How saiganesh-09/fleet-management-platform works
FleetOps is a fleet operations platform spanning inventory, driver management, trip lifecycle, tracking, maintenance, fuel, documents, analytics, reporting, and AI assistance. The principal flow is an operator using the dashboard to make a fleet change or request; the frontend calls the backend, which applies domain logic and persists or retrieves data. The README documents backend layering and realtime behavior; unsampled service wiring is represented only where documented, and some domain endpoints are grouped at their documented boundaries.
Main entry points: domain.controller.ts Controllers · repositories Data repositories · domain.routes.ts API routes · main.py AI service
Components 25
Fleet dashboard
- Fleet dashboard
frontend/app/(app) - API client
frontend/lib/api.ts - Socket client
frontend/lib/socket.ts
Backend API
- API routes
backend/src/routes/domain.routes.ts - Controllers
backend/src/controllers/domain.controller.ts - Authentication
backend/src/services/auth.service.ts - Data repositories
backend/src/repositories
Fleet operations
- Fleet inventory
backend/src/services/vehicle.service.ts - Driver roster
backend/src/services/driver.service.ts - Trip lifecycle
backend/src/services/trip.service.ts - Maintenance
backend/src/services/maintenance.service.ts - Fuel operations
backend/src/services/fuel.service.ts - Documents
backend/src/services/document.service.ts - Notifications
backend/src/services/notification.service.ts
Analytics and AI
- Reports and analytics
backend/src/services/report.service.ts - Global search
backend/src/services/search.service.ts - AI proxy
backend/src/services/ai.service.ts - AI service
ai-service/app/main.py - Curated AI data
backend/src/controllers/aiData.controller.ts
Live tracking
- GPS simulator
backend/src/services/gpsSimulator.service.ts - Location service
backend/src/services/location.service.ts - Socket.IO server
backend/src/sockets/index.ts
Other components
- Fleet user
- PostgreSQL
- LLM provider
Connections 33
- Fleet user → Fleet dashboard: uses
- Fleet dashboard → API client: requests data
- API client → API routes: REST calls
- API routes → Controllers: dispatches
- Controllers → Fleet inventory: calls
- Controllers → Driver roster: calls
- Controllers → Trip lifecycle: calls
- Controllers → Maintenance: calls
- Controllers → Fuel operations: calls
- Controllers → Documents: calls
- Controllers → Notifications: calls
- Controllers → Reports and analytics: calls
- Controllers → Global search: calls
- API routes → Authentication: routes auth
- Fleet inventory → Data repositories: queries
- Driver roster → Data repositories: queries
- Trip lifecycle → Data repositories: queries
- Maintenance → Data repositories: queries
- Fuel operations → Data repositories: queries
- Documents → Data repositories: queries
- Notifications → Data repositories: queries
- Reports and analytics → Data repositories: reads
- Global search → PostgreSQL: searches
- Data repositories → PostgreSQL: reads and writes
- AI proxy → AI service: proxies requests
- AI service → Curated AI data: fetches context
- Curated AI data → PostgreSQL: reads curated data
- AI service → LLM provider: tool calls
- GPS simulator → Location service: records positions
- Location service → PostgreSQL: persists locations
- GPS simulator → Socket.IO server: broadcasts updates
- Socket.IO server → Socket client: pushes events
- Socket client → Fleet dashboard: updates views