How deepakksah/v-gpstracker works
V-Fleet turns vehicle GPS packets into live fleet status and history: device streams are decoded, filtered and evaluated, then served through persistent storage and WebSockets to a dashboard. The dashboard also exposes fleet management, geofences, alerts, playback and reports. Backend source excerpts establish the available implementation modules, while README architecture statements support several connections; unsampled details and some wiring remain unverified, so those relationships are dashed.
Main entry points: App.tsx Dashboard Shell · internal Alert Evaluation · db.go Database Access · TelemetryDrawer.tsx Telemetry Drawer
Components 23
Telemetry Ingestion
- Fleet Simulator
backend/cmd/simulator/main.go - Socket Listeners
backend/internal/ingestion/listener.go - Protocol Parsers
backend/internal/ingestion
Processing and Storage
- Kalman Filter
backend/internal/filter/kalman.go - Alert Evaluation
backend/internal - Hot State Cache
backend/internal/state/state.go - Database Access
backend/internal/database/db.go
Fleet Services
- WebSocket Hub
backend/internal/websocket/hub.go - REST API
backend/internal/api/routes.go - Scheduled Reports
backend/internal/cron/reporter.go
Fleet Dashboard
- Dashboard Shell
frontend/src/App.tsx - Live Fleet Map
frontend/src/components/FleetMap.tsx - Telemetry Drawer
frontend/src/components/TelemetryDrawer.tsx - Reverse Geocoding
frontend/src/utils/geocoding.ts - Vehicle Illustrations
frontend/src/utils/vehicleImages.tsx - Trip Playback
frontend/src/views/PlaybackView.tsx - Geofence Manager
frontend/src/views/GeofencesView.tsx - Alerts View
frontend/src/views/AlertsView.tsx - Fleet Management
frontend/src/views/FleetManagementView.tsx - Reports View
frontend/src/views/ReportsView.tsx
Other components
- GPS Devices
- PostgreSQL
- Fleet Operator
Connections 25
- GPS Devices → Socket Listeners: send packets
README.md - Fleet Simulator → Socket Listeners: sends telemetry
README.md - Socket Listeners → Protocol Parsers: decode packets
README.md - Protocol Parsers → Kalman Filter: filter fixes
README.md - Kalman Filter → Alert Evaluation: evaluate telemetry
- Alert Evaluation → Hot State Cache: update hot state
README.md - Alert Evaluation → Database Access: write telemetry
README.md - Hot State Cache → WebSocket Hub: publish updates
README.md - Alert Evaluation → WebSocket Hub: broadcast alerts
- Database Access → PostgreSQL: read and write
- REST API → Database Access: access records
README.md - Scheduled Reports → Database Access: query telemetry
- WebSocket Hub → Dashboard Shell: push live updates
README.md - REST API → Dashboard Shell: serve dashboard data
README.md - Fleet Operator → Dashboard Shell: use dashboard
- Dashboard Shell → Live Fleet Map: renders
frontend/src/App.tsx - Dashboard Shell → Telemetry Drawer: renders
frontend/src/App.tsx - Dashboard Shell → Trip Playback: renders
frontend/src/App.tsx - Dashboard Shell → Geofence Manager: renders
frontend/src/App.tsx - Dashboard Shell → Alerts View: renders
frontend/src/App.tsx - Dashboard Shell → Fleet Management: renders
frontend/src/App.tsx - Dashboard Shell → Reports View: renders
frontend/src/App.tsx - Telemetry Drawer → Reverse Geocoding: fetches locations
frontend/src/components/TelemetryDrawer.tsx - Telemetry Drawer → Vehicle Illustrations: renders
frontend/src/components/TelemetryDrawer.tsx - Dashboard Shell → Vehicle Illustrations: renders
frontend/src/App.tsx