How abdullellahswe/fleetpulse works
FleetPulse is a fleet telemetry and operations dashboard for PHEV/GPS/OBD-II status, alerts, AI-assisted dispatch and analysis, LEZ geofencing, and fleet/ESG PDF reporting. Users sign in through Cognito, then use the dashboard to request fleet data and operational actions from the API; the API draws from PostgreSQL or fallback data and provides alert, AI, geospatial, and report capabilities. The repository also defines AWS infrastructure and a streaming ingestion path. Several frontend-to-API and streaming connections are inferred from the product structure rather than shown in the excerpts, so those links are dashed.
Main entry points: main.py Telemetry API · App.jsx Fleet dashboard · app.py AWS deployment · database.py Fleet database access
Components 23
Dashboard
- Fleet dashboard
src/frontend/src/App.jsx - Sign-in
src/frontend/src/Login.jsx - Browser auth
src/frontend/src/auth.js - Fleet map
src/frontend/src/FleetMap.jsx - Alerts panel
src/frontend/src/AlertsPanel.jsx - Chat assistant
src/frontend/src/ChatAssistant.jsx - Chat message
src/frontend/src/ChatMessage.jsx - AI status badge
src/frontend/src/EngineBadge.jsx
Telemetry API
- Telemetry API
src/telemetry-api/main.py - Token verification
src/telemetry-api/auth.py - AI assistance
src/telemetry-api/ai.py - Alert rules
src/telemetry-api/alerts.py - Geofencing
src/telemetry-api/geo.py - PDF reporting
src/telemetry-api/report.py
Telemetry Data
- Fleet database access
src/telemetry-api/database.py - Sample fleet data
src/telemetry-api/fallback_data.py - Telemetry producer
src/telemetry-api/kinesis_producer.py - Database consumer
src/workers/kinesis_db_consumer.py
AWS Platform
- Aurora PostgreSQL
fleet_pulse/stacks/database_stack.py - Kinesis streaming
fleet_pulse/stacks/streaming_stack.py - Cognito
fleet_pulse/stacks/auth_stack.py - AWS deployment
app.py
Other components
- Fleet operator
Connections 27
- Fleet operator → Fleet dashboard: uses
- Fleet dashboard → Sign-in: renders
src/frontend/src/App.jsx - Sign-in → Browser auth: signs in
src/frontend/src/Login.jsx - Browser auth → Cognito: authenticates
src/frontend/src/auth.js - Fleet dashboard → Fleet map: renders
src/frontend/src/App.jsx - Fleet dashboard → Alerts panel: renders
src/frontend/src/App.jsx - Fleet dashboard → Chat assistant: renders
src/frontend/src/App.jsx - Chat assistant → Chat message: renders
src/frontend/src/ChatAssistant.jsx - Chat message → AI status badge: renders
src/frontend/src/ChatMessage.jsx - Fleet dashboard → AI status badge: renders
src/frontend/src/App.jsx - Fleet dashboard → Telemetry API: requests data
- Telemetry API → Token verification: verifies requests
src/telemetry-api/main.py - Token verification → Cognito: fetches signing keys
src/telemetry-api/auth.py - Telemetry API → Fleet database access: loads fleet
src/telemetry-api/main.py - Telemetry API → Sample fleet data: uses fallback
src/telemetry-api/main.py - Telemetry API → Alert rules: refreshes alerts
src/telemetry-api/main.py - Alert rules → Geofencing: checks zones
src/telemetry-api/alerts.py - Telemetry API → Geofencing: checks dispatch zone
src/telemetry-api/main.py - Telemetry API → AI assistance: requests response
src/telemetry-api/main.py - Telemetry API → PDF reporting: builds PDF
src/telemetry-api/main.py - Fleet database access → Aurora PostgreSQL: queries
- Telemetry producer → Kinesis streaming: publishes events
- Kinesis streaming → Database consumer: delivers events
- Database consumer → Fleet database access: writes telemetry
- AWS deployment → Cognito: defines
app.py - AWS deployment → Aurora PostgreSQL: defines
app.py - AWS deployment → Kinesis streaming: defines
app.py