Interactive Web 3D digital twin of theRettba Lake in Senegal
# Lac Rose Digital Twin
Jumeau numérique 3D interactif du Lac Rose (Lake Retba), Sénégal - Simulation environnementale et d'extraction de sel.
## 🌊 À propos
Le **Lac Rose** (appelé *Lac Retba* localement) est un lac salé emblématique situé à 35 km de Dakar, au Sénégal. Il est célèbre pour sa couleur rose due à la présence de l'algue *Dunaliella salina* qui produit du bêta-carotène en réponse au stress salin.
Ce projet crée un **jumeau numérique** permettant de:
- Visualiser le lac en 3D avec un rendu réaliste
- Simuler l'impact du changement climatique
- Modéliser la croissance des algues et la coloration rose
- Analyser les scénarios d'extraction de sel
- Surveiller les données environnementales en temps réel
## 🛠️ Technologies
### Frontend
- **React 18** + TypeScript
- **Three.js** + React Three Fiber (3D)
- **Tailwind CSS** (styling)
- **Recharts** (graphiques)
- **Zustand** (state management)
- **Vite** (build tool)
### Backend
- **Fastify** (API server)
- **TypeScript**
- **WebSocket** (real-time)
- **PostgreSQL** + TimescaleDB (time-series data)
- **Redis** (caching)
## 🚀 Démarrage rapide
### Prérequis
- Node.js 20+
- Docker & Docker Compose
### Installation
```bash
# Cloner le projet
cd LacRose
# Installer les dépendances
npm install
# Démarrer l'infrastructure (PostgreSQL, Redis, MinIO)
docker-compose up -d
# Démarrer le backend
npm run dev:backend
# Dans un autre terminal, démarrer le frontend
npm run dev:frontend
```
Accédez à:
- Frontend:
localhost
- API:
localhost
### Développement sans Docker
```bash
# Backend uniquement (exige PostgreSQL et Redis)
cd backend
npm install
npm run dev
```
## 📊 Scénarios de Simulation
| Scénario | Description |
|----------|-------------|
| **État Actuel** | Conditions basées sur les données 2024 |
| **Sécheresse 2030** | -15% précipitations, +1.5°C |
| **Sécheresse Sévère 2050** | -30% précipitations, +2.5°C |
| **Inondation 2022** | +200% précipitations pendant 90 jours |
| ** …