Chapter 13.1 — Workflow Index

1. Purpose

This volume is a visual reference: every major workflow in travoBooks captured as a diagram with the roles, systems, decision points, and data artefacts visible at a glance. The text describing each workflow lives in the relevant module chapter; this volume reproduces and standardises the diagrams in one place for trainers, auditors, and onboarding.

2. Conventions

• Mermaid sequence diagrams for time-ordered multi-actor flows.
• Mermaid state diagrams for entity lifecycles.
• Mermaid flowcharts for decision-heavy processes.
• Roles named consistently: Agent, Cashier, Accountant, Controller, Auditor, Approver, Partner Admin, Platform Admin, Customer, Supplier, System.
• System components: UI, API, Worker, DB, Queue, Supplier (GDS/NDC/LCC), Gateway, BSP, Bank, S3.

3. Workflow catalog

Customer-facing

• 13.2 Booking Lifecycle — search → issue → travel
• 13.3 Invoice Generation — booking → invoice → delivery → payment
• 13.4 Refund — request → quote → execute → payback
• 13.5 Customer Onboarding — KYC → screening → activation

Internal operations

• 13.6 Approval Workflows — booking, refund, credit, payout
• 13.7 Period Close — soft-close → close → lock
• 13.8 Partner Onboarding — provisioning → configuration → first transaction
• 13.9 Cash Drawer Open/Close — daily cycle
• 13.10 Supplier Payout — initiate → approve → wire → reconcile

Financial flows

• 13.11 Daily Recognition Run
• 13.12 BSP Settlement Cycle
• 13.13 Bank Reconciliation
• 13.14 ADM/ACM Lifecycle
• 13.15 Commission Settlement
• 13.16 VAT Return Cycle

Integration flows

• 13.17 GDS Issuance Sequence
• 13.18 NDC Order Lifecycle
• 13.19 Webhook Delivery & Retry
• 13.20 Gateway Settlement

4. How to read the diagrams

Each workflow chapter contains: - Context — when this workflow runs, what triggers it - Pre-conditions — what must be true to enter - Roles & systems — actors involved - Diagram(s) — sequence + flowchart - Outcomes — terminal states - Cross-references — the module chapter(s) that own the workflow

5. Cross-cutting workflow principles

These hold across every travoBooks workflow:

1. Same-transaction operational+financial commit — wherever a state transition has a ledger impact, both happen in the same DB transaction.
2. Maker-checker over threshold — high-impact actions split across two users.
3. Idempotency — every external-initiated operation accepts an idempotency key; retries are safe.
4. Audit trail by default — every workflow step records actor, timestamp, before, after.
5. Async for slow steps — supplier calls, gateway calls, document generation are async; UI continues.
6. Notification on terminal states — successful and failed workflow endings notify the right roles.
7. Period-state aware — workflows check the target period's state before posting.

6. Master cross-workflow swim-lane

The remaining chapters in this volume zoom into each workflow with detail and exact-system sequence.