150 lines
9.6 KiB
Markdown
150 lines
9.6 KiB
Markdown
# 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.
|