richardawe/Humanitarian-Intelligence-Platform-Nigeria

# 🇳🇬 Humanitarian Intelligence Platform (HIP) - Nigerian Edition **Data-Driven Crisis Response System** A real-time humanitarian intelligence platform for Nigeria, combining state-level vulnerability indicators with humanitarian data to optimize aid allocation and crisis response decision-making. ## 🚀 Quick Start ### Prerequisites - Node.js 18+ - npm or yarn ### Installation 1. Install all dependencies (root, backend, and frontend): ```bash npm run install-all ``` Or install separately: ```bash # Install root dependencies npm install # Install backend dependencies cd backend npm install # Install frontend dependencies cd ../frontend npm install ``` ### Running the Application From the root directory, run both backend and frontend: ```bash npm run dev ``` Or run separately: **Backend** (port 3001): ```bash cd backend npm run dev ``` **Frontend** (port 3000): ```bash cd frontend npm run dev ``` Then open localhost in your browser. ## 📊 Data Sources For detailed information about all data sources and update frequencies, see DATA_SOURCES_AND_UPDATES.md ### Summary: - **Exchange Rates**: `open.er-api.com` - Updates hourly, cached for 1 hour - **States & Population**: National Population Commission (2006 census, 2024 estimates) - Static data - **Humanitarian Indicators**: UNOCHA/WFP/UNHCR reports (2024) - Updated monthly/quarterly - **Food Inflation**: NBS (National Bureau of Statistics) - Updated monthly/quarterly - **Poverty Levels**: HDI (2023) / MPI (2018-2019) - Updated annually - **Conflict Intensity**: ACLED/UNOCHA - Updated weekly/monthly - **Infrastructure Quality**: HDI (UNDP 2023) - Updated annually **Current Cache Duration**: 1 hour for all cached endpoints ## 🎯 Features - ✅ Interactive map showing Nigerian states with risk indicators - ✅ Real-time humanitarian indicators (food insecurity, displacement) - ✅ State filtering and detailed state views - ✅ Vulnerability index calculations - ✅ State-level correlation analysis - ✅ Cri …