How prithvisb08/flash-flood-intelligence works
JALRAKSHAK is a basin-scale flash-flood intelligence and OASIS CAP early-warning decision-support platform. Operators use the admin console to inspect basin risk, telemetry, spatial hazards and evacuation routes, and to run scenarios; the public citizen portal presents risk, safe zones and recommended actions. The backend syncs telemetry, evaluates hydrological and compound risk, maintains per-session simulation state, and exposes alerts, routes and bulletins. README-documented integrations and capabilities are included, but their precise internal call paths are not all visible in the sampled source.
Main entry points: main.py API and orchestration · Admin.tsx Admin console · Citizen.tsx Citizen portal · weather.py Weather provider
Components 25
Backend intelligence
- API and orchestration
backend/main.py - Session state
backend/state.py - Risk assessment
backend/risk_engine.py - Hydrology physics
backend/hydrology.py - Evacuation routing
backend/routing.py - API data contracts
backend/schemas.py - Runtime settings
backend/settings.py
Telemetry and dispatch
- Weather provider
backend/weather.py - External data feeds
backend/providers.py - Alert and CAP dispatch
backend/alerting.py
Operations console
- Admin console
frontend/src/pages/Admin.tsx - Spatial digital twin
frontend/src/components/MapDigitalTwin.tsx - Scenario simulation
frontend/src/components/SimulationPanel.tsx - Sensor monitoring
frontend/src/components/SensorPanel.tsx - Satellite monitoring
frontend/src/components/SatelliteFeed.tsx - AI assistant
frontend/src/components/RakshakAI.tsx - Basin map
frontend/src/components/MapWrapper.tsx - API endpoint config
frontend/src/config.ts - India boundary data
frontend/src/data/indiaBoundary.ts
Public interface
- Citizen portal
frontend/src/pages/Citizen.tsx
Other components
- Duty officer
- Citizen
- Open-Meteo
- Other telemetry feeds
- Dispatch channels
Connections 32
- Duty officer → Admin console: uses
- Citizen → Citizen portal: uses
- Admin console → API and orchestration: requests risk
frontend/src/pages/Admin.tsx - Citizen portal → API and orchestration: requests risk
frontend/src/pages/Citizen.tsx - Citizen portal → API and orchestration: syncs telemetry
frontend/src/pages/Citizen.tsx - Admin console → Spatial digital twin: renders
frontend/src/pages/Admin.tsx - Admin console → Scenario simulation: renders
frontend/src/pages/Admin.tsx - Admin console → Sensor monitoring: renders
frontend/src/pages/Admin.tsx - Admin console → Satellite monitoring: renders
frontend/src/pages/Admin.tsx - Admin console → AI assistant: renders
frontend/src/pages/Admin.tsx - Spatial digital twin → API and orchestration: requests hazards
frontend/src/components/MapDigitalTwin.tsx - API and orchestration → Session state: loads session
backend/main.py - API and orchestration → Risk assessment: computes risk
backend/main.py - API and orchestration → Hydrology physics: uses hydrology
backend/main.py - API and orchestration → Evacuation routing: calculates routes
backend/main.py - API and orchestration → External data feeds: serves feed data
backend/main.py - API and orchestration → Weather provider: syncs weather
backend/main.py - API and orchestration → Alert and CAP dispatch: dispatches alerts
backend/main.py - Weather provider → Open-Meteo: fetches forecasts
README.md - Hydrology physics → Weather provider: uses weather data
backend/hydrology.py - External data feeds → Other telemetry feeds: fetches telemetry
README.md - Alert and CAP dispatch → Dispatch channels: sends notifications
README.md - API and orchestration → API data contracts: uses contracts
backend/main.py - Weather provider → Runtime settings: reads endpoints
backend/weather.py - External data feeds → Runtime settings: reads endpoints
backend/providers.py - Alert and CAP dispatch → Runtime settings: reads config
backend/alerting.py - API and orchestration → Admin console: returns risk data
frontend/src/pages/Admin.tsx - API and orchestration → Citizen portal: returns risk data
frontend/src/pages/Citizen.tsx - Spatial digital twin → API endpoint config: uses API address
frontend/src/components/MapDigitalTwin.tsx - Citizen portal → API endpoint config: uses API address
frontend/src/pages/Citizen.tsx - Admin console → API endpoint config: uses API address
frontend/src/pages/Admin.tsx - Basin map → India boundary data: renders boundary
frontend/src/components/MapWrapper.tsx