20 KiB
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) :
- 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.
- 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.
- 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.
- Le dialogue de création s'ouvre seul après le placement d'un point ou la fermeture d'un tracé.
- 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é depuisdocument.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 :
LAYERSgagneannotationetEditorViewun 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,DiscardConfirmde 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.jsse 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.