MANUEL §0 : source de verite de la production PV du jour

Somme des 3 rendements par chargeur Victron (airtria_mppt1 + mppt_450_200 + v1)
= production reelle du jour. Verifie 24/09 (45,1 kWh) et recoupe par l'integrale
de pv_power_system (44,0). Documente les 3 pieges qui donnent un faux chiffre :
energy_production_today = prevision, gx_device_pv_energy = partiel/gelable,
v1_production_d_hier = la veille. Pour les rapports, le bilan et l'agent vocal.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GwpFpy2aQ2rJok6tNQSbVj

docs/MANUEL_COMPLET.md

@@ -74,6 +74,41 @@ défaut de configuration était réel, son ampleur a été surestimée.
 
 et `inverter_size` porté de 8 000 à **16 000 W**.
 
+### Production PV RÉELLE du jour — le capteur qui fait foi
+
+> Vérifié le 24/09/2026 (attributs HA + contre-intégrale de la puissance).
+> Il n'existe PAS un capteur unique : la production réelle du jour est la
+> **somme des trois rendements journaliers par chargeur Victron**.
+
+```
+production_pv_jour_kWh =
+    sensor.airtria_mppt1_yield_today             (MPPT 250/70,  sud-est, 10 panneaux)
+  + sensor.mppt_450_200_hq2449yr9pt_yield_today  (MPPT RS 450/200, sud 30 + ouest 9)
+  + sensor.v1_yield_today                        (MPPT 150/35,  suiveur, 3 panneaux)
+```
+
+`state_class: total`, remis à zéro chaque nuit par Victron ; pendant la journée
+c'est le cumulé-jusqu'ici, la nuit c'est le total du jour. Sommer EXACTEMENT ces
+trois capteurs de niveau *device* — ne pas ajouter de sous-capteur par tracker
+par-dessus (le 450/200 a deux trackers déjà inclus dans son total device →
+double comptage sinon).
+
+Exemple du 24/09 : 9,45 + 32,71 + 2,97 = **45,1 kWh**, recoupé en intégrant
+`sensor.victron_pv_power_system` sur la journée (pondéré par l'intervalle) =
+44,0 kWh. Les deux concordent.
+
+⚠️ **Trois pièges qui donnent un faux chiffre** (ils ont fait patauger l'agent
+vocal OpenClaw le 24/09) :
+- `sensor.energy_production_today` (« Solar production forecast ») = la
+  **PRÉVISION** Forecast.Solar, jamais le réalisé.
+- `sensor.gx_device_pv_energy` = compteur **partiel** (un sous-ensemble ~11 kWh
+  quand le parc a fait 45), et ces compteurs GX journaliers peuvent **geler**
+  (§46) : vérifier `last_changed` avant de citer une valeur GX comme actuelle.
+- `sensor.v1_production_d_hier` = la **veille**, pas aujourd'hui.
+
+Robustesse : si un des trois `yield_today` est `unavailable`, dire « production
+partielle, un chargeur muet » plutôt que sommer un trou en silence.
+
 ### Batterie
 **État au 20/09/2026 : parc assaini à 13 équivalents US2000, deux packs reliés
 par un LV-Hub.**