System Workflows
Trip Lifecycle
The trip state machine — publishing, start-time transitions, remedy windows, change notices and archival.
A trip moves through thirteen states from Draft to Archived, and several transitions belong to the system, not to any person: start time reached, settlement closed, thirty days passed. This is the engine view of state machine 7.1; the organization side is UF-ORG-06.
Delivery phase: P2 (creation and booking), P3 (multi-vehicle and programs), P6 (tracking-era archival).
Trigger and actors
- Trigger: an organization publishes a draft, the clock reaches departure, or the last booking completes its lifecycle.
- Actors: the organization; the start-time job; the remedy window; the archive job; travelers choosing remedies.
Diagram
Timers and rules
| Step | Timer (verbatim) | Rule trace |
|---|---|---|
| Start transition | "Trip start time reached; trip is Ready" moves the trip to In Progress | BRL-07, section 7.1 |
| Remedy window | The traveler has "7 days to choose; then the case goes to admin"; remedy status offered, chosen, escalated, expired | BRL-24, FR-TRIP-06, D-148 |
| Change notice | "Vehicle, driver or time changes are notified within 1 hour" | FR-NTF-07, D-186 |
| Organization cancel | "every confirmed booking is refunded in full, with coupon redemptions reversed" | BRL-30, FR-BKG-06, D-150 |
| Settlement gate | The trip archives "30 days after Completed, and only once its settlement is closed" | BRL-25, FR-ACC-10, D-26 |
| Refunds-issued terminal | Cancelled becomes Refunds Issued when "Every confirmed booking Refunded", then Archived "30 days later" | section 7.1 |
| Ready gate | A trip is Ready when staffing is complete; finalized deals assign platform suppliers and drivers see their assigned trips | FR-STF-01, FR-STF-03, FR-STF-04 |
| Program changes | Programs changeable until departure; later changes become traveler remedies | FR-TRIP-04 |
| Publish gates | Drafts and targeted trips are hidden from browsing; VIP early access windows apply before public | FR-TRIP-02, FR-TRV-02 |
Stories
- As an organization, I want the trip to start itself at departure time, so that no one has to press a button mid-operation. (BRL-07)
- As a traveler affected by a change, I want seven days to pick my remedy before anyone decides for me, so that a schedule change stays my call. (BRL-24, FR-TRIP-06)
- As a finance operator, I want archival gated on settlement closure, so that nothing disappears while money is still open. (BRL-25, FR-ACC-10)
- As a parent, I want vehicle or driver changes told to me within the hour, so that I am never surprised at pickup. (FR-NTF-07, D-186)