# k-sewii/tour-booking-management-system architecture

> Architecture diagram of the GitHub repository k-sewii/tour-booking-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/k-sewii/tour-booking-management-system
- Repository: https://github.com/k-sewii/tour-booking-management-system

## Overview

DongNamTrip is a Southeast Vietnam tour-discovery and trip-management product. Customers browse tours and destinations, plan itineraries, manage bookings and request private-tour quotations; authenticated users can listen to published narration. Staff manage accounts and operational content through a separate Windows Forms app. The README documents a React SPA→Web BFF→ASP.NET API→SQL Server route, with six API modules structured as presentation, business logic and data access. Edges for the documented topology and capabilities cite the README; sampled API registration and selected service/repository references provide additional evidence. Other module internals are represented at directory level, not claimed as inspected.

Main entry points: [`src/Backend/DongNamTrip.Api/Program.cs`](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Api/Program.cs) (API host), [`src/Frontend/DongNamTrip.Spa/src/app/App.tsx`](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Frontend/DongNamTrip.Spa/src/app/App.tsx) (Customer SPA), [`src/Frontend/DongNamTrip.Admin/Program.cs`](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Frontend/DongNamTrip.Admin/Program.cs) (Admin app), [`src/Backend/DongNamTrip.Modules/Catalog`](https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Catalog) (Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User applications"]
  node_spa["Customer SPA<br/>[App.tsx]"]
  node_adminapp["Admin app<br/>[Program.cs]"]
end

subgraph group_platform["Web and API platform"]
  node_bff["Web BFF<br/>[Program.cs]"]
  node_apihost["API host<br/>[Program.cs]"]
  node_contracts["Shared contracts<br/>[Models.cs]"]
  node_database[("SQL Server")]
end

subgraph group_travel["Travel planning"]
  node_catalog["Catalog<br/>[Catalog]"]
  node_itinerary["Itinerary<br/>[Itinerary]"]
  node_cataloglogic["Catalog services<br/>[BusinessLogic]"]
  node_catalogdata["Catalog data access"]
end

subgraph group_operations["Bookings and quotations"]
  node_booking["Booking<br/>[Booking]"]
  node_quotation["Quotation<br/>[Quotation]"]
  node_bookingadmin["Booking operations"]
  node_bookingdata["Booking data access"]
end

subgraph group_content["Content and administration"]
  node_narration["Narration<br/>[Narration]"]
  node_administration["Administration<br/>[Administration]"]
  node_narrationlogic["Narration services"]
  node_narrationdata["Narration data access"]
end

node_traveler(("Traveler"))
node_staff(("Staff"))

node_traveler -->|"uses"| node_spa
node_staff -->|"uses"| node_adminapp
node_spa -->|"accesses"| node_bff
node_bff -->|"forwards requests"| node_apihost
node_adminapp -->|"accesses"| node_apihost
node_apihost -->|"registers and routes"| node_catalog
node_apihost -->|"registers and routes"| node_itinerary
node_apihost -->|"registers and routes"| node_booking
node_apihost -->|"registers and routes"| node_quotation
node_apihost -->|"registers and routes"| node_narration
node_apihost -->|"registers and routes"| node_administration
node_apihost -->|"configures SQL access"| node_database
node_catalog -->|"organizes business logic"| node_cataloglogic
node_cataloglogic -->|"uses data access"| node_catalogdata
node_catalogdata -->|"reads catalog data"| node_database
node_booking -->|"organizes business logic"| node_bookingadmin
node_bookingadmin -->|"calls repository"| node_bookingdata
node_bookingdata -->|"reads and writes"| node_database
node_narration -->|"organizes business logic"| node_narrationlogic
node_narrationlogic -->|"uses repository"| node_narrationdata
node_narrationdata -->|"reads and writes"| node_database
node_catalog -.->|"supports itinerary planning"| node_itinerary
node_quotation -.->|"accepts quote into order"| node_booking
node_spa -->|"discovers tours and destinations"| node_catalog
node_spa -->|"manages personal plans"| node_itinerary
node_spa -->|"views booking history"| node_booking
node_spa -->|"requests private tours"| node_quotation
node_spa -->|"listens to published audio"| node_narration
node_adminapp -->|"manages accounts"| node_administration
node_adminapp -->|"manages catalog"| node_catalog
node_adminapp -->|"handles booking operations"| node_booking
node_adminapp -->|"edits narration"| node_narration

click node_spa "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Frontend/DongNamTrip.Spa/src/app/App.tsx"
click node_adminapp "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Frontend/DongNamTrip.Admin/Program.cs"
click node_bff "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Frontend/DongNamTrip.Web/Program.cs"
click node_apihost "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Api/Program.cs"
click node_contracts "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Shared/DongNamTrip.Contracts/Models.cs"
click node_catalog "https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Catalog"
click node_itinerary "https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Itinerary"
click node_booking "https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Booking"
click node_quotation "https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Quotation"
click node_narration "https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Narration"
click node_administration "https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Administration"
click node_cataloglogic "https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Catalog/BusinessLogic"
click node_catalogdata "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Catalog/DataAccess/CatalogRepository.cs"
click node_bookingadmin "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Booking/BusinessLogic/BookingAdminService.cs"
click node_bookingdata "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Booking/DataAccess/BookingRepository.cs"
click node_narrationlogic "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Narration/BusinessLogic/NarrationService.cs"
click node_narrationdata "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Narration/DataAccess/NarrationRepository.cs"
click node_database "https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Persistence/DongNamTripDbContext.cs"

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_spa,node_adminapp toneBlue
class node_bff,node_apihost,node_contracts,node_database toneAmber
class node_catalog,node_itinerary,node_cataloglogic,node_catalogdata toneMint
class node_booking,node_quotation,node_bookingadmin,node_bookingdata toneRose
class node_narration,node_administration,node_narrationlogic,node_narrationdata,node_traveler,node_staff toneIndigo
```

## Components

### User applications

- [Customer SPA](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Frontend/DongNamTrip.Spa/src/app/App.tsx): `src/Frontend/DongNamTrip.Spa/src/app/App.tsx`
- [Admin app](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Frontend/DongNamTrip.Admin/Program.cs): `src/Frontend/DongNamTrip.Admin/Program.cs`

### Web and API platform

- [Web BFF](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Frontend/DongNamTrip.Web/Program.cs): `src/Frontend/DongNamTrip.Web/Program.cs`
- [API host](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Api/Program.cs): `src/Backend/DongNamTrip.Api/Program.cs`
- [Shared contracts](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Shared/DongNamTrip.Contracts/Models.cs): `src/Shared/DongNamTrip.Contracts/Models.cs`
- [SQL Server](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Persistence/DongNamTripDbContext.cs): `src/Backend/DongNamTrip.Modules/Persistence/DongNamTripDbContext.cs`

### Travel planning

- [Catalog](https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Catalog): `src/Backend/DongNamTrip.Modules/Catalog`
- [Itinerary](https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Itinerary): `src/Backend/DongNamTrip.Modules/Itinerary`
- [Catalog services](https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Catalog/BusinessLogic): `src/Backend/DongNamTrip.Modules/Catalog/BusinessLogic`
- [Catalog data access](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Catalog/DataAccess/CatalogRepository.cs): `src/Backend/DongNamTrip.Modules/Catalog/DataAccess/CatalogRepository.cs`

### Bookings and quotations

- [Booking](https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Booking): `src/Backend/DongNamTrip.Modules/Booking`
- [Quotation](https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Quotation): `src/Backend/DongNamTrip.Modules/Quotation`
- [Booking operations](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Booking/BusinessLogic/BookingAdminService.cs): `src/Backend/DongNamTrip.Modules/Booking/BusinessLogic/BookingAdminService.cs`
- [Booking data access](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Booking/DataAccess/BookingRepository.cs): `src/Backend/DongNamTrip.Modules/Booking/DataAccess/BookingRepository.cs`

### Content and administration

- [Narration](https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Narration): `src/Backend/DongNamTrip.Modules/Narration`
- [Administration](https://github.com/k-sewii/tour-booking-management-system/tree/main/src/Backend/DongNamTrip.Modules/Administration): `src/Backend/DongNamTrip.Modules/Administration`
- [Narration services](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Narration/BusinessLogic/NarrationService.cs): `src/Backend/DongNamTrip.Modules/Narration/BusinessLogic/NarrationService.cs`
- [Narration data access](https://github.com/k-sewii/tour-booking-management-system/blob/main/src/Backend/DongNamTrip.Modules/Narration/DataAccess/NarrationRepository.cs): `src/Backend/DongNamTrip.Modules/Narration/DataAccess/NarrationRepository.cs`

### Other components

- **Traveler**
- **Staff**

## Connections

- Traveler → Customer SPA: uses (evidence: `README.md`)
- Staff → Admin app: uses (evidence: `README.md`)
- Customer SPA → Web BFF: accesses (evidence: `README.md`)
- Web BFF → API host: forwards requests (evidence: `README.md`)
- Admin app → API host: accesses (evidence: `README.md`)
- API host → Catalog: registers and routes (evidence: `src/Backend/DongNamTrip.Api/Program.cs`)
- API host → Itinerary: registers and routes (evidence: `src/Backend/DongNamTrip.Api/Program.cs`)
- API host → Booking: registers and routes (evidence: `src/Backend/DongNamTrip.Api/Program.cs`)
- API host → Quotation: registers and routes (evidence: `src/Backend/DongNamTrip.Api/Program.cs`)
- API host → Narration: registers and routes (evidence: `src/Backend/DongNamTrip.Api/Program.cs`)
- API host → Administration: registers and routes (evidence: `src/Backend/DongNamTrip.Api/Program.cs`)
- API host → SQL Server: configures SQL access (evidence: `src/Backend/DongNamTrip.Api/Program.cs`)
- Catalog → Catalog services: organizes business logic (evidence: `README.md`)
- Catalog services → Catalog data access: uses data access (evidence: `README.md`)
- Catalog data access → SQL Server: reads catalog data (evidence: `src/Backend/DongNamTrip.Modules/Catalog/DataAccess/CatalogRepository.cs`)
- Booking → Booking operations: organizes business logic (evidence: `README.md`)
- Booking operations → Booking data access: calls repository (evidence: `src/Backend/DongNamTrip.Modules/Booking/BusinessLogic/BookingAdminService.cs`)
- Booking data access → SQL Server: reads and writes (evidence: `src/Backend/DongNamTrip.Modules/Booking/DataAccess/BookingRepository.cs`)
- Narration → Narration services: organizes business logic (evidence: `README.md`)
- Narration services → Narration data access: uses repository (evidence: `src/Backend/DongNamTrip.Modules/Narration/BusinessLogic/NarrationService.cs`)
- Narration data access → SQL Server: reads and writes (evidence: `src/Backend/DongNamTrip.Modules/Narration/DataAccess/NarrationRepository.cs`)
- Catalog → Itinerary: supports itinerary planning (evidence: `README.md`)
- Quotation → Booking: accepts quote into order (evidence: `README.md`)
- Customer SPA → Catalog: discovers tours and destinations (evidence: `README.md`)
- Customer SPA → Itinerary: manages personal plans (evidence: `README.md`)
- Customer SPA → Booking: views booking history (evidence: `README.md`)
- Customer SPA → Quotation: requests private tours (evidence: `README.md`)
- Customer SPA → Narration: listens to published audio (evidence: `README.md`)
- Admin app → Administration: manages accounts (evidence: `README.md`)
- Admin app → Catalog: manages catalog (evidence: `README.md`)
- Admin app → Booking: handles booking operations (evidence: `README.md`)
- Admin app → Narration: edits narration (evidence: `README.md`)
