Files
faunosteo/.claude/tasks/contracts/2026-11-17-u2-design-boards.md

150 lines
9.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# CONTRACT — u2-design-boards
- date: 2026-11-17 | flow: design and documentation only (U2 boards, review, arbitrations, tracking) | branch: feature/v1-2-anatomical-sheets
- status: closed (owner validation 2026-11-17)
- worktree: /home/bchanot/Documents/faunosteo-v1-2 (every command from this absolute path; never DEV: the
`supabase_*_faunosteo` containers are DEV). The sandbox and the trial stack are not read nor written by this lot.
- base: c42c655. Commit in place, push; no merge, no `gitflow.sh finish`.
- untracked file kept: `faunosteo-v1-2-6-revue-ux-chatgpt.md`.
## REQUEST (verbatim — IMMUTABLE)
### Owner brief 2026-11-17 (R4 closed, U2 design start)
Je confirme avoir terminé mes tests manuels de R4 sur la sandbox.
Tous les tests fonctionnent correctement et le résultat me convient.
Je valide officiellement R4.
Je confirme également les deux décisions restantes :
1. Nettoyage des fiches de test :
Je valide leur archivage plutôt que leur suppression.
Les règles métier concernant les fiches ayant eu une version publiée doivent rester inchangées.
2. Fichiers supplémentaires :
J'accepte les modifications de Card.tsx et de l'utilitaire de validation des identifiants SQL.
Tu peux maintenant procéder à la clôture documentaire de R4 :
- Enregistrer ma validation propriétaire.
- Mettre à jour les contrats, le TODO et le suivi.
- Enregistrer les décisions et apprentissages pertinents.
- Conserver les résultats exacts des tests.
- Committer et pousser les modifications documentaires.
BLK-015, RR-13 et l'anomalie A restent des chantiers séparés.
R4 est terminé.
Nous pouvons maintenant préparer U2 : la refonte de la manipulation graphique des annotations.
Je souhaite commencer par la conception graphique, conformément à notre méthode habituelle.
Reprends les maquettes validées et les nouvelles décisions UX concernant les modales de propriétés des annotations.
Les objectifs restent :
- Création d'un point directement sur le schéma.
- Création d'une zone en traçant son polygone.
- Déplacement des sommets avec la souris ou le doigt.
- Ajout d'un sommet avec « + » sur un segment.
- Suppression d'un sommet avec « − ».
- Déplacement et redessin d'une zone.
- Modification de la taille d'un point.
- Consultation et modification des propriétés dans une modale.
- Ouverture de la modale de création après le placement du point ou la fin du tracé.
Les interactions graphiques doivent rester possibles sans que les modales gênent les gestes.
Prépare les nouvelles maquettes U2, notamment les planches 02 à 06 et 13, ainsi que les éventuels écrans supplémentaires nécessaires.
Je te laisse autonome pour auditer l'existant, proposer les meilleures interactions et organiser les relectures.
Présente-moi les maquettes pour validation visuelle avant toute implémentation de U2.
Aucune fusion ni intervention sur DEV.
## CLARIFICATIONS
- « Les nouvelles décisions UX concernant les modales de propriétés des annotations » = the owner orientation of
2026-11-14 (BDR-117), recorded in `docs/development/V1-2-6_UX_PLAN.md` §U2 « Orientation 2026-11-14 »,
`docs/development/V1-2-6_UX_DECISIONS.md` row « U2 orientation » and `docs/design/README.md` note of 2026-11-14.
- « Les maquettes validées »: `docs/design/v1-2-6/` boards 01 to 16 (approved for good, not reopened, except boards
02 to 06 and 13 which the orientation sends back for redrawing), the R0 boards `docs/design/v1-2-6-r0/` 23 to 30
(validated 2026-11-09, BDR-110; board 26 draws the Annotations tab as U1 built it), the constats boards
`docs/design/v1-2-6-constats/` and the step 7 shell.
- Ratified rules that bind the drawing (`V1-2-6_UX_DECISIONS.md`, `v1-2-6/ARBITRAGES.md`, `V1-2-6_UX_PLAN.md` §U2):
choice 1 (a) a selected zone drags directly with the mouse, an explicit « Déplacer la zone » mode by touch; choice 3
(b) the point size slider snaps to the sizes used in the view, no number shown, red minimum mark (core
`marker_too_small`); choice 10 (b) the app sidebar hidden in the editor below 1 280 px; O14 A below 1 024 px the
editor is read-only (boards 14 and 16 unchanged); T15 wording « Abandonner » for a form, « Défaire » / « Refaire »
for the history (R0); T18 handle cap per shape; §2 G keyboard (Tab between handles, arrows, Maj by 10, Inser,
Suppr, Entrée, Échap); 44 px touch targets; no coordinate field in the normal journey; curves excluded (curves lot).
- What is open and goes to the owner as an arbitration: any deviation from the 2026-11-14 interaction rules that the
request's « sans que les modales gênent les gestes » leads to, the dialog placement over the drawing, the laterality
default at creation (C25), and any other visible choice the boards make.
## ACCEPTANCE CRITERIA
1. Boards: a new folder `docs/design/v1-2-6-u2/` holds `maquettes.html`, its data generator and generated data, one
PNG per board rendered with the pinned Chromium (`docs/design/v1-2-6/render.cjs`), a contact sheet (PNG and HTML)
and `REVUE.md` in French. Boards 02 to 06 and 13 are redrawn under their numbers; extra boards, if any, are
numbered from 31.
2. Objectives: each of the nine objectives of the request is drawn on at least one board, and `REVUE.md` holds a
table objective → board(s) → what is shown.
3. Dialogs: properties are read and edited in a modal dialog (read mode first, then a form whose actions reuse the R2
wording); the creation dialog opens after the point is placed or the trace is finished, the new shape staying
visible; no board shows a gesture on the drawing while a dialog is open, and no dialog covers the shape it
concerns. The rule for when a dialog opens (and when it does not) is written in `REVUE.md`.
4. Geometry on the drawing: point move and size (slider in the fixed strip with the red minimum mark and the snap
marks), vertex drag, « + » on a segment, « − » on the chosen vertex, zone move (mouse direct, touch explicit mode),
redraw keeping the old shape until accepted, each undoable in one step through « Défaire »; no coordinate field.
5. Touch: board 13 at 1 180 px with 44 px targets, the sidebar hidden (choice 10 b), the explicit touch move mode, and
a dialog opened by touch.
6. Keyboard: the alternative to every drag (WCAG 2.5.7) and the focus path into and out of the dialogs (return target)
are drawn or written on the boards.
7. Identity and truth: tokens, shell (five tabs, « Défaire » / « Refaire », save line as built after R2), components and
icons reused from the validated boards with no new colour; annotations at their real coordinates from the equine
draft `document.json` through the generator; every new visible label listed in `REVUE.md` with FR and EN.
8. Arbitrations: `docs/design/v1-2-6-u2/ARBITRAGES.md` lists every choice that needs the owner, each with what the
boards draw, the alternatives, the consequences and a recommendation; any deviation from the 2026-11-14 orientation
is named as such.
9. Reviews: a fresh design review and a fresh conformity check against this contract, their exact results written in
`REVUE.md` (or a `CONTROLE-CONFORMITE.md`), and `impeccable detect` on `maquettes.html` run or its absence stated.
10. Restrictions: the branch diff from c42c655 touches only `docs/`, `.claude/tasks/`, `.claude/memory/`; nothing under
`apps/`, `packages/`, `crates/`, `supabase/`, `scripts/`; no stack started, stopped or written; no merge; DEV
unchanged; the untracked review file still present.
## FILE SCOPE
docs/design/v1-2-6-u2/**, docs/design/README.md, docs/development/V1-2-6_UX_PLAN.md (U2 note only),
.claude/tasks/TODO.md, .claude/tasks/contracts/this file, .claude/memory/*
## Owner validation 2026-11-17 (verbatim)
J'ai fait examiner l'archive graphique U2 par ChatGPT.
La revue graphique est favorable. Je valide les neuf maquettes ainsi que les arbitrages A1 à A15, y compris les trois écarts A1, A2 et A3 par rapport à l'orientation initiale.
En particulier :
- A1 : le premier clic sélectionne l'annotation sans ouvrir de modale. Un deuxième clic, un double-clic ou le bouton « Propriétés » ouvre la modale. La création ouvre automatiquement la modale après le placement du point ou la fermeture du tracé.
- A2 : la modale des propriétés s'affiche sur la colonne de droite pour préserver la visibilité du squelette.
- A3 : la colonne de droite reste présente avec les vues, catégories et annotations.
- A4 à A15 : les propositions des maquettes sont acceptées.
Trois ajustements mineurs sont demandés :
1. A13 : rendre compréhensible le déplacement du dessin à deux doigts sur tablette, avec une indication discrète et contextuelle. Ne pas surcharger l'interface.
2. A14 : s'assurer que l'apparition et la disparition des messages comme « Point déplacé · Défaire » ne provoquent aucun déplacement ni redimensionnement du schéma.
3. Planche 33 : rendre les messages de validation cohérents avec les champs réellement manquants. Si la catégorie est déjà sélectionnée, le message ne doit pas demander de la choisir à nouveau.
Ces ajustements ne nécessitent pas de refaire l'ensemble des maquettes.
Tu peux considérer la conception graphique U2 comme validée et poursuivre avec la préparation du plan technique U2, selon ton processus habituel.
Je te laisse autonome sur l'architecture, les choix techniques, les tests, les relectures et l'organisation des travaux.
L'objectif reste une édition anatomique fluide, précise et intuitive, aussi bien à la souris qu'au toucher, sans perte de données et sans déplacement intempestif de l'interface.
Présente-moi le plan technique et les éventuels arbitrages réellement nécessaires avant l'implémentation.