3.8 KiB
3.8 KiB
name, description
| name | description |
|---|---|
| nouvelle-analyse | Créer une nouvelle analyse dans le projet de diagnostic AIMsight — règle, fiche, code dans son domaine, panneau de comparaison, index, journal. À utiliser dès que l'utilisateur veut ajouter, concevoir ou prototyper une nouvelle analyse des séries temporelles d'une station. |
Créer une nouvelle analyse
1. Situer l'analyse
- Domaine : Energy (
src/energy/,docs/energy/), Storage, Cellular, ou un nouveau domaine, qui reçoit alors son propresrc/<domaine>/etdocs/<domaine>/(D-026). Un domaine qui n'existe pas encore se crée d'abord avec le skillnouveau-domaine(D-030). Le demander à l'utilisateur en cas de doute. - Nom de la règle : en anglais, en majuscules, en mots complets sans abréviation (ex.
MOVING_AVERAGE_7_DAYS_DROP, D-017). Les analyses ne sont pas numérotées : le nom de la règle les désigne (D-026). - Lire, sans tout charger :
- les « Pistes » et les « Limites connues » des fiches du domaine (
docs/<domaine>/analyses/). La nouvelle analyse en couvre souvent une ; docs/decisions.md, en particulier les options écartées ;- la note de
docs/domaine/ou dedocs/<domaine>/domaine/qui concerne la question posée.
- les « Pistes » et les « Limites connues » des fiches du domaine (
- Si la conception demande des choix, en discuter avec l'utilisateur. Avec superpowers (brainstorming), la spec s'écrit directement dans la fiche, pas dans
docs/superpowers/specs/(D-010).
2. Écrire la fiche
- Copier
modele-fiche.md(à côté de ce fichier) versdocs/<domaine>/analyses/<règle en minuscules>.md(ex.daily_battery_state.md) et remplir :- la question posée ;
- le principe et le calcul exact ;
- les constantes avec leur source ;
- les options écartées.
- Statut : « en conception ».
3. Écrire le code
- Le calcul respecte le contrat commun :
run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}.- Il est causal.
- Il utilise uniquement la bibliothèque standard, sans importer
src/common/: il doit pouvoir s'embarquer seul. valueest exprimé dans une unité physique, sans pseudo-probabilité.- Une analyse seule conclut au plus
consistent with.
- Le module va dans
src/<domaine>/. Les séries arrivent parcommon.stations.load_stations. Extraire du code partagé seulement quand une deuxième analyse en a vraiment besoin. - Pas de point d'entrée par analyse : ajouter le panneau de l'analyse à la page de comparaison du domaine (pour Energy,
figure()etmain()desrc/energy/all_analyses.py). Si l'analyse devient livrée, elle rejoint aussi la page livrée (pour Energy,src/energy/final.py). - Graphique (D-011) : en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle. Écrire le HTML avec
post_script=common.page.AUTOSCALE_Y_JSet des ordonnées enfixedrange, pour que l'ordonnée se recale à chaque zoom. - Pas de tests automatisés en phase prototype (D-008).
4. Vérifier
- Lancer la page de comparaison du domaine sur son jeu de travail (pour Energy, VERMONT :
python3 src/energy/all_analyses.py; pour Storage et Cellular, WEISSHORN, D-030). - Comparer les résultats au diagnostic expert (
docs/<domaine>/domaine/cas-annotes-par-l-expert.md). - Reporter les dates et valeurs observées dans la section « Résultats » de la fiche.
5. Documenter
- Fiche : statut « prototype en place », résultats, limites, historique.
CLAUDE.md:- ajouter une ligne au tableau des analyses du domaine ;
- mettre à jour « État et prochaine étape ».
docs/decisions.md: une entrée seulement si une décision de niveau projet a été prise (nouveau principe, changement de cap, nouveau domaine). Les choix propres à l'analyse restent dans sa fiche.- Un savoir métier découvert en chemin va dans
docs/domaine/(commun) oudocs/<domaine>/domaine/.