Smart Flood Monitoring System for Morocco World Cup 2030 - AI-first IoT platform with real-time predictions
# 🌊 Morocco Flood Monitoring System
**Système intelligent de surveillance des inondations pour la Coupe du Monde 2030 au Maroc**
---
## 📋 Description
Système de surveillance en temps réel des inondations conçu pour protéger les infrastructures et la population lors de la Coupe du Monde 2030 au Maroc. Le système combine IoT, IA prédictive, et visualisation cartographique pour une gestion proactive des risques d'inondation.
> **Version 1.1.0** : Toutes les dépendances ont été mises à jour vers leurs dernières versions stables (décembre 2024). Voir CHANGELOG.md pour les détails.
### 🎯 Objectifs
- **Prévention** : Anticiper les inondations avec des prédictions IA
- **Réaction rapide** : Alertes en temps réel et contrôle automatisé des pompes
- **Visualisation** : Interface intuitive avec carte interactive
- **Scalabilité** : Architecture modulaire pour déploiement multi-villes
### ✨ Fonctionnalités principales
#### 🔮 Prédiction IA
- Modèle ML (RandomForest) entraîné sur données historiques
- Prédictions toutes les 5 minutes
- Niveaux de risque : Low, Medium, High
- Explications générées par OpenAI
#### 📡 IoT & MQTT
- Collecte temps réel via MQTT
- Support multi-capteurs (niveau d'eau, humidité, etc.)
- Buffers roulants pour agrégation
- Simulateur de capteurs inclus
#### 🗺️ Cartographie
- Carte interactive du Maroc (Leaflet + OpenStreetMap)
- Marqueurs colorés selon le niveau de risque
- Popups avec actions (informer, contrôler pompes)
#### 🎛️ Contrôle automatisé
- Activation/désactivation des pompes via MQTT
- Notifications par email (SMTP)
- Génération de rapports PDF (OpenAI)
#### 💻 Interface moderne
- Design minimal et professionnel (shadcn/ui)
- Grilles responsives (villes → capteurs → détails)
- Setup Wizard pour configuration initiale
- Pas d'authentification (démo locale)
---
## 🏗️ Architecture
### Stack technique
**Backend**
- **Framework** : Flask 3.1 + FastAPI
- **Base de données** : SQLite (dev) / PostgreSQL (prod)
- **MQTT** : Paho MQ …