R3: suite de tests golden — 16 scénarios, bloquante avant push

- tests/golden/run.mjs : chaîne complète des 5 nodes (code réel) en sandbox vm,
  horloge simulée par scénario, snapshot HA réel comme fixture.
- 16 scénarios attendus figés après revue : nuit HC (P7), solaire, abondance P6,
  provocation P3, gardes SOC, force_grid/force_charge, stop, overload.
- n8n-push.mjs exécute la suite avant tout PUT du workflow EVCS :
  golden rouge = push refusé (--skip-golden en échappatoire consciente).
- Validé par mutation : P7 cassé volontairement -> 2 échecs détectés + push bloqué.
- tools/fetch-snapshot-fixture.mjs : recapture d'un snapshot production.
This commit is contained in:
Tallagrand Thierry
2026-08-07 19:16:03 +02:00
parent 9c3a0a9c6e
commit d1efeac44c
6 changed files with 838 additions and 0 deletions

View File

@@ -520,3 +520,55 @@ divergence silencieuse entre sourceMode (WINDOWS) et conditions (BCL).
---
*Document mis à jour le : 07/08/2026 (~19:10) — R1 déployé, comportement inchangé (A/B), production stable*
## 13. Session du 07/08/2026 (soir) — R3 : Suite de tests golden
### Ce qui existe désormais (`tests/golden/`)
- **`run.mjs`** : exécute le VRAI code des nodes en chaîne complète
(INPUT_PARSE → WINDOWS_SOURCEV2 → BATTERY_CLOUD_LOCKS → DECISION_ENGINEV2
→ HA_SERVICE_CALLS_OUTPUT) dans une sandbox vm avec **horloge simulée**
(Date épinglée par scénario) sur un **snapshot HA réel** modifié par overrides.
- **`fixture-snapshot.json`** : snapshot production capturé depuis l'exécution
n8n 975833 (173 champs, re-capturable via `tools/fetch-snapshot-fixture.mjs`).
- **`scenarios.mjs`** : 16 scénarios avec attendus FIGÉS après revue manuelle :
6 nuit HC (P7 ON/OFF, sous-cible, hard floor, sans véhicule, EDF ON→start),
4 solaire (matin fort, matin nuageux, abondance P6, provocation P3),
garde SOC midi HC, force_grid, force_charge nuit, stop, overload, débranché.
### Usage
- `node tests/golden/run.mjs` → 16/16 ✅ ou liste des diffs + exit 1
- `--print` : affiche les résumés obtenus (pour autoriser une évolution)
- `--json` : sortie machine (utilisée pour figer les attendus)
- `--only=<motif>` : filtre par id de scénario
### Intégration au déploiement (le point clé)
`tools/n8n-push.mjs` exécute la suite AVANT tout PUT du workflow EVCS :
**golden rouge = rien n'est poussé**. Échappatoire consciente : `--skip-golden`.
Évolution volontaire du comportement → mettre à jour les attendus dans
`scenarios.mjs` DANS LE MÊME COMMIT que le patch.
### Validation par mutation
P7 volontairement cassé (`nightGridHcPreferred = false`) → la suite détecte
2 échecs avec diffs précis (sourceMode, takeover, EDF) et bloque le push ;
restauration → 16/16. Le filet fonctionne.
### Résumé testé par scénario
profile, sourceMode, state, decision, desiredCharging, currentA,
takeoverNeeded, action EDF ON, service helper takeover.
### Notes de comportement figées (découvertes en écrivant les attendus)
- SOC 20 la nuit avec maison sur batterie (−14 A) → `battery_current_hard_stop`
(bande lt25 : hard −8 A) + demande réseau simultanée. Protection cohérente.
- `force_charge_now` la nuit (toggle HC ON) → `start_manual_local_min_current`
ET takeover helper ON (session nuit active) : EDF peut venir en renfort. Voulu.
- Garde SOC>35 midi : sourceMode `grid_hc_allowed` mais `idle_wait_conditions`
(le grid HC midi ne s'active que SOC ≤ 35) — comportement épinglé par le test.
### Prochaines étapes du plan
- R2 : git source de vérité (src/nodes/*.js + assemblage dans n8n-push).
- Agent IA planificateur en mode ombre (après R2).
- Enrichir la suite au fil des incidents : chaque bug corrigé = +1 scénario.
---
*Document mis à jour le : 07/08/2026 (~19:20) — R3 en place, 16/16, push bloquant*

View File

@@ -0,0 +1,175 @@
{
"ac_loads_max_safe_w": "9000.0",
"afternoon_battery_max_discharge_a": "unknown",
"afternoon_probe_pv_avg_min_w": "1000.0",
"afternoon_probe_soc_min": "85.0",
"allow_grid_hc_midday": "on",
"allow_grid_hc_night": "on",
"base_load_remaining_kwh": "2.2",
"batt_charge_reserve_25_40_a": "110.0",
"batt_charge_reserve_40_60_a": "70.0",
"batt_charge_reserve_60_80_a": "40.0",
"batt_charge_reserve_80_90_a": "10.0",
"batt_charge_reserve_gt90_a": "5.0",
"batt_charge_reserve_lt25_a": "150.0",
"batt_discharge_hard_25_40_a": "-15.0",
"batt_discharge_hard_40_60_a": "-30.0",
"batt_discharge_hard_60_80_a": "-50.0",
"batt_discharge_hard_80_90_a": "-80.0",
"batt_discharge_hard_gt90_a": "-100.0",
"batt_discharge_hard_lt25_a": "-8.0",
"batt_discharge_soft_25_40_a": "-5.0",
"batt_discharge_soft_40_60_a": "-12.0",
"batt_discharge_soft_60_80_a": "-20.0",
"batt_discharge_soft_80_90_a": "-40.0",
"batt_discharge_soft_gt90_a": "-50.0",
"batt_discharge_soft_lt25_a": "-3.0",
"batt_hard_tol_25_40_sec": "5.0",
"batt_hard_tol_40_60_sec": "10.0",
"batt_hard_tol_60_80_sec": "15.0",
"batt_hard_tol_80_90_sec": "20.0",
"batt_hard_tol_gt90_sec": "20.0",
"batt_hard_tol_lt25_sec": "2.0",
"batt_recovery_25_40_min": "12.0",
"batt_recovery_40_60_min": "10.0",
"batt_recovery_60_80_min": "8.0",
"batt_recovery_80_90_min": "6.0",
"batt_recovery_gt90_min": "6.0",
"batt_recovery_lt25_min": "15.0",
"batt_soft_tol_25_40_min": "2.0",
"batt_soft_tol_40_60_min": "4.0",
"batt_soft_tol_60_80_min": "6.0",
"batt_soft_tol_80_90_min": "10.0",
"batt_soft_tol_gt90_min": "12.0",
"batt_soft_tol_lt25_min": "1.0",
"battery_current_a": "2.799999952316284",
"battery_discharge_hard_a": "-25.0",
"battery_discharge_soft_a": "0.0",
"battery_full_forecast_min_kwh": "4.5",
"battery_full_soc": "90.0",
"battery_neutral_band_a": "0.0",
"battery_reserve_up_a": "8.0",
"blocked_until": "2026-08-07 19:08:30",
"budget_remaining_kwh": "-10.11",
"charge_permission_now": "off",
"cloud_debt_kwh": "0.0",
"cloud_debt_max_kwh": "1.2",
"cloud_debt_started_at": "2026-08-06 19:41:30",
"cloud_tolerance_minutes": "20.0",
"control_latch": "off",
"controller_enabled": "on",
"current_change_cooldown_seconds": "30.0",
"current_max_auto_a": "22.0",
"current_min_a": "6.0",
"current_step_down_a": "2.0",
"current_step_up_a": "1.0",
"day_start_time": "08:30:00",
"day_stop_time": "20:15:00",
"departure_priority_enabled": "on",
"departure_time": "08:50:00",
"end_of_day_soc_guard": "85.0",
"end_of_day_soc_target": "85.0",
"evcs_ac_power_w": "0.0",
"evcs_auto_start_switch": "off",
"evcs_charging_switch": "off",
"evcs_command_current_a": "6",
"evcs_current_a": "0.0",
"evcs_delivery_noise_ema": "0.003",
"evcs_delivery_ratio_ema": "0.001",
"evcs_device_connected": "on",
"evcs_mode_fallback": "unknown",
"evcs_mode_sensor": "Manuel",
"evcs_no_demand_filter_eval_at": "2026-08-07 19:08:30",
"evcs_no_demand_score_ema": "0.002",
"evcs_no_demand_semantic_active": "off",
"evcs_no_demand_since_at": "2026-08-07 18:26:00",
"evcs_priority_manual_mode": "normal",
"evcs_priority_manual_override": "off",
"evcs_priority_manual_reason": "unknown",
"evcs_priority_manual_until": "2026-04-14 00:00:00",
"evcs_set_current_a": "6",
"evcs_status_raw": "0",
"evcs_vehicle_connected": "off",
"evening_battery_max_discharge_a": "-30.0",
"evening_soc_start_min": "85.0",
"evening_soc_stop_min": "80.0",
"evening_start_time": "17:00:00",
"evening_stop_time": "20:30:00",
"flexible_safety_margin_kwh": "0.9",
"force_mode_auto_revert_minutes": "120.0",
"forecast_commit_min_kwh": "10.0",
"forecast_commit_soc_floor": "35.0",
"forecast_mode_enabled": "off",
"grid_battery_hard_a": "-20.0",
"grid_battery_soft_a": "-10.0",
"grid_current_max_a": "20.0",
"grid_power_w": "0",
"grid_state": "off",
"hard_stop_enabled": "on",
"hc_midday_start_time": "12:24:00",
"hc_midday_stop_time": "14:24:00",
"hc_night_start_time": "01:24:00",
"hc_night_stop_time": "07:24:00",
"house_ac_headroom_w": "5000.0",
"house_ac_power_prev_w": "1842.0",
"house_ac_power_w": "1842.0",
"house_spike_grace_minutes": "10.0",
"last_block_reason": "vehicle_not_connected",
"last_current_change_at": "2026-08-07 18:26:30",
"last_signature": "vehicle_not_connected|profile=evening_high_soc|source=solar_only|chg=0|perm=0|l=0|cur=6|block=vehicle_not_connected|stop=0|prio=0|night=0|ntrg=85|nurg=0|vdf=0|vdfs=0.002",
"last_start_at": "2026-08-07 18:26:30",
"last_stop_at": "2026-08-07 18:26:00",
"midday_battery_max_discharge_a": "-40.0",
"midday_probe_pv_avg_min_w": "0.0",
"midday_soc_min": "75.0",
"min_run_minutes": "29.0",
"min_stop_minutes": "0.0",
"morning_battery_max_discharge_a": "-20.0",
"morning_probe_pv_avg_min_w": "1500.0",
"morning_probe_pv_trend_min_w": "-2000.0",
"morning_soc_min": "35.0",
"morning_start_time": "07:30:00",
"morning_stop_time": "11:00:00",
"night_takeover_prev": "off",
"notifications_enabled": "on",
"operating_mode_helper": "evening_high_soc",
"overload_hold_seconds": "30.0",
"overload_step_down_a": "2.0",
"overload_stop_after_seconds": "120.0",
"probe_current_a": "6.0",
"probe_enabled": "on",
"probe_minutes": "3.0",
"probe_retry_minutes": "45.0",
"probe_started_at": "2026-03-31 00:00:00",
"projected_end_soc_after_charge": "35.2",
"pv_hold_min_w": "500.0",
"pv_power_10m_avg_w": "1778",
"pv_power_w": "1851.9319741067588",
"pv_start_min_w": "700.0",
"pv_trend_w": "unknown",
"required_energy_kwh": "10.5",
"soc_comfort_target": "85.0",
"soc_percent": "93.0",
"soc_start_min": "80.0",
"soc_stop_min": "29.0",
"solar_potential_grace_minutes": "12.0",
"step_down_cooldown_seconds": "60.0",
"step_up_cooldown_seconds": "30.0",
"target_current_auto_a": "6.0",
"today_remaining_kwh": "3.486",
"tomorrow_kwh": "57.263",
"vebus_ac_out_l1_current_a": "8.0",
"vebus_ac_out_l1_power_w": "1846",
"vebus_ac_out_l1_voltage_v": "229.75999450683594",
"vebus_dc_current_a": "-38.400001525878906",
"vebus_dc_power_w": "-1842.0",
"vebus_dc_voltage_v": "51.279998779296875",
"vebus_l1_low_battery": "off",
"vebus_l1_overload": "off",
"vebus_low_battery": "off",
"vebus_main_state": "4",
"vebus_overload": "off",
"vebus_state": "9",
"victron_acin1_available": "0",
"victron_evcs_strategy": "auto_solar_plus"
}

176
tests/golden/run.mjs Normal file
View File

@@ -0,0 +1,176 @@
#!/usr/bin/env node
// R3 — Suite de tests GOLDEN du workflow EVCS Surplus Controller V2.6.
// Exécute le VRAI code des nodes (chaîne complète INPUT_PARSE → WINDOWS_SOURCEV2
// → BATTERY_CLOUD_LOCKS → DECISION_ENGINEV2 → HA_SERVICE_CALLS_OUTPUT → Build)
// sur un snapshot HA réel modifié par scénario, avec horloge simulée.
//
// Usage:
// node tests/golden/run.mjs # assertions (exit 1 si échec)
// node tests/golden/run.mjs --print # affiche les résumés (pour figer les attendus)
// node tests/golden/run.mjs --only=night-hc # filtre par label
//
// RÈGLE : cette suite DOIT passer avant tout push (intégrée à tools/n8n-push.mjs).
import fs from 'fs';
import vm from 'vm';
import path from 'path';
import { fileURLToPath } from 'url';
import { scenarios } from './scenarios.mjs';
const __dirname = path.dirname(fileURLToPath(import.meta.url));
const ROOT = path.resolve(__dirname, '../..');
const WORKFLOW_FILE = path.join(ROOT, 'workflows/evcs-surplus-controller-v2.6.json');
const FIXTURE_FILE = path.join(__dirname, 'fixture-snapshot.json');
const PRINT = process.argv.includes('--print');
const JSON_OUT = process.argv.includes('--json');
const only = (process.argv.find(a => a.startsWith('--only=')) || '').slice(7);
const wf = JSON.parse(fs.readFileSync(WORKFLOW_FILE, 'utf8'));
const fixture = JSON.parse(fs.readFileSync(FIXTURE_FILE, 'utf8'));
const CHAIN = [
'INPUT_PARSE',
'WINDOWS_SOURCEV2',
'BATTERY_CLOUD_LOCKS',
'DECISION_ENGINEV2',
'HA_SERVICE_CALLS_OUTPUT',
];
const nodeCode = Object.fromEntries(
CHAIN.map(n => [n, wf.nodes.find(x => x.name === n).parameters.jsCode])
);
// Horloge simulée : Date épinglée à l'instant du scénario dans la sandbox.
function makeFakeDate(fixedMs) {
return class FakeDate extends Date {
constructor(...args) {
if (args.length === 0) super(fixedMs);
else super(...args);
}
static now() { return fixedMs; }
};
}
function runNode(jsCode, inputJson, fixedMs) {
const ctx = {
$input: { first: () => ({ json: inputJson }) },
console, Intl, Math, Number, Object, String, JSON, Array, Boolean,
Date: makeFakeDate(fixedMs),
};
vm.createContext(ctx);
const out = vm.runInContext(`(function(){\n${jsCode}\n})()`, ctx);
return out[0].json;
}
// Overrides par défaut : timers neutres relatifs à l'instant du scénario
// (min_stop écoulé, pas de blocage anti-cliquetis, filtre no-demand au repos).
function stamp(ms) {
const p = new Intl.DateTimeFormat('fr-FR', {
timeZone: 'Europe/Paris', year: 'numeric', month: '2-digit', day: '2-digit',
hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false,
}).formatToParts(new Date(ms));
const g = t => p.find(x => x.type === t).value;
return `${g('year')}-${g('month')}-${g('day')} ${g('hour')}:${g('minute')}:${g('second')}`;
}
function baseOverrides(fixedMs) {
return {
last_start_at: stamp(fixedMs - 2 * 3600000),
last_stop_at: stamp(fixedMs - 2 * 3600000 + 30000),
last_current_change_at: stamp(fixedMs - 2 * 3600000),
blocked_until: stamp(fixedMs - 3600000),
last_block_reason: 'none',
evcs_no_demand_filter_eval_at: stamp(fixedMs - 30000),
evcs_no_demand_semantic_active: 'off',
evcs_delivery_ratio_ema: '0.9',
evcs_delivery_noise_ema: '0.01',
evcs_no_demand_score_ema: '0.0',
probe_started_at: '',
cloud_debt_kwh: '0.0',
night_takeover_prev: 'off',
grid_state: 'off',
victron_acin1_available: '0',
evcs_charging_switch: 'off',
control_latch: 'off',
charge_permission_now: 'off',
controller_enabled: 'on',
vebus_overload: 'off',
vebus_l1_overload: 'off',
vebus_low_battery: 'off',
vebus_l1_low_battery: 'off',
};
}
function summarize(out) {
const c = out.computed || {};
const d = out.decision || {};
const calls = out.ha_service_calls || {};
return {
profile: c.profile,
sourceMode: c.source_mode,
state: d.state,
decision: d.current_decision,
desiredCharging: d.desired_charging,
currentA: d.desired_current_a,
takeoverNeeded: !!c.night_grid_takeover_needed,
edfOnAction: !!calls.edf_general_ok_on?.execute,
takeoverHelperService: calls.helper_night_grid_takeover_needed?.service || null,
};
}
const jsonResults = {};
let failures = 0, ran = 0;
for (const sc of scenarios) {
if (only && !sc.id.includes(only)) continue;
ran++;
const fixedMs = new Date(sc.time).getTime();
if (!Number.isFinite(fixedMs)) throw new Error(`${sc.id}: time invalide`);
const raw = { ...fixture, ...baseOverrides(fixedMs), ...sc.overrides };
let payload = { data: JSON.stringify(raw) };
try {
for (const nodeName of CHAIN) payload = runNode(nodeCode[nodeName], payload, fixedMs);
} catch (e) {
failures++;
console.log(`💥 ${sc.id} : CRASH dans la chaîne — ${e.message}`);
continue;
}
const got = summarize(payload);
if (JSON_OUT) {
jsonResults[sc.id] = got;
continue;
}
if (PRINT) {
console.log(`\n─── ${sc.id} | ${sc.label}`);
console.log(' expect:', JSON.stringify(got));
if (payload.decision?.short_reason) console.log(' raison:', payload.decision.short_reason);
continue;
}
const diffs = [];
for (const [k, v] of Object.entries(sc.expect || {})) {
if (JSON.stringify(got[k]) !== JSON.stringify(v)) diffs.push(`${k}: attendu ${JSON.stringify(v)}, obtenu ${JSON.stringify(got[k])}`);
}
if (diffs.length) {
failures++;
console.log(`❌ ${sc.id} | ${sc.label}`);
for (const d of diffs) console.log(` ${d}`);
if (payload.decision?.short_reason) console.log(` raison: ${payload.decision.short_reason}`);
} else {
console.log(`✅ ${sc.id}`);
}
}
if (JSON_OUT) {
console.log(JSON.stringify(jsonResults, null, 2));
process.exit(0);
}
if (!PRINT) {
console.log(failures
? `\n${failures}/${ran} ÉCHEC(S) — NE PAS POUSSER EN PRODUCTION`
: `\nGOLDEN OK — ${ran}/${ran} scénarios conformes`);
process.exit(failures ? 1 : 0);
}

366
tests/golden/scenarios.mjs Normal file
View File

@@ -0,0 +1,366 @@
// R3 — Scénarios golden EVCS. Chaque scénario = instant simulé + overrides du
// snapshot HA réel (tests/golden/fixture-snapshot.json) + résumé attendu.
// Les attendus sont FIGÉS après vérification manuelle : un diff = régression
// (ou évolution volontaire → mettre à jour l'attendu dans le même commit).
//
// Fenêtres (helpers réels) : night_hc 01:24-07:24 | morning 07:30-11:00 |
// midday 12:24-14:24 | evening 17:00-20:30 | sinon outside_window.
// Seuils : hard floor nuit 22 | cible matin forecast fort 35 (tomorrow_kwh 57) |
// soc_start_min 80 | morning_soc_min 35 | midday_soc_min 75.
const NIGHT = '2026-08-08T01:30:00+02:00';
const MORNING = '2026-08-08T09:00:00+02:00';
const MIDDAY = '2026-08-08T13:00:00+02:00';
const AFTERNOON = '2026-08-08T15:30:00+02:00';
const EVENING = '2026-08-08T18:00:00+02:00';
const VEHICLE_NIGHT = {
evcs_vehicle_connected: 'on',
evcs_device_connected: 'on',
pv_power_w: '0',
pv_power_10m_avg_w: '0',
pv_trend_w: '0',
house_ac_power_w: '700',
vebus_ac_out_l1_power_w: '700',
battery_current_a: '-14',
};
export const scenarios = [
// ================= NUIT HC (P7 + historique) =================
{
id: 'night-hc-p7-toggle-on',
label: 'Nuit HC, VW branchée, toggle HC nuit ON, SOC 53, EDF OFF → demande réseau (P7)',
time: NIGHT,
overrides: { ...VEHICLE_NIGHT, soc_percent: '53', allow_grid_hc_night: 'on' },
expect: {
profile: 'night_hc',
sourceMode: 'grid_hc_allowed',
state: 'night_wait_grid_takeover',
decision: 'hold',
desiredCharging: false,
currentA: 6,
takeoverNeeded: true,
edfOnAction: true,
takeoverHelperService: 'turn_on',
},
},
{
id: 'night-hc-p7-edf-on-start',
label: 'Nuit HC, cycle suivant : EDF ON, batterie tenue +2A → démarrage charge HC',
time: NIGHT,
overrides: {
...VEHICLE_NIGHT, soc_percent: '53', allow_grid_hc_night: 'on',
grid_state: 'on', victron_acin1_available: '1',
battery_current_a: '2', night_takeover_prev: 'on',
},
expect: {
profile: 'night_hc',
sourceMode: 'grid_hc_allowed',
state: 'start_grid_hc_min_current',
decision: 'start',
desiredCharging: true,
currentA: 6,
takeoverNeeded: true,
edfOnAction: false,
takeoverHelperService: 'turn_on',
},
},
{
id: 'night-hc-toggle-off-historique',
label: 'Nuit HC, toggle OFF → comportement historique battery_assist_night (idle)',
time: NIGHT,
overrides: { ...VEHICLE_NIGHT, soc_percent: '53', allow_grid_hc_night: 'off' },
expect: {
profile: 'night_hc',
sourceMode: 'battery_assist_night',
state: 'idle_wait_conditions',
decision: 'hold',
desiredCharging: false,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
{
id: 'night-soc-sous-cible',
label: 'Nuit HC, SOC 30 < cible matin 35 → grid_forced',
time: NIGHT,
overrides: { ...VEHICLE_NIGHT, soc_percent: '30', allow_grid_hc_night: 'on' },
expect: {
profile: 'night_hc',
sourceMode: 'grid_forced',
state: 'night_wait_grid_takeover',
decision: 'hold',
desiredCharging: false,
currentA: 6,
takeoverNeeded: true,
edfOnAction: true,
takeoverHelperService: 'turn_on',
},
},
{
id: 'night-hard-floor',
label: 'Nuit HC, SOC 20 ≤ hard floor 22 → hard stop protection batterie + demande réseau',
time: NIGHT,
overrides: { ...VEHICLE_NIGHT, soc_percent: '20', allow_grid_hc_night: 'on' },
expect: {
profile: 'night_hc',
sourceMode: 'grid_forced',
state: 'battery_current_hard_stop',
decision: 'stop_hard',
desiredCharging: false,
currentA: 6,
takeoverNeeded: true,
edfOnAction: true,
takeoverHelperService: 'turn_on',
},
},
{
id: 'night-sans-vehicule',
label: 'Nuit HC sans véhicule → bloqué, takeover relâché',
time: NIGHT,
overrides: { ...VEHICLE_NIGHT, evcs_vehicle_connected: 'off', soc_percent: '53' },
expect: {
profile: 'night_hc',
sourceMode: 'blocked',
state: 'vehicle_not_connected',
decision: 'stop_not_connected',
desiredCharging: false,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
// ================= JOUR SOLAIRE =================
{
id: 'morning-solaire-fort',
label: 'Matin, PV 4,5 kW, SOC 60, batterie +10A → charge solaire',
time: MORNING,
overrides: {
evcs_vehicle_connected: 'on', evcs_device_connected: 'on',
soc_percent: '60', pv_power_w: '4500', pv_power_10m_avg_w: '4200',
pv_trend_w: '100', battery_current_a: '10',
house_ac_power_w: '900', vebus_ac_out_l1_power_w: '900',
},
expect: {
profile: 'morning_solar',
sourceMode: 'solar_only',
state: 'start_min_current',
decision: 'start',
desiredCharging: true,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
{
id: 'morning-nuageux',
label: 'Matin nuageux, PV 300 W, SOC 40 → pas de démarrage',
time: MORNING,
overrides: {
evcs_vehicle_connected: 'on', evcs_device_connected: 'on',
soc_percent: '40', pv_power_w: '300', pv_power_10m_avg_w: '250',
pv_trend_w: '-50', battery_current_a: '-3',
house_ac_power_w: '900', vebus_ac_out_l1_power_w: '900',
},
expect: {
profile: 'morning_solar',
sourceMode: 'blocked',
state: 'idle_wait_source',
decision: 'hold',
desiredCharging: false,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
{
id: 'midday-abondance-p6',
label: 'Midi abondance P6 : PV avg 4,5 kW + batterie +25A, SOC 66 < plancher 75 → démarre quand même',
time: MIDDAY,
overrides: {
evcs_vehicle_connected: 'on', evcs_device_connected: 'on',
soc_percent: '66', pv_power_w: '5000', pv_power_10m_avg_w: '4500',
pv_trend_w: '200', battery_current_a: '25',
house_ac_power_w: '1200', vebus_ac_out_l1_power_w: '1200',
},
expect: {
profile: 'midday_hc_or_solar',
sourceMode: 'solar_only',
state: 'start_min_current',
decision: 'start',
desiredCharging: true,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
{
id: 'midday-hc-garde-soc',
label: 'Midi sans PV, SOC 50 > 35, HC midi autorisé + EDF ON → grid proposé mais gardé (soc>35)',
time: MIDDAY,
overrides: {
evcs_vehicle_connected: 'on', evcs_device_connected: 'on',
soc_percent: '50', pv_power_w: '100', pv_power_10m_avg_w: '100',
pv_trend_w: '0', battery_current_a: '-4',
grid_state: 'on', victron_acin1_available: '1',
house_ac_power_w: '900', vebus_ac_out_l1_power_w: '900',
},
expect: {
profile: 'midday_hc_or_solar',
sourceMode: 'grid_hc_allowed',
state: 'idle_wait_conditions',
decision: 'hold',
desiredCharging: false,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
{
id: 'apresmidi-provocation-p3',
label: 'Après-midi hors fenêtre, SOC 95, PV bridé 300 W (< hold 500) → provocation PV (solar_potential)',
time: AFTERNOON,
overrides: {
evcs_vehicle_connected: 'on', evcs_device_connected: 'on',
soc_percent: '95', pv_power_w: '300', pv_power_10m_avg_w: '300',
pv_trend_w: '0', battery_current_a: '2',
house_ac_power_w: '600', vebus_ac_out_l1_power_w: '600',
},
expect: {
profile: 'outside_window',
sourceMode: 'solar_potential',
state: 'start_forecast_solar_potential',
decision: 'start',
desiredCharging: true,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
// ================= STRATÉGIES MANUELLES =================
{
id: 'force-grid-jour',
label: 'force_grid_now l\'après-midi, EDF ON, SOC 60 → charge réseau forcée',
time: AFTERNOON,
overrides: {
victron_evcs_strategy: 'force_grid_now',
evcs_vehicle_connected: 'on', evcs_device_connected: 'on',
soc_percent: '60', pv_power_w: '500', pv_power_10m_avg_w: '500',
pv_trend_w: '0', battery_current_a: '2',
grid_state: 'on', victron_acin1_available: '1',
house_ac_power_w: '900', vebus_ac_out_l1_power_w: '900',
},
expect: {
profile: 'outside_window',
sourceMode: 'grid_forced',
state: 'start_grid_forced_min_current',
decision: 'start',
desiredCharging: true,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
{
id: 'force-charge-nuit',
label: 'force_charge_now la nuit (toggle HC ON) → démarrage manuel local (non-régression P7)',
time: NIGHT,
overrides: {
...VEHICLE_NIGHT, victron_evcs_strategy: 'force_charge_now',
soc_percent: '60', allow_grid_hc_night: 'on',
},
expect: {
profile: 'night_hc',
sourceMode: 'solar_potential',
state: 'start_manual_local_min_current',
decision: 'start',
desiredCharging: true,
currentA: 6,
takeoverNeeded: true,
edfOnAction: false,
takeoverHelperService: 'turn_on',
},
},
{
id: 'strategie-stop',
label: 'Stratégie stop en journée → tout bloqué',
time: AFTERNOON,
overrides: {
victron_evcs_strategy: 'stop',
evcs_vehicle_connected: 'on', evcs_device_connected: 'on',
soc_percent: '80', pv_power_w: '3000', pv_power_10m_avg_w: '3000',
battery_current_a: '10',
},
expect: {
profile: 'outside_window',
sourceMode: 'blocked',
state: 'stopped_user',
decision: 'stop_stop_mode',
desiredCharging: false,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
// ================= SÉCURITÉ =================
{
id: 'securite-overload',
label: 'Charge solaire en cours + surcharge VE.Bus → protection (stop/step-down)',
time: EVENING,
overrides: {
evcs_vehicle_connected: 'on', evcs_device_connected: 'on',
evcs_charging_switch: 'on', control_latch: 'on', charge_permission_now: 'on',
last_start_at: '2026-08-08 17:30:00',
soc_percent: '90', pv_power_w: '3500', pv_power_10m_avg_w: '3400',
battery_current_a: '5', evcs_current_a: '13', evcs_set_current_a: '13',
vebus_overload: 'on', vebus_l1_overload: 'on',
house_ac_power_w: '4800', vebus_ac_out_l1_power_w: '4800',
},
expect: {
profile: 'evening_high_soc',
sourceMode: 'solar_only',
state: 'vebus_overload_stop_min_current',
decision: 'stop',
desiredCharging: false,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
{
id: 'vehicule-debranche-jour',
label: 'Après-midi véhicule débranché → stop_not_connected (état de repos)',
time: AFTERNOON,
overrides: {
evcs_vehicle_connected: 'off', evcs_device_connected: 'on',
soc_percent: '93', pv_power_w: '1800', pv_power_10m_avg_w: '1800',
battery_current_a: '3',
},
expect: {
profile: 'outside_window',
sourceMode: 'solar_only',
state: 'vehicle_not_connected',
decision: 'stop_not_connected',
desiredCharging: false,
currentA: 6,
takeoverNeeded: false,
edfOnAction: false,
takeoverHelperService: 'turn_off',
},
},
];

View File

@@ -0,0 +1,50 @@
#!/usr/bin/env node
// Capture un snapshot HA RÉEL depuis une exécution n8n récente du workflow EVCS
// → tests/golden/fixture-snapshot.json (base des scénarios golden).
// Usage: node tools/fetch-snapshot-fixture.mjs [executionId]
import fs from 'fs';
import os from 'os';
import path from 'path';
const WORKFLOW_ID = 'ATswvGfG4KJUls0K';
const SNAPSHOT_NODE = 'HA Snapshot EVCS Surplus Controller V2.2';
const OUT = 'tests/golden/fixture-snapshot.json';
function loadApiConfig() {
const cfgPath = path.join(os.homedir(), '.config/opencode/opencode.json');
const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
const env = cfg?.mcp?.['n8n-mcp']?.environment || {};
return {
url: (env.N8N_API_URL || '').replace(/\/api\/v1\/?$/, ''),
key: env.N8N_API_KEY
};
}
const { url, key } = loadApiConfig();
const headers = { 'X-N8N-API-KEY': key };
let execId = process.argv[2];
if (!execId) {
const res = await fetch(`${url}/api/v1/executions?workflowId=${WORKFLOW_ID}&status=success&limit=1`, { headers });
const list = await res.json();
execId = list.data?.[0]?.id;
if (!execId) { console.error('Aucune exécution trouvée'); process.exit(1); }
}
const res = await fetch(`${url}/api/v1/executions/${execId}?includeData=true`, { headers });
if (!res.ok) { console.error(`GET exécution ${execId}: ${res.status}`); process.exit(1); }
const exec = await res.json();
const runData = exec.data?.resultData?.runData;
if (!runData?.[SNAPSHOT_NODE]) {
console.error(`Node "${SNAPSHOT_NODE}" absent des données. Nodes dispo: ${Object.keys(runData || {}).join(', ')}`);
process.exit(1);
}
const items = runData[SNAPSHOT_NODE][0]?.data?.main?.[0];
if (!items?.length) { console.error('Pas de données de sortie sur le node snapshot'); process.exit(1); }
const snapshot = items[0].json;
fs.mkdirSync(path.dirname(OUT), { recursive: true });
fs.writeFileSync(OUT, JSON.stringify(snapshot, null, 2) + '\n');
console.log(`Fixture écrite: ${OUT} (exécution ${execId}, ${Object.keys(snapshot).length} champs)`);
console.log(`Champs: ${Object.keys(snapshot).sort().join(', ')}`);

View File

@@ -86,6 +86,25 @@ if (syntaxErrors) {
}
console.log('Syntaxe OK sur tous les nodes jsCode.');
// 3bis. Suite golden (R3) : obligatoire pour le workflow EVCS, sauf --skip-golden
const isEvcsWorkflow = path.basename(INPUT) === 'evcs-surplus-controller-v2.6.json';
const skipGolden = process.argv.includes('--skip-golden');
if (isEvcsWorkflow && fs.existsSync('tests/golden/run.mjs')) {
if (skipGolden) {
console.log('⚠️ Suite golden SAUTÉE (--skip-golden) — à n\'utiliser qu\'en connaissance de cause.');
} else {
console.log('Exécution de la suite golden (tests/golden/run.mjs)...');
const { spawnSync } = await import('child_process');
const g = spawnSync('node', ['tests/golden/run.mjs'], { stdio: 'inherit' });
if (g.status !== 0) {
console.error('ABANDON: la suite golden échoue. Rien n\'a été poussé.');
console.error('(Évolution volontaire du comportement ? Mettre à jour les attendus');
console.error(' dans tests/golden/scenarios.mjs dans le même commit, puis re-pousser.)');
process.exit(1);
}
}
}
// 4. PUT
const putRes = await fetch(`${url}/api/v1/workflows/${WORKFLOW_ID}`, {
method: 'PUT',