Ml-gur/Civic-evidence-kenya

# 🇰🇪 Witness Kenya ### **Civic Evidence & Accountability Platform** **The national ledger for public infrastructure integrity and civic oversight.** Verified by citizens. Secured for the future. --- ## 📖 Table of Contents - About the Project - Key Features - Tech Stack - Architecture Overview - Getting Started - Prerequisites - Installation - Environment Variables - Database Setup - Project Structure - Contributing - Reporting Bugs - Suggesting Features - Development Workflow - Coding Standards - Roadmap - License - Acknowledgements --- ## 🌍 About the Project **Witness Kenya** is an open-source, mobile-first civic media platform that empowers Kenyan citizens to document, verify, and hold leaders accountable for the state of public infrastructure and services across all **47 counties**. Citizens can capture photo or video evidence of issues — from broken roads and dry water taps to crumbling school buildings — geotagged to their exact ward, constituency, and county. Every report is automatically linked to the responsible elected officials (MCA, MP, Governor, Senator), creating a transparent, crowd-sourced record that is difficult to ignore. The platform uses a **weighted trust-scoring system** where the community verifies or disputes each report, building a confidence score for every piece of evidence. This creates a credible, self-governing ledger that journalists, NGOs, and policy makers can rely on. > **"Accountability by design."** --- ## ✨ Key Features | Feature | Description | |---|---| | 📸 **Evidence Capture** | In-app camera to capture photos and videos with automatic GPS, timestamp, and metadata embedding | | 🗺️ **Interactive Map** | Leaflet-powered map showing all reports pinned across Kenya's 47 counties | | 🏛️ **Leader Accountability** | Browse Governors, MPs, and MCAs; every report is linked to responsible officials | | ✅ **Community Verification** | Citizens confirm or dispute reports with structured verification evidence | | 🔒 ** …