# knamrataa/fleetmanagementplatform architecture

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

- Interactive diagram: https://gitdiagram.com/knamrataa/fleetmanagementplatform
- Repository: https://github.com/knamrataa/fleetmanagementplatform

## Overview

FleetFlow is a role-based fleet-management application for customer trip requests, dispatcher assignment, driver trip execution, fleet tracking, and supporting finance, maintenance, and administration. Users enter through the web app and its role-specific pages; the backend exposes API routes and persists operational records in MongoDB. The sampled code confirms finance and administration route dispatch, selected model access, and live tracking infrastructure; several other domain modules are represented from the file tree, so uncertain internal wiring is intentionally omitted.

Main entry points: [`backend/server.js`](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/server.js) (API and realtime server), [`frontend/src/App.jsx`](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/App.jsx) (Role routing), [`frontend/src/services/api.js`](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/services/api.js) (HTTP API client), [`backend/models`](https://github.com/knamrataa/fleetmanagementplatform/tree/main/backend/models) (Operational records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Role routing<br/>[App.jsx]"]
  node_trip_manager_ui["Trip management"]
  node_customer_ui["Customer portal"]
  node_driver_ui["Driver portal<br/>[DriverTrips.jsx]"]
  node_finance_ui["Finance dashboard"]
  node_maintenance_ui["Maintenance dashboard"]
  node_api_client["HTTP API client<br/>[api.js]"]
end

subgraph group_operations["Fleet operations"]
  node_trip_request_routes["Trip request routes"]
  node_trip_manager_routes["Trip manager routes"]
  node_driver_routes["Driver routes"]
  node_tracking_routes["Tracking routes<br/>[trackingRoutes.js]"]
  node_driver_controller["Driver trip actions"]
  node_trip_request_controller["Trip request handling"]
  node_trip_manager_controller["Assignment handling"]
  node_tracking_service["Tracking service<br/>[trackingService.js]"]
  node_tracking_socket["Live tracking socket<br/>[trackingSocket.js]"]
end

subgraph group_business["Business services"]
  node_finance_routes["Finance routes<br/>[financeRoutes.js]"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_finance_controller["Finance workflows"]
  node_admin_controller["Administration<br/>[adminController.js]"]
end

subgraph group_platform["Platform and state"]
  node_server["API and realtime server<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_notification_service["Notifications"]
  node_models[("Operational records")]
  node_db_config["MongoDB connection<br/>[db.js]"]
end

node_users(("Role-based users"))
node_mongo[("MongoDB")]
node_email_provider["Brevo email"]

node_users -->|"use"| node_app
node_app -->|"route to"| node_trip_manager_ui
node_app -->|"route to"| node_customer_ui
node_app -->|"route to"| node_driver_ui
node_app -->|"route to"| node_finance_ui
node_app -->|"route to"| node_maintenance_ui
node_trip_manager_ui -->|"request"| node_api_client
node_customer_ui -->|"request"| node_api_client
node_driver_ui -->|"request"| node_api_client
node_finance_ui -->|"request"| node_api_client
node_maintenance_ui -->|"request"| node_api_client
node_api_client -->|"HTTP request"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_trip_request_routes
node_server -->|"mounts"| node_trip_manager_routes
node_server -->|"mounts"| node_driver_routes
node_server -->|"mounts"| node_tracking_routes
node_server -->|"mounts"| node_finance_routes
node_server -->|"mounts"| node_admin_routes
node_finance_routes -->|"dispatches"| node_finance_controller
node_admin_routes -->|"dispatches"| node_admin_controller
node_finance_controller -->|"reads and writes"| node_models
node_admin_controller -->|"reads and writes"| node_models
node_driver_controller -->|"trip records"| node_models
node_trip_request_controller -->|"trip requests"| node_models
node_trip_manager_controller -->|"assignments"| node_models
node_tracking_service -->|"tracking data"| node_models
node_db_config -->|"connects"| node_mongo
node_server -->|"connects"| node_db_config
node_server -->|"registers"| node_tracking_socket
node_driver_controller -->|"notifies"| node_notification_service
node_notification_service -.->|"sends email"| node_email_provider

click node_app "https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/App.jsx"
click node_trip_manager_ui "https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/TripManagerDashboard.jsx"
click node_customer_ui "https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/CustomerTripRequest.jsx"
click node_driver_ui "https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/DriverTrips.jsx"
click node_finance_ui "https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/FinanceManagerDashboard.jsx"
click node_maintenance_ui "https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/MaintenanceManagerDashboard.jsx"
click node_api_client "https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/server.js"
click node_auth_routes "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/authRoutes.js"
click node_trip_request_routes "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/tripRequestRoutes.js"
click node_trip_manager_routes "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/tripManagerRoutes.js"
click node_driver_routes "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/driverPortalRoutes.js"
click node_tracking_routes "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/trackingRoutes.js"
click node_finance_routes "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/financeRoutes.js"
click node_admin_routes "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/adminRoutes.js"
click node_finance_controller "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/financeController.js"
click node_admin_controller "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/adminController.js"
click node_driver_controller "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/driverController.js"
click node_trip_request_controller "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/tripRequestController.js"
click node_trip_manager_controller "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/tripManagerController.js"
click node_tracking_service "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/services/trackingService.js"
click node_tracking_socket "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/realtime/trackingSocket.js"
click node_notification_service "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/services/notificationService.js"
click node_models "https://github.com/knamrataa/fleetmanagementplatform/tree/main/backend/models"
click node_db_config "https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/config/db.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_trip_manager_ui,node_customer_ui,node_driver_ui,node_finance_ui,node_maintenance_ui,node_api_client,node_users toneBlue
class node_trip_request_routes,node_trip_manager_routes,node_driver_routes,node_tracking_routes,node_driver_controller,node_trip_request_controller,node_trip_manager_controller,node_tracking_service,node_tracking_socket,node_mongo toneAmber
class node_finance_routes,node_admin_routes,node_finance_controller,node_admin_controller toneMint
class node_server,node_auth_routes,node_notification_service,node_models,node_db_config toneRose
class node_email_provider toneIndigo
```

## Components

### Web experience

- [Role routing](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Trip management](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/TripManagerDashboard.jsx): `frontend/src/pages/TripManagerDashboard.jsx`
- [Customer portal](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/CustomerTripRequest.jsx): `frontend/src/pages/CustomerTripRequest.jsx`
- [Driver portal](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/DriverTrips.jsx): `frontend/src/pages/DriverTrips.jsx`
- [Finance dashboard](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/FinanceManagerDashboard.jsx): `frontend/src/pages/FinanceManagerDashboard.jsx`
- [Maintenance dashboard](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/pages/MaintenanceManagerDashboard.jsx): `frontend/src/pages/MaintenanceManagerDashboard.jsx`
- [HTTP API client](https://github.com/knamrataa/fleetmanagementplatform/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Fleet operations

- [Trip request routes](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/tripRequestRoutes.js): `backend/routes/tripRequestRoutes.js`
- [Trip manager routes](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/tripManagerRoutes.js): `backend/routes/tripManagerRoutes.js`
- [Driver routes](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/driverPortalRoutes.js): `backend/routes/driverPortalRoutes.js`
- [Tracking routes](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/trackingRoutes.js): `backend/routes/trackingRoutes.js`
- [Driver trip actions](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/driverController.js): `backend/controllers/driverController.js`
- [Trip request handling](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/tripRequestController.js): `backend/controllers/tripRequestController.js`
- [Assignment handling](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/tripManagerController.js): `backend/controllers/tripManagerController.js`
- [Tracking service](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/services/trackingService.js): `backend/services/trackingService.js`
- [Live tracking socket](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/realtime/trackingSocket.js): `backend/realtime/trackingSocket.js`

### Business services

- [Finance routes](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/financeRoutes.js): `backend/routes/financeRoutes.js`
- [Admin routes](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Finance workflows](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/financeController.js): `backend/controllers/financeController.js`
- [Administration](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`

### Platform and state

- [API and realtime server](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/server.js): `backend/server.js`
- [Authentication routes](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Notifications](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/services/notificationService.js): `backend/services/notificationService.js`
- [Operational records](https://github.com/knamrataa/fleetmanagementplatform/tree/main/backend/models): `backend/models`
- [MongoDB connection](https://github.com/knamrataa/fleetmanagementplatform/blob/main/backend/config/db.js): `backend/config/db.js`

### Other components

- **Role-based users**
- **MongoDB**
- **Brevo email**

## Connections

- Role-based users → Role routing: use
- Role routing → Trip management: route to
- Role routing → Customer portal: route to
- Role routing → Driver portal: route to
- Role routing → Finance dashboard: route to
- Role routing → Maintenance dashboard: route to
- Trip management → HTTP API client: request
- Customer portal → HTTP API client: request
- Driver portal → HTTP API client: request
- Finance dashboard → HTTP API client: request
- Maintenance dashboard → HTTP API client: request
- HTTP API client → API and realtime server: HTTP request
- API and realtime server → Authentication routes: mounts
- API and realtime server → Trip request routes: mounts
- API and realtime server → Trip manager routes: mounts
- API and realtime server → Driver routes: mounts
- API and realtime server → Tracking routes: mounts
- API and realtime server → Finance routes: mounts
- API and realtime server → Admin routes: mounts
- Finance routes → Finance workflows: dispatches
- Admin routes → Administration: dispatches
- Finance workflows → Operational records: reads and writes
- Administration → Operational records: reads and writes
- Driver trip actions → Operational records: trip records
- Trip request handling → Operational records: trip requests
- Assignment handling → Operational records: assignments
- Tracking service → Operational records: tracking data
- MongoDB connection → MongoDB: connects
- API and realtime server → MongoDB connection: connects
- API and realtime server → Live tracking socket: registers
- Driver trip actions → Notifications: notifies
- Notifications → Brevo email: sends email