Driver status is derived

The status on a driver record — Available, On Delivery, On Break, On Leave or Offline — is not a field you maintain. Cooriroo derives it from three facts about the driver right now: whether they have an active shift, whether that shift has an open break, and whether they have a trip in progress. Every shift and trip event recomputes it from those facts.

This surprises people, because the Status column on the drivers list looks like a dropdown you can use. It is worth understanding why it works this way before you spend an afternoon correcting statuses that correct themselves back.

The table above is in precedence order, and the order carries real meaning. Cooriroo checks each rule in turn and stops at the first match:

1. An open break wins over everything. Breaks only exist inside an active shift, so this rule is safe to put first.
2. Otherwise, a trip in progress means On Delivery.
3. Otherwise, an active shift means Available.
4. Otherwise, if the driver is already On Leave, they stay On Leave.
5. Otherwise, Offline.

The reason a break outranks a trip is the return journey. A driver who stops for lunch halfway through a trip reads On Break while the break is open, and goes back to On Delivery when it ends — not to Available. The status is recomputed at the end of the break rather than forced to a fixed value, so it lands on whatever is actually true.

A driver’s status is recomputed when any of these happen to them:

• They clock in, whether by activating a scheduled shift or starting an ad-hoc one.
• They clock out.
• A break starts.
• A break ends.
• A trip of theirs starts.
• A trip of theirs reaches a final state — completed, cancelled or failed.
• The no-show sweep records that they missed a scheduled shift.

On Leave is the exception, and it is the only reason the dropdown is there at all. It is an administrative state rather than an operational one — nothing a driver does produces it — so recalculation preserves it whenever there is no activity to contradict it.

It is not sticky, though. Any activity overrides it immediately: a clock-in makes the driver Available, a trip makes them On Delivery. And once that activity ends they become Offline, not On Leave again. If someone is put on leave, works a day mid-way through it, and then goes back on leave, you have to set it a second time.

Driver status is about availability, not about location. Where a driver is comes from live tracking and appears on the live map, which is a separate signal with its own feature gate.