travo Books Documentation
বাংলা
In this volume · VOLUME 13
Workflows
Workflow Index Booking Lifecycle Workflow Refund Workflow Approval Workflows Period Close Workflow
Home / Workflows / Workflow Index

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

flowchart LR subgraph CUST[Customer / Buyer] C1[Browse offer] C2[Pay] C3[Travel] C4[Refund request] end subgraph OPS[Agent / Mid-Office] O1[Search & select] O2[Issue ticket] O3[Service: change/refund] O4[Reconcile daily] end subgraph ACC[Accountant] A1[Receipts apply] A2[Daily bank recon] A3[Period close] A4[Tax filings] end subgraph FIN[Finance / Controllership] F1[Approve large] F2[Sign-off close] F3[Audit support] end subgraph SYS[System / Workers] S1[Hold timelimit sweep] S2[Recognition run] S3[FX revaluation] S4[Webhook delivery] S5[BSP import] S6[Bank statement import] end C1 --> O1 O1 --> O2 C2 --> O2 O2 --> S4 O2 --> A1 O2 --> S5 C3 --> S2 C4 --> O3 O3 --> A1 A1 --> A2 S6 --> A2 A2 --> A3 S2 --> A3 S3 --> A3 A3 --> F2 F2 --> A4 A4 --> F3 S5 --> A2 O2 -.over threshold.-> F1 F1 --> O2

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