How vaidik04/q-transit-nexus works
Q-Transit Nexus is a transportation digital twin and optimization system. Its documented core loop models network conditions, predicts future traffic, computes routing and control decisions, applies them to the simulation, and measures outcomes; the dashboard presents operational state and results. The repository also contains a separate backend digital-twin/orchestration stack and a 137ML prediction package. The graph reflects documented workflows and indexed imports; several subsystem internals and dashboard-to-API wiring were not sampled, so those connections are omitted.
Main entry points: orchestrator.py Cycle Orchestrator · state_manager.py Twin State Contract · at_dqpso.py Adaptive Routing · network_engine.py Urban Network
Components 23
Dashboard
- Operations Dashboard
dashboard/src/App.jsx - Map and Panels
dashboard/src/components
Backend Services
- Backend Entry
backend/main.py - API Routes
backend/api - Cycle Orchestrator
backend/orchestrator.py
Digital Twin
- Urban Network
backend/modules/network_engine.py - Backend Digital Twin
backend/modules/simulation_engine.py - Twin State Contract
simulation/state_manager.py - Scenario Runs
simulation/scenarios - Route and Signal Control
simulation/route_applier.py - Simulation Metrics
simulation/metrics.py
Prediction and Optimization
- Traffic Prediction
backend/modules/traffic_prediction.py - 137ML Prediction
137ML/prediction - Feature Engineering
137ML/prediction/feature_engineering.py - Adaptive Routing
backend/modules/at_dqpso.py - Optimization Algorithms
optimization - Algorithm Benchmarks
optimization/benchmarks.py
Transport Intelligence
- Transit Intelligence
backend/modules/transit_intelligence.py - EV Charging
backend/modules/ev_intelligence.py - Emergency Priority
backend/modules/emergency_priority.py - Decision Explanations
backend/modules/explainability.py - Trust Ledger
backend/modules/trust_layer.py
Other components
- Operator
Connections 34
- Operator → Operations Dashboard: operates
- Operations Dashboard → Map and Panels: renders
dashboard/src/App.jsx - Backend Entry → Cycle Orchestrator: initializes
backend/main.py - Backend Entry → API Routes: registers
backend/main.py - Cycle Orchestrator → Urban Network: creates
backend/orchestrator.py - Cycle Orchestrator → Backend Digital Twin: creates
backend/orchestrator.py - Backend Digital Twin → Urban Network: uses
backend/modules/simulation_engine.py - Cycle Orchestrator → Traffic Prediction: creates
backend/orchestrator.py - Cycle Orchestrator → Adaptive Routing: creates
backend/orchestrator.py - Cycle Orchestrator → Transit Intelligence: creates
backend/orchestrator.py - Cycle Orchestrator → EV Charging: creates
backend/orchestrator.py - Cycle Orchestrator → Emergency Priority: creates
backend/orchestrator.py - Cycle Orchestrator → Decision Explanations: creates
backend/orchestrator.py - Cycle Orchestrator → Trust Ledger: creates
backend/orchestrator.py - Cycle Orchestrator → Backend Digital Twin: advances
backend/orchestrator.py - Cycle Orchestrator → Adaptive Routing: applies routes
backend/orchestrator.py - Cycle Orchestrator → Decision Explanations: records reasons
backend/orchestrator.py - Cycle Orchestrator → Trust Ledger: records audit
backend/orchestrator.py - Traffic Prediction → Urban Network: uses
backend/modules/traffic_prediction.py - 137ML Prediction → Feature Engineering: includes
137ML/prediction/inference.py - Feature Engineering → 137ML Prediction: builds features for
137ML/prediction/feature_engineering.py - Urban Network → Optimization Algorithms: provides graph
- Adaptive Routing → Optimization Algorithms: uses algorithms
- Algorithm Benchmarks → Optimization Algorithms: compares algorithms
optimization/benchmarks.py - Twin State Contract → Backend Digital Twin: reads telemetry from
simulation/state_manager.py - Scenario Runs → Twin State Contract: registers incidents
simulation/scenarios/accident.py - Scenario Runs → Route and Signal Control: applies reroutes
simulation/scenarios/accident.py - Scenario Runs → Simulation Metrics: measures outcomes
simulation/scenarios/accident.py - Twin State Contract → 137ML Prediction: supplies twin state
- Twin State Contract → Adaptive Routing: supplies twin state
- Twin State Contract → API Routes: exposes state to
- Adaptive Routing → Route and Signal Control: sends route decisions
- Route and Signal Control → Twin State Contract: changes network state
- Simulation Metrics → Operations Dashboard: reports results to