How balasutharsan1247/heritage-monument-booking-system works
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: App.jsx Portal routing · ticketController.js Ticket lifecycle · adminDashboardController.js Dashboard analytics · index.js HTTP API client
Components 26
Visitor portal
- Portal routing
frontend/src/App.jsx - Monument browsing
frontend/src/pages/Monuments.jsx - Ticket booking
frontend/src/pages/Booking.jsx - Ticket access
frontend/src/pages/MyTickets.jsx - Wallet UI
frontend/src/pages/Wallet.jsx
Queue operations
- Staff queue
frontend/src/pages/StaffQueue.jsx - Ticket validation
frontend/src/pages/StaffValidate.jsx - Public queue display
frontend/src/pages/PublicQueue.jsx
Administration
- Admin dashboard
frontend/src/pages/AdminDashboard.jsx - Prediction view
frontend/src/components/AdminPredictionView.jsx
Backend services
- HTTP API client
frontend/src/api/index.js - API application
backend/src/app.js - Access control
backend/src/middleware/authMiddleware.js - Monument handlers
backend/src/controllers/monumentController.js - Ticket lifecycle
backend/src/controllers/ticketController.js - Queue management
backend/src/controllers/queueController.js - Staff ticket service
backend/src/services/staffTicketService.js - Dashboard analytics
backend/src/controllers/adminDashboardController.js - Prediction service
backend/src/services/modelService.js
Persistent data
- Monuments
backend/src/models/Monument.js - Tickets
backend/src/models/Ticket.js - Queue entries
backend/src/models/QueueEntry.js - Users
backend/src/models/User.js - Wallet balances
backend/src/models/Wallet.js - Wallet transactions
backend/src/models/WalletTransaction.js
Other components
- Visitors
Connections 44
- Visitors → Portal routing: opens portal
frontend/src/App.jsx - Portal routing → Monument browsing: routes to
frontend/src/App.jsx - Portal routing → Ticket booking: routes to
frontend/src/App.jsx - Portal routing → Ticket access: routes to
frontend/src/App.jsx - Portal routing → Wallet UI: routes to
frontend/src/App.jsx - Portal routing → Staff queue: routes to
frontend/src/App.jsx - Portal routing → Ticket validation: routes to
frontend/src/App.jsx - Portal routing → Public queue display: routes to
frontend/src/App.jsx - Portal routing → Admin dashboard: routes to
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
frontend/src/pages/StaffValidate.jsx - Admin dashboard → Prediction view: renders
- HTTP API client → API application: calls API
- API application → Monument handlers: mounts routes
backend/src/app.js - API application → Ticket lifecycle: mounts routes
backend/src/app.js - API application → Queue management: mounts routes
backend/src/app.js - API application → Dashboard analytics: mounts routes
backend/src/app.js - API application → Prediction service: mounts prediction routes
backend/src/app.js - Ticket lifecycle → Access control: routes protect
backend/src/routes/ticketRoutes.js - Queue management → Access control: routes protect
backend/src/routes/queueRoutes.js - Dashboard analytics → Access control: routes protect
backend/src/routes/adminDashboardRoutes.js - Ticket lifecycle → Monuments: reads
backend/src/controllers/ticketController.js - Ticket lifecycle → Tickets: creates and updates
backend/src/controllers/ticketController.js - Ticket lifecycle → Queue entries: creates and deletes
backend/src/controllers/ticketController.js - Ticket lifecycle → Wallet balances: debits and refunds
backend/src/controllers/ticketController.js - Ticket lifecycle → Wallet transactions: records payment
backend/src/controllers/ticketController.js - Ticket lifecycle → Users: reads admin
backend/src/controllers/ticketController.js - Queue management → Queue entries: manages entries
backend/src/controllers/queueController.js - Queue management → Tickets: reads ticket
backend/src/controllers/queueController.js - Queue management → Users: checks staff
backend/src/controllers/queueController.js - Staff ticket service → Tickets: uses
backend/src/services/staffTicketService.js - Staff ticket service → Monuments: uses
backend/src/services/staffTicketService.js - Staff ticket service → Queue entries: uses
backend/src/services/staffTicketService.js - Staff ticket service → Users: uses
backend/src/services/staffTicketService.js - Dashboard analytics → Tickets: aggregates
backend/src/controllers/adminDashboardController.js - Dashboard analytics → Queue entries: aggregates
backend/src/controllers/adminDashboardController.js - Dashboard analytics → Monuments: queries
backend/src/controllers/adminDashboardController.js - Dashboard analytics → Users: counts
backend/src/controllers/adminDashboardController.js - Dashboard analytics → Wallet balances: reads
backend/src/controllers/adminDashboardController.js - Prediction service → Prediction view: supplies predictions