docs(docs): V1-2.6 U2 boards 02-06, 13, 31-33, review and arbitrations
This commit is contained in:
1 parent
c42c65509b
commit
bc19481b93
18 files changed
+1335
No files matched your search
@@ -0,0 +1,160 @@
|
||||
# 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).
|
||||
Reference in new issue
Block a user