Skip to main content

Live monitoring

The Monitoring page is the dispatch center during business hours β€” letting Dispatchers track realtime vehicle positions, trip progress, and react quickly to issues.

Live monitoring

Page layout​

AreaContent
Map (center)All running vehicles on one Leaflet/OSM map
Trip list (right)Card per trip: vehicle, driver, progress, ETA
Filters (top)Filter by date, status, depot

Map markers​

Each vehicle = a colored marker on the map:

ColorMeaning
🟒 GreenRunning on planned route (IN_PROGRESS)
πŸ”΅ BlueJust started (LOADING / just left depot)
🟠 OrangeReturning to depot (RETURNING)
πŸ”΄ RedRoute deviation β€” alert!
⚫ GrayLost GPS signal > 5 minutes

Click a marker for a detail popup: driver, vehicle code, next stop, current speed, last update time.

Realtime GPS​

The mobile driver app pushes location to the server every 30 seconds while a trip is active. On the map:

  • Marker = current position
  • Dashed line = planned route (per plan)
  • Solid line = actual route (drawn from historical GPS points)
Deviation detection

The system automatically compares actual GPS vs the dashed planned route. If deviation exceeds 200m for 3 consecutive samples β†’ marker turns πŸ”΄ + notification fires.

Common causes: driver took a different road (traffic, avoidance), wrong address, or needs verification.

Trip detail​

Click a trip card on the right or a map marker β†’ opens detail panel:

  • Vehicle + driver info (with click-to-call phone)
  • Stop list with status:
    • ⏳ Not yet arrived
    • πŸ“ Currently at
    • βœ… Completed (with POD photos)
    • ❌ Failed (with reason + photo)
  • Progress: X/N stops delivered
  • Actual total km vs planned
  • COD collected: total cash + per-stop detail

Trip status​

ASSIGNED ─(driver confirms)─> DRIVER_CONFIRMED
   β”‚
   └─(starts)─> LOADING ─> IN_PROGRESS ─> RETURNING ─> COMPLETED
                                      β”‚
                                      └─(issue)─> CANCELLED

Dispatcher actions​

1. Call the driver​

Click the phone number in the card β†’ opens dialer on PC (requires softphone) or copy the number.

2. Send in-app message​

Click πŸ’¬ on the trip β†’ type text β†’ driver gets notification on the app.

3. Mark a stop as failed​

When the driver can't be reached, the Dispatcher can mark on their behalf:

  • Click stop β†’ "Mark failed" β†’ choose reason (customer absent, wrong address, rejected...)

4. Close trip early​

For serious incidents:

  • Click "End trip" β†’ moves to CANCELLED
  • System writes Audit Log
  • Undelivered orders return to OPEN (awaiting re-planning)

Filters​

  • Date: defaults to today
  • Status: tick statuses to view
  • Origin depot: filter by parent depot
  • Has alert: show only trips with deviation / GPS loss

Next​