Rendered architecture

End-to-end pollution response architecture

This is the browser version judges should see: citizen reports, sensors, satellite/weather ingestion, AI fusion, 24-hour forecasting, municipal dispatch, and proof-of-action reporting in one deployable flow.

1. Evidence Capture
Citizen Android / Web Smoke/dust photo, GPS, timestamp, Hindi/regional note, offline queue.
PMS7003 / SDS011 Low-cost PM2.5/PM10 readings with humidity and device-health metadata.
Satellite + Weather NASA FIRMS, Sentinel-5P, MODIS AOD, IMD/ERA5/Open-Meteo wind.
2. Google Cloud Ingestion
Cloud Run Civic API Receives citizen forms, validates location, stores metadata, emits event.
Pub/Sub Event Bus Streams reports, sensor readings, satellite priors, forecast jobs, dispatch updates.
Cloud Storage Stores original and privacy-blurred report photos.
3. AI Fusion
Vertex AI Vision Smoke/dust/cause classifier, haze proxy, EXIF confidence, duplicate risk.
Fusion Service Temporal decay, trust scoring, wind-aware interpolation, cross-source corroboration.
Cloud SQL + PostGIS Stores ward grid cells, evidence graph, hotspot states, and dispatch history.
4. Prediction + Decision
24-hour AQI Forecast XGBoost for hackathon, spatiotemporal GNN later; predicts peak AQI and spike window.
Hotspot State Machine Clear → Watch → Suspected → Confirmed → Mitigated.
Dispatch Optimizer Ranks mist cannons, cleanup crews, inspectors by ETA, severity, and exposed population.
5. Municipal Action
ICCC / Ward Dashboard Evidence cards, plume map, forecast, dispatch recommendation, SLA timer.
FCM / SMS / WhatsApp Alerts ward officers, solid-waste teams, water-mist units, enforcement teams.
Proof Loop + BigQuery Before/after PM, visual haze, action closure, impact reporting, repeat hotspot analytics.

Hotspot confirmation logic

A single citizen photo can create Watch, but Confirmed requires at least two independent source families and wind/geospatial plausibility.

  • Photo evidence: smoke, dust, haze, EXIF, duplicate risk.
  • Sensor evidence: corrected PM2.5/PM10 anomaly.
  • Satellite/fire prior: FIRMS thermal anomaly or regional aerosol prior.
  • Weather: downwind consistency and low-wind spike risk.

Deployment path

The hackathon site is static and deployed through GitHub Actions. A real city pilot keeps the same product flow and swaps simulated services for Google Cloud components.

  • Now: GitHub Pages prototype with deterministic demo data.
  • Pilot: Cloud Run, Pub/Sub, Cloud SQL/PostGIS, Cloud Storage, Vertex AI.
  • Scale: ICCC integration, municipal fleet routing, BigQuery impact reports.

Core data contracts

Citizen reportreport_id, user_hash, lat, lon, timestamp, media_uri, language, note
Image evidencesmoke_probability, haze_score, exif_confidence, duplicate_risk
Sensor readingsensor_id, raw_pm25, corrected_pm25, pm10, humidity, device_health
Hotspot cellstate, confidence, cause, forecast_peak_aqi, recommended_action