ayodeji07/nigeria-disease-surveillance

# 🏥 Nigeria Disease Surveillance Dashboard > End-to-end health data engineering platform tracking **5 diseases** across **37 states** (2015–present) --- ## 🔴 Live Demo | Service | URL | |---------|-----| | 📊 Dashboard | Open Streamlit App | | ⚡ API (Swagger) | Open API Docs | | 🔗 GitHub | View Source | --- ## 📌 Key Findings - Cholera burden peaks in **June–September** (rainy season) — significant seasonal pattern confirmed by Kruskal-Wallis test (p < 0.01) - **Borno, Bauchi, and Kebbi** consistently account for 60%+ of annual Meningitis burden - Spatial autocorrelation (Moran's I) confirms Northern states cluster for Meningitis while Southern states cluster for Cholera - 8 states flagged CRITICAL for facility accessibility — high disease burden with fewer than 0.5 facilities per 100,000 population - Lassa Fever cases surged **330×** in four years (3 confirmed in 2021 → 992 in 2024), with a 24.1% national Case Fatality Rate --- ## 🗂️ Project Structure ``` nigeria-disease-surveillance/ ├── data/ │ ├── raw/ # Downloaded source files (gitignored) │ ├── processed/ # Cleaned outputs (gitignored) │ └── shapefiles/ # GRID3 boundary files (gitignored) ├── src/ │ ├── utils/ # config, logger, state_maps │ ├── etl/ # extract, transform, validate, load, pipeline │ ├── db/ # connection, models, repository │ ├── analysis/ # statistics, geospatial, forecasting │ └── api/ # FastAPI app, routes, schemas, auth ├── dashboard/ │ ├── app.py # Streamlit entry point │ ├── api_client.py # HTTP client for dashboard → API │ └── _pages/ # overview, state_view, geo_atlas, forecasting, admin ├── reports/ │ ├── policy_brief.md # Data-driven policy brief │ └── screenshots/ # Dashboard screenshots ├── sql/ │ ├── schema.sql # PostgreSQL + PostGIS schem …