
# Sync City: Civic Infrastructure Platform **Sync City** is a crowdsourced app bridging the gap between citizens and municipalities. It empowers residents to report and monitor infrastructure issues (e.g., potholes, leaks, broken streetlights), providing local governments with pre-validated data to optimize repairs. ## Key Features * **Dynamic Dashboard:** View real-time stats on pending and resolved issues alongside a live activity feed. Admins can toggle issue states with instantaneous UI updates. * **Interactive Mapping:** Displays color-coded pins based on severity. Features deep zoom (up to 22.0), dynamic pin clustering for high-density areas, and seamless Google Maps redirection. * **Gemini AI Reporting:** Submitting an issue takes under a minute. Powered by the **Gemini Vision API**, the system analyzes uploaded photos in real-time. It validates civic context (strictly blocking selfies, documents, or unrelated images), auto-categorizes the problem, and assesses severity. * **Community Verification:** Nearby users can confirm issues they witness in person. Meeting a community threshold upgrades a report to **VERIFIED**, preventing spam and ensuring data accuracy. * **Gamification:** Users earn XP, level up, and unlock achievements (like *Pothole Patrol* or *Eco Warrior*) for reporting and verifying, incentivizing active civic participation. ## Technology Stack ### Frontend (Flutter) * **Framework:** Cross-platform Flutter SDK (iOS, Android, Web) with ResponsiveBuilder. * **State & Routing:** **Riverpod** for declarative state management; **GoRouter** for persistent bottom navigation. * **Mapping:** flutter_map styled with CartoDB Voyager and Dark themes. ### Backend & AI (Python) * **API & Database:** **FastAPI** for asynchronous REST endpoints, backed by a **PostgreSQL** database via SQLAlchemy ORM. * **AI Vision:** OpenRouter linked to **Gemini 2.5 Flash** for high-speed, accurate image validation and automated categorization.
13 Jul 2026