Document the project: decisions log, analysis sheet, domain notes

- CLAUDE.md becomes a short map: status and next step, analyses index,
  documentation map, working rules.
- docs/decisions.md: ADR-style project decision log (D-001..D-014).
- docs/analyses/: living sheet per analysis (analyse_01) and template.
- docs/domaine/: domain knowledge, one note per question.
- .claude/rules/analyses.md: path-scoped rule loaded on src/ and
  docs/analyses/; .claude/skills/nouvelle-analyse: new-analysis workflow.
- README.md: human entry point.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-09 23:29:42 +02:00
1 parent 0b950199b8
commit 8992bda17e
12 files changed
+588 -49

No files matched your search

+45
View File
@@ -0,0 +1,45 @@
# Ce que mesure la station (et ce qu'elle ne mesure pas)
## Format des exports CSV
- Un CSV par station et par métrique : `<STATION>_<Metric>_<début> to <fin>.csv`.
- Colonnes `,time_utc,metric` : un index sans nom, l'horodatage UTC (pas d'une heure), la valeur.
- Une valeur `metric` vide signifie qu'il n'y a pas de mesure.
- Les valeurs exportées sont des **moyennes horaires**.
- Les CSV simulent la future base de données. Les schémas CSV historiques varient d'un export à l'autre. Parquet et HDF5 viendront ensuite.
## Métriques système et unités
La source est le collecteur embarqué `src/__main__ (3).py` : bibliothèque INA219, shunt de 0,1 Ω.
| Métrique | Unité | Sens |
|---|---|---|
| `BusVoltage` | V | tension du bus, proche de la tension batterie |
| `BusCurrent` | mA | courant consommé par la station |
| `Power` | mW | puissance consommée |
| `ShuntVoltage` | mV | tension aux bornes du shunt (= courant × 0,1 Ω) |
| `sensor_*_deg_c` | °C | températures internes (CPU, PLL, thermal, …) |
- **`Power`, `BusCurrent` et `ShuntVoltage` sont une seule et même mesure.** On le vérifie avec P/(V·I) ≈ 0,99 et Shunt/0,1 Ω ≈ I.
- Ces trois métriques mesurent la **consommation** de la station. Le courant ne devient jamais négatif. Il baisse à midi quand la tension monte, comme une charge à puissance constante.
- **L'apport (panneau ou secteur) n'est pas mesuré.** On ne le voit qu'à travers la réaction de la batterie.
- Le courant augmente quand la tension baisse, alors que la puissance reste constante. Pour la consommation, raisonner en `Power`, pas en `BusCurrent`.
- La température suit l'ensoleillement : son amplitude dans la journée est faible les jours nuageux. Elle chute aussi quand la station est éteinte, puisque l'auto-échauffement de ~5 W s'arrête.
## Calculs déjà présents dans le collecteur embarqué
Ces valeurs ne sont pas exportées dans les CSV actuels :
- `BusVoltageOCV` : tension compensée de la chute dans la résistance interne, avec R = 0,34 Ω (mesure faite sur une station déployée) ;
- `BusVoltageTrend` : pente en mV/min sur une fenêtre de 60 s ;
- `BatteryState` et `BatteryPercent` : état de charge estimé par la table OCV LiFePO4 (voir `comment-se-comporte-la-batterie.md`).
## Instantanés d'état système
`data/metadata.md` contient des instantanés de l'état de WILDSTRUBEL et de VERMONT, avec des unités notées `[unknown]`. On y trouve par exemple `mode SLP` pour VERMONT, cohérent avec la réactivation du mode veille.
## Consommation observée sur VERMONT
- La consommation est d'environ 5,0 W constants d'avril à octobre (~120 Wh/j). Le déficit de fin septembre vient donc d'un apport en baisse, pas d'une consommation en hausse.
- Exceptions :
- ~3,3 W du 14/09 0 h au 15/09 13 h (essai du mode veille, probablement) ;
- 2,2 à 3,2 W le 09/10 à partir de 13 h (cohérent avec `mode SLP`).