HANDOFF/MANUEL : kilometrage des vehicules

HANDOFF.md

@@ -1527,5 +1527,40 @@ du 03-04/10 = test du budget.
   - `session_charge` dim 27/09 01:25 (JEEP, 5,70 kWh) confirmee par le proprietaire. Plus
     rien « a confirmer » sur 7 jours ; 19 sur tout l'historique (surtout VW avant le 17/09).
 
+### 04/10 nuit — Kilometrage des vehicules : km par kWh et usure des batteries
+Demande du proprietaire, deux mesures convenues avec lui :
+- **km par kWh** entre deux releves du compteur : kWh consommes = kWh borne du vehicule
+  entre les releves + (niveau 1er - niveau 2nd) x capacite. Mesure surtout conduite et
+  saison. ⚠️ JEEP et VW hybrides : intervalle ecarte si niveau au retour = 0 (essence).
+- **capacite estimee** (l'usure) : a chaque branchement termine ou le niveau a ete saisi,
+  kWh livres par la borne DEPUIS LE BRANCHEMENT (le niveau dit est celui du branchement,
+  « c'etait 53 % a 13h10 ») / part manquante ; fin = plein vu par le controleur, ou
+  niveau d'un releve km dans l'heure apres debranchement. Vehicule = sessions confirmees.
+Construit :
+- `tools/kilometrage.mjs` : tables `releve_km`, `niveau_saisi` ; vues `km_intervalle`,
+  `capacite_estimee` (DROP + CREATE au demarrage) ; ingestion du helper
+  `input_text.evcs_releve_km` (tableau JSON [vehicule, km, niveau|null, epoch_s, source],
+  6 derniers), refus d'un compteur qui baisse (journalise). Branche dans
+  `historise-evcs.mjs`. Tests `tests/kilometrage/run.mjs` 10/10 purs + `--vues` 24/24 dans
+  le conteneur (transaction annulee, verifie : rien ne reste), 4 mutations qui mordent.
+- HA `packages/evcs_kilometrage.yaml` : file des releves, formulaire (vehicule, compteur,
+  niveau -1 = inconnu) + `script.evcs_enregistrer_releve_km`, autonomies de reference
+  JEEP 50 / VW 42 / ZERO 200 km. Carte « Releve kilometrique » sur EVCS Master
+  (sauvegarde `evcs_master.yaml.bak-20261004-km`). check_config valide.
+- Concierge (fait par moi, SPARK prevenu avant/apres) : « JEEP 112694 km 54 % », un ou
+  plusieurs vehicules, toujours avec « km » ; ecrit UNIQUEMENT `input_text.evcs_releve_km`
+  (4e constante de `concierge-write.js`, test de portee 19/19). Releve date du branchement
+  si le vehicule est celui du branchement en cours ; branchement sans etiquette et < 1 h :
+  le message vaut aussi confirmation (etiquette + niveau). Doublon (meme vehicule, meme km)
+  ignore. 10 cas en simulation. Sauvegardes `*.bak-km-20261004-004103`.
+- Grafana « Les vehicules » : nuage km / kWh avec droites de reference, tableau des
+  intervalles (statut et raison), capacite estimee dans le temps, tableau des releves.
+- ⚠️ Corrige au passage : mon remplacement de position du 03/10 avait aussi decale un
+  panneau de « La journee » (y 5 -> 4, json non commite mais servi) ; remis.
+Premiers points reels : **JEEP 9,8 kWh** (53 % -> plein, 4,6 kWh le 03/10 midi), **ZERO
+15,3 kWh** (48 -> 78 %, 4,6 kWh). Releves du 03/10 soir saisis par moi : JEEP 112 694 km
+(date du branchement 20:14, niveau 54), ZERO 16 469 km (date du debranchement 18:47,
+niveau 78 — a confirmer qu'elle n'a pas roule depuis), VW 216 830 km (niveau INCONNU).
+
 ---
-*Document mis a jour le : 03/10/2026 (~23:55) — concierge : vehicule non confirme demande, heure de saisie ; Grafana vehicules en tableau ; Grafana vehicules : ZERO et Invite ajoutes, session 16:46 reetiquetee ZERO ; prevision SOC 10 h ~35 % ; concierge fiable : niveau note par le script, une ligne, dedoublonnage, simulation par drapeau ; agent : message incompris = question, bourse sur demande explicite (banc final 6/6) ; a verifier : nuit du samedi 03 au dimanche 04/10 (budget < besoin JEEP), cron orange-cloture lundi 05/10 apres 17:40, comparaison VRM / Forecast.Solar lundi 05/10*
+*Document mis a jour le : 04/10/2026 (~01:00) — kilometrage des vehicules (km/kWh, capacite) ; concierge : vehicule non confirme demande, heure de saisie ; Grafana vehicules en tableau ; Grafana vehicules : ZERO et Invite ajoutes, session 16:46 reetiquetee ZERO ; prevision SOC 10 h ~35 % ; concierge fiable : niveau note par le script, une ligne, dedoublonnage, simulation par drapeau ; agent : message incompris = question, bourse sur demande explicite (banc final 6/6) ; a verifier : nuit du samedi 03 au dimanche 04/10 (budget < besoin JEEP), cron orange-cloture lundi 05/10 apres 17:40, comparaison VRM / Forecast.Solar lundi 05/10*

docs/MANUEL_COMPLET.md

@@ -184,6 +184,18 @@ charge pleine, soit environ **6,2 kWh au compteur**.
 ⚠️ La capacite de la JEEP n'est pas encore mesuree de la meme facon. Ne pas lui
 appliquer les 7,70 kWh de la VW.
 
+### Kilometrage et usure des batteries (donne par le proprietaire, 04/10/2026)
+
+Autonomies de reference d'une charge pleine : **JEEP 50 km**, **VW 42 km**,
+**ZERO 200 km** (helpers `input_number.victron_evcs_autonomie_{jeep,vw,zero}_km`).
+Le proprietaire releve les compteurs kilometriques (WhatsApp « JEEP 112694 km
+54 % » ou carte EVCS Master) ; le service d'historisation calcule les km par kWh
+entre deux releves et la capacite estimee a chaque charge menee au plein (tables
+`releve_km`, `niveau_saisi`, vues `km_intervalle`, `capacite_estimee`, Grafana
+« Les vehicules »). ⚠️ JEEP et VW sont hybrides : toujours donner le NIVEAU avec
+le compteur ; un intervalle fini batterie vide est ecarte (km essence possibles).
+Premiers releves (03/10 au soir) : JEEP 112 694 km, VW 216 830 km, ZERO 16 469 km.
+
 ### Routine de charge des deux vehicules (donnee par le proprietaire, 05/09/2026)
 
 | vehicule | conducteur | quand il charge |