# ddpl-work/holiday-circuit architecture

> Architecture diagram of the GitHub repository ddpl-work/holiday-circuit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ddpl-work/holiday-circuit
- Repository: https://github.com/ddpl-work/holiday-circuit

## Overview

Holiday Circuit is a role-based travel operations platform spanning agent, operations, supplier, finance, and administrative workspaces. Its central workflow moves an agent enquiry through operations acceptance and quotation, agent approval and payment, finance verification, DMC fulfilment, voucher delivery, and settlement. The graph also includes identity and governance, inventory, and reporting capabilities documented in the README. Source excerpts are partial; domain capabilities and lifecycle links rely on the README, while the sampled code directly demonstrates API-backed service lookup, reassignment, and invoice processing.

Main entry points: [`DMC/src/pages/dmcPages/FulfillmentConfirmation.jsx`](https://github.com/ddpl-work/holiday-circuit/blob/main/DMC/src/pages/dmcPages/FulfillmentConfirmation.jsx) (DMC Fulfilment), [`Admin/src/pages/opsPages/QuotationBuilder.jsx`](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/opsPages/QuotationBuilder.jsx) (Quotation Builder), [`Admin/src/pages/financePages/PaymentVerification.jsx`](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/financePages/PaymentVerification.jsx) (Payment Verification), [`Agent/src/pages/agentPages/QueryDetails.jsx`](https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/QueryDetails.jsx) (Agent Quote Review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Governance"]
  node_registration["Registration and Login<br/>[RegisterFlow.jsx]"]
  node_admin["Admin Governance<br/>[UserManagement.jsx]"]
end

subgraph group_trip["Enquiry and Quotation"]
  node_query["Travel Queries<br/>[Queries.jsx]"]
  node_ops["Operations Acceptance"]
  node_quotation["Quotation Builder"]
  node_inventory["DMC Inventory"]
  node_quote_review["Agent Quote Review<br/>[QueryDetails.jsx]"]
  node_booking["Bookings and Documents"]
end

subgraph group_money["Payments and Fulfilment"]
  node_invoice["Invoice and Payments<br/>[Finance.jsx]"]
  node_verification["Payment Verification"]
  node_fulfillment["DMC Fulfilment"]
  node_voucher["Voucher Management"]
  node_settlement["Settlement and Ledger"]
end

subgraph group_oversight["Administration and Reporting"]
  node_analytics["Finance Analytics"]
  node_management["Role Dashboards"]
end

node_agent(("Travel Agent"))
node_api["API Client<br/>[Api.js]"]
node_server_admin["Admin Controller<br/>[adminController.js]"]
node_customer(("Traveller / Client"))
node_dmc_partner(("DMC Partner"))

node_agent -->|"registers"| node_registration
node_registration -->|"requests approval"| node_admin
node_agent -->|"creates enquiry"| node_query
node_query -->|"routes for acceptance"| node_ops
node_ops -->|"starts quote work"| node_quotation
node_quotation -->|"searches services"| node_inventory
node_quotation -->|"sends quote"| node_quote_review
node_agent -->|"reviews quote"| node_quote_review
node_quote_review -->|"accepts quote"| node_booking
node_booking -->|"initiates invoicing"| node_invoice
node_invoice -->|"submits payment proof"| node_verification
node_verification -->|"confirms payment"| node_fulfillment
node_dmc_partner -->|"confirms services"| node_fulfillment
node_fulfillment -->|"supports voucher issue"| node_voucher
node_voucher -->|"delivers voucher"| node_agent
node_fulfillment -->|"records supplier settlement"| node_settlement
node_verification -->|"feeds reporting"| node_analytics
node_admin -->|"oversees accounts"| node_management
node_management -->|"reviews metrics"| node_analytics
node_api -->|"sends requests"| node_server_admin

click node_registration "https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/auth/register/RegisterFlow.jsx"
click node_admin "https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/adminPages/UserManagement.jsx"
click node_query "https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/Queries.jsx"
click node_ops "https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/opsPages/OrderAcceptance.jsx"
click node_quotation "https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/opsPages/QuotationBuilder.jsx"
click node_inventory "https://github.com/ddpl-work/holiday-circuit/blob/main/DMC/src/pages/dmcPages/ContractedRates.jsx"
click node_quote_review "https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/QueryDetails.jsx"
click node_booking "https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/ActiveBookingDetails.jsx"
click node_invoice "https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/Finance.jsx"
click node_verification "https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/financePages/PaymentVerification.jsx"
click node_fulfillment "https://github.com/ddpl-work/holiday-circuit/blob/main/DMC/src/pages/dmcPages/FulfillmentConfirmation.jsx"
click node_voucher "https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/opsPages/VoucherManagement.jsx"
click node_settlement "https://github.com/ddpl-work/holiday-circuit/blob/main/DMC/src/pages/dmcPages/SettlementCenter.jsx"
click node_analytics "https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/financePages/AdvancedAnalytics.jsx"
click node_management "https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/adminPages/SuperAdminDashboard.jsx"
click node_api "https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/utils/Api.js"
click node_server_admin "https://github.com/ddpl-work/holiday-circuit/blob/main/server/src/controllers/adminController.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_registration,node_admin,node_api,node_customer toneBlue
class node_query,node_ops,node_quotation,node_inventory,node_quote_review,node_booking toneAmber
class node_invoice,node_verification,node_fulfillment,node_voucher,node_settlement toneMint
class node_analytics,node_management toneRose
class node_agent,node_dmc_partner toneIndigo
class node_server_admin toneTeal
```

## Components

### Access and Governance

- [Registration and Login](https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/auth/register/RegisterFlow.jsx): `Agent/src/auth/register/RegisterFlow.jsx`
- [Admin Governance](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/adminPages/UserManagement.jsx): `Admin/src/pages/adminPages/UserManagement.jsx`

### Enquiry and Quotation

- [Travel Queries](https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/Queries.jsx): `Agent/src/pages/agentPages/Queries.jsx`
- [Operations Acceptance](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/opsPages/OrderAcceptance.jsx): `Admin/src/pages/opsPages/OrderAcceptance.jsx`
- [Quotation Builder](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/opsPages/QuotationBuilder.jsx): `Admin/src/pages/opsPages/QuotationBuilder.jsx`
- [DMC Inventory](https://github.com/ddpl-work/holiday-circuit/blob/main/DMC/src/pages/dmcPages/ContractedRates.jsx): `DMC/src/pages/dmcPages/ContractedRates.jsx`
- [Agent Quote Review](https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/QueryDetails.jsx): `Agent/src/pages/agentPages/QueryDetails.jsx`
- [Bookings and Documents](https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/ActiveBookingDetails.jsx): `Agent/src/pages/agentPages/ActiveBookingDetails.jsx`

### Payments and Fulfilment

- [Invoice and Payments](https://github.com/ddpl-work/holiday-circuit/blob/main/Agent/src/pages/agentPages/Finance.jsx): `Agent/src/pages/agentPages/Finance.jsx`
- [Payment Verification](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/financePages/PaymentVerification.jsx): `Admin/src/pages/financePages/PaymentVerification.jsx`
- [DMC Fulfilment](https://github.com/ddpl-work/holiday-circuit/blob/main/DMC/src/pages/dmcPages/FulfillmentConfirmation.jsx): `DMC/src/pages/dmcPages/FulfillmentConfirmation.jsx`
- [Voucher Management](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/opsPages/VoucherManagement.jsx): `Admin/src/pages/opsPages/VoucherManagement.jsx`
- [Settlement and Ledger](https://github.com/ddpl-work/holiday-circuit/blob/main/DMC/src/pages/dmcPages/SettlementCenter.jsx): `DMC/src/pages/dmcPages/SettlementCenter.jsx`

### Administration and Reporting

- [Finance Analytics](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/financePages/AdvancedAnalytics.jsx): `Admin/src/pages/financePages/AdvancedAnalytics.jsx`
- [Role Dashboards](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/pages/adminPages/SuperAdminDashboard.jsx): `Admin/src/pages/adminPages/SuperAdminDashboard.jsx`

### Other components

- **Travel Agent**
- [API Client](https://github.com/ddpl-work/holiday-circuit/blob/main/Admin/src/utils/Api.js): `Admin/src/utils/Api.js`
- [Admin Controller](https://github.com/ddpl-work/holiday-circuit/blob/main/server/src/controllers/adminController.js): `server/src/controllers/adminController.js`
- **Traveller / Client**
- **DMC Partner**

## Connections

- Travel Agent → Registration and Login: registers
- Registration and Login → Admin Governance: requests approval
- Travel Agent → Travel Queries: creates enquiry
- Travel Queries → Operations Acceptance: routes for acceptance
- Operations Acceptance → Quotation Builder: starts quote work
- Quotation Builder → DMC Inventory: searches services
- Quotation Builder → Agent Quote Review: sends quote
- Travel Agent → Agent Quote Review: reviews quote
- Agent Quote Review → Bookings and Documents: accepts quote
- Bookings and Documents → Invoice and Payments: initiates invoicing
- Invoice and Payments → Payment Verification: submits payment proof
- Payment Verification → DMC Fulfilment: confirms payment
- DMC Partner → DMC Fulfilment: confirms services
- DMC Fulfilment → Voucher Management: supports voucher issue
- Voucher Management → Travel Agent: delivers voucher
- DMC Fulfilment → Settlement and Ledger: records supplier settlement
- Payment Verification → Finance Analytics: feeds reporting
- Admin Governance → Role Dashboards: oversees accounts
- Role Dashboards → Finance Analytics: reviews metrics
- API Client → Admin Controller: sends requests