Grafana : les deux bases se consultent, et les requetes sont verifiees

Trois tableaux de bord provisionnes depuis git, sur le modele de la regle R2
(le depot est la source de verite, l'interface ne peut pas les ecraser) :

  La nuit      SOC reel contre SOC exige par le bilan, et la marge entre les
               deux. C'est la question qui avait demande une nuit d'archeologie
               le 03/09.
  Le solaire   l'excedent (§36), la censure, et le mode declare par chacun des
               sept chargeurs (§37) — le signal le plus direct dont on dispose.
  Prevision    l'ecart heure par heure, avec la bande de censure dessous : une
               production sous la prevision peut vouloir dire mauvaise
               prevision OU absence de preneur.

Les evenements de la table `evenement` deviennent des marqueurs verticaux sur
tous les graphiques — une courbe sans ses evenements ne s'interprete pas.

tools/verifier-dashboards.mjs rejoue CHAQUE requete pour de vrai (SQL contre
PostgreSQL, Flux contre InfluxDB, macros Grafana substituees), annotations
comprises puisqu'elles s'executent sur tous les panneaux. Sans lui une requete
cassee ne se voit qu'a l'ecran, panneau par panneau. 19/19 au deploiement.

Port 3001 et non 3000 : sonde avant d'ecrire la ligne, quelque chose ecoute
deja sur 3000 — la lecon du 5432 deja pris par le PostgreSQL de DSM.

Connexion PostgreSQL par le role evcs_lecture : un tableau de bord ne doit pas
pouvoir ecrire dans la memoire. Aucun secret duplique, aucun secret commite :
le provisionnement les reference par $VARIABLE depuis les deux .env.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KKzkkVTG6KXnGXFFC7X9XJ

deploy/historisation/README.md

@@ -169,3 +169,82 @@ Les deux bases vivent dans des volumes Docker nommés, donc **hors du dépôt et
 hors des sauvegardes Home Assistant**. Une mémoire non sauvegardée est une
 mémoire qu'on perdra une fois — voir `HANDOFF.md` §34, qui raconte la même
 histoire pour Home Assistant.
+
+---
+
+## Consultation — Grafana (ajouté le 04/09/2026)
+
+### Ce qu'il y a à consulter, et où
+
+| Base | Où | Ce qu'elle garde | Consultable dans Grafana |
+|---|---|---|---|
+| **PostgreSQL `evcs`** | 10.10.10.22:5433 | ce que le système **calcule** : bilan, décisions, prévision publiée, événements | oui |
+| **InfluxDB `evcs`** | 10.10.10.22:8086 | ce que HA **observe**, ~1 point/s, 113 grandeurs | oui |
+| SQLite de Home Assistant | 10.10.10.17 | son historique brut (20 j) et ses statistiques long terme (186 j) | **non — volontairement** |
+
+Le PostgreSQL du port **5432** appartient à DSM et à ses services internes.
+Ce n'est pas une base du projet ; ne pas s'y connecter.
+
+L'historique de Home Assistant reste consulté **dans Home Assistant**. L'y
+brancher demanderait de lire un fichier SQLite de 4,4 Go en mode WAL, à travers
+un partage réseau, pendant que HA écrit dedans : c'est la meilleure façon de
+lire une base incohérente, et le risque n'est pas payé en retour puisque tout
+ce qui compte pour l'avenir arrive désormais dans InfluxDB à une résolution
+bien meilleure.
+
+### Mise en service
+
+```bash
+cd /volume2/projects/EVCS/EVCS/deploy/historisation
+bash preparer-grafana.sh      # génère le mot de passe admin, l'affiche une fois
+docker compose up -d grafana
+docker compose logs -f grafana
+```
+
+Puis **http://10.10.10.22:3001** — port 3001 et non 3000, occupé sur cette
+machine par autre chose.
+
+Mot de passe perdu :
+`grep GRAFANA_ADMIN_PASSWORD deploy/historisation/.env`
+
+### Les trois tableaux de bord
+
+- **La nuit** — le SOC réel contre le SOC exigé par le bilan, la marge entre
+  les deux, la session réseau, et ce que la nuit a coûté. C'est la question qui
+  avait demandé une nuit d'archéologie le 03/09.
+- **Le solaire** — production, maison, et surtout **l'excédent** (la grandeur
+  qui décide d'un démarrage depuis le 03/09), avec la censure du MPPT et le
+  mode déclaré par chacun des sept chargeurs.
+- **Prévision contre réel** — le biais de forme de la prévision, question
+  ouverte qui demande des semaines de données.
+
+Les événements de la table `evenement` apparaissent en **marqueurs verticaux
+orange sur tous les graphiques** : une courbe sans ses événements ne
+s'interprète pas.
+
+### Modifier un tableau de bord
+
+Ils viennent du dépôt git, comme le code des nodes n8n — et pour la même
+raison : une modification faite dans l'interface serait écrasée au prochain
+démarrage, en silence. Le générateur est `tools/gen-grafana-dashboards.py` :
+
+```bash
+python3 tools/gen-grafana-dashboards.py     # réécrit les trois JSON
+node tools/verifier-dashboards.mjs          # rejoue CHAQUE requête pour de vrai
+```
+
+`verifier-dashboards.mjs` exécute les requêtes SQL contre PostgreSQL et les
+requêtes Flux contre InfluxDB, macros de Grafana substituées. Sans lui, une
+requête cassée ne se voit qu'à l'écran, panneau par panneau. Sortie non nulle
+si une seule échoue.
+
+Grafana relit le dossier toutes les 30 s : pas besoin de redémarrer.
+
+Pour explorer librement sans rien casser : **« Save as… »** depuis n'importe
+quel tableau de bord en crée une copie personnelle et modifiable.
+
+### Ce que Grafana ne peut pas faire
+
+Il ne **stocke** rien : il interroge les deux bases à la demande. Le perdre ne
+perd aucune mesure. Il n'écrit rien non plus — sa connexion PostgreSQL utilise
+le rôle `evcs_lecture`, en lecture seule.