# vprak86/final-year-project architecture

> Architecture diagram of the GitHub repository vprak86/final-year-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vprak86/final-year-project
- Repository: https://github.com/vprak86/final-year-project

## Overview

BusBook is a bus-search, stop-segment seat-booking and operations application. Passengers search trips, inspect seat availability, select seats, confirm bookings, then review bookings or track buses; operators manage assigned trips, while administrators manage buses, stops, routes, trips and bookings. The frontend routes users to these capabilities and calls a REST API; the backend routes requests to controllers that apply domain rules and use MongoDB models. The README is empty, so documented product capabilities come from the chatbot controller’s embedded product description; several UI and controller implementations were not sampled.

Main entry points: [`frontend-bus/src/App.jsx`](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/App.jsx) (App routing), [`backend_bus/routes`](https://github.com/vprak86/final-year-project/tree/main/backend_bus/routes) (API route handlers), [`frontend-bus/src/services/api.js`](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/services/api.js) (API client), [`backend_bus/controllers/availabilityController.js`](https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/availabilityController.js) (Seat availability)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_authctx["Auth context<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_search["Trip search<br/>[SearchPage.jsx]"]
  node_seat_selection["Seat selection"]
  node_seat_map["Seat map<br/>[SeatMap.jsx]"]
  node_booking_confirmation["Booking confirmation"]
  node_my_bookings["My bookings<br/>[MyBookingsPage.jsx]"]
  node_live_tracking["Live tracking<br/>[LiveTracking.jsx]"]
  node_operator_ui["Operator panel<br/>[OperatorPage.jsx]"]
  node_admin_ui["Admin management"]
  node_chat_ui["Chat assistant UI<br/>[ChatBot.jsx]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP server<br/>[server.js]"]
  node_route_handlers["API route handlers"]
  node_auth_middleware["JWT role checks<br/>[auth.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_availability["Seat availability"]
  node_booking["Booking rules"]
  node_trip_controller["Trip search and scheduling<br/>[tripController.js]"]
  node_admin_controllers["Fleet and route management"]
  node_operator_controller["Operator operations"]
  node_chat_controller["Chat service<br/>[chatController.js]"]
end

subgraph group_domain["Bus domain data"]
  node_db_config[("MongoDB connection<br/>[db.js]")]
  node_booking_model[("Bookings<br/>[Booking.js]")]
  node_trip_model[("Trips<br/>[Trip.js]")]
  node_route_model[("Routes and stop order<br/>[Route.js]")]
  node_bus_model[("Buses<br/>[Bus.js]")]
  node_stop_model[("Stops<br/>[Stop.js]")]
  node_user_model[("Users<br/>[User.js]")]
end

subgraph group_integrations["External services"]
  node_gemini{{"Gemini AI"}}
  node_mongo[("MongoDB")]
end

node_passenger(("Passenger"))
node_operator(("Operator"))
node_admin(("Administrator"))

node_passenger -->|"uses"| node_app
node_operator -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"provides auth"| node_authctx
node_app -->|"routes to"| node_search
node_app -->|"routes to"| node_seat_selection
node_app -->|"routes to"| node_booking_confirmation
node_app -->|"routes to"| node_my_bookings
node_app -->|"routes to"| node_live_tracking
node_app -->|"routes to"| node_operator_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"renders"| node_chat_ui
node_authctx -->|"loads identity"| node_api_client
node_seat_selection -->|"renders"| node_seat_map
node_search -->|"searches trips"| node_api_client
node_seat_selection -->|"loads availability"| node_api_client
node_seat_selection -->|"reads identity"| node_authctx
node_admin_ui -->|"manages routes"| node_api_client
node_admin_ui -->|"checks role"| node_authctx
node_live_tracking -->|"requests data"| node_api_client
node_api_client -.->|"calls REST API"| node_server
node_server -->|"connects"| node_db_config
node_server -->|"mounts"| node_route_handlers
node_route_handlers -->|"dispatches"| node_auth_controller
node_route_handlers -->|"dispatches"| node_availability
node_route_handlers -->|"dispatches"| node_booking
node_route_handlers -->|"dispatches"| node_trip_controller
node_route_handlers -->|"dispatches"| node_chat_controller
node_route_handlers -->|"dispatches"| node_operator_controller
node_route_handlers -->|"dispatches"| node_admin_controllers
node_route_handlers -->|"protects endpoints"| node_auth_middleware
node_auth_middleware -->|"loads user"| node_user_model
node_auth_controller -->|"reads and writes"| node_user_model
node_availability -->|"checks conflicts"| node_booking_model
node_availability -->|"reads trips"| node_trip_model
node_availability -->|"reads routes"| node_route_model
node_availability -->|"reads buses"| node_bus_model
node_booking -->|"creates and updates"| node_booking_model
node_booking -->|"loads trip"| node_trip_model
node_booking -->|"checks stop order"| node_route_model
node_trip_controller -->|"manages trips"| node_trip_model
node_trip_controller -->|"uses routes"| node_route_model
node_admin_controllers -->|"manages buses"| node_bus_model
node_admin_controllers -->|"manages routes"| node_route_model
node_admin_controllers -->|"manages stops"| node_stop_model
node_operator_controller -->|"handles bookings"| node_booking_model
node_operator_controller -->|"loads trips"| node_trip_model
node_operator_controller -->|"reads operators"| node_user_model

click node_app "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/App.jsx"
click node_authctx "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/context/AuthContext.jsx"
click node_api_client "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/services/api.js"
click node_search "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/SearchPage.jsx"
click node_seat_selection "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/SeatSelectionPage.jsx"
click node_seat_map "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/components/SeatMap.jsx"
click node_booking_confirmation "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/BookingConfirmationPage.jsx"
click node_my_bookings "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/MyBookingsPage.jsx"
click node_live_tracking "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/LiveTracking.jsx"
click node_operator_ui "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/OperatorPage.jsx"
click node_admin_ui "https://github.com/vprak86/final-year-project/tree/main/frontend-bus/src/pages/admin"
click node_chat_ui "https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/components/ChatBot.jsx"
click node_server "https://github.com/vprak86/final-year-project/blob/main/backend_bus/server.js"
click node_route_handlers "https://github.com/vprak86/final-year-project/tree/main/backend_bus/routes"
click node_auth_middleware "https://github.com/vprak86/final-year-project/blob/main/backend_bus/middleware/auth.js"
click node_auth_controller "https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/authController.js"
click node_availability "https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/availabilityController.js"
click node_booking "https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/bookingController.js"
click node_trip_controller "https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/tripController.js"
click node_admin_controllers "https://github.com/vprak86/final-year-project/tree/main/backend_bus/controllers"
click node_operator_controller "https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/operatorController.js"
click node_chat_controller "https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/chatController.js"
click node_db_config "https://github.com/vprak86/final-year-project/blob/main/backend_bus/config/db.js"
click node_booking_model "https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Booking.js"
click node_trip_model "https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Trip.js"
click node_route_model "https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Route.js"
click node_bus_model "https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Bus.js"
click node_stop_model "https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Stop.js"
click node_user_model "https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/User.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_authctx,node_api_client,node_search,node_seat_selection,node_seat_map,node_booking_confirmation,node_my_bookings,node_live_tracking,node_operator_ui,node_admin_ui,node_chat_ui toneBlue
class node_server,node_route_handlers,node_auth_middleware,node_auth_controller,node_availability,node_booking,node_trip_controller,node_admin_controllers,node_operator_controller,node_chat_controller toneAmber
class node_db_config,node_booking_model,node_trip_model,node_route_model,node_bus_model,node_stop_model,node_user_model toneMint
class node_gemini,node_mongo toneRose
class node_passenger,node_operator,node_admin toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/App.jsx): `frontend-bus/src/App.jsx`
- [Auth context](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/context/AuthContext.jsx): `frontend-bus/src/context/AuthContext.jsx`
- [API client](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/services/api.js): `frontend-bus/src/services/api.js`
- [Trip search](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/SearchPage.jsx): `frontend-bus/src/pages/SearchPage.jsx`
- [Seat selection](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/SeatSelectionPage.jsx): `frontend-bus/src/pages/SeatSelectionPage.jsx`
- [Seat map](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/components/SeatMap.jsx): `frontend-bus/src/components/SeatMap.jsx`
- [Booking confirmation](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/BookingConfirmationPage.jsx): `frontend-bus/src/pages/BookingConfirmationPage.jsx`
- [My bookings](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/MyBookingsPage.jsx): `frontend-bus/src/pages/MyBookingsPage.jsx`
- [Live tracking](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/LiveTracking.jsx): `frontend-bus/src/pages/LiveTracking.jsx`
- [Operator panel](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/pages/OperatorPage.jsx): `frontend-bus/src/pages/OperatorPage.jsx`
- [Admin management](https://github.com/vprak86/final-year-project/tree/main/frontend-bus/src/pages/admin): `frontend-bus/src/pages/admin`
- [Chat assistant UI](https://github.com/vprak86/final-year-project/blob/main/frontend-bus/src/components/ChatBot.jsx): `frontend-bus/src/components/ChatBot.jsx`

### Backend API

- [HTTP server](https://github.com/vprak86/final-year-project/blob/main/backend_bus/server.js): `backend_bus/server.js`
- [API route handlers](https://github.com/vprak86/final-year-project/tree/main/backend_bus/routes): `backend_bus/routes`
- [JWT role checks](https://github.com/vprak86/final-year-project/blob/main/backend_bus/middleware/auth.js): `backend_bus/middleware/auth.js`
- [Authentication](https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/authController.js): `backend_bus/controllers/authController.js`
- [Seat availability](https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/availabilityController.js): `backend_bus/controllers/availabilityController.js`
- [Booking rules](https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/bookingController.js): `backend_bus/controllers/bookingController.js`
- [Trip search and scheduling](https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/tripController.js): `backend_bus/controllers/tripController.js`
- [Fleet and route management](https://github.com/vprak86/final-year-project/tree/main/backend_bus/controllers): `backend_bus/controllers`
- [Operator operations](https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/operatorController.js): `backend_bus/controllers/operatorController.js`
- [Chat service](https://github.com/vprak86/final-year-project/blob/main/backend_bus/controllers/chatController.js): `backend_bus/controllers/chatController.js`

### Bus domain data

- [MongoDB connection](https://github.com/vprak86/final-year-project/blob/main/backend_bus/config/db.js): `backend_bus/config/db.js`
- [Bookings](https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Booking.js): `backend_bus/models/Booking.js`
- [Trips](https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Trip.js): `backend_bus/models/Trip.js`
- [Routes and stop order](https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Route.js): `backend_bus/models/Route.js`
- [Buses](https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Bus.js): `backend_bus/models/Bus.js`
- [Stops](https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/Stop.js): `backend_bus/models/Stop.js`
- [Users](https://github.com/vprak86/final-year-project/blob/main/backend_bus/models/User.js): `backend_bus/models/User.js`

### External services

- **Gemini AI**
- **MongoDB**

### Other components

- **Passenger**
- **Operator**
- **Administrator**

## Connections

- Passenger → App routing: uses
- Operator → App routing: uses
- Administrator → App routing: uses
- App routing → Auth context: provides auth (evidence: `frontend-bus/src/App.jsx`)
- App routing → Trip search: routes to (evidence: `frontend-bus/src/App.jsx`)
- App routing → Seat selection: routes to (evidence: `frontend-bus/src/App.jsx`)
- App routing → Booking confirmation: routes to (evidence: `frontend-bus/src/App.jsx`)
- App routing → My bookings: routes to (evidence: `frontend-bus/src/App.jsx`)
- App routing → Live tracking: routes to (evidence: `frontend-bus/src/App.jsx`)
- App routing → Operator panel: routes to (evidence: `frontend-bus/src/App.jsx`)
- App routing → Admin management: routes to (evidence: `frontend-bus/src/App.jsx`)
- App routing → Chat assistant UI: renders (evidence: `frontend-bus/src/App.jsx`)
- Auth context → API client: loads identity (evidence: `frontend-bus/src/context/AuthContext.jsx`)
- Seat selection → Seat map: renders (evidence: `frontend-bus/src/pages/SeatSelectionPage.jsx`)
- Trip search → API client: searches trips (evidence: `frontend-bus/src/pages/SearchPage.jsx`)
- Seat selection → API client: loads availability (evidence: `frontend-bus/src/pages/SeatSelectionPage.jsx`)
- Seat selection → Auth context: reads identity (evidence: `frontend-bus/src/pages/SeatSelectionPage.jsx`)
- Admin management → API client: manages routes (evidence: `frontend-bus/src/pages/admin/AdminRoutes.jsx`)
- Admin management → Auth context: checks role (evidence: `frontend-bus/src/pages/admin/AdminRoutes.jsx`)
- Live tracking → API client: requests data (evidence: `frontend-bus/src/pages/LiveTracking.jsx`)
- API client → HTTP server: calls REST API
- HTTP server → MongoDB connection: connects (evidence: `backend_bus/server.js`)
- HTTP server → API route handlers: mounts (evidence: `backend_bus/server.js`)
- API route handlers → Authentication: dispatches (evidence: `backend_bus/routes/authRoutes.js`)
- API route handlers → Seat availability: dispatches (evidence: `backend_bus/routes/availabilityRoutes.js`)
- API route handlers → Booking rules: dispatches (evidence: `backend_bus/routes/bookingRoutes.js`)
- API route handlers → Trip search and scheduling: dispatches (evidence: `backend_bus/routes/tripRoutes.js`)
- API route handlers → Chat service: dispatches (evidence: `backend_bus/routes/chatRoutes.js`)
- API route handlers → Operator operations: dispatches (evidence: `backend_bus/routes/operatorRoutes.js`)
- API route handlers → Fleet and route management: dispatches (evidence: `backend_bus/routes/routeRoutes.js`)
- API route handlers → JWT role checks: protects endpoints (evidence: `backend_bus/routes/tripRoutes.js`)
- JWT role checks → Users: loads user (evidence: `backend_bus/middleware/auth.js`)
- Authentication → Users: reads and writes (evidence: `backend_bus/controllers/authController.js`)
- Seat availability → Bookings: checks conflicts (evidence: `backend_bus/controllers/availabilityController.js`)
- Seat availability → Trips: reads trips (evidence: `backend_bus/controllers/availabilityController.js`)
- Seat availability → Routes and stop order: reads routes (evidence: `backend_bus/controllers/availabilityController.js`)
- Seat availability → Buses: reads buses (evidence: `backend_bus/controllers/availabilityController.js`)
- Booking rules → Bookings: creates and updates (evidence: `backend_bus/controllers/bookingController.js`)
- Booking rules → Trips: loads trip (evidence: `backend_bus/controllers/bookingController.js`)
- Booking rules → Routes and stop order: checks stop order (evidence: `backend_bus/controllers/bookingController.js`)
- Trip search and scheduling → Trips: manages trips (evidence: `backend_bus/controllers/tripController.js`)
- Trip search and scheduling → Routes and stop order: uses routes (evidence: `backend_bus/controllers/tripController.js`)
- Fleet and route management → Buses: manages buses (evidence: `backend_bus/controllers/busController.js`)
- Fleet and route management → Routes and stop order: manages routes (evidence: `backend_bus/controllers/routeController.js`)
- Fleet and route management → Stops: manages stops (evidence: `backend_bus/controllers/stopController.js`)
- Operator operations → Bookings: handles bookings (evidence: `backend_bus/controllers/operatorController.js`)
- Operator operations → Trips: loads trips (evidence: `backend_bus/controllers/operatorController.js`)
- Operator operations → Users: reads operators (evidence: `backend_bus/controllers/operatorController.js`)
