Chimereya/naija-flood

NaijaFlood is a web application that allows Nigerians to check the flood risk of any location # NaijaFlood – Nigerian Flood Risk Checker(Experimental) NaijaFlood is a web application that allows Nigerians to check the flood risk of any location. Using authoritative flood‑affected area data from NEMA (2022) and geospatial analysis, it provides a simple risk rating (High/Moderate/Low) along with some safety tips. ## The Problem Flooding in Nigeria displaces millions and destroys property every year, yet there is no easy‑to‑use public tool for individuals to assess their flood risk. Existing data is locked in technical reports and GIS files. ## The Solution NaijaFlood bridges that gap by: - Accepting any Nigerian address or LGA name. - Geocoding the location (via Nominatim + local LGA centroids). - Querying a PostGIS database of flood‑affected areas. - Returning a clear risk level and actionable safety advice. ## Tech Stack - **Backend:** Django + GeoDjango - **Database:** PostgreSQL + PostGIS - **Geocoding:** Nominatim (OSM) + local LGA centroids from GitHub - **Flood Data:** NEMA 2022 flood‑affected LGAs shapefile (imported into PostGIS) - **Frontend:** Bootstrap 5 ## Features (MVP) - [x] Search by address or LGA - [x] Geocode with fallback to LGA centroids - [x] Flood risk assessment using actual flood‑affected polygons - [x] User accounts (save locations) - [x] Safety tips based on risk level ## Challenges Comming soon ## 📊 Data Sources - **LGA centroids:** temikeezy/nigeria-geojson-data (MIT license) - **Flood‑affected areas:** NEMA 2022 shapefile via HDX – `2022_Flood-affected_Areas_2022_by_LGA_as_of_8th_August.shp` (public domain/CC BY) - **Geocoding:** OpenStreetMap Nominatim ## 📦 Installation ### Prerequisites - Python 3.10+ - PostgreSQL 14+ with PostGIS - GDAL, GEOS, Proj libraries ### Setup Setup instructions will be provided in a future update