How omsudhamsh/disaster-grid works
Disaster Grid turns responder-facing reports and live crisis signals into a geographically constrained operational picture and response actions. Responders enter through authenticated web pages, inspect incidents, crisis intelligence, sensor risk, imagery analyses, and fused priorities, then coordinate resources or dispatches. Backend routes own requests to domain services; ingestion, analysis, prioritization, and operational coordination are distinct stages. The graph also includes the shared India-boundary logic and the frontend API client. Some feature links rely on README documentation because their page or service implementations were not sampled.
Main entry points: App.jsx Auth and routes · main.py FastAPI app · api.js REST client · live_incidents.py Live incidents
Components 34
Responder application
- Auth and routes
frontend/src/App.jsx - Command center
frontend/src/pages/Dashboard.jsx - Incident workspace
frontend/src/pages/Incidents.jsx - Crisis intelligence
frontend/src/pages/CrisisIntelligence.jsx - Imagery analysis
frontend/src/pages/Imagery.jsx - Sensor network
frontend/src/pages/Sensors.jsx - Priority grid
frontend/src/pages/Fusion.jsx - Resource allocation
frontend/src/pages/Resources.jsx - Operational map
frontend/src/components/DisasterMap.jsx - REST client
frontend/src/services/api.js
API request layer
- FastAPI app
backend/main.py - Incident routes
backend/routes/incidents.py - Crisis routes
backend/routes/crisis.py - Fusion routes
backend/routes/fusion.py - Imagery routes
backend/routes/imagery.py - Sensor routes
backend/routes/sensors.py - Resource routes
backend/routes/resources.py - Dispatch routes
backend/routes/dispatch.py
Signal intelligence
- Report NLP
backend/services/nlp.py - Social feed
backend/services/social.py - Live incidents
backend/services/live_incidents.py - Live sensor feeds
backend/services/sensors.py - Image vision
backend/services/vision.py - NASA imagery
backend/services/nasa.py - Priority fusion
backend/services/fusion.py - Priority explanations
backend/services/explanation.py
Response operations
- Dispatch coordination
backend/services/dispatch.py - Location safety
backend/services/safety.py
Geospatial foundation
- India geospatial checks
backend/services/geo.py - Map boundaries
frontend/src/utils/geo.js - Hexbin geometry
frontend/src/utils/hexbin.js
Other components
- Responder
- External crisis feeds
- Gemini Vision
Connections 45
- Responder → Auth and routes: opens
- Auth and routes → Command center: routes to
frontend/src/App.jsx - Auth and routes → Incident workspace: routes to
frontend/src/App.jsx - Auth and routes → Crisis intelligence: routes to
frontend/src/App.jsx - Auth and routes → Imagery analysis: routes to
frontend/src/App.jsx - Auth and routes → Sensor network: routes to
frontend/src/App.jsx - Auth and routes → Priority grid: routes to
frontend/src/App.jsx - Auth and routes → Resource allocation: routes to
frontend/src/App.jsx - Incident workspace → REST client: uses
frontend/src/pages/Incidents.jsx - Incident workspace → REST client: uses
frontend/src/pages/Incidents.jsx - Imagery analysis → REST client: uses
frontend/src/pages/Imagery.jsx - Priority grid → REST client: uses
frontend/src/pages/Fusion.jsx - REST client → FastAPI app: REST requests
- FastAPI app → Incident routes: registers
backend/main.py - FastAPI app → Crisis routes: registers
backend/main.py - FastAPI app → Fusion routes: registers
backend/main.py - FastAPI app → Imagery routes: registers
backend/main.py - FastAPI app → Sensor routes: registers
backend/main.py - FastAPI app → Resource routes: registers
backend/main.py - FastAPI app → Dispatch routes: registers
backend/main.py - Crisis routes → Report NLP: analyzes reports
backend/routes/crisis.py - Crisis routes → Social feed: loads feed
backend/routes/crisis.py - Social feed → Report NLP: checks locations
backend/services/social.py - Fusion routes → Report NLP: uses analysis
backend/routes/fusion.py - Fusion routes → Live incidents: loads incidents
backend/routes/fusion.py - Fusion routes → Priority fusion: scores signals
backend/routes/fusion.py - Priority fusion → Priority explanations: generates explanations
- Incident routes → Report NLP: analyzes reports
backend/routes/incidents.py - Incident routes → Live incidents: reads and reports
backend/routes/incidents.py - Sensor routes → Live sensor feeds: loads feeds
backend/routes/sensors.py - Resource routes → Live incidents: reads incidents
backend/routes/resources.py - Dispatch routes → Dispatch coordination: delegates
backend/routes/dispatch.py - Imagery routes → NASA imagery: fetches imagery
backend/routes/imagery.py - Imagery routes → Image vision: analyzes images
backend/routes/imagery.py - Imagery analysis → Gemini Vision: analysis capability
- External crisis feeds → Social feed: supplies posts
- External crisis feeds → Live incidents: supplies events
- External crisis feeds → Live sensor feeds: supplies telemetry
- Live incidents → India geospatial checks: filters locations
backend/services/live_incidents.py - NASA imagery → India geospatial checks: checks locations
backend/services/nasa.py - Map boundaries → Operational map: constrains map
frontend/src/components/DisasterMap.jsx - Hexbin geometry → Operational map: bins hotspots
frontend/src/components/DisasterMap.jsx - India geospatial checks → Location safety: supports checks
- Operational map → Command center: shows operational picture
- Resource allocation → Dispatch routes: coordinates deployments