chore(tasks): R1 and D6b contract and plan (rev 3, challenged)

This commit is contained in:
bchanot committed 2026-11-12 12:19:34 +01:00
1 parent 541706cba9
commit 4923edefc0
2 files changed
+463

No files matched your search

@@ -0,0 +1,156 @@
# CONTRACT — r1-history-deselect
- date: 2026-11-12 | flow: ship-feature | branch: feature/v1-2-anatomical-sheets
- status: active
## REQUEST (verbatim — IMMUTABLE)
# FAUNOSTEO V1-2.6 — GO R1 COMPLET + D6b
Le propriétaire approuve l'implémentation complète de R1, incluant le critère D6b ajouté après les tests manuels U1.
La cause identifiée dans useCanvasGestures.ts est acceptée. Le périmètre proposé est validé, sous les décisions suivantes.
## 1. Arbitrages
A. Focus après clic :
- Le focus reste dans le schéma après une désélection par clic ou toucher.
- Utiliser un élément graphique approprié et focusable ; ne pas tenter de focaliser arbitrairement un os ou un path SVG.
- Déclencher l'annonce accessible prévue.
- Conserver la règle A6 propre au bouton Désélectionner : ligne correspondante si disponible, sinon repli sur le schéma.
B. Zones et liens :
- Un clic sur une annotation interactive (point, zone ou lien) conserve le comportement de sélection.
- Un clic sur un élément non interactif du dessin, y compris un os ou un tracé SVG interne, désélectionne.
- Ne pas confondre les éléments SVG ordinaires et ceux porteurs d'une annotation.
C. Livraison :
- Implémenter R1 complet, conformément aux maquettes R0 validées et à V1-2-6_U1_CORRECTIONS.md.
- Isoler D6b dans un commit distinct pour faciliter sa revue et sa traçabilité.
- Ne pas commencer R2, R3, R4, U2 ou U2b.
D. Valeurs invalides :
- Conserver pour R1 le comportement actuel d'une valeur explicitement refusée et non appliquée : fermeture du panneau sans modification du document.
- Vérifier qu'aucune modification valide en attente d'enregistrement n'est perdue silencieusement.
- Ne pas introduire une nouvelle gestion globale des formulaires ou une modale de confirmation dans ce lot.
- Documenter le comportement et ses limites.
## 2. Implémentation D6b
Traiter les deux parcours :
- useCanvasGestures.ts / EditableAnnotations.tsx pour l'éditeur modifiable.
- CatalogueCanvas.tsx / AnnotationsTab.tsx pour la consultation en lecture seule.
Mutualiser le chemin de désélection existant lorsque c'est pertinent, sans altérer le catalogue du lecteur.
Une désélection ne doit pas :
- Modifier le document ;
- Déclencher une sauvegarde ;
- Ajouter une opération Défaire/Refaire ;
- Annuler une création en cours lorsqu'aucune annotation n'était sélectionnée ;
- Interférer avec le déplacement d'un repère, le pan, le zoom ou le pincement.
Le seuil de mouvement de 4 px et la protection des gestes multidoigts doivent être vérifiés sur les séquences réelles d'événements, et pas uniquement sur des clics synthétiques isolés.
## 3. Tests
Exécuter les tests unitaires et navigateur prévus pour R1 et D6b.
Couvrir :
- Clic sur un point, une zone et un lien interactif ;
- Clic sur rect/path/circle non interactifs, racine SVG et marge ;
- Absence de sélection initiale ;
- Pan, zoom, déplacement d'annotation et gestes à plusieurs doigts ;
- Utilisation tactile ;
- Annonce accessible et gestion du focus ;
- Lecture seule ;
- Absence de régression du catalogue du lecteur ;
- Défaire/Refaire après désélection ;
- Persistance du document et absence d'écriture inattendue ;
- Gestion des valeurs refusées et des modifications valides en attente.
Exécuter les suites automatisées uniquement sur leur environnement prévu. Ne jamais utiliser db:trial comme sandbox E2E jetable.
Si un test équin nécessite des fixtures, les préparer dans un environnement automatisé isolé, sans toucher à la fiche historique ni aux données de la pile d'essai.
iOS Safari reste une vérification manuelle ultérieure, non une preuve de compatibilité acquise.
## 4. Livraison et contrôles
Respecter les conventions de branche, commit et push du projet.
Réaliser :
- Les vérifications statiques ;
- Les tests unitaires ;
- Les tests navigateur ;
- Une revue fonctionnelle indépendante ;
- Une revue de code indépendante ;
- Une vérification de sécurité ciblée sur les interactions et l'isolation des environnements.
Documenter les écarts et limites réels, sans déclarer validé un test non exécuté.
## 5. Restrictions
Aucune intervention sur DEV.
Aucune migration SQL ni modification du moteur Rust ou du worker.
Ne pas modifier la fiche équine historique.
Ne pas supprimer ni réinitialiser la copie de travail d'essai.
Aucune modification des rôles, du MFA ou des secrets.
Ne pas modifier l'exposition réseau de la pile d'essai.
Préserver le fichier de revue ChatGPT non suivi.
Aucune fusion ni aucun déploiement.
## 6. Checkpoint
Fournir :
- Le détail des modifications R1 et D6b ;
- Les commits et leur état de push ;
- Les résultats des tests et contre-revues ;
- Les éventuelles régressions ou limitations ;
- Les points à vérifier manuellement dans l'éditeur sur db:trial.
S'arrêter à la fin de R1.
Ne pas démarrer R2 sans nouveau feu vert.
## CLARIFICATIONS
Q: spec of R1? / A: docs/development/V1-2-6_U1_CORRECTIONS.md §1 D5, D6, D6b, §3 R1, §6 A5, A5b, A6; board 26 (docs/design/v1-2-6-r0/26-historique-deselection.png, maquettes.html:380-391, :611-667, REVUE.md:57-60, :72, :108-111, :129-135) is normative (BDR-110).
Q: tooltip with the shortcut and Meta in aria-keyshortcuts? / A: yes, board 26 and REVUE.md:59, :108-110 (title = name + « (Ctrl+Z ou ⌘Z) » / « (Ctrl+Maj+Z ou ⇧⌘Z) », EN « (Ctrl+Z or ⌘Z) » / « (Ctrl+Shift+Z or ⇧⌘Z) »; aria-label = name only; aria-keyshortcuts adds Meta+Z / Meta+Shift+Z).
Q: suites environment? / A: unit + e2e:ui local; e2e:shell only on `pnpm db:sandbox` (already up); never db:trial, never DEV; no sandbox reset/down; exact shell count reported against the known baseline (4 failures admin.spec.ts:717, anomaly B).
## ACCEPTANCE CRITERIA
1. FR history labels read « Défaire » / « Refaire » with names « Défaire la dernière modification » / « Refaire la dernière modification défaite »; EN undo/redo strings unchanged; fr and en key sets identical.
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2/apps/app && grep -q "'editor.history.undo': 'Défaire'" src/i18n/fr.ts && grep -q "'editor.history.redo': 'Refaire'" src/i18n/fr.ts && grep -q "'editor.history.undo_title': 'Défaire la dernière modification'" src/i18n/fr.ts && grep -q "'editor.history.redo_title': 'Refaire la dernière modification défaite'" src/i18n/fr.ts && grep -q "'editor.history.undo': 'Undo'" src/i18n/en.ts && grep -q "'editor.history.redo_title': 'Redo the last undone change'" src/i18n/en.ts && ! grep -qE "'editor\.history\.(undo|redo)(_title)?': '(Annuler|Rétablir)" src/i18n/fr.ts && echo LABELS_OK
EXPECT: LABELS_OK
EVIDENCE: pending
2. History buttons: aria-label = the name, title = name + the shortcut text of board 26, aria-keyshortcuts lists Control and Meta forms; shortcuts themselves unchanged (useUndoShortcuts.ts untouched); dialog « Annuler » buttons untouched; the FR prose naming the history command (editor.views.drawing.use_parent_body, editor.views.repair.body_one/_other) says « Défaire ».
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 541706c -- apps/app/src/editor/useUndoShortcuts.ts && grep -q "Meta+Z" apps/app/src/components/editor/HistoryButtons.tsx && grep -q "Meta+Shift+Z" apps/app/src/components/editor/HistoryButtons.tsx && ! grep -q "un seul Annuler" apps/app/src/i18n/fr.ts && ! grep -q "ce changement (Annuler)" apps/app/src/i18n/fr.ts && echo HISTORY_OK
EXPECT: HISTORY_OK
EVIDENCE: pending
3. « Désélectionner » (secondary, deselect glyph) sits to the left of « Supprimer » in the properties panel, in edit and read-only modes (read-only: no « Supprimer »); after it: the annotation's list row if visible, else the drawing box; focus never reselects; polite announcement « Aucune annotation sélectionnée. » / « No annotation selected. ».
4. Escape in the editor workspace, first applicable wins: open dialog (native, untouched) > « Plus » menu open (closes, focus on « Plus ») > references panel open (closes, focus on its opener) > tracing in progress (cancels, as today) > selection (deselects, focus per the [gated] rule, same announcement); Escape inside a text field / select never deselects; nothing applicable → nothing; acts on the shown body only (kept hidden edit body or hidden tab never changes).
5. D6b, edit canvas: with the select tool, a click/tap whose target has no [data-anno-id] ancestor deselects when an annotation is selected (bone or any drawing shape, the composed root, the box margin); a click on a point, zone or link still selects it; nothing selected → no dispatch (pending keyboard creation, typed fields, « Filtrer par nom » kept); drawing tools and tracing unchanged; a press that moved > 4 px (pan, marker drag, pinch) or during which a second pointer came down never deselects; focus ends on the canvas box (role=group, tabIndex 0), never on an SVG shape; same announcement.
6. D6b, read-only twin: CatalogueCanvas gets an optional onEmpty with the same rules, passed only by the editor's read-only twin; the catalogue reader (SheetRoute) passes none and behaves exactly as before; useFraming.ts unchanged.
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 541706c -- apps/app/src/catalogue/useFraming.ts apps/app/src/app/routes/app/anatomy/SheetRoute.tsx && grep -q "onEmpty" apps/app/src/components/catalogue/CatalogueCanvas.tsx && grep -q "onEmpty" apps/app/src/components/editor/tabs/AnnotationsTab.tsx && echo READER_UNCHANGED_OK
EXPECT: READER_UNCHANGED_OK
EVIDENCE: pending
7. Every deselect path (button, Escape, click/tap): document text, handle version, history length, unsaved count and save state unchanged by the deselect itself; no save request; a valid typed value not yet blurred is committed (its own edit, undoable), never dropped silently; a refused « non appliqué » value: panel closes, document unchanged (current behaviour, documented); undo after a deselect undoes the previous edit.
8. Unit tests (vitest) cover items 1-7 including clicks on inner SVG elements (rect/circle/path), the root svg and the margin, pointer sequences (down/move/up then click) under and over 4 px, a second pointer, read-only twin, reader unchanged; `pnpm typecheck`, `pnpm lint`, `pnpm test:run`, `pnpm build` pass.
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && pnpm -s typecheck >/dev/null 2>&1 && pnpm -s lint >/dev/null 2>&1 && pnpm -s test:run >/tmp/claude-1000/-home-bchanot-Documents-faunosteo/463d8810-0112-4b67-92e4-aa3c30af6089/scratchpad/r1-unit.txt 2>&1 && echo STATIC_UNIT_OK
EXPECT: STATIC_UNIT_OK
EVIDENCE: pending
9. Browser tests: `pnpm e2e:ui` passes; a new shell spec (Chromium, `pnpm db:sandbox` only) covers button, Escape matrix, D6b mouse clicks on inner shapes/root/margin/annotations, pan/zoom/marker drag, touch tap, touch drag, two-finger tap and pinch through CDP, read-only twin, persistence after reload and no save request; `editor-equine.spec.ts` clicks a bone path of the horse drawing on its own sandbox copy; the full shell suite run is reported with its exact counts against the baseline.
10. D6b lands in its own commit; commits pushed on feature/v1-2-anatomical-sheets; no change under supabase/, crates/, scripts/db-trial*.sh, docker/; the untracked review file kept.
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && [ -z "$(git diff --name-only 541706c -- supabase crates scripts/db-trial.sh scripts/db-trial-check.sh docker)" ] && [ -f faunosteo-v1-2-6-revue-ux-chatgpt.md ] && git log --format=%s 541706c..HEAD | grep -q "D6b" && [ "$(git rev-parse HEAD)" = "$(git rev-parse @{u})" ] && echo SCOPE_PUSH_OK
EXPECT: SCOPE_PUSH_OK
EVIDENCE: pending
11. Docs: V1-2-6_U1_CORRECTIONS.md R1 status + the deselect limits (refused value, focus rules, iOS manual), BROWSER_TESTS.md (new spec, keyboard order « Défaire », « Refaire »), V1-2-6_OWNER_TRIAL.md labels, a D5 note on T15 in V1-2-6_UX_DECISIONS.md and V1-2_ANATOMICAL_SHEETS.md, ANNOTATION-RENDERING.md click paragraph (D6b); historical records (U1 checkpoint, v1-2-6 board records) untouched.
## FILE SCOPE
apps/app/src/i18n/{fr,en}.ts; apps/app/src/components/editor/{HistoryButtons,EditorTabs,EditorWorkspace,EditorGlyph}.tsx; apps/app/src/components/editor/annotations/{PropertiesPanel,EditableAnnotations,AnnotationCanvas}.tsx; apps/app/src/components/editor/references/ReferencesPanel.tsx; apps/app/src/components/editor/tabs/AnnotationsTab.tsx; apps/app/src/components/catalogue/CatalogueCanvas.tsx; apps/app/src/editor/annotations/{useCanvasGestures,usePlacement}.ts; apps/app/src/editor/{focusRequest,useEditorNavigation}.ts; new apps/app/src/editor/{deselect,escape}.ts(x) helpers; apps/app/tests/unit/*.test.tsx (editor-history-buttons, editor-annotations-tab, editor-overview, editor-sections, editor-keep-alive, routes.catalogue, new editor-deselect / editor-escape); apps/app/e2e/shell/editor-*.spec.ts (titles/comments), new e2e/shell/editor-deselect.spec.ts, e2e/support/editor.ts, editor-equine.spec.ts; docs listed in criterion 11; .claude/tasks/*.