# aaryankasaudhan91-dev/aero-vision architecture

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

- Interactive diagram: https://gitdiagram.com/aaryankasaudhan91-dev/aero-vision
- Repository: https://github.com/aaryankasaudhan91-dev/aero-vision

## Overview

AeroVision is a geospatial atmospheric intelligence platform: users choose a dashboard, retrieve environmental data through the API, and inspect mapped analyses, forecasts, alerts, and reports. The README documents capabilities beyond the sampled code; those are represented at the subsystem level. Source-index references and excerpts support the backend routing, service, and storage links shown; unsampled internal behavior is not expanded into speculative calls.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/services/api.ts) (Frontend API client), [`frontend/src/App.tsx`](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/App.tsx) (App navigation and sync), [`backend/app/main.py`](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/main.py) (FastAPI application), [`frontend/src/components/IndiaMap.tsx`](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/IndiaMap.tsx) (2D/3D map interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User Interface"]
  node_app["App navigation and sync<br/>[App.tsx]"]
  node_aqi_ui["AQI dashboard<br/>[AqiDashboard.tsx]"]
  node_pollutant_ui["Pollutant maps"]
  node_health_ui["Health risk dashboard"]
  node_hcho_ui["HCHO hotspot dashboard<br/>[HchoDashboard.tsx]"]
  node_fire_ui["Fire dashboard<br/>[FireDashboard.tsx]"]
  node_transport_ui["Transport dashboard"]
  node_weather_ui["Weather dashboard"]
  node_insights_ui["AI insights dashboard"]
  node_reports_ui["Research reports dashboard"]
  node_map["2D/3D map interface<br/>[IndiaMap.tsx]"]
  node_map2d["2D GIS rendering<br/>[IndiaMap2D.tsx]"]
  node_map3d["3D atmospheric map<br/>[IndiaMap3D.tsx]"]
end

subgraph group_api["API Surface"]
  node_api_client["Frontend API client<br/>[api.ts]"]
  node_server["FastAPI application<br/>[main.py]"]
  node_aqi_route["AQI endpoints<br/>[aqi.py]"]
  node_hcho_route["HCHO endpoints<br/>[hcho.py]"]
  node_fire_route["Fire endpoints<br/>[fire.py]"]
  node_transport_route["Transport endpoints<br/>[transport.py]"]
  node_weather_route["Weather endpoints<br/>[weather.py]"]
  node_insights_route["Insights endpoints<br/>[insights.py]"]
  node_reports_route["Report endpoints<br/>[reports.py]"]
  node_alerts_route["Alert subscriptions<br/>[alerts.py]"]
end

subgraph group_analysis["Analysis and Data"]
  node_aqi_service["AQI data service<br/>[aqi_service.py]"]
  node_hcho_service["HCHO analysis service<br/>[hcho_service.py]"]
  node_fire_service["Fire data service<br/>[fire_service.py]"]
  node_transport_service["Transport analysis service"]
  node_weather_service["Forecast service"]
  node_insights_service["AI insights service"]
  node_report_service["Report generation service<br/>[report_service.py]"]
  node_alerts_service["Email dispatch<br/>[email_service.py]"]
  node_ingestion["Data ingestion pipelines<br/>[data_ingestion.py]"]
  node_aqi_engine["CPCB AQI computation<br/>[aqi_engine.py]"]
end

subgraph group_infra["Persistence and Integrations"]
end

node_user(("Platform user"))

node_user -->|"uses"| node_app
node_app -->|"selects dashboard"| node_aqi_ui
node_app -->|"selects dashboard"| node_pollutant_ui
node_app -->|"selects dashboard"| node_health_ui
node_app -->|"selects dashboard"| node_hcho_ui
node_app -->|"selects dashboard"| node_fire_ui
node_app -->|"selects dashboard"| node_transport_ui
node_app -->|"selects dashboard"| node_weather_ui
node_app -->|"selects dashboard"| node_insights_ui
node_app -->|"selects dashboard"| node_reports_ui
node_aqi_ui -.->|"requests data"| node_api_client
node_health_ui -->|"requests data"| node_api_client
node_hcho_ui -->|"requests data"| node_api_client
node_weather_ui -->|"requests data"| node_api_client
node_reports_ui -->|"requests data"| node_api_client
node_health_ui -->|"renders analysis"| node_map
node_hcho_ui -->|"renders hotspots"| node_map
node_weather_ui -->|"renders forecast"| node_map
node_map -.->|"offers 2D view"| node_map2d
node_map -.->|"offers 3D view"| node_map3d
node_api_client -->|"calls AQI routes"| node_aqi_route
node_api_client -->|"calls HCHO routes"| node_hcho_route
node_api_client -->|"calls fire routes"| node_fire_route
node_api_client -->|"calls transport routes"| node_transport_route
node_api_client -.->|"calls weather routes"| node_weather_route
node_api_client -.->|"calls insights routes"| node_insights_route
node_api_client -->|"calls report routes"| node_reports_route
node_server -->|"registers"| node_aqi_route
node_server -->|"registers"| node_hcho_route
node_server -->|"registers"| node_fire_route
node_server -->|"registers"| node_transport_route
node_server -->|"registers"| node_weather_route
node_server -->|"registers"| node_insights_route
node_server -->|"registers"| node_reports_route
node_server -->|"registers"| node_alerts_route
node_aqi_route -->|"delegates to"| node_aqi_service
node_hcho_route -->|"delegates to"| node_hcho_service
node_fire_route -->|"delegates to"| node_fire_service
node_insights_route -->|"delegates to"| node_insights_service
node_reports_route -->|"delegates to"| node_report_service
node_alerts_route -->|"dispatches through"| node_alerts_service
node_ingestion -->|"computes AQI"| node_aqi_engine
node_report_service -.->|"uses summaries"| node_insights_service

click node_app "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/App.tsx"
click node_aqi_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/AqiDashboard.tsx"
click node_pollutant_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/PollutantDashboard.tsx"
click node_health_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/HealthDashboard.tsx"
click node_hcho_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/HchoDashboard.tsx"
click node_fire_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/FireDashboard.tsx"
click node_transport_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/TransportDashboard.tsx"
click node_weather_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/WeatherDashboard.tsx"
click node_insights_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/InsightsDashboard.tsx"
click node_reports_ui "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/ReportsDashboard.tsx"
click node_map "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/IndiaMap.tsx"
click node_map2d "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/IndiaMap2D.tsx"
click node_map3d "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/IndiaMap3D.tsx"
click node_api_client "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/services/api.ts"
click node_server "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/main.py"
click node_aqi_route "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/aqi.py"
click node_hcho_route "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/hcho.py"
click node_fire_route "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/fire.py"
click node_transport_route "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/transport.py"
click node_weather_route "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/weather.py"
click node_insights_route "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/insights.py"
click node_reports_route "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/reports.py"
click node_alerts_route "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/alerts.py"
click node_aqi_service "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/aqi_service.py"
click node_hcho_service "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/hcho_service.py"
click node_fire_service "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/fire_service.py"
click node_transport_service "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/transport_service.py"
click node_weather_service "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/fourcastnet_service.py"
click node_insights_service "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/insights_service.py"
click node_report_service "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/report_service.py"
click node_alerts_service "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/email_service.py"
click node_ingestion "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/pipelines/data_ingestion.py"
click node_aqi_engine "https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/ml/aqi_engine.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_app,node_aqi_ui,node_pollutant_ui,node_health_ui,node_hcho_ui,node_fire_ui,node_transport_ui,node_weather_ui,node_insights_ui,node_reports_ui,node_map,node_map2d,node_map3d,node_user toneBlue
class node_api_client,node_server,node_aqi_route,node_hcho_route,node_fire_route,node_transport_route,node_weather_route,node_insights_route,node_reports_route,node_alerts_route toneAmber
class node_aqi_service,node_hcho_service,node_fire_service,node_transport_service,node_weather_service,node_insights_service,node_report_service,node_alerts_service,node_ingestion,node_aqi_engine toneMint
```

## Components

### User Interface

- [App navigation and sync](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/App.tsx): `frontend/src/App.tsx`
- [AQI dashboard](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/AqiDashboard.tsx): `frontend/src/components/AqiDashboard.tsx`
- [Pollutant maps](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/PollutantDashboard.tsx): `frontend/src/components/PollutantDashboard.tsx`
- [Health risk dashboard](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/HealthDashboard.tsx): `frontend/src/components/HealthDashboard.tsx`
- [HCHO hotspot dashboard](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/HchoDashboard.tsx): `frontend/src/components/HchoDashboard.tsx`
- [Fire dashboard](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/FireDashboard.tsx): `frontend/src/components/FireDashboard.tsx`
- [Transport dashboard](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/TransportDashboard.tsx): `frontend/src/components/TransportDashboard.tsx`
- [Weather dashboard](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/WeatherDashboard.tsx): `frontend/src/components/WeatherDashboard.tsx`
- [AI insights dashboard](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/InsightsDashboard.tsx): `frontend/src/components/InsightsDashboard.tsx`
- [Research reports dashboard](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/ReportsDashboard.tsx): `frontend/src/components/ReportsDashboard.tsx`
- [2D/3D map interface](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/IndiaMap.tsx): `frontend/src/components/IndiaMap.tsx`
- [2D GIS rendering](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/IndiaMap2D.tsx): `frontend/src/components/IndiaMap2D.tsx`
- [3D atmospheric map](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/components/IndiaMap3D.tsx): `frontend/src/components/IndiaMap3D.tsx`

### API Surface

- [Frontend API client](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [FastAPI application](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/main.py): `backend/app/main.py`
- [AQI endpoints](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/aqi.py): `backend/app/routers/aqi.py`
- [HCHO endpoints](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/hcho.py): `backend/app/routers/hcho.py`
- [Fire endpoints](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/fire.py): `backend/app/routers/fire.py`
- [Transport endpoints](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/transport.py): `backend/app/routers/transport.py`
- [Weather endpoints](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/weather.py): `backend/app/routers/weather.py`
- [Insights endpoints](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/insights.py): `backend/app/routers/insights.py`
- [Report endpoints](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/reports.py): `backend/app/routers/reports.py`
- [Alert subscriptions](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/routers/alerts.py): `backend/app/routers/alerts.py`

### Analysis and Data

- [AQI data service](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/aqi_service.py): `backend/app/services/aqi_service.py`
- [HCHO analysis service](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/hcho_service.py): `backend/app/services/hcho_service.py`
- [Fire data service](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/fire_service.py): `backend/app/services/fire_service.py`
- [Transport analysis service](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/transport_service.py): `backend/app/services/transport_service.py`
- [Forecast service](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/fourcastnet_service.py): `backend/app/services/fourcastnet_service.py`
- [AI insights service](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/insights_service.py): `backend/app/services/insights_service.py`
- [Report generation service](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/report_service.py): `backend/app/services/report_service.py`
- [Email dispatch](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/services/email_service.py): `backend/app/services/email_service.py`
- [Data ingestion pipelines](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/pipelines/data_ingestion.py): `backend/app/pipelines/data_ingestion.py`
- [CPCB AQI computation](https://github.com/aaryankasaudhan91-dev/aero-vision/blob/Project-Aero-Vision/backend/app/ml/aqi_engine.py): `backend/app/ml/aqi_engine.py`

### Other components

- **Platform user**

## Connections

- Platform user → App navigation and sync: uses
- App navigation and sync → AQI dashboard: selects dashboard (evidence: `frontend/src/App.tsx`)
- App navigation and sync → Pollutant maps: selects dashboard (evidence: `frontend/src/App.tsx`)
- App navigation and sync → Health risk dashboard: selects dashboard (evidence: `frontend/src/App.tsx`)
- App navigation and sync → HCHO hotspot dashboard: selects dashboard (evidence: `frontend/src/App.tsx`)
- App navigation and sync → Fire dashboard: selects dashboard (evidence: `frontend/src/App.tsx`)
- App navigation and sync → Transport dashboard: selects dashboard (evidence: `frontend/src/App.tsx`)
- App navigation and sync → Weather dashboard: selects dashboard (evidence: `frontend/src/App.tsx`)
- App navigation and sync → AI insights dashboard: selects dashboard (evidence: `frontend/src/App.tsx`)
- App navigation and sync → Research reports dashboard: selects dashboard (evidence: `frontend/src/App.tsx`)
- AQI dashboard → Frontend API client: requests data
- Health risk dashboard → Frontend API client: requests data (evidence: `frontend/src/components/HealthDashboard.tsx`)
- HCHO hotspot dashboard → Frontend API client: requests data (evidence: `frontend/src/components/HchoDashboard.tsx`)
- Weather dashboard → Frontend API client: requests data (evidence: `frontend/src/components/WeatherDashboard.tsx`)
- Research reports dashboard → Frontend API client: requests data (evidence: `frontend/src/components/ReportsDashboard.tsx`)
- Health risk dashboard → 2D/3D map interface: renders analysis (evidence: `frontend/src/components/HealthDashboard.tsx`)
- HCHO hotspot dashboard → 2D/3D map interface: renders hotspots (evidence: `frontend/src/components/HchoDashboard.tsx`)
- Weather dashboard → 2D/3D map interface: renders forecast (evidence: `frontend/src/components/WeatherDashboard.tsx`)
- 2D/3D map interface → 2D GIS rendering: offers 2D view
- 2D/3D map interface → 3D atmospheric map: offers 3D view
- Frontend API client → AQI endpoints: calls AQI routes (evidence: `frontend/src/services/api.ts`)
- Frontend API client → HCHO endpoints: calls HCHO routes (evidence: `frontend/src/services/api.ts`)
- Frontend API client → Fire endpoints: calls fire routes (evidence: `frontend/src/services/api.ts`)
- Frontend API client → Transport endpoints: calls transport routes (evidence: `frontend/src/services/api.ts`)
- Frontend API client → Weather endpoints: calls weather routes
- Frontend API client → Insights endpoints: calls insights routes
- Frontend API client → Report endpoints: calls report routes (evidence: `frontend/src/services/api.ts`)
- FastAPI application → AQI endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → HCHO endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Fire endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Transport endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Weather endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Insights endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Report endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Alert subscriptions: registers (evidence: `backend/app/main.py`)
- AQI endpoints → AQI data service: delegates to (evidence: `backend/app/routers/aqi.py`)
- HCHO endpoints → HCHO analysis service: delegates to (evidence: `backend/app/routers/hcho.py`)
- Fire endpoints → Fire data service: delegates to (evidence: `backend/app/routers/fire.py`)
- Insights endpoints → AI insights service: delegates to (evidence: `backend/app/routers/insights.py`)
- Report endpoints → Report generation service: delegates to (evidence: `backend/app/routers/reports.py`)
- Alert subscriptions → Email dispatch: dispatches through (evidence: `backend/app/routers/alerts.py`)
- Data ingestion pipelines → CPCB AQI computation: computes AQI (evidence: `backend/app/pipelines/data_ingestion.py`)
- Report generation service → AI insights service: uses summaries
