📦 Dispatcher playbook

1Your first morning

Open tariq.codeator.ai on your desktop. Sign in with your dispatcher email and password. The Orders page is your home base.

• 1The nav bar — every admin page is one click away. Orders is always your starting point.
• 2The SLA badge appears when an order sits pending longer than your company's SLA window (default 24 hours).
• 3COD is shown in orange IQD — this is what the driver must collect.

2Adding one order

The fast path for a single phone call. Most fields you'll fill once and move on.

1. Phone number — start typing; if the customer has ordered before, suggestions appear below the input. Tap one to auto-fill name, area, and last-known coordinates.
2. Customer name — Arabic or English, both work.
3. Area — the district name (e.g. Karrada, Mansour, Zayouna).
4. COD (IQD) — amount in Iraqi dinars, numbers only.
5. GPS — paste the customer's shared location from WhatsApp, Google Maps, or apple maps. The form extracts the coordinates automatically. Alternatively, click on the map to pick a spot.

3Bulk import from CSV/Excel

When you have 50 orders this morning, you don't type them in one at a time. Export them from Excel as CSV, drop them on Tariq.

Required columns: phone, customer, area, cod.

Optional columns: lat, lng, notes. Without lat/lng, the order lands without coordinates and needs GPS added later before it can be routed.

4Generating optimized routes

Once your orders are in with coordinates, the Routes page assigns them to drivers in the smartest order.

1. Pick the depart hour. 08:00 runs traffic-aware routing as if drivers leave at 8am. 14:00 does the same for mid-day. Stop orders will differ — Karrada at 8am has different traffic than Karrada at 2pm.
2. Hit Optimize. The server calls OSRM for drive times, applies Baghdad rush-hour multipliers, and OR-Tools solves the vehicle routing problem.
3. Review the cards. Each driver gets a card with stops numbered. Look for obviously weird sequences — they're rare, but the optimizer isn't omniscient.
4. Send to drivers. Each driver's stops are already assigned. They see them the moment they open their PWA link.

5Notifying customers on WhatsApp

After routes are generated, one button tells every customer their order is out for delivery, with a tracking link.

The customer receives a WhatsApp message like:

6Bulk reassigning orders

When a driver calls in sick, you don't re-assign 20 orders one by one.

1. Check the boxes next to orders you want to move.
2. The orange bulk bar appears at the top with a count.
3. Pick a target driver from the dropdown, hit Reassign.
4. Generate routes again — the sick driver's queue is redistributed.

7End of day — cash reconciliation

Every driver carried a pocketful of cash today. You need to zero it out before tomorrow.

1. Driver hands you the physical cash. Count it.
2. Click Reconcile on their row. Confirm the total matches.
3. Their outstanding balance drops to 0. The audit log now records who reconciled each order and when.

8The daily report

One page tells you what happened today: how many delivered, what went wrong, how much cash came in.

Use the From / To date pickers to look at any time range, not just today. Switch stores with the store dropdown if you run multiple.

9Drag-and-drop route reordering

After the optimizer generates routes, you can manually reorder stops by dragging them — useful when you know something the algorithm doesn't.

1. Generate routes as normal on the Routes page.
2. Grab any stop and drag it up or down within a driver's card.
3. Click Save Order on that driver's card to persist the change.
4. The driver sees the new stop order immediately on their phone.

10Barcode management

Assign barcodes to orders for fast identification. Drivers can scan them with their phone camera.

How barcodes work:

• Assign a barcode string to any order (e.g. PKG-2026-0142 or any format you use).
• Drivers tap the scan button on their app to open their phone camera — it reads the barcode instantly.
• The matching order scrolls into view so the driver knows which package they're holding.
• Customers can also look up their order by barcode on the Customer Portal.

11Predictive analytics

The Predictions tab on the Report page shows patterns that help you plan ahead — failure hotspots, demand days, and peak hours.

What each section tells you:

• Failure by area: which neighborhoods have the highest failure rates — focus your address verification there.
• Demand by day: which days are busiest — plan driver availability accordingly.
• Peak hours: which hours see the most deliveries — schedule route generation around these windows.
• Average orders/day: your baseline — if today is significantly above, you may need an extra driver.

12Customer self-service portal

Customers can check their order status without calling you — via order number or barcode.

Two ways customers can track:

• Quick lookup: visit /customer-portal, enter order number or barcode — instant status.
• Tracking link: the WhatsApp notification includes a unique tracking URL that shows real-time status + driver info.

13Troubleshooting

The five problems that come up most often, and their fix.