
π Logistics & Supply Chain Β· State Machine
The states of a freight shipment booking, from quote and booking through pickup, transit, customs and delivery.
Drawing diagramβ¦
State machine for a freight booking: Quoted, Booked, Carrier Confirmed (or Rejected back to Quoted), Pickup Scheduled, Picked Up, In Transit, At Customs (international), Cleared, Out for Delivery, Delivered, Invoiced. Exception can happen during transit (delay, damage) and returns to In Transit when resolved; customs Hold needs documents before Cleared.
stateDiagram-v2 [*] --> Quoted Quoted --> Booked: Customer accepts Booked --> CarrierConfirmed Booked --> Quoted: Carrier rejects CarrierConfirmed --> PickupScheduled PickupScheduled --> PickedUp PickedUp --> InTransit InTransit --> Exception: Delay or damage Exception --> InTransit: Resolved InTransit --> AtCustoms: International AtCustoms --> CustomsHold: Documents missing CustomsHold --> AtCustoms: Documents provided AtCustoms --> Cleared Cleared --> OutForDelivery InTransit --> OutForDelivery: Domestic OutForDelivery --> Delivered Delivered --> Invoiced Invoiced --> [*]
From an order leaving the hub to the parcel at the customer's door: rider assignment, live tracking, OTP handover and proof of delivery.
A logistics platform that tracks shipments across carriers: booking, scan events from hubs, carrier integrations and customer notifications.
How a warehouse receives goods: appointment, unloading, checking against the ASN, quality check, putaway and stock update.
How a delivery company plans daily routes: orders, vehicle capacity, time windows and live traffic feed a route optimiser that assigns stops to drivers.
Where cold chain monitoring runs for vaccines or fresh food: temperature loggers in reefers and cold rooms, gateways, and a cloud alerting platform.
Tables for a logistics system: customers, shipments, packages, consignment legs, hubs, vehicles and tracking events.