# yashmishra9/hazard-watch architecture

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

- Interactive diagram: https://gitdiagram.com/yashmishra9/hazard-watch
- Repository: https://github.com/yashmishra9/hazard-watch

## Overview

Hazard Watch supports citizen hazard reporting, authority review, and hotspot analysis. Citizens submit categorized, located reports that are stored locally; the dashboard reads them, displays statistics and a map, and derives alerts from validated clusters. The monitor separately loads Pune demo reports and runs ST-DBSCAN. Map presentation and alert details provide the key internal UI layer. Edges reflect excerpts, SOURCE INDEX references, or README statements; some component details are unsampled, so uncertain connections are omitted.

Main entry points: [`src/app/dashboard/page.tsx`](https://github.com/yashmishra9/hazard-watch/blob/main/src/app/dashboard/page.tsx) (Authority dashboard), [`src/components/map/HazardMapInner.tsx`](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/HazardMapInner.tsx) (Leaflet map), [`src/lib/clustering/stdbscan.ts`](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/stdbscan.ts) (ST-DBSCAN), [`src/lib/hazardService.ts`](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/hazardService.ts) (Local report store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reporting["Citizen reporting"]
  node_report_page["Report page<br/>[page.tsx]"]
  node_report_form["Report form<br/>[ReportForm.tsx]"]
end

subgraph group_authority["Authority dashboard"]
  node_dashboard["Authority dashboard<br/>[page.tsx]"]
  node_report_list["Report list<br/>[ReportList.tsx]"]
  node_dashboard_states["Dashboard states<br/>[States.tsx]"]
  node_toast["Toast feedback<br/>[Toast.tsx]"]
  node_stats["Report statistics<br/>[StatCards.tsx]"]
end

subgraph group_analysis["Hazard analysis"]
  node_monitor_page["Monitor page<br/>[page.tsx]"]
  node_monitor["Analysis monitor<br/>[HazardMonitor.tsx]"]
  node_monitor_adapters["Monitor adapters<br/>[adapters.ts]"]
  node_demo_data["Pune demo reports<br/>[pune-hazards.ts]"]
  node_clustering["ST-DBSCAN<br/>[stdbscan.ts]"]
  node_cluster_options["Cluster options<br/>[options.ts]"]
  node_cluster_geo["Cluster geometry<br/>[geo.ts]"]
  node_cluster_severity["Cluster severity<br/>[severity.ts]"]
end

subgraph group_presentation["Maps and alerts"]
  node_hazard_map["Hazard map wrapper<br/>[HazardMap.tsx]"]
  node_map_inner["Leaflet map<br/>[HazardMapInner.tsx]"]
  node_map_config["Map configuration<br/>[mapConfig.ts]"]
  node_map_details["Cluster map details"]
  node_map_legend["Map legend<br/>[MapLegend.tsx]"]
  node_alerts_logic["Alert derivation<br/>[alerts.ts]"]
  node_alert_panel["Alert panel<br/>[AlertPanel.tsx]"]
  node_alert_card["Alert card<br/>[AlertCard.tsx]"]
  node_hazard_badges["Hazard badges<br/>[HazardBadges.tsx]"]
end

subgraph group_shared["Shared runtime"]
  node_report_store[("Local report store<br/>[hazardService.ts]")]
  node_data_hook["Hazard data hook<br/>[useHazardData.ts]"]
  node_geo_helpers["Display geo helpers<br/>[geo.ts]"]
  node_hazard_types["Hazard data types<br/>[hazard.ts]"]
  node_format_helpers["Formatting helpers<br/>[format.ts]"]
end

node_citizen(("Citizen"))
node_browser_storage[("Browser localStorage")]
node_tile_provider["Map tile service"]

node_citizen -->|"opens"| node_report_page
node_report_page -->|"renders"| node_report_form
node_report_form -->|"submits report"| node_report_store
node_report_store -->|"reads and writes"| node_browser_storage
node_report_store -->|"computes clusters"| node_clustering
node_data_hook -->|"loads and subscribes"| node_report_store
node_dashboard -->|"loads data"| node_data_hook
node_dashboard -->|"renders reports"| node_report_list
node_dashboard -->|"renders status"| node_dashboard_states
node_dashboard -->|"shows feedback"| node_toast
node_dashboard -->|"shows statistics"| node_stats
node_dashboard -->|"shows hotspots"| node_hazard_map
node_dashboard -->|"builds alerts"| node_alerts_logic
node_dashboard -->|"renders alerts"| node_alert_panel
node_monitor_page -->|"renders monitor"| node_monitor
node_monitor -->|"loads and analyzes"| node_monitor_adapters
node_monitor_adapters -->|"loads reports"| node_demo_data
node_monitor_adapters -->|"runs analysis"| node_clustering
node_clustering -->|"uses options"| node_cluster_options
node_clustering -->|"uses geometry"| node_cluster_geo
node_clustering -->|"assigns severity"| node_cluster_severity
node_hazard_map -->|"loads client map"| node_map_inner
node_map_inner -->|"indexes reports"| node_geo_helpers
node_map_inner -->|"renders hotspot details"| node_map_details
node_map_inner -->|"renders legend"| node_map_legend
node_map_inner -->|"uses map settings"| node_map_config
node_map_inner -->|"requests tiles"| node_tile_provider
node_alerts_logic -->|"ranks severity"| node_map_config
node_alert_panel -->|"displays alerts"| node_alerts_logic
node_alert_panel -->|"renders cards"| node_alert_card
node_alert_card -->|"renders badges"| node_hazard_badges
node_alert_card -->|"formats dates"| node_format_helpers
node_map_details -->|"renders badges"| node_hazard_badges
node_map_details -->|"uses report geometry"| node_geo_helpers
node_report_store -->|"stores typed reports"| node_hazard_types
node_map_config -->|"defines hazard metadata"| node_hazard_types

click node_report_page "https://github.com/yashmishra9/hazard-watch/blob/main/src/app/report/page.tsx"
click node_report_form "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/ReportForm.tsx"
click node_report_store "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/hazardService.ts"
click node_data_hook "https://github.com/yashmishra9/hazard-watch/blob/main/src/hooks/useHazardData.ts"
click node_dashboard "https://github.com/yashmishra9/hazard-watch/blob/main/src/app/dashboard/page.tsx"
click node_report_list "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/ReportList.tsx"
click node_dashboard_states "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/States.tsx"
click node_toast "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/Toast.tsx"
click node_stats "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/StatCards.tsx"
click node_monitor_page "https://github.com/yashmishra9/hazard-watch/blob/main/src/app/monitor/page.tsx"
click node_monitor "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/monitor/HazardMonitor.tsx"
click node_monitor_adapters "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/monitor/adapters.ts"
click node_demo_data "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/demo-data/pune-hazards.ts"
click node_clustering "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/stdbscan.ts"
click node_cluster_options "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/options.ts"
click node_cluster_geo "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/geo.ts"
click node_cluster_severity "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/severity.ts"
click node_hazard_map "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/HazardMap.tsx"
click node_map_inner "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/HazardMapInner.tsx"
click node_map_config "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/mapConfig.ts"
click node_map_details "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/ClusterDetailsBody.tsx"
click node_map_legend "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/MapLegend.tsx"
click node_alerts_logic "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/alerts.ts"
click node_alert_panel "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/alerts/AlertPanel.tsx"
click node_alert_card "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/alerts/AlertCard.tsx"
click node_geo_helpers "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/geo.ts"
click node_hazard_types "https://github.com/yashmishra9/hazard-watch/blob/main/src/types/hazard.ts"
click node_format_helpers "https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/format.ts"
click node_hazard_badges "https://github.com/yashmishra9/hazard-watch/blob/main/src/components/ui/HazardBadges.tsx"

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_report_page,node_report_form toneBlue
class node_dashboard,node_report_list,node_dashboard_states,node_toast,node_stats,node_browser_storage toneAmber
class node_monitor_page,node_monitor,node_monitor_adapters,node_demo_data,node_clustering,node_cluster_options,node_cluster_geo,node_cluster_severity toneMint
class node_hazard_map,node_map_inner,node_map_config,node_map_details,node_map_legend,node_alerts_logic,node_alert_panel,node_alert_card,node_hazard_badges toneRose
class node_report_store,node_data_hook,node_geo_helpers,node_hazard_types,node_format_helpers,node_citizen,node_tile_provider toneIndigo
```

## Components

### Citizen reporting

- [Report page](https://github.com/yashmishra9/hazard-watch/blob/main/src/app/report/page.tsx): `src/app/report/page.tsx`
- [Report form](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/ReportForm.tsx): `src/components/ReportForm.tsx`

### Authority dashboard

- [Authority dashboard](https://github.com/yashmishra9/hazard-watch/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Report list](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/ReportList.tsx): `src/components/ReportList.tsx`
- [Dashboard states](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/States.tsx): `src/components/States.tsx`
- [Toast feedback](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/Toast.tsx): `src/components/Toast.tsx`
- [Report statistics](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/StatCards.tsx): `src/components/StatCards.tsx`

### Hazard analysis

- [Monitor page](https://github.com/yashmishra9/hazard-watch/blob/main/src/app/monitor/page.tsx): `src/app/monitor/page.tsx`
- [Analysis monitor](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/monitor/HazardMonitor.tsx): `src/components/monitor/HazardMonitor.tsx`
- [Monitor adapters](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/monitor/adapters.ts): `src/lib/monitor/adapters.ts`
- [Pune demo reports](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/demo-data/pune-hazards.ts): `src/lib/demo-data/pune-hazards.ts`
- [ST-DBSCAN](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/stdbscan.ts): `src/lib/clustering/stdbscan.ts`
- [Cluster options](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/options.ts): `src/lib/clustering/options.ts`
- [Cluster geometry](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/geo.ts): `src/lib/clustering/geo.ts`
- [Cluster severity](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/clustering/severity.ts): `src/lib/clustering/severity.ts`

### Maps and alerts

- [Hazard map wrapper](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/HazardMap.tsx): `src/components/map/HazardMap.tsx`
- [Leaflet map](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/HazardMapInner.tsx): `src/components/map/HazardMapInner.tsx`
- [Map configuration](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/mapConfig.ts): `src/components/map/mapConfig.ts`
- [Cluster map details](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/ClusterDetailsBody.tsx): `src/components/map/ClusterDetailsBody.tsx`
- [Map legend](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/map/MapLegend.tsx): `src/components/map/MapLegend.tsx`
- [Alert derivation](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/alerts.ts): `src/lib/alerts.ts`
- [Alert panel](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/alerts/AlertPanel.tsx): `src/components/alerts/AlertPanel.tsx`
- [Alert card](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/alerts/AlertCard.tsx): `src/components/alerts/AlertCard.tsx`
- [Hazard badges](https://github.com/yashmishra9/hazard-watch/blob/main/src/components/ui/HazardBadges.tsx): `src/components/ui/HazardBadges.tsx`

### Shared runtime

- [Local report store](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/hazardService.ts): `src/lib/hazardService.ts`
- [Hazard data hook](https://github.com/yashmishra9/hazard-watch/blob/main/src/hooks/useHazardData.ts): `src/hooks/useHazardData.ts`
- [Display geo helpers](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/geo.ts): `src/lib/geo.ts`
- [Hazard data types](https://github.com/yashmishra9/hazard-watch/blob/main/src/types/hazard.ts): `src/types/hazard.ts`
- [Formatting helpers](https://github.com/yashmishra9/hazard-watch/blob/main/src/lib/format.ts): `src/lib/format.ts`

### Other components

- **Citizen**
- **Browser localStorage**
- **Map tile service**

## Connections

- Citizen → Report page: opens (evidence: `README.md`)
- Report page → Report form: renders (evidence: `src/app/report/page.tsx`)
- Report form → Local report store: submits report (evidence: `src/components/ReportForm.tsx`)
- Local report store → Browser localStorage: reads and writes (evidence: `src/lib/hazardService.ts`)
- Local report store → ST-DBSCAN: computes clusters (evidence: `src/lib/hazardService.ts`)
- Hazard data hook → Local report store: loads and subscribes (evidence: `src/hooks/useHazardData.ts`)
- Authority dashboard → Hazard data hook: loads data (evidence: `src/app/dashboard/page.tsx`)
- Authority dashboard → Report list: renders reports (evidence: `src/app/dashboard/page.tsx`)
- Authority dashboard → Dashboard states: renders status (evidence: `src/app/dashboard/page.tsx`)
- Authority dashboard → Toast feedback: shows feedback (evidence: `src/app/dashboard/page.tsx`)
- Authority dashboard → Report statistics: shows statistics (evidence: `src/app/dashboard/page.tsx`)
- Authority dashboard → Hazard map wrapper: shows hotspots (evidence: `src/app/dashboard/page.tsx`)
- Authority dashboard → Alert derivation: builds alerts (evidence: `src/app/dashboard/page.tsx`)
- Authority dashboard → Alert panel: renders alerts (evidence: `src/app/dashboard/page.tsx`)
- Monitor page → Analysis monitor: renders monitor (evidence: `src/app/monitor/page.tsx`)
- Analysis monitor → Monitor adapters: loads and analyzes (evidence: `src/components/monitor/HazardMonitor.tsx`)
- Monitor adapters → Pune demo reports: loads reports (evidence: `src/lib/monitor/adapters.ts`)
- Monitor adapters → ST-DBSCAN: runs analysis (evidence: `src/lib/monitor/adapters.ts`)
- ST-DBSCAN → Cluster options: uses options (evidence: `src/lib/clustering/stdbscan.ts`)
- ST-DBSCAN → Cluster geometry: uses geometry (evidence: `src/lib/clustering/stdbscan.ts`)
- ST-DBSCAN → Cluster severity: assigns severity (evidence: `src/lib/clustering/stdbscan.ts`)
- Hazard map wrapper → Leaflet map: loads client map (evidence: `src/components/map/HazardMap.tsx`)
- Leaflet map → Display geo helpers: indexes reports (evidence: `src/components/map/HazardMapInner.tsx`)
- Leaflet map → Cluster map details: renders hotspot details (evidence: `src/components/map/HazardMapInner.tsx`)
- Leaflet map → Map legend: renders legend (evidence: `src/components/map/HazardMapInner.tsx`)
- Leaflet map → Map configuration: uses map settings (evidence: `src/components/map/HazardMapInner.tsx`)
- Leaflet map → Map tile service: requests tiles (evidence: `src/components/map/HazardMapInner.tsx`)
- Alert derivation → Map configuration: ranks severity (evidence: `src/lib/alerts.ts`)
- Alert panel → Alert derivation: displays alerts (evidence: `src/components/alerts/AlertPanel.tsx`)
- Alert panel → Alert card: renders cards (evidence: `src/components/alerts/AlertPanel.tsx`)
- Alert card → Hazard badges: renders badges (evidence: `src/components/alerts/AlertCard.tsx`)
- Alert card → Formatting helpers: formats dates (evidence: `src/components/alerts/AlertCard.tsx`)
- Cluster map details → Hazard badges: renders badges (evidence: `src/components/map/ClusterDetailsPanel.tsx`)
- Cluster map details → Display geo helpers: uses report geometry (evidence: `src/components/map/ClusterDetailsPanel.tsx`)
- Local report store → Hazard data types: stores typed reports (evidence: `src/lib/hazardService.ts`)
- Map configuration → Hazard data types: defines hazard metadata (evidence: `src/components/map/mapConfig.ts`)
