How krekker0101/rohai works
Smart Traffic AI combines a traffic-control backend, deterministic simulation, camera-based vision, and an operator dashboard. The principal loop advances simulated or observed traffic, computes a desired signal (including emergency priority), applies safety constraints, and exposes telemetry to the dashboard. The separate vision path captures frames, detects and analyzes traffic using camera geometry, then supplies observed state and video overlays. The README documents the major capabilities; some subsystem links below rely on that documentation or the SOURCE INDEX because their implementation excerpts were not provided.
Main entry points: pipeline.py Vision pipeline · engine.py Simulation engine · main.py HTTP and WebSocket API · vision_runtime.py Vision runtime
Components 28
Traffic control
- Phase controller
packages/traffic_core/src/traffic_core/controller.py - Observed controller
packages/traffic_core/src/traffic_core/observed_controller.py - Safety state machine
packages/traffic_core/src/traffic_core/safety.py - Traffic state models
packages/traffic_core/src/traffic_core/models.py
Vision pipeline
- Video sources
packages/vision/src/traffic_vision/sources.py - YOLO detector
packages/vision/src/traffic_vision/detector.py - Vision pipeline
packages/vision/src/traffic_vision/pipeline.py - Camera geometry
packages/vision/src/traffic_vision/geometry.py - Traffic analytics
packages/vision/src/traffic_vision/analytics.py - Detection and track models
packages/vision/src/traffic_vision/models.py - Video overlay
packages/vision/src/traffic_vision/overlay.py
Backend runtime
- HTTP and WebSocket API
apps/backend/src/smart_traffic_backend/main.py - Runtime settings
apps/backend/src/smart_traffic_backend/config.py - Simulation runtime
apps/backend/src/smart_traffic_backend/runtime.py - Demo runtime
apps/backend/src/smart_traffic_backend/demo_runtime.py - Vision runtime
apps/backend/src/smart_traffic_backend/vision_runtime.py - Hardware adapter
apps/backend/src/smart_traffic_backend/hardware.py
Operator dashboard
- Dashboard app
apps/dashboard/src/App.tsx - Traffic views
apps/dashboard/src/components/Overview.tsx - Analytics and controls
apps/dashboard/src/features/Analytics.tsx - REST client
apps/dashboard/src/data/api.ts - Telemetry normalization
apps/dashboard/src/domain/telemetry.ts
Simulation and metrics
- Simulation engine
packages/simulator/src/traffic_simulator/engine.py - Queue simulator
packages/simulator/src/traffic_simulator/simulator.py - KPI comparison
packages/simulator/src/traffic_simulator/comparison.py
Other components
- Operator
- Camera or video source
- ESP32 hardware
Connections 34
- Operator → Dashboard app: operates
- Dashboard app → Traffic views: renders
apps/dashboard/src/App.tsx - Dashboard app → Analytics and controls: offers
apps/dashboard/src/App.tsx - Analytics and controls → REST client: requests data
- Dashboard app → REST client: requests data
apps/dashboard/src/App.tsx - Traffic views → Telemetry normalization: uses
apps/dashboard/src/components/Overview.tsx - REST client → HTTP and WebSocket API: calls REST
- HTTP and WebSocket API → Simulation runtime: drives
apps/backend/src/smart_traffic_backend/main.py - HTTP and WebSocket API → Demo runtime: serves demo
apps/backend/src/smart_traffic_backend/main.py - HTTP and WebSocket API → Vision runtime: serves vision
apps/backend/src/smart_traffic_backend/main.py - Runtime settings → Simulation runtime: configures
apps/backend/src/smart_traffic_backend/config.py - Runtime settings → Vision runtime: configures
apps/backend/src/smart_traffic_backend/config.py - Simulation runtime → Simulation engine: advances
apps/backend/src/smart_traffic_backend/runtime.py - Simulation runtime → Hardware adapter: applies signals
- Demo runtime → Simulation engine: advances
apps/backend/src/smart_traffic_backend/demo_runtime.py - Simulation engine → Queue simulator: advances queues
packages/simulator/src/traffic_simulator/engine.py - Simulation engine → Phase controller: requests decisions
packages/simulator/src/traffic_simulator/engine.py - Simulation engine → Safety state machine: advances safety
packages/simulator/src/traffic_simulator/engine.py - Phase controller → Traffic state models: uses types
packages/traffic_core/src/traffic_core/controller.py - Observed controller → Phase controller: delegates policy
packages/traffic_core/src/traffic_core/observed_controller.py - Observed controller → Safety state machine: advances safety
packages/traffic_core/src/traffic_core/observed_controller.py - Vision runtime → Vision pipeline: runs
apps/backend/src/smart_traffic_backend/vision_runtime.py - Vision runtime → Observed controller: controls observed state
apps/backend/src/smart_traffic_backend/vision_runtime.py - Video sources → Vision pipeline: provides frames
packages/vision/src/traffic_vision/pipeline.py - Camera or video source → Video sources: supplies video
- Vision pipeline → YOLO detector: infers detections
packages/vision/src/traffic_vision/pipeline.py - Vision pipeline → Traffic analytics: analyzes detections
packages/vision/src/traffic_vision/pipeline.py - Vision pipeline → Video overlay: renders frames
packages/vision/src/traffic_vision/pipeline.py - Traffic analytics → Camera geometry: uses calibration
packages/vision/src/traffic_vision/analytics.py - Vision pipeline → Detection and track models: publishes results
packages/vision/src/traffic_vision/pipeline.py - Vision runtime → Traffic state models: produces traffic state
apps/backend/src/smart_traffic_backend/vision_runtime.py - HTTP and WebSocket API → Dashboard app: streams telemetry
- KPI comparison → Simulation engine: benchmarks
packages/simulator/src/traffic_simulator/comparison.py - Hardware adapter → ESP32 hardware: optional connection