From 83d5ad9ed76bfc7d387330226183bf4c24a4b899 Mon Sep 17 00:00:00 2001
From: Patrick Schurig <patrick@etm-schurig.eu>
Date: Tue, 9 Jun 2026 22:42:33 +0200
Subject: [PATCH] =?UTF-8?q?[3e-1]=20types=20SG-Ready=20:=20declared.states?=
 =?UTF-8?q?=20+=20estimatedPowerW(=C3=A9tat)=20+=20telemetry=20min/maxStat?=
 =?UTF-8?q?e?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

LoadDeclared : states[1-4] + estimatedPowerW QHash<int,double> (déclaré installateur,
approximatif ; états 1/2 ≈ 0 pour l'allocation surplus, invariant 8).
LoadContextTelemetry : minState/maxState (fenêtre verrou minStateHold, parallèle à
minStage/maxStage ECS). Build 0 erreur / 0 warning.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 energyplugin/etm/types/loaddescriptor.h | 10 +++++++++-
 energyplugin/etm/types/surpluscontext.h |  5 +++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/energyplugin/etm/types/loaddescriptor.h b/energyplugin/etm/types/loaddescriptor.h
index d7982c6..ef2d906 100644
--- a/energyplugin/etm/types/loaddescriptor.h
+++ b/energyplugin/etm/types/loaddescriptor.h
@@ -4,6 +4,7 @@
 
 #include <QDateTime>
 #include <QList>
+#include <QHash>
 #include <QString>
 #include "loadaction.h"
 
@@ -28,7 +29,14 @@ struct LoadDeclared {
     double capacityWh        = 0;  //!< Capacité totale (Wh).
     int    reserveSocPercent = 0;  //!< SOC de réserve (%) — non déchargeable.
 
-    // sg-ready : états toujours 1-4, pas de déclaration nécessaire.
+    // --- sg-ready (PAC) ---
+    //! États supportés (toujours 1-4 ; déclaré pour symétrie avec le protocole §5).
+    QList<int>         states;
+    //! Puissance estimée (W) par état, DÉCLARÉE installateur (approximative, cas
+    //! \c declared du protocole §5) : ex. {3: 1800, 4: 2600}. Sert au budget, n'est PAS
+    //! une consigne exacte. États 1 (blocage) et 2 (normal) ≈ 0 du point de vue allocation
+    //! surplus (la conso autonome de l'état 2 est déjà au compteur — invariant 8).
+    QHash<int, double> estimatedPowerW;
 };
 
 /*!
diff --git a/energyplugin/etm/types/surpluscontext.h b/energyplugin/etm/types/surpluscontext.h
index 5f630ad..ef86960 100644
--- a/energyplugin/etm/types/surpluscontext.h
+++ b/energyplugin/etm/types/surpluscontext.h
@@ -68,6 +68,11 @@ struct LoadContextTelemetry {
     int       maxStage   = 0;
     // --- sg-ready ---
     int       state      = 0;
+    //! Fenêtre d'états autorisée MAINTENANT par le verrou minStateHold (protection
+    //! court-cycling PAC) : gel total (minState == maxState == state) si non écoulé,
+    //! sinon [1, 4]. Même mécanique que minStage/maxStage de l'ECS, source = temps de cycle.
+    int       minState   = 0;
+    int       maxState   = 0;
     // --- battery / electricvehicle ---
     double    socPercent = 0;
     QDateTime lastSwitch;          //!< Dernier changement d'état.