# pragatisource08/air-action architecture

> Architecture diagram of the GitHub repository pragatisource08/air-action, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pragatisource08/air-action
- Repository: https://github.com/pragatisource08/air-action

## Overview

This is an air-quality intelligence platform: users select a location on an interactive globe, request air-quality information, and inspect current conditions and forecasts. The frontend proxies forecast requests to FastAPI; the backend exposes additional current, historical, and detailed-data capabilities, with source integration implemented in the data-source module. README documents satellite, sensor, and weather inputs, but sampled code does not establish all provider-level calls or frontend wiring. Cesium worker bundles are grouped as visualization runtime assets; their internal relationships are not expanded.

Main entry points: [`web/src/app/page.tsx`](https://github.com/pragatisource08/air-action/blob/main/web/src/app/page.tsx) (Air Quality UI), [`api/data_sources.py`](https://github.com/pragatisource08/air-action/blob/main/api/data_sources.py) (Data Fusion), [`api/main.py`](https://github.com/pragatisource08/air-action/blob/main/api/main.py) (FastAPI Endpoints), [`web/src/components/CesiumGlobe.tsx`](https://github.com/pragatisource08/air-action/blob/main/web/src/components/CesiumGlobe.tsx) (Interactive Globe)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_webpage["Air Quality UI<br/>[page.tsx]"]
  node_location["Location Search<br/>[LocationSearch.tsx]"]
  node_forecastchart["Forecast Chart<br/>[ForecastChart.tsx]"]
  node_detailoverlay["Map Details"]
  node_timezone["Timezone Utilities<br/>[timezone.ts]"]
  node_geocoding["Geocoding Utilities<br/>[geocoding.ts]"]
end

subgraph group_visualization["Geospatial Visualization"]
  node_map["Interactive Globe<br/>[CesiumGlobe.tsx]"]
  node_cesium["Cesium Workers"]
end

subgraph group_service["API Services"]
  node_proxy["Forecast Proxy<br/>[route.ts]"]
  node_backend["FastAPI Endpoints<br/>[main.py]"]
end

subgraph group_data["Data Integration"]
  node_fusion["Data Fusion<br/>[data_sources.py]"]
  node_tempo(("NASA TEMPO"))
  node_openaq(("OpenAQ"))
  node_airnow(("AirNow"))
  node_weather(("Weather Service"))
end

node_user(("User"))

node_user -->|"uses"| node_webpage
node_webpage -.->|"shows globe"| node_map
node_webpage -.->|"offers search"| node_location
node_user -->|"selects location"| node_map
node_map -->|"renders with"| node_cesium
node_webpage -.->|"requests forecast"| node_proxy
node_proxy -->|"proxies forecast"| node_backend
node_backend -->|"requests data"| node_fusion
node_fusion -.->|"fetches observations"| node_tempo
node_fusion -.->|"fetches measurements"| node_openaq
node_fusion -.->|"fetches reports"| node_airnow
node_fusion -.->|"fetches conditions"| node_weather
node_webpage -.->|"presents forecast"| node_forecastchart
node_detailoverlay -->|"renders"| node_forecastchart
node_webpage -.->|"shows details"| node_detailoverlay
node_location -.->|"resolves places"| node_geocoding
node_webpage -.->|"formats local time"| node_timezone
node_backend -.->|"serves AQI and history"| node_user

click node_webpage "https://github.com/pragatisource08/air-action/blob/main/web/src/app/page.tsx"
click node_location "https://github.com/pragatisource08/air-action/blob/main/web/src/components/LocationSearch.tsx"
click node_map "https://github.com/pragatisource08/air-action/blob/main/web/src/components/CesiumGlobe.tsx"
click node_cesium "https://github.com/pragatisource08/air-action/tree/main/web/public/cesium/Workers"
click node_forecastchart "https://github.com/pragatisource08/air-action/blob/main/web/src/components/ForecastChart.tsx"
click node_detailoverlay "https://github.com/pragatisource08/air-action/blob/main/web/src/components/MaximizedMapOverlay.tsx"
click node_timezone "https://github.com/pragatisource08/air-action/blob/main/web/src/utils/timezone.ts"
click node_geocoding "https://github.com/pragatisource08/air-action/blob/main/web/src/utils/geocoding.ts"
click node_proxy "https://github.com/pragatisource08/air-action/blob/main/web/src/app/api/forecast/route.ts"
click node_backend "https://github.com/pragatisource08/air-action/blob/main/api/main.py"
click node_fusion "https://github.com/pragatisource08/air-action/blob/main/api/data_sources.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_webpage,node_location,node_forecastchart,node_detailoverlay,node_timezone,node_geocoding,node_user toneBlue
class node_map,node_cesium toneAmber
class node_proxy,node_backend toneMint
class node_fusion,node_tempo,node_openaq,node_airnow,node_weather toneRose
```

## Components

### User Experience

- [Air Quality UI](https://github.com/pragatisource08/air-action/blob/main/web/src/app/page.tsx): `web/src/app/page.tsx`
- [Location Search](https://github.com/pragatisource08/air-action/blob/main/web/src/components/LocationSearch.tsx): `web/src/components/LocationSearch.tsx`
- [Forecast Chart](https://github.com/pragatisource08/air-action/blob/main/web/src/components/ForecastChart.tsx): `web/src/components/ForecastChart.tsx`
- [Map Details](https://github.com/pragatisource08/air-action/blob/main/web/src/components/MaximizedMapOverlay.tsx): `web/src/components/MaximizedMapOverlay.tsx`
- [Timezone Utilities](https://github.com/pragatisource08/air-action/blob/main/web/src/utils/timezone.ts): `web/src/utils/timezone.ts`
- [Geocoding Utilities](https://github.com/pragatisource08/air-action/blob/main/web/src/utils/geocoding.ts): `web/src/utils/geocoding.ts`

### Geospatial Visualization

- [Interactive Globe](https://github.com/pragatisource08/air-action/blob/main/web/src/components/CesiumGlobe.tsx): `web/src/components/CesiumGlobe.tsx`
- [Cesium Workers](https://github.com/pragatisource08/air-action/tree/main/web/public/cesium/Workers): `web/public/cesium/Workers`

### API Services

- [Forecast Proxy](https://github.com/pragatisource08/air-action/blob/main/web/src/app/api/forecast/route.ts): `web/src/app/api/forecast/route.ts`
- [FastAPI Endpoints](https://github.com/pragatisource08/air-action/blob/main/api/main.py): `api/main.py`

### Data Integration

- [Data Fusion](https://github.com/pragatisource08/air-action/blob/main/api/data_sources.py): `api/data_sources.py`
- **NASA TEMPO**
- **OpenAQ**
- **AirNow**
- **Weather Service**

### Other components

- **User**

## Connections

- User → Air Quality UI: uses (evidence: `README.md`)
- Air Quality UI → Interactive Globe: shows globe
- Air Quality UI → Location Search: offers search
- User → Interactive Globe: selects location (evidence: `README.md`)
- Interactive Globe → Cesium Workers: renders with (evidence: `web/public/cesium/Workers/createTaskProcessorWorker.js`)
- Air Quality UI → Forecast Proxy: requests forecast
- Forecast Proxy → FastAPI Endpoints: proxies forecast (evidence: `README.md`)
- FastAPI Endpoints → Data Fusion: requests data (evidence: `api/main.py`)
- Data Fusion → NASA TEMPO: fetches observations (evidence: `README.md`)
- Data Fusion → OpenAQ: fetches measurements (evidence: `README.md`)
- Data Fusion → AirNow: fetches reports (evidence: `api/data_sources.py`)
- Data Fusion → Weather Service: fetches conditions (evidence: `README.md`)
- Air Quality UI → Forecast Chart: presents forecast
- Map Details → Forecast Chart: renders (evidence: `web/src/components/MaximizedMapOverlay.tsx`)
- Air Quality UI → Map Details: shows details
- Location Search → Geocoding Utilities: resolves places
- Air Quality UI → Timezone Utilities: formats local time
- FastAPI Endpoints → User: serves AQI and history (evidence: `README.md`)
