# balasutharsan1247/heritage-monument-booking-system architecture

> Architecture diagram of the GitHub repository balasutharsan1247/heritage-monument-booking-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/balasutharsan1247/heritage-monument-booking-system
- Repository: https://github.com/balasutharsan1247/heritage-monument-booking-system

## Overview

This is a heritage-monument visitor portal with staff queue operations and administration. Visitors browse monuments, authenticate, book time-slotted tickets (including wallet payment), receive QR-backed tickets, and follow queues; staff call, validate, and complete visits. Admins manage monuments and inspect operational analytics and predictions. The graph follows only evidenced frontend routes, backend mounts, and sampled controller/model interactions; unsampled feature links are omitted where their caller is not visible.

Main entry points: [`frontend/src/App.jsx`](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/App.jsx) (Portal routing), [`backend/src/controllers/ticketController.js`](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/ticketController.js) (Ticket lifecycle), [`backend/src/controllers/adminDashboardController.js`](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/adminDashboardController.js) (Dashboard analytics), [`frontend/src/api/index.js`](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/api/index.js) (HTTP API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_visitor["Visitor portal"]
  node_app["Portal routing<br/>[App.jsx]"]
  node_catalog["Monument browsing<br/>[Monuments.jsx]"]
  node_booking["Ticket booking<br/>[Booking.jsx]"]
  node_tickets["Ticket access<br/>[MyTickets.jsx]"]
  node_wallet["Wallet UI<br/>[Wallet.jsx]"]
end

subgraph group_operations["Queue operations"]
  node_staff["Staff queue<br/>[StaffQueue.jsx]"]
  node_validation["Ticket validation<br/>[StaffValidate.jsx]"]
  node_publicqueue["Public queue display<br/>[PublicQueue.jsx]"]
end

subgraph group_admin["Administration"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_predictionui["Prediction view"]
end

subgraph group_server["Backend services"]
  node_api["HTTP API client<br/>[index.js]"]
  node_backend["API application<br/>[app.js]"]
  node_auth["Access control<br/>[authMiddleware.js]"]
  node_monumentctl["Monument handlers"]
  node_ticketctl["Ticket lifecycle"]
  node_queuectl["Queue management<br/>[queueController.js]"]
  node_staffticket["Staff ticket service"]
  node_dashboardctl["Dashboard analytics"]
  node_predictionctl["Prediction service<br/>[modelService.js]"]
end

subgraph group_data["Persistent data"]
  node_monumentdata[("Monuments<br/>[Monument.js]")]
  node_ticketdata[("Tickets<br/>[Ticket.js]")]
  node_queuedata[("Queue entries<br/>[QueueEntry.js]")]
  node_userdata[("Users<br/>[User.js]")]
  node_walletdata[("Wallet balances<br/>[Wallet.js]")]
  node_transactions[("Wallet transactions")]
end

node_visitor(("Visitors"))

node_visitor -->|"opens portal"| node_app
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_booking
node_app -->|"routes to"| node_tickets
node_app -->|"routes to"| node_wallet
node_app -->|"routes to"| node_staff
node_app -->|"routes to"| node_validation
node_app -->|"routes to"| node_publicqueue
node_app -->|"routes to"| node_adminui
node_app -.->|"uses"| node_api
node_catalog -.->|"requests data"| node_api
node_booking -.->|"submits booking"| node_api
node_wallet -.->|"requests wallet"| node_api
node_staff -.->|"requests queue"| node_api
node_validation -->|"validates ticket"| node_api
node_adminui -.->|"renders"| node_predictionui
node_api -.->|"calls API"| node_backend
node_backend -->|"mounts routes"| node_monumentctl
node_backend -->|"mounts routes"| node_ticketctl
node_backend -->|"mounts routes"| node_queuectl
node_backend -->|"mounts routes"| node_dashboardctl
node_backend -->|"mounts prediction routes"| node_predictionctl
node_ticketctl -->|"routes protect"| node_auth
node_queuectl -->|"routes protect"| node_auth
node_dashboardctl -->|"routes protect"| node_auth
node_ticketctl -->|"reads"| node_monumentdata
node_ticketctl -->|"creates and updates"| node_ticketdata
node_ticketctl -->|"creates and deletes"| node_queuedata
node_ticketctl -->|"debits and refunds"| node_walletdata
node_ticketctl -->|"records payment"| node_transactions
node_ticketctl -->|"reads admin"| node_userdata
node_queuectl -->|"manages entries"| node_queuedata
node_queuectl -->|"reads ticket"| node_ticketdata
node_queuectl -->|"checks staff"| node_userdata
node_staffticket -->|"uses"| node_ticketdata
node_staffticket -->|"uses"| node_monumentdata
node_staffticket -->|"uses"| node_queuedata
node_staffticket -->|"uses"| node_userdata
node_dashboardctl -->|"aggregates"| node_ticketdata
node_dashboardctl -->|"aggregates"| node_queuedata
node_dashboardctl -->|"queries"| node_monumentdata
node_dashboardctl -->|"counts"| node_userdata
node_dashboardctl -->|"reads"| node_walletdata
node_predictionctl -.->|"supplies predictions"| node_predictionui

click node_app "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/App.jsx"
click node_catalog "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/Monuments.jsx"
click node_booking "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/Booking.jsx"
click node_tickets "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/MyTickets.jsx"
click node_wallet "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/Wallet.jsx"
click node_staff "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/StaffQueue.jsx"
click node_validation "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/StaffValidate.jsx"
click node_publicqueue "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/PublicQueue.jsx"
click node_adminui "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_predictionui "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/components/AdminPredictionView.jsx"
click node_api "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/api/index.js"
click node_backend "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/app.js"
click node_auth "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/middleware/authMiddleware.js"
click node_monumentctl "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/monumentController.js"
click node_ticketctl "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/ticketController.js"
click node_queuectl "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/queueController.js"
click node_staffticket "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/services/staffTicketService.js"
click node_dashboardctl "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/adminDashboardController.js"
click node_predictionctl "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/services/modelService.js"
click node_monumentdata "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/Monument.js"
click node_ticketdata "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/Ticket.js"
click node_queuedata "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/QueueEntry.js"
click node_userdata "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/User.js"
click node_walletdata "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/Wallet.js"
click node_transactions "https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/WalletTransaction.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_app,node_catalog,node_booking,node_tickets,node_wallet toneBlue
class node_staff,node_validation,node_publicqueue toneAmber
class node_adminui,node_predictionui toneMint
class node_api,node_backend,node_auth,node_monumentctl,node_ticketctl,node_queuectl,node_staffticket,node_dashboardctl,node_predictionctl toneRose
class node_monumentdata,node_ticketdata,node_queuedata,node_userdata,node_walletdata,node_transactions,node_visitor toneIndigo
```

## Components

### Visitor portal

- [Portal routing](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Monument browsing](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/Monuments.jsx): `frontend/src/pages/Monuments.jsx`
- [Ticket booking](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/Booking.jsx): `frontend/src/pages/Booking.jsx`
- [Ticket access](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/MyTickets.jsx): `frontend/src/pages/MyTickets.jsx`
- [Wallet UI](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/Wallet.jsx): `frontend/src/pages/Wallet.jsx`

### Queue operations

- [Staff queue](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/StaffQueue.jsx): `frontend/src/pages/StaffQueue.jsx`
- [Ticket validation](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/StaffValidate.jsx): `frontend/src/pages/StaffValidate.jsx`
- [Public queue display](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/PublicQueue.jsx): `frontend/src/pages/PublicQueue.jsx`

### Administration

- [Admin dashboard](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Prediction view](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/components/AdminPredictionView.jsx): `frontend/src/components/AdminPredictionView.jsx`

### Backend services

- [HTTP API client](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/frontend/src/api/index.js): `frontend/src/api/index.js`
- [API application](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/app.js): `backend/src/app.js`
- [Access control](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`
- [Monument handlers](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/monumentController.js): `backend/src/controllers/monumentController.js`
- [Ticket lifecycle](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/ticketController.js): `backend/src/controllers/ticketController.js`
- [Queue management](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/queueController.js): `backend/src/controllers/queueController.js`
- [Staff ticket service](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/services/staffTicketService.js): `backend/src/services/staffTicketService.js`
- [Dashboard analytics](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/controllers/adminDashboardController.js): `backend/src/controllers/adminDashboardController.js`
- [Prediction service](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/services/modelService.js): `backend/src/services/modelService.js`

### Persistent data

- [Monuments](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/Monument.js): `backend/src/models/Monument.js`
- [Tickets](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/Ticket.js): `backend/src/models/Ticket.js`
- [Queue entries](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/QueueEntry.js): `backend/src/models/QueueEntry.js`
- [Users](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/User.js): `backend/src/models/User.js`
- [Wallet balances](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/Wallet.js): `backend/src/models/Wallet.js`
- [Wallet transactions](https://github.com/balasutharsan1247/heritage-monument-booking-system/blob/main/backend/src/models/WalletTransaction.js): `backend/src/models/WalletTransaction.js`

### Other components

- **Visitors**

## Connections

- Visitors → Portal routing: opens portal (evidence: `frontend/src/App.jsx`)
- Portal routing → Monument browsing: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Ticket booking: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Ticket access: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Wallet UI: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Staff queue: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Ticket validation: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Public queue display: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → HTTP API client: uses
- Monument browsing → HTTP API client: requests data
- Ticket booking → HTTP API client: submits booking
- Wallet UI → HTTP API client: requests wallet
- Staff queue → HTTP API client: requests queue
- Ticket validation → HTTP API client: validates ticket (evidence: `frontend/src/pages/StaffValidate.jsx`)
- Admin dashboard → Prediction view: renders
- HTTP API client → API application: calls API
- API application → Monument handlers: mounts routes (evidence: `backend/src/app.js`)
- API application → Ticket lifecycle: mounts routes (evidence: `backend/src/app.js`)
- API application → Queue management: mounts routes (evidence: `backend/src/app.js`)
- API application → Dashboard analytics: mounts routes (evidence: `backend/src/app.js`)
- API application → Prediction service: mounts prediction routes (evidence: `backend/src/app.js`)
- Ticket lifecycle → Access control: routes protect (evidence: `backend/src/routes/ticketRoutes.js`)
- Queue management → Access control: routes protect (evidence: `backend/src/routes/queueRoutes.js`)
- Dashboard analytics → Access control: routes protect (evidence: `backend/src/routes/adminDashboardRoutes.js`)
- Ticket lifecycle → Monuments: reads (evidence: `backend/src/controllers/ticketController.js`)
- Ticket lifecycle → Tickets: creates and updates (evidence: `backend/src/controllers/ticketController.js`)
- Ticket lifecycle → Queue entries: creates and deletes (evidence: `backend/src/controllers/ticketController.js`)
- Ticket lifecycle → Wallet balances: debits and refunds (evidence: `backend/src/controllers/ticketController.js`)
- Ticket lifecycle → Wallet transactions: records payment (evidence: `backend/src/controllers/ticketController.js`)
- Ticket lifecycle → Users: reads admin (evidence: `backend/src/controllers/ticketController.js`)
- Queue management → Queue entries: manages entries (evidence: `backend/src/controllers/queueController.js`)
- Queue management → Tickets: reads ticket (evidence: `backend/src/controllers/queueController.js`)
- Queue management → Users: checks staff (evidence: `backend/src/controllers/queueController.js`)
- Staff ticket service → Tickets: uses (evidence: `backend/src/services/staffTicketService.js`)
- Staff ticket service → Monuments: uses (evidence: `backend/src/services/staffTicketService.js`)
- Staff ticket service → Queue entries: uses (evidence: `backend/src/services/staffTicketService.js`)
- Staff ticket service → Users: uses (evidence: `backend/src/services/staffTicketService.js`)
- Dashboard analytics → Tickets: aggregates (evidence: `backend/src/controllers/adminDashboardController.js`)
- Dashboard analytics → Queue entries: aggregates (evidence: `backend/src/controllers/adminDashboardController.js`)
- Dashboard analytics → Monuments: queries (evidence: `backend/src/controllers/adminDashboardController.js`)
- Dashboard analytics → Users: counts (evidence: `backend/src/controllers/adminDashboardController.js`)
- Dashboard analytics → Wallet balances: reads (evidence: `backend/src/controllers/adminDashboardController.js`)
- Prediction service → Prediction view: supplies predictions
