billotiende-droid/Kajiado-AquaShield

A comprehensive real-time weather monitoring and flood alert system for the Kajiado region, featuring AI-powered risk assessment, SMS/webhook alert simulation, and bilingual (English/Swahili) interface. # Kajiado AquaShieldhttps App View ://github.com **Real-time flash-flood risk assessment and alert system for Kajiado County, Kenya.** Live weather data from Stormglass.io feeds a multi-factor risk engine that computes flood probability across five Kajiado sub-counties. Risk assessments are stored in SQLite, served via a FastAPI REST API, and displayed on a Next.js emergency operations dashboard with bilingual (English/Swahili) support. --- ## Architecture Overview ``` ┌─────────────────────┐ ┌──────────────────────────────────┐ ┌──────────────────┐ │ │ │ │ │ │ │ Stormglass.io API │────▶│ FastAPI Backend (Railway) │────▶│ SQLite Database │ │ (weather data) │ │ │ │ │ │ │ │ ┌────────────────────────────┐ │ ├──────────────────┤ └─────────────────────┘ │ │ weather_service.py │ │ │ weather_data │ │ │ ↳ async Stormglass client│ │ │ risk_assessments │ │ │ ↳ fallback → simulated │ │ │ sms_alerts │ │ └────────────────────────────┘ │ └──────────────────┘ │ │ │ ┌────────────────────────────┐ │ │ │ risk_engine.py │ │ │ │ ↳ rainfall/humidity/wind │ │ │ │ ↳ trend analysis │ │ │ │ ↳ risk_level → LOW- │ │ │ │ CRITICAL │ │ │ └────────────────────────────┘ │ │ │ │ ┌────────────────────────────┐ │ │ │ main.py (lifespan) │ │ │ │ ↳ init_database() │ │ │ │ ↳ seed_initial_data() │ │ │ │ ↳ background 5-min fetch │ │ │ └────────────────────────────┘ │ │ │ └──────┬───────────────────────────┘ │ │ REST API (JSON) │ ┌──────▼───────────────────────────┐ │ │ │ Next.js F …