docs(docs): U2 owner trial section and gate figures

OWNER_TRIAL §4.17: db:trial preparation, mouse and tablet steps, visible choices to judge, invented strings, known limits, measures. Plan Task 10 Step 3 and UX_TESTS performance row: commit latency figures. CLAUDE.md cites the two hand-run measure specs.
This commit is contained in:
bchanot committed 2026-11-18 12:20:49 +01:00
1 parent e6f47280ad
commit c6b8c7e48a
4 files changed
+188 -2

No files matched your search

@@ -1314,6 +1314,15 @@ Behaviour:
Record the counts.
- [ ] **Step 3:** commit latency under 500 ms for a vertex drag, an insert and a removal (`editor-equine.spec.ts`
through its sandbox alias).
- Ruling (T10): measured by the opt-in `shell/editor-measure-commit.spec.ts` (`support/measure-commit.ts`) on a
run-seeded equine-sized draft, never `editor-equine.spec.ts` nor the historical copy.
- Measured 2026-11-18 (`MEASURE_COMMIT=1 MEASURE_BUILD=preview`, production build under `vite preview`, Chromium
mouse 1 280 × 800, CPU ×4 during each gesture, « Vertèbres thoraciques » of the seeded draft, three runs per
gesture, each undone). From the `pointerup` time stamp to the end of the first frame, after paint, showing the
new `points`, no old-place outline and « Défaire la dernière modification » enabled (the undo entry). Median /
max: drag 176.9 / 209.2 ms, « + » 176.2 / 177.6 ms, « − » 168.2 / 170.3 ms; a second spec run gave 176.0 /
209.1, 176.1 / 186.1, 169.5 / 175.3 ms. All under the 500 ms bar. A dev-server smoke run (React development
build) gave medians 337.3, 329.1 and 272.2 ms, max 399.3 ms; it does not stand for the product.
- [ ] **Step 4:** fresh `verifier` against the U2 implementation contract (written at the start of execution with
the owner's approval brief verbatim), and fresh `security-auditor` on the U2 diff, once each.
- [ ] **Step 5:** owner trial section `docs/development/V1-2-6_OWNER_TRIAL.md` §4.17 « Démonstration U2 », on the
+1 -1
View File
@@ -275,7 +275,7 @@ faunosteo/
├─ tests/
│ ├─ setup.ts
│ └─ unit/*.test.ts
├─ e2e/ ← Playwright (V1-1.3): playwright.{ui,shell}.config.ts, support/{browser,sandbox,shell,records,admin,catalogue}.ts, ui/*.spec.ts, shell/*.spec.ts (V1-2.5: admin, catalogue; V1-2.6 R2: editor-references, editor-citations; R3: admin-sheets-list; V1-2.6 U2: editor-zones, editor-properties, editor-touch, `support/layout.ts` (`expectNoShift`)), harness/{dialog,working-copy}.{html,tsx} (dev server only, never built)
├─ e2e/ ← Playwright (V1-1.3): playwright.{ui,shell}.config.ts, support/{browser,sandbox,shell,records,admin,catalogue}.ts, ui/*.spec.ts, shell/*.spec.ts (V1-2.5: admin, catalogue; V1-2.6 R2: editor-references, editor-citations; R3: admin-sheets-list; V1-2.6 U2: editor-zones, editor-properties, editor-touch, `support/layout.ts` (`expectNoShift`); hand-run measures editor-measure-{drag,commit}, skipped unless `MEASURE_DRAG=1` / `MEASURE_COMMIT=1`), harness/{dialog,working-copy}.{html,tsx} (dev server only, never built)
├─ docker/
│ ├─ entrypoint.sh ← injects env.js at container start
│ └─ nginx.conf ← SPA fallback + PORT envsubst
+177
View File
@@ -680,6 +680,183 @@ Résultat du 17 novembre 2026 : essai fait par le propriétaire sur la sandbox (
compte créé pour l'occasion et le seul droit `catalog_reader`. Toutes les étapes fonctionnent. R4 est validé.
L'archivage des fiches de test est confirmé, et les règles sur les fiches ayant eu une version publiée ne changent pas.
### 4.17 Démonstration U2 : modifier les annotations directement sur le dessin
À faire sur la pile d'essai (`db:trial`), dans l'application d'essai `http://<host>:5194`, avec le compte praticien
d'essai (rôle `admin` et habilitation `sheet_editor`), double authentification faite. Planches :
`docs/design/v1-2-6-u2/` (arbitrages A1 à A15). U2 n'ajoute aucune migration : la pile garde ses données, l'application
sert le code de cette branche. Claude n'écrit rien sur la pile d'essai : vous lancez vous-même les commandes.
Préparation. Une commande à la fois, depuis la racine du worktree :
```bash
pnpm db:trial status
pnpm db:trial start
pnpm db:trial app
```
`status` ne modifie rien. Lisez deux lignes de sa sortie avant de continuer :
- sous « migrations », la ligne « applied files unchanged; new: … » doit finir par « none ». Si elle nomme un fichier,
lancez `pnpm db:trial migrate` (il fait d'abord une sauvegarde, puis applique les nouvelles migrations de la
branche) ;
- « drawings uploaded and confirmed: n/n » doit montrer deux nombres égaux. Sinon, lancez `pnpm db:trial assets`
(il envoie les dessins équins par la passerelle de la pile, puis les vérifie).
Si `status` dit « database stopped », `start` relance les mêmes conteneurs, données gardées. `app` affiche l'adresse
(« trial app: http://… ») ; Ctrl+C l'arrête, la pile continue de tourner.
La fiche. Ouvrez la copie de travail de la fiche équine (Administration, « Fiches officielles », sa rangée, puis
« Ouvrir le brouillon »), onglet « Annotations », vue principale. Chaque geste ci-dessous modifie le brouillon. Pour
garder la copie telle qu'elle est, défaites chaque geste comme demandé et ne cliquez pas, à la fin, le bouton
« Enregistrer » de l'éditeur (celui qui enregistre le brouillon) : quitter l'éditeur vous demandera alors
confirmation, c'est attendu. Le bouton « Enregistrer » de la boîte des propriétés (étape 8) ne fait que modifier le
brouillon ouvert, comme un geste sur le dessin.
Chaque étape donne l'action, puis l'attendu. Pendant tout l'essai, une règle vaut pour chaque étape : quand un
message apparaît ou disparaît sous le dessin, ni le dessin ni la bande au-dessus ne bougent, même d'un pixel. Notez
toute étape où quelque chose saute.
Souris, à 1 280 px :
1. Déplacer un point. Action : dans la liste « Annotations de la vue », cliquez une rangée de type point, puis
glissez le point sur le dessin. Attendu : le point suit la souris et se pose au relâchement ; sous le dessin,
« Point déplacé · Défaire ». Cliquez « Défaire » dans ce message : le point revient. Refaites le déplacement par
« Déplacer le point » dans la bande : les flèches à l'écran (ou celles du clavier) le déplacent, l'ancienne place
reste en pointillé gris, « Valider la position » enregistre, « Annuler » rend la place d'origine. Défaites.
2. Changer sa taille. Action : le point toujours sélectionné, faites glisser le curseur « Taille » de la bande, puis
relâchez. Attendu : un seul message « Taille modifiée · Défaire » au relâchement, quel que soit le nombre de
crans parcourus. Défaites.
3. Sélectionner « Vertèbres thoraciques ». Action : cliquez sa rangée dans la liste. Attendu : la zone montre ses
sommets ; au zoom d'ajustement, la bande affiche « Zoomez pour ajouter un sommet sur les segments courts. » et
certains « + » manquent. Zoomez (molette ou boutons de zoom) jusqu'à voir un « + » au milieu de chaque segment.
4. Glisser un sommet. Action : glissez un sommet de la zone. Attendu : « Sommet déplacé · Défaire », le sommet est
« choisi » (la bande dit « sommet n choisi »). Défaites.
5. Ajouter puis retirer un sommet. Action : cliquez un « + ». Attendu : « Sommet ajouté », le nouveau sommet est
choisi et un « − » apparaît à côté de lui. Cliquez ce « − ». Attendu : « Sommet retiré ». Défaites les deux
gestes, un par un.
6. Déplacer la zone. Action : glissez l'intérieur de la zone, puis refaites-le par « Déplacer la zone » dans la bande
(flèches, puis « Valider la position »). Attendu : la zone bouge d'un bloc, « Zone déplacée · Défaire ».
Défaites.
7. Redessiner puis annuler. Action : « Redessiner », posez trois ou quatre sommets sur le dessin, puis « Annuler le
tracé ». Attendu : la zone garde sa forme d'origine, rien n'entre dans l'historique (« Défaire » de l'en-tête ne
change rien de plus).
8. Les propriétés. Action : « Propriétés » dans la bande, ou un double clic sur la zone sélectionnée. Attendu : la
boîte s'ouvre au-dessus de la colonne de droite, jamais sur le dessin. Un clic sur le voile gris ne la ferme pas.
« Modifier », changez le nom anglais, « Enregistrer » en bas de la boîte. Attendu : « Modifications
enregistrées ». Fermez, puis
« Défaire » dans l'en-tête : l'ancien nom revient.
9. Créer un point et une zone. Action : outil « Point », cliquez dans le dessin. Attendu : « Point placé » et la boîte
de création ; « Replacer le point » vous rend la main sur le dessin. Remplissez les noms, « Créer » : « Point
créé ». Puis outil « Zone » : posez des sommets, fermez sur le premier sommet ou par « Fermer le tracé ». Attendu :
« Zone tracée, n sommets » et la boîte ; essayez « Reprendre le tracé » (voir les choix à juger), puis « Créer » :
« Zone créée ». Pendant la création, « Défaire » est caché du message et inactif dans l'en-tête.
10. Tout défaire. Action : « Défaire » dans l'en-tête, autant de fois que nécessaire. Attendu : chaque clic défait
un geste entier (un glisser, un « + », une création), dans l'ordre inverse, jusqu'à la fiche telle qu'ouverte.
11. Quitter un mode commencé. Action : « Déplacer la zone », un appui sur une flèche, puis cliquez l'onglet
« Constats ». Attendu : « Abandonner le déplacement ? » avec « Continuer » et « Abandonner ». Refaites avec le
bouton Retour du navigateur : même question. Puis « Redessiner », un sommet posé, onglet puis Retour : « Abandonner
le nouveau tracé ? ». Enfin, entrez dans « Déplacer la zone » ou « Redessiner » sans rien faire et changez
d'onglet : le mode se termine tout de suite, sans question.
Tablette en paysage (au moins 1 024 px de large ; en dessous, l'éditeur est en lecture seule) :
12. Les mêmes étapes 1 à 11 au doigt. Attendu en plus : un doigt sur un sommet ou sur le point le déplace, avec une
loupe qui montre ce qui est sous le doigt ; la loupe suit sans saccade. Les poignées sont assez grandes pour le
doigt.
13. Le message « deux doigts ». Action : glissez un doigt sur une partie vide du dessin. Attendu : rien ne bouge et le
message « Deux doigts pour déplacer ou zoomer le dessin » s'affiche une fois. À deux doigts, le dessin se
déplace et se zoome.
14. Rotation avec une boîte ouverte. Action : ouvrez « Propriétés », commencez une saisie, puis tournez la tablette en
portrait et revenez en paysage. Attendu : la saisie est gardée. En portrait sous 1 024 px, la fiche passe en
lecture seule et « Enregistrer » est désactivé ; de retour en paysage, il redevient actif.
#### Choix visibles à juger pendant l'essai
Ces points s'écartent des planches ou n'y figurent pas. Ils ont été tranchés pendant la construction ; dites pour
chacun s'il vous convient.
Interprétations et écarts par rapport aux planches :
- « Reprendre le tracé » rouvre la ligne de sommets : chaque clic ajoute un sommet, « Retirer le dernier sommet »
(bouton en plus des deux de la planche) retire le dernier, fermer sur le premier sommet ou « Revenir aux
propriétés » rouvre la boîte. La planche 04 C dessine le polygone fermé avec ses sommets et ses « + ».
- Pendant un nouveau tracé, Échap demande « Abandonner la création ? », alors que « Annuler le tracé » abandonne tout
de suite. La planche 04 A abandonne tout de suite dans les deux cas.
- « Aller à » pendant une création pose d'abord la question, au lieu de garder la demande pour plus tard.
- Le curseur « Taille » est caché tant que la boîte de création est ouverte, et revient quand vous replacez un point
(planche 02 : visible pendant « Nouveau point »).
- La bande commence par une partie de largeur fixe (256 px) pour le nom et l'état : les commandes ne sont jamais
coupées à 1 024 px et rien ne bouge quand l'état change. En contrepartie, le nom est tronqué tôt (environ 120 px en
français, 77 px en anglais à 1 280 px, à cause de « Inherited, not reviewed »).
- Retour pendant un mode commencé : la question s'affiche ; après « Abandonner », le retour n'est pas rejoué, il faut
appuyer une seconde fois sur Retour (comme pour une modification non enregistrée aujourd'hui).
- Avec un mode commencé et des modifications non enregistrées, quitter l'éditeur pose deux questions de suite :
celle du dessin, puis celle de la fiche.
- Une série de flèches au clavier sur une poignée ou sur le curseur « Taille » (hors des modes « Déplacer … ») est
enregistrée quand vous changez d'onglet, de vue ou d'outil, ou quand vous quittez l'éditeur : elle entre dans
l'historique au lieu d'être perdue.
- Une zone de plus de 40 sommets n'a ni poignées ni glisser de l'intérieur ; ses boutons restent.
- Un accès tracé en polygone a ses sommets et « Redessiner », mais pas de « Déplacer » ; un accès en cercle se glisse
au doigt comme un point, sans curseur de taille.
- « Défaire » pendant un mode ou un nouveau tracé annule seulement ce mode ; Échap annule un nouveau tracé depuis
n'importe où dans l'éditeur ; donner le focus clavier à un sommet le choisit ; une fermeture refusée laisse le
tracé ouvert.
- Un nouveau tracé garde la sélection précédente en dessous ; un point posé ou une zone fermée la lève. Une zone trop
étroite est refusée au moment de « Créer », pas à la fermeture.
- La question de garde dit « Continuer » (et non « Continuer la saisie » comme en R2). Le mode « Déplacer … » se
quitte par « Annuler » / « Cancel », nommé dans le texte de la revue mais absent de son tableau.
- Un double clic sur une annotation non sélectionnée la sélectionne puis ouvre ses propriétés, comme sur une
annotation déjà sélectionnée.
- « Modifier la forme » donne le focus à la première poignée (un « + » quand il y en a un).
- Sous 1 024 px, la lecture des propriétés a un bouton « Désélectionner » ; en lecture seule, « Annuler » devient
« Abandonner ». Le bouton de la bande s'appelle « Propriétés » (avant : « Propriétés de l'annotation »).
- En lecture seule sans sélection, la bande reprend « Cliquez sur une annotation pour la sélectionner », sans
détail. La lecture des propriétés affiche « Aucune » pour une zone sans constat et « — » pour un nom absent (un
accès sans nom). Les icônes « Propriétés », « Modifier », « Valider » et « Supprimer » sont dessinées pour l'éditeur.
- Au toucher, l'appui est jugé au moment où le doigt se lève, sur la cible appuyée : un appui près d'un repère est un
peu plus strict qu'avant.
- Le pincement à deux doigts zoome par rapport à son début, centré sur le point de départ entre les doigts. Le
message « deux doigts » s'affiche quand le doigt se lève, pas dès le début du glisser.
- Ctrl+Z défait maintenant aussi quand le focus est sur le curseur « Taille » ou une case à cocher ; seuls les champs
de texte gardent leur propre annulation.
Libellés inventés pendant la construction (français / anglais) :
- « Sommet {n} » / « Vertex {n} » ; « Ajouter un sommet après le sommet {n} » / « Add a vertex after vertex {n} » ;
« Retirer le sommet {n} » / « Remove vertex {n} » (noms des poignées, lus par les lecteurs d'écran).
- « Accès {nom} » / « Link {name} » (nom de la poignée d'un accès).
- « Sommet déplacé » / « Vertex moved ».
- « Taille refusée : {texte} » / « Size refused: {text} ».
- « Modification refusée : {texte} » / « Change refused: {text} » (un « + » ou un « − » refusé).
- « Accès déplacé » / « Access moved » ; « Accès redessiné » / « Link redrawn » ; « Point redessiné » / « Point
redrawn ». En anglais, « Access » et « Link » désignent la même chose : à harmoniser si vous le souhaitez.
- « Accès créé » / « Link created » ; « Accès tracé, {n} sommet(s) » / « Link traced, {n} vertex/vertices ».
- « Accès · {n} sommets » / « Link · {n} vertices » (bande) ; « {détail} · fiche en lecture seule » /
« {detail} · read-only sheet ».
- « Cliquez dans le dessin pour poser le premier sommet » / « Click in the drawing to place the first vertex » ;
« Cliquez sur une annotation pour la sélectionner » / « Click an annotation to select it » ; « {n} sommets posés »
(sans point final) / « {n} vertices placed ».
- « Cette annotation n'existe plus » / « This annotation no longer exists ».
- « À compléter : {champs}. » / « To complete: {fields}. », plusieurs champs séparés par des virgules.
- « Création abandonnée : la fiche a changé. » / « Creation discarded: the sheet changed. »
- Anglais seulement : « A zone keeps at least 3 vertices » (le français vient du tableau validé).
- Anglais des libellés du tableau : « Point placed », « Zone traced, {count} vertices », « Reposition the point »,
« Resume tracing », « Discard », « Back to properties », « Tracing resumed, input kept », « Point created »,
« Zone created ».
Limites connues :
- Planche 31, trois écarts restent dans la boîte des propriétés : pas de pastille de couleur dans la liste des
catégories, les boutons « Abandonner » passent à la ligne à 352 px, l'en-tête de la boîte défile avec son contenu.
- Tablette : quand le clavier à l'écran est ouvert dans la boîte des propriétés, « Enregistrer » peut se retrouver
sous le clavier. Fermez le clavier pour l'atteindre, et dites si cela gêne.
- Les courbes (tracés libres) ne se modifient pas : « Remplacer par un polygone » reste le seul changement possible.
#### Mesures
Deux mesures ont été faites sur un brouillon équin créé pour l'occasion sur la sandbox, jamais sur la copie de
travail ni sur la fiche historique, avec Chromium sur ordinateur et un processeur ralenti quatre fois :
- la fluidité de la loupe (2026-11-18, version de production) : le travail d'une image pendant un glisser au doigt
reste sous 4,7 ms dans 95 % des cas (p95 4,2 à 4,7 ms avec la loupe, 3,6 à 4,2 ms sans), loin des 16 ms d'une image ;
- le délai d'enregistrement d'un geste (2026-11-18, version de production, souris) : du relâchement de la souris à
l'image où la nouvelle forme est affichée et où « Défaire » est disponible, trois essais par geste. Médiane et
maximum : glisser d'un sommet 177 et 209 ms, « + » 176 et 178 ms, « − » 168 et 170 ms, sous la limite de 500 ms.
Ces chiffres viennent d'un navigateur piloté par ordinateur. Le vrai contrôle est votre essai sur la tablette : si un
glisser, un « + » ou un « − » vous paraît lent ou saccadé, notez le geste et la vue.
## 5. Limites à connaître
- Risque résiduel RR-12 : les opérations du catalogue lisent la mention `aal2` du jeton, pas la session vivante.
Un jeton émis à `aal2` reste accepté après la suppression du facteur, jusqu'à son expiration (une heure).
+1 -1
View File
@@ -63,7 +63,7 @@ Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 3; boards `
| Keyboard | create a zone, add and remove a vertex, move the zone, validate, without a pointer; Ctrl+Z on a focused handle after arrow moves only cancels the preview and a later Enter commits nothing stale; after undoing « + », « − » never removes the wrong vertex; « Désélectionner » commits a pending series |
| Paths (T16) | a path annotation gets no handle, no « + » or « − », no zone move in either mode, no keyboard move; its `d` is byte-identical after every gesture on its neighbours, a save and a reload; « Remplacer par un polygone » stays the only change: explicit, validated by the core, the path kept while tracing, on Escape and on a refusal; one undo entry restoring the exact `d`, redo restoring the polygon (owner, BDR-101) |
| Accessibility | axe on selection, tracing, move states and the dialog in read and edit modes; handle names (« Point {nom} », « Sommet {n} », « Ajouter un sommet après le sommet {n} », « Retirer le sommet {n} »); live-region message after a move; WCAG 2.5.7: the move mode with four arrow buttons is the single-pointer path without dragging (A11) |
| Performance | commit latency under the 500 ms budget (`editor-equine.spec.ts`) for drag, insert and remove, measured at the gates (plan Task 10) on a run-seeded equine-sized draft, never on the historical copy; the drag smoothness is a measure, not an assertion (`e2e/support/measure-drag.ts`, `editor-measure-drag.spec.ts`, run by hand). Measured 2026-11-18 on a production build under `vite preview`, Chromium touch at 1 180 px, CPU ×4: frame work p95 4.2 to 4.7 ms with the loupe (technique A), 4.0 to 4.4 ms outline only (B), 3.6 to 4.2 ms without a loupe; technique A kept. The figures are in plan Task 8; the owner's tablet trial is the real check |
| Performance | commit latency under the 500 ms budget for drag, insert and remove, a measure run by hand at the gates (`e2e/support/measure-commit.ts`, `editor-measure-commit.spec.ts`, `MEASURE_COMMIT=1`) on a run-seeded equine-sized draft, never on the historical copy nor through `editor-equine.spec.ts`. Measured 2026-11-18 on a production build under `vite preview`, Chromium mouse at 1 280 px, CPU ×4, from the release to the painted frame showing the new geometry with the undo entry: median / max drag 176.9 / 209.2 ms, « + » 176.2 / 177.6 ms, « − » 168.2 / 170.3 ms (three runs each; figures in plan Task 10); the drag smoothness is a measure, not an assertion (`e2e/support/measure-drag.ts`, `editor-measure-drag.spec.ts`, run by hand). Measured 2026-11-18 on a production build under `vite preview`, Chromium touch at 1 180 px, CPU ×4: frame work p95 4.2 to 4.7 ms with the loupe (technique A), 4.0 to 4.4 ms outline only (B), 3.6 to 4.2 ms without a loupe; technique A kept. The figures are in plan Task 8; the owner's tablet trial is the real check |
## U3 · Category panel and own colour