How koppakaranjeethguptha0307-lab/neuroute works
NEURoute is a software-only logistics and accessibility platform for disruption-aware operations in Northeast India. Operators use its web interface and APIs to monitor corridors, report incidents, track shipments and vehicles, and plan safer routes; the documented operational flow combines weather, hazards, incidents, risk and delay estimates, rerouting, alerts, and live map updates. The backend also supports authentication, GIS, analytics, simulation, and offline field-report synchronization. Several route and API subsystems are represented by their existing directories because their implementations were not sampled.
Main entry points: simulation_service.py Scenario Simulation · repositories Persistence Repositories · route_orchestrator.py Route Orchestrator · incident_service.py Incident Handling
Components 23
Operator Web App
- Web Application
frontend/src/App.tsx - Operations Screens
frontend/src/pages - Offline Report Queue
frontend/src/utils/offlineQueue.ts
Backend API
- FastAPI Application
backend/app/main.py - Domain API Routes
backend/app/api/routes - Route Planning API
backend/app/api/routes/routes.py
Operational Services
- Authentication
backend/app/services/auth_service.py - Incident Handling
backend/app/services/incident_service.py - Shipment Lifecycle
backend/app/services/shipment_service.py - Scenario Simulation
backend/app/services/simulation_service.py - Live Event Broadcast
backend/app/services/event_broadcaster.py - GIS Services
backend/app/services/gis_service.py - Route Orchestrator
backend/app/services/route_orchestrator.py
Risk And Routing
- Risk Prediction
ai/services/risk_predictor.py - Delay Estimation
ai/services/delay_estimator.py - Route Optimization
ai/services/route_optimizer.py - Incident Classification
ai/services/classifier.py
Adapters And Storage
- Software Telemetry
backend/app/adapters - Routing Providers
backend/app/adapters/routing - Weather Providers
backend/app/adapters/weather - Relational Database
backend/app/database/session.py - Persistence Repositories
backend/app/repositories
Other components
- Operator
Connections 21
- Operator → Web Application: uses
- Web Application → Operations Screens: routes to
frontend/src/App.tsx - Operator → Offline Report Queue: queues field reports
- FastAPI Application → Domain API Routes: registers routes
backend/app/main.py - Domain API Routes → Authentication: authenticates users
backend/app/api/routes/auth.py - Route Planning API → Route Orchestrator: plans routes
backend/app/api/routes/routes.py - Scenario Simulation → Risk Prediction: calculates risk
backend/app/services/simulation_service.py - Scenario Simulation → Delay Estimation: estimates delay
backend/app/services/simulation_service.py - Scenario Simulation → Route Optimization: selects routes
backend/app/services/simulation_service.py - Scenario Simulation → Software Telemetry: reads telemetry
backend/app/services/simulation_service.py - Scenario Simulation → Live Event Broadcast: broadcasts updates
backend/app/services/simulation_service.py - Incident Handling → Live Event Broadcast: alerts operators
- Incident Handling → Persistence Repositories: persists incidents
backend/app/services/incident_service.py - Shipment Lifecycle → Persistence Repositories: persists shipments
backend/app/services/shipment_service.py - Authentication → Persistence Repositories: reads and writes users
backend/app/services/auth_service.py - Persistence Repositories → Relational Database: accesses
backend/app/repositories/base.py - Route Orchestrator → Route Optimization: optimizes alternatives
- Route Orchestrator → Routing Providers: requests geometry
- Weather Providers → Operator: provides provenance badges
- Operations Screens → Live Event Broadcast: displays live updates
- Incident Classification → Incident Handling: classifies reports