Smart Lead & Staff Management System

via Freelancer ·

Budget / Salary₹12,500–37,500
TypeFreelance project
LocationRemote
Posted3 hours ago
# Android App Development – Smart Lead & Staff Management System

I am looking for an experienced **Android app developer** to build a professional staff-management and lead-distribution application for my service business **Plyfix**.

The main purpose of the app is to automatically send a new customer/service lead to the **nearest available staff member** based on their live GPS location.

## Core Feature: Smart Nearby Lead Assignment

When a new lead is created, the admin will enter the customer's:

**Name + Mobile Number + Service Required + Lead Location**

The system will automatically identify available staff members around that location.

### Lead distribution logic

**Stage 1 – 2 KM Radius**

The system searches for available staff within **2 KM** of the customer's location.

All eligible nearby staff receive a notification such as:

> New Plyfix Lead
> Plumbing Service Required
> Location: Raj Nagar
> Distance: 1.2 KM
> Estimated earning: ₹XXX
> **Accept Lead**

The first eligible staff member who accepts the lead gets the job.

### Stage 2 – Expand to 4 KM

If **nobody accepts within a defined time period** (for example, 2 minutes), the system automatically expands the search radius to **4 KM**.

Staff within the new radius receive the lead notification.

### Future Expansion

The radius should be configurable from the Admin Panel, for example:

**2 KM → 4 KM → 6 KM → 10 KM**

The admin should be able to change these distances and acceptance times without modifying the app code.

---

# Live Staff Location Tracking

The application must continuously track the **live location of active staff members**, subject to Android background-location permissions and appropriate privacy controls.

Admin should be able to see:

**Staff Name**
**Online/Offline status**
**Current location**
**Current assigned job**
**Distance from customer**
**Last location update**

The admin dashboard should display staff on a **Google Maps-style live map**.

Example:

Customer Lead
Staff A – 0.8 KM away
Staff B – 1.4 KM away
Staff C – Offline
Staff D – 3.2 KM away

---

# Staff App

Each technician/staff member should have a separate login.

### Staff features

**Login / OTP authentication**

**Online / Offline button**

**Live GPS location sharing**

**Receive nearby leads**

**Accept / Reject lead**

**View customer location**

**Navigation using Google Maps**

**Customer contact option**

**Job status**

* New Lead
* Accepted
* Travelling
* Reached
* Work Started
* Completed
* Cancelled

**Daily earnings**

**Completed jobs**

**Job history**

**Profile**

---

# Admin App / Admin Dashboard

The administrator should have complete control over the system.

### Admin features

**Create a new lead manually**

**View all active leads**

**View all staff**

**Live staff map**

**Assign lead manually**

**Automatic lead assignment**

**Change radius**

**Change acceptance time**

**View accepted/rejected leads**

**Track job status**

**View staff performance**

**View earnings**

**View customer details**

**Lead history**

**Staff attendance / online time**

---

# Smart Assignment Algorithm

The developer should implement the following logic:

```text
New Lead Created

Find Available Staff

Search Radius = 2 KM

Send Notification

Staff Accepts?
YES ↓ ↓ NO
Assign Job Wait X minutes

Expand Radius = 4 KM

Send Notifications

Staff Accepts?
YES ↓ ↓ NO
Assign Job Continue/Notify Admin
```

The system should prevent **two staff members from successfully accepting the same lead**.

The server must lock the lead immediately when the first valid acceptance is received.

---

# Notifications

Real-time push notifications are required using **Firebase Cloud Messaging (FCM)** or an equivalent reliable technology.

Notifications should be sent when:

**New lead available**

**Lead accepted**

**Lead assigned**

**Customer cancelled**

**Job status changed**

**New job reminder**

---

# Location & Technology

Preferred technology stack:

**Android:** Kotlin + Jetpack Compose or XML

**Backend:** Node.js / Firebase / suitable scalable backend

**Database:** Firebase Firestore or PostgreSQL

**Authentication:** Firebase Authentication / OTP

**Maps:** Google Maps API

**Location:** Android Fused Location Provider

**Notifications:** Firebase Cloud Messaging

**Admin Panel:** Responsive web dashboard

The developer can recommend a better architecture if they have experience building **location-based delivery, field-service, taxi, or on-demand service applications**.

---

# Important Technical Requirements

The application must:

* Work reliably with background location where permitted by Android.
* Handle poor internet connectivity.
* Avoid excessive battery consumption.
* Prevent duplicate lead assignments.
* Calculate distance accurately using GPS coordinates.
* Automatically expand the search radius.
* Store lead assignment history.
* Record staff location updates securely.
* Handle staff going offline.
* Protect customer and staff personal information.
* Have proper role-based access for Admin and Staff.

The system should also be designed so that **customer app integration can be added later**.

---

# Example Use Case

A customer requests:

**Plumber – leakage repair**

Location:

**Raj Nagar, Ghaziabad**

Admin creates the lead.

System searches:

**0–2 KM → 5 eligible plumbers found**

Notifications are sent.

Nobody accepts within **2 minutes**.

System automatically changes to:

**0–4 KM → 12 eligible plumbers found**

A plumber 2.8 KM away accepts.

The system immediately:

**Assigns the job → removes the lead from other staff → opens customer location → starts job tracking.**

Admin can see the plumber's live location throughout the job.

---

# Deliverables

I need a **complete working Android MVP**, not just UI screens.

The final project should include:

**Android Staff App**

**Admin Dashboard**

**Backend/API**

**Database**

**Firebase notifications**

**Live GPS tracking**

**Automatic 2 KM → 4 KM lead distribution**

**Lead acceptance/rejection**

**Job status system**

**Source code**

**Database/backend setup**

**APK/AAB build**

**Basic documentation**

The code should be clean, scalable, and structured so additional features can be added later.

### Developer Profile

I am specifically looking for someone who has experience with:

**GPS + Google Maps + real-time location tracking + Firebase + push notifications + marketplace/on-demand service applications.**

Please include **2–3 relevant projects** you have previously developed, particularly apps involving **technicians, delivery personnel, drivers, field staff, or location-based job assignment**.

**Project name:** Smart Service Management App
**Platform:** Android + Web Admin
**Type:** Location-based field service / technician management system.
mobile app development backend development frontend development
Apply on Freelancer →

Project sourced from Freelancer.com. Applications happen directly on the original platform — we never collect your data.