Ubongar/IOPHIN

Leveraging unsupervised machine learning to map and analyze poverty distribution across Nigeria and Sub-Saharan Africa. # IOPHIN — Poverty Hotspot Intelligence for Nigeria **Version 5.0** — April 2026 IOPHIN (Integrated Open Poverty Hotspot Intelligence Network) is a full-stack geospatial intelligence platform for identifying, monitoring, and forecasting poverty risk across all 774 Local Government Areas (LGAs) in Nigeria. ## What's New in v4.0 ### Core Features (Original v1.0) - Python pipeline for feature extraction and K-Means clustering from MPI and nightlight data - Simple Node.js API for hotspots and statistics - React dashboard with interactive choropleth map - Static CSV/GeoJSON output --- ## Recent test results & artifacts We recently validated the PostGIS + Redis caching strategy and captured test artifacts. Key files and artifacts: - **Caching validation report**: CACHING_VALIDATION_REPORT.md - **Quick reference**: CACHING_QUICK_REFERENCE.md - **Detailed testing guide**: POSTGIS_REDIS_TESTING_GUIDE.md - **Raw results & images**: `results/perf/` (example: results/perf/cache_stats.png, JMeter HTML: results/perf/jmeter_html_short/index.html) To regenerate the stats image locally: ```bash python scripts/generate_stats_image.py --input results/perf/redis_cache_test.json --output results/perf/cache_stats.png ``` Notes: - If you run tests locally, ensure `REDIS_URL` and `DATABASE_URL` (or `POSTGRES_URL`) are set in your environment or `server/.env`. - No code modifications are required to reproduce the tests; only service endpoints must be reachable. Embedded chart (generated): ### Added in v2.0 - PostgreSQL + PostGIS database with spatial indexes - Redis caching for API performance - JWT authentication with role-based access control (RBAC) - WebSocket real-time updates via Socket.IO - Expanded `/api/v1/*` route family - Anomaly detection and forecasting modules - Intervention tracking system - Alert subscription management (email + webhook) ### Added in v3.0 - 9 dashboard views (Map, Rankings, State Overview, Interventions, Seasonal, Budget, Reports, Alerts, Dat …