Fidele012/Temba-Digital-Bridge-USSD-Web-app-platform

Bridge the gap between water service providers and communities # Temba Digital Bridge > A bilingual (English / Kinyarwanda) civic-tech platform that connects Rwandan communities to water service providers through a responsive web interface and a USSD feature-phone channel — so every citizen, regardless of smartphone access, can report water issues, book appointments, and track resolutions in real time. --- > **GitHub Repository** > **Live Frontend** > **Live API Docs** --- ## Table of Contents 1. Project Description 2. Functional Requirements 3. Non-Functional Requirements 4. Key Features 5. Panel Feedback & How We Responded 6. Trust & Authenticity Framework — MSVF 7. Community Ambassadors 8. Anti-Spam & False Submission Protections 9. System Architecture 10. Technology Stack 11. Demo Video 12. Testing 13. Designs 14. How to Run the Project — Step by Step - Quick Start — 4 Commands (Docker) - Prerequisites - Clone the Repository - Backend Setup - Frontend Setup - Africa's Talking USSD Setup - Verify Everything Is Working - Common Issues & Fixes 15. Test Accounts 16. Environment Variables 17. Deployment Plan 18. API Reference 19. Project Structure 20. Database Schema --- ## 1. Project Description ### Problem Statement Access to clean water is a fundamental human right, yet millions of Rwandans still face daily challenges with water supply disruption, pipe bursts, contamination, and billing errors. The gap between affected communities and the water service providers responsible for resolving those issues is wide — residents have no reliable, structured way to report problems, track progress, or hold providers accountable. Meanwhile, providers lack visibility into their service quality and response times. This problem is acute in Karangazi Sector, Mbale Cell, Nyagatare District, Rwanda's Eastern Province, where 60% of households report regular water infrastructure failures (NISR, 2025), yet complaints relied on informal escalation through local leaders with no tracking, acknowledgement, or accountability mechani …