How diyap235/transitops-fleet-management works
TransitOps is a role-based fleet operations platform. Users sign in, then use the React app to manage vehicles, drivers, trips, maintenance, fuel logs and expenses; finance/reporting views expose operational costs and fuel statistics. The API authenticates protected routes and persists domain records in MongoDB. The README documents role-specific access and these major capabilities. Some frontend API wiring and several controllers were not sampled, so uncertain links are omitted; the trip and maintenance status effects shown are supported by sampled controllers.
Main entry points: server.js Express API server · App.jsx App routes · expense.controller.js Expense and fuel handlers · auth.middleware.js JWT access control
Components 34
React application
- App routes
frontend/src/App.jsx - Auth context
frontend/src/context/AuthContext.jsx - Fleet pages
frontend/src/pages/Vehicles.jsx - Trip page
frontend/src/pages/Trips.jsx - Maintenance page
frontend/src/pages/Maintenance.jsx - Finance pages
frontend/src/pages/FuelExpenses.jsx - Reports page
frontend/src/pages/Reports.jsx - Auth API client
frontend/src/api/auth.api.js - Fleet API clients
frontend/src/api/vehicles.api.js - Trip API client
frontend/src/api/trips.api.js - Maintenance API client
frontend/src/api/maintenance.api.js - Finance API clients
frontend/src/api/fuelExpenses.api.js - Reports API client
frontend/src/api/reports.api.js
API and access
- Express API server
backend/server.js - Auth routes
backend/routes/auth.routes.js - Auth handlers
backend/controllers/auth.controller.js - JWT access control
backend/middleware/auth.middleware.js
Fleet operations
- Fleet routes
backend/routes/vehicle.routes.js - Vehicle and driver handlers
backend/controllers/vehicle.controller.js - Trip routes
backend/routes/trip.routes.js - Trip handler
backend/controllers/trip.controller.js - Maintenance routes
backend/routes/maintenance.routes.js - Maintenance handler
backend/controllers/maintenance.controller.js
Finance and reporting
- Finance routes
backend/routes/expense.routes.js - Expense and fuel handlers
backend/controllers/expense.controller.js - Fuel-log handler
backend/controllers/fuelLog.controller.js
Persistence
- Vehicle records
backend/models/Vehicle.js - Driver records
backend/models/Driver.js - Trip records
backend/models/Trip.js - Maintenance records
backend/models/Maintenance.js - Expense records
backend/models/Expense.js - Fuel-log records
backend/models/FuelLog.js - User records
backend/models/User.js
Other components
- Fleet user
Connections 48
- Fleet user → App routes: uses
- App routes → Auth context: checks session
- App routes → Fleet pages: routes
- App routes → Trip page: routes
- App routes → Maintenance page: routes
- App routes → Finance pages: routes
- App routes → Reports page: routes
- Auth context → Auth API client: requests auth
- Fleet pages → Fleet API clients: requests fleet
- Trip page → Trip API client: requests trips
- Maintenance page → Maintenance API client: requests records
- Finance pages → Finance API clients: requests finance
- Reports page → Reports API client: requests reports
- Auth API client → Express API server: sends requests
- Fleet API clients → Express API server: sends requests
- Trip API client → Express API server: sends requests
- Maintenance API client → Express API server: sends requests
- Finance API clients → Express API server: sends requests
- Reports API client → Express API server: sends requests
- Express API server → Auth routes: mounts routes
- Express API server → Fleet routes: mounts routes
- Express API server → Trip routes: mounts routes
- Express API server → Maintenance routes: mounts routes
- Express API server → Finance routes: mounts routes
- Auth routes → Auth handlers: dispatches
- Fleet routes → Vehicle and driver handlers: dispatches
- Trip routes → Trip handler: dispatches
- Maintenance routes → Maintenance handler: dispatches
- Finance routes → Expense and fuel handlers: dispatches
- Finance routes → Fuel-log handler: dispatches
- Auth routes → JWT access control: protects routes
- Fleet routes → JWT access control: protects routes
- Trip routes → JWT access control: protects routes
- Maintenance routes → JWT access control: protects routes
- Finance routes → JWT access control: protects routes
- Auth handlers → User records: reads/writes users
- Vehicle and driver handlers → Vehicle records: reads/writes vehicles
- Vehicle and driver handlers → Driver records: manages drivers
- Trip handler → Trip records: reads/writes trips
- Trip handler → Vehicle records: checks/updates status
- Trip handler → Driver records: checks/updates status
- Maintenance handler → Maintenance records: reads/writes records
- Maintenance handler → Vehicle records: updates status
- Expense and fuel handlers → Expense records: reads/writes expenses
- Expense and fuel handlers → Fuel-log records: aggregates fuel costs
- Expense and fuel handlers → Maintenance records: aggregates costs
- Expense and fuel handlers → Vehicle records: checks vehicle
- Fuel-log handler → Fuel-log records: reads/writes fuel logs