How sumedha-t/urban-air-quality-intelligence works
The platform presents air-quality intelligence through administrator and citizen portals, while its backend collects AQI, weather, and traffic data, fuses snapshots, and exposes collection and history routes. The UI also offers forecast, attribution, intervention-priority, climate, health, and citizen-report experiences; the README describes several AI capabilities as planned, and the frontend API currently selects mock data. Edges reflect shown calls, imports listed in the SOURCE INDEX, or README claims; unsampled UI internals and planned backend agents are not asserted as implemented.
Main entry points: data_collectors Source collectors · App.jsx Role router · routes API routes · data_fusion.py Data fusion agent
Components 24
User portals
- Role router
frontend/src/App.jsx - Portal layout
frontend/src/components/Layout/MainLayout.jsx - Admin workspace
frontend/src/pages/Admin - Citizen workspace
frontend/src/pages/Citizen - Interactive map
frontend/src/components/Map/InteractiveMap.jsx - Forecast views
frontend/src/pages/Admin/Forecast.jsx - Priority planning
frontend/src/pages/Admin/PriorityDashboard.jsx - Climate analysis
frontend/src/pages/Citizen/ClimateAnalysis.jsx - Health assistant
frontend/src/pages/Citizen/HealthAssistant.jsx - Citizen reports
frontend/src/pages/Citizen/ReportPage.jsx - Frontend data service
frontend/src/services/api.js - Mock intelligence data
frontend/src/services/mockData.js
API and collection
- FastAPI entry
backend/main.py - API routes
backend/routes - Data fusion agent
backend/agents/data_fusion.py - Collection scheduler
backend/scheduler/scheduler.py - Source collectors
backend/data_collectors - HTTP client
backend/utils/http_client.py - Runtime settings
backend/config/settings.py
Persistence
- Data repositories
backend/repositories - MongoDB manager
backend/database/mongodb.py
External sources
- OpenWeather APIs
- TomTom Traffic API
Other components
- Portal user
Connections 24
- Portal user → Role router: uses
- Role router → Frontend data service: loads locations
frontend/src/App.jsx - Role router → Portal layout: renders
frontend/src/App.jsx - Role router → Admin workspace: routes admin
frontend/src/App.jsx - Role router → Citizen workspace: routes citizen
frontend/src/App.jsx - Admin workspace → Frontend data service: requests data
frontend/src/pages/Admin/Forecast.jsx - Citizen workspace → Frontend data service: requests data
frontend/src/pages/Citizen/ClimateAnalysis.jsx - Admin workspace → Interactive map: renders map
frontend/src/pages/Admin/MapGIS.jsx - Frontend data service → Mock intelligence data: uses mock data
frontend/src/services/api.js - FastAPI entry → API routes: registers routes
backend/main.py - FastAPI entry → MongoDB manager: connects lifecycle
backend/main.py - FastAPI entry → Collection scheduler: starts scheduler
backend/main.py - Collection scheduler → Data fusion agent: invokes fusion
backend/scheduler/scheduler.py - Data fusion agent → Source collectors: collects sources
backend/agents/data_fusion.py - Data fusion agent → Data repositories: saves snapshot
backend/agents/data_fusion.py - Source collectors → HTTP client: fetches JSON
backend/data_collectors/weather.py - Source collectors → Data repositories: saves readings
backend/data_collectors/weather.py - Source collectors → Runtime settings: reads credentials
backend/data_collectors/weather.py - Source collectors → OpenWeather APIs: queries weather
backend/data_collectors/weather.py - Source collectors → TomTom Traffic API: queries traffic
backend/data_collectors/traffic.py - Data repositories → MongoDB manager: uses database
backend/repositories/base_repository.py - API routes → Source collectors: serves source calls
backend/routes/aqi.py - API routes → Data fusion agent: serves fusion call
backend/routes/fusion.py - API routes → Data repositories: reads history
backend/routes/history.py