# 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.