autanuhu/nepa-watch-legacy

Real-time power outage monitoring and reporting platform for Nigeria. # NEPA-Watch **Crowdsourced power outage tracking & prediction for the Nigerian grid.** NEPA-Watch lets users report power outages/restorations in their area (via web or WhatsApp), builds a live outage map, and uses historical patterns to predict when power is likely to return or go out next — helping households and SMEs plan generator/inverter use and reduce fuel costs. ## Why this exists Grid reliability data in Nigeria is fragmented and mostly anecdotal ("light don go", "up NEPA"). There's no public, structured, area-level dataset or prediction tool for outage patterns. NEPA-Watch aims to be that — open source, community-driven, and built for real Nigerian conditions (feeder-level granularity, DisCo boundaries, generator dependency). ## Core features (MVP) - [ ] Report outage/restoration by location (area, feeder/DisCo if known) - [ ] Live map of reported outages (Leaflet/Mapbox) - [ ] Historical outage log per area - [ ] Basic prediction: "likely outage window" per area based on past patterns - [ ] WhatsApp Business bot for reporting (no app install needed — critical for adoption) - [ ] Public API for outage data ## Tech stack | Layer | Choice | Why | |---|---|---| | Backend | FastAPI (Python) | Fast to build, good for data/ML work later | | Database | PostgreSQL + PostGIS | Geo-queries for area/feeder mapping | | Frontend | Next.js + Tailwind | Fast, SEO-friendly map dashboard | | Bot | WhatsApp Business Cloud API | Lowest-friction reporting channel in Nigeria | | Prediction (v2) | scikit-learn / Prophet | Time-series outage prediction per area | | Hosting | Railway/Render (backend), Vercel (frontend) | Free/cheap tiers to start | ## Project structure ``` nepa-watch/ ├── backend/ # FastAPI app: reports API, outage data, auth │ └── app/ ├── frontend/ # Next.js dashboard + map ├── data/ # Schema docs, seed data, DisCo/feeder reference data ├── docs/ # Architecture notes, roadmap └── README.md ``` ## Roadmap 1 …