Files
faunosteo/docs/design/v1-2-6-u2/REVUE.md
T

20 KiB
Raw Blame History

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.