How ayyappan1221/fleet-tracking-platform works
This is a fleet-monitoring web platform: users authenticate in the React client, then manage vehicles, routes, GPS locations, geofences, alerts, maintenance, and dashboard summaries through FastAPI. The route workflow is shown in detail: a manager submits stops, the API delegates planning and status changes to route services, and those services persist route and stop state. README capabilities preserve the unsampled domain branches; their exact service/API interactions are not asserted beyond documented endpoints. Source evidence is sampled, so some links are omitted.
Main entry points: database.py SQL database · App.jsx React app · main.py FastAPI app · api.js API client
Components 25
Fleet web client
- React app
frontend/src/App.jsx - Sign-in
frontend/src/pages/AuthPage.jsx - Route planning
frontend/src/pages/RoutesPage.jsx - API client
frontend/src/api.js - Fleet pages
frontend/src/pages
REST API
- FastAPI app
app/main.py - Auth endpoints
app/api/v1/auth.py - Route endpoints
app/api/v1/routes.py - Fleet endpoints
app/api/v1
Fleet operations
- Route planning
app/services/route_service.py - Vehicle management
app/services/vehicle_service.py - GPS tracking
app/services/location_service.py - Geofence alerts
app/services/geofence_service.py - Maintenance scheduling
app/services/maintenance_service.py - Alerts and reports
app/services
Identity
- Token security
app/core/security.py
Persistence
- User records
app/models/user.py - Vehicle records
app/models/vehicle.py - Routes and stops
app/models/route.py - Location records
app/models/location.py - Geofence records
app/models/geofence.py - Maintenance records
app/models/maintenance.py - Alert records
app/models/alert.py - SQL database
app/core/database.py
Other components
- Fleet user
Connections 28
- Fleet user → React app: uses
README.md - React app → Sign-in: routes to
frontend/src/App.jsx - React app → Route planning: routes to
frontend/src/App.jsx - React app → Fleet pages: routes to
frontend/src/App.jsx - Sign-in → API client: requests
frontend/src/pages/AuthPage.jsx - Route planning → API client: requests
frontend/src/pages/RoutesPage.jsx - Fleet pages → API client: requests
frontend/src/pages/RoutesPage.jsx - API client → FastAPI app: calls API
README.md - FastAPI app → Auth endpoints: registers
- FastAPI app → Route endpoints: registers
- FastAPI app → Fleet endpoints: registers
app/api/v1/__init__.py - Auth endpoints → Token security: hashes and signs
app/api/v1/auth.py - Auth endpoints → User records: reads and writes
app/api/v1/auth.py - Route endpoints → Route planning: delegates
app/api/v1/routes.py - Route planning → Vehicle records: checks vehicle
app/services/route_service.py - Route planning → Routes and stops: creates and updates
app/services/route_service.py - Vehicle management → Vehicle records: manages
app/services/vehicle_service.py - GPS tracking → Location records: records GPS
app/services/location_service.py - Geofence alerts → Geofence records: manages
app/services/geofence_service.py - Maintenance scheduling → Maintenance records: manages
app/services/maintenance_service.py - Alerts and reports → Alert records: manages
- SQL database → Vehicle records: stores
app/models/vehicle.py - SQL database → Routes and stops: stores
app/models/route.py - SQL database → User records: stores
app/models/user.py - SQL database → Location records: stores
app/models/location.py - SQL database → Geofence records: stores
app/models/geofence.py - SQL database → Maintenance records: stores
app/models/maintenance.py - SQL database → Alert records: stores