AI-Powered Multi-Source Ocean & Coastal Disaster Intelligence, Verification, Risk Assessment, and Last-Mile Action Platform
๐ Interactive Live Architecture Diagram โข ๐ GitHub Repository โข ๐ Render Ready
"From scattered signals to trusted decisions."
- Problem Statement ID:
SIH25039 - Title: Integrated Platform for Crowdsourced Ocean Hazard Reporting and Social Media Analytics
- Nodal Ministry / Organization: Ministry of Earth Sciences (MoES)
- Category: Software | Theme: Disaster Management
India features a 7,516 km coastline inhabited by over 250 million citizens, major commercial ports, and vulnerable coastal fishing villages. During tropical cyclones, extreme swell surges (Kallakkadal), and tsunami threats across the Bay of Bengal and Arabian Sea, emergency managers face three severe systemic challenges:
- Fragmented Data Silos: MoES/IMD weather bulletins, INCOIS ocean wave buoys, ISRO MOSDAC INSAT-3DR satellite imagery, and citizen eyewitnesses operate in isolated silos.
- Noise and Rumor Bottlenecks: Social media chatter contains massive misinformation, lack actionable GPS coordinates, and flood authorities with unverified reports.
- Black-Box AI Decision Traps: Opaque machine learning algorithms deliver raw numbers without explaining why an evacuation is mandatory, which roads are impassable, or which shelters are safe.
RESQNET AI solves this through an end-to-end, explainable, and multi-source intelligence engine built on an 8-Stage Operational Disaster Lifecycle:
Every decision is corroborated by independent physical evidence, bounded by epistemic humility (max 98% confidence), decomposed through TreeSHAP explainability, and translated into A* hazard-avoiding evacuation routes and zero-cost Cell Broadcast (CBS) alerts.
Explore the live, interactive vector nodes, zoomable tiers, and operational data flows at:
๐ https://resqnetai-arch.netlify.app/
flowchart TB
%% Styling Classes
classDef clientTier fill:#0b192e,stroke:#38bdf8,stroke-width:2px,color:#f8fafc;
classDef gatewayTier fill:#0f172a,stroke:#818cf8,stroke-width:2px,color:#f8fafc;
classDef coreTier fill:#022c22,stroke:#34d399,stroke-width:2px,color:#f8fafc;
classDef mlTier fill:#1e1b4b,stroke:#a855f7,stroke-width:2px,color:#f8fafc;
classDef dataTier fill:#1e293b,stroke:#06b6d4,stroke-width:2px,color:#f8fafc;
classDef dispatchTier fill:#2e1065,stroke:#f43f5e,stroke-width:2px,color:#f8fafc;
%% Subgraphs
subgraph S1 ["1. Client Edge & Operational Consoles"]
HUD["๐ฅ๏ธ Tactical Command HUD<br/><i>React 18 / Liquid Glass UI / 6-KPI Bar</i>"]:::clientTier
GIS["๐บ๏ธ Fullscreen GIS Live Map<br/><i>Leaflet / Isolated Stacking / GPS Panning</i>"]:::clientTier
PWA["๐ฑ Citizen SOS & Field PWA<br/><i>Offline-First / Service Worker / GPS Triage</i>"]:::clientTier
SATMODAL["๐ฐ๏ธ INSAT-3D Live Viewer<br/><i>Real-time Satellite Feed (No API Key)</i>"]:::clientTier
end
subgraph S2 ["2. Security & API Gateway Layer"]
AUTH["๐ Role-Based Access Control (RBAC)<br/><i>JWT Scopes: Authority, Citizen, Responder, Analyst</i>"]:::gatewayTier
API["โก FastAPI Async Core Gateway<br/><i>REST API / Static Distribution :8000</i>"]:::gatewayTier
WS["๐ก WebSocket Real-time Feed<br/><i>WSS /ws/live-feed Telemetry Gateway</i>"]:::gatewayTier
end
subgraph S3 ["3. ResQNet AI Analytical Subsystems"]
NLP["๐ง Multilingual NLP Distress Parser<br/><i>English, Hindi, Hinglish Extraction & Urgency</i>"]:::mlTier
VISION["๐๏ธ Vision Damage Inspector<br/><i>Water Intrusion, Breaches & Infrastructure Triage</i>"]:::mlTier
FUSION["๐ฏ Bayesian Multi-Source Evidence Fusion<br/><i>Cross-Corroboration Matrix & Contradiction Penalty</i>"]:::mlTier
XAI["๐ Explainable AI Engine (TreeSHAP)<br/><i>Physical Factor Attribution & Plain Summaries</i>"]:::mlTier
ROUTER["๐งญ A* Safer Evacuation Pathfinder<br/><i>Hazard Perimeter Avoidance & Shelter Routing</i>"]:::mlTier
end
subgraph S4 ["4. Multi-Source Ingestion & Physical Telemetry"]
IMD["๐ก IMD Coastal Observatories<br/><i>Coastal Bulletins, 7-Day Forecasts, Port Signals</i>"]:::dataTier
INCOIS["๐ INCOIS Ocean Buoys & QuikSCAT<br/><i>Wave Buoy BOB-04 & Wind Stress Curl Grid</i>"]:::dataTier
MOSDAC["๐ฐ๏ธ ISRO MOSDAC & INSAT-3DR<br/><i>Quantitative Precipitation (QPE)</i>"]:::dataTier
SAR["๐ฐ๏ธ Copernicus Sentinel-1 SAR<br/><i>Radar Inundation Water Surface Masks</i>"]:::dataTier
OSM["๐บ๏ธ OpenStreetMap & GEBCO<br/><i>Road Network Topology & Coastal Elevation</i>"]:::dataTier
CITIZEN["๐ฅ Crowdsourced Citizen Reports<br/><i>Geotagged Photos & Field Incident Feed</i>"]:::dataTier
SOCIAL["๐ Social Streams & GDELT<br/><i>Early Warning Hazard Keywords & News</i>"]:::dataTier
end
subgraph S5 ["5. State Persistence & Last-Mile Dispatch"]
STORE[("๐๏ธ In-Memory / SQLite Geo-Store<br/><i>Spatial Indexing / PostGIS-Ready Schemas</i>")]:::coreTier
CBS["๐ข Cell Broadcast (CBS) Relay<br/><i>Zero-Cost Public Disaster SMS & Relays</i>"]:::dispatchTier
end
%% Ingestion to Gateway & Core
IMD --> API
INCOIS --> API
MOSDAC --> API
SAR --> API
OSM --> API
CITIZEN --> API
SOCIAL --> API
%% Client Interactions
HUD <-->|"WSS /ws/live-feed"| WS
GIS <-->|"GeoJSON Hazards & Layers"| API
PWA <-->|"HTTPS SOS & Reports"| API
SATMODAL <-->|"INSAT-3D Frame Cache"| API
%% Internal Processing Flow
API -. "Validate Scope" .-> AUTH
API --> STORE
API --> NLP
API --> VISION
API --> FUSION
NLP -->|"Distress Evidence"| FUSION
VISION -->|"Visual Evidence"| FUSION
STORE -->|"Sensor Readings"| FUSION
FUSION -->|"Consensus Risk Score"| XAI
XAI -->|"Risk Surface & Penalties"| ROUTER
STORE -->|"Road Graphs & Shelters"| ROUTER
ROUTER -->|"Evacuation Path"| PWA
ROUTER -->|"Evacuation Corridor"| CBS
ROUTER -->|"Tactical Route Overlay"| GIS
CBS -. "Public Alert Warning" .-> PWA
[1. SENSE] Continuous telemetry ingestion across 7 physical & social channels.
โ
[2. EXTRACT] Multilingual NLP parses Hindi, Hinglish, & English reports for victim counts & urgency.
โ
[3. VERIFY] Vision model verifies floodwaters; Bayesian cross-corroboration validates ground truth.
โ
[4. PREDICT] Ensemble risk model forecasts inundation depth, storm surge anomaly, and wind stress curl.
โ
[5. SIMULATE] Parametric stress-testing evaluates surge escalation (+0.5m to +3.5m) in real-time.
โ
[6. DECIDE] TreeSHAP identifies primary hazard drivers (wave surge vs rain vs tide) with 0-98% confidence.
โ
[7. ACT] A* pathfinder charts safer inland corridors to cyclone shelters; triggers zero-cost CBS SMS.
โ
[8. LEARN] Post-incident metrics record verification accuracy, response latency, and model feedback.
-
Methodology: Weights independent evidence streams by sensor reliability coefficients:
$$\text{Official IMD/INCOIS (0.95)} > \text{Ocean Buoy (0.90)} > \text{Satellite SAR (0.85)} > \text{Citizen Report (0.65)} > \text{News/GDELT (0.60)} > \text{Social Media (0.45)}$$ - Contradiction Penalty: Automatically dampens overall risk confidence if coastal buoys and inland sensors register opposing trends.
- Epistemic Humility: Confidence is rigorously capped at 98% to acknowledge physical sensor uncertainty during extreme meteorological events.
- Decomposes every composite risk score into exact physical contributing factors:
-
Wave Surge Height:
$+32%$ -
Sustained Wind Velocity:
$+24%$ -
Low Coastal Elevation:
$+20%$ -
Precipitation Influx:
$+16%$ -
Ground Citizen Eyewitnesses:
$+8%$
-
Wave Surge Height:
- Generates plain-language operational summaries customized for Incident Commanders, Field Responders, and Civilians.
- Dynamic graph pathfinding engine ingesting active flood polygons, submerged coastal highways, and real-time shelter bed counts.
- Dynamically routes civilians around blocked coastal arteries (e.g. Puri Marine Drive) toward the nearest designated cyclone shelter with verified capacity.
- Generates one-click copyable SMS / WhatsApp text directions for zero-connectivity field dispatch.
- Extracts disaster types, casualty counts, urgency ratings (1-5), and local landmarks.
- Supports native English, Hindi (Devanagari:
เคชเคพเคจเฅ เคญเคฐ เคเคฏเคพ,เคฎเคฆเคฆ เคเคพเคนเคฟเค), and Hinglish (pani road pe aa gaya hai).
- Classifies user-uploaded photos and satellite backscatter into structural damage levels (
MINOR,MODERATE,SEVERE,CRITICAL). - Instant client-side preview on report submission with automatic object and water intrusion detection.
- Built with React 18, Vite, and Tailwind CSS using an Aqua/Oceanic Liquid Glass design system.
- High-contrast night-vision UI tailored for Emergency Operations Centers (EOC).
- Real-time 6-KPI operations bar tracking Active Hazards, Critical Warnings, Available Shelter Beds, Exposed Population, Verification Latency (1.4s), and Consensus Confidence.
ResQnet AI/
โโโ backend/ # FastAPI REST API & WebSocket Engine
โ โโโ __init__.py # Backend core package
โ โโโ app.py # Application factory, CORS, SPA fallback & WSS gateway
โ โโโ config.py # Pydantic v2 Settings, environment configuration
โ โโโ database/ # Data layer & schema models
โ โ โโโ __init__.py # Database package init
โ โ โโโ schemas.py # Pydantic request/response schemas & Enums
โ โ โโโ store.py # In-memory Geo-Spatial DataStore & seed loader
โ โโโ routers/ # Modular API route controllers
โ โโโ __init__.py # Router package exports
โ โโโ alerts.py # Official IMD vs AI vs Crowdsourced alert feeds
โ โโโ auth.py # JWT Authentication & role demo credentials
โ โโโ evidence.py # Bayesian multi-source evidence fusion API
โ โโโ hazards.py # Active hazard polygons & INCOIS wind stress
โ โโโ reports.py # Crowdsourced report ingest & verification
โ โโโ risk.py # SHAP XAI risk assessment & role action engine
โ โโโ routes.py # A* hazard-avoidance safer route generation
โ โโโ shelters.py # Shelter inventory, capacity, and coordinates
โ โโโ simulation.py # Parametric scenario simulator & pipeline
โ โโโ system.py # Health probes, KPI analytics & CBS alerts
โโโ data/ # Validated oceanographic datasets
โ โโโ pilot_puri.json # Comprehensive pilot baseline for Puri Coastal Zone
โ โโโ incois_coastal_stations_clean.json # Cleaned INCOIS coastal station index
โ โโโ incois_coastal_winds_clean.csv # INCOIS surface wind time-series
โ โโโ incois_ocean_wind_grid.json # 200+ spatial wind vectors across Indian waters
โ โโโ incois_quickscat_daily_*.nc # Raw NetCDF QuikSCAT scatterometer dataset
โโโ docker/
โ โโโ Dockerfile.backend # Production container build specification
โโโ docs/ # Technical documentation & guides
โ โโโ CODEBASE_DOCUMENTATION.md # Complete codebase reference guide
โ โโโ WINDOWS_SETUP_GUIDE.md # Windows setup, execution & troubleshooting
โ โโโ diagrams/
โ โโโ index.html # Standalone interactive vector diagram (Netlify)
โ โโโ candidate.json # Node/edge vector graph coordinates
โโโ frontend/ # React 18 + TypeScript + Vite Web Application
โ โโโ public/ # PWA manifest, service worker (sw.js), icons
โ โโโ src/
โ โ โโโ App.tsx # Root application layout, offline watcher & routes
โ โ โโโ main.tsx # React DOM entrypoint
โ โ โโโ index.css # Aqua Liquid-Glass design system & Tailwind
โ โ โโโ components/ # Reusable UI component modules
โ โ โ โโโ common/ # Badges, Skeletons, Role guidance banner
โ โ โ โโโ evidence/ # EvidencePanel (Bayesian matrix table)
โ โ โ โโโ hero/ # HeroGlobeVisual (interactive 3D globe)
โ โ โ โโโ layout/ # Navbar, Footer, AuroraBackground
โ โ โ โโโ map/ # DisasterMap (Leaflet), MapLayers, MapLegend
โ โ โ โโโ ocean/ # OceanCard, WindStressCard (INCOIS QuikSCAT)
โ โ โ โโโ reports/ # CitizenReportForm (AI pre-check), ReportCard
โ โ โ โโโ risk/ # RiskCard, XAIPanel, RiskBreakdown, AnalyticsChart
โ โ โ โโโ routes/ # SaferRouteCard (A* pathfinding UI)
โ โ โ โโโ search/ # LocationSearch, SearchModal (20+ Indian ports)
โ โ โ โโโ simulation/ # ScenarioSimulator (sliders), PipelineModal
โ โ โ โโโ weather/ # WeatherCard, CityForecastCard, SatelliteModal
โ โ โโโ pages/ # Top-level view controllers
โ โ โ โโโ LandingPage.tsx # Hero showcase & executive overview
โ โ โ โโโ LocationIntelligencePage.tsx # Deep-dive for 20+ coastal ports
โ โ โ โโโ LiveMapPage.tsx # Fullscreen tactical GIS command map
โ โ โ โโโ CommandCenterPage.tsx # Authority/NDRF 6-KPI operations console
โ โ โ โโโ CitizenReportingPage.tsx # Crowdsourced report feed & submission
โ โ โ โโโ SimulationPage.tsx # Parametric crisis stress-testing studio
โ โ โ โโโ AlertsPage.tsx # Unified Official vs AI vs Citizen alerts
โ โ โ โโโ NotFoundPage.tsx # 404 handler
โ โ โโโ services/ # Typed API client services
โ โ โโโ types/ # TypeScript interfaces (disaster, imd, risk, route)
โ โโโ package.json # Frontend dependencies & build scripts
โ โโโ tailwind.config.js # Custom Liquid Glass theme, glow shadows & hues
โ โโโ vite.config.ts # Proxy rules, vendor chunking & build settings
โโโ ingestion/ # Multi-source data providers & connectors
โ โโโ base.py # Abstract BaseProvider with fetch/normalize/health
โ โโโ providers/ # Specialized agency adapters
โ โโโ copernicus.py # Sentinel-1 SAR water inundation provider
โ โโโ gdelt.py # Global news intelligence provider
โ โโโ imd.py # IMD Coastal Bulletin & 7-Day City Forecast
โ โโโ incois.py # INCOIS Buoy (BOB-04) & ocean state provider
โ โโโ incois_wind.py # INCOIS QuikSCAT Scatterometer surface wind provider
โ โโโ mosdac.py # ISRO MOSDAC INSAT-3DR QPE satellite provider
โ โโโ osm.py # OpenStreetMap road topology & GEBCO elevation
โ โโโ social.py # Public social media hazard signal provider
โโโ ml/ # Machine Learning & Analytical Subsystems
โ โโโ evaluation/metrics.py # Precision, Recall, F1, and MAE benchmarks
โ โโโ explainability/xai_engine.py# TreeSHAP feature attribution & local rationale
โ โโโ fusion/evidence_fusion.py # Multi-source Bayesian consensus matrix
โ โโโ nlp/multilingual_parser.py # Regex & transformer zero-shot distress parser
โ โโโ risk/risk_model.py # Interpretable physical-bounds risk ensemble
โ โโโ routing/safe_route_engine.py# Dynamic A* hazard-avoidance pathfinder
โ โโโ vision/damage_inspector.py # Computer vision photo damage triage
โโโ scripts/
โ โโโ clean_incois_dataset.py # Parser for raw INCOIS NetCDF ocean wind data
โโโ tests/ # Automated test suite (pytest)
โ โโโ test_api.py # FastAPI route & schema validation tests
โ โโโ test_fusion.py # Evidence fusion math & contradiction tests
โ โโโ test_nlp.py # Multilingual NLP accuracy & entity tests
โ โโโ test_routing.py # A* hazard perimeter avoidance tests
โโโ .env.example # Template environment variables
โโโ .gitignore # Git exclusion rules
โโโ docker-compose.yml # Multi-container orchestration definition
โโโ render.yaml # 1-Click Render Cloud deployment blueprint
โโโ requirements.txt # Python backend dependencies
โโโ run.py # Unified single-command launcher script
- Python: Version
3.10,3.11, or3.12installed. - Node.js: Version
18+andnpminstalled. - Git: Installed.
git clone https://github.com/codeCraft-Ritik/ResQnet-AI.git
cd ResQnet-AI# Windows (PowerShell)
python -m venv venv
.\venv\Scripts\Activate.ps1
# Linux / macOS
python3 -m venv venv
source venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Copy environment configuration
cp .env.example .envcd frontend
npm install
npm run build
cd ..(Building compiles the frontend into frontend/dist. The FastAPI server serves the web application and API on a single unified port).
python run.pyThe system will start and provide instant access:
- ๐ Tactical Command Center Web App: http://localhost:8000/
- ๐ Interactive Swagger / OpenAPI Documentation: http://localhost:8000/docs
- ๐งญ Alternative Redoc API Explorer: http://localhost:8000/redoc
- ๐ก Live WebSocket Telemetry Gateway:
ws://localhost:8000/ws/live-feed
To develop with instant Vite hot-module replacement (HMR):
- Terminal 1 (Backend):
python run.py
- Terminal 2 (Frontend Dev Server):
cd frontend npm run dev - Open http://localhost:5173/. Vite is pre-configured to proxy all
/api/*and/ws/*calls to FastAPI on127.0.0.1:8000.
The repository includes a ready-to-deploy render.yaml specification:
- Push your repository to GitHub.
- In Render Dashboard, click New + โ Blueprint (or Web Service).
- Select your repository.
- Render will configure everything automatically:
- Environment:
Python - Build Command:
pip install -r requirements.txt && cd frontend && npm install && npm run build && cd .. - Start Command:
python run.py - Health Check Path:
/api/health
- Environment:
| Category | Method | Endpoint | Description |
|---|---|---|---|
| System | GET |
/api/health |
Root health check and operational mode status. |
| System | GET |
/api/v1/system/health |
Live availability check for all 7 ingestion providers. |
| System | GET |
/api/v1/system/analytics |
District-level operational KPI summary. |
| System | POST |
/api/v1/system/dispatch-alert |
Zero-cost Cell Broadcast (CBS) emergency alert trigger. |
| Hazards | GET |
/api/v1/hazards |
Active hazard polygons (supports ?location= filtering). |
| Hazards | GET |
/api/v1/hazards/incois/wind-stress |
INCOIS QuikSCAT scatterometer wind stress & curl. |
| Hazards | GET |
/api/v1/hazards/imd/coastal-bulletin |
Official IMD coastal bulletin text and warnings. |
| Hazards | GET |
/api/v1/hazards/imd/city-forecast |
Official IMD 7-day city weather forecast. |
| Reports | GET |
/api/v1/reports |
List crowdsourced citizen reports with status filters. |
| Reports | POST |
/api/v1/reports |
Submit a citizen report with automatic AI verification. |
| Reports | POST |
/api/v1/reports/analyze-preview |
Real-time multilingual NLP and photo damage pre-check. |
| Evidence | GET |
/api/v1/evidence/{hazard_id} |
Complete Bayesian evidence matrix & confidence breakdown. |
| Risk | GET |
/api/v1/risk/assess |
SHAP-style factor attribution decomposition. |
| Risk | GET |
/api/v1/risk/role-action |
Safety-first action directives by user role. |
| Routes | POST |
/api/v1/routes/safer |
Dynamic A* hazard-avoidance shelter pathfinding. |
| Shelters | GET |
/api/v1/shelters |
Relief shelter capacities and operational status. |
| Simulation | POST |
/api/v1/simulation/run |
Parametric surge crisis stress-testing. |
| Simulation | POST |
/api/v1/simulation/execute-pipeline-demo |
Automated 8-stage disaster response lifecycle demo. |
The platform provides tailored interfaces and permission scopes for four operational profiles:
| Role | Target User | Interface & Permissions |
|---|---|---|
Authority (AUTHORITY) |
NDRF, ODRAF, District Magistrates | Full Command Center HUD, 6-KPI metrics, CBS dispatch trigger, shelter activation. |
Citizen (CITIZEN) |
Coastal Residents, Fisherfolk | Offline-ready SOS, crowdsourced reporting form, nearest shelter route guidance. |
Responder (RESPONDER) |
Field Rescue Battalions, Coast Guard | Tactical hazard perimeters, vehicle impassability overlays, live report triage. |
Analyst (ANALYST) |
Ocean Modelers, Meteorologists | Raw INCOIS QuikSCAT scatterometer data, SHAP waterfall charts, simulation studio. |
Quick test demo accounts (Password: password123):
authority@resqnet.gov.incitizen@resqnet.gov.inresponder@resqnet.gov.inanalyst@resqnet.gov.in
The codebase includes comprehensive unit and integration tests covering API schemas, Bayesian math, NLP parsing, and A* pathfinding:
# Run pytest test suite
python -m pytesttests\test_api.py .............. [ 70%]
tests\test_fusion.py .. [ 80%]
tests\test_nlp.py ... [ 95%]
tests\test_routing.py . [100%]
============================== 20 passed in 0.48s ==============================
# Verify frontend production build
cd frontend
npm run buildโ 2772 modules transformed.
dist/index.html 1.90 kB โ gzip: 0.82 kB
dist/assets/index-OS29SHxK.css 75.38 kB โ gzip: 17.12 kB
dist/assets/index-C0anW72h.js 231.64 kB โ gzip: 53.52 kB
โ built in 5.37s
- Strict Data Lineage: Official Government Warnings (IMD/INCOIS) are displayed with statutory precedence. Automated machine outputs are explicitly badged as "AI Risk Assessment โ Predictive Intelligence" to prevent public confusion.
- Epistemic Humility: AI confidence scores are capped at 98% to prevent over-reliance on automated models during extreme meteorological anomalies.
- No False Safety Guarantees: Evacuation paths avoid known flooded polygons but provide explicit disclaimers directing citizens to obey local law enforcement sirens.
- Privacy Protection: Public crowdsourced feeds omit personal citizen phone numbers and blur sensitive residential coordinates.
This project is licensed under the terms of the MIT License. See LICENSE for details.
Built with pride for coastal community resilience & disaster safety across India.
Developed for Smart India Hackathon (SIH 2025) โข Ministry of Earth Sciences (MoES)