🌍 SmartCityMek is a citizen-focused web/mobile platform that empowers residents of Meknès to report urban issues, manage waste, monitor energy/water usage, and learn sustainable practices.
# đź§ SmartCityMek
A smart citizen platform for the city of Meknès (Morocco) that enables users to:
- 📸 Report urban issues (waste, water leaks, lighting, road damage)
- ♻️ Track and manage household waste
- đź’§ Monitor water and electricity consumption
- 🎓 Learn eco-friendly habits via interactive educational content
- 📊 Provide authorities with a centralized dashboard for better urban planning
## 🚀 Features
### 👨‍👩‍👧‍👦 For Citizens
- Report city problems with photos & geolocation
- Track status of their reports (pending, in progress, resolved)
- View charts of water/electricity usage
- Participate in gamified educational content (quizzes, eco-tips)
- Receive personalized eco-advice
### 🛠️ For Admins (City Authorities)
- View and filter reports on a map
- Change status of incidents (moderation workflow)
- Access consumption stats by neighborhood
- Detect high-consumption or problematic areas
## 📱 Tech Stack
| Layer | Tech Used |
|------------------|----------------------------------|
| Frontend (Web) | React.js + Tailwind CSS |
| Backend | Node.js + Express.js |
| Database | MongoDB Atlas |
| Auth | JWT Auth |
| Image Upload | Cloudinary |
| Maps | Leaflet.js |
| Data Viz | Recharts |
| AI | TensorFlow.js, Teachable Machine |
## đź§Ş Example Modules
- `signalements/` → Urban reporting (form + map)
- `waste/` → Waste tracking, tips, and educational content
- `consumption/` → Water/Energy data input + prediction
- `education/` → Quizzes and gamified learning
- `admin/` → Municipality dashboard and moderation tools
## 📦 Setup Instructions
```bash
# 1. Clone the repository
git clone
github.com
# 2. Install dependencies
cd smartcity-meknes
npm install
# 3. Start backend
cd server
npm install …