How uakash07/driver-behavior-telemetry-analytics works
This is a post-drive driver profiling and risk analytics platform. Its primary workflow generates or ingests telemetry, derives trip-level behavior features and labels, then computes risk, trends, coaching, and model explanations. A FastAPI service exposes the resulting analytics to a React fleet and driver dashboard. The pipeline orchestration and core analytics calls are visible in source; the README documents the API-to-dashboard relationship and several dashboard capabilities whose implementation details were not sampled.
Main entry points: engineering.py Behavior Labels · pipeline.py Telemetry Cleaning · classifier.py Classifiers & Anomalies · risk.py Risk Scoring
Components 14
Telemetry Pipeline
- Telemetry Generator
data/generate_dataset.py - Telemetry Cleaning
preprocessing/pipeline.py - Trip Features
features/engineering.py - Behavior Labels
features/engineering.py
Risk Analytics
- Classifiers & Anomalies
models/classifier.py - Risk Scoring
scoring/risk.py - Trend Analysis
analysis/trends.py - Driver Coaching
analysis/feedback.py - Feature Importance
explainability/insights.py
API Serving
- Analytics REST API
dashboard/fastapi_app.py
Driver Dashboard
- React Entry
dashboard-react/src/main.tsx - Fleet & Driver Views
dashboard-react/src/App.tsx
Other components
- Pipeline Operator
- Dashboard User
Connections 22
- Pipeline Operator → Telemetry Generator: starts pipeline
- Pipeline Operator → Telemetry Cleaning: starts pipeline
- Pipeline Operator → Trip Features: starts pipeline
- Pipeline Operator → Behavior Labels: starts pipeline
- Pipeline Operator → Classifiers & Anomalies: starts pipeline
- Pipeline Operator → Risk Scoring: starts pipeline
- Pipeline Operator → Trend Analysis: starts pipeline
- Pipeline Operator → Driver Coaching: starts pipeline
- Pipeline Operator → Feature Importance: starts pipeline
- Pipeline Operator → Analytics REST API: launches server
- Telemetry Generator → Telemetry Cleaning: raw telemetry
main.py - Telemetry Cleaning → Trip Features: cleaned telemetry
main.py - Trip Features → Behavior Labels: trip features
main.py - Behavior Labels → Classifiers & Anomalies: labeled trips
main.py - Behavior Labels → Risk Scoring: labeled trips
main.py - Risk Scoring → Trend Analysis: scored trips
main.py - Trend Analysis → Driver Coaching: trended trips
main.py - Classifiers & Anomalies → Feature Importance: trained forest
main.py - Dashboard User → React Entry: opens dashboard
- React Entry → Fleet & Driver Views: renders
dashboard-react/src/main.tsx - Fleet & Driver Views → Analytics REST API: requests analytics
README.md - Analytics REST API → Fleet & Driver Views: returns analytics
README.md