docs(docs): U2 rev 4, owner corrections before the trial

This commit is contained in:
bchanot committed 2026-11-19 00:45:08 +01:00
1 parent 1f2485ecb8
commit 816d0f4f9a
3 files changed
+259 -2

No files matched your search

@@ -221,7 +221,7 @@ Je souhaite pouvoir essayer le résultat sur db:trial avant la clôture définit
### Accessibility and touch
18. **Accessibility.**
- Handles are focusable outside any `aria-hidden` subtree, with names such as « Sommet 3 de Thoraciques ».
- Handles are focusable outside any `aria-hidden` subtree, with names such as « Sommet 3 de Vertèbres thoraciques » (the annotation's full name).
- Every drag has a non-drag path (WCAG 2.5.7): move mode arrows, a track click, « + » and « − » clicks,
« Redessiner ».
- axe passes on the selection, tracing, move, creation and dialog states.
@@ -267,3 +267,83 @@ packages/core-wasm/types/**, packages/core-wasm/tests/**, apps/app/src/{editor/*
components/ui/Dialog.tsx,catalogue/useFraming.ts,app/routes/app/admin/AdminSheetDraftRoute.tsx,
components/shell/SignOutButton.tsx,styles/index.css,i18n/fr.ts,i18n/en.ts}, apps/app/tests/**, apps/app/e2e/**,
docs/**, CLAUDE.md, CHANGELOG.md, .claude/tasks/**, .claude/memory/*
## ADDENDUM 2026-11-19: owner corrections before the trial
### REQUEST (verbatim — IMMUTABLE)
Le bilan technique de U2 est encourageant.
Je valide globalement les choix visibles et les comportements annoncés, sous réserve de mon essai manuel sur db:trial.
Avant cet essai définitif, je souhaite corriger quelques points.
1. Sur tablette, la barre supérieure fixe ne doit jamais recouvrir le bandeau des outils de l'éditeur pendant le défilement.
C'est un véritable défaut d'ergonomie à corriger. Le dessin et les autres éléments ne doivent pas se décaler de manière inattendue.
2. Après une interaction tactile qui valide des réglages en attente, le focus doit revenir à un endroit cohérent avec l'action, et non simplement sur la page.
3. Lorsque l'on choisit « Reprendre le tracé », je préférerais retrouver les poignées prévues sur la planche 04 C, afin de pouvoir corriger directement la forme.
4. Sur Mac, Retour arrière doit pouvoir supprimer le sommet sélectionné, dans le respect des règles de validation du polygone.
Pour la fonction Inser, prévois une alternative accessible au clavier sur Mac. Je te laisse choisir la solution la plus naturelle, sans multiplier inutilement les raccourcis.
5. Utilise le nom complet de l'annotation pour le groupe de poignées, par exemple « Sommets de Vertèbres thoraciques ».
6. Si « Refaire » est indisponible pendant une opération, une explication accessible serait appréciable.
Les autres comportements sont acceptés :
- Échap demande confirmation avant d'abandonner une création.
- « Annuler le tracé » est une action explicite d'abandon.
- Double-clic sur « + » = un seul sommet.
- Un message conserve sa visibilité pendant qu'il a le focus.
Je valide également l'ajout au suivi produit des problèmes de pagination des droits et de chargement progressif du catalogue.
Pour les mots de passe fictifs présents dans les scripts, conserve l'exigence déjà ratifiée : aucun véritable secret en clair dans les journaux, arguments de processus ou artefacts de test et CI/CD avant la production.
Je te laisse autonome pour organiser les corrections, les tests et les relectures avec ton processus habituel.
Une fois ces points traités, je souhaite procéder à l'essai manuel U2 sur db:trial, notamment sur la véritable fiche équine et sur tablette.
Je validerai la clôture de U2 après cet essai.
### Rulings carried (plan rev 4, « Owner corrections before the trial »)
The accepted behaviours (Escape asks, « Annuler le tracé » discards, a double click on « + » inserts once, the
focus hold) close criteria 2 and 6's open rulings. The plan's rev 4 rulings bind criteria 25 to 30.
### ACCEPTANCE CRITERIA (addendum)
25. **Strip under the top bar (point 1).** At 1 024 × 768, 1 180 × 820 and 1 280 × 800, at every scroll position of
the editor's annotations tab, the strip's top is at or below the top bar's bottom and the strip is fully
visible; the canvas and aside boxes do not shift; a focused or scrolled-to target is never under the bar or the
strip; below 1 024 px nothing changes.
26. **Focus after a touch commit (point 2).** A pending keyboard series or slider change commits without `blur()`;
after a tap that commits it (Safari-like: the tapped control takes no focus), the focus is on the pressed
handle, the handle that held the series, the canvas box, or the command's own keyboard target, per the path
(plan Task 13), never `body`. Real iPad Safari is a trial item, not a verified one.
27. **Resumed trace with handles (point 3, board 04 C).** « Reprendre le tracé » shows the closed pending shape with
its vertex, « + » and « − » handles; drags, « + », « − » and the vertex keys change only the pending shape
(document text, history and unsaved count unchanged); the three-vertex floor holds with its message; the strip
shows « Revenir aux propriétés » and « Abandonner » only; « Créer » writes the edited shape in one insert;
handle names use the form's name with a fallback while it is empty; the polyline reopening and its assertions
are gone, each mapped.
28. **Mac keys (point 4).** On a focused vertex handle, Backspace removes the chosen vertex exactly as Delete
(three-vertex floor, move-mode inertness, pending steps committed first) and « + » inserts after it exactly as
Insert, also when that segment's « + » is hidden; neither zooms the canvas nor reaches the tracing's Backspace;
`aria-keyshortcuts` lists them.
29. **Group name (point 5).** On the real equine sheet copy the group reads « Sommets de Vertèbres thoraciques »
(e2e assertion), its vertices « Sommet {n} de Vertèbres thoraciques ».
30. **Why redo is held (point 6).** A held « Refaire » (pending work) and a held « Défaire » or « Refaire » (creation)
carry an `aria-describedby` reason; a press on a held button shows that reason in the message line without any
shift; other disabled causes unchanged; axe passes on the held state.
31. **Follow-ups and gates (rev 4).** TODO carries the rights paging, the catalogue progressive loading and the
passwords requirement; §4.17 is rewritten for points 1 to 6 with the accepted behaviours moved out of the
choices to judge; criteria 22 and 23 are met again on the final head (check:all, the shell suite without
editor-equine, both measures, a fresh verifier, a fresh security auditor).
### FILE SCOPE (addendum)
apps/app/src/components/shell/ShellChrome.tsx (the top bar's height variable only), apps/app/src/components/editor/HistoryButtons.tsx.