Mode Client Local
Vue d'ensemble
Le mode client de MyElectricalData est une version allégée de l'application, conçue pour tourner localement chez l'utilisateur final. Contrairement au mode serveur (gateway complet), le mode client :
- Se connecte à l'API MyElectricalData (www.v2.myelectricaldata.fr) au lieu d'Enedis directement
- Stocke les données indéfiniment dans une base locale : un simple fichier SQLite (recommandé) ou PostgreSQL
- Ne nécessite pas de compte Enedis professionnel
- Propose des exports vers Home Assistant, MQTT, VictoriaMetrics, Jeedom
┌─────────────────────────────────────────────────────────────────────────────┐
│ ARCHITECTURE COMPARÉE │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ MODE SERVEUR (Gateway) MODE CLIENT (Local) │
│ ━━━━━━━━━━━━━━━━━━━━━━ ━━━━━━━━━━━━━━━━━━━━ │
│ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ Frontend │ │ Frontend │ │
│ │ (React) │ │ (React) │ │
│ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ Backend │ │ Backend │ │
│ │ (FastAPI) │ │ (FastAPI) │ │
│ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Enedis API │ │ API MyElectricalData│ │
│ │ (direct) │ │ v2.myelectricaldata │ │
│ └─────────────┘ └─────────────────────┘ │
│ │ │
│ Cache : Valkey (24h) ▼ │
│ Admin : Oui ┌─────────────┐ │
│ Page accueil : Oui │SQLite ou PG │ │
│ │ (indéfini) │ │
│ └──────┬──────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ Exporters │ │
│ │ HA/MQTT/VM │ │
│ └─────────────┘ │
│ │
│ Cache : Non │
│ Admin : Non │
│ Page accueil : Non │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Fonctionnalités
Pages disponibles
| Page | Description | Source de données |
|---|---|---|
| Dashboard | Vue d'ensemble des PDL | API v2.myelectricaldata.fr |
| Consommation (kWh) | Données de consommation | API → base locale |
| Consommation (Euro) | Coûts calculés | Base locale |
| Production | Données de production | API → base locale |
| Bilan | Synthèse conso/prod | Base locale |
| Contribution | Envoi de contributions | API v2.myelectricaldata.fr |
| Tempo | Calendrier RTE Tempo | API → base locale |
| EcoWatt | Alertes RTE EcoWatt | API → base locale |
| Exporter | Configuration exports | Local uniquement |
Pages supprimées (vs mode serveur)
- Page d'accueil (landing)
- Inscription / Connexion
- Administration (users, rôles, logs, offres)
- Paramètres avancés
Exports disponibles
| Destination | Description |
|---|---|
| Home Assistant | Intégration directe via REST API |
| MQTT | Publication vers broker MQTT |
| VictoriaMetrics | Push vers base time-series |
➡️ Voir les intégrations planifiées (Jeedom, InfluxDB, Domoticz...)
Prérequis
- Docker & Docker Compose
- Compte sur www.v2.myelectricaldata.fr avec PDL autorisé
- Client ID et Client Secret de l'API MyElectricalData
Installation rapide
# Cloner le dépôt
git clone https://github.com/MyElectricalData/myelectricaldata_new.git
cd myelectricaldata_new
# Configurer les variables d'environnement
cp .env.local-client.example .env
# Éditer .env avec vos credentials API
vim .env
# Démarrer le mode client (base SQLite ; docker-compose.yml pour PostgreSQL)
docker compose -f docker-compose.sqlite.yml up -d
Accès : http://localhost:8100 (port différent du mode serveur)
Coexistence avec le mode serveur
Les deux modes peuvent tourner en parallèle sur la même machine :
| Mode | Frontend | Backend | Base de données |
|---|---|---|---|
| Serveur | :8000 | :8081 | PostgreSQL :5432 (interne) |
| Client | :8100 | :8181 | SQLite (fichier), ou PostgreSQL :5433 (interne) |
# Démarrer les deux modes simultanément
docker compose -f docker-compose.server.yml up -d # Mode serveur
docker compose -f docker-compose.sqlite.yml up -d # Mode client
Compatibilité avec la passerelle (Enedis Data Connect 2026)
Depuis la migration vers les API Enedis Data Connect 2026, la passerelle v2.myelectricaldata.fr rend les mesures, le contrat et l'adresse au nouveau format (grandeur[].points[] au lieu de meter_reading.interval_reading[]). Conséquences :
- un client local antérieur à cette version ne sait plus lire les réponses de la passerelle : il faut le mettre à jour ;
- un client local à jour lit aussi une passerelle encore en v5, l'ordre de mise à jour est donc libre ;
- les données déjà synchronisées en base (
raw_dataau format v5) sont gardées et restent lues, sans migration.
Détail du format : Data Connect 2026.
Documentation
- Installation (Docker, Helm)
- Architecture technique
- Configuration
- Page Exporter
- Interface utilisateur
Intégrations
- Home Assistant
- MQTT
- VictoriaMetrics
- Autres intégrations planifiées (Jeedom, InfluxDB...)