tmzf5455/EVCS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
970ff83f6829781dd3e8dfd96818dbee0f92daae
EVCS/docs/MANUEL_COMPLET.md

28 KiB
Raw Blame History

Manuel Utilisateur - Système EVCS Solaire

Document généré le 17/07/2026 — dernière mise à jour le 09/08/2026 (fixes anti-rebond A→F, câblage advisor cible SOC, P9 départ, véhicules VW/JEEP) Projet: n8n / Home Assistant / EVCS Solaire sans injection réseau

1. Architecture Globale

┌─────────────────────────────────────────────────────────────────┐
│                         DGX Spark (10.10.10.8)                  │
│  ┌─────────────────┐    ┌─────────────────┐                     │
│  │  Qwen3.6-35B    │    │  Qwen3-VL       │                     │
│  │  (texte, code)  │    │  (vision)       │                     │
│  └────────┬────────┘    └────────┬────────┘                     │
└───────────┼──────────────────────┼──────────────────────────────┘
            │                      │
            ▼                      ▼
┌───────────────────────────────────────────────────────────────────┐
│                     opencode (minimax-m2.5)                       │
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │ Skills: n8n-code-javascript, n8n-expression-syntax,         │ │
│  │         n8n-mcp-tools-expert, n8n-node-configuration,       │ │
│  │         n8n-validation-expert                               │ │
│  └─────────────────────────────────────────────────────────────┘ │
└───────────┬──────────────────────┬───────────────────────────────┘
            │                      │
            ▼                      ▼
┌──────────────────────┐    ┌──────────────────────────────────────┐
│   n8n (cloud)        │    │   Home Assistant (10.10.10.17:8123)  │
│   https://n8n.airtria.pro    │    ┌──────────────────────────────────┐ │
│  ┌────────────────┐ │    │ │ Dashboards YAML (17 fichiers)      │ │
│  │ 40 workflows   │ │    │ │ - evcs_master.yaml                 │ │
│  │ 13 actifs      │ │    │ │ - evcs_mobile.yaml                 │ │
│  └────────┬───────┘ │    │ │ - victron_master.yaml              │ │
│           │         │    │ │ - etc.                              │ │
│           ▼         │    │ └──────────────────────────────────┘ │
│  ┌────────────────┐ │    └──────────────────────────────────────┘
│  │ MCP Servers    │ │
│  │ (6 outils)     │ │
│  └────────┬───────┘ │
└───────────┼─────────┘
            │
            ▼
┌───────────────────────────────────────────────────────────────────┐
│                     Équipements physiques                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │ EVCS HQ229  │  │ Victron ESS │  │ MultiPlus   │               │
│  │ (borne VE)  │  │ (batterie)  │  │ (onduleur)  │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└───────────────────────────────────────────────────────────────────┘

2. Workflows n8n Actifs

2.1 Gestion Énergie (EVCS + Grid)

ID Nom Fréquence Fonction
ATswvGfG4KJUls0K HA Snapshot EVCS Surplus Controller V2.6 30s Pilotage borne EVCS, décision charge solaire/réseau
7iIlu7LLTW7TZA8o Victron - Battery / Grid Hysteresis Fix V1 1 min Hystérésis réseau EDF (ON ≤20%, OFF ≥30%)
cTeeHy4ePiVeELLh Victron - Auto Charge Manager V1.2 30s Limites DVCC batterie (MaxChargeCurrent/Voltage)

2.2 Gestion Charges

ID Nom Fréquence Fonction
2NhrfxuGm4pTUNs9 SDB Climate & Surplus Manager V2.2 1 min Pilotage chauffage SDB selon surplus
FtPVF7byhtu4o6Oh Victron - Garage Thermal Surplus Manager V2.2 1 min Gestion garage thermique
A11aOb50cGtpJmvn Water Heater Advisor V2.3 10 min Advisor ballon ECS
yX2j8m04e3pxaoQq Water Heater Advisor ECS 6 Nodes + Build + Execute 10 min Pilotage ballon ECS
YjiNCpEoVhPT8JMw Victron - Flexible Load Advisor V1 5 min Charge flexible

2.3 Advisor / Monitoring

ID Nom Fréquence Fonction
U0nRmdS9Pa0qzpWm Victron - PV Surplus Advisor V1 15 min Advisor surplus PV

2.4 MCP (Machine Communication Protocol)

ID Nom Fonction
76hHlVYIgt1lEHyR MCP - ha.get_state Lecture états HA
eeDmEICJ3ArjwpCt MCP - ha.set_helper Écriture helpers HA
uGZAOJjKegRuRNyb MCP - grid-set-state Pilotage ON/OFF réseau EDF
a92quWH4pokpIqdn MCP - victron-set-charge-limits Limites courant/tension batterie
RVTMdsvR4i8wSc18 MCP - pv.get_forecast Prévisions Forecast.Solar

3. Skills opencode

Skill Chemin Fonction
n8n-code-javascript .opencode/skills/n8n-code-javascript/SKILL.md Analyse/patch code JS dans nodes n8n
n8n-expression-syntax .opencode/skills/n8n-expression-syntax/SKILL.md Validation syntaxe {{ }}
n8n-mcp-tools-expert .opencode/skills/n8n-mcp-tools-expert/SKILL.md Utilisation outils MCP
n8n-node-configuration .opencode/skills/n8n-node-configuration/SKILL.md Configuration nœuds n8n
n8n-validation-expert .opencode/skills/n8n-validation-expert/SKILL.md Interprétation erreurs validation

4. MCP - Outils disponibles

4.1 Lecture

  • ha-get-state : Lire un état Home Assistant

    • Input: entity_id (ex: sensor.victron_battery_soc)
    • Output: état + attributs

  • pv-get-forecast : Prévisions solaires

    • Input: aucun
    • Output: today_remaining_kwh, tomorrow_kwh, tomorrow_peak_time

4.2 Écriture

  • ha-set-helper : Écrire un helper HA

    • Input: entity_id, value

  • grid-set-state : Piloter le réseau EDF

    • Input: state ('on' ou 'off')

  • victron-set-charge-limits : Limites de charge

    • Input: max_charge_current_a, max_charge_voltage_v

4.3 Workflows n8n

  • n8n-mcp : CRUD workflows
    • List workflows, get workflow, update workflow, activate/deactivate

5. Dashboards Home Assistant

5.1 Principaux

Fichier Titre Description
evcs_master.yaml EVCS Master Dashboard principal borne VE
evcs_mobile.yaml EVCS Mobile Version mobile
victron_master.yaml Victron Master Dashboard principal système Victron
victron_mobile.yaml Victron Mobile Version mobile

5.2 Debug

Fichier Titre Description
big_victron_debug.yaml Victron Debug (complet) Debug étendu
victron_debug.yaml Victron Debug Debug standard
EVCS_SOLAR.yaml EVCS Solar Vue solaire EVCS

5.3 Pilotage

Fichier Titre Description
ECS_PILOTAGE.yaml ECS Pilotage Pilotage ECS
ECS_PILOTAGE_PREMIUM.yaml ECS Pilotage Premium Pilotage ECS avancé
GARAGE_PREMIUM_PILOTAGE.yaml Garage Premium Pilotage Pilotage garage
SDB_PREMIUM_PILOTAGE.yaml SDB Premium Pilotage Pilotage SDB

5.4 Debug Premium

Fichier Titre Description
ECS_DEBUG_REGLAGES.yaml ECS Debug Réglages Debug ECS
ECS_DEBUG_REGLAGES_PREMIUM.yaml ECS Debug Réglages Premium Debug ECS avancé
GARAGE_DEBUG_PREMIUM.yaml Garage Debug Premium Debug garage
SDB_DEBUG_PREMIUM.yaml SDB Debug Premium Debug SDB

6. Helpers Home Assistant (principaux)

6.1 Configuration EVCS

Entity ID Type Description
input_select.victron_evcs_strategy select Stratégie (auto_solar_plus, force_grid_now, etc.)
input_select.victron_evcs_vehicle select Véhicule branché : VW ou JEEP (09/08/2026, à sélectionner au branchement)
input_number.victron_evcs_required_energy_kwh number Énergie demandée (kWh)
input_boolean.victron_evcs_departure_priority_enabled boolean Priorité départ
input_datetime.victron_evcs_departure_time datetime Heure de départ VW (~08:50)
input_datetime.victron_evcs_departure_time_jeep datetime Heure de départ JEEP (~06:30)
input_boolean.victron_evcs_allow_grid_departure_urgent boolean P9 : réseau avant départ hors HC (fenêtre 120 min)
input_boolean.victron_evcs_allow_grid_hc_night boolean Réseau HC nuit (P7)
input_boolean.victron_evcs_allow_grid_hc_midday boolean Réseau HC midi
input_boolean.victron_evcs_surplus_auto_enabled boolean Contrôleur surplus actif

Package : /mnt/ARCH3/docker/HA/packages/victron_evcs_vehicles.yaml (sélecteur, départ JEEP, toggle P9). NB : input_select.victron_evcs_target_vehicle (None/Jeep/Zero) est un ancien helper UI non câblé — ne pas l'utiliser.

6.1bis Conseiller IA (advisor)

Entity ID Type Description
input_boolean.evcs_advisor_enabled boolean Kill-switch : l'advisor tourne (15 min) et écrit ses recommandations
input_boolean.evcs_advisor_apply_night_target boolean CÂBLAGE RÉEL : la cible SOC matin suit l'advisor (bornes 22-90, statut ok, fraîcheur ≤ 120 min)
input_number.evcs_advisor_night_target_soc number Cible SOC matin recommandée
input_text.evcs_advisor_strategy / _reason / _status / _divergence / _last_run / _model text Détail des recommandations (cartes + historique)
input_number.evcs_advisor_agree_count / _diverge_count number Compteurs accord/divergence vs réel

Package : /mnt/ARCH3/docker/HA/packages/evcs_advisor_shadow.yaml.

6.2 État système

Entity ID Type Description
input_text.victron_evcs_operating_mode text Profil actif
input_text.victron_evcs_surplus_state text État interne
input_text.victron_evcs_surplus_current_decision text Décision logique
input_text.victron_evcs_source_mode text Source autorisée (Solaire/Réseau)
input_text.victron_evcs_surplus_reason text Raison courte
input_text.victron_evcs_last_block_reason text Dernier blocage

6.3 Paramètres seuils

Entity ID Type Description Valeur actuelle
input_number.victron_evcs_soc_start_min number Seuil SOC démarrage 80%
input_number.victron_evcs_soc_stop_min number Seuil SOC arrêt 70%
input_number.victron_evcs_midday_soc_min number Seuil SOC midi 75%
input_number.victron_evcs_night_target_soc number Cible SOC nuit 70%
input_number.evcs_plafond_courant_edf_on number Plafond EDF ON 20A
input_number.victron_evcs_current_max_auto_a number Plafond modes auto 22A

6.4 Hystérésis réseau

Entity ID Type Description
input_boolean.victron_grid_hysteresis_latch boolean Latch hystérésis
input_boolean.victron_evcs_night_session_active boolean Session nuit active
input_boolean.victron_evcs_night_grid_takeover_needed boolean Takeover réseau nuit

7. Capteurs clés (lecture seule)

Entity ID Description
sensor.victron_battery_soc SOC batterie (%)
sensor.victron_battery_current Courant batterie (A)
sensor.victron_pv_power_system Puissance PV totale (W)
sensor.victron_consumption_power_l1 Consommation maison (W)
sensor.victron_grid_power_l1 Puissance réseau (W)
sensor.victron_evcs_current Courant EVCS réel (A)
sensor.victron_evcs_set_current Consigne lue borne (A)
sensor.victron_evcs_ac_power Puissance EVCS (W)
sensor.victron_evcs_charging_time Durée de charge
sensor.victron_evcs_statut_fr Statut FR borne
sensor.victron_evcs_mode_fr Mode FR borne
switch.edf_general_ok_switch Interrupteur réseau EDF
binary_sensor.victron_evcs_vehicle_connected Véhicule connecté
binary_sensor.victron_evcs_device_connected Borne détectée

8. Scripts HA

Script Fonction
script.evcs_boost_edf BOOST EDF 28A (plafonds 28A + force_grid_now)
script.evcs_boost_off Retour normal (plafonds 20/22 + auto_solar_plus)
script.edf_urgence_off EDF Urgence OFF (hystérésis OFF + latch OFF + stratégie stop)
script.edf_force_on EDF forcé ON
script.edf_rendre_la_main Rendre la main au système auto

9. Stratégies de charge

Stratégie Description SourceMode Conditions
auto_solar_plus Solaire uniquement + assistance batterie haute solar_only / solar_potential SOC ≥ 90% + dette nuageuse faible
auto_solar Solaire classique solar_only -
force_grid_now Préservation batterie (remonter à seuil) grid_forced / grid_hc_allowed Si SOC < 22% → remonter à 35% été / 50% mi-saison / 75% hiver
force_charge_now Charge immédiate (solution de secours manuelle) solar_only si possible, grid_forced si SOC < 35% À la discrétion du conducteur qui doit prendre sa voiture
stop Arrêt complet - -

10. Profils temporels

Profil Horaire Description
morning_solar 07:30 - 11:00 Fenêtre solaire matin
midday_hc_or_solar 12:24 - 14:24 HC midi ou solaire
evening_high_soc 17:00 - 20:30 Soir haute priorité SOC
night_hc 01:24 - 07:24 Heures creuses nuit
outside_window Autres Hors fenêtres → Mode probe (sonde) pour relancer le PV si besoin

11. Logique de décision (DECISION_ENGINEV2)

11.1 Garde-fous (Safety)

  • commonSafetyStartOk : Vérifications sécurité au démarrage
  • commonSafetyHoldOk : Vérifications sécurité au maintien
  • mustStopHard : Arrêt d'urgence (batterie basse, surcharge)

11.2 Conditions de démarrage

Condition Seuil Description
solarStartOk SOC ≥ profil + PV ≥ 1000W Démarrage solaire
gridStartOk SOC ≤ 35% + réseau dispo Démarrage réseau
batteryAssistSolarStartOk SOC ≥ 90% + dette nuageuse faible Assistance batterie solaire
probeStartOk Mode probe actif Sonde PV

11.3 Step-up / Step-down

  • Step-up : Augmente le courant si PV suffisant ou batterie en charge
  • Step-down : Diminue si batterie décharge trop ou dette nuageuse

11.4 Cloud Debt (Dette Nuageuse) & Probe

Problème

Quand les batteries sont pleines (SOC > 90%) et que la maison consomme peu (< 1200W), le MPPT de l'onduleur Victron se bride à la consommation maison uniquement. Le PV visible reste bas tant que l'EVCS ne démarre pas.

Dette Nuageuse

  • Définition : La batterie se décharge pour alimenter la maison + VE sans production PV suffisante
  • Seuil max : 1.5 kWh
  • Durée max : 30 min
  • Cette dette doit être "remboursée" par du surplus PV ultérieur

Mode Probe (Sonde)

  • Principe : Lancer la borne à 10A pour "provoquer" une production PV qui va s'adapter en quelques secondes
  • Courant probe : 10A (augmenté de 6A à 10A)
  • Durée probe : 3 minutes
  • Retry : 45 minutes si échec
  • Activation : En dehors des fenêtres définies (outside_window) ou lors de passages nuageux

Bypass outside_window

En mode auto_solar_plus ou force_charge_now, le profil outside_window ne bloque plus la charge solaire locale si :

  • SOC batterie ≥ 90%
  • Forecast solaire fort
  • Maison consommation faible

11.5 Logique Heure de départ (Night EVCS + P9)

Objectif

S'assurer que le véhicule est chargé avant l'heure de départ prévue.

Deux véhicules (09/08/2026)

Le sélecteur input_select.victron_evcs_vehicle choisit l'heure de départ effective — à positionner au branchement (la borne ne détecte pas qui est branché) :

Véhicule Heure départ (helper) Particularité
VW (défaut) victron_evcs_departure_time (~08:50) Ne publie pas franchement "charged" → fin de charge via VDF
JEEP victron_evcs_departure_time_jeep (~06:30) "Charged" franc (statut 3) ; départ DANS la fenêtre HC → logique nuit

Comportement

Scénario Action
Départ pendant la fenêtre HC (JEEP 06:30) Logique nuit : P7 + recovery urgent avant départ
Départ après la fenêtre HC (VW 08:50) + charge finie Rien (veille collante)
Départ ≤ 120 min, hors HC, charge NON finie, toggle P9 ON grid_hc_allowed → EDF ON → charge jusqu'à fin (VDF/statut) → departure_done_idle collant → EDF coupé immédiatement
Toggle P9 OFF Comportement historique (attente solaire)

P9 ne s'impose jamais sur solar_only (solaire réel prioritaire) ni sur stop / force_*. Pendant P9 le helper takeover est tenu ON (ACM maintient la batterie, l'hystérésis maintient EDF).

Paramètres

  • batteryHardFloorPct : Plancher dur batterie (ex: 22%)
  • batteryMorningTargetPct : Objectif SOC matin
    • Règles forecast (fort/moyen/faible) — valeurs helpers ;
    • OU la recommandation de l'advisor si le toggle evcs_advisor_apply_night_target est ON (bornes [max(22, hard floor), 90], statut ok, fraîcheur ≤ 120 min ; trace (ADVISOR) dans la raison) — câblage réel du 09/08/2026, HANDOFF §20.
  • gridTakeoverTriggerPct : Seuil de basculement réseau
  • batteryRecoveryUrgent : Si temps restant < temps de charge nécessaire (utilise l'heure de départ du véhicule sélectionné)
  • P9_DEPARTURE_LEAD_MIN : 120 min (constante WINDOWS_SOURCEV2)

11.6 Cycle nuit HC complet — GRAFCET (P7 + P8 + fixes 08-09/08/2026)

Deux automates coordonnés via les helpers HA (night_grid_takeover_needed, victron_evcs_surplus_state) :

  • G1 = contrôleur EVCS V2.6 (boucle 30 s)
  • G2 = hystérésis EDF (« Victron - Battery / Grid Hysteresis Fix V1 », 1 min)
G1 — SESSION NUIT EVCS
──────────────────────
X0  JOUR / attente (profils solaires)
 │   t1: fenêtre HC (01:24) ET véhicule branché
X1  SESSION NUIT ACTIVE — capture startSOC/startAt (une seule fois, Fix B)
 │   t2: toggle "Réseau HC nuit" ON → nightGridHcPreferred (P7)
X2  TAKEOVER: helper ON → G2 force EDF ON ; ACM tient la batterie (~2 A)
 │   t3: EDF ON confirmé (gridAvailable)
X3  CHARGE VE: start 6 A → step-up (plafond 20 A / boost 28 A)
 │   t4: fin de charge = VDF no-demand OU statut EVCS brut 3 "charged"
 │       + puissance ≤ 300 W (Fix D+E)
X4  CHARGE TERMINÉE (collant): vehicleChargeCompleted, sourceMode='blocked'
 │   ⚑ Fix F : cet état est réécrit à CHAQUE cycle AU-DESSUS des gardes
 │     (hard stop batterie, source-lost...) → il survit aux micro-charges
 │     du véhicule et ne peut plus être écrasé.
 │
 ├─ t5a: SOC < cible matin (cible = règles forecast OU advisor si câblé)
 │   X5a RECOVERY BATTERIE: takeover ON (EDF ON), ACM recharge → cible
 │    │   t6: SOC ≥ cible
 │    ▼
 └─ t5b: SOC ≥ cible matin
     X5b RECOVERY DONE (collant, Fix A): état 'night_recovery_done_idle'
      │   takeover OFF définitif → G2 coupe EDF IMMÉDIATEMENT (cut E2)
      │   ré-engagement UNIQUEMENT si SOC ≤ cible − 2 (bande anti-rebond)
      │   t7: débranchement OU fin de fenêtre (07:24)
     X6  CLÔTURE: clear session → retour X0 (profil jour)

G1bis — P9 : DÉPART IMMINENT HORS HC (09/08/2026)
─────────────────────────────────────────────────
Z0  JOUR, hors fenêtre HC
 │   w1: toggle P9 ON ET véhicule branché ET départ (véhicule sélectionné)
 │       dans ≤ 120 min ET charge non terminée
Z1  RÉSEAU PRÉ-DÉPART: sourceMode='grid_hc_allowed' (bypass garde SOC 35),
 │   takeover helper ON (ACM + hystérésis), EDF ON, charge du véhicule.
 │   NB: solar_only réel reste prioritaire ; stop/force* restent maîtres.
 │   w2: fin de charge (VDF vehicle_full_or_paused OU statut 3)
Z2  'departure_done_idle' (COLLANT, réécrit chaque cycle comme Fix F)
 │   takeover OFF → G2 coupe EDF immédiatement (cut E2 étendu)
 │   w3: heure de départ passée OU débranchement
Z0  retour au jour normal

G2 — HYSTÉRÉSIS EDF (seuils ON ≤ 20 % | OFF ≥ 30 % | min_on 25 | cooldown 15)
──────────────────────────────────────────────────────────────────────────────
Y0  EDF OFF (observe_only)
 │   u1: override EVCS (takeover/force_grid/grid_forced/grid_hc_allowed)
 │       sans no-demand sémantique
 │   u2: SOC ≤ seuil ON (bypass cooldown)
Y1  EDF ON + latch
 │   v1: override disparu ET min_on écoulé ET SOC ≥ seuil OFF → turn_off_recovered
 │   v2: force_grid + voiture pleine → coupure immédiate
 │   v3: véhicule débranché + SOC ≥ seuil OFF → coupure immédiate
 │       (turn_off_vehicle_unplugged, bypass min_on — Fix C)
 │   v4: es ∈ {night_recovery_done_idle, departure_done_idle} + SOC ≥ seuil OFF
 │       → coupure immédiate (turn_off_recovery_done, bypass min_on — E2+P9)
 └─▶ retour Y0 (cooldown 15 min)

États surplus « fin de charge » (aucun ne doit matcher les patterns no-demand de G2 — full_or_paused / not_requesting_power / charge_complete / no_demand) :

  • night_session_done_idle : charge finie, recovery batterie possible (EDF maintenu si SOC < cible)
  • night_recovery_done_idle : charge finie ET batterie à la cible → EDF relâché définitivement (anti-rebond)
  • departure_done_idle : charge finie pendant la fenêtre départ P9 (jour) → EDF relâché définitivement

Incidents de référence

  • Nuit 07-08/08 (JEEP) : SOC bloqué pile à la cible = point dégénéré → rebond EDF ~10 min + flapping ACM ; EDF maintenu 25 min après débranchement. → Fix A (collant + bande 2 pts), B (snapshot startSOC/At), C (coupure au débranchement), D (statut charged).
  • Nuit 08-09/08 (JEEP) : statut 3 pendant la session armée → branches source-lost zombies, état collant jamais écrit, statut retombe à l'ouverture du relais → re-P7 ~30 min. → Fix E (latch en session active) + E2 (coupure immédiate recovery done).
  • Matin 09/08 (VW pleine rebranchée) : micro-charges du véhicule sur batterie → hard stop ÉCRASAIT l'état collant → re-P7. → Fix F (mémoire prioritaire sur les gardes, réécrite chaque cycle).

11.7 Conseiller IA — mode ombre et câblages réels

  • Workflow EVCS Advisor Shadow V1 (15 min) : snapshot HA compact → LLM local (qwen3-vl / qwen3.6-35b sur la Spark, fallback cloud) → validation stricte → helpers evcs_advisor_* + logbook. N'écrit RIEN d'autre (testé).
  • Câblage réel n°1 (09/08/2026) : cible SOC matin (evcs_advisor_apply_night_target, cf. §11.5). Garde-fous : statut ok, fraîcheur ≤ 120 min, bornes, fallback règles, rollback toggle.
  • Suivi : carte « Conseiller IA (ombre) » (accords/divergences), historique des entités evcs_advisor_*, logbook « EVCS Advisor », executions n8n.
  • Prochains candidats (après observation) : stratégie, plafond courant.

12. Configuration opencode.json

{
  "provider": {
    "openrama": {
      "models": {
        "minimax-m2.5": { "name": "minimax-m2.5" }
      }
    },
    "qwen-dgx-vl": {
      "models": {
        "qwen3-vl": { "attachment": true, "modalities": {"input": ["text","image"]} },
        "qwen3.6-35b": { "options": { "temperature": 0.15, "reasoningEffort": "none" } }
      }
    }
  },
  "mcp": {
    "n8n-mcp": { "type": "local", "command": ["npx", "-y", "n8n-mcp-server"] },
    "ha-get-state": { "type": "remote", "url": "https://n8n.airtria.pro/mcp/..." },
    "ha-set-helper": { "type": "remote", "url": "https://n8n.airtria.pro/mcp/..." },
    "grid-set-state": { "type": "remote", "url": "https://n8n.airtria.pro/mcp/grid-set-state/sse" },
    "victron-set-charge-limits": { "type": "remote", "url": "https://n8n.airtria.pro/mcp/..." },
    "pv-get-forecast": { "type": "remote", "url": "https://n8n.airtria.pro/mcp/..." }
  },
  "permission": {
    "bash": { "curl *": "deny", "wget *": "deny", "*": "ask" }
  }
}

13. Méthode de travail

13.1 Source de vérité et déploiement (R2, 07/08/2026)

Le code des nodes du workflow EVCS V2.6 vit dans src/nodes/*.js (+ HA_SNAPSHOT_TEMPLATE.json.tpl). Le JSON workflows/*.json est un artefact reconstruit au push.

éditer src/nodes/<NODE>.js
node tools/n8n-push.mjs workflows/evcs-surplus-controller-v2.6.json
   → build src→JSON → node --check → GOLDEN 33 scénarios (bloquant)
   → backup serveur → PUT
git commit && git push
  • JAMAIS d'édition du JSON ou de l'UI n8n (écrasée au prochain push).
  • Tests : node tests/golden/run.mjs (33 scénarios figés, exécute le JSON buildé → toujours node tools/n8n-build.mjs avant un run manuel).
  • Évolution voulue du comportement → mettre à jour tests/golden/scenarios.mjs dans le même commit.
  • Workflow hystérésis (7iIlu7LLTW7TZA8o) : fichier local workflows/victron-grid-hysteresis-v1.json, patches rejouables dans tools/patch-*.mjs, push via n8n-push.mjs (backup auto).

13.2 Lecture d'un workflow n8n (hors EVCS V2.6)

  1. Utiliser n8n-mcp_get_workflow avec l'ID
  2. Le fichier est écrit dans ~/.local/share/opencode/tool-output/tool_*
  3. Attention : Le fichier commence par "Retrieved workflow: " AVANT le JSON
  4. Extraction par nœud : 
    grep -n '"name": "NOM_DU_NOEUD"' <fichier>
sed -n 'DEBUT,FINp' <fichier>

13.3 Modification

  1. TOUJOURS backup avant modification
  2. Une seule modification à la fois
  3. Vérifier avec dry-run
  4. Valider en production

13.4 Interdiction

  • JAMAIS de curl/wget direct vers HA/n8n/Victron
  • JAMAIS d'IP/URL/token inventés
  • Utiliser les MCP uniquement

14. À compléter par l'utilisateur

  • Tableau détaillé des fonctionnalités (entrées/sorties/conditions)
  • Documentation EDF Urgence (créé par FABLE)
  • Liste des incidents récurrents → §11.6 (incidents de référence) + HANDOFF §17-21
  • Procédures de dépannage
  • Glossaire des termes techniques

Document généré le 17/07/2026 — mis à jour le 09/08/2026 (HANDOFF §17-21 : fixes A→F, advisor, P9, véhicules)

Reference in New Issue View Git Blame Copy Permalink