17 KiB
V1-2.6 · Éditeur graphique : maquettes et faisabilité
Branche feature/v1-2-anatomical-sheets. Brief du propriétaire du 2026-11-05, « nouvelles maquettes UX approuvées sur le principe ». Statut : proposition, non validée ; direction générale acceptée sur le principe par le propriétaire, corrections graphiques finales du 2026-11-05 appliquées après une revue externe (section « Corrections après la revue externe »). Rien n'est implémenté. Le cœur Rust, l'application, Supabase et DEV sont intacts. Aucune fusion, pas de V1-2.7. Contrat de ce lot : .claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md (U1 à U11).
Les deux chantiers séparés restent hors de ce dossier : le TOTP demandé à la connexion, et les illustrations manquantes qui empêchent la copie de la fiche équine historique.
Contenu du dossier
| Fichier | Rôle |
|---|---|
planche-contact.png |
Les seize planches réduites, groupées par étape du parcours |
planche-contact.html |
Même planche dans un navigateur : chaque vignette ouvre le PNG en pleine taille |
01-…png à 16-…png |
Les planches en pleine résolution |
maquettes.html, render.cjs |
Source des planches et outil de rendu (Chromium épinglé du projet) |
REVUE.md |
Ce rapport |
ARBITRAGES.md |
Les onze choix : statut (confirmé ou ouvert), dessin, alternatives, conséquences, recommandations et garde-fous |
ETUDE-TECHNIQUE.md |
Impacts techniques et préalables avant tout développement |
CONTROLE-CONFORMITE.md |
Résultats exacts des contrôles indépendants |
Les planches réutilisent l'identité validée : jetons de tokens.css, coque de l'étape 7, composants des maquettes V1-2.4. Le dessin est le fichier nettoyé du brouillon équin. Chaque point et chaque zone vient de son document.json, aux vraies coordonnées. Les compteurs sont calculés dans la source à partir de ces données, jamais saisis : chaque annotation compte une fois, sous sa catégorie, accès compris (l'accès à « Tête » appartient à Articulations dans le document), soit Os 2, Articulations 12, Vertèbres 5, Charnières vertébrales 4, Os du crâne 5, vue principale 19, Tête 9. La vue « Tête » et la nouvelle vue détaillée sont des cadrages du même fichier, comme le cœur les compose déjà.
Parcours
| Étape | Planches | Ce que l'utilisateur fait |
|---|---|---|
| Ouvrir | 01, 10, 11 | Quatre onglets : Général, Annotations, Constats, Vérification. Vues, illustrations et régions vertébrales vivent dans Annotations. Références s'ouvre en volet latéral depuis l'en-tête ou depuis un constat. |
| Points | 02, 03 | « Ajouter un point », clic sur le dessin, nom et catégorie, taille au curseur. Le point se glisse sur le dessin ; une poignée sur son bord change sa taille. |
| Zones | 04, 05, 06 | « Ajouter une zone », un clic par sommet, fermeture sur le premier sommet. Une zone sélectionnée montre ses sommets, un « + » au milieu de chaque segment et une bulle « − » sur le sommet cliqué. « Déplacer la zone » et « Redessiner » sont des modes explicites. |
| Structure | 07, 08, 09 | Catégories dans un volet dépliable, Os, Articulations et Vertèbres fixes. Vue détaillée tracée au rectangle avec un nom FR/EN proposé. Régions vertébrales depuis la catégorie Vertèbres. |
| États | 12 | Enregistrement, refus d'une modification, lecture seule, récupération locale, moteur indisponible. |
| Au doigt | 13, 14, 15, 16 | Tablette avec poignées agrandies. Téléphone avec panneau du bas et barre d'outils en bas : zone sélectionnée, point, vue détaillée, tracé d'une zone, déplacement, redessin, refus et enregistrement. Planche 15 C : la règle actuelle sous 1 024 px. |
Aucune coordonnée n'apparaît dans l'interface courante. L'alternative au glisser exigée par le WCAG 2.5.7 passe par le clavier, sur chaque geste : Tab parcourt les sommets, les points de contrôle et les poignées du rectangle d'une vue détaillée ; les flèches déplacent l'élément choisi (par 10 avec Maj) ; Inser ajoute un sommet après celui choisi ; Suppr le retire ; Entrée valide un tracé ou un déplacement, Échap l'annule. Les boutons « Terminer la zone », « Retirer le dernier sommet », « Déplacer la zone » et « Valider la position » donnent aussi une voie sans glisser. Chaque pastille de couleur porte son nom, et la catégorie s'affiche à la sélection : la couleur n'est jamais seule à porter le sens.
Choix de conception à arbitrer
Ces choix sont visibles dans les planches. Le choix 2 est confirmé par le propriétaire (brief du 2026-11-05) ; les dix autres restent ouverts. Le détail, avec les recommandations de la revue externe et leurs garde-fous, est dans ARBITRAGES.md. Les planches montrent le comportement dessiné, pas les recommandations encore à ratifier.
- Déplacement d'une zone entière par un mode explicite (« Déplacer la zone », planches 05, 06). Un mode évite les déplacements involontaires, au bureau comme au doigt ; hors de ce mode, un doigt hors d'une poignée ne déplace rien et deux doigts font défiler le dessin. L'alternative serait de glisser directement l'intérieur d'une zone sélectionnée sur desktop, comme le fait l'éditeur actuel.
- Annuler / Rétablir dans l'en-tête de l'éditeur, confirmé par le propriétaire : à droite de la barre d'onglets, identiques sur tous les onglets, tablette comprise (en 44 px) ; dans la barre du haut au téléphone. Plus aucune paire flottante sur le dessin. Le message « … déplacé · Annuler » après un geste reste (planche 03). Noms d'outils identiques partout : Sélectionner, Ajouter un point, Ajouter une zone, Créer une vue détaillée ; formes courtes (Point, Zone, Vue détaillée) seulement quand la largeur l'impose.
- Taille du point sans valeur chiffrée : curseur de « Petit » à « Grand », avec un trait rouge au minimum touchable.
- Noms des trois catégories fixes non modifiables, seules la couleur et l'opacité changent. Le brief dit « non supprimables », il ne dit rien des noms.
- L'opacité règle le remplissage seulement, le contour reste plein. Palette de seize couleurs, code hexadécimal, curseur et champ « 55 % » synchronisés, aperçu, « Appliquer ».
- Vue détaillée : le nom proposé reprend les annotations comprises dans le cadre (« Coude, carpe et boulet »). Une case cochée par défaut crée l'accès sur la vue parente avec le rectangle tracé. L'outil « Accès à une vue détaillée » de l'éditeur actuel disparaît de la barre ; un accès supplémentaire vers une vue existante passerait par le menu de la vue.
- Périmètre et limites en deux blocs : texte commun non modifiable ici, et précisions propres à la fiche. Le praticien lit les deux à la suite. Une nouvelle version du texte commun est signalée et ne s'applique qu'après accord.
- Enregistrement explicite conservé (bouton « Enregistrer », pas d'enregistrement automatique), désormais placé en dernier dans l'en-tête après Références et Prévisualiser.
- Téléphone : panneau du bas qui se tire ou s'ouvre par « Toutes les propriétés », barre de quatre outils en bas. « + » seulement sur les segments assez longs pour être touchés ; zoomer fait apparaître les autres.
- Tablette : la barre latérale de l'application se replie derrière le menu pour laisser la place au dessin.
- Couleur propre d'une annotation : le champ existe (
color). Les planches ne le montrent plus et toute annotation hérite de sa catégorie. À décider : le masquer, le garder en option avancée, ou le retirer du modèle.
Contradictions avec des décisions ratifiées
Le brief rouvre des décisions déjà prises. Les planches suivent le brief, ces points restent à confirmer.
| Décision en vigueur | Ce que la nouvelle UX demande |
|---|---|
| Contrat V1-2 §8.3 : glisser de sommet, rectangle de recadrage sur le dessin et courbes sont au niveau 2, différé | Les trois deviennent le cœur de l'éditeur |
| §8.4 et O14 A : édition en lecture seule sous 1 024 px | Interactions au doigt sur téléphone (planches 14, 15 A-B, 16). La planche 15 C montre la règle actuelle si elle est gardée |
| §8.2 : chaque coordonnée saisissable dans un champ numérique (alternative clavier et précision) | Coordonnées internes. Le clavier reste possible par les flèches, sans champ chiffré |
| §7.4 : « No template of scientific content is shipped » | Un texte commun préremplit « Périmètre et limites ». C'est un texte juridique, mais c'est un modèle livré |
| §8.2 : noms des catégories modifiables, couleur propre par annotation, outil de lien vers une vue détaillée | Noms des catégories fixes figés (choix 4), couleur héritée de la catégorie (choix 11), lien créé avec la vue détaillée (choix 6) |
| BDR-096 : planches 04 et 05 de V1-2.4 approuvées comme référence de l'éditeur | Ces maquettes les remplacent une fois validées (règle de docs/design/README.md : un changement de direction demande un nouveau fichier validé) |
| V1-2.6 niveau 1 construit, essai du propriétaire en attente | Il faut décider si la nouvelle UX remplace l'essai, s'ajoute à V1-2.6 ou devient une étape avant V1-2.7 |
Faisabilité avec le cœur Rust actuel
Audit en lecture seule de crates/core et de l'éditeur. Les références détaillées (fichier:ligne) sont dans .claude/audits/2026-11-05-v1-2-6-ux-feasibility.md. Classement : déjà possible (opérations existantes), page seule (le cœur suffit, seule l'interface change), opération à créer dans le cœur, changement de schéma du document v2.
| Besoin | Classement | Constat |
|---|---|---|
| Déplacer un point, régler son rayon | Déjà possible | Un update de l'annotation au relâchement. Le rayon par glisser ou curseur ne change que la page |
| Glisser un sommet, insérer au milieu d'un segment, retirer un sommet, déplacer un polygone | Page seule | Chaque geste est un update avec le nouveau tableau de points. Minimum de 3 sommets déjà refusé par le schéma. Les cercles de sommets actuels sont décoratifs (pointer-events-none) |
| Refus d'une forme (hors cadre, trop petite, intérieur trop étroit) | Déjà possible | out_of_frame, too_small, interior_too_small contrôlés après chaque validation, moins de 61 ms sur l'équin. L'aperçu pendant le geste reste côté page |
| Annuler / Rétablir | Déjà possible | Une entrée par modification acceptée, 8 Mio de pile. Ctrl+Z et Ctrl+Maj+Z existent |
| Redessiner une zone | Page seule | Un update de la géométrie qui garde les autres champs |
| Tracer une vue détaillée au rectangle | Page seule | Le rectangle donne le view_box d'une vue sans dessin propre. Le compositeur garde tout le SVG (définitions, transformations) et ne fait que recadrer : la qualité vectorielle est conservée sans fichier dérivé |
| Nom FR/EN proposé pour la vue | Opération à créer | Aucune requête ne liste les annotations dans un rectangle. Esquisse : sheet.annotations_in_rect {document, view_id, rect} → [{id, name, category_id, inside | partial}] |
| Remplacer le cadrage par un SVG spécifique | Déjà possible, remise en place à créer | Téléversement, nettoyage, rattachement existent. Les coordonnées sont gardées telles quelles et relues dans l'espace du nouveau dessin : les annotations peuvent se décaler. Esquisse : transposer les géométries du cadre au nouveau viewBox, les passer « À confirmer » |
| Éditer une courbe sans la simplifier (sommets et points de contrôle) | Opération à créer | Le cœur lit d pour le mesurer, sans modèle de segments ni écrivain. Une proposition existe, non construite : sheet.path_points et sheet.path_move_points (.claude/tasks/plans/2026-11-04-v1-2-6-path-repair-core-proposal.md). Il reste à traiter les chemins relatifs (déplacer un point décale les suivants), H et V, les contrôles implicites S et T, les arcs. Aucune fiche actuelle ne contient de courbe |
| Déplacer une zone courbe entière | Opération à créer | Même manque : aucune translation de d aujourd'hui |
| Catégories fixes Os, Articulations, Vertèbres | Changement de schéma ou règle nouvelle | Aucune notion de catégorie fixe. Une fiche neuve démarre sans catégorie. Il faut un rôle par catégorie (ou des identifiants réservés) et une règle qui refuse leur suppression |
| Opacité par catégorie | Changement de schéma et du rendu | Couleur #rrggbb seulement. Opacités codées en dur dans le calque (point 0,65 ou 0,5, zone 0,3, accès 0,06, PDF 0,85). Toucher au rendu impose de mettre à jour docs/ANNOTATION-RENDERING.md d'abord, et les références R3/R4 ne se régénèrent pas sans décision |
| Lien catégorie Vertèbres ↔ régions | Page seule ou règle nouvelle | Aujourd'hui toute annotation peut porter une région, quelle que soit sa catégorie. Filtrer le choix par catégorie ne change que la page ; l'imposer est une règle de validation |
| Régions vertébrales dans la catégorie | Page seule | Code unique, nombre positif, plage count_range cohérente et suppression refusée tant qu'une zone l'utilise : règles déjà dans le cœur |
| Texte commun de « Périmètre et limites » | Page seule, source à décider | Un seul update. Il faut décider où vit le texte commun (dictionnaire de l'application, table serveur) et qui en porte la rédaction juridique |
| Références en volet secondaire | Page seule | Seuls les constats citent des références |
| Toucher : poignées, deux doigts | Page seule, défaut à corriger | Pincer et faire défiler existent déjà. Le geste de déplacement ne vérifie pas pointerId : un second doigt peut l'alimenter |
Conséquences d'un changement de schéma
Ajouter un rôle ou une opacité aux catégories touche : les types ts-rs, le lecteur N-1 figé (strict, il refuserait un instantané nouveau), l'instantané embarqué dans chaque PDF, l'empreinte RFC 8785 de la fiche, les empreintes des groupes de revue, les contrôles SQL de version de schéma, le verdict du worker. Un champ flottant retire aussi Eq à AnnotationCategory. Les lecteurs d'archives ne perdent jamais une version : un document v3 coexisterait avec v2. Une piste à étudier pour limiter l'effet : rôle et opacité déduits sans nouveau champ (identifiants réservés, opacité fixe par rôle), au prix de la souplesse demandée.
Autres risques
- Il reste environ 17 Ko de marge sur le module WebAssembly (583 126 o sur 600 000 o compressés) pour les nouvelles opérations.
- La fiche équine a cinq catégories : Articulations, Os, Charnières vertébrales, Segments vertébraux, Os du crâne. Les planches rangent « Segments vertébraux » sous Vertèbres et gardent « Charnières vertébrales » et « Os du crâne » comme catégories de la fiche. Ce rattachement est à valider, avec la migration de la copie de travail.
Ce qui n'est pas dessiné
Le contenu des onglets Constats et Vérification ne change pas : seule leur place dans la barre d'onglets est montrée (planche 11 pour Constats). Les écrans de revue et de publication relèvent de V1-2.7.
Relecture d'écriture
Texte relu contre les règles de style du projet : pas de tiret cadratin, pas de liste réflexe en trois points, pas de vocabulaire creux. Rien d'autre à corriger.
Corrections après la revue externe (2026-11-05)
Brief du propriétaire « Revue finale des nouvelles maquettes UX V1-2.6 », après la revue graphique faunosteo-v1-2-6-revue-ux-chatgpt.md. Contrat : .claude/tasks/contracts/2026-11-05-v1-2-6-ux-corrections.md (K1 à K9). Seuls les cinq défauts documentés ont été corrigés ; le fonctionnement validé de « + » et « − » sur le polygone et le glisser des sommets à la souris ou au doigt est conservé.
| # | Défaut | Correction | Planches |
|---|---|---|---|
| 1 | Barre d'actions sur le dernier sommet | Les commandes du tracé passent dans un bandeau fixe entre la barre d'outils et le dessin, qui ne recouvre jamais le tracé, quel que soit le zoom | 04 |
| 2 | Annuler / Rétablir flottants, absents de 06 | Commandes globales à droite de la barre d'onglets, sur tous les onglets ; 06 montre cet en-tête dans ses deux états ; sur 11, le volet Références s'ouvre sous l'en-tête pour le laisser visible | 01 à 11, 13, 14, 16 |
| 3 | Formulaire « Nouvelle catégorie » coupé | Formulaire complet dans son propre état, avec noms FR et EN, palette, opacité et aperçu | 07 D |
| 4 | Plusieurs états ouverts à la fois | Un état par interaction : A éditeur d'une catégorie fixe ; B menu « ⋮ » seul ; C modification d'une catégorie de la fiche ; D nouvelle catégorie. Un seul élément du volet est ouvert à la fois | 07 |
| 5 | Compteurs faux | Compteurs calculés depuis les données, une seule règle sur toutes les planches | 07, 09 ; 01 et 14 D suivent la même règle (vue principale 19 au lieu de 18) |
Planches régénérées : 01 à 11, 13, 14, 16 (en-tête d'annulation, et selon la planche compteurs, bandeau ou états). Planches 12 et 15 inchangées, octet pour octet : leurs extraits ne contiennent pas la barre d'onglets, et les seuls compteurs de 15 (« utilisée par 1 zone ») étaient déjà justes ; ils sont désormais calculés eux aussi. La planche 12 A montre seulement la partie « enregistrement » de l'en-tête. La planche-contact est régénérée.
Les planches téléphone 14 à 16 restent une proposition prospective : la règle O14 A (lecture seule sous 1 024 px) est toujours en vigueur, et la recommandation 9 propose d'en faire un lot futur distinct.