doc planning
This commit is contained in:
1 parent
23f01d7c23
commit
ebcdb30375
3 files changed
+103
-42
No files matched your search
@@ -1,6 +1,6 @@
|
||||
# Journal du matin du client : plan de travail
|
||||
|
||||
> **Pour l'agent qui reprend ce plan :** ce plan n'est pas linéaire. L'utilisateur nomme **un point** (« exécute le point 7 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md` ») ; tu fais ce point seul, en suivant ses étapes (`- [ ]`), avec superpowers:executing-plans **en ligne** (pas de sous-agents sauf demande explicite). Prototype : ni tests ni revue (D-008, utilisateur 2026-10-16 et 2026-10-23) ; on vérifie en lançant et en regardant une capture. Avant de commencer : lis la section « Contraintes » et le point demandé en entier, puis seulement les fichiers qu'il cite. À la fin : coche les étapes faites, mets à jour la colonne **Statut** de l'index, ajoute une ligne datée au « Journal du plan » en bas, et dis à l'utilisateur ce qui reste du point.
|
||||
> **Pour l'agent qui reprend ce plan :** ce plan n'est pas linéaire. L'utilisateur nomme **un point** (« exécute le point 7 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md` ») ; tu fais ce point seul, en suivant ses étapes (`- [ ]`), avec superpowers:executing-plans **en ligne** (pas de sous-agents sauf demande explicite). Prototype : ni tests ni revue (D-008, utilisateur 2026-10-16 et 2026-10-23) ; on vérifie en lançant et en regardant une capture. Avant de commencer : lis la section « Contraintes » et le point demandé en entier, puis seulement les fichiers qu'il cite. À la fin : coche les étapes faites, mets à jour la colonne **Statut** de l'index, ajoute une ligne datée au « Journal du plan » en bas, et dis à l'utilisateur ce qui reste du point. Si l'utilisateur lance une idée nouvelle en cours de route, ajoute-la au plan aussitôt : un point à la suite des numéros existants (sans renuméroter), rangé dans la partie qui lui va, une ligne dans l'index, une ligne au « Journal du plan » ; et dans `vues-deplacements/contexte/journal-du-matin.md`.
|
||||
|
||||
**But :** une page `Journal` dans Explore, que le client lit comme le journal du matin : ses courbes de déplacement sur quelques jours et, dessous, **ce qui s'est passé**, une catégorie claire par événement, la zone invalidée quand il faut l'ignorer, et les images quand elles montrent la cause.
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
|
||||
## Contraintes (valent pour tous les points)
|
||||
|
||||
- **Simple d'abord.** Le plus bête qui marche sur les cas, puis on itère avec l'utilisateur. Pas d'imagination débordante, pas d'optimal, pas de stylé. À redire à tout sous-agent.
|
||||
- **La règle d'or : simple.** L'utilisateur, le 2026-10-23 : « c'est ça, la guideline, l'instruction que je dois m'imposer : ça doit être simple ; il ne faut pas chercher à faire des trucs super complexes. » Le plus bête qui marche sur les cas, puis on itère avec lui. Pas d'imagination débordante, pas d'optimal, pas de stylé ; avant d'ajouter une règle ou une constante, se demander si le client en a besoin pour comprendre. À redire à tout sous-agent.
|
||||
- **Catégorique et complet** (retour du 2026-10-23) : chaque événement a **une** catégorie, dite sans « probably », « most likely » ou « may be » ; la phrase dit ce qui s'est passé et quoi en faire.
|
||||
- **On garde toutes les données.** Invalider = griser ou mettre en retrait, jamais retirer un point de la courbe brute.
|
||||
- **Un vrai mouvement n'est jamais invalidé.** CLARIDEN (C-004) doit rester visible et marqué « à vérifier » à chaque changement.
|
||||
@@ -56,12 +56,13 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis
|
||||
| | **II. Le journal catégorique (le cœur du retour)** | | | |
|
||||
| 5 | Les catégories et leurs processus | Décider | 3 | à faire |
|
||||
| 6 | Le classement : des épisodes aux événements catégorisés | Coder | 5 | à faire |
|
||||
| 7 | Le processus « montrer les images » | Coder | 6 | à faire |
|
||||
| 7 | Le bouton `Images` : la vidéo de l'épisode | Coder | — (après 6 : sur les événements) | à faire |
|
||||
| 8 | La page Journal, catégorique et plus simple | Coder | 6, 7 | à faire |
|
||||
| 9 | Les phrases du journal | Décider, Coder | 5 | à faire |
|
||||
| 10 | Vérifier le journal catégorique sur les six jeux | Lancer, Comprendre | 6 à 9 | à faire |
|
||||
| 38 | Les statuts de visibilité : bonne, moyenne, nulle | Décider, Coder | 11 | à faire |
|
||||
| | **III. Les détecteurs, un par un** | | | |
|
||||
| 11 | `visibilite` : régler et nettoyer | Coder | 2 | à faire |
|
||||
| 11 | `visibilite` : la version simple d'abord | Coder, Décider | 2 | à faire |
|
||||
| 12 | `sauts` : régler | Coder | 2 | à faire |
|
||||
| 13 | `thermique` : ce que voit vraiment le client | Décider, Coder | 2 | à faire |
|
||||
| 14 | `turbulence` : midis agités et marge de CLARIDEN | Décider, Coder | 2 | à faire |
|
||||
@@ -94,7 +95,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis
|
||||
| | **VIII. Suivi du chantier** | | | |
|
||||
| 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | à faire |
|
||||
|
||||
Chemins conseillés : le cœur du retour, c'est **5 → 6 → 7 → 8 → 9 → 10** ; les points 1 à 4 se lisent avant si l'on veut d'abord tout comprendre ; le point 27 se lance en parallèle (il n'attend rien).
|
||||
Chemins conseillés : le plus simple et le plus parlant d'abord, **11 (visibilité simple), 38 (ses statuts : bonne, moyenne, nulle) puis 7 (bouton `Images`)**, qui marchent sans le classement ; le cœur du retour, c'est **5 → 6 → 7 → 8 → 9 → 10** ; les points 1 à 4 se lisent avant si l'on veut d'abord tout comprendre ; le point 27 se lance en parallèle (il n'attend rien).
|
||||
|
||||
---
|
||||
|
||||
@@ -185,6 +186,8 @@ Chemins conseillés : le cœur du retour, c'est **5 → 6 → 7 → 8 → 9 →
|
||||
|
||||
Le retour de l'utilisateur, en une phrase : **un événement → sa catégorie → le processus de la catégorie**. Exemple de référence : NORDEND, le 14/10 vers 05:15, 11 cibles font un aller-retour de près de 0,5 px en quelques heures ; au même moment, 22 capteurs, références comprises, sont mal vus (taches pâles à l'aube). Aujourd'hui la page dit « Sudden jump, back to normal … most likely a measurement artefact » **et** « Poor visibility … probably rain, fog… ». Demain elle doit dire une seule chose, catégorique : *Loss of visibility*, la zone est invalidée, le saut n'est pas un mouvement, et voici les images où l'on ne distingue pas les cibles.
|
||||
|
||||
Précision de l'utilisateur, le même soir : le gros saut, c'est généralement une mauvaise visibilité ; la visibilité se calcule simplement (le taux d'erreur des cibles, une par une ou en moyenne) ; quand elle est mauvaise, on le dit, et un bouton `Images` sur l'épisode ouvre une petite vidéo (timelapse) qui commence un peu avant et finit un peu après : le client voit tout de suite. D'où les points 11 (visibilité simple) et 7 (le bouton).
|
||||
|
||||
### Point 5 : Les catégories et leurs processus
|
||||
|
||||
**Pourquoi.** Le classement (point 6), les images (point 7) et la page (point 8) en dépendent. C'est une décision de l'utilisateur, sur proposition.
|
||||
@@ -193,14 +196,14 @@ Le retour de l'utilisateur, en une phrase : **un événement → sa catégorie
|
||||
|
||||
| Clé | Label du site | Familles de la carte | Épisodes qui la font | Zone | Processus |
|
||||
|---|---|---|---|---|---|
|
||||
| `visibilite_perdue` | Loss of visibility | pluie, brume, buée, neige, références masquées | `visibilite` « Poor visibility » | invalidée | montrer les images (avant, pendant, après) |
|
||||
| `passage` | Passing obstacle | passage (train, véhicule) | `visibilite` « Brief obstruction » | invalidée (l'instant) | montrer l'image de l'instant et celle d'avant |
|
||||
| `cible_masquee` | Target hidden | feuilles, plante, neige sur une cible, éclairage | `visibilite` « Target obscured » | invalidée pour ces cibles seulement (point 18) | montrer la cible en gros plan, avant et pendant |
|
||||
| `visibilite_perdue` | Loss of visibility | pluie, brume, buée, neige, références masquées | `visibilite` « Poor visibility » | invalidée | bouton `Images` (point 7) ; deux niveaux possibles (point 38) |
|
||||
| `passage` | Passing obstacle | passage (train, véhicule) | `visibilite` « Brief obstruction » | invalidée (l'instant) | bouton `Images` (point 7) |
|
||||
| `cible_masquee` | Target hidden | feuilles, plante, neige sur une cible, éclairage | `visibilite` « Target obscured » | invalidée pour ces cibles seulement (point 18) | bouton `Images` (point 7) |
|
||||
| `turbulence` | Heat haze | turbulence | `turbulence` | invalidée si forte | aucune image ; une phrase |
|
||||
| `cycle_thermique` | Daily thermal cycle | cycle thermique | `thermique` | **gardée** (normal) | aucun ; une phrase |
|
||||
| `trou` | No data | trou de données | `trous` | rien à griser (pas de point) | aucun |
|
||||
| `saut_bref` | Brief jump | saut sans autre explication | `sauts` « back to normal » seul | invalidée | montrer les images (avant, pendant, après) |
|
||||
| `a_verifier` | Shift to check | tout a bougé, une cible a sauté | `sauts` « Lasting shift » ou « Jump, not back yet » | **gardée, jamais invalidée** | montrer les images d'avant et d'après, et un lien vers `Diagnosis` |
|
||||
| `saut_bref` | Brief jump | saut sans autre explication | `sauts` « back to normal » seul | invalidée | bouton `Images` (point 7) |
|
||||
| `a_verifier` | Shift to check | tout a bougé, une cible a sauté | `sauts` « Lasting shift » ou « Jump, not back yet » | **gardée, jamais invalidée** | bouton `Images` (point 7) et un lien vers `Diagnosis` |
|
||||
|
||||
**Règles de regroupement proposées** (appliquées au point 6) :
|
||||
- un épisode `sauts` « back to normal » qui chevauche un épisode `visibilite` ou `turbulence` est **absorbé** : il n'est plus un événement, la phrase de l'événement dit que le saut de N cibles dans cette période n'est pas un mouvement ;
|
||||
@@ -212,7 +215,8 @@ Le retour de l'utilisateur, en une phrase : **un événement → sa catégorie
|
||||
- [ ] Le cycle thermique : « normal, gardé » (détecteur) ou « à ignorer » (carte) ?
|
||||
- [ ] `saut_bref` : une catégorie à part, ou toujours « Loss of visibility » quand il y a des rejets autour ?
|
||||
- [ ] Une reprise de saut pendant une perte de visibilité (C-002, le 31/07 à 20:30, 13 cibles, une heure avant la fin des données) : `a_verifier` ou absorbée ?
|
||||
- [ ] Le processus de chaque catégorie : les images, oui ou non, lesquelles.
|
||||
- [ ] Le processus de chaque catégorie : le bouton `Images`, oui ou non.
|
||||
- [ ] La perte de visibilité en deux niveaux, « Reduced visibility » (données moyennes) et « No visibility » (on ne voit rien) : point 38.
|
||||
|
||||
**Étapes.**
|
||||
- [ ] Présenter le tableau et les règles ; noter les réponses.
|
||||
@@ -230,7 +234,7 @@ Le retour de l'utilisateur, en une phrase : **un événement → sa catégorie
|
||||
- Modifier : `vues-deplacements/maquette/explore.py` (`journal()` l. 172-185 déménage dans `categories.py` ; `build()` appelle `categories.evenements(mesures)`).
|
||||
|
||||
**Interfaces.**
|
||||
- `CATEGORIES: dict[str, dict]` : clé → `{"label": str, "ignore": bool, "process": "images" | "image_instant" | "gros_plan" | "aucun" | "verifier", "ordre": int}`, recopié du tableau validé au point 5.
|
||||
- `CATEGORIES: dict[str, dict]` : clé → `{"label": str, "ignore": bool, "process": "images" | "aucun" | "verifier", "ordre": int}`, recopié du tableau validé au point 5.
|
||||
- `detecteurs() -> list[module]` : les modules de `vues-deplacements/journal/*.py` qui ont `detect` (le code actuel de `explore.journal`, déplacé tel quel).
|
||||
- `classer(episodes: list[dict], references: set[str]) -> list[dict]` : événements triés par `start`, chacun `{"start", "end", "category", "label", "text", "ignore", "sensors", "process", "episodes": [épisodes absorbés ou d'origine]}` ; `references` = capteurs `global_ref` (pour la phrase : « including the reference points »).
|
||||
- `evenements(mesures) -> list[dict]` : `classer` appliqué aux épisodes de tous les détecteurs ; c'est ce que la page reçoit dans `D.journal`.
|
||||
@@ -246,33 +250,38 @@ Le retour de l'utilisateur, en une phrase : **un événement → sa catégorie
|
||||
|
||||
**Fini quand.** Les deux contrôles ci-dessus passent ; la page se construit encore (annexe B).
|
||||
|
||||
### Point 7 : Le processus « montrer les images »
|
||||
### Point 7 : Le bouton `Images` : la vidéo de l'épisode
|
||||
|
||||
**Pourquoi.** « On monte les images. Parce que ça va être clair pour le client » : il voit le gros saut, lit la catégorie, voit les cibles invisibles, et passe à la suite. L'idée des petits GIF du brainstorming entre ici.
|
||||
**Pourquoi.** Retour de l'utilisateur (2026-10-23) : « comment est-ce qu'on fait pour prouver, montrer au client qu'il y a une mauvaise visibilité ? Une petite vidéo. » Le gros saut qui monte et redescend, c'est généralement une mauvaise visibilité : souvent, pendant plusieurs heures, on ne voit rien. On le dit, et sur l'épisode un bouton ouvre le timelapse des images de la plage, **un peu avant et un peu après**, pour encadrer l'épisode par des moments où tout va bien : le client voit les cibles nettes, puis plus rien, puis nettes à nouveau, et comprend tout de suite que l'anomalie est une mauvaise visibilité. C'est l'idée des petits GIF du brainstorming.
|
||||
|
||||
**Ce qui existe.**
|
||||
- `D.images` : `[{t, src}]`, toutes les images du dossier avec leur heure UTC (déjà dans la page, pour l'onglet View) ; `D.view` : le cadre des capteurs dans l'image (± 150 px) ; l'onglet View sait déjà afficher une image, zoomer sur les cibles et dessiner les cercles colorés selon `error_value`.
|
||||
- `D.images` : `[{t, src}]`, toutes les images du dossier avec leur heure UTC (déjà dans la page, pour l'onglet View) ; `D.view` : le cadre des capteurs dans l'image (± 150 px) ; l'onglet View sait déjà afficher une image, zoomer sur les cibles, jouer un film (`▶ Play`, 2, 4 ou 8 images par seconde) et dessiner les cercles colorés selon `error_value`.
|
||||
- `agents/diagnostic/outils/vignettes.py` : grille PNG de vignettes (capteurs × heures), pour l'agent et les fiches de cas ; pas pour la page.
|
||||
- Images disponibles : NORDEND d'octobre au pas de 15 min (985 images) ; NORDEND de juillet, WILDSTRUBEL, CLARIDEN à 10 min ; NIEDERHORN horaire ; PS des Coudres 24 images horaires (13/10 12:00 → 14/10 11:00).
|
||||
|
||||
**Décisions prises ici** (à confirmer en passant) : tout en HTML et JS dans la page, sans fabriquer de GIF (un « film » qui fait défiler les images suffit et ne demande rien de nouveau) ; images recadrées sur le cadre des capteurs (`D.view`), comme le zoom « Targets » de View.
|
||||
**Décisions prises ici.**
|
||||
- Un bouton `▶ Images` sur chaque entrée du journal qui a des images à montrer (perte de visibilité, saut bref, passage, cible masquée) ; un clic ouvre une fenêtre par-dessus la page qui joue le timelapse ; Échap ou un clic à côté la ferme.
|
||||
- Plage : du début de l'épisode moins une marge à sa fin plus la marge ; marge = la moitié de la durée de l'épisode, 1 h au moins, 6 h au plus (à régler à l'œil avec l'utilisateur).
|
||||
- Le timelapse : images recadrées sur le cadre des cibles (`D.view`, comme le zoom « Targets » de View), 4 images par seconde, en boucle ; sur chaque image, l'heure UTC et un repère `Before` / `During` / `After` (bord rouge pendant l'épisode) ; boutons pause et image par image. Au-delà de 60 images, on n'en garde qu'une sur deux, une sur trois…
|
||||
- Pas de fichier GIF : le timelapse est joué dans la page en JS, rien à fabriquer ni à installer (Pillow n'est pas installé). Un vrai GIF ne viendra que si la vraie application en a besoin (point 36).
|
||||
- Pas d'image dans la plage : le bouton est grisé, avec « No camera image for this period. »
|
||||
- **Ce point ne dépend pas du classement** (point 6) : il marche dès aujourd'hui sur les épisodes `ignore` des détecteurs ; après le point 6, sur les événements.
|
||||
|
||||
**Fichiers.**
|
||||
- Modifier : `vues-deplacements/maquette/explore_template.html` (volet `#journal` et JS du journal).
|
||||
**Fichiers.** Modifier `vues-deplacements/maquette/explore_template.html` (volet `#journal`, CSS et JS du journal) ; `vues-deplacements/maquette/spec.md` (section « L'onglet Journal »).
|
||||
|
||||
**Interfaces.**
|
||||
- Consomme : `D.journal[i].process`, `start`, `end`, `sensors` (point 6) ; `D.images`, `D.view`.
|
||||
- Produit : `jImages(ev) -> [{t, src, role: "before" | "during" | "after"}]` en JS : la dernière image avant `start` (2 h au plus avant), jusqu'à 3 images pendant (début, milieu, fin), la première image après `end` (2 h au plus après) ; liste vide si aucune.
|
||||
- Consomme : une entrée du journal (`start`, `end`, `ignore`, et `process` après le point 6) ; `D.images`, `D.view`.
|
||||
- Produit : en JS, `jFrames(ev) -> [{t, src, role}]` (`role` : `"before"`, `"during"` ou `"after"`) et `openTimelapse(ev)`, qui ouvre la fenêtre.
|
||||
|
||||
**Étapes.**
|
||||
- [ ] Écrire `jImages` ; pour `image_instant`, l'image la plus proche de `start` (10 min près) et celle d'avant ; pour `gros_plan`, les mêmes que `images`, recadrées sur la ou les cibles de `sensors` (± 60 px).
|
||||
- [ ] Sous l'entrée du journal, une bande de 3 à 5 images avec leur heure et leur rôle (Before / During / After) ; s'il n'y en a pas : « No camera image for this period. »
|
||||
- [ ] Un bouton `▶ Play` qui fait défiler toutes les images de `start − 1 h` à `end + 1 h` dans la bande, 2 images par seconde (le « GIF »).
|
||||
- [ ] Un lien `Open in View` qui ouvre l'onglet View sur la première image « During » (fonctions existantes `activate` et `setT`).
|
||||
- [ ] Contrôle du point d'attention 4 : capturer PS des Coudres sur le 13/10 à 01:15 (`#tab=journal&from=2026-10-12`) : le message « No camera image for this period. » s'affiche.
|
||||
- [ ] Capturer NORDEND d'octobre sur le 14/10 05:15 : on voit l'image d'avant (cibles nettes), celles de pendant (taches pâles), celle d'après.
|
||||
- [ ] Écrire `jFrames` (plage avec marge, une image sur n au-delà de 60) et `openTimelapse` (fenêtre, lecture en boucle à 4 images par seconde, pause, image par image, Échap).
|
||||
- [ ] Ajouter le bouton `▶ Images` aux entrées du journal (et au clic sur la barre de la frise, si c'est simple) ; grisé sans image.
|
||||
- [ ] Lire `#tab=journal&play=<n>` dans l'adresse pour ouvrir le timelapse de l'entrée n dès le chargement (pour les captures).
|
||||
- [ ] Contrôle : NORDEND d'octobre, le 14/10 vers 05:15 : le timelapse montre les cibles nettes avant, les taches pâles pendant, nettes après ; capture de la fenêtre ouverte.
|
||||
- [ ] Contrôle du point d'attention 4 : PS des Coudres le 13/10 à 01:15 (`#tab=journal&from=2026-10-12`) : bouton grisé, « No camera image for this period. »
|
||||
- [ ] Montrer à l'utilisateur ; régler la marge et la vitesse à son œil ; mettre la spec à jour.
|
||||
|
||||
**Fini quand.** Les deux captures montrent le bon comportement.
|
||||
**Fini quand.** En cliquant sur `▶ Images` le 14/10 à NORDEND, l'utilisateur voit tout de suite que le saut est une perte de visibilité.
|
||||
|
||||
### Point 8 : La page Journal, catégorique et plus simple
|
||||
|
||||
@@ -343,31 +352,75 @@ Le retour de l'utilisateur, en une phrase : **un événement → sa catégorie
|
||||
|
||||
**Fini quand.** CLARIDEN n'est jamais grisé, NORDEND le 14/10 n'a qu'un événement, et l'utilisateur valide les six captures.
|
||||
|
||||
### Point 38 : Les statuts de visibilité : bonne, moyenne, nulle
|
||||
|
||||
**Pourquoi.** L'utilisateur, le 2026-10-23 : « on peut catégoriser : il y a des cas où la visibilité est vraiment affreuse, et des cas où elle n'est pas très bonne. Quand il pleut, la visibilité n'est pas très bonne, c'est moyen, les données sont moyennes ; et il y a des moments où vraiment on ne voit rien. » Et : « c'est là où on revient un peu sur les statuts : on veut faire des statuts des cibles. » Comme les statuts des métriques système (Energy, Storage, Cellular, Temperature : vert, orange, rouge), un statut de visibilité, par cible et pour la station. Placé ici, dans la partie II, parce qu'il change la catégorie « perte de visibilité » du point 5.
|
||||
|
||||
**Proposition à valider.**
|
||||
|
||||
| Statut | Couleur | Ce qu'on voit | Phrase au client (à valider au point 9) | Sur les courbes |
|
||||
|---|---|---|---|---|
|
||||
| Good visibility | vert | `error_value` loin du seuil | rien, pas d'entrée au journal | rien |
|
||||
| Reduced visibility | orange | `error_value` qui approche le seuil, quelques rejets ; la pluie de C-005 (nuits du 01 et du 02/10), sans doute la buée de C-001 | « Visibility was reduced (see images): the data in this period are less precise. » | zone en léger retrait (gris très clair ou hachures), données gardées |
|
||||
| No visibility | rouge | la plupart des capteurs rejetés : NORDEND le 09/10 à 23:00 (17 capteurs), la toile de C-002 | « The camera could not see the targets: ignore the curves in this period. » | zone grisée |
|
||||
|
||||
- **Calcul**, dans l'esprit du point 11 : le rapport `error_value / error_threshold` de chaque cible, et sa moyenne pour la station. La page le colore déjà ainsi dans l'onglet View (`errorColor` dans `explore_template.html` : vert loin du seuil, orange à son approche, rouge au-dessus). Deux limites sur la moyenne (et sur la part de cibles rejetées) séparent les trois statuts.
|
||||
- **Par cible** : le même statut, cible par cible (une bande par cible dans la couche support, point 23).
|
||||
- **Statut du jour** : le pire statut tenu au moins une heure dans la journée, comme la couleur du jour des métriques système. C'est ce qu'un bloc `Visibility` pourrait montrer dans la vue client « System Summary » et dans les notifications du support (maquettes, D-039), si l'utilisateur le demande.
|
||||
- **Effet sur le point 5** : si le tableau est validé, la catégorie `visibilite_perdue` devient deux catégories, `visibilite_reduite` (données gardées, en retrait) et `visibilite_nulle` (invalidée), toutes deux avec le bouton `Images` (point 7).
|
||||
|
||||
**À décider par l'utilisateur.**
|
||||
- [ ] Trois statuts, ou plus ?
|
||||
- [ ] « Reduced » : données gardées en retrait, ou invalidées elles aussi ?
|
||||
- [ ] Le statut se montre-t-il comme une bande de couleur continue sous les courbes (plus simple qu'une suite d'épisodes) ?
|
||||
- [ ] Un statut de visibilité du jour dans la vue client et chez le support : maintenant ou plus tard ?
|
||||
|
||||
**Fichiers.**
|
||||
- Modifier : `vues-deplacements/journal/visibilite.py` (version simple du point 11) : les épisodes portent un niveau ; contrat d'épisode : champ facultatif `"level": "reduced" | "none"` (les autres détecteurs ne le mettent pas).
|
||||
- Modifier : `vues-deplacements/maquette/explore_template.html` : une bande de statut sous les courbes du Journal, au-dessus de la frise.
|
||||
|
||||
**Étapes.**
|
||||
- [ ] Faire valider le tableau ; reporter le choix au point 5 (catégories) et au point 9 (phrases).
|
||||
- [ ] Dans la version simple de `visibilite.py`, deux limites sur la moyenne, `REDUIT` et `NUL` (provisoires, réglées à l'œil : pluie de C-005 = Reduced, NORDEND le 09/10 à 23:00 = None ; registre du point 17) ; un épisode par période de même statut, avec son `level`.
|
||||
- [ ] La bande de statut (vert, orange, rouge) sous les courbes du Journal, mesure par mesure ; épisodes `reduced` en léger retrait, `none` grisés.
|
||||
- [ ] Vérifier sur les six jeux et montrer : C-005, les deux nuits de pluie en orange ; C-002, la toile en rouge ; NORDEND le 09/10 à 23:00 en rouge ; C-001 (buée) et C-003 (turbulence) : orange ou rien, à juger par l'utilisateur.
|
||||
- [ ] Reporter les statuts validés dans `docs/displacement/domaine/carte-des-evenements.md` (section 4 du point 5) et sous D-056.
|
||||
|
||||
**Fini quand.** L'utilisateur distingue d'un coup d'œil « données moyennes » et « on ne voit rien » sur les six jeux.
|
||||
|
||||
---
|
||||
|
||||
## Partie III — Les détecteurs, un par un
|
||||
|
||||
Chaque point : on le règle sur les cas, on relance les six jeux, on met à jour la docstring (méthode et résultats) et le registre du point 17. Ne jamais régler un seuil sur un seul jeu sans relancer les cinq autres.
|
||||
|
||||
### Point 11 : `visibilite` : régler et nettoyer
|
||||
### Point 11 : `visibilite` : la version simple d'abord
|
||||
|
||||
**Ce qui existe.** `vues-deplacements/journal/visibilite.py` : mesure « haute » = `error_value` > médiane + `K_MAD` (10) MAD **et** > `FACTEUR` (2) × médiane du capteur, sur tout l'export (relatif au capteur et non au seuil, car la buée de C-001 reste sous le seuil) ; `Brief obstruction` si ≥ `BREF_MIN` (3) capteurs hauts à un instant, `SAILLIE` (3) fois plus qu'aux instants voisins ; `Poor visibility` : suites d'au moins `SUITE_MIN` (3) mesures hautes, réunies entre capteurs (≥ 2), réduites aux instants où ≥ `FRAC` (15 %) du pic est haut, coupées par une accalmie de `COUPURE` (2 h) ; `Target obscured` : une cible rejetée et à plus de `K_CIBLE` (5) MAD, au moins `CIBLE_MIN` (3) fois à moins de `CIBLE_ECART` (6 h) ; `ECART` 2,5 pas entre deux mesures d'une suite.
|
||||
**Pourquoi.** Retour de l'utilisateur (2026-10-23) : la ligne Visibility de la v0 est « super bien », et « c'est facile de calculer la visibilité des cibles : soit individuellement, soit faire la moyenne des visibilités. Et on peut détecter facilement quand les taux d'erreur sont élevés ; dans ces cas-là, on indique qu'il y a une mauvaise visibilité ». La guideline est la simplicité. La v0 marche mais a grossi : 11 constantes, médianes et MAD par capteur, trois sorties.
|
||||
|
||||
**Défauts connus.**
|
||||
- `Target obscured` est la sortie la plus bruitée : à NORDEND d'octobre, CTR01, PR04 et PR09, souvent rejetées, donnent des épisodes jusqu'à un jour ; l'image du 13/10 à 20:00 paraît normale.
|
||||
- Le train du 03/10 10:00 (C-005, 2 cibles) est manqué (`BREF_MIN` = 3).
|
||||
- La pluie du 01/10 commence à 06:00 contre 05:00 dans la vérité.
|
||||
- WILDSTRUBEL : deux `Brief obstruction` (02/09 12:00, 03/09 08:15) probablement dus à la turbulence ; celui du 04/09 14:00 est plausible (véhicule et image fantôme sur la route).
|
||||
- Le texte de `Brief obstruction` cite « train, vehicle or animal » même dans le tunnel de CLARIDEN (réglé par le point 9 : plus de cause dans le texte).
|
||||
- Le niveau habituel est calculé sur tout l'export, donc après coup (pas causal).
|
||||
**La version simple, à essayer d'abord.**
|
||||
- Visibilité d'une cible, à chaque mesure : `error_value / error_threshold` (1 ou plus = mesure rejetée).
|
||||
- Visibilité de la station : la moyenne de ce rapport sur les capteurs mesurés. C'est exactement la bande du haut de l'onglet View (spec, section « L'onglet View »), déjà calculée en JS pour la page.
|
||||
- `Loss of visibility` quand la moyenne dépasse un niveau pendant quelques mesures d'affilée ; `Passing obstacle` quand elle le dépasse sur une seule mesure ; `Target hidden` quand une cible dépasse son seuil plusieurs fois alors que la moyenne reste basse. Tout est grisé ; le bouton `Images` du point 7 apporte la preuve.
|
||||
- Trois constantes au plus (le niveau de la moyenne, le nombre de mesures d'affilée, le nombre de rejets d'une cible), réglées à l'œil sur les cas et inscrites au registre du point 17.
|
||||
- Risque connu : la buée de C-001 reste **sous le seuil** des références ; c'est pour cela que la v0 compare chaque capteur à son propre niveau. La version simple la manquera peut-être : le mesurer et le dire à l'utilisateur, qui tranche (simple et imparfait d'abord, selon sa règle).
|
||||
|
||||
**Étapes.**
|
||||
- [ ] `Target obscured` : exiger aussi que la cible soit rejetée bien plus souvent que d'habitude (part de rejets dans l'épisode face à celle de tout l'export) ; vérifier que CTR01, PR04, PR09 sortent à NORDEND et que les feuilles de C-005 et PA_9 de WILDSTRUBEL restent.
|
||||
- [ ] Ne pas compter un `Brief obstruction` pendant un épisode `turbulence` (les deux de WILDSTRUBEL) ; à faire dans le classement (point 6) plutôt qu'ici si c'est plus simple.
|
||||
- [ ] Laisser le train à 2 cibles manqué (le gagner coûte des faux positifs) ; le noter dans la docstring.
|
||||
- [ ] Relancer les six jeux ; mettre à jour la docstring et le registre.
|
||||
- [ ] Mettre la v0 de côté : la copier dans `vues-deplacements/journal/archive/visibilite_v0.py` (le chargeur ne lit que `journal/*.py`, pas les sous-dossiers).
|
||||
- [ ] Réécrire `vues-deplacements/journal/visibilite.py` en version simple, même contrat, labels du point 9.
|
||||
- [ ] Lancer les six jeux ; un tableau v0 contre version simple, face à la vérité du point 10 : ce que la simple attrape, ce qu'elle manque (C-001, le train à 2 cibles, les feuilles, les obstructions de WILDSTRUBEL).
|
||||
- [ ] Montrer le tableau à l'utilisateur ; garder la simple si elle suffit à ses yeux, sinon ne reprendre de la v0 que ce qui manque.
|
||||
- [ ] Docstring (méthode et résultats) et registre du point 17 à jour.
|
||||
|
||||
**Fini quand.** NORDEND d'octobre n'a plus d'épisode `Target obscured` d'une journée, et C-005 garde ses feuilles.
|
||||
**La v0, pour mémoire** (`archive/visibilite_v0.py` après la première étape) : mesure « haute » = `error_value` > médiane + `K_MAD` (10) MAD **et** > `FACTEUR` (2) × médiane du capteur, sur tout l'export ; `Brief obstruction` si ≥ `BREF_MIN` (3) capteurs hauts à un instant, `SAILLIE` (3) fois plus qu'aux instants voisins ; `Poor visibility` : suites d'au moins `SUITE_MIN` (3) mesures hautes, réunies entre capteurs (≥ 2), réduites aux instants où ≥ `FRAC` (15 %) du pic est haut, coupées par une accalmie de `COUPURE` (2 h) ; `Target obscured` : une cible rejetée et à plus de `K_CIBLE` (5) MAD, au moins `CIBLE_MIN` (3) fois à moins de `CIBLE_ECART` (6 h) ; `ECART` 2,5 pas entre deux mesures d'une suite. Ses défauts connus, à ne corriger que si l'on en garde des morceaux :
|
||||
- `Target obscured` est la sortie la plus bruitée : à NORDEND d'octobre, CTR01, PR04 et PR09, souvent rejetées, donnent des épisodes jusqu'à un jour ; l'image du 13/10 à 20:00 paraît normale ;
|
||||
- le train du 03/10 10:00 (C-005, 2 cibles) est manqué (`BREF_MIN` = 3) ;
|
||||
- la pluie du 01/10 commence à 06:00 contre 05:00 dans la vérité ;
|
||||
- WILDSTRUBEL : deux `Brief obstruction` (02/09 12:00, 03/09 08:15) probablement dus à la turbulence (à écarter dans le classement, point 6) ; celui du 04/09 14:00 est plausible (véhicule et image fantôme sur la route) ;
|
||||
- le texte de `Brief obstruction` cite « train, vehicle or animal » même dans le tunnel de CLARIDEN (réglé par le point 9) ;
|
||||
- le niveau habituel est calculé sur tout l'export, donc après coup.
|
||||
|
||||
**Fini quand.** L'utilisateur a choisi entre la version simple et la v0, sur le tableau des six jeux.
|
||||
|
||||
### Point 12 : `sauts` : régler
|
||||
|
||||
@@ -746,3 +799,5 @@ Depuis `/home/maxime/Support-Agent`.
|
||||
Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
|
||||
|
||||
- 2026-10-23 : plan écrit à partir de la conversation du 2026-10-23 (brainstorming vocal, huit agents, v0 de l'onglet Journal, retour de l'utilisateur sur la v0).
|
||||
- 2026-10-23 : suggestion de l'utilisateur ajoutée : la simplicité comme règle d'or (Contraintes), la visibilité simple (point 11 réécrit), le bouton `Images` et son timelapse avec marge avant et après (point 7 réécrit) ; chemin conseillé : 11 puis 7.
|
||||
- 2026-10-23 : suggestion de l'utilisateur ajoutée : les statuts de visibilité, bonne, moyenne (« les données sont moyennes », la pluie) et nulle (« on ne voit rien »), par cible et pour la station, comme les statuts des métriques système (point 38, nouveau, rangé dans la partie II) ; processus du point 5 ramenés au seul bouton `Images`.
|
||||
Reference in new issue
Block a user