How teamdenkwerk/nivara works
NIVARA is a disaster-management decision-support platform that turns multi-hazard and population-risk information into evacuation priorities, relocation options, capacity checks, and authority actions. Its user workflow spans hazard intelligence, priority evacuation, safe-site selection, capacity assessment, and operational response; the README also identifies GIS, simulation, reports, voice alerts, and explainable AI as product capabilities. The graph combines those documented capabilities with sampled API, engine, and UI evidence; unsampled feature wiring is represented only where the README documents the workflow.
Main entry points: App.tsx Web application · v2_routes.py Risk and alert routes · HazardCommandCenter.tsx Hazard command · endpoints.py REST API
Components 30
Users & interface
- Web application
frontend/src/App.tsx - Hazard command
frontend/src/pages/HazardCommandCenter.tsx - Evacuation queue
frontend/src/pages/PriorityQueue.tsx - Relocation planner
frontend/src/pages/RelocationEngine.tsx - Capacity assessment
frontend/src/pages/CarryingCapacity.tsx - Authority action
frontend/src/pages/AuthorityAction.tsx - Scenario simulator
frontend/src/pages/WhatIfSimulation.tsx - Situation reports
frontend/src/pages/ProjectReport.tsx - GIS map views
frontend/src/components/map/MapComponent.tsx
Hazard intelligence
- REST API
backend/app/api/endpoints.py - Risk and alert routes
backend/app/routes/v2_routes.py - Hazard engines
backend/app/engines - Catchment hydrology
backend/app/engines/catchment_engine.py - Runout cascades
backend/app/engines/runout_engine.py - Bayesian risk
ml/prediction/bayesian_risk_inference.py - XGBoost risk
ml/training/train_xgboost.py - Hazard modules
modules - Model trust gate
backend/models/maturity_engine.py
Relocation decisions
- Site and hazard registries
frontend/src/data/areaHazardProfiles.ts - Capacity calculator
frontend/src/utils/capacityCalculator.ts
Response & assistance
- Alert lifecycle
backend/app/services/alert_service.py - Voice notifications
backend/app/services/voice_service.py - SMS provider
backend/app/notifications/sms_provider.py - AI assistance
backend/app/services/gemini_service.py
Data & integrations
- Risk context
backend/app/services/risk_context_service.py - Terrain data
backend/models/dem_engine.py - Weather service
frontend/src/services/weatherService.ts
Other components
- Emergency authorities
- Twilio
- Gemini service
Connections 37
- Emergency authorities → Web application: uses
- Web application → Hazard command: presents
- Web application → Evacuation queue: presents
- Web application → Relocation planner: presents
- Web application → Capacity assessment: presents
- Web application → Authority action: presents
- Web application → Scenario simulator: presents
- Web application → Situation reports: presents
- Web application → GIS map views: presents
- Hazard command → REST API: requests intelligence
- REST API → Risk and alert routes: dispatches routes
- Risk and alert routes → Catchment hydrology: queries catchments
- Risk and alert routes → Runout cascades: queries corridors
- Risk and alert routes → Model trust gate: evaluates trust
- Risk and alert routes → Risk context: loads context
- Risk and alert routes → Bayesian risk: uses inference
- Risk and alert routes → XGBoost risk: uses model
- Catchment hydrology → Terrain data: uses terrain
- Hazard modules → REST API: expose hazard data
- Hazard command → Evacuation queue: informs priority
- Evacuation queue → Relocation planner: sets evacuation need
- Relocation planner → Site and hazard registries: reads site profiles
- Relocation planner → Capacity calculator: calculates capacity
- Relocation planner → Capacity assessment: opens capacity review
- Capacity assessment → Authority action: informs action
- Authority action → REST API: requests response
- REST API → Alert lifecycle: dispatches alert actions
- Alert lifecycle → Voice notifications: initiates voice call
- Voice notifications → Twilio: calls provider
- Alert lifecycle → SMS provider: sends SMS
- Model trust gate → Alert lifecycle: gates dispatch
- Scenario simulator → Hazard command: explores scenarios
- Situation reports → Emergency authorities: delivers reports
- AI assistance → Gemini service: calls model
- Hazard command → AI assistance: requests assistance
- Hazard command → Weather service: requests weather
- GIS map views → REST API: requests map data