kengnidoriane/CleanCity-AI
Domain:
environment and energydigital infrastructureRecord type:
softwareproject
Creator:
ken
Host:
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
# …