How harini-buildon/roadtrack-ai works
RoadTrack AI presents a traffic-intelligence command center for multi-camera vehicle tracking, cross-camera association, route forecasting, and alerts. The intended workflow is camera observations through vision processing and track association, then road-graph-informed prediction and operator-facing maps. The excerpts show the API router’s dependencies, prediction and association internals, and map composition, but do not establish a live camera-ingestion deployment or every UI-to-API connection. The README describes additional capabilities—such as ALPR, homography, RBAC, and Gemini forensics—that are not fully verifiable in the sampled implementation.
Main entry points: routes.ts API Routes · App.tsx Application Shell · inMemoryDb.ts Tracking State · TrafficIntelligenceDashboard.tsx Intelligence Map
Components 26
Operator Interface
- Application Shell
src/App.tsx - Traffic Dashboard
src/components/TrafficIntelligenceDashboard.tsx - Association View
src/components/VehicleAssociationTab.tsx - Alerts View
src/components/AlertsTab.tsx - Audit Trail
src/components/AuditTrailTab.tsx - Drive Export
src/services/googleDriveService.ts - Drive Authorization
src/services/googleDriveAuth.ts
API Orchestration
- API Routes
src/server/routes.ts
Tracking Intelligence
- Vision Pipeline
src/server/ai/visionPipeline.ts - Track Association
src/server/ai/associationEngine.ts - Tracking State
src/server/db/inMemoryDb.ts - Alert Engine
src/server/services/alertEngine.ts
Spatial Prediction
- Road Graph
src/server/graph/roadGraphEngine.ts - Route Prediction
src/server/ai/predictionEngine.ts - Model Evaluation
src/server/services/modelEvaluationService.ts - Route Forensics
src/server/ai/geminiService.ts
Command Visualization
- Command Map
src/components/EcoCommandCenterMap.tsx - Intelligence Map
src/components/TrafficIntelligenceDashboard.tsx - MapLibre Renderer
src/components/map/MapLibreCommandMap.tsx - Realtime OSM Map
src/components/map/RealtimeOpenStreetMap.tsx - Vehicle Layer
src/components/map/VehicleLayer.tsx - Prediction Layer
src/components/map/PredictionRouteLayer.tsx - Alert Layer
src/components/map/AlertLayer.tsx - Geo Projection
src/services/map/GeoProjectionService.ts
Other components
- Operator
- Google Drive
Connections 28
- Operator → Application Shell: uses
- Application Shell → Traffic Dashboard: renders
src/App.tsx - Application Shell → Association View: renders
src/App.tsx - Application Shell → Alerts View: renders
src/App.tsx - Application Shell → Audit Trail: renders
src/App.tsx - API Routes → Tracking State: reads and writes
src/server/routes.ts - API Routes → Vision Pipeline: invokes
src/server/routes.ts - API Routes → Track Association: invokes
src/server/routes.ts - API Routes → Route Prediction: invokes
src/server/routes.ts - API Routes → Alert Engine: invokes
src/server/routes.ts - API Routes → Model Evaluation: invokes
src/server/routes.ts - API Routes → Route Forensics: invokes
src/server/routes.ts - Track Association → Tracking State: reads
src/server/ai/associationEngine.ts - Route Prediction → Tracking State: reads
src/server/ai/predictionEngine.ts - Route Prediction → Road Graph: gets outgoing edges
src/server/ai/predictionEngine.ts - Road Graph → Tracking State: reads road data
src/server/graph/roadGraphEngine.ts - Alert Engine → Tracking State: reads and records alerts
src/server/services/alertEngine.ts - Application Shell → Command Map: renders
src/App.tsx - Command Map → MapLibre Renderer: selects renderer
src/components/EcoCommandCenterMap.tsx - Command Map → Realtime OSM Map: selects renderer
src/components/EcoCommandCenterMap.tsx - Traffic Dashboard → Intelligence Map: renders map
src/components/TrafficIntelligenceDashboard.tsx - Intelligence Map → Vehicle Layer: uses layer
src/components/TrafficIntelligenceDashboard.tsx - Intelligence Map → Prediction Layer: uses layer
src/components/TrafficIntelligenceDashboard.tsx - Intelligence Map → Alert Layer: uses layer
src/components/TrafficIntelligenceDashboard.tsx - Vehicle Layer → Geo Projection: projects coordinates
src/components/map/VehicleLayer.tsx - Prediction Layer → Geo Projection: projects coordinates
src/components/map/PredictionRouteLayer.tsx - Drive Export → Drive Authorization: uses authorization
src/services/googleDriveService.ts - Drive Authorization → Google Drive: authorizes access
src/services/googleDriveAuth.ts