etm-powersync-energy-plugin-etm/docs/INVENTAIRE_MOCK.md

# INVENTAIRE À FROID DU MOCK — ce qu'il rend structurellement introuvable

*(Fait le 2026-09-01, après trois occurrences en trois jours d'un cas réel impossible à
reproduire. Ce n'est plus un incident, c'est une propriété du banc d'essai.)*

## Pourquoi cet inventaire

Trois fois cette semaine, un défaut réel s'est révélé **inatteignable par la suite** :

| Occurrence | Ce qui était introuvable | Comment on l'a su |
|---|---|---|
| Correctif amont `calculateAllowanceAmpere` | un compteur publiant les courants **sans** les puissances par phase | le mock pose `currentPhaseB = currentPowerPhaseB / 230`, cohérent **par construction** |
| Test `command` sous `source: none` | une charge dont rien ne mesure la puissance | **toutes** les classes pilotables portent `currentPower` |
| Test `ECO_FLOOR_*` en régime `unmeasurable` | une borne sans `sessionEnergy` | il a fallu **ajouter** l'état à une seule classe pour avoir les deux cas |

Le point commun : **le mock est plus homogène que la réalité.** Il a été construit pour faire
marcher des scénarios, pas pour représenter la diversité du parc — et une suite verte ne dit alors
rien sur les cas qu'il ne sait pas produire.

## Les classes, et ce qu'elles portent

| Classe | `currentPower` | `totalEnergyConsumed` | `sessionEnergy` |
|---|---|---|---|
| `meter` | ✅ | ✅ | — |
| `charger` | ✅ | ✅ | ❌ |
| `chargerPhaseSwitching` | ✅ | ✅ | ✅ *(ajouté le 2026-08-31)* |
| `simpleCharger` | ❌ | ❌ | ❌ |
| `powerSwitch` | ✅ | ❌ | — |
| `etmVariableLoad` | ✅ *(`currentPowerW`)* | ❌ | — |
| `energyStorage` | ✅ | ❌ | — |
| `car`, `notification` | ❌ | ❌ | — |

**Ce que la table donne, et c'est la bonne nouvelle** : `sessionEnergy` et `totalEnergyConsumed`
sont désormais **discriminants** — il existe des classes avec et sans. Les régimes `measured` /
`unmeasurable` et les causes `noSessionEnergy` / `meterWithoutEnergy` sont donc exerçables.

## Ce qui reste STRUCTURELLEMENT introuvable

**1. ~~`measurement.source: none` pour une charge saine.~~ — OUVERT le 2026-09-02.** La classe
`dryRelay` a été ajoutée : elle commute, elle ne mesure pas. Une charge **saine et non mesurée**
est désormais fabricable, et `testHealthyButUnmeasuredDiffersFromFaulty` vérifie ce que rien ne
pouvait vérifier avant — que le moteur **distingue** « rien ne mesure cette charge » de « cette
charge est en panne », deux affirmations que le seul chemin disponible (un Thing manquant)
mélangeait.

> **Ce que l'ajout a révélé au passage** : `executeAction()` déréférençait le contrôleur HTTP de
> **chaque** Thing sans vérifier — le mock supposait que toute classe en possède un. Un relais sec
> n'en a pas besoin, n'ayant rien à mesurer. Le plantage était immédiat et net ; l'hypothèse, elle,
> était invisible tant qu'aucune classe ne la contredisait. **Le mock avait sa propre prémisse
> fausse**, protégée par son homogénéité.

**2. ~~Un compteur par phase incohérent.~~ — OUVERT le 2026-09-03.** `voltagePhaseX` et
`currentPhaseX` sont désormais réglables **indépendamment** des puissances, par des paramètres
OPTIONNELS — sans eux, le comportement dérivé d'origine est conservé et aucun scénario existant
ne bouge.

> **Et l'ouverture a corrigé une erreur de RAISONNEMENT, pas seulement comblé un trou.** Le
> premier test de `LM-1210-a` attendait qu'une phase en export donne une marge *supérieure* au
> plafond — c'est ce que le design affirmait. Il a échoué : `calculateAllowanceAmpere()` part du
> plafond et ne fait que des `qMin`, donc la marge y est **écrêtée**. Physiquement juste — l'export
> ne permet pas de tirer plus que le disjoncteur — mais la phrase du design était fausse. **La
> conclusion tenait, la raison non**, et rien ne pouvait le révéler tant que le déséquilibre était
> infabricable.

**3. ~~`temperature`.~~ — OUVERT le 2026-09-05.** La classe `thermalProbe` porte l'état, et
`testThermalProbeFeedsTelemetry` exerce enfin la branche « sonde présente » de
`attachMeasurements()`, écrite depuis toujours et **jamais parcourue**. C'était la seule entrée du
volet thermique, et rien ne l'exerçait.

> **Ce qu'il reste à dire, et qui n'est pas corrigé ici** : une sonde DÉSIGNÉE mais incapable —
> un Thing sans état `temperature` — produit exactement la même charge utile qu'aucune sonde du
> tout (`temperatureC` absent). Le geste de réparation, lui, diffère : désigner une sonde, ou en
> changer. C'est un silence de la famille `progressUnmeasurableCause`, relevé par le test et
> laissé ouvert : le fermer demande un catalogue de causes thermiques qui n'existe pas encore.

**4. ~~Une triphasée déséquilibrée.~~ — OUVERT le 2026-09-03.**
`testWorstPhaseBindsWhenPhasesAreUnbalanced` exerce enfin `LM-1210-a` : phase B saturée à 30 A
sous un plafond de 25 pendant que A et C exportent, et la maison **exporte globalement**. La
marge retenue est celle de B — négative — et non celle du total, qui rassurerait à tort.

Ce manque était nommé **deux fois par deux chemins indépendants** — cet inventaire et le balayage
des contrôles — avant d'être comblé. C'est ce qui lui a donné sa priorité.

## La règle qui en sort

> **Avant d'écrire un test qui exerce une ABSENCE, vérifier que le mock peut la produire.**
> Une assertion sur un cas inatteignable ne passe pas : elle **ne s'exécute pas**, ce qui est
> pire — elle compte comme verte.
>
> Le symptôme se reconnaît : **la contre-épreuve ne mord pas**. C'est le corollaire fin
> d'`AGENTS.md` appliqué au banc d'essai plutôt qu'au code.

**Et la parade tient en une ligne de test** : quand on itère pour trouver des cas, **compter
combien on en a examinés**, et échouer si le compte est nul. C'est ce qui a rattrapé le test de
`command`, et ce qui garde celui de la mesurabilité.

**5. ~~Un compteur d'énergie FIGÉ.~~ — OUVERT le 2026-09-04.** `totalEnergyConsumed` n'était
écrit par personne : il valait sa valeur par défaut, indéfiniment. **Un compteur figé est un
compteur qui n'existe pas pour tout ce qui l'intègre** — `deliveredWh` restait à 0, `remainingWh`
à 4 000, et l'étalement adaptatif n'était **jamais exercé**. Le comportement se confondait avec
`unmeasurable` pour une raison entièrement différente et bénigne.

Le mock intègre désormais `currentPower` dans le cumul, une fois par seconde. **En export il ne
recule pas — il ne bouge pas** : un compteur de consommation est monotone, et le faire reculer
produirait un cas que le terrain ne produit pas, que la garde de sémantique traiterait comme une
anomalie.

**Et `LM-1014-b` s'y applique, question posée et répondue** : `totalEnergyConsumed` est déclaré
`cached`, donc il **continue** au redémarrage du mock. Repartir de zéro ferait reculer un cumul
monotone — le mock fabriquerait l'anomalie que le moteur est censé détecter.

**Quatrième occurrence.** Après les six états cohérents du `rootmeter`, les classes portant toutes
une puissance, et la triphasée équilibrée.

**6. ~~Le compteur sans énergie et la sonde thermique.~~ — OUVERTS le 2026-09-05**, et les deux
derniers de la liste. `meterNoEnergy` remplace le `powerSwitch` détourné en instrument de mesure —
un montage que personne ne fait, et qui faisait tenir DEUX rôles à la même Thing dans le même
scénario. `thermalProbe` ouvre le volet thermique.

> **Et l'ouverture a révélé un défaut, comme les trois précédentes.** `setupThing()` du mock
> n'avait **aucune sortie par défaut** : une classe sans branche ne rencontrait jamais de
> `info->finish()`. Le setup ne échouait pas — **il ne se terminait jamais**. Le symptôme est un
> Thing éternellement « en cours de configuration » et un test qui expire ailleurs, très loin de
> la cause.
>
> C'est le même mécanisme que le contrôleur déréférencé pour toute classe : **une hypothèse du
> mock que son homogénéité protégeait.** Tant que chaque classe avait sa branche, l'absence de
> sortie par défaut ne pouvait pas se voir. Corrigé : une classe oubliée se dit maintenant en
> `qCWarning` et rend `ThingErrorSetupFailed`.
>
> **Et une garde a mordu au passage** : la première version du test thermique lisait `loads[]`
> sans compteur racine — donc une liste vide, et trois assertions qui ne se seraient jamais
> exécutées. `QCOMPARE(parId.count(), 3)` l'a attrapé. C'est la parade écrite plus haut dans ce
> document, appliquée le jour même à son auteur.

## Ce qu'il faudrait ajouter, par ordre d'utilité

1. **Une classe pilotable SANS aucune puissance** — un relais sec. Débloque `source: none` sur
   une charge saine, et sépare enfin « non mesurée » de « en panne ».
2. ~~**Un compteur sans `totalEnergyConsumed`** en tant que classe déclarée.~~ — **FAIT le
   2026-09-05** : `meterNoEnergy`. Elle ne déclare PAS l'interface `energymeter`, qui exige
   `totalEnergyConsumed` — promettre une interface qu'on ne tient pas ferait mentir le mock là où
   il doit être littéral.
3. **Une tension par phase réglable** indépendamment des puissances — pour exercer le correctif
   amont ailleurs qu'en inversant la fonction.

> Aucune de ces trois n'est urgente. Ce qui l'est, c'est de **savoir qu'elles manquent** : sans
> cette liste, chaque lot repaiera le même temps à découvrir qu'un cas est introuvable.