How pragatisource08/air-action works
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: page.tsx Air Quality UI · data_sources.py Data Fusion · main.py FastAPI Endpoints · CesiumGlobe.tsx Interactive Globe
Components 16
User Experience
- Air Quality UI
web/src/app/page.tsx - Location Search
web/src/components/LocationSearch.tsx - Forecast Chart
web/src/components/ForecastChart.tsx - Map Details
web/src/components/MaximizedMapOverlay.tsx - Timezone Utilities
web/src/utils/timezone.ts - Geocoding Utilities
web/src/utils/geocoding.ts
Geospatial Visualization
- Interactive Globe
web/src/components/CesiumGlobe.tsx - Cesium Workers
web/public/cesium/Workers
API Services
- Forecast Proxy
web/src/app/api/forecast/route.ts - FastAPI Endpoints
api/main.py
Data Integration
- Data Fusion
api/data_sources.py - NASA TEMPO
- OpenAQ
- AirNow
- Weather Service
Other components
- User
Connections 18
- User → Air Quality UI: uses
README.md - Air Quality UI → Interactive Globe: shows globe
- Air Quality UI → Location Search: offers search
- User → Interactive Globe: selects location
README.md - Interactive Globe → Cesium Workers: renders with
web/public/cesium/Workers/createTaskProcessorWorker.js - Air Quality UI → Forecast Proxy: requests forecast
- Forecast Proxy → FastAPI Endpoints: proxies forecast
README.md - FastAPI Endpoints → Data Fusion: requests data
api/main.py - Data Fusion → NASA TEMPO: fetches observations
README.md - Data Fusion → OpenAQ: fetches measurements
README.md - Data Fusion → AirNow: fetches reports
api/data_sources.py - Data Fusion → Weather Service: fetches conditions
README.md - Air Quality UI → Forecast Chart: presents forecast
- Map Details → Forecast Chart: renders
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
README.md