Files
Support-Agent/README.md
T
maximeandClaude Opus 5.5 d43db2a66a Add the storage analyses and their day color
DAILY_STORAGE_STATE classifies the end-of-day free space of /data and
DAYS_UNTIL_STORAGE_FULL divides it by the median daily fill over 7
days. The day color reads a state x horizon matrix drawn in
docs/storage/matrice-etat-horizon.drawio. Thresholds are arbitrary for
now (D-034, D-035); expert questions stay open. On WEISSHORN the disk
fills at 28.2 MiB/day and would be full around 06/02/2027.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:33:11 +02:00

38 lines
3.3 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/energy/final.py
```
Le script analyse `data/VERMONT/` et ouvre dans le navigateur `out/VERMONT_daily.html`, l'état et la tendance de la batterie jour par jour : ce sont les analyses livrées, destinées au site de monitoring. La figure Plotly est aussi écrite dans `out/VERMONT_daily.json`.
Pour comparer les quatre analyses Energy sur une même page (`out/VERMONT_energy.html`) : `python3 src/energy/all_analyses.py`. Pour comprendre la couleur d'un jour, en ne regardant que ce jour et la veille : `python3 src/energy/focus_jour.py 27.09`. Pages des autres domaines, sur WEISSHORN par défaut : `python3 src/storage/all_analyses.py` (espace disque) et `python3 src/cellular/all_analyses.py` (signal 4G).
La page de comparaison 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/energy/guide/diagnostic-energetique.md` |
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/<domaine>/analyses/<règle>.md` |
| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/<domaine>/domaine/` (`energy`, `storage`, `cellular`) |
| Documentation AIMsight d'origine | `docs/aimsight/` |
| Données de travail (VERMONT pour Energy, WEISSHORN pour Storage, WEISSHORN et NORDEND pour Cellular) | `data/<STATION>/` |
| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/energy.py`, `python3 maquettes/support/home.py` | `maquettes/` |
## État
Prototype expérimental, sans tests automatisés. Quatre analyses Energy sont en place. Deux sont livrées : `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour, et `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les deux autres servent à la comparaison : `MOVING_AVERAGE_7_DAYS_DROP` et sa variante sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/energy/analyses/` (section « Pistes »). Deux autres domaines sont en prototype, sans cas annotés par l'expert. Storage (espace disque) : `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et leur couleur du jour, avec des seuils arbitraires pour commencer (D-034, D-035) ; reste la livraison. Cellular (signal 4G) : `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE`, en pause en attendant le spécialiste. Le skill `nouveau-domaine` décrit comment ajouter un domaine (D-030).