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

13 KiB
Raw Blame History

V1-2.6 U2 : manipulation graphique des annotations (proposition de conception, non validée)

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/ une fois validées ; 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 »)
03-point-modification-desktop.png Point sélectionné sans dialogue, déplacé (ancienne place en pointillé, message) ; B curseur de taille aimanté ; C dialogue en lecture ouvert d'un clic sur le point 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é »
05-zone-poignees-desktop.png Zone sélectionnée : sommets, « + », bulle « − », 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) ; C « Redessiner » sur l'ancien contour
13-tablette-tactile.png 1 180 px au doigt : poignées agrandies, cibles de 44 px, bandeau en 44 px ; B dialogue en lecture ouvert d'un toucher ; C déplacement au doigt
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 à la règle 1 de l'orientation ; Échap ; clavier pour chaque geste ; 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 dix choix soumis au propriétaire, dont l'écart A1 avec 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 180 px la barre latérale est masquée (bouton menu) et le dessin fait 694 × 520 px ; à 1 024 px, 538 × 403 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) ; 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, 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.
  • 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é » ; « Nouveau point », « Nouvelle zone », « Créer » ; « Marquer comme relu », « Remettre à confirmer », « Désélectionner », « Supprimer » ; dialogue de suppression et question « Abandonner les modifications ? » (R2).

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 ; poignées agrandies et cibles de 44 px au doigt
Ajouter un sommet avec « + » sur un segment 05, 05 A, 13 « + » au milieu de chaque segment ; le nouveau sommet est déjà choisi
Supprimer un sommet avec « − » 05, 05 C, 13 Bulle « − » sur le sommet choisi ; grisée sous 3 sommets
Déplacer et redessiner une zone 05, 06 A, 06 B, 06 C, 13 C Glisser direct à la souris, mode explicite au doigt et au clavier, redessin sur l'ancien contour
Modifier la taille d'un point 02 A, 03, 03 B Curseur du bandeau aimanté sur les tailles de la vue, trait rouge du minimum, sans nombre
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 la règle 1 de l'orientation du 14/11) :

  1. Un clic ou un toucher sans déplacement sur une annotation la sélectionne : poignées, bandeau, ligne marquée dans la liste. 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, un double-clic sur une annotation, Entrée sur sa ligne dans la liste, 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.

É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, « Déplacer la zone », « 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.
  • « Annuler » de l'historique devient « Défaire » (R0) ; le message après un geste dit « Défaire ».
  • 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 (choix 1 a ratifié) ; le mode reste pour le doigt et le clavier.
  • 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.

Nouveaux libellés (FR / EN)

FR EN Où
Propriétés Properties Bandeau, sélection
Taille Size Bandeau, curseur d'un point
Déplacer la zone Move zone Bandeau
Valider la position Confirm position Bandeau, mode déplacement
Redessiner Redraw Bandeau
Redessiner · {nom} Redraw · {name} Bandeau, tracé
Retirer le dernier sommet Remove last vertex Bandeau, tracé
Modifier la forme Edit shape Dialogue en lecture
Replacer le point Reposition the point Dialogue « Nouveau point »
Reprendre le tracé Resume tracing Dialogue « Nouvelle zone »
Continuer Continue Bandeau, création reprise
Nouvelle zone · tracé repris New zone · tracing resumed Bandeau
Point placé · renseignez ses propriétés Point placed · fill in its properties Bandeau
Tracé fermé · {n} sommets · renseignez ses propriétés Tracing closed · {n} vertices · fill in its properties Bandeau
Cliquez dans le dessin pour placer le point Click in the drawing to place the point Bandeau
{n} sommets · sommet {i} choisi {n} vertices · vertex {i} chosen Bandeau
Glissez n'importe où · flèches au clavier Drag anywhere · arrow keys Bandeau, mode déplacement
Fermeture refusée Closing refused Bandeau, refus
Trop de sommets pour les poignées : utilisez « Redessiner ». Too many vertices for handles: use “Redraw”. Bandeau, plafond T18
Celle de la catégorie The category's Dialogue, couleur en lecture
Vue View Dialogue en lecture
Point « {nom} » créé / déplacé ; Zone « {nom} » déplacée, redessinée ; Sommet ajouté, retiré ; Taille modifiée Point “{name}” created / moved; Zone “{name}” moved, redrawn; Vertex added, removed; Size changed Message après un geste
Défaire Undo Message après un geste (libellé existant de l'en-tête)
Déplacement refusé : {texte du cœur} Move refused: {core text} Message d'erreur

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.
  • 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 », la nouvelle zone « Tibia », les positions du point déplacé et de la zone déplacée, le tracé en cours et le tracé de redessin, la forme trop étroite, le texte du refus de déplacement, « 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).
  • Pendant une création, cliquer une autre annotation abandonne aujourd'hui la saisie sans le dire (uiState.ts:64-71) : les planches rendent les annotations non sélectionnables pendant la création.
  • 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.

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.

Contrôles

À compléter par la revue graphique et le contrôle de conformité neufs (section suivante).