How harit117/road_routing_geoagentic_solution works
This is a FastAPI flood-aware emergency-routing service with a map interface. A user can inspect the road network and flood context, run or select rainfall simulations, view road-risk states, and request emergency routes that account for flooding. The runtime has two related flood-modeling paths: a normalized scenario risk engine and a time-stepped simulation with registered flood models; routing can use forecast loading to find safer facility routes. The README is empty, so capabilities and links here rely on the supplied source index and excerpts; unsampled details are omitted where their relationships are not evidenced.
Main entry points: risk_engine.py Risk engine · main.py FastAPI entry · susceptibility_bucket.py Susceptibility model · planner.py Mission planner
Components 30
Application API
- Map interface
backend/static/app.js - FastAPI entry
backend/app/main.py - Network API
backend/app/api/network.py - Simulation API
backend/app/api/simulation.py - Flood-risk API
backend/app/api/flood_risk.py - Routing API
backend/app/api/routing.py - API schemas
backend/app/api/schemas.py
Road network
- Network loader
backend/app/network/loader.py - Road network model
backend/app/network/models.py
Flood risk
- Risk engine
backend/app/flood/risk_engine.py - Risk parameters
backend/app/flood/config.py - Risk data types
backend/app/flood/models.py - Susceptibility scoring
backend/app/flood/susceptibility.py - Bucket model
backend/app/flood/bucket_model.py - Scenario rainfall
backend/app/flood/rainfall_provider.py
Simulation
- Risk service adapter
backend/app/simulation/flood_risk_service.py - Time-step engine
backend/app/simulation/engine.py - Rainfall series
backend/app/simulation/rainfall.py - Flood model contract
backend/app/simulation/flood_models/base.py - Susceptibility model
backend/app/simulation/flood_models/susceptibility_bucket.py - Placeholder model
backend/app/simulation/flood_models/placeholder_bucket.py - Model registry
backend/app/simulation/flood_models/__init__.py
Emergency routing
- Flood forecast
backend/app/routing/forecast.py - Routing graph
backend/app/routing/graph.py - Geospatial helpers
backend/app/routing/geo.py - Mission planner
backend/app/routing/planner.py - A-star search
backend/app/routing/astar.py - Emergency facilities
backend/app/routing/facilities.py - Mission profiles
backend/app/routing/missions.py
Other components
- Map user
Connections 48
- Map user → Map interface: uses
- FastAPI entry → Network API: registers
backend/app/main.py - FastAPI entry → Simulation API: registers
backend/app/main.py - FastAPI entry → Flood-risk API: registers
backend/app/main.py - FastAPI entry → Routing API: registers
backend/app/main.py - FastAPI entry → Network loader: loads
backend/app/main.py - FastAPI entry → Mission planner: initializes
backend/app/main.py - FastAPI entry → Risk engine: initializes
backend/app/main.py - FastAPI entry → Simulation API: builds demo
backend/app/main.py - Network loader → Road network model: builds
backend/app/network/loader.py - Network API → Road network model: uses
backend/app/api/network.py - Risk engine → Road network model: reads roads
backend/app/flood/risk_engine.py - Risk engine → Risk parameters: uses
backend/app/flood/risk_engine.py - Risk engine → Risk data types: uses
backend/app/flood/risk_engine.py - Risk engine → Susceptibility scoring: scores
backend/app/flood/risk_engine.py - Risk engine → Bucket model: advances
backend/app/flood/risk_engine.py - Risk engine → Scenario rainfall: loads scenarios
backend/app/flood/risk_engine.py - Scenario rainfall → Rainfall series: uses presets
backend/app/flood/rainfall_provider.py - Flood-risk API → Risk service adapter: calls
backend/app/api/flood_risk.py - Flood-risk API → Risk engine: uses
backend/app/api/flood_risk.py - Flood-risk API → API schemas: uses
backend/app/api/flood_risk.py - Risk service adapter → Risk engine: runs scenarios
backend/app/simulation/flood_risk_service.py - Risk service adapter → Time-step engine: reads active simulation
backend/app/simulation/flood_risk_service.py - Risk service adapter → API schemas: returns states
backend/app/simulation/flood_risk_service.py - Simulation API → Time-step engine: builds and runs
backend/app/api/simulation.py - Simulation API → Rainfall series: uses
backend/app/api/simulation.py - Simulation API → Model registry: selects model
backend/app/api/simulation.py - Simulation API → API schemas: uses
backend/app/api/simulation.py - Time-step engine → Road network model: simulates network
backend/app/simulation/engine.py - Time-step engine → Flood model contract: steps model
backend/app/simulation/engine.py - Time-step engine → Rainfall series: consumes series
backend/app/simulation/engine.py - Model registry → Flood model contract: registers
backend/app/simulation/flood_models/__init__.py - Model registry → Susceptibility model: registers
backend/app/simulation/flood_models/__init__.py - Model registry → Placeholder model: registers
backend/app/simulation/flood_models/__init__.py - Susceptibility model → Flood model contract: implements
backend/app/simulation/flood_models/susceptibility_bucket.py - Susceptibility model → Risk parameters: uses
backend/app/simulation/flood_models/susceptibility_bucket.py - Susceptibility model → Risk data types: uses
backend/app/simulation/flood_models/susceptibility_bucket.py - Susceptibility model → Susceptibility scoring: calculates
backend/app/simulation/flood_models/susceptibility_bucket.py - Susceptibility model → Bucket model: advances
backend/app/simulation/flood_models/susceptibility_bucket.py - Susceptibility model → Road network model: reads roads
backend/app/simulation/flood_models/susceptibility_bucket.py - Routing API → Mission planner: plans routes
backend/app/api/routing.py - Routing API → Flood forecast: builds forecast
backend/app/api/routing.py - Mission planner → Flood forecast: reads loading
backend/app/routing/planner.py - Mission planner → Routing graph: searches graph
backend/app/routing/planner.py - Mission planner → A-star search: calls
backend/app/routing/planner.py - Mission planner → Emergency facilities: chooses destination
backend/app/routing/planner.py - Mission planner → Mission profiles: uses profile
backend/app/routing/planner.py - Routing graph → Road network model: builds routing view
backend/app/routing/graph.py