How paarthexe/routeshield works
RouteShield turns an origin/destination and hazard scenario into inspectable evacuation corridors, selecting a viable primary or contingency and checking backup independence. The documented flow covers route discovery, evidence collection, bottleneck and cutoff analysis, viability decisions, and a decision briefing; the React interface presents maps, route comparisons, and operational panels. Source excerpts show the principal API, routing, sampling, and scoring handoffs. Several documented capabilities are represented at their exact service or component paths, but their internal calls are not inferred where source was not sampled.
Main entry points: routes.py Route API · sampling.py Route sampling · agent_service.py Decision pipeline · App.jsx Application shell
Components 34
Route planning UI
- Application shell
frontend/src/App.jsx - API client
frontend/src/services/api.js - Map and samples
frontend/src/components/MapView.jsx - Search panel
frontend/src/components/SearchPanel.jsx - Decision panels
frontend/src/components/SidePanel.jsx - Segment manager
frontend/src/components/SegmentManager.jsx
API orchestration
- Route API
backend/app/api/routes.py - Location API
backend/app/api/location.py - Zone API
backend/app/api/zone.py
Corridor analysis
- Route discovery
backend/app/services/routing.py - Route sampling
backend/app/services/sampling.py - Decision pipeline
backend/app/services/agent_service.py - Bottleneck scoring
backend/app/services/bottleneck_service.py - Viability ranking
backend/app/services/viability_service.py - Backup independence
backend/app/services/redundancy_service.py - Corridor segments
backend/app/services/segmentation_service.py - Segment repair
backend/app/services/segment_repair_service.py - Hazard cutoff
backend/app/services/isochrone_service.py
Evidence services
- Geocoding
backend/app/services/geocoding.py - Mireye hazards
backend/app/services/mireye_service.py - Bridge inventory
backend/app/services/nbi_service.py - Weather evidence
backend/app/services/weather_service.py - Population exposure
backend/app/services/population_service.py - Network capacity
backend/app/services/capacity_service.py - Emergency incidents
backend/app/services/incident_service.py - Corridor facilities
backend/app/services/poi_service.py - Connectivity gaps
backend/app/services/connectivity_service.py - Traffic conditions
backend/app/services/traffic_service.py - Live web alerts
backend/app/services/scraper_service.py
Operational features
- Live monitoring
backend/app/services/monitoring_service.py - After-action cases
backend/app/services/aar_service.py - Zone allocation
backend/app/services/zone_service.py - Response cache
backend/app/services/cache.py
Other components
- Planner
Connections 39
- Planner → Application shell: plans evacuation
README.md - Application shell → API client: requests analysis
frontend/src/App.jsx - Application shell → Map and samples: renders map
frontend/src/App.jsx - Application shell → Search panel: renders search
frontend/src/App.jsx - Application shell → Decision panels: renders decisions
frontend/src/App.jsx - API client → Route API: posts analysis
frontend/src/services/api.js - API client → Location API: resolves place
frontend/src/services/api.js - API client → Zone API: plans zones
frontend/src/services/api.js - Decision panels → Segment manager: renders segments
frontend/src/components/SidePanel.jsx - Segment manager → API client: requests repair
frontend/src/components/SegmentManager.jsx - Route API → Route discovery: generates routes
backend/app/api/routes.py - Route API → Geocoding: resolves origin
backend/app/api/routes.py - Route API → Live monitoring: registers routes
backend/app/api/routes.py - Route API → Live web alerts: fetches alerts
backend/app/api/routes.py - Location API → Geocoding: resolves query
backend/app/api/location.py - Zone API → Zone allocation: plans evacuation
backend/app/api/zone.py - Route discovery → Route sampling: samples corridors
backend/app/services/routing.py - Route discovery → Corridor segments: builds segments
backend/app/services/routing.py - Route sampling → Bridge inventory: looks up bridges
backend/app/services/sampling.py - Route sampling → Mireye hazards: probes hazards
backend/app/services/sampling.py - Route sampling → Traffic conditions: collects traffic
backend/app/services/sampling.py - Route sampling → Weather evidence: collects elevation
README.md - Decision pipeline → Bottleneck scoring: scores risks
backend/app/services/agent_service.py - Decision pipeline → Viability ranking: ranks corridors
backend/app/services/agent_service.py - Decision pipeline → Backup independence: checks backup
backend/app/services/agent_service.py - Decision pipeline → Mireye hazards: asks hazard insight
backend/app/services/agent_service.py - Decision pipeline → Bridge inventory: reports bridge source
backend/app/services/agent_service.py - Route API → Population exposure: analyzes exposure
backend/app/api/routes.py - Route API → Network capacity: analyzes capacity
backend/app/api/routes.py - Route API → Emergency incidents: collects incidents
backend/app/api/routes.py - Route API → Corridor facilities: collects facilities
backend/app/api/routes.py - Route API → Connectivity gaps: checks dead zones
backend/app/api/routes.py - Route API → After-action cases: builds case studies
backend/app/api/routes.py - Route API → Hazard cutoff: computes cutoff
backend/app/api/routes.py - Route API → Segment repair: repairs segments
backend/app/api/routes.py - Route API → Live monitoring: streams updates
backend/app/api/routes.py - Route sampling → Response cache: uses cache
- Mireye hazards → Response cache: uses cache
backend/app/services/mireye_service.py - After-action cases → Response cache: uses cache
backend/app/services/aar_service.py