NunyaHotor/ghana-sanitation-platform

Digital sanitation, reporting and enforcement system for Ghana # ghana-sanitation-platform Digital sanitation, reporting and enforcement system for Ghana # Ghana Sanitation Reporting & Enforcement Platform A civic-tech platform for **reporting sanitation offenses**, enabling **lawful enforcement**, and creating **sanitation employment** across Ghana. This project includes: - A mobile reporting app (Android / Flutter) - A USSD shortcode for feature phones - A backend for case management - An authority dashboard for Assemblies - Support for courts and enforcement officers ## 🌍 Problem Illegal dumping of waste, especially plastics and construction debris, harms public health, blocks drains, and increases flooding risk in Ghanaian cities. Local authorities lack scalable tools to monitor and enforce sanitation laws at community level. ## 💡 Solution The Ghana Sanitation Reporting & Enforcement Platform empowers citizens to: - Report sanitation violations via smartphone or USSD - Upload photo/video evidence with GPS and timestamp - Track case progress - Enable authorities to enforce penalties - Assign community service tasks - Create sanitation job opportunities ## 🚀 Project Status ### ✅ Phase 1: Backend Foundation - COMPLETE - Express.js/Node.js REST API with TypeORM - PostgreSQL database with 5 core entities - Authentication: OTP (mobile) + email/password (dashboard) - Report management with immutability - Case workflow state machine with audit trail - Incentive system (points for verified reports) - 15 API endpoints, fully tested **See**: `backend/README.md`, `backend/API.md`, `backend/IMPLEMENTATION.md` ### 🚀 Phase 2: Mobile App - IN PROGRESS - Flutter Android/iOS app - Hive local database + offline queue - GPS + camera integration - OTP login (SMS verification) - Real-time case tracking - Offline-first architecture - Auto-sync when online **See**: `mobile/README.md` **See**: `mobile/README.md` (coming soon) ### ⏳ Phase 3: Authority Dashboard & USSD - PENDING - React/Vue dashboard for case review - USSD menu handle …