221 lines
20 KiB
Markdown
221 lines
20 KiB
Markdown
# V1-2.6 U2 : manipulation graphique des annotations (conception validée par le propriétaire le 2026-11-17)
|
||
|
||
Brief du propriétaire du 2026-11-17 (« préparer U2 : la refonte de la manipulation graphique des annotations »),
|
||
orientation du 2026-11-14 (BDR-117, `docs/development/V1-2-6_UX_PLAN.md` §U2 « Orientation 2026-11-14 »). Contrat
|
||
`.claude/tasks/contracts/2026-11-17-u2-design-boards.md`. Ces planches remplacent les planches 02 à 06 et 13 de
|
||
`docs/design/v1-2-6/` (validées le 2026-11-17, ajustements dans `ARBITRAGES.md`) ; les planches 14 et 16 (téléphone) ne changent pas (O14 A). Rien n'est
|
||
implémenté : ni code, ni SQL, ni Rust, ni pile démarrée. Aucune fusion, DEV inchangé.
|
||
|
||
| Fichier | Contenu |
|
||
|---|---|
|
||
| `02-point-creation-desktop.png` | Outil Point : taille choisie dans le bandeau, clic, dialogue « Nouveau point » ouvert sur la colonne de droite, point visible sous le voile ; A avant le clic ; C après « Créer » (sélection, message « Défaire » sous le dessin) |
|
||
| `03-point-modification-desktop.png` | Point sélectionné sans dialogue, déplacé (message sous le dessin) ; B curseur de taille aimanté ; C dialogue en lecture ouvert d'un clic sur le point déjà sélectionné |
|
||
| `04-zone-creation-desktop.png` | Dialogue « Nouvelle zone » à la fermeture du tracé, forme visible ; A tracé en cours dans le bandeau ; C « Reprendre le tracé » puis « Revenir aux propriétés » |
|
||
| `05-zone-poignees-desktop.png` | Zone sélectionnée : sommets, « + », bulle « − » sur le sommet choisi, glisser direct de l'intérieur à la souris ; A sommet ajouté, B sommet glissé, C sommet retiré |
|
||
| `06-zone-deplacer-redessiner-desktop.png` | A déplacement direct à la souris ; B mode explicite « Déplacer la zone » (doigt, clavier, flèches du bandeau) ; C « Redessiner » sur l'ancien contour |
|
||
| `13-tablette-tactile.png` | 1 180 px au doigt : poignées agrandies, cibles de 44 px dans tout l'onglet, loupe au-dessus du doigt ; B dialogue en lecture ouvert d'un toucher ; C déplacement de la zone au doigt ; D point glissé au doigt, curseur de 44 px |
|
||
| `31-dialogue-proprietes-etats.png` | Dialogue de propriétés : lecture (point, zone), « Modifier », fermeture avec saisie en cours, « Supprimer », lecture seule |
|
||
| `32-ouverture-gestes-clavier.png` | Règle d'ouverture proposée face aux règles 1, 3 et 6 de l'orientation ; priorité d'un clic ; Échap ; clavier ; pointeur sans glisser ; retour du focus |
|
||
| `33-refus-et-etats.png` | Fermeture refusée, latéralité manquante, déplacement refusé, plafond de poignées, lecture seule |
|
||
| `planche-contact.png`, `planche-contact.html` | Les neuf planches sur une page |
|
||
| `maquettes.html`, `gen-data.cjs`, `data.js` | Source des planches ; données calculées depuis `document.json` du brouillon équin |
|
||
| `ARBITRAGES.md` | Les quinze choix soumis au propriétaire ; A1, A2 et A3 s'écartent de l'orientation |
|
||
|
||
Rendu : `node gen-data.cjs && PW_MODULE=<…>/apps/app/node_modules/@playwright/test node ../v1-2-6/render.cjs maquettes.html .`
|
||
puis la même commande sur `planche-contact.html` ; le fichier `all.png` produit est supprimé.
|
||
|
||
## Point de départ : l'onglet Annotations tel qu'il est construit
|
||
|
||
Audit en lecture du 2026-11-17 (U1, R1, R2). Les planches partent de ces faits :
|
||
|
||
- Largeurs : à 1 280 px la barre latérale est affichée et le dessin fait 538 × 403 px ; à 1 024 px la barre latérale
|
||
est masquée et le contenu garde la même largeur (960 px), donc le même dessin et le même bandeau ; à 1 180 px le
|
||
dessin fait 694 × 520 px. La colonne de droite fait 22 rem (352 px) partout, la colonne d'outils 44 px
|
||
(`EditableAnnotations.tsx:142`, `AnnotationCanvas.tsx`, `ShellChrome.tsx:32-37`).
|
||
- Colonne de droite : sans sélection, l'aperçu « Vues », « Catégories », « Annotations de la vue » (`OverviewPanel.tsx`,
|
||
entrées de 44 px, lignes d'environ 36 px) ; avec une sélection, le panneau de propriétés ; pendant une création, le
|
||
formulaire de création.
|
||
- Gestes construits : sélection au clic, glisser en bloc de l'annotation sélectionnée (point ou zone, seuil 4 px),
|
||
défilement à un doigt quand le dessin est zoomé, pincement, zoom. Non construits : poignées de sommet, « + » et « − »
|
||
sur le dessin, curseur de taille, « Déplacer la zone », « Redessiner » d'une zone ordinaire, message après un geste,
|
||
dialogue d'annotation.
|
||
- Création : formulaire dans la colonne de droite ; catégorie préremplie avec la première ; latéralité sans valeur par
|
||
défaut ; « Créer » écrit en une modification ; cliquer une autre annotation abandonne la création sans le dire.
|
||
- Libellés existants repris tels quels : « Non latéralisée », « Bilatérale », « Gauche », « Droite » ; « À confirmer »,
|
||
« Relu », « Hérité, non relu » ; « Fermer le tracé », « Annuler le tracé », « {n} sommets posés » ; « Nouveau point »,
|
||
« Nouvelle zone », « Créer » ; « Marquer comme relu », « Remettre à confirmer », « Désélectionner », « Supprimer » ;
|
||
dialogue de suppression ; formulaire « Annuler » / « Enregistrer » et question « Abandonner les modifications ? »
|
||
(R2) ; « Choisissez la catégorie et la latéralité (et la vue ouverte pour un accès). ».
|
||
|
||
## Objectifs du brief et planches
|
||
|
||
| Objectif | Planches | Ce qui est montré |
|
||
|---|---|---|
|
||
| Créer un point directement sur le schéma | 02 | Outil Point, aperçu sous le pointeur à la taille du bandeau, un clic place le point |
|
||
| Créer une zone en traçant son polygone | 04 A, 33 A | Un clic par sommet, fermeture sur le premier sommet, Entrée ou « Fermer le tracé » ; refus d'une zone trop étroite |
|
||
| Déplacer les sommets à la souris ou au doigt | 05 B, 13 | Poignée glissée, aperçu, validation au relâchement ; au doigt, poignées agrandies, cibles de 44 px et loupe |
|
||
| Ajouter un sommet avec « + » sur un segment | 05, 05 A, 13 | « + » au milieu de chaque segment ; le nouveau sommet est aussitôt choisi |
|
||
| Supprimer un sommet avec « − » | 05, 05 C, 13 | Bulle « − » sur le sommet choisi |
|
||
| Déplacer et redessiner une zone | 05, 06 A, 06 B, 06 C, 13 C | Glisser direct à la souris, mode explicite au doigt, au clavier et par flèches, redessin sur l'ancien contour |
|
||
| Modifier la taille d'un point | 02 A, 03, 03 B, 13 D | Curseur du bandeau aimanté sur les tailles de la vue, trait rouge du minimum, sans nombre ; 44 px au doigt |
|
||
| Consulter et modifier les propriétés dans une modale | 03 C, 13 B, 31 | Lecture d'abord, « Modifier », enregistrement en une modification, sortie protégée, suppression, lecture seule |
|
||
| Ouvrir la modale de création après le placement ou le tracé | 02, 04 | « Nouveau point » et « Nouvelle zone » s'ouvrent seuls, la forme reste visible ; « Replacer le point », « Reprendre le tracé » |
|
||
| Gestes possibles sans que les modales gênent | 03, 05, 13, 32 | Sélection sans dialogue, dialogue sur la colonne de droite et jamais sur le dessin, jamais pendant un geste (A1, A2) |
|
||
|
||
## Quand le dialogue s'ouvre, et quand il ne s'ouvre pas
|
||
|
||
Proposé (arbitrage A1, écart avec les règles 1 et 6 de l'orientation du 14/11 ; la règle 3 est gardée) :
|
||
|
||
1. Un clic, un toucher ou Entrée sur la ligne de la liste, sans déplacement, sur une annotation non sélectionnée la
|
||
sélectionne : poignées, bandeau, ligne marquée. Aucun dialogue.
|
||
2. Un appui qui bouge au-delà du seuil est un geste : point, sommet, « + », « − », intérieur d'une zone sélectionnée à
|
||
la souris. Il n'ouvre jamais de dialogue.
|
||
3. Les propriétés s'ouvrent en lecture par un clic sans déplacement sur l'annotation déjà sélectionnée (hors poignée, et
|
||
si aucun sommet n'est choisi), un double-clic sur une annotation, Entrée sur la ligne déjà sélectionnée, ou
|
||
« Propriétés » dans le bandeau.
|
||
4. Le dialogue de création s'ouvre seul après le placement d'un point ou la fermeture d'un tracé.
|
||
5. Le dialogue est modal (dialogue natif, D13) et s'ouvre sur la colonne de droite (A2) : il ne couvre jamais le dessin.
|
||
« Modifier la forme » le ferme et met le focus sur la première poignée. Fermer le dialogue rend le dessin tel qu'il
|
||
était : sélection, zoom et défilement inchangés.
|
||
|
||
Priorité d'un clic sur le dessin (planche 32) : poignées de la forme sélectionnée, puis autre annotation sous le
|
||
pointeur, puis intérieur de la forme sélectionnée, puis dessin vide.
|
||
|
||
## Écarts avec les planches 02 à 06 et 13 d'origine
|
||
|
||
- Le panneau de propriétés à droite du dessin devient un dialogue (orientation du 14/11) ; la colonne de droite garde
|
||
l'aperçu tel que construit (A3).
|
||
- Le bandeau fixe porte la consigne, la sélection, le curseur de taille, les commandes de déplacement, « Redessiner » et
|
||
les commandes du tracé (A6) ; les bulles d'aide posées sur le dessin des anciennes planches disparaissent.
|
||
- La poignée de taille sur le bord d'un point (ancienne planche 03) n'est pas reprise : la taille se règle au curseur
|
||
du bandeau, qui montre le minimum et les crans.
|
||
- Le message après un geste quitte le dessin pour la ligne sous le dessin (A14) et dit « Défaire » (libellé de
|
||
l'historique depuis R0) ; il ne répète pas le nom.
|
||
- Le déplacement d'une zone n'est plus seulement un mode explicite : à la souris, l'intérieur d'une zone sélectionnée
|
||
se glisse directement (objectif U2 du plan UX, `V1-2-6_UX_PLAN.md` §U2) ; le mode reste pour le doigt, le clavier,
|
||
et gagne des flèches (A11).
|
||
- Planche 13 : la loupe au-dessus du doigt et la règle « un doigt ailleurs ne déplace rien » sont gardées de la planche
|
||
validée (A13) ; l'application actuelle fait défiler le dessin zoomé à un doigt.
|
||
- Les catégories gardent leurs noms actuels (« Segments vertébraux ») : U2 passe avant les catégories fixes de U6.
|
||
- Les zones à courbes (encart de l'ancienne planche 05) restent hors U2 (lot courbes) : sélection possible, sans
|
||
poignée ni déplacement.
|
||
|
||
## Libellés : T15 et nouveautés
|
||
|
||
T15 (ratifié) réserve « Abandonner » à la sortie d'un formulaire. Les planches gardent les libellés construits : le
|
||
formulaire de modification de R2 dit « Annuler » / « Enregistrer », la barre de tracé dit « Annuler le tracé ». Le
|
||
dialogue de création dit « Abandonner » (il retire aussi la forme placée, comme le prévoit l'orientation) au lieu du
|
||
« Annuler » actuel. Le mode « Déplacer » dit « Annuler » : il rend la place d'avant. L'orientation écrit « Terminer » et
|
||
« Annuler » pour le tracé ; les planches gardent « Fermer le tracé » et « Annuler le tracé », déjà construits (A15).
|
||
|
||
| FR | EN | Où |
|
||
|---|---|---|
|
||
| Propriétés | Properties | Bandeau, sélection |
|
||
| Taille | Size | Bandeau, curseur d'un point |
|
||
| Déplacer le point / la zone / le sommet | Move point / zone / vertex | Bandeau, sélection |
|
||
| Déplacer vers la gauche, le haut, le bas, la droite | Move left, up, down, right | Bandeau, flèches du mode déplacement |
|
||
| Valider la position | Confirm position | Bandeau, mode déplacement |
|
||
| Glissez n'importe où, ou utilisez les flèches | Drag anywhere, or use the arrows | Bandeau, mode déplacement |
|
||
| Redessiner ; Redessiner · {nom} | Redraw; Redraw · {name} | Bandeau |
|
||
| Retirer le dernier sommet | Remove last vertex | Bandeau, tracé |
|
||
| Point ; Zone · {n} sommets ; Zone · {n} sommets · sommet {i} choisi | Point; Zone · {n} vertices; Zone · {n} vertices · vertex {i} chosen | Bandeau, seconde ligne |
|
||
| Point · fiche en lecture seule | Point · read-only sheet | Bandeau, lecture seule |
|
||
| Zone · {n} sommets, trop pour les poignées | Zone · {n} vertices, too many for handles | Bandeau, plafond T18 |
|
||
| Ajouter un point ; Cliquez dans le dessin pour placer le point | Add a point; Click in the drawing to place the point | Bandeau, outil Point |
|
||
| Point placé, en attente de ses propriétés ; Tracé fermé, {n} sommets, en attente de ses propriétés | Point placed, waiting for its properties; Tracing closed, {n} vertices, waiting for its properties | Bandeau, création |
|
||
| Tracé repris, saisie gardée | Tracing resumed, input kept | Bandeau, création |
|
||
| Revenir aux propriétés | Back to properties | Bandeau, création reprise |
|
||
| Fermeture refusée | Closing refused | Bandeau, refus |
|
||
| Point placé · Replacer le point ; Zone tracée, {n} sommets · Reprendre le tracé | Point placed · Reposition the point; Zone traced, {n} vertices · Resume tracing | Dialogue de création, première ligne |
|
||
| Abandonner | Discard | Dialogue de création (aujourd'hui « Annuler ») |
|
||
| Choisissez une latéralité. | Choose a laterality. | Dialogue de création, sous le champ |
|
||
| Modifier la forme | Edit shape | Dialogue en lecture |
|
||
| Vue | View | Dialogue en lecture |
|
||
| Celle de la catégorie | The category's | Champ « Couleur » vide (texte indicatif) |
|
||
| Point créé, déplacé ; Zone déplacée, redessinée ; Sommet ajouté, retiré ; Taille modifiée | Point created, moved; Zone moved, redrawn; Vertex added, removed; Size changed | Message après un geste, avec « Défaire » |
|
||
| Déplacement refusé : {texte du cœur} | Move refused: {core text} | Message d'erreur sous le dessin |
|
||
|
||
## Conventions
|
||
|
||
- Identité reprise des planches validées (jetons, coquille, composants, icônes) et de l'onglet tel que construit ;
|
||
aucune nouvelle couleur. Le voile des dialogues d'annotation (22 % d'encre) est une valeur proposée (A2), dans la
|
||
même famille que le voile actuel.
|
||
- Marques sur le dessin : pointillé gris = l'ancienne place pendant un geste ou un redessin ; pointillé de la couleur
|
||
d'accent sur un détourage blanc = une forme nouvelle en attente de ses propriétés ; pointillé rouge = un endroit
|
||
refusé par le cœur ; disque gris = le doigt ; sommet choisi = plus grand, plein, cerclé (jamais la couleur seule).
|
||
- Données vraies : chaque annotation, nom, catégorie, latéralité, zone de constats, région, statut, coordonnée et taille
|
||
vient de `data.js`, généré depuis `document.json` ; les crans du curseur sont les tailles réelles de la vue (30 et
|
||
34 sur la vue principale, 27 sur la tête).
|
||
- Texte de mise en scène (exemples, pas des données) : le nouveau point « Tibia distal » / « Distal tibia » (catégorie
|
||
Os), la nouvelle zone « Tibia », les positions du point déplacé et de la zone déplacée, le tracé en cours, le tracé
|
||
de redessin, la forme trop étroite, le texte du refus de déplacement, « Brouillon, version 4 », « 2 erreurs »,
|
||
« 3 modifications non enregistrées », l'utilisateur. Le trait rouge du minimum est placé à titre indicatif : sa
|
||
valeur viendra du cœur (seuil `MIN_VISIBLE_PX`, `frame.rs:67`).
|
||
- Les lignes en jaune pointillé sont des notes de planche, pas du texte d'interface.
|
||
|
||
## Points pour le plan U2 (techniques, sans choix visible)
|
||
|
||
- Le cœur donne une valeur en lecture par vue : le rayon minimum visible (orientation, U2 « Rust ops »).
|
||
- Le dialogue d'annotation est une couche d'historique : `LAYERS` gagne `annotation` et `EditorView` un champ clé par
|
||
élément (`useEditorNavigation.ts:61-62`, `navigation.ts:36-45`).
|
||
- Les propriétés passent d'un enregistrement par champ à un formulaire transactionnel (`useFormDraft`, `FormActions`,
|
||
`DiscardConfirm` de R2 ; LRN-142).
|
||
- Les flèches font aujourd'hui défiler le dessin focalisé (`useFraming.ts:150-168`) : elles ne déplacent une forme que
|
||
si une poignée a le focus.
|
||
- Le seuil de glisser vaut 4 px pour la souris et le doigt, mesuré de trois façons (`gesture.ts:5`, `useFraming.ts:20`,
|
||
`useEmptyTap.ts:5`) : un seuil au doigt plus large est à fixer et à unifier.
|
||
- Le bandeau remplace la ligne d'outil et la barre de tracé (`ToolNotes`, `TracingBar`) ; hauteur fixe (LRN-131).
|
||
- Poignées à la souris (sommet d'environ 12 px, « + » d'environ 16 px) : elles reposent sur l'exception d'espacement de
|
||
WCAG 2.5.8 ; dans les endroits serrés (près des charnières), la priorité d'un clic tranche et la voie clavier reste.
|
||
- Compatibilité U2b : le dialogue de propriétés pourra recevoir la partie « Constats » de l'annotation (planches 17 et
|
||
18 de `v1-2-6-constats/`), à la place du panneau ; à trancher au plan U2b.
|
||
- Ordre des champs : la création reprend l'ordre du formulaire de modification (région vertébrale, puis zone de
|
||
constats), aujourd'hui inversé à la création.
|
||
|
||
## impeccable detect
|
||
|
||
`npx --offline impeccable@4.1.0 detect docs/design/v1-2-6-u2/maquettes.html` (2026-11-17, sans réseau) : 2 observations
|
||
esthétiques, les mêmes que pour R0 : `overused-font` (Inter, jeton `--font-sans` de l'application) et `cream-palette`
|
||
(#ECE6DA, fond de présentation des planches seulement), code de sortie 2. Gardées, comme décidé par le propriétaire à
|
||
R0. Relancé après la passe de corrections (même commande, hors ligne) : les deux mêmes observations, code de sortie 2, aucune nouvelle.
|
||
|
||
## Contrôles
|
||
|
||
Première passe, sur `bc19481` (2026-11-17), deux relectures neuves en parallèle :
|
||
|
||
- Revue graphique neuve : 5 à corriger, 19 améliorations, 19 observations. À corriger : le bandeau débordait à
|
||
1 280 px (05, 06 A) ; le message coupait son verbe (03) ; la planche 32 et A1 décrivaient mal la règle 1 de
|
||
l'orientation (la règle 3 permet de glisser les poignées sans dialogue) ; la planche 32 revendiquait WCAG 2.5.7 par
|
||
le clavier ; l'ordre d'Échap pouvait abandonner une saisie sans le dire. Données vérifiées conformes à
|
||
`document.json`, libellés conformes à `fr.ts`.
|
||
- Contrôle de conformité neuf : ECARTS(4), critères 1, 2, 3, 4, 6, 10 remplis. Non remplis : 5 (cibles de 44 px
|
||
manquantes sur la planche 13 hors poignées), 7 (motif « {type} · {nom} » du bandeau absent de la table des
|
||
libellés), 8 (conséquences manquantes pour A5 à A10, écart avec la règle 6 non nommé, choix visible de A12 non
|
||
soumis), 9 (cette section vide à ce moment-là). Les 10 PNG se rendent à l'identique ; `data.js` se régénère à
|
||
l'identique.
|
||
|
||
Corrections apportées (passe 2) : bandeau à deux lignes à gauche et largeur utile vérifiée à 958 px ; message après un
|
||
geste sans nom, sous le dessin ; comparaison honnête des règles 1, 3 et 6 ; tableau « Clavier (WCAG 2.1.1) » et tableau
|
||
« Pointeur sans glisser (WCAG 2.5.7) » avec le mode « Déplacer » et ses flèches (A11) ; ordre d'Échap avec la création
|
||
avant le tracé ; priorité d'un clic ; clic sur l'intérieur qui déchoisit un sommet ; planche 13 avec cibles de 44 px
|
||
partout, loupe, point au doigt (13 D) et doigt hors de la forme ; actions du dialogue regroupées ; « Replacer le point »
|
||
et « Reprendre le tracé » dans la première ligne du dialogue ; « Continuer » devenu « Revenir aux propriétés » ; sommet
|
||
choisi marqué par la taille et un cercle ; refus 33 A avec ses commandes ; plafond 33 D avec contour et commandes ;
|
||
lecture seule dite dans le bandeau ; message d'erreur sous le champ « Latéralité » ; « Couleur » en lecture seulement
|
||
si remplie (choix 11 b) ; liste de l'aperçu avec son en-tête et son filtre ; tracés de 04 entiers dans le cadre ;
|
||
arbitrages A11 à A14 ajoutés, A2 et A3 nommés comme écarts, conséquences complètes.
|
||
|
||
Contre-vérification neuve sur `8bdb23a` : ECARTS(1), critères 1 à 6 et 8 à 10 remplis. Les six défauts de la première
|
||
passe sont corrigés (bandeau, message, comparaison des règles 1, 3 et 6, voie sans glisser, ordre d'Échap, planche 13 à
|
||
44 px avec loupe et point au doigt), mesures faites dans le navigateur ; les 10 PNG et `data.js` se reproduisent à
|
||
l'identique. Écart restant, critère 7 : deux libellés absents de la table (« Celle de la catégorie » dans le champ
|
||
« Couleur », variante « Glissez n'importe où » de 13 C). Défauts mineurs relevés : note de `docs/design/README.md` et
|
||
du plan UX en retard (dix choix, règle 1 seule), renvoi vers une section absente ici, loupe de 13 D posée dans le point,
|
||
« Zone de constats » coupée sans points de suspension (31 C, D), en-tête de la tablette sous 44 px (« Défaire »,
|
||
« Refaire », onglets), libellé « Terminer » de l'orientation non soumis, cases du TODO non cochées.
|
||
|
||
Corrections apportées (passe 3) : libellé ajouté à la table, 13 C aligné sur 06 B ; notes du README et du plan UX
|
||
alignées sur ARBITRAGES (A1 à A3) ; loupe de 13 D au-dessus du point ; points de suspension dans les champs ; en-tête
|
||
de la tablette à 44 px ; A15 ajouté ; TODO à jour. Vérifié par rendu (planches 13 et 31) ; les autres planches ne
|
||
changent que par ces points.
|