Initial Cariflex project

- 40 FlexMeasures assets (10 PV, 10 Bat, 10 Chg, 10 EV) - Geolocated on Martinique - Documentation: architecture, deployment, concepts - Standards: Flex Ready, S2, OpenADR, EPEX SPOT - R&D tools: HAMLET, OPLEM, lemlab - Map patch: Mapbox -> OpenStreetMap
2026-06-07 22:19:29 -04:00
commit ffc08d0629
18 changed files with 1229 additions and 0 deletions
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -0,0 +1,90 @@
+# Cariflex - Documentation Complète
+
+## Architecture Globale
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                          CARIFLEX PLATFORM                               │
+│              Caribbean Flexibility — Martinique                         │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                          │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐              │
+│  │   DSO Layer  │    │  Market Layer │    │   R&D Layer  │              │
+│  │              │    │              │    │              │              │
+│  │ ENEDIS/RTE   │    │ Flex Ready®  │    │   OPLEM      │              │
+│  │ OpenADR 2.0b │    │ Aggregator   │    │   HAMLET     │              │
+│  │              │    │ API          │    │   lemlab     │              │
+│  └──────┬───────┘    └──────┬───────┘    └──────┬───────┘              │
+│         │                   │                   │                       │
+│  ┌──────▼───────────────────▼───────────────────▼───────┐              │
+│  │              FLEXMEASURES (Core RM)                   │              │
+│  │  ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐  │              │
+│  │  │Scheduling│ │Forecasting│ │ Reporting │ │  APIs   │  │              │
+│  │  └─────────┘ └──────────┘ └──────────┘ └─────────┘  │              │
+│  └───────────────────────┬───────────────────────────────┘              │
+│                          │                                              │
+│  ┌───────────────────────▼───────────────────────────────┐              │
+│  │                    IoT Layer                           │              │
+│  │  MQTT (Mosquitto/EMQX/BunkerM) → Telegraf → InfluxDB │              │
+│  └───────────────────────┬───────────────────────────────┘              │
+│                          │                                              │
+│  ┌───────────────────────▼───────────────────────────────┐              │
+│  │                    Assets (40)                          │              │
+│  │  10 PV (5kWc) │ 10 Battery (100kWh) │ 10 EVSE (22kW) │ 10 EV (75kWh)│
+│  └───────────────────────────────────────────────────────┘              │
+│                                                                          │
+│  ┌─────────────────────────────────────────────────────┐                │
+│  │              Visualization Layer                     │                │
+│  │  Grafana (supervision) │ Metabase (reporting)        │                │
+│  └─────────────────────────────────────────────────────┘                │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+## Standards Interopérabilité
+
+| Standard | Organisation | Usage | API |
+|----------|-------------|-------|-----|
+| **Flex Ready®** | GIMELEC/RTE/ENEDIS | Bâtiment ↔ Réseau | Aggregator + Supplier |
+| **IEC 62746-4** | IEC | Interfaces ressources côté demande | — |
+| **S2** | S2Standard.org | CEM/RM | WebSocket |
+| **OpenADR 2.0b** | OpenADR Alliance | Réponse à la demande | REST |
+| **OpenLEADR** | OpenLEADR | Passerelle OpenADR | Python lib |
+
+## Actifs Cariflex
+
+| Type | Nb | Capacité | Localisation |
+|------|-----|----------|--------------|
+| Panneau PV | 10 | 5 kWc | Fort-de-France, Lamentin, Schoelcher |
+| Batterie | 10 | 100 kWh | Saint-Joseph, Marin, Vauclin, Sainte-Marie |
+| Borne VE | 10 | 22 kW | Diamant, Trois-Ilets, Salée, François, Robert |
+| Véhicule Électrique | 10 | 75 kWh (V2G) | Lorrain, Robert, Basse-Pointe, Grand-Rivière, etc. |
+
+## Flux de Données
+
+```
+Capteurs IoT → MQTT → Telegraf → InfluxDB
+                              ↓
+                         FlexMeasures (scheduling/forecast)
+                              ↓
+                    ┌─────────┼─────────┐
+                    ↓         ↓         ↓
+                Grafana   Metabase   S2 CEM
+                (viz)     (report)   (DSO)
+```
+
+## Fichiers de Configuration
+
+| Fichier | Description |
+|---------|-------------|
+| `config/flexmeasures-config.cfg` | Config FlexMeasures Cariflex |
+| `config/map-init-patch.js` | Patch carte OSM |
+| `scripts/init_flexmeasures_db.py` | Création des assets |
+| `scripts/telegraf-cariflex.conf` | Config Telegraf MQTT→InfluxDB |
+
+## URLs
+
+| Service | URL |
+|---------|-----|
+| FlexMeasures | https://flexmeasures.digitribe.fr |
+| Grafana | https://grafana.digitribe.fr |
+| Metabase | https://metabase.digitribe.fr |
--- a/docs/concepts.md
+++ b/docs/concepts.md
@@ -0,0 +1,210 @@
+# Cariflex — Concepts Clé et État de l'Art
+
+> Documentation de référence pour le projet Cariflex — Agrégation et flexibilité énergétique
+
+## 1. Virtual Power Plant (VPP)
+
+### Définition
+Une **Centrale Virtuelle de Production (VPP)** est un réseau agrégé de ressources énergétiques décentralisées (DER) :
+- Panneaux photovoltaïques (PV)
+- Batteries de stockage
+- Éoliennes
+- Bornes de recharge véhicules électriques (EVSE)
+- Véhicules électriques (V2G)
+
+Connectées et gérées via un logiciel avancé pour fonctionner comme une **seule entité coordonnée**.
+
+### Rôle
+- **Flexibilité au réseau** : régulation de fréquence, réponse à la demande, trading d'énergie
+- **Stabilité du réseau** : maximisation de l'intégration des ENR
+- **Bénéfices économiques** : revenus pour les participants via les marchés de flexibilité
+- **Transition énergétique** : soutien à la décentralisation et à la durabilité
+
+### Composants clés
+1. **Engagement clients** : onboarding des propriétaires d'actifs (PV, batteries, EV)
+2. **Agrégation** : pooling des ressources distribuées
+3. **Optimisation** : dispatch intelligent via algorithmes
+4. **Marché** : participation aux marchés de flexibilité (frequency regulation, demand response, energy trading)
+5. **Monitoring** : supervision temps réel des actifs
+
+### Application Cariflex
+Cariflex agit comme un VPP qui agrège :
+- 10 installations PV (5 kWc chacune = 50 kWc total)
+- 10 batteries (100 kWh chacune = 1 MWh total)
+- 10 bornes EV (22 kW chacune = 220 kW total)
+- 10 véhicules électriques V2G (75 kWh chacun = 750 kWh total)
+
+**Capacité totale d'agrégation : ~50 kWc PV + 1,75 MWh stockage**
+
+## 2. Energy Aggregators in Flexibility Markets
+
+### Définition
+Un **agrégateur d'énergie** est un acteur qui regroupe la flexibilité de plusieurs petits consommateurs/producteurs pour la vendre sur les marchés de l'énergie.
+
+### Modèle économique
+- **Marché de capacité** : réservation de capacité de flexibilité
+- **Marché d'énergie** : vente d'énergie sur le spot (EPEX SPOT)
+- **Marché de services système** : régulation de fréquence (FCR, aFRR, mFRR)
+- **Demand Response** : réponse à la demande (effacement)
+
+### Types de flexibilité
+| Type | Description | Source |
+|------|-------------|--------|
+| **Montée (Up)** | Augmentation de production ou réduction de consommation | Batteries (décharge), PV (curtailment inversé), EV (charge réduite) |
+| **Descente (Down)** | Réduction de production ou augmentation de consommation | Batteries (charge), PV (curtailment), EV (charge augmentée) |
+
+### Application Cariflex
+En tant qu'agrégateur, Cariflex :
+1. Collecte la flexibilité disponible de ses 40 actifs
+2. Optimise le dispatch selon les signaux de prix et les demandes DSO
+3. Vend la flexibilité sur les marchés appropriés
+4. Rémunère les participants proportionnellement à leur contribution
+
+## 3. Flexibility Trading (EPEX SPOT)
+
+### Qu'est-ce que le trading de flexibilité ?
+Le trading de flexibilité consiste à acheter/ vendre de la capacité de modulation de consommation ou production sur les marchés de l'énergie.
+
+### Marchés EPEX SPOT (France)
+| Marché | Horizon | Produit | Rôle Cariflex |
+|--------|---------|---------|---------------|
+| **Day-ahead** | J-1 | Énergie par heure (MWh) | Optimisation schedule |
+| **Intraday** | H-1 à H-24 | Énergie 15min (MWh) | Ajustement en temps réel |
+| **Balancing** | Temps réel | Capacité (MW) | Réponse à la demande |
+
+Source : https://www.epexspot.com/en/marketdataservices
+
+### Application Cariflex
+| Marché | Horizon | Produit |
+|--------|---------|---------|
+| **Day-ahead** | J-1 | Énergie par heure (MWh) |
+| **Intraday** | H-1 à H-24 | Énergie par quart d'heure (MWh) |
+| **Balancing** | Temps réel | Capacité de réservation (MW) |
+
+### Mécanisme
+1. **Prévision** : FlexMeasures génère des prévisions de production/consommation
+2. **Offre** : Cariflex soumet des offres de flexibilité sur EPEX SPOT
+3. **Clearing** : Le marché détermine le prix et le volume
+4. **Exécution** : Les actifs ajustent leur opération selon le signal de marché
+
+### Application Cariflex
+- FlexMeasures génère les prévisions PV, consommation, stockage
+- Le S2 CEM reçoit les signaux de prix et les demandes DSO
+- Les actifs sont dispatchés pour maximiser les revenus de flexibilité
+
+## 4. Standards d'Interopérabilité
+
+| Standard | Organisation | Usage | APIs |
+|----------|-------------|-------|------|
+| **Flex Ready®** | GIMELEC/RTE/ENEDIS | Interopérabilité Bâtiment ↔ Réseau | Aggregator API, Supplier API |
+| **IEC 62746-4** | IEC | Interfaces ressources côté demande | — |
+| **S2** | S2Standard.org | Communication CEM/RM | WebSocket |
+| **OpenADR 2.0b** | OpenADR Alliance | Demand Response automatisée | REST |
+| **OpenLEADR** | OpenLEADR | Passerelle open-source OpenADR | Python |
+
+## 5. Local Energy Market (LEM)
+
+### Définition
+Un marché local d'énergie permet l'échange direct d'énergie entre producteurs et consommateurs locaux, sans passer par les marchés centralisés.
+
+### Designs de marché LEM
+| Design | Description | Avantages |
+|--------|-------------|-----------|
+| **Time-of-Use (ToU)** | Variable pricing by hour | Simple, incitation décalage |
+| **Peer-to-Peer (P2P)** | Échange direct prosumer↔prosumer | Autonomie, communauté |
+| **Central Market** | Marché centralisé avec clearing | Efficacité, liquidité |
+
+### Outils de simulation
+| Outil | Usage | Source |
+|-------|-------|--------|
+| **HAMLET** | Simulation agent-based LEM | TU Munich |
+| **OPLEM** | Optimisation multi-période | Oxford (PSAL) |
+| **lemlab** | Simulation agent-based (legacy) | TU Munich |
+
+### Application Cariflex
+- HAMLET et OPLEM pour simuler des designs LEM
+- Évaluer la viabilité économique d'un marché local en Martinique
+- Tester les stratégies de trading (ToU, P2P, Central)
+
+## 6. FlexMeasures — Resource Manager
+
+### Définition
+FlexMeasures est un **Resource Manager (RM)** open-source qui :
+- Collecte les données des capteurs (IoT)
+- Génère des prévisions (production, consommation, prix)
+- Optimise les schedules (planification)
+- Applique les consignes des marchés/DSO
+
+### Fonctionnalités clés
+| Fonctionnalité | Description |
+|----------------|-------------|
+| **Scheduling** | Optimisation de la charge/décharge des actifs |
+| **Forecasting** | Prévisions de production PV, consommation, prix |
+| **Reporting** | Rapports de performance et de flexibilité |
+| **API** | REST API v3.0 pour intégration |
+
+### Configuration des actifs Cariflex
+
+#### PV (production)
+```json
+{
+  "consumption-capacity": "0kW",
+  "production-capacity": "5kW",
+  "soc-min": "0kWh",
+  "soc-max": "0kWh"
+}
+```
+
+#### Battery (stockage)
+```json
+{
+  "consumption-capacity": "50kW",
+  "production-capacity": "50kW",
+  "soc-min": "10kWh",
+  "soc-max": "100kWh",
+  "charging-efficiency": "95%",
+  "discharging-efficiency": "95%"
+}
+```
+
+#### EV Charge Point (consommation)
+```json
+{
+  "consumption-capacity": "22kW",
+  "production-capacity": "0kW",
+  "soc-min": "0kWh",
+  "soc-max": "0kWh"
+}
+```
+
+#### Electric Vehicle (V2G)
+```json
+{
+  "consumption-capacity": "11kW",
+  "production-capacity": "11kW",
+  "soc-min": "15kWh",
+  "soc-max": "75kWh",
+  "charging-efficiency": "95%",
+  "discharging-efficiency": "95%"
+}
+```
+
+## 7. Références
+
+### Articles scientifiques
+- **VPP Review** (2021) : "Virtual power plants: A comprehensive review" — Renewable and Sustainable Energy Reviews, DOI: 10.1016/j.rser.2021.110201
+- **OPLEM** (2024) : "OPLEM: Open Platform for Local Energy Markets" — Applied Energy, DOI: 10.1016/j.apenergy.2024.123848
+- **HAMLET** (2025) : "HAMLET: A modular agent-based Python framework for energy markets" — SoftwareX, DOI: 10.1016/j.softx.2025.102346
+
+### Resources en ligne
+- GridX Knowledge: VPP, Aggregators, Flexibility Trading — https://www.gridx.ai/knowledge
+- Flex Ready® : https://gimelec.fr/en/flex-ready-enabling-interoperability-for-building-energy-flexibility/
+- S2 Standard : https://s2standard.org
+- OpenADR Alliance : https://www.openadr.org
+
+### Documentation Cariflex
+- `docs/architecture.md` — Architecture globale
+- `docs/deployment.md` — Guide de déploiement
+- `docs/s2_architecture.md` — Architecture S2/OpenADR
+- `docs/flex_ready_standard.md` — Standard Flex Ready®
+- `docs/lem_rd_tools.md` — Outils LEM R&D
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -0,0 +1,143 @@
+# Cariflex - Script de Déploiement Complet
+
+## 1. FlexMeasures (déjà déployé)
+
+```bash
+# Assets déjà créés: 40 (10 PV, 10 Bat, 10 Chg, 10 EV)
+# Sensors: 40
+# Carte: OSM patchée (Mapbox → OSM)
+
+# Accès
+URL: https://flexmeasures.digitribe.fr
+Login: admin@digitribe.fr / Digitribe972
+```
+
+## 2. HAMLET (simulation LEM)
+
+```bash
+# Environnement conda dédié
+conda create -n hamlet-rd python=3.11 -y
+conda activate hamlet-rd
+
+# Dépendances
+pip install numpy pandas scipy matplotlib jupyter linopy pandapower pvlib highspy hplib pyoptinterface sktime xlsxwriter tqdm windpowerlib
+
+# Cloner et installer HAMLET
+git clone https://github.com/tum-ens/HAMLET.git /home/eric/cariflex/HAMLET
+cd /home/eric/cariflex/HAMLET
+pip install -e hamlet/creator
+pip install -e hamlet/executor
+pip install -e hamlet/analyzer
+
+# Vérifier
+python -c "import hamlet; print('HAMLET OK')"
+```
+
+## 3. OPLEM (optimisation LEM)
+
+```bash
+pip install git+https://github.com/EsaLaboratory/OPLEM.git
+```
+
+## 4. S2 CEM (FlexMeasures Client)
+
+```bash
+pip install flexmeasures-client[s2]
+```
+
+## 5. OpenLEADR (passerelle OpenADR)
+
+```bash
+pip install openleadr
+```
+
+## 6. Configuration FlexMeasures Cariflex
+
+### 6.1 Flex Context (modèle de flexibilité)
+
+Chaque type d'actif a un `flex_context` et `flex_model` :
+
+**PV (production) :**
+```json
+{
+  "consumption-capacity": "0kW",
+  "production-capacity": "5kW",
+  "soc-min": "0kWh",
+  "soc-max": "0kWh"
+}
+```
+
+**Batterie (stockage) :**
+```json
+{
+  "consumption-capacity": "50kW",
+  "production-capacity": "50kW",
+  "soc-min": "0kWh",
+  "soc-max": "100kWh",
+  "soc-usage": "10kWh",
+  "charging-efficiency": "95%",
+  "discharging-efficiency": "95%"
+}
+```
+
+**EV Borne (consommation flexible) :**
+```json
+{
+  "consumption-capacity": "22kW",
+  "production-capacity": "0kW",
+  "soc-min": "0kWh",
+  "soc-max": "0kWh"
+}
+```
+
+**EV (V2G) :**
+```json
+{
+  "consumption-capacity": "11kW",
+  "production-capacity": "11kW",
+  "soc-min": "15kWh",
+  "soc-max": "75kWh",
+  "charging-efficiency": "95%",
+  "discharging-efficiency": "95%"
+}
+```
+
+### 6.2 Données de prévision
+
+FlexMeasures nécessite des données de prévision pour :
+- Production PV (données météo)
+- Consommation (profil type)
+- Prix de l'électricité (tarification EDF SEI)
+
+## 7. Intégration DSO (ENEDIS/RTE)
+
+### 7.1 Flex Ready® Aggregator API
+
+Cariflex implémente l'interface Aggregator de Flex Ready® :
+- Réception des demandes de flexibilité du DSO
+- Agrégation des réponses des actifs
+- Monitoring en temps réel
+
+### 7.2 S2 Protocol
+
+Le S2 CEM (Customer Energy Manager) fait le pont entre :
+- FlexMeasures (côté RM)
+- OpenADR/Flex Ready® (côté DSO)
+
+## 8. Monitoring
+
+### 8.1 Grafana
+
+Dashboard Cariflex :
+- Production PV temps réel
+- État de charge des batteries
+- Consommation des bornes VE
+- Flexibilité disponible
+- Signaux DSO
+
+### 8.2 Métriques clés
+
+- **Flexibilité disponible** : somme des capacités de modulation
+- **Énergie échangée** : kWh produit/consommé
+- **Revenus flexibilité** : €/kWh de flexibilité vendue
+- **Taux d'utilisation** : % du temps en mode flexibilité
--- a/docs/elaad_flexibility_protocols.pdf
+++ b/docs/elaad_flexibility_protocols.pdf
--- a/docs/flex_ready_standard.md
+++ b/docs/flex_ready_standard.md
@@ -0,0 +1,76 @@
+# Cariflex - Standard Flex Ready® (GIMELEC/RTE/ENEDIS)
+
+> Source : https://gimelec.fr/en/flex-ready-enabling-interoperability-for-building-energy-flexibility/
+> Date : 27 mai 2026
+
+## Vue d'ensemble
+
+**Flex Ready®** est un cadre d'interopérabilité open source conçu pour accélérer le déploiement des services de flexibilité énergétique dans les bâtiments et infrastructures.
+
+**Porteurs du projet :** RTE, ENEDIS, GIMELEC, THINK SMARTGRIDS
+
+**Objectif :** Créer un langage commun entre les bâtiments, les systèmes BACS (Building Automation Control Systems), les plateformes de gestion énergétique et les acteurs du marché de flexibilité.
+
+## Norme de référence
+
+- **IEC 62746-4** — Demand Side Resource Interfaces
+- **Directive EPBD** — Performance Énergétique des Bâtiments (UE)
+- Cible : **bâtiments tertiaires** (bureaux, écoles, hôpitaux, commerces, logistique)
+
+## Architecture des APIs
+
+Deux interfaces complémentaires :
+
+### 1. Supplier API
+Communication entre le **CEMS/BACS** du bâtiment et les **fournisseurs d'électricité**.
+- Cas d'usage : tarification dynamique (dynamic pricing)
+- Échange : signaux de prix, consentement du consommateur
+
+### 2. Aggregator API
+Transmission des **demandes de flexibilité**, **signaux d'activation** et **informations de monitoring** entre :
+- Les **agrégateurs** (ex: Cariflex via FlexMeasures)
+- Les systèmes **CEMS/BACS** du bâtiment
+
+## Intégration Cariflex
+
+Cariflex, en tant qu'agrégateur de flexibilité, utilise l'**Aggregator API** de Flex Ready® pour :
+
+1. **Recevoir** les demandes de flexibilité du DSO (ENEDIS/RTE)
+2. **Transmettre** les signaux d'activation aux actifs via FlexMeasures
+3. **Monitorer** la réponse des actifs (PV, batteries, bornes VE, VE V2G)
+
+```
+DSO (ENEDIS/RTE)
+    │
+    │ Aggregator API (Flex Ready®)
+    │ IEC 62746-4
+    │
+    ▼
+Cariflex (Agrégateur)
+    │
+    │ FlexMeasures API / S2 CEM
+    │
+    ▼
+Actifs (PV, Battery, EV, Charger)
+```
+
+## Standards liés
+
+| Standard | Organisation | Usage |
+|----------|-------------|-------|
+| Flex Ready® | GIMELEC/RTE/ENEDIS | Interopérabilité Bâtiment ↔ Réseau |
+| IEC 62746-4 | IEC | Interfaces de ressources côté demande |
+| S2 | S2Standard.org | CEM/RM pour flexibilité énergétique |
+| OpenADR 2.0b | OpenADR Alliance | Demande de réponse automatisée |
+
+## Documents à télécharger
+
+- [Supplier API spec](https://gimelec.fr) (via GIMELEC)
+- [Aggregator API spec](https://gimelec.fr) (via GIMELEC)
+
+## Prochaines étapes Cariflex
+
+- [ ] Télécharger les specifications Flex Ready® (Supplier + Aggregator API)
+- [ ] Implémenter l'Aggregator API côté Cariflex
+- [ ] Connecter FlexMeasures comme CEMS/BACS via Flex Ready®
+- [ ] Tester l'échange avec ENEDIS/RTE
--- a/docs/lem_rd_tools.md
+++ b/docs/lem_rd_tools.md
@@ -0,0 +1,115 @@
+# Cariflex R&D — Outils LEM (Local Energy Market)
+
+> Volet R&D du projet Cariflex — Agrégation et flexibilité énergétique
+
+## Vue d'ensemble
+
+Le volet R&D de Cariflex vise à développer et tester des mécanismes de marché local de l'énergie (LEM) pour optimiser la flexibilité des actifs ENR en Martinique.
+
+## Outils identifiés
+
+### 1. OPLEM — Open Platform for Local Energy Markets
+
+**Source :** https://github.com/PSALOxford/OPLEM
+**Lab :** Energy Systems Architecture Lab (ESAL), Oxford
+**Licence :** Academic (citation requise)
+
+**Description :** Plateforme open-source pour modéliser et tester des designs de marchés locaux de l'énergie.
+
+**Caractéristiques :**
+- Modélisation des ressources énergétiques distribuées (PV, batteries, VE)
+- Simulation de flux de puissance multi-phase
+- Optimisation multi-périodes pour la planification
+- Cadre modulaire pour créer et tester des designs de marché
+- Supporte les designs LEM courants (ToU, P2P, Central Market)
+
+**Installation :**
+```bash
+conda create --name cariflex-rd python=3.11
+conda activate cariflex-rd
+pip install git+https://github.com/EsaLaboratory/OPLEM.git
+# MOSEK solver required (academic license)
+```
+
+**Référence :**
+> Chaimaa Essayeh, Thomas Morstyn, OPLEM: Open Platform for Local Energy Markets, Applied Energy, Volume 373, 2024, 123848, https://doi.org/10.1016/j.apenergy.2024.123848
+
+### 2. lemlab — Local Energy Market Laboratory
+
+**Source :** https://github.com/tum-ewk/lemlab
+**Lab :** Chair of Energy Economics and Application Technology, TU Munich
+**Version :** 1.0 (May 2021) — **Non maintenu activement**
+
+**Description :** Outil open-source de modélisation agent-based pour les LEMs.
+
+**Caractéristiques :**
+- Modélisation agent-based (ABM)
+- Simulation ou temps réel (RTS)
+- Base de données agnostique
+- Données de séries temporelles intégrées (PV, éolien, pompes à chaleur, VE)
+- Templates pour prévisions, stratégies de trading, algorithms de marché
+
+**Successeur :** [HAMLET](https://github.com/tum-ens/HAMLET)
+
+### 3. HAMLET — successor to lemlab
+
+**Source :** https://github.com/tum-ens/HAMLET
+**Lab :** TU Munich
+
+Le successeur de lemlab, plus moderne et maintenu.
+
+## Standards de marchés LEM
+
+| Design | Description | Cas d'usage Cariflex |
+|--------|-------------|---------------------|
+| **ToU (Time of Use)** | Tarification variable selon l'heure | Base pour flexibilité résidentielle |
+| **P2P (Peer-to-Peer)** | Échange direct entre prosumers | Marché local ENR |
+| **Central Market** | Marché centralisé avec clearing | Agrégation Cariflex |
+| **Flex Ready®** | Standard GIMELEC/RTE/ENEDIS | Interopérabilité DSO |
+
+## Intégration Cariflex
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Cariflex Platform                         │
+├─────────────────────────────────────────────────────────────┤
+│  R&D Layer                                                   │
+│  ┌─────────┐  ┌─────────┐  ┌─────────┐                    │
+│  │  OPLEM  │  │ lemlab  │  │ HAMLET  │                    │
+│  │ (LEM    │  │ (Agent  │  │ (LEM    │                    │
+│  │  design)│  │  simul) │  │  simul) │                    │
+│  └────┬────┘  └────┬────┘  └────┬────┘                    │
+│       │            │            │                           │
+│  ┌────▼────────────▼────────────▼────┐                     │
+│  │         FlexMeasures (RM)         │                     │
+│  │    Scheduling + Forecasting       │                     │
+│  └────────────────┬──────────────────┘                     │
+│                   │                                         │
+│  ┌────────────────▼──────────────────┐                     │
+│  │     S2 CEM / Flex Ready® APIs     │                     │
+│  │     (Aggregator Interface)        │                     │
+│  └────────────────┬──────────────────┘                     │
+│                   │                                         │
+│  ┌────────────────▼──────────────────┐                     │
+│  │     DSO (ENEDIS/RTE)              │                     │
+│  │     OpenADR 2.0b                  │                     │
+│  └───────────────────────────────────┘                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Prochaines étapes R&D
+
+- [ ] Déployer OPLEM pour tester designs LEM
+- [ ] Intégrer HAMLET pour simulation agent-based
+- [ ] Développer les trading strategies Cariflex
+- [ ] Tester les designs de marché (ToU, P2P, Central)
+- [ ] Valider l'interopérabilité avec Flex Ready® et S2
+
+## Références
+
+- OPLEM paper: https://doi.org/10.1016/j.apenergy.2024.123848
+- OPLEM code: https://github.com/PSALOxford/OPLEM
+- lemlab: https://github.com/tum-ewk/lemlab
+- HAMLET: https://github.com/tum-ens/HAMLET
+- S2 Standard: https://s2standard.org
+- Flex Ready: https://gimelec.fr/en/flex-ready-enabling-interoperability-for-building-energy-flexibility/
--- a/docs/s2_architecture.md
+++ b/docs/s2_architecture.md
@@ -0,0 +1,66 @@
+# Cariflex - S2 Customer Energy Manager (CEM)
+
+Pour répondre au besoin de flexibilité d'un DSO (Distribution System Operator),
+le projet Cariflex intègre le standard S2 via un CEM (Customer Energy Manager).
+
+## Architecture S2 / OpenADR
+
+```
+                          ┌─────────────┐
+                          │    DSO      │
+                          │  (OpenADR)  │
+                          └──────┬──────┘
+                                 │ OpenADR 2.0b
+                                 │ / WebSocket S2
+                          ┌──────▼──────┐
+                          │  OpenLEADR  │
+                          │    ou CEM   │
+                          └──────┬──────┘
+                                 │
+                    ┌────────────┼────────────┐
+                    │            │            │
+             ┌──────▼──┐  ┌─────▼────┐  ┌───▼─────┐
+             │ RM_PV   │  │ RM_Bat   │  │ RM_EV   │
+             │ (PV_01) │  │ (Bat_01) │  │ (EV_01) │
+             └─────────┘  └──────────┘  └─────────┘
+
+RM = Resource Manager (gère un ou plusieurs actifs)
+CEM = Customer Energy Manager (agrège les RMs)
+DSO = Distribution System Operator (demande de flexibilité)
+```
+
+## S2 Standard
+
+Le standard S2 (S2standard.org) définit les interactions entre :
+- **CEM** (Customer Energy Manager) — agrège les ressources flexibles
+- **RM** (Resource Manager) — gère un dispositif flexible spécifique
+
+Messages S2 :
+- `PowerForecast` — prévision de puissance
+- `PowerMeasurement` — mesure de puissance
+- `Setpoint` — consigne de puissance
+- `Instruction` — instruction du DSO
+- `ReplayResponse` — réponse à une demande de flexibilité
+
+## Intégration avec FlexMeasures
+
+FlexMeasures joue le rôle de RM (Resource Manager) :
+1. Reçoit les données des capteurs (IoT)
+2. Génère des prévisions
+3. Crée des schedules d'optimisation
+4. Applique les consignes du DSO via S2
+
+Le CEM FlexMeasures Client fait le pont entre :
+- FlexMeasures (côté RM)
+- OpenADR / S2 (côté DSO)
+
+## Déploiement
+
+Voir `scripts/deploy_s2.sml` pour le déploiement du CEM.
+
+## Références
+
+- S2 Standard : https://s2standard.org
+- FlexMeasures Client : https://github.com/FlexMeasures/flexmeasures-client
+- OpenLEADR : https://github.com/openleadr/openleadr
+- FlexMeasures S2 Docs : https://flexmeasures-client.readthedocs.io/en/latest/CEM.html