# ojaswijoshi13/rakshakgis architecture

> Architecture diagram of the GitHub repository ojaswijoshi13/rakshakgis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ojaswijoshi13/rakshakgis
- Repository: https://github.com/ojaswijoshi13/rakshakgis

## Overview

RakshakGIS is a disaster-risk decision platform for authorities: operational users inspect village and GIS data, assess multi-hazard risk and red zones, then plan and review relocation, with scenario simulation supporting what-if analysis. The frontend presents GIS and operational workflows; the FastAPI backend exposes them alongside risk, relocation, ingestion, telemetry, and governance capabilities. The README documents the REST/GeoJSON boundary and data modes. Some subsystem routes and runtime wiring are unsampled, so those links are omitted or marked unverified rather than inferred from filenames.

Main entry points: [`backend/app/core/scenarios/engine.py`](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/scenarios/engine.py) (Scenario Simulator), [`backend/app/api/routes.py`](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/routes.py) (REST API), [`backend/app/core/risk/computation/engine.py`](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/computation/engine.py) (Risk Computation), [`backend/app/api/v1/risk.py`](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/risk.py) (Risk and Red Zones)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User Workbench"]
  node_gis_ui["GIS Explorer<br/>[page.tsx]"]
  node_village_ui["Village Profile<br/>[page.tsx]"]
  node_ops_ui["Operations Console"]
end

subgraph group_api["API and Operations"]
  node_api_app["REST API<br/>[routes.py]"]
  node_risk_api["Risk and Red Zones<br/>[risk.py]"]
  node_reloc_api["Relocation Services<br/>[relocation.py]"]
  node_scenario_api["Scenario Services<br/>[scenarios.py]"]
  node_governance_api["Governance Workflows<br/>[governance.py]"]
  node_reports["Reports<br/>[reports.py]"]
end

subgraph group_risk["Risk Intelligence"]
  node_risk_calc["Risk Computation<br/>[engine.py]"]
  node_risk_class["Risk Classification<br/>[engine.py]"]
  node_vulnerability["Vulnerability Scoring<br/>[engine.py]"]
  node_redzone["Red Zone Analysis<br/>[engine.py]"]
  node_dynamic_redzone["Dynamic Red Zones<br/>[dynamic_engine.py]"]
  node_priority["Relocation Priority<br/>[engine.py]"]
end

subgraph group_relocation["Relocation Planning"]
  node_suitability["Site Suitability<br/>[engine.py]"]
  node_capacity["Site Capacity<br/>[engine.py]"]
  node_matching["Relocation Matching<br/>[engine.py]"]
  node_routing["Evacuation Routing<br/>[engine.py]"]
  node_scenario["Scenario Simulator<br/>[engine.py]"]
end

subgraph group_data["Data and Configuration"]
  node_profiles["Regional Profiles<br/>[models.py]"]
  node_providers["Hazard Providers<br/>[contracts.py]"]
  node_ingestion["Data Ingestion<br/>[pipeline.py]"]
  node_spatial_db[("Spatial Database<br/>[database.py]")]
  node_telemetry["Live Telemetry<br/>[service.py]"]
end

node_officer(("Disaster Officer"))

node_officer -->|"explores map"| node_gis_ui
node_officer -->|"reviews villages"| node_village_ui
node_officer -->|"manages operations"| node_ops_ui
node_gis_ui -->|"requests REST/GeoJSON"| node_api_app
node_village_ui -->|"requests REST/GeoJSON"| node_api_app
node_ops_ui -.->|"uses REST"| node_api_app
node_api_app -.->|"routes requests"| node_risk_api
node_api_app -.->|"routes requests"| node_reloc_api
node_api_app -.->|"routes requests"| node_scenario_api
node_risk_api -.->|"invokes"| node_risk_calc
node_risk_calc -->|"classifies result"| node_risk_class
node_risk_calc -.->|"uses factor scores"| node_vulnerability
node_risk_api -.->|"invokes"| node_redzone
node_risk_api -.->|"invokes"| node_dynamic_redzone
node_risk_api -.->|"invokes"| node_priority
node_reloc_api -.->|"invokes"| node_matching
node_matching -->|"evaluates sites"| node_suitability
node_matching -->|"checks capacity"| node_capacity
node_scenario_api -.->|"invokes"| node_scenario
node_scenario -->|"computes risk"| node_risk_calc
node_scenario -->|"evaluates zones"| node_dynamic_redzone
node_scenario -->|"scores priority"| node_priority
node_scenario -->|"assesses sites"| node_suitability
node_scenario -->|"sizes capacity"| node_capacity
node_scenario -->|"assigns sites"| node_matching
node_scenario -.->|"plans routes"| node_routing
node_risk_calc -->|"loads configuration"| node_profiles
node_providers -->|"supplies observations"| node_risk_calc
node_ingestion -.->|"loads datasets"| node_spatial_db
node_telemetry -.->|"uses provider data"| node_providers
node_governance_api -.->|"persists decisions"| node_spatial_db
node_api_app -.->|"serves reports"| node_reports

click node_gis_ui "https://github.com/ojaswijoshi13/rakshakgis/blob/main/frontend/src/app/gis/page.tsx"
click node_village_ui "https://github.com/ojaswijoshi13/rakshakgis/blob/main/frontend/src/app/villages/page.tsx"
click node_ops_ui "https://github.com/ojaswijoshi13/rakshakgis/tree/main/frontend/src/app/operations"
click node_api_app "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/routes.py"
click node_risk_api "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/risk.py"
click node_reloc_api "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/relocation.py"
click node_scenario_api "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/scenarios.py"
click node_governance_api "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/governance.py"
click node_risk_calc "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/computation/engine.py"
click node_risk_class "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/classification/engine.py"
click node_vulnerability "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/vulnerability/engine.py"
click node_redzone "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/red_zone/engine.py"
click node_dynamic_redzone "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/red_zone/dynamic_engine.py"
click node_priority "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/relocation_priority/engine.py"
click node_suitability "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/relocation/suitability/engine.py"
click node_capacity "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/relocation/capacity/engine.py"
click node_matching "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/relocation/matching/engine.py"
click node_routing "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/relocation/routing/engine.py"
click node_scenario "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/scenarios/engine.py"
click node_profiles "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/profiles/models.py"
click node_providers "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/data/providers/contracts.py"
click node_ingestion "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/data/ingestion/pipeline.py"
click node_spatial_db "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/database.py"
click node_telemetry "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/telemetry/service.py"
click node_reports "https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/reports.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gis_ui,node_village_ui,node_ops_ui toneBlue
class node_api_app,node_risk_api,node_reloc_api,node_scenario_api,node_governance_api,node_reports toneAmber
class node_risk_calc,node_risk_class,node_vulnerability,node_redzone,node_dynamic_redzone,node_priority toneMint
class node_suitability,node_capacity,node_matching,node_routing,node_scenario toneRose
class node_profiles,node_providers,node_ingestion,node_spatial_db,node_telemetry,node_officer toneIndigo
```

## Components

### User Workbench

- [GIS Explorer](https://github.com/ojaswijoshi13/rakshakgis/blob/main/frontend/src/app/gis/page.tsx): `frontend/src/app/gis/page.tsx`
- [Village Profile](https://github.com/ojaswijoshi13/rakshakgis/blob/main/frontend/src/app/villages/page.tsx): `frontend/src/app/villages/page.tsx`
- [Operations Console](https://github.com/ojaswijoshi13/rakshakgis/tree/main/frontend/src/app/operations): `frontend/src/app/operations`

### API and Operations

- [REST API](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/routes.py): `backend/app/api/routes.py`
- [Risk and Red Zones](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/risk.py): `backend/app/api/v1/risk.py`
- [Relocation Services](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/relocation.py): `backend/app/api/v1/relocation.py`
- [Scenario Services](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/scenarios.py): `backend/app/api/v1/scenarios.py`
- [Governance Workflows](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/governance.py): `backend/app/api/v1/governance.py`
- [Reports](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/api/v1/reports.py): `backend/app/api/v1/reports.py`

### Risk Intelligence

- [Risk Computation](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/computation/engine.py): `backend/app/core/risk/computation/engine.py`
- [Risk Classification](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/classification/engine.py): `backend/app/core/risk/classification/engine.py`
- [Vulnerability Scoring](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/vulnerability/engine.py): `backend/app/core/risk/vulnerability/engine.py`
- [Red Zone Analysis](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/red_zone/engine.py): `backend/app/core/risk/red_zone/engine.py`
- [Dynamic Red Zones](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/red_zone/dynamic_engine.py): `backend/app/core/risk/red_zone/dynamic_engine.py`
- [Relocation Priority](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/risk/relocation_priority/engine.py): `backend/app/core/risk/relocation_priority/engine.py`

### Relocation Planning

- [Site Suitability](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/relocation/suitability/engine.py): `backend/app/core/relocation/suitability/engine.py`
- [Site Capacity](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/relocation/capacity/engine.py): `backend/app/core/relocation/capacity/engine.py`
- [Relocation Matching](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/relocation/matching/engine.py): `backend/app/core/relocation/matching/engine.py`
- [Evacuation Routing](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/relocation/routing/engine.py): `backend/app/core/relocation/routing/engine.py`
- [Scenario Simulator](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/scenarios/engine.py): `backend/app/core/scenarios/engine.py`

### Data and Configuration

- [Regional Profiles](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/profiles/models.py): `backend/app/core/profiles/models.py`
- [Hazard Providers](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/data/providers/contracts.py): `backend/app/data/providers/contracts.py`
- [Data Ingestion](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/data/ingestion/pipeline.py): `backend/app/data/ingestion/pipeline.py`
- [Spatial Database](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Live Telemetry](https://github.com/ojaswijoshi13/rakshakgis/blob/main/backend/app/core/telemetry/service.py): `backend/app/core/telemetry/service.py`

### Other components

- **Disaster Officer**

## Connections

- Disaster Officer → GIS Explorer: explores map (evidence: `README.md`)
- Disaster Officer → Village Profile: reviews villages (evidence: `README.md`)
- Disaster Officer → Operations Console: manages operations (evidence: `README.md`)
- GIS Explorer → REST API: requests REST/GeoJSON (evidence: `README.md`)
- Village Profile → REST API: requests REST/GeoJSON (evidence: `README.md`)
- Operations Console → REST API: uses REST
- REST API → Risk and Red Zones: routes requests
- REST API → Relocation Services: routes requests
- REST API → Scenario Services: routes requests
- Risk and Red Zones → Risk Computation: invokes
- Risk Computation → Risk Classification: classifies result (evidence: `backend/app/core/risk/classification/engine.py`)
- Risk Computation → Vulnerability Scoring: uses factor scores
- Risk and Red Zones → Red Zone Analysis: invokes
- Risk and Red Zones → Dynamic Red Zones: invokes
- Risk and Red Zones → Relocation Priority: invokes
- Relocation Services → Relocation Matching: invokes
- Relocation Matching → Site Suitability: evaluates sites (evidence: `backend/app/core/relocation/matching/engine.py`)
- Relocation Matching → Site Capacity: checks capacity (evidence: `backend/app/core/relocation/matching/engine.py`)
- Scenario Services → Scenario Simulator: invokes
- Scenario Simulator → Risk Computation: computes risk (evidence: `backend/app/core/scenarios/engine.py`)
- Scenario Simulator → Dynamic Red Zones: evaluates zones (evidence: `backend/app/core/scenarios/engine.py`)
- Scenario Simulator → Relocation Priority: scores priority (evidence: `backend/app/core/scenarios/engine.py`)
- Scenario Simulator → Site Suitability: assesses sites (evidence: `backend/app/core/scenarios/engine.py`)
- Scenario Simulator → Site Capacity: sizes capacity (evidence: `backend/app/core/scenarios/engine.py`)
- Scenario Simulator → Relocation Matching: assigns sites (evidence: `backend/app/core/scenarios/engine.py`)
- Scenario Simulator → Evacuation Routing: plans routes (evidence: `backend/app/core/scenarios/engine.py`)
- Risk Computation → Regional Profiles: loads configuration (evidence: `backend/app/core/risk/computation/engine.py`)
- Hazard Providers → Risk Computation: supplies observations (evidence: `backend/app/core/risk/computation/engine.py`)
- Data Ingestion → Spatial Database: loads datasets
- Live Telemetry → Hazard Providers: uses provider data
- Governance Workflows → Spatial Database: persists decisions
- REST API → Reports: serves reports
