⚑

Dispatch Platform

Test Portal β€” Full E2E Flow Guide

Complete test guide from order placement to delivery and payment. Open multiple tabs, one per role.

Checking backend…

Test Accounts

Admin

Admin User

πŸ‘‘
+91 9999999999

Manage orders, accept as vendor, view live map, see OTPs

  • βœ“ Accept orders as vendor
  • βœ“ View pickup & drop OTPs
  • βœ“ Force order status
  • βœ“ Live map with GPS
  • βœ“ Dispatch offers history
Open Admin Dashboard β†’

Customer

Admin User

πŸ›’
+91 9999999999

Browse vendors, place orders, track deliveries live with map

  • βœ“ Browse nearby vendors
  • βœ“ Add items to cart
  • βœ“ Place orders (COD / UPI)
  • βœ“ Track rider on live map
  • βœ“ See drop OTP on tracking page
Open Shop Page β†’

Vendor

Fresh Mart

πŸͺ
+91 9876543210

Accept incoming orders, see pickup OTP generated for rider

  • βœ“ Accept PLACED orders
  • βœ“ Pickup OTP auto-generated
  • βœ“ Triggers rider dispatch
  • βœ“ View order items & bill
Open Admin β†’ Orders β†’

Rider

Deepak Kumar

πŸ›΅
+91 9876543212

Go online, accept dispatch offers, GPS streams to tracking page

  • βœ“ Go online/offline
  • βœ“ Accept dispatch offer (25s window)
  • βœ“ GPS auto-simulates movement
  • βœ“ Enter pickup OTP at vendor
  • βœ“ Enter drop OTP from customer
Open Rider Panel β†’

Worker

Amit Singh

πŸ‘·
+91 9876543213

Works for KaamGhanta vertical β€” same panel as rider

  • βœ“ Accept gig job offers
  • βœ“ Clock in/out shifts
  • βœ“ Earn per-hour payout
Open Rider Panel β†’

Complete Flow β€” Step by Step

Open these tabs in parallel: Shop Β· Rider Panel Β· Admin Dashboard Β· Tracking Page

1
Customer πŸ›’β†’ PLACED

Place an Order

Login with +919999999999 β†’ Browse Fresh Mart β†’ Add items β†’ Checkout β†’ Place Order

πŸ’‘ Copy the Order ID from the tracking URL

Open Shop β†’
2
Admin / Vendor πŸ‘‘β†’ SEARCHING RIDER

Accept Order as Vendor

Find the PLACED order β†’ click Accept button β†’ Pickup OTP appears in both the toast and the OTP card

πŸ’‘ Pickup OTP also shows inside the order detail panel

Open Admin Orders β†’
3
Rider πŸ›΅β†’ RIDER ASSIGNED

Rider Goes Online & Accepts

Login as +919876543212 β†’ Go ONLINE β†’ Wait for offer card (within seconds) β†’ Accept

πŸ’‘ GPS simulation starts immediately β€” check Live Map on admin

Open Rider Panel β†’
4
Rider πŸ›΅β†’ PICKED UP

Arrive at Vendor + Pickup OTP

Click "Arrived at Vendor" β†’ Enter the 4-digit Pickup OTP (shown on rider page as hint) β†’ Confirm

πŸ’‘ Order status jumps to PICKED_UP on tracking page

Rider Panel β†’
5
Both πŸ›΅πŸ“±β†’ EN ROUTE

En Route β€” Watch GPS Live

GPS simulation streams rider location via Socket.IO β†’ Rider pin moves on customer tracking map in real time

πŸ’‘ Admin Live Map at localhost:3002/live-map also shows the moving rider

6
Customer πŸ›’β†’ ARRIVED

Share Drop OTP with Rider

On the tracking page, the orange Drop OTP box shows a 4-digit code β€” tell it to the rider

πŸ’‘ Drop OTP is visible once rider is assigned

7
Rider πŸ›΅β†’ COMPLETED

Enter Drop OTP β†’ Delivery Done

Click "Arrived at Customer" β†’ Enter the 4-digit Drop OTP β†’ Confirm Delivery

πŸ’‘ Wallet balance updates instantly on rider panel

Rider Panel β†’
8
Admin πŸ‘‘β†’ COMPLETED

Verify Payment Payout

Open the completed order β†’ Payment section shows β‚Ή credited to rider wallet (after 10% platform commission)

πŸ’‘ Dispatch offers section shows which riders were offered and their responses

Admin Orders β†’

Service URLs

πŸ›°οΈ How Live GPS Tracking Works

1. Rider goes online β†’ sends initial GPS position via POST /partner/online

2. Rider accepts offer β†’ GPS simulation starts, interpolating from rider position to vendor location

3. Every 1.5s β†’ rider page emits location:update via Socket.IO with the order ID

4. Gateway broadcasts location:partner to the track:{orderId} room

5. Customer tracking page subscribes to that room β†’ rider πŸ›΅ pin moves smoothly on Leaflet map

6. Admin Live Map also updates (polls every 8s via GET /admin/partners/online)

7. After pickup OTP β†’ new GPS simulation from vendor to customer destination starts automatically

Dispatch Platform β€” Local Dev Environment Β· All OTPs appear in-response (dev mode)