From c6b8c7e48ac6b1361d38db1c64fd62b1d1fc9fcf Mon Sep 17 00:00:00 2001 From: bchanot Date: Wed, 18 Nov 2026 12:20:49 +0100 Subject: [PATCH] docs(docs): U2 owner trial section and gate figures MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- .claude/tasks/plans/2026-11-17-v1-2-6-u2.md | 9 + CLAUDE.md | 2 +- docs/development/V1-2-6_OWNER_TRIAL.md | 177 ++++++++++++++++++++ docs/development/V1-2-6_UX_TESTS.md | 2 +- 4 files changed, 188 insertions(+), 2 deletions(-) diff --git a/.claude/tasks/plans/2026-11-17-v1-2-6-u2.md b/.claude/tasks/plans/2026-11-17-v1-2-6-u2.md index ee6876a2..c90c0bf6 100644 --- a/.claude/tasks/plans/2026-11-17-v1-2-6-u2.md +++ b/.claude/tasks/plans/2026-11-17-v1-2-6-u2.md @@ -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 diff --git a/CLAUDE.md b/CLAUDE.md index 1cba521e..e7c0f3d5 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md index 5d21a29d..bf59b324 100644 --- a/docs/development/V1-2-6_OWNER_TRIAL.md +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -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://: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). diff --git a/docs/development/V1-2-6_UX_TESTS.md b/docs/development/V1-2-6_UX_TESTS.md index 39a08bee..f738092b 100644 --- a/docs/development/V1-2-6_UX_TESTS.md +++ b/docs/development/V1-2-6_UX_TESTS.md @@ -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