Docs: handoff moved to docs/aimsight/, CLAUDE.md and README.md rewritten (D-083)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
0df340231a
commit
cbdf91068b
4 files changed
+136
-157
No files matched your search
@@ -1,38 +1,48 @@
|
||||
# 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).
|
||||
Prototype de diagnostic pour les stations AIMsight, un système de surveillance optique de déplacements. Il analyse les données d'une station (santé du système, déplacements des cibles, images de la caméra), détecte les anomalies et les explique à partir de faits calculés, avant que le client ne pose la question. Le calcul est **100 % analytique** ; des agents Claude Code s'en servent pour lire les données, améliorer les détecteurs et répondre au support.
|
||||
|
||||
## Lancer l'analyse
|
||||
Prototype expérimental, sans tests automatisés : on vérifie en lançant les scripts et en regardant les pages.
|
||||
|
||||
## Ce qui existe
|
||||
|
||||
- **Santé du système**, quatre domaines en prototype : Energy (batterie, alimentation), Storage (espace disque), Cellular (liaison 4G), Temperature (GPU). Chacun donne une couleur par jour, une figure pour le site et un guide de lecture. Seul Energy est réglé sur des cas de l'expert ; les autres ont des seuils provisoires.
|
||||
- **Journal du matin des déplacements**, le chantier en cours : des détecteurs simples disent, en catégories, ce qui s'est passé sur les courbes (pluie, buée, passage devant une cible, turbulence… ou vrai mouvement), dans la maquette de la page Explore.
|
||||
- **Base de cas** (`events/`) : des incidents réels validés par l'expert, qui servent à régler et mesurer les détecteurs.
|
||||
- **Agents Claude Code**, lancés par l'utilisateur : `/support` répond au mail d'un client, `/boucle` améliore les détecteurs lot après lot, `/aiguiser` améliore les outils de lecture des données, `/revue-cas` fait valider les cas appris.
|
||||
- **Maquettes du site** : la vue client (une page par station) et l'accueil du support.
|
||||
|
||||
## Démarrer
|
||||
|
||||
```bash
|
||||
python3 src/energy/final.py
|
||||
python3 -m venv .venv && .venv/bin/pip install plotly matplotlib
|
||||
```
|
||||
|
||||
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`.
|
||||
Les données ne sont pas dans le dépôt : `data/` se remplit par le pompage de la plateforme (voir `run.md`). Ensuite, par exemple :
|
||||
|
||||
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) ; sur WEISSHORN et NORDEND, `python3 src/temperature/all_analyses.py` (limite du GPU).
|
||||
```bash
|
||||
python3 src/energy/final.py data/<STATION>/
|
||||
```
|
||||
|
||||
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.
|
||||
```bash
|
||||
python3 vues-deplacements/maquette/explore.py data/<STATION>/
|
||||
```
|
||||
|
||||
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`.
|
||||
Chaque script bascule seul sur `.venv` et ouvre sa page dans le navigateur ; les pages sont écrites dans `out/`. Les autres commandes sont dans `CLAUDE.md` (section « Commandes ») et `run.md` (pompage, `/boucle`, `/aiguiser`, `/revue-cas`).
|
||||
|
||||
## Où trouver quoi
|
||||
|
||||
| Besoin | Où |
|
||||
|---|---|
|
||||
| Vue d'ensemble, règles du projet, commandes | `CLAUDE.md` |
|
||||
| Carte complète du dépôt, état, règles, commandes | `CLAUDE.md` |
|
||||
| Commandes lancées par l'utilisateur (pompage, processus automatiques) | `run.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`, `temperature`, `displacement`) |
|
||||
| Cadrage du product owner (santé des sites, notifications au client) et écarts à arbitrer | `docs/aimsight/AIMsight_handoff_G_site_health.md` |
|
||||
| Documentation AIMsight d'origine | `docs/aimsight/` |
|
||||
| Données de travail (VERMONT pour Energy, WEISSHORN pour Storage, WEISSHORN et NORDEND pour Cellular et Temperature) | `data/<STATION>/` |
|
||||
| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/summary.py`, `python3 maquettes/support/home.py` | `maquettes/` |
|
||||
| Vues des déplacements : maquette de la page Explore, onglets View (images), Diagnosis (données, demande à l'agent) et Displacements (sauts et tendances détectés) ; `python3 vues-deplacements/maquette/explore.py` ; cas réels et parcours de l'expert | `vues-deplacements/` (carte : `vues-deplacements/CLAUDE.md`) |
|
||||
|
||||
## É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 »). Trois 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. Temperature : `DAILY_GPU_TEMPERATURE_LIMIT` et sa couleur du jour, rouge si le GPU a atteint 97,5 °C, la limite du constructeur, dans les 24 dernières heures (D-040) ; restent la figure du site et le guide. Le skill `nouveau-domaine` décrit comment ajouter un domaine (D-030).
|
||||
| Savoir métier | `docs/domaine/` (commun), `docs/<domaine>/domaine/` |
|
||||
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/<domaine>/analyses/<règle>.md` |
|
||||
| Guides de lecture pour le client et le support | `docs/<domaine>/guide/` |
|
||||
| Journal du matin : plan de travail, point par point | `docs/superpowers/plans/2026-10-23-journal-du-matin.md` |
|
||||
| Déplacements : maquette Explore, détecteurs, contexte, séances | `vues-deplacements/` (carte : `vues-deplacements/CLAUDE.md`) |
|
||||
| Base de cas | `events/INDEX.md` |
|
||||
| Réponses aux clients | `support/` |
|
||||
Reference in new issue
Block a user