kengnidoriane/CleanCity-AI

AI-powered waste management platform connecting citizens, collection companies, and municipalities to solve Africa's urban waste crisis. # 🌿 Clean City AI **AI-Powered Waste Management Platform for African Cities** Connecting citizens, waste collection companies, and municipal authorities through smart technology to solve Africa's urban waste crisis. > BeOrchid Africa Developers Hackathon — Built by FOSSO KENGNI Doriane --- ## 🌟 Overview Clean City AI is a multi-platform system that transforms how African cities handle waste. 60% of urban waste in Africa remains uncollected, causing 500,000 deaths annually. Our platform addresses this through three interconnected applications: | Platform | Users | Description | |---|---|---| | 📱 **Mobile App** | Citizens | Report waste with photo + GPS, track collection in real time | | 🏢 **Company Dashboard** | Waste collectors | AI-optimized routes, fleet tracking, performance stats | | 🏛️ **Municipal Dashboard** | City authorities | City-wide KPIs, hotspot maps, audit trail, monthly reports | **Key results:** 40% fuel savings · 70% waste reduction · Full operational transparency --- ## 🏗️ Architecture ``` cleancity-ai/ ├── mobile/ # React Native (Expo) — Citizen app ├── backend/ # Node.js + Express + Prisma — Main API ├── ai-service/ # Python + FastAPI + OR-Tools — Route optimization ├── web-company/ # React + Vite + Tailwind — Company dashboard ├── web-municipal/ # React + Vite + Tailwind — Municipal dashboard └── .github/ └── workflows/ # CI/CD pipelines (4 services) ``` ### Services | Service | Tech | Port | |---|---|---| | Backend API | Node.js + Express + Prisma | 3000 | | AI Service | Python + FastAPI + OR-Tools | 8000 | | Company Dashboard | React + Vite + Nginx | 4000 | | Municipal Dashboard | React + Vite + Nginx | 4001 | | Mobile App | React Native (Expo) | — | | Database | PostgreSQL 16 | 5432 | --- ## ⚡ Quick Start ### Option A — Docker (recommended) **Prerequisites:** Docker + Docker Compose ```bash git clone github.com cd CleanCity-AI cp .env.example .env # …