# aminulmunnadev/booking-system architecture

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

- Interactive diagram: https://gitdiagram.com/aminulmunnadev/booking-system
- Repository: https://github.com/aminulmunnadev/booking-system

## Overview

This is a bus-ticket booking web application: travelers search routes and trips, inspect seat availability, book seats, then review or cancel bookings; administrators manage buses, routes, trips, users, bookings, and dashboard statistics. The backend exposes these capabilities through Express routes and controllers backed by Prisma, while the Next.js frontend has corresponding traveler and admin pages. Backend route and controller links are supported by excerpts or the source index. Frontend-to-API wiring is not shown in the sampled files, so those links are marked unverified.

Main entry points: [`backend/src/routes/admin.routes.js`](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/admin.routes.js) (Admin routes), [`backend/src/config/prisma.js`](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/config/prisma.js) (Prisma client), [`backend/src/app.js`](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/app.js) (Express application), [`backend/src/routes/auth.routes.js`](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/auth.routes.js) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_traveler["Traveler experience"]
  node_traveler["Traveler pages"]
  node_search_ui["Trip search UI"]
  node_seat_ui["Seat selection<br/>[SeatGrid.js]"]
  node_auth_ui["Sign-in and registration<br/>[page.js]"]
  node_auth_state["Auth state<br/>[AuthContext.js]"]
end

subgraph group_admin["Admin operations"]
  node_admin_ui["Admin pages"]
  node_admin_components["Admin components"]
  node_admin_trip["Trip management"]
  node_admin_booking["Booking management"]
  node_admin_resources["Fleet and user management"]
  node_statistics["Dashboard statistics"]
end

subgraph group_api["API and access"]
  node_api_client["API client<br/>[api.js]"]
  node_express_app["Express application<br/>[app.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_public_routes["Public trip routes<br/>[public.routes.js]"]
  node_booking_routes["Booking routes<br/>[bookings.routes.js]"]
  node_admin_routes["Admin routes<br/>[admin.routes.js]"]
  node_auth_middleware["Token and role checks<br/>[auth.js]"]
  node_validation["Request validation<br/>[validate.js]"]
end

subgraph group_domain["Booking domain"]
  node_auth_controller["Authentication<br/>[auth.controller.js]"]
  node_trip_controller["Trip discovery"]
  node_booking_controller["Booking lifecycle"]
  node_prisma["Prisma client<br/>[prisma.js]"]
  node_booking_helpers["Booking helpers<br/>[cancelBooking.js]"]
end

node_mysql[("MySQL database")]

node_express_app -->|"mounts"| node_auth_routes
node_express_app -->|"mounts"| node_admin_routes
node_express_app -->|"mounts"| node_public_routes
node_express_app -->|"mounts"| node_booking_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"checks identity"| node_auth_middleware
node_auth_routes -->|"validates input"| node_validation
node_public_routes -->|"dispatches"| node_trip_controller
node_booking_routes -->|"dispatches"| node_booking_controller
node_booking_routes -->|"checks identity"| node_auth_middleware
node_booking_routes -->|"validates input"| node_validation
node_admin_routes -->|"dispatches"| node_admin_trip
node_admin_routes -->|"dispatches"| node_admin_booking
node_admin_routes -->|"dispatches"| node_admin_resources
node_admin_routes -->|"dispatches"| node_statistics
node_admin_routes -->|"checks roles"| node_auth_middleware
node_admin_routes -->|"validates input"| node_validation
node_auth_controller -->|"reads and writes"| node_prisma
node_trip_controller -->|"queries trips"| node_prisma
node_booking_controller -->|"reads and writes"| node_prisma
node_admin_trip -->|"manages trips"| node_prisma
node_admin_booking -->|"manages bookings"| node_prisma
node_statistics -->|"queries statistics"| node_prisma
node_booking_controller -->|"cancels bookings"| node_booking_helpers
node_admin_booking -->|"cancels bookings"| node_booking_helpers
node_prisma -->|"connects"| node_mysql
node_traveler -.->|"uses API"| node_api_client
node_admin_ui -.->|"uses API"| node_api_client
node_traveler -.->|"renders"| node_search_ui
node_traveler -.->|"renders"| node_seat_ui
node_auth_ui -.->|"uses auth"| node_auth_state
node_admin_ui -.->|"renders"| node_admin_components

click node_traveler "https://github.com/aminulmunnadev/booking-system/tree/main/frontend/src/app"
click node_search_ui "https://github.com/aminulmunnadev/booking-system/tree/main/frontend/src/components/search"
click node_seat_ui "https://github.com/aminulmunnadev/booking-system/blob/main/frontend/src/components/seats/SeatGrid.js"
click node_auth_ui "https://github.com/aminulmunnadev/booking-system/blob/main/frontend/src/app/login/page.js"
click node_auth_state "https://github.com/aminulmunnadev/booking-system/blob/main/frontend/src/context/AuthContext.js"
click node_api_client "https://github.com/aminulmunnadev/booking-system/blob/main/frontend/src/lib/api.js"
click node_admin_ui "https://github.com/aminulmunnadev/booking-system/tree/main/frontend/src/app/admin"
click node_admin_components "https://github.com/aminulmunnadev/booking-system/tree/main/frontend/src/components/admin"
click node_express_app "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/app.js"
click node_auth_routes "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/auth.routes.js"
click node_public_routes "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/public.routes.js"
click node_booking_routes "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/bookings.routes.js"
click node_admin_routes "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/admin.routes.js"
click node_auth_controller "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/auth.controller.js"
click node_trip_controller "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/trips.controller.js"
click node_booking_controller "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/bookings.controller.js"
click node_admin_trip "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/adminTrip.controller.js"
click node_admin_booking "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/adminBooking.controller.js"
click node_admin_resources "https://github.com/aminulmunnadev/booking-system/tree/main/backend/src/controllers"
click node_statistics "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/stats.controller.js"
click node_auth_middleware "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/middleware/auth.js"
click node_validation "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/middleware/validate.js"
click node_prisma "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/config/prisma.js"
click node_booking_helpers "https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/utils/cancelBooking.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_traveler,node_search_ui,node_seat_ui,node_auth_ui,node_auth_state toneBlue
class node_admin_ui,node_admin_components,node_admin_trip,node_admin_booking,node_admin_resources,node_statistics,node_mysql toneAmber
class node_api_client,node_express_app,node_auth_routes,node_public_routes,node_booking_routes,node_admin_routes,node_auth_middleware,node_validation toneMint
class node_auth_controller,node_trip_controller,node_booking_controller,node_prisma,node_booking_helpers toneRose
```

## Components

### Traveler experience

- [Traveler pages](https://github.com/aminulmunnadev/booking-system/tree/main/frontend/src/app): `frontend/src/app`
- [Trip search UI](https://github.com/aminulmunnadev/booking-system/tree/main/frontend/src/components/search): `frontend/src/components/search`
- [Seat selection](https://github.com/aminulmunnadev/booking-system/blob/main/frontend/src/components/seats/SeatGrid.js): `frontend/src/components/seats/SeatGrid.js`
- [Sign-in and registration](https://github.com/aminulmunnadev/booking-system/blob/main/frontend/src/app/login/page.js): `frontend/src/app/login/page.js`
- [Auth state](https://github.com/aminulmunnadev/booking-system/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`

### Admin operations

- [Admin pages](https://github.com/aminulmunnadev/booking-system/tree/main/frontend/src/app/admin): `frontend/src/app/admin`
- [Admin components](https://github.com/aminulmunnadev/booking-system/tree/main/frontend/src/components/admin): `frontend/src/components/admin`
- [Trip management](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/adminTrip.controller.js): `backend/src/controllers/adminTrip.controller.js`
- [Booking management](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/adminBooking.controller.js): `backend/src/controllers/adminBooking.controller.js`
- [Fleet and user management](https://github.com/aminulmunnadev/booking-system/tree/main/backend/src/controllers): `backend/src/controllers`
- [Dashboard statistics](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/stats.controller.js): `backend/src/controllers/stats.controller.js`

### API and access

- [API client](https://github.com/aminulmunnadev/booking-system/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`
- [Express application](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/app.js): `backend/src/app.js`
- [Auth routes](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/auth.routes.js): `backend/src/routes/auth.routes.js`
- [Public trip routes](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/public.routes.js): `backend/src/routes/public.routes.js`
- [Booking routes](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/bookings.routes.js): `backend/src/routes/bookings.routes.js`
- [Admin routes](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/routes/admin.routes.js): `backend/src/routes/admin.routes.js`
- [Token and role checks](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Request validation](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/middleware/validate.js): `backend/src/middleware/validate.js`

### Booking domain

- [Authentication](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Trip discovery](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/trips.controller.js): `backend/src/controllers/trips.controller.js`
- [Booking lifecycle](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/controllers/bookings.controller.js): `backend/src/controllers/bookings.controller.js`
- [Prisma client](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/config/prisma.js): `backend/src/config/prisma.js`
- [Booking helpers](https://github.com/aminulmunnadev/booking-system/blob/main/backend/src/utils/cancelBooking.js): `backend/src/utils/cancelBooking.js`

### Other components

- **MySQL database**

## Connections

- Express application → Auth routes: mounts (evidence: `backend/src/app.js`)
- Express application → Admin routes: mounts (evidence: `backend/src/app.js`)
- Express application → Public trip routes: mounts (evidence: `backend/src/app.js`)
- Express application → Booking routes: mounts (evidence: `backend/src/app.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/src/routes/auth.routes.js`)
- Auth routes → Token and role checks: checks identity (evidence: `backend/src/routes/auth.routes.js`)
- Auth routes → Request validation: validates input (evidence: `backend/src/routes/auth.routes.js`)
- Public trip routes → Trip discovery: dispatches (evidence: `backend/src/routes/public.routes.js`)
- Booking routes → Booking lifecycle: dispatches (evidence: `backend/src/routes/bookings.routes.js`)
- Booking routes → Token and role checks: checks identity (evidence: `backend/src/routes/bookings.routes.js`)
- Booking routes → Request validation: validates input (evidence: `backend/src/routes/bookings.routes.js`)
- Admin routes → Trip management: dispatches (evidence: `backend/src/routes/admin.routes.js`)
- Admin routes → Booking management: dispatches (evidence: `backend/src/routes/admin.routes.js`)
- Admin routes → Fleet and user management: dispatches (evidence: `backend/src/routes/admin.routes.js`)
- Admin routes → Dashboard statistics: dispatches (evidence: `backend/src/routes/admin.routes.js`)
- Admin routes → Token and role checks: checks roles (evidence: `backend/src/routes/admin.routes.js`)
- Admin routes → Request validation: validates input (evidence: `backend/src/routes/admin.routes.js`)
- Authentication → Prisma client: reads and writes (evidence: `backend/src/controllers/auth.controller.js`)
- Trip discovery → Prisma client: queries trips (evidence: `backend/src/controllers/trips.controller.js`)
- Booking lifecycle → Prisma client: reads and writes (evidence: `backend/src/controllers/bookings.controller.js`)
- Trip management → Prisma client: manages trips (evidence: `backend/src/controllers/adminTrip.controller.js`)
- Booking management → Prisma client: manages bookings (evidence: `backend/src/controllers/adminBooking.controller.js`)
- Dashboard statistics → Prisma client: queries statistics (evidence: `backend/src/controllers/stats.controller.js`)
- Booking lifecycle → Booking helpers: cancels bookings (evidence: `backend/src/controllers/bookings.controller.js`)
- Booking management → Booking helpers: cancels bookings (evidence: `backend/src/controllers/adminBooking.controller.js`)
- Prisma client → MySQL database: connects (evidence: `backend/src/config/prisma.js`)
- Traveler pages → API client: uses API
- Admin pages → API client: uses API
- Traveler pages → Trip search UI: renders
- Traveler pages → Seat selection: renders
- Sign-in and registration → Auth state: uses auth
- Admin pages → Admin components: renders
