# pragalathan-22/travel-booking architecture

> Architecture diagram of the GitHub repository pragalathan-22/travel-booking, 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/pragalathan-22/travel-booking
- Repository: https://github.com/pragalathan-22/travel-booking

## Overview

This is a vehicle-booking platform with an Express/MongoDB backend, a browser-based admin console, and a driver mobile app; the user-app tree is present but its implementation is not shown. The main workflow is driver registration and vehicle submission, admin review, then booking and trip-status updates. Backend route/controller excerpts establish the API path and booking/vehicle behavior; major frontend pages and driver screens are represented from the source index, but their unsampled calls are not asserted. No README was provided, so capability coverage is based on the source tree and index.

Main entry points: [`frontend/src/App.jsx`](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/App.jsx) (Admin web router), [`backend/server.js`](https://github.com/pragalathan-22/travel-booking/blob/main/backend/server.js) (API server), [`frontend/src/api/axios.js`](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/api/axios.js) (Web API client), [`backend/routes/vehicleRoutes.js`](https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/vehicleRoutes.js) (Vehicle endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["API and data"]
  node_server["API server<br/>[server.js]"]
  node_db_connect["Database connection<br/>[db.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_auth_middleware["Token authentication<br/>[authMiddleware.js]"]
  node_role_middleware["Role authorization<br/>[roleMiddleware.js]"]
  node_user_model[("User records<br/>[User.js]")]
  node_vehicle_model[("Vehicle records<br/>[Vehicle.js]")]
  node_booking_model[("Booking records<br/>[Booking.js]")]
end

subgraph group_fleet["Fleet operations"]
  node_vehicle_routes["Vehicle endpoints<br/>[vehicleRoutes.js]"]
  node_vehicle_controller["Fleet management"]
  node_upload_middleware["Document uploads"]
end

subgraph group_trips["Booking lifecycle"]
  node_booking_routes["Booking endpoints<br/>[bookingRoutes.js]"]
  node_booking_controller["Booking and trip state"]
end

subgraph group_admin["Admin console"]
  node_dashboard_routes["Dashboard endpoints<br/>[dashboardRoutes.js]"]
  node_dashboard_controller["Dashboard metrics"]
  node_user_routes["User endpoints<br/>[userRoutes.js]"]
  node_user_controller["User management<br/>[userController.js]"]
  node_web_app["Admin web router<br/>[App.jsx]"]
  node_web_layout["Admin dashboard layout"]
  node_web_auth["Admin sign-in<br/>[Login.jsx]"]
  node_web_dashboard["Operations dashboard<br/>[Dashboard.jsx]"]
  node_web_vehicles["Vehicle review<br/>[VehiclesPage.jsx]"]
  node_web_drivers["Driver management<br/>[DriversPage.jsx]"]
  node_web_bookings["Booking management<br/>[BookingsPage.jsx]"]
  node_web_users["User management page<br/>[UsersPage.jsx]"]
  node_web_api["Web API client<br/>[axios.js]"]
end

subgraph group_driver["Driver app"]
  node_driver_app["Driver app entry<br/>[App.js]"]
  node_driver_auth["Driver session<br/>[AuthContext.js]"]
  node_driver_api["Mobile API client<br/>[client.js]"]
  node_driver_nav["Driver navigation<br/>[RootNavigator.js]"]
end

node_admin_actor(("Administrator"))
node_driver_actor(("Driver"))
node_rider_actor(("Rider"))

node_server -->|"connects"| node_db_connect
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_vehicle_routes
node_server -->|"mounts"| node_booking_routes
node_server -->|"mounts"| node_dashboard_routes
node_server -->|"mounts"| node_user_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"reads/writes"| node_user_model
node_vehicle_routes -->|"dispatches"| node_vehicle_controller
node_vehicle_routes -->|"authenticates"| node_auth_middleware
node_vehicle_routes -->|"checks role"| node_role_middleware
node_vehicle_routes -->|"uploads files"| node_upload_middleware
node_vehicle_controller -->|"reads/writes"| node_vehicle_model
node_booking_routes -->|"dispatches"| node_booking_controller
node_booking_routes -->|"authenticates"| node_auth_middleware
node_booking_routes -->|"checks role"| node_role_middleware
node_booking_controller -->|"reads/writes"| node_booking_model
node_booking_controller -->|"reads/updates"| node_vehicle_model
node_dashboard_routes -->|"dispatches"| node_dashboard_controller
node_dashboard_routes -->|"authenticates"| node_auth_middleware
node_dashboard_routes -->|"checks role"| node_role_middleware
node_dashboard_controller -->|"queries"| node_user_model
node_dashboard_controller -->|"queries"| node_vehicle_model
node_dashboard_controller -->|"queries"| node_booking_model
node_user_routes -->|"dispatches"| node_user_controller
node_user_routes -->|"authenticates"| node_auth_middleware
node_user_routes -->|"checks role"| node_role_middleware
node_user_controller -->|"reads/writes"| node_user_model
node_web_app -->|"routes to"| node_web_auth
node_web_app -->|"routes to"| node_web_layout
node_web_app -->|"routes to"| node_web_dashboard
node_web_app -->|"routes to"| node_web_vehicles
node_web_app -->|"routes to"| node_web_drivers
node_web_app -->|"routes to"| node_web_bookings
node_web_app -->|"routes to"| node_web_users
node_web_auth -->|"uses API"| node_web_api
node_web_dashboard -->|"uses API"| node_web_api
node_web_vehicles -->|"uses API"| node_web_api
node_web_drivers -->|"uses API"| node_web_api
node_web_bookings -->|"uses API"| node_web_api
node_web_users -->|"uses API"| node_web_api
node_driver_app -->|"provides session"| node_driver_auth
node_driver_app -->|"renders"| node_driver_nav
node_driver_auth -->|"requests auth"| node_driver_api
node_driver_actor -.->|"uses"| node_driver_app
node_rider_actor -.->|"requests bookings"| node_booking_routes
node_admin_actor -.->|"operates"| node_web_app

click node_server "https://github.com/pragalathan-22/travel-booking/blob/main/backend/server.js"
click node_db_connect "https://github.com/pragalathan-22/travel-booking/blob/main/backend/config/db.js"
click node_auth_routes "https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/authController.js"
click node_auth_middleware "https://github.com/pragalathan-22/travel-booking/blob/main/backend/middleware/authMiddleware.js"
click node_role_middleware "https://github.com/pragalathan-22/travel-booking/blob/main/backend/middleware/roleMiddleware.js"
click node_user_model "https://github.com/pragalathan-22/travel-booking/blob/main/backend/models/User.js"
click node_vehicle_model "https://github.com/pragalathan-22/travel-booking/blob/main/backend/models/Vehicle.js"
click node_booking_model "https://github.com/pragalathan-22/travel-booking/blob/main/backend/models/Booking.js"
click node_vehicle_routes "https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/vehicleRoutes.js"
click node_vehicle_controller "https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/vehicleController.js"
click node_upload_middleware "https://github.com/pragalathan-22/travel-booking/blob/main/backend/middleware/uploadMiddleware.js"
click node_booking_routes "https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/bookingRoutes.js"
click node_booking_controller "https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/bookingController.js"
click node_dashboard_routes "https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/dashboardRoutes.js"
click node_dashboard_controller "https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/dashboardController.js"
click node_user_routes "https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/userRoutes.js"
click node_user_controller "https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/userController.js"
click node_web_app "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/App.jsx"
click node_web_layout "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/layouts/DashboardLayout.jsx"
click node_web_auth "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/Login.jsx"
click node_web_dashboard "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/Dashboard.jsx"
click node_web_vehicles "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/VehiclesPage.jsx"
click node_web_drivers "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/DriversPage.jsx"
click node_web_bookings "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/BookingsPage.jsx"
click node_web_users "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/UsersPage.jsx"
click node_web_api "https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/api/axios.js"
click node_driver_app "https://github.com/pragalathan-22/travel-booking/blob/main/driver-app/App.js"
click node_driver_auth "https://github.com/pragalathan-22/travel-booking/blob/main/driver-app/src/context/AuthContext.js"
click node_driver_api "https://github.com/pragalathan-22/travel-booking/blob/main/driver-app/src/api/client.js"
click node_driver_nav "https://github.com/pragalathan-22/travel-booking/blob/main/driver-app/src/navigation/RootNavigator.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_server,node_db_connect,node_auth_routes,node_auth_controller,node_auth_middleware,node_role_middleware,node_user_model,node_vehicle_model,node_booking_model toneBlue
class node_vehicle_routes,node_vehicle_controller,node_upload_middleware toneAmber
class node_booking_routes,node_booking_controller toneMint
class node_dashboard_routes,node_dashboard_controller,node_user_routes,node_user_controller,node_web_app,node_web_layout,node_web_auth,node_web_dashboard,node_web_vehicles,node_web_drivers,node_web_bookings,node_web_users,node_web_api toneRose
class node_driver_app,node_driver_auth,node_driver_api,node_driver_nav,node_admin_actor,node_driver_actor,node_rider_actor toneIndigo
```

## Components

### API and data

- [API server](https://github.com/pragalathan-22/travel-booking/blob/main/backend/server.js): `backend/server.js`
- [Database connection](https://github.com/pragalathan-22/travel-booking/blob/main/backend/config/db.js): `backend/config/db.js`
- [Authentication routes](https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Authentication](https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Token authentication](https://github.com/pragalathan-22/travel-booking/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Role authorization](https://github.com/pragalathan-22/travel-booking/blob/main/backend/middleware/roleMiddleware.js): `backend/middleware/roleMiddleware.js`
- [User records](https://github.com/pragalathan-22/travel-booking/blob/main/backend/models/User.js): `backend/models/User.js`
- [Vehicle records](https://github.com/pragalathan-22/travel-booking/blob/main/backend/models/Vehicle.js): `backend/models/Vehicle.js`
- [Booking records](https://github.com/pragalathan-22/travel-booking/blob/main/backend/models/Booking.js): `backend/models/Booking.js`

### Fleet operations

- [Vehicle endpoints](https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/vehicleRoutes.js): `backend/routes/vehicleRoutes.js`
- [Fleet management](https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/vehicleController.js): `backend/controllers/vehicleController.js`
- [Document uploads](https://github.com/pragalathan-22/travel-booking/blob/main/backend/middleware/uploadMiddleware.js): `backend/middleware/uploadMiddleware.js`

### Booking lifecycle

- [Booking endpoints](https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/bookingRoutes.js): `backend/routes/bookingRoutes.js`
- [Booking and trip state](https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/bookingController.js): `backend/controllers/bookingController.js`

### Admin console

- [Dashboard endpoints](https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/dashboardRoutes.js): `backend/routes/dashboardRoutes.js`
- [Dashboard metrics](https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/dashboardController.js): `backend/controllers/dashboardController.js`
- [User endpoints](https://github.com/pragalathan-22/travel-booking/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [User management](https://github.com/pragalathan-22/travel-booking/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Admin web router](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Admin dashboard layout](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/layouts/DashboardLayout.jsx): `frontend/src/layouts/DashboardLayout.jsx`
- [Admin sign-in](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Operations dashboard](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Vehicle review](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/VehiclesPage.jsx): `frontend/src/pages/VehiclesPage.jsx`
- [Driver management](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/DriversPage.jsx): `frontend/src/pages/DriversPage.jsx`
- [Booking management](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/BookingsPage.jsx): `frontend/src/pages/BookingsPage.jsx`
- [User management page](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/pages/UsersPage.jsx): `frontend/src/pages/UsersPage.jsx`
- [Web API client](https://github.com/pragalathan-22/travel-booking/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### Driver app

- [Driver app entry](https://github.com/pragalathan-22/travel-booking/blob/main/driver-app/App.js): `driver-app/App.js`
- [Driver session](https://github.com/pragalathan-22/travel-booking/blob/main/driver-app/src/context/AuthContext.js): `driver-app/src/context/AuthContext.js`
- [Mobile API client](https://github.com/pragalathan-22/travel-booking/blob/main/driver-app/src/api/client.js): `driver-app/src/api/client.js`
- [Driver navigation](https://github.com/pragalathan-22/travel-booking/blob/main/driver-app/src/navigation/RootNavigator.js): `driver-app/src/navigation/RootNavigator.js`

### Other components

- **Administrator**
- **Driver**
- **Rider**

## Connections

- API server → Database connection: connects (evidence: `backend/server.js`)
- API server → Authentication routes: mounts (evidence: `backend/server.js`)
- API server → Vehicle endpoints: mounts (evidence: `backend/server.js`)
- API server → Booking endpoints: mounts (evidence: `backend/server.js`)
- API server → Dashboard endpoints: mounts (evidence: `backend/server.js`)
- API server → User endpoints: mounts (evidence: `backend/server.js`)
- Authentication routes → Authentication: dispatches (evidence: `backend/routes/authRoutes.js`)
- Authentication → User records: reads/writes (evidence: `backend/controllers/authController.js`)
- Vehicle endpoints → Fleet management: dispatches (evidence: `backend/routes/vehicleRoutes.js`)
- Vehicle endpoints → Token authentication: authenticates (evidence: `backend/routes/vehicleRoutes.js`)
- Vehicle endpoints → Role authorization: checks role (evidence: `backend/routes/vehicleRoutes.js`)
- Vehicle endpoints → Document uploads: uploads files (evidence: `backend/routes/vehicleRoutes.js`)
- Fleet management → Vehicle records: reads/writes (evidence: `backend/controllers/vehicleController.js`)
- Booking endpoints → Booking and trip state: dispatches (evidence: `backend/routes/bookingRoutes.js`)
- Booking endpoints → Token authentication: authenticates (evidence: `backend/routes/bookingRoutes.js`)
- Booking endpoints → Role authorization: checks role (evidence: `backend/routes/bookingRoutes.js`)
- Booking and trip state → Booking records: reads/writes (evidence: `backend/controllers/bookingController.js`)
- Booking and trip state → Vehicle records: reads/updates (evidence: `backend/controllers/bookingController.js`)
- Dashboard endpoints → Dashboard metrics: dispatches (evidence: `backend/routes/dashboardRoutes.js`)
- Dashboard endpoints → Token authentication: authenticates (evidence: `backend/routes/dashboardRoutes.js`)
- Dashboard endpoints → Role authorization: checks role (evidence: `backend/routes/dashboardRoutes.js`)
- Dashboard metrics → User records: queries (evidence: `backend/controllers/dashboardController.js`)
- Dashboard metrics → Vehicle records: queries (evidence: `backend/controllers/dashboardController.js`)
- Dashboard metrics → Booking records: queries (evidence: `backend/controllers/dashboardController.js`)
- User endpoints → User management: dispatches (evidence: `backend/routes/userRoutes.js`)
- User endpoints → Token authentication: authenticates (evidence: `backend/routes/userRoutes.js`)
- User endpoints → Role authorization: checks role (evidence: `backend/routes/userRoutes.js`)
- User management → User records: reads/writes (evidence: `backend/controllers/userController.js`)
- Admin web router → Admin sign-in: routes to (evidence: `frontend/src/App.jsx`)
- Admin web router → Admin dashboard layout: routes to (evidence: `frontend/src/App.jsx`)
- Admin web router → Operations dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Admin web router → Vehicle review: routes to (evidence: `frontend/src/App.jsx`)
- Admin web router → Driver management: routes to (evidence: `frontend/src/App.jsx`)
- Admin web router → Booking management: routes to (evidence: `frontend/src/App.jsx`)
- Admin web router → User management page: routes to (evidence: `frontend/src/App.jsx`)
- Admin sign-in → Web API client: uses API (evidence: `frontend/src/pages/Login.jsx`)
- Operations dashboard → Web API client: uses API (evidence: `frontend/src/pages/Dashboard.jsx`)
- Vehicle review → Web API client: uses API (evidence: `frontend/src/pages/VehiclesPage.jsx`)
- Driver management → Web API client: uses API (evidence: `frontend/src/pages/DriversPage.jsx`)
- Booking management → Web API client: uses API (evidence: `frontend/src/pages/BookingsPage.jsx`)
- User management page → Web API client: uses API (evidence: `frontend/src/pages/UsersPage.jsx`)
- Driver app entry → Driver session: provides session (evidence: `driver-app/App.js`)
- Driver app entry → Driver navigation: renders (evidence: `driver-app/App.js`)
- Driver session → Mobile API client: requests auth (evidence: `driver-app/src/context/AuthContext.js`)
- Driver → Driver app entry: uses
- Rider → Booking endpoints: requests bookings
- Administrator → Admin web router: operates
