realEdwinJ/CityCare

Civic reporting & legislative engagement platform for Windhoek, Namibia. Citizens report municipal issues with photo + GPS, AI triage, duplicate merging, law ratings, ministry suggestions, admin dashboard & public live map. Built for the AWS User Group Windhoek 'For The People' hackathon. # CityCare A civic reporting & legislative engagement platform for Windhoek, Namibia. Built for the AWS User Group Windhoek **"For The People"** hackathon. Citizens report municipal issues (potholes, water leaks, power outages, etc.) with a photo and GPS location; an **AI automatically triages each report as Critical / Medium / Light**; duplicate reports of the same problem **merge into one ticket** with a "N citizens reported this" counter; and citizens **track the government's progress** (Received → Reviewed → Resolved). The same app lets people **rate proposed laws**, **send suggestions to ministries**, and **reach emergency services**. City officials work incoming reports from a **web admin dashboard**, and anyone can watch the city on a **public live map**. ## Features - 📱 **Mobile app** (Expo / React Native) — report issues with photo + GPS, live map, rate laws, send ministry suggestions, one-tap **SOS** - 🤖 **AI triage** — every report is classified **Critical / Medium / Light** by a rule engine with an optional Google Gemini refinement layer (graceful fallback) - 🔁 **Duplicate merging** — reports of the same problem cluster into one ticket with a "N citizens reported this" counter (haversine distance) - 🏛️ **Civic engagement** — rate proposed laws, send suggestions to ministries - 🖥️ **Admin dashboard** — severity-sorted triage queue with status workflow (Received → Reviewed → Resolved) - 🗺️ **Public live map** — real Leaflet map, severity-colored pins, no login ## Project documentation - Design brief — the concept and scope - Hackathon plan — build plan and timeline - Demo script — step-by-step demo walkthrough - Deployment runbook — full AWS EC2 setup ## Contents - Architecture - Project structure - Tech stack - Quick start (local) - Configuration - Running the mobile app - Web surfaces - Deployment to AWS EC2 - API reference - Troubleshooting - Contributing - License --- ## Architecture ``` ┌────────────────────┐ ┌─────────────────── …