# keval2347/floodguard-response-planner architecture

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

- Interactive diagram: https://gitdiagram.com/keval2347/floodguard-response-planner
- Repository: https://github.com/keval2347/floodguard-response-planner

## Overview

JalNiti is a ward-scale flood response planner: it turns mapped streets and environmental data into segment risk scores, allocates a simulated pump-truck fleet, and lets operators explore scenario overrides in a map-based console. The repository shows a TypeScript runtime pipeline and frontend alongside a Python data-fetch-and-cache pipeline; the README’s broader proposed FastAPI, database, and model-training steps are not represented in the supplied tree. Some subsystem links below rely on README or SOURCE INDEX references because their full source was not excerpted.

Main entry points: [`backend/app/data_pipeline/run_pipeline.py`](https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/run_pipeline.py) (Pipeline CLI), [`src/lib/jalniti/model.ts`](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/model.ts) (Risk and allocation), [`src/lib/jalniti/pipeline.server.ts`](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/pipeline.server.ts) (Data acquisition), [`src/routes/index.tsx`](https://github.com/keval2347/floodguard-response-planner/blob/main/src/routes/index.tsx) (Planner console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_backend["Python Data Pipeline"]
  node_cli["Pipeline CLI<br/>[run_pipeline.py]"]
  node_config["Ward configuration<br/>[config.py]"]
  node_schemas["Input schemas<br/>[schemas.py]"]
  node_osm["OSM fetch<br/>[osm_source.py]"]
  node_dem["Elevation fetch<br/>[dem_source.py]"]
  node_rain["Rainfall fetch<br/>[rainfall_source.py]"]
  node_cache[("File cache<br/>[cache.py]")]
end

subgraph group_runtime["Live Data Runtime"]
  node_live["Live data service<br/>[live.functions.ts]"]
  node_pipeline["Data acquisition<br/>[pipeline.server.ts]"]
  node_ward_data["Ward data model<br/>[data.ts]"]
  node_geo["Geospatial helpers<br/>[geo.ts]"]
end

subgraph group_decision["Risk And Response"]
  node_risk_opt["Risk and allocation<br/>[model.ts]"]
  node_scenario["Scenario validation<br/>[schema.ts]"]
  node_hospital["Hospital access assessment<br/>[hospitals.ts]"]
end

subgraph group_console["Operator Console"]
  node_ui["Planner console<br/>[index.tsx]"]
  node_map["Ward map<br/>[WardMap.tsx]"]
  node_map_panel["Map panel<br/>[MapPanel.tsx]"]
end

node_operator(("Ward operator"))
node_external(("Public data services"))

node_operator -->|"uses"| node_ui
node_ui -->|"requests data"| node_live
node_ui -->|"runs plan"| node_risk_opt
node_ui -->|"renders"| node_map_panel
node_map_panel -->|"renders"| node_map
node_map -->|"reads"| node_ward_data
node_map -->|"reads"| node_hospital
node_live -->|"delegates"| node_pipeline
node_live -->|"uses"| node_ward_data
node_pipeline -->|"uses"| node_ward_data
node_pipeline -->|"uses"| node_geo
node_risk_opt -->|"scores inputs"| node_ward_data
node_risk_opt -->|"uses"| node_geo
node_risk_opt -->|"validates overrides"| node_scenario
node_hospital -->|"measures distance"| node_geo
node_hospital -->|"assesses roads"| node_risk_opt
node_pipeline -->|"fetches datasets"| node_external
node_operator -->|"runs"| node_cli
node_cli -->|"fetches streets"| node_osm
node_cli -->|"fetches elevation"| node_dem
node_cli -->|"fetches rainfall"| node_rain
node_cli -->|"validates arguments"| node_schemas
node_osm -->|"reads settings"| node_config
node_osm -->|"caches files"| node_cache
node_dem -->|"uses cache"| node_cache
node_rain -->|"uses cache"| node_cache
node_dem -->|"reads settings"| node_config
node_rain -->|"reads settings"| node_config
node_cli -->|"loads configuration"| node_config

click node_cli "https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/run_pipeline.py"
click node_config "https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/config.py"
click node_schemas "https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/schemas.py"
click node_osm "https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/osm_source.py"
click node_dem "https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/dem_source.py"
click node_rain "https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/rainfall_source.py"
click node_cache "https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/cache.py"
click node_ui "https://github.com/keval2347/floodguard-response-planner/blob/main/src/routes/index.tsx"
click node_map "https://github.com/keval2347/floodguard-response-planner/blob/main/src/components/jalniti/WardMap.tsx"
click node_map_panel "https://github.com/keval2347/floodguard-response-planner/blob/main/src/components/jalniti/MapPanel.tsx"
click node_live "https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/live.functions.ts"
click node_pipeline "https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/pipeline.server.ts"
click node_ward_data "https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/data.ts"
click node_risk_opt "https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/model.ts"
click node_scenario "https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/schema.ts"
click node_hospital "https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/hospitals.ts"
click node_geo "https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/geo.ts"

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_cli,node_config,node_schemas,node_osm,node_dem,node_rain,node_cache toneBlue
class node_live,node_pipeline,node_ward_data,node_geo toneAmber
class node_risk_opt,node_scenario,node_hospital toneMint
class node_ui,node_map,node_map_panel toneRose
class node_operator,node_external toneIndigo
```

## Components

### Python Data Pipeline

- [Pipeline CLI](https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/run_pipeline.py): `backend/app/data_pipeline/run_pipeline.py`
- [Ward configuration](https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/config.py): `backend/app/config.py`
- [Input schemas](https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/schemas.py): `backend/app/schemas.py`
- [OSM fetch](https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/osm_source.py): `backend/app/data_pipeline/osm_source.py`
- [Elevation fetch](https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/dem_source.py): `backend/app/data_pipeline/dem_source.py`
- [Rainfall fetch](https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/rainfall_source.py): `backend/app/data_pipeline/rainfall_source.py`
- [File cache](https://github.com/keval2347/floodguard-response-planner/blob/main/backend/app/data_pipeline/cache.py): `backend/app/data_pipeline/cache.py`

### Live Data Runtime

- [Live data service](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/live.functions.ts): `src/lib/jalniti/live.functions.ts`
- [Data acquisition](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/pipeline.server.ts): `src/lib/jalniti/pipeline.server.ts`
- [Ward data model](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/data.ts): `src/lib/jalniti/data.ts`
- [Geospatial helpers](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/geo.ts): `src/lib/jalniti/geo.ts`

### Risk And Response

- [Risk and allocation](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/model.ts): `src/lib/jalniti/model.ts`
- [Scenario validation](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/schema.ts): `src/lib/jalniti/schema.ts`
- [Hospital access assessment](https://github.com/keval2347/floodguard-response-planner/blob/main/src/lib/jalniti/hospitals.ts): `src/lib/jalniti/hospitals.ts`

### Operator Console

- [Planner console](https://github.com/keval2347/floodguard-response-planner/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Ward map](https://github.com/keval2347/floodguard-response-planner/blob/main/src/components/jalniti/WardMap.tsx): `src/components/jalniti/WardMap.tsx`
- [Map panel](https://github.com/keval2347/floodguard-response-planner/blob/main/src/components/jalniti/MapPanel.tsx): `src/components/jalniti/MapPanel.tsx`

### Other components

- **Ward operator**
- **Public data services**

## Connections

- Ward operator → Planner console: uses (evidence: `src/routes/index.tsx`)
- Planner console → Live data service: requests data (evidence: `src/routes/index.tsx`)
- Planner console → Risk and allocation: runs plan (evidence: `src/routes/index.tsx`)
- Planner console → Map panel: renders (evidence: `src/routes/index.tsx`)
- Map panel → Ward map: renders (evidence: `src/components/jalniti/MapPanel.tsx`)
- Ward map → Ward data model: reads (evidence: `src/components/jalniti/WardMap.tsx`)
- Ward map → Hospital access assessment: reads (evidence: `src/components/jalniti/WardMap.tsx`)
- Live data service → Data acquisition: delegates (evidence: `src/lib/jalniti/live.functions.ts`)
- Live data service → Ward data model: uses (evidence: `src/lib/jalniti/live.functions.ts`)
- Data acquisition → Ward data model: uses (evidence: `src/lib/jalniti/pipeline.server.ts`)
- Data acquisition → Geospatial helpers: uses (evidence: `src/lib/jalniti/pipeline.server.ts`)
- Risk and allocation → Ward data model: scores inputs (evidence: `src/lib/jalniti/model.ts`)
- Risk and allocation → Geospatial helpers: uses (evidence: `src/lib/jalniti/model.ts`)
- Risk and allocation → Scenario validation: validates overrides (evidence: `src/lib/jalniti/model.ts`)
- Hospital access assessment → Geospatial helpers: measures distance (evidence: `src/lib/jalniti/hospitals.ts`)
- Hospital access assessment → Risk and allocation: assesses roads (evidence: `src/lib/jalniti/hospitals.ts`)
- Data acquisition → Public data services: fetches datasets (evidence: `src/lib/jalniti/pipeline.server.ts`)
- Ward operator → Pipeline CLI: runs (evidence: `backend/app/data_pipeline/run_pipeline.py`)
- Pipeline CLI → OSM fetch: fetches streets (evidence: `backend/app/data_pipeline/run_pipeline.py`)
- Pipeline CLI → Elevation fetch: fetches elevation (evidence: `backend/app/data_pipeline/run_pipeline.py`)
- Pipeline CLI → Rainfall fetch: fetches rainfall (evidence: `backend/app/data_pipeline/run_pipeline.py`)
- Pipeline CLI → Input schemas: validates arguments (evidence: `backend/app/data_pipeline/run_pipeline.py`)
- OSM fetch → Ward configuration: reads settings (evidence: `backend/app/data_pipeline/osm_source.py`)
- OSM fetch → File cache: caches files (evidence: `backend/app/data_pipeline/osm_source.py`)
- Elevation fetch → File cache: uses cache (evidence: `backend/app/data_pipeline/dem_source.py`)
- Rainfall fetch → File cache: uses cache (evidence: `backend/app/data_pipeline/rainfall_source.py`)
- Elevation fetch → Ward configuration: reads settings (evidence: `backend/app/data_pipeline/dem_source.py`)
- Rainfall fetch → Ward configuration: reads settings (evidence: `backend/app/data_pipeline/rainfall_source.py`)
- Pipeline CLI → Ward configuration: loads configuration (evidence: `backend/app/data_pipeline/run_pipeline.py`)
