How vikram0678/vigil-flood works
VIGIL-FLOOD is a flash-flood early-warning and response system for hilly communities. Its primary workflow turns sensor and weather telemetry into village-level hazard analysis, actionable lead time, evacuation guidance, and live authority/citizen views. The backend also provides scenario simulation, external-data access, and Aapda Mitra disaster Q&A; the React dashboard adds GIS, XAI, and citizen-facing capabilities. Several subsystem links are documented by the README or imports, but unsampled routes and modules limit evidence for finer runtime relationships.
Main entry points: App.tsx Dashboard application · simulation.py Scenario analysis · routes.py REST API · router.py Assistant API
Components 34
Warning backend
- REST API
backend/app/api/routes.py - Telemetry stream
backend/app/api/websocket.py - FastAPI server
backend/app/main.py - External data connectors
backend/app/core/external_connectors.py - Tile cache
backend/app/core/tile_cache.py
Risk and response
- Input sanitizers
backend/app/core/sanitizers.py - Sensor health
backend/app/core/sensor_health.py - Dual ML risk engine
backend/app/core/ml_engine.py - Synthetic data
backend/app/core/synthetic_data.py - Lead-time estimator
backend/app/core/lead_time_engine.py - Evacuation and alerts
backend/app/core/action_engine.py - Scenario analysis
backend/app/core/simulation.py
Disaster assistant
- Assistant API
backend/app/aapda_mitra/router.py - Offline decision engine
backend/app/aapda_mitra/deterministic_engine.py - Assistant configuration
backend/app/aapda_mitra/aapda_mitra_config.py - OpenRouter client
backend/app/aapda_mitra/openrouter_client.py
React dashboard
- Dashboard application
frontend_react/src/App.tsx - Flood state
frontend_react/src/context/FloodContext.tsx - WebSocket hook
frontend_react/src/hooks/useWebSocket.ts - GIS maps
frontend_react/src/components/map/MapContainer.tsx - XAI analysis
frontend_react/src/components/analysis/DeepDiveAnalysis.tsx - What-if controls
frontend_react/src/components/simulation/WhatIfSandbox.tsx - Citizen alerts
frontend_react/src/components/citizen/CitizenView.tsx - Catchment panel
frontend_react/src/components/sidebar/PilotCatchmentPanel.tsx - Aapda Mitra chat
frontend_react/src/components/aapda_mitra/AapdaMitraBot.tsx - 2D GIS view
frontend_react/src/components/map/GISMap2D.tsx - 3D terrain view
frontend_react/src/components/map/GISMap3D.tsx - Flood Hub panel
frontend_react/src/components/map/GoogleFloodHubPanel.tsx - Hydrograph
frontend_react/src/components/modals/HydrographModal.tsx - Methodology
frontend_react/src/components/modals/MethodologyModal.tsx - Product tour
frontend_react/src/components/tour/ProductTourModal.tsx
Other components
- Authorities
- Citizens
- Weather and IoT
Connections 37
- Authorities → Dashboard application: use dashboard
- Citizens → Dashboard application: view alerts
- Weather and IoT → External data connectors: provide observations
- FastAPI server → REST API: mounts routes
backend/app/main.py - FastAPI server → Telemetry stream: mounts stream
backend/app/main.py - FastAPI server → Assistant API: mounts assistant
backend/app/main.py - REST API → Scenario analysis: requests analysis
backend/app/api/routes.py - REST API → Sensor health: queries health
backend/app/api/routes.py - REST API → External data connectors: fetches external data
backend/app/api/routes.py - REST API → Tile cache: uses tile cache
backend/app/api/routes.py - Telemetry stream → Scenario analysis: reads analysis
backend/app/api/websocket.py - Scenario analysis → Dual ML risk engine: evaluates risk
backend/app/core/simulation.py - Scenario analysis → Lead-time estimator: calculates lead time
backend/app/core/simulation.py - Scenario analysis → Evacuation and alerts: builds response plan
backend/app/core/simulation.py - Scenario analysis → Sensor health: checks sensor health
backend/app/core/simulation.py - Scenario analysis → Input sanitizers: uses validation
backend/app/core/simulation.py - Dual ML risk engine → Synthetic data: loads training data
backend/app/core/ml_engine.py - Assistant API → OpenRouter client: tries cloud model
backend/app/aapda_mitra/router.py - Assistant API → Offline decision engine: falls back to rules
backend/app/aapda_mitra/router.py - Assistant API → Assistant configuration: uses prompt settings
backend/app/aapda_mitra/router.py - Dashboard application → Flood state: reads shared state
frontend_react/src/App.tsx - Dashboard application → WebSocket hook: starts live updates
frontend_react/src/App.tsx - WebSocket hook → Flood state: updates telemetry
frontend_react/src/hooks/useWebSocket.ts - Flood state → REST API: fetches village data
frontend_react/src/context/FloodContext.tsx - Flood state → Scenario analysis: submits scenarios
- Dashboard application → GIS maps: renders map
frontend_react/src/App.tsx - GIS maps → 2D GIS view: renders 2D view
frontend_react/src/components/map/MapContainer.tsx - GIS maps → 3D terrain view: renders 3D view
frontend_react/src/components/map/MapContainer.tsx - GIS maps → Flood Hub panel: offers basemap panel
- Dashboard application → XAI analysis: renders analysis
frontend_react/src/App.tsx - Dashboard application → What-if controls: renders simulation
frontend_react/src/App.tsx - Dashboard application → Citizen alerts: renders citizen view
frontend_react/src/App.tsx - Dashboard application → Catchment panel: renders catchments
frontend_react/src/App.tsx - Dashboard application → Aapda Mitra chat: renders assistant
frontend_react/src/App.tsx - Dashboard application → Hydrograph: renders hydrograph
frontend_react/src/App.tsx - Dashboard application → Methodology: renders methodology
frontend_react/src/App.tsx - Dashboard application → Product tour: renders product tour
frontend_react/src/App.tsx