agent

services/tools/help/assigning-a-rider.md

@@ -0,0 +1,19 @@
+---
+question: What happens when I assign a rider?
+also:
+  - how does assigning a delivery work
+  - rider did not get the job
+  - assigned but nothing happened
+area: orders
+source: services/... assignDelivery, src/features/store-admin/assignDelivery.ts
+---
+Assigning a rider is not a status change — it creates a delivery job. The job is
+written, copied into the rider's queue so it appears in their app, and the order
+is moved on, all together.
+
+Until that happens the order is not on the deliveries board at all, because
+deliveries are their own records rather than a view over orders.
+
+If a rider says they never received a job, the two usual causes are that they
+have never opened the app on a device, so there is nothing to send a
+notification to, or that the job was assigned to somebody else.