YonSci/eonet-east-africa

# EONET East Africa Natural Events Dashboard A near real-time natural event monitoring dashboard for the **East Africa** region, powered by the NASA EONET v3 API. Built at ILRI as a companion to climate services work in the region. --- ## What it does - Monitors **8 natural event categories** across East Africa in near real-time: Wildfires, Severe Storms, Floods, Drought, Volcanoes, Dust & Haze, Earthquakes, Landslides - Filters EONET data to the East Africa bounding box (`21.8 E -- 51.4 E`, `11.7 S -- 22.0 N`) - Displays events on an interactive map with category icons and open/closed status - Auto-refreshes every 15 minutes via a FastAPI proxy backend - Exportable to CSV and GeoJSON --- ## Project structure ``` eonet-east-africa/ | +-- backend/ FastAPI proxy + EONET client | +-- main.py App entry point, lifespan, scheduler | +-- config.py Settings loaded from .env | +-- eonet_client.py EONET API client, caching, diff detection | +-- eonet_api/ | +-- events.py GET /events /events/geojson /summary /status | +-- frontend/ React 18 + Vite dashboard (Phase 2+) | +-- src/ | +-- api/ TanStack Query hooks | +-- components/ Map, event list, filter sidebar, charts | +-- store/ Zustand global state | +-- scripts/ | +-- validate_eonet.py Phase 1 standalone validation script | +-- data/ GeoJSON snapshots (gitignored) +-- docker/ Docker Compose setup +-- references/ API docs, bug log, layer catalogue +-- .github/workflows/ GitHub Pages CI/CD +-- requirements.txt +-- .env.example ``` --- ## Quick start ### 1. Clone and set up Python environment ```bash git clone github.com cd eonet-east-africa # Create virtual environment python -m venv .venv # Activate (Windows) .venv\Scripts\activate # Activate (macOS / …