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:
1 parent
e6f47280ad
commit
c6b8c7e48a
4 files changed
+188
-2
No files matched your search
@@ -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).
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
Reference in new issue
Block a user