chore(tasks): R1 and D6b contract and plan (rev 3, challenged)
This commit is contained in:
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/*.
|
||||
Reference in new issue
Block a user