# haidang711/nguyenhaidang-24ct2-cnpm-dau architecture

> Architecture diagram of the GitHub repository haidang711/nguyenhaidang-24ct2-cnpm-dau, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/haidang711/nguyenhaidang-24ct2-cnpm-dau
- Repository: https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau

## Overview

This is a Spring Boot tour-booking application with a static browser frontend. Customers browse and inspect tours, register or sign in, create bookings, manage cancellation/payment requests, and submit reviews; staff and administrators manage bookings, tours, customers, and staff. The sampled controllers show the backend and persistence interactions, while the frontend scripts and some endpoints are known only from the source index and tree, so those client-to-API links are documented as unverified.

Main entry points: [`24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/api.js`](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/api.js) (API client), [`24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java`](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java) (Tour queries), [`24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AdminController.java`](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AdminController.java) (Admin operations), [`24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/UserRepository.java`](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/UserRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer experience"]
  node_web["Customer pages"]
  node_webapi["API client<br/>[api.js]"]
  node_authui["Account pages<br/>[register.js]"]
  node_profileui["Profile bookings<br/>[profile.js]"]
  node_auth["User authentication"]
end

subgraph group_operations["Booking operations"]
  node_bookingui["Booking form<br/>[booking.js]"]
  node_booking["Booking lifecycle"]
  node_reviews["Review submission"]
end

subgraph group_catalog["Tour catalog"]
  node_tourui["Tour browsing<br/>[tour.js]"]
  node_tours["Tour queries"]
end

subgraph group_admin["Administration"]
  node_adminui["Admin console"]
  node_admincontroller["Admin operations"]
end

subgraph group_persistence["Persistence"]
  node_users["User accounts<br/>[User.java]"]
  node_admins["Admin accounts<br/>[Admin.java]"]
  node_bookings["Bookings<br/>[Booking.java]"]
  node_tourmodel["Tours<br/>[Tour.java]"]
  node_packages["Tour packages<br/>[TourPackage.java]"]
  node_reviewmodel["Reviews<br/>[Review.java]"]
  node_userrepo["User repository"]
  node_adminrepo["Admin repository"]
  node_bookingrepo["Booking repository"]
  node_tourrepo["Tour repository"]
  node_packagerepo["Package repository"]
  node_reviewrepo["Review repository"]
  node_database[("Relational database")]
end

node_visitor(("Customer"))

node_visitor -->|"uses"| node_web
node_web -.->|"calls"| node_webapi
node_authui -.->|"uses"| node_webapi
node_profileui -.->|"uses"| node_webapi
node_tourui -.->|"uses"| node_webapi
node_bookingui -.->|"uses"| node_webapi
node_webapi -.->|"HTTP requests"| node_auth
node_webapi -.->|"HTTP requests"| node_tours
node_webapi -.->|"HTTP requests"| node_booking
node_webapi -.->|"HTTP requests"| node_reviews
node_adminui -.->|"HTTP requests"| node_admincontroller
node_auth -->|"queries"| node_userrepo
node_booking -->|"reads and writes"| node_bookingrepo
node_booking -->|"looks up tours"| node_tourrepo
node_booking -->|"validates package"| node_packagerepo
node_reviews -->|"checks booking"| node_bookingrepo
node_reviews -->|"checks and saves"| node_reviewrepo
node_tours -->|"queries catalog"| node_tourrepo
node_tours -->|"loads packages"| node_packagerepo
node_tours -->|"loads reviews"| node_reviewrepo
node_tours -->|"loads reviewers"| node_userrepo
node_admincontroller -->|"authenticates and manages"| node_adminrepo
node_admincontroller -.->|"manages bookings"| node_bookingrepo
node_admincontroller -.->|"manages tours"| node_tourrepo
node_admincontroller -.->|"manages customers"| node_userrepo
node_userrepo -->|"persists"| node_users
node_adminrepo -->|"persists"| node_admins
node_bookingrepo -->|"persists"| node_bookings
node_tourrepo -->|"persists"| node_tourmodel
node_packagerepo -->|"persists"| node_packages
node_reviewrepo -->|"persists"| node_reviewmodel
node_userrepo -.->|"database access"| node_database

click node_web "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/tree/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend"
click node_webapi "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/api.js"
click node_authui "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/register.js"
click node_profileui "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/profile.js"
click node_tourui "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/tour.js"
click node_bookingui "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/booking.js"
click node_auth "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AuthController.java"
click node_tours "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java"
click node_booking "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/BookingController.java"
click node_reviews "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/ReviewController.java"
click node_adminui "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/tree/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/admin"
click node_admincontroller "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AdminController.java"
click node_users "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/User.java"
click node_admins "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Admin.java"
click node_bookings "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Booking.java"
click node_tourmodel "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Tour.java"
click node_packages "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/TourPackage.java"
click node_reviewmodel "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Review.java"
click node_userrepo "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/UserRepository.java"
click node_adminrepo "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/AdminRepository.java"
click node_bookingrepo "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/BookingRepository.java"
click node_tourrepo "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/TourRepository.java"
click node_packagerepo "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/TourPackageRepository.java"
click node_reviewrepo "https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/ReviewRepository.java"

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_web,node_webapi,node_authui,node_profileui,node_auth toneBlue
class node_bookingui,node_booking,node_reviews toneAmber
class node_tourui,node_tours toneMint
class node_adminui,node_admincontroller toneRose
class node_users,node_admins,node_bookings,node_tourmodel,node_packages,node_reviewmodel,node_userrepo,node_adminrepo,node_bookingrepo,node_tourrepo,node_packagerepo,node_reviewrepo,node_database,node_visitor toneIndigo
```

## Components

### Customer experience

- [Customer pages](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/tree/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend): `24CT2_NguyenHaiDang/src/main/resources/static/frontend`
- [API client](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/api.js): `24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/api.js`
- [Account pages](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/register.js): `24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/register.js`
- [Profile bookings](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/profile.js): `24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/profile.js`
- [User authentication](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AuthController.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AuthController.java`

### Booking operations

- [Booking form](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/booking.js): `24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/booking.js`
- [Booking lifecycle](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/BookingController.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/BookingController.java`
- [Review submission](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/ReviewController.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/ReviewController.java`

### Tour catalog

- [Tour browsing](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/tour.js): `24CT2_NguyenHaiDang/src/main/resources/static/frontend/js/tour.js`
- [Tour queries](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java`

### Administration

- [Admin console](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/tree/main/24CT2_NguyenHaiDang/src/main/resources/static/frontend/admin): `24CT2_NguyenHaiDang/src/main/resources/static/frontend/admin`
- [Admin operations](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AdminController.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AdminController.java`

### Persistence

- [User accounts](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/User.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/User.java`
- [Admin accounts](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Admin.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Admin.java`
- [Bookings](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Booking.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Booking.java`
- [Tours](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Tour.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Tour.java`
- [Tour packages](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/TourPackage.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/TourPackage.java`
- [Reviews](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Review.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/model/Review.java`
- [User repository](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/UserRepository.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/UserRepository.java`
- [Admin repository](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/AdminRepository.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/AdminRepository.java`
- [Booking repository](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/BookingRepository.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/BookingRepository.java`
- [Tour repository](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/TourRepository.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/TourRepository.java`
- [Package repository](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/TourPackageRepository.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/TourPackageRepository.java`
- [Review repository](https://github.com/haidang711/nguyenhaidang-24ct2-cnpm-dau/blob/main/24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/ReviewRepository.java): `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/ReviewRepository.java`
- **Relational database**

### Other components

- **Customer**

## Connections

- Customer → Customer pages: uses
- Customer pages → API client: calls
- Account pages → API client: uses
- Profile bookings → API client: uses
- Tour browsing → API client: uses
- Booking form → API client: uses
- API client → User authentication: HTTP requests
- API client → Tour queries: HTTP requests
- API client → Booking lifecycle: HTTP requests
- API client → Review submission: HTTP requests
- Admin console → Admin operations: HTTP requests
- User authentication → User repository: queries (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AuthController.java`)
- Booking lifecycle → Booking repository: reads and writes (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/BookingController.java`)
- Booking lifecycle → Tour repository: looks up tours (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/BookingController.java`)
- Booking lifecycle → Package repository: validates package (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/BookingController.java`)
- Review submission → Booking repository: checks booking (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/ReviewController.java`)
- Review submission → Review repository: checks and saves (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/ReviewController.java`)
- Tour queries → Tour repository: queries catalog (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java`)
- Tour queries → Package repository: loads packages (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java`)
- Tour queries → Review repository: loads reviews (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java`)
- Tour queries → User repository: loads reviewers (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/TourController.java`)
- Admin operations → Admin repository: authenticates and manages (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/controller/AdminController.java`)
- Admin operations → Booking repository: manages bookings
- Admin operations → Tour repository: manages tours
- Admin operations → User repository: manages customers
- User repository → User accounts: persists (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/UserRepository.java`)
- Admin repository → Admin accounts: persists (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/AdminRepository.java`)
- Booking repository → Bookings: persists (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/BookingRepository.java`)
- Tour repository → Tours: persists (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/TourRepository.java`)
- Package repository → Tour packages: persists (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/TourPackageRepository.java`)
- Review repository → Reviews: persists (evidence: `24CT2_NguyenHaiDang/src/main/java/com/dangbooking/tour/repository/ReviewRepository.java`)
- User repository → Relational database: database access
