Ejyke90/naija-conflict-tracker

# Nigeria Conflict Tracker A data-driven platform to track, analyze, and forecast conflict/violence in Nigeria at state, LGA, and community levels. ## Platform Overview **Mission:** Enable citizens, policymakers, and researchers to make informed decisions through real-time conflict tracking, predictive analytics, and geospatial visualization. ### Key Features - Real-time conflict tracking with geospatial visualization - Predictive analytics for early warning - Gender-disaggregated data analysis - Poverty-conflict correlation analysis - Social media chatter monitoring ## Architecture ### Tech Stack - **Frontend:** Next.js 14, React, Tailwind CSS, Mapbox GL JS - **Backend:** FastAPI, Python, PostgreSQL + PostGIS - **ML/AI:** scikit-learn, Prophet, spaCy - **Infrastructure:** Docker, Railway (backend), Vercel (frontend) ### Data Sources - News scraping (RSS feeds, major Nigerian news outlets) - Social media monitoring (Twitter/X API) - Official sources (Nigeria Police Force, NEMA) - NGO reports and external APIs (ACLED, GDELT) - Excel database import capabilities ## Project Structure ``` naija-conflict-tracker/ ├── backend/ # FastAPI Python backend │ ├── app/ │ │ ├── api/ # API endpoints │ │ ├── models/ # Database models │ │ ├── services/ # Business logic │ │ └── main.py # FastAPI app │ ├── requirements.txt │ └── Dockerfile ├── frontend/ # Next.js frontend │ ├── components/ # React components │ ├── pages/ # Next.js pages │ ├── styles/ # CSS/Tailwind │ └── package.json ├── database/ # Database schemas │ ├── migrations/ # Alembic migrations │ └── schema.sql # Initial schema ├── scripts/ # Utility scripts ├── docs/ # Documentation ├── docker-compose.yml # Local development └── railway.toml # Railway deployment config ``` ## Quick Start ### Prerequisites - Docker a …