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

3.3 KiB

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

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).