# nandakishore170507/urban-disaster-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/nandakishore170507/urban-disaster-dashboard
- Repository: https://github.com/nandakishore170507/urban-disaster-dashboard

## Overview

Aegis is an urban emergency command dashboard. Operators use the browser dashboard to review live incident and risk information, report geolocated incidents with photos, inspect incident details, and access analytics, shelters, and resources. The Node server routes the dashboard’s API requests, supplies demo data or uses Supabase for persistence, and integrates place search and photo storage. The README documents GIS overlays, field-team dispatch, and alert analytics; some implementation details are unsampled, so those links are documented at subsystem level.

Main entry points: [`app.js`](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js) (Operations UI), [`server.js`](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js) (HTTP API routing), [`supabase/schema.sql`](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/supabase/schema.sql) (Operational schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Command dashboard"]
  node_dashboard["Operations UI<br/>[app.js]"]
  node_gis["GIS risk map<br/>[app.js]"]
  node_incidentreport["Incident reporting<br/>[app.js]"]
  node_analyticsui["Analytics and shelters<br/>[app.js]"]
end

subgraph group_api["API and operations"]
  node_api["HTTP API routing<br/>[server.js]"]
  node_incidentops["Incident operations<br/>[server.js]"]
  node_dispatch["Team dispatch<br/>[server.js]"]
  node_dashboarddata["Dashboard data<br/>[server.js]"]
  node_placefinder["Place search<br/>[server.js]"]
  node_audit["Audit and history<br/>[server.js]"]
end

subgraph group_data["Persistence"]
  node_schema["Operational schema<br/>[schema.sql]"]
end

subgraph group_integrations["External services"]
  node_supabase[("Supabase database")]
  node_photostorage[("Photo storage")]
  node_geocoders["Place providers"]
  node_leaflet["Leaflet GIS"]
end

node_operator(("Emergency operator"))

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"requests API"| node_api
node_dashboard -->|"views map"| node_gis
node_dashboard -->|"submits reports"| node_incidentreport
node_dashboard -->|"opens views"| node_analyticsui
node_api -->|"routes incidents"| node_incidentops
node_api -->|"serves dashboard"| node_dashboarddata
node_api -->|"routes places"| node_placefinder
node_incidentops -->|"persists incidents"| node_supabase
node_dashboarddata -->|"reads operations"| node_supabase
node_incidentops -->|"stores photos"| node_photostorage
node_incidentops -->|"records events"| node_audit
node_api -.->|"supports dispatch"| node_dispatch
node_dispatch -.->|"dispatches teams"| node_supabase
node_placefinder -->|"queries providers"| node_geocoders
node_gis -.->|"renders overlays"| node_leaflet
node_schema -->|"defines tables"| node_supabase

click node_dashboard "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js"
click node_gis "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js"
click node_incidentreport "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js"
click node_analyticsui "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js"
click node_api "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js"
click node_incidentops "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js"
click node_dispatch "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js"
click node_dashboarddata "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js"
click node_placefinder "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js"
click node_audit "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js"
click node_schema "https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/supabase/schema.sql"

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_dashboard,node_gis,node_incidentreport,node_analyticsui toneBlue
class node_api,node_incidentops,node_dispatch,node_dashboarddata,node_placefinder,node_audit toneAmber
class node_schema toneMint
class node_supabase,node_photostorage,node_geocoders,node_leaflet toneRose
class node_operator toneIndigo
```

## Components

### Command dashboard

- [Operations UI](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js): `app.js`
- [GIS risk map](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js): `app.js`
- [Incident reporting](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js): `app.js`
- [Analytics and shelters](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/app.js): `app.js`

### API and operations

- [HTTP API routing](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js): `server.js`
- [Incident operations](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js): `server.js`
- [Team dispatch](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js): `server.js`
- [Dashboard data](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js): `server.js`
- [Place search](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js): `server.js`
- [Audit and history](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/server.js): `server.js`

### Persistence

- [Operational schema](https://github.com/nandakishore170507/urban-disaster-dashboard/blob/main/supabase/schema.sql): `supabase/schema.sql`

### External services

- **Supabase database**
- **Photo storage**
- **Place providers**
- **Leaflet GIS**

### Other components

- **Emergency operator**

## Connections

- Emergency operator → Operations UI: uses (evidence: `README.md`)
- Operations UI → HTTP API routing: requests API (evidence: `app.js`)
- Operations UI → GIS risk map: views map (evidence: `README.md`)
- Operations UI → Incident reporting: submits reports (evidence: `app.js`)
- Operations UI → Analytics and shelters: opens views (evidence: `app.js`)
- HTTP API routing → Incident operations: routes incidents (evidence: `server.js`)
- HTTP API routing → Dashboard data: serves dashboard (evidence: `server.js`)
- HTTP API routing → Place search: routes places (evidence: `server.js`)
- Incident operations → Supabase database: persists incidents (evidence: `server.js`)
- Dashboard data → Supabase database: reads operations (evidence: `server.js`)
- Incident operations → Photo storage: stores photos (evidence: `README.md`)
- Incident operations → Audit and history: records events (evidence: `server.js`)
- HTTP API routing → Team dispatch: supports dispatch (evidence: `README.md`)
- Team dispatch → Supabase database: dispatches teams (evidence: `README.md`)
- Place search → Place providers: queries providers (evidence: `server.js`)
- GIS risk map → Leaflet GIS: renders overlays (evidence: `README.md`)
- Operational schema → Supabase database: defines tables (evidence: `README.md`)
