Files
Support-Agent/README.md
T
maximeandClaude Opus 5.5 1a2220d317 Add the day focus: a day and the day before only
D-024: to explain a day's color, show only that day and the day before,
the only days analyses 03 and 04 read for it. day_color.focus() selects
the data (standard library); src/focus_jour.py prints a traceable fact
summary and writes a 48 h BusVoltage figure (out/<STATION>_focus_<date>
.html and .json). Analysis 03 gains the night_end_h fact; the other
facts are unchanged. The client Energy mockup does not use this figure:
the user prefers numeric facts there.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 16:23:45 +02:00

40 lines
2.4 KiB
Markdown

# Support-Agent — diagnostic proactif AIMsight
Agent de diagnostic **100 % analytique (sans LLM)** pour les stations AIMsight. Il analyse les séries temporelles d'une station, détecte les anomalies et les explique à partir de faits calculés, avant que le client ne pose la question. Premier cas d'usage : la **santé énergétique** des stations (batterie, alimentation, interruptions de mesure).
## Lancer l'analyse
```bash
python3 src/analyse_01.py
```
Le script analyse `data/` (station VERMONT) et ouvre deux pages dans le navigateur :
- `out/VERMONT_daily.html` : l'état et la tendance de la batterie jour par jour (analyses 03 et 04), destinés au site de monitoring ; sa figure Plotly est aussi dans `out/VERMONT_daily.json` ;
- `out/VERMONT_energy.html` : le détail de toutes les analyses.
Pour comprendre la couleur d'un jour, en ne regardant que ce jour et la veille : `python3 src/focus_jour.py 27.09`.
Le graphique se lit ainsi :
- **en haut**, l'analyse ;
- **dessous**, une courbe par mesure de la station ;
- **zoom** : dans le temps, au rectangle ou à la molette ; double-clic pour revenir à la vue complète.
Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer cet environnement : `python3 -m venv .venv && .venv/bin/pip install plotly`.
## Où trouver quoi
| Besoin | Où |
|---|---|
| Vue d'ensemble, règles du projet, commandes | `CLAUDE.md` |
| Pourquoi le projet est comme il est (décisions, options écartées) | `docs/decisions.md` |
| Lire le diagnostic énergétique (manuel client et support) | `docs/guide/diagnostic-energetique.md` |
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/analyses/analyse_NN.md` |
| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` |
| Documentation AIMsight d'origine | `doc/` |
| Données de travail (VERMONT) et diagnostics experts | `data/` |
| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/energy.py` | `maquettes/` |
## État
Prototype expérimental, sans tests automatisés. Quatre analyses sont en place : `MOVING_AVERAGE_7_DAYS_DROP`, la tendance de la tension batterie sur 7 jours ; `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`, la même sur la seule mesure de 00:00 UTC ; `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour ; `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les suivantes sont listées dans les fiches `docs/analyses/` (section « Pistes »).