13 KiB
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) :
- 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.
- 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, un double-clic sur une annotation, Entrée sur sa ligne dans la liste, 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.
É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é 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 », 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 :
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). - 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).