# vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system architecture

> Architecture diagram of the GitHub repository vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system
- Repository: https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system

## Overview

Aegis is an emergency coordination workspace: citizens and responders use role-based screens to review operational conditions and coordinate incidents, assistance, medical needs, relief, recovery, and information. Its API validates and routes operations requests to a persistent operations snapshot. A legacy risk-monitoring experience separately evaluates flood exposure using weather, nearby-place, and mapped hydrological data. The README is empty; links between the main Aegis UI and API are not shown in the excerpts, so that connection is omitted. The mockup sandbox and shared UI primitives are not central runtime domain components.

Main entry points: [`artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx) (Risk monitoring), [`artifacts/aegis/src/legacy-risk/App.jsx`](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/App.jsx) (Risk navigation), [`artifacts/api-server/src/routes/index.ts`](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/routes/index.ts) (API route registry), [`artifacts/aegis/src/main.tsx`](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/main.tsx) (Aegis app entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_aegis["Aegis operations"]
  node_aegis_entry["Aegis app entry<br/>[main.tsx]"]
  node_aegis_workspace["Operations workspace<br/>[App.tsx]"]
end

subgraph group_risk["Flood risk analysis"]
  node_risk_entry["Risk app entry<br/>[main.jsx]"]
  node_risk_router["Risk navigation<br/>[App.jsx]"]
  node_home_weather["Location and weather<br/>[App.jsx]"]
  node_nearby_places["Nearby places lookup<br/>[nearbyPlaces.js]"]
  node_zone_weather["Zone weather lookup<br/>[zoneWeather.js]"]
  node_home_page["Risk overview<br/>[Home.jsx]"]
  node_monitoring["Risk monitoring<br/>[RiskMonitoring.jsx]"]
  node_risk_map["Risk map<br/>[RiskMap.jsx]"]
  node_infra_exposure["Infrastructure exposure"]
  node_hydro_exposure["Hydrological exposure"]
  node_infra_vulnerability["Infrastructure vulnerability"]
  node_terrain_vulnerability["Terrain vulnerability"]
  node_drainage_vulnerability["Drainage vulnerability"]
  node_capacity_assessment["Capacity assessment"]
  node_historical_floods["Historical flood data<br/>[historicalFlood.js]"]
  node_alerts["Risk alerts<br/>[Alerts.jsx]"]
  node_safety["Safety guidance<br/>[Safety.jsx]"]
end

subgraph group_server["Operations API"]
  node_api_app["HTTP application<br/>[app.ts]"]
  node_api_routes["API route registry<br/>[index.ts]"]
  node_health["Health endpoint<br/>[health.ts]"]
  node_operations_api["Operations endpoints<br/>[operations.ts]"]
end

subgraph group_state["Operational state"]
  node_operations_store[("Operations snapshot store")]
end

node_user(("Citizen or responder"))
node_overpass{{"Overpass service"}}
node_geocoding{{"Open-Meteo geocoding"}}
node_geonames{{"GeoNames service"}}

node_user -->|"opens"| node_aegis_entry
node_aegis_entry -->|"renders"| node_aegis_workspace
node_user -.->|"opens"| node_risk_entry
node_risk_entry -->|"renders"| node_risk_router
node_risk_router -->|"routes weather"| node_home_weather
node_risk_router -->|"renders"| node_home_page
node_risk_router -->|"routes monitoring"| node_monitoring
node_risk_router -->|"routes alerts"| node_alerts
node_risk_router -->|"routes safety"| node_safety
node_home_weather -->|"looks up places"| node_nearby_places
node_home_weather -->|"gets zone weather"| node_zone_weather
node_home_weather -->|"geocodes location"| node_geocoding
node_home_weather -->|"gets population"| node_geonames
node_monitoring -->|"renders"| node_risk_map
node_monitoring -->|"renders"| node_infra_exposure
node_monitoring -->|"renders"| node_hydro_exposure
node_monitoring -->|"renders"| node_infra_vulnerability
node_monitoring -->|"renders"| node_terrain_vulnerability
node_monitoring -->|"renders"| node_drainage_vulnerability
node_monitoring -->|"renders"| node_capacity_assessment
node_monitoring -->|"loads history"| node_historical_floods
node_hydro_exposure -->|"queries features"| node_overpass
node_api_app -->|"mounts API"| node_api_routes
node_api_routes -->|"registers"| node_health
node_api_routes -->|"registers"| node_operations_api
node_operations_api -->|"reads and updates"| node_operations_store

click node_aegis_entry "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/main.tsx"
click node_aegis_workspace "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/App.tsx"
click node_risk_entry "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/main.jsx"
click node_risk_router "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/App.jsx"
click node_home_weather "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/App.jsx"
click node_nearby_places "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/nearbyPlaces.js"
click node_zone_weather "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/zoneWeather.js"
click node_home_page "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/Home.jsx"
click node_monitoring "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx"
click node_risk_map "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/RiskMap.jsx"
click node_infra_exposure "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/InfrastructureExposure.jsx"
click node_hydro_exposure "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/HydrologicalExposure.jsx"
click node_infra_vulnerability "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/InfrastructureVulnerability.jsx"
click node_terrain_vulnerability "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/TerrainVulnerability.jsx"
click node_drainage_vulnerability "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/DrainageVulnerability.jsx"
click node_capacity_assessment "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/CapacityAssessment.jsx"
click node_historical_floods "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/historicalFlood.js"
click node_alerts "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/Alerts.jsx"
click node_safety "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/Safety.jsx"
click node_api_app "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/app.ts"
click node_api_routes "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/routes/index.ts"
click node_health "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/routes/health.ts"
click node_operations_api "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/routes/operations.ts"
click node_operations_store "https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/lib/operations-store.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_aegis_entry,node_aegis_workspace toneBlue
class node_risk_entry,node_risk_router,node_home_weather,node_nearby_places,node_zone_weather,node_home_page,node_monitoring,node_risk_map,node_infra_exposure,node_hydro_exposure,node_infra_vulnerability,node_terrain_vulnerability,node_drainage_vulnerability,node_capacity_assessment,node_historical_floods,node_alerts,node_safety toneAmber
class node_api_app,node_api_routes,node_health,node_operations_api toneMint
class node_operations_store toneRose
class node_user,node_overpass,node_geocoding,node_geonames toneIndigo
```

## Components

### Aegis operations

- [Aegis app entry](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/main.tsx): `artifacts/aegis/src/main.tsx`
- [Operations workspace](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/App.tsx): `artifacts/aegis/src/App.tsx`

### Flood risk analysis

- [Risk app entry](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/main.jsx): `artifacts/aegis/src/legacy-risk/main.jsx`
- [Risk navigation](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/App.jsx): `artifacts/aegis/src/legacy-risk/App.jsx`
- [Location and weather](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/App.jsx): `artifacts/aegis/src/legacy-risk/App.jsx`
- [Nearby places lookup](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/nearbyPlaces.js): `artifacts/aegis/src/legacy-risk/nearbyPlaces.js`
- [Zone weather lookup](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/zoneWeather.js): `artifacts/aegis/src/legacy-risk/zoneWeather.js`
- [Risk overview](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/Home.jsx): `artifacts/aegis/src/legacy-risk/pages/Home.jsx`
- [Risk monitoring](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx): `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`
- [Risk map](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/RiskMap.jsx): `artifacts/aegis/src/legacy-risk/components/RiskMap.jsx`
- [Infrastructure exposure](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/InfrastructureExposure.jsx): `artifacts/aegis/src/legacy-risk/components/InfrastructureExposure.jsx`
- [Hydrological exposure](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/HydrologicalExposure.jsx): `artifacts/aegis/src/legacy-risk/components/HydrologicalExposure.jsx`
- [Infrastructure vulnerability](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/InfrastructureVulnerability.jsx): `artifacts/aegis/src/legacy-risk/components/InfrastructureVulnerability.jsx`
- [Terrain vulnerability](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/TerrainVulnerability.jsx): `artifacts/aegis/src/legacy-risk/components/TerrainVulnerability.jsx`
- [Drainage vulnerability](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/DrainageVulnerability.jsx): `artifacts/aegis/src/legacy-risk/components/DrainageVulnerability.jsx`
- [Capacity assessment](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/components/CapacityAssessment.jsx): `artifacts/aegis/src/legacy-risk/components/CapacityAssessment.jsx`
- [Historical flood data](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/historicalFlood.js): `artifacts/aegis/src/legacy-risk/historicalFlood.js`
- [Risk alerts](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/Alerts.jsx): `artifacts/aegis/src/legacy-risk/pages/Alerts.jsx`
- [Safety guidance](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/aegis/src/legacy-risk/pages/Safety.jsx): `artifacts/aegis/src/legacy-risk/pages/Safety.jsx`

### Operations API

- [HTTP application](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [API route registry](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Health endpoint](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/routes/health.ts): `artifacts/api-server/src/routes/health.ts`
- [Operations endpoints](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/routes/operations.ts): `artifacts/api-server/src/routes/operations.ts`

### Operational state

- [Operations snapshot store](https://github.com/vaishnavimailwar/aegis-adaptive-emergency-geospatial-intelligence-system/blob/main/artifacts/api-server/src/lib/operations-store.ts): `artifacts/api-server/src/lib/operations-store.ts`

### Other components

- **Citizen or responder**
- **Overpass service**
- **Open-Meteo geocoding**
- **GeoNames service**

## Connections

- Citizen or responder → Aegis app entry: opens (evidence: `artifacts/aegis/src/main.tsx`)
- Aegis app entry → Operations workspace: renders (evidence: `artifacts/aegis/src/main.tsx`)
- Citizen or responder → Risk app entry: opens
- Risk app entry → Risk navigation: renders (evidence: `artifacts/aegis/src/legacy-risk/main.jsx`)
- Risk navigation → Location and weather: routes weather (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Risk navigation → Risk overview: renders (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Risk navigation → Risk monitoring: routes monitoring (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Risk navigation → Risk alerts: routes alerts (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Risk navigation → Safety guidance: routes safety (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Location and weather → Nearby places lookup: looks up places (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Location and weather → Zone weather lookup: gets zone weather (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Location and weather → Open-Meteo geocoding: geocodes location (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Location and weather → GeoNames service: gets population (evidence: `artifacts/aegis/src/legacy-risk/App.jsx`)
- Risk monitoring → Risk map: renders (evidence: `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`)
- Risk monitoring → Infrastructure exposure: renders (evidence: `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`)
- Risk monitoring → Hydrological exposure: renders (evidence: `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`)
- Risk monitoring → Infrastructure vulnerability: renders (evidence: `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`)
- Risk monitoring → Terrain vulnerability: renders (evidence: `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`)
- Risk monitoring → Drainage vulnerability: renders (evidence: `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`)
- Risk monitoring → Capacity assessment: renders (evidence: `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`)
- Risk monitoring → Historical flood data: loads history (evidence: `artifacts/aegis/src/legacy-risk/pages/RiskMonitoring.jsx`)
- Hydrological exposure → Overpass service: queries features (evidence: `artifacts/aegis/src/legacy-risk/components/HydrologicalExposure.jsx`)
- HTTP application → API route registry: mounts API (evidence: `artifacts/api-server/src/app.ts`)
- API route registry → Health endpoint: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- API route registry → Operations endpoints: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Operations endpoints → Operations snapshot store: reads and updates (evidence: `artifacts/api-server/src/routes/operations.ts`)
