How vprak86/final-year-project works
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: App.jsx App routing · routes API route handlers · api.js API client · availabilityController.js Seat availability
Components 34
Web application
- App routing
frontend-bus/src/App.jsx - Auth context
frontend-bus/src/context/AuthContext.jsx - API client
frontend-bus/src/services/api.js - Trip search
frontend-bus/src/pages/SearchPage.jsx - Seat selection
frontend-bus/src/pages/SeatSelectionPage.jsx - Seat map
frontend-bus/src/components/SeatMap.jsx - Booking confirmation
frontend-bus/src/pages/BookingConfirmationPage.jsx - My bookings
frontend-bus/src/pages/MyBookingsPage.jsx - Live tracking
frontend-bus/src/pages/LiveTracking.jsx - Operator panel
frontend-bus/src/pages/OperatorPage.jsx - Admin management
frontend-bus/src/pages/admin - Chat assistant UI
frontend-bus/src/components/ChatBot.jsx
Backend API
- HTTP server
backend_bus/server.js - API route handlers
backend_bus/routes - JWT role checks
backend_bus/middleware/auth.js - Authentication
backend_bus/controllers/authController.js - Seat availability
backend_bus/controllers/availabilityController.js - Booking rules
backend_bus/controllers/bookingController.js - Trip search and scheduling
backend_bus/controllers/tripController.js - Fleet and route management
backend_bus/controllers - Operator operations
backend_bus/controllers/operatorController.js - Chat service
backend_bus/controllers/chatController.js
Bus domain data
- MongoDB connection
backend_bus/config/db.js - Bookings
backend_bus/models/Booking.js - Trips
backend_bus/models/Trip.js - Routes and stop order
backend_bus/models/Route.js - Buses
backend_bus/models/Bus.js - Stops
backend_bus/models/Stop.js - Users
backend_bus/models/User.js
External services
- Gemini AI
- MongoDB
Other components
- Passenger
- Operator
- Administrator
Connections 48
- Passenger → App routing: uses
- Operator → App routing: uses
- Administrator → App routing: uses
- App routing → Auth context: provides auth
frontend-bus/src/App.jsx - App routing → Trip search: routes to
frontend-bus/src/App.jsx - App routing → Seat selection: routes to
frontend-bus/src/App.jsx - App routing → Booking confirmation: routes to
frontend-bus/src/App.jsx - App routing → My bookings: routes to
frontend-bus/src/App.jsx - App routing → Live tracking: routes to
frontend-bus/src/App.jsx - App routing → Operator panel: routes to
frontend-bus/src/App.jsx - App routing → Admin management: routes to
frontend-bus/src/App.jsx - App routing → Chat assistant UI: renders
frontend-bus/src/App.jsx - Auth context → API client: loads identity
frontend-bus/src/context/AuthContext.jsx - Seat selection → Seat map: renders
frontend-bus/src/pages/SeatSelectionPage.jsx - Trip search → API client: searches trips
frontend-bus/src/pages/SearchPage.jsx - Seat selection → API client: loads availability
frontend-bus/src/pages/SeatSelectionPage.jsx - Seat selection → Auth context: reads identity
frontend-bus/src/pages/SeatSelectionPage.jsx - Admin management → API client: manages routes
frontend-bus/src/pages/admin/AdminRoutes.jsx - Admin management → Auth context: checks role
frontend-bus/src/pages/admin/AdminRoutes.jsx - Live tracking → API client: requests data
frontend-bus/src/pages/LiveTracking.jsx - API client → HTTP server: calls REST API
- HTTP server → MongoDB connection: connects
backend_bus/server.js - HTTP server → API route handlers: mounts
backend_bus/server.js - API route handlers → Authentication: dispatches
backend_bus/routes/authRoutes.js - API route handlers → Seat availability: dispatches
backend_bus/routes/availabilityRoutes.js - API route handlers → Booking rules: dispatches
backend_bus/routes/bookingRoutes.js - API route handlers → Trip search and scheduling: dispatches
backend_bus/routes/tripRoutes.js - API route handlers → Chat service: dispatches
backend_bus/routes/chatRoutes.js - API route handlers → Operator operations: dispatches
backend_bus/routes/operatorRoutes.js - API route handlers → Fleet and route management: dispatches
backend_bus/routes/routeRoutes.js - API route handlers → JWT role checks: protects endpoints
backend_bus/routes/tripRoutes.js - JWT role checks → Users: loads user
backend_bus/middleware/auth.js - Authentication → Users: reads and writes
backend_bus/controllers/authController.js - Seat availability → Bookings: checks conflicts
backend_bus/controllers/availabilityController.js - Seat availability → Trips: reads trips
backend_bus/controllers/availabilityController.js - Seat availability → Routes and stop order: reads routes
backend_bus/controllers/availabilityController.js - Seat availability → Buses: reads buses
backend_bus/controllers/availabilityController.js - Booking rules → Bookings: creates and updates
backend_bus/controllers/bookingController.js - Booking rules → Trips: loads trip
backend_bus/controllers/bookingController.js - Booking rules → Routes and stop order: checks stop order
backend_bus/controllers/bookingController.js - Trip search and scheduling → Trips: manages trips
backend_bus/controllers/tripController.js - Trip search and scheduling → Routes and stop order: uses routes
backend_bus/controllers/tripController.js - Fleet and route management → Buses: manages buses
backend_bus/controllers/busController.js - Fleet and route management → Routes and stop order: manages routes
backend_bus/controllers/routeController.js - Fleet and route management → Stops: manages stops
backend_bus/controllers/stopController.js - Operator operations → Bookings: handles bookings
backend_bus/controllers/operatorController.js - Operator operations → Trips: loads trips
backend_bus/controllers/operatorController.js - Operator operations → Users: reads operators
backend_bus/controllers/operatorController.js