diff --git a/.claude/tasks/TODO.md b/.claude/tasks/TODO.md index 4e051153..d23514e9 100644 --- a/.claude/tasks/TODO.md +++ b/.claude/tasks/TODO.md @@ -743,6 +743,7 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet - [x] Final fix wave (FX1-FX16, `.superpowers/sdd/2026-11-16-r4-card-integrity-2337/final-fix-list.md`): b378cf0 retry ending with no retry left keeps the polite region and moves focus to « Consulter », busy look on « Réessayer », engine stopped for good in the error tone, one attempt for two calls in one tick, rendered tests (engine stopped, two cards on the core, no blob URL after unmount); 2930f49 lines over 100 columns wrapped; 1e50585 board 30 deviation fixed (failure row `*:px-3`, both buttons on one row at 1280 and 375, e2e checks it); 3bea19f spec reads each own sheet's name by id before archiving, `seedGrant` account id through `capturedId`. App 1775 tests in 138 files; typecheck, lint, build exit 0. `catalogue-integrity.spec.ts` alone 6 passed 0 failed 0 skipped 0 flaky (twice: once with temporary screenshot lines, once as committed); `catalogue.spec.ts` alone 8 passed. Guard: 0 removed, 0 changed, 81 added (27 sheets, 43 versions, 11 grants), the runs' own; 8 R4 sheets archived, 4 grants revoked, read back. `pnpm check:all` then run at `2c9d837` (line above) - [ ] Follow-up: seed owner row in `private.catalog_write_budgets` is R4's own (none before R4; its first run created it, later runs update that same row, 4 archives per run; 8 of 300 per hour after the final wave, outside the data guard); `catalogue.spec.ts` still leaves its published sheets listed, warm-up its sheet and `sheet_editor` grant per invocation (BLK-015, RR-13) - [ ] owner arbitrations A1-A15 (`V1-2-6_U1_CORRECTIONS.md` §6, `TRIAL_STACK.md` §6) + - [ ] V1-2.6 UX U2 design: boards 02-06, 13 redrawn + extras from 31 (owner brief 2026-11-17 « R4 est terminé … préparer U2 », orientation 2026-11-14 BDR-117; contract `.claude/tasks/contracts/2026-11-17-u2-design-boards.md`; docs only, no code, no DEV, no merge). [ ] audit as built · [ ] boards + REVUE + ARBITRAGES in `docs/design/v1-2-6-u2/` · [ ] fresh design review · [ ] fresh conformity check · [ ] STOP owner visual validation before any U2 plan or code - [ ] Test anomaly A (owner 2026-11-09, separate from U1/U2): fictitious fingerprints `'a'.repeat(64)` from worker stand-ins (`packages/supabase/tests/sandbox/sheet-fixtures.ts:115` openRound, `sheets-concurrency.sandbox.ts:168`, `sheets-perf.sandbox.ts:169`); 7 published/deprecated sandbox versions fail `check_published`. Fix: real fingerprint through the core (as e2e `fingerprintOf`, `apps/app/e2e/support/catalogue.ts:88`); never weaken the publish gate or the reader check. Needs its own go. Census 2026-11-17 (R4 Task 3, read-only): 4 of 164 catalogue entries fail, the four current « Cheval sandbox » versions (2 at v1, 2 at v2), all `fingerprint_mismatch`; R4 cards show them with the integrity line. - [ ] Test anomaly B (owner 2026-11-09, separate from U1/U2): `packages/supabase/tests/sandbox/sheets-admin.sandbox.ts:181-195` creates the historical working copy and never archives it; slot taken → `admin.spec.ts:717` fails x4. Fix test independence and cleanup; the existing copy `8c315a12-20d4-4432-9db3-7cb88b27a5b4` stays untouched until the owner authorises. Linked: RR-13, the admin.spec confirmation line above. - [x] Test anomaly C (owner 2026-11-09, separate from U1/U2): CLOSED 2026-11-17 with R4's owner validation. Integrity failure invisible in catalogue cards; implemented as lot R4; failure shown, never hidden or bypassed. Built 2026-11-17 (R4 Task 1-3 and final fix wave, `V1-2-6_U1_CORRECTIONS.md` §5 row C: built by R4, closes on the owner's validation); checked off with R4's owner validation. diff --git a/.claude/tasks/contracts/2026-11-17-u2-design-boards.md b/.claude/tasks/contracts/2026-11-17-u2-design-boards.md new file mode 100644 index 00000000..ac0edecb --- /dev/null +++ b/.claude/tasks/contracts/2026-11-17-u2-design-boards.md @@ -0,0 +1,118 @@ +# CONTRACT — u2-design-boards +- date: 2026-11-17 | flow: design and documentation only (U2 boards, review, arbitrations, tracking) | branch: feature/v1-2-anatomical-sheets +- status: open +- worktree: /home/bchanot/Documents/faunosteo-v1-2 (every command from this absolute path; never DEV: the + `supabase_*_faunosteo` containers are DEV). The sandbox and the trial stack are not read nor written by this lot. +- base: c42c655. Commit in place, push; no merge, no `gitflow.sh finish`. +- untracked file kept: `faunosteo-v1-2-6-revue-ux-chatgpt.md`. + +## REQUEST (verbatim — IMMUTABLE) + +### Owner brief 2026-11-17 (R4 closed, U2 design start) + +Je confirme avoir terminé mes tests manuels de R4 sur la sandbox. + +Tous les tests fonctionnent correctement et le résultat me convient. + +Je valide officiellement R4. + +Je confirme également les deux décisions restantes : + +1. Nettoyage des fiches de test : +Je valide leur archivage plutôt que leur suppression. + +Les règles métier concernant les fiches ayant eu une version publiée doivent rester inchangées. + +2. Fichiers supplémentaires : +J'accepte les modifications de Card.tsx et de l'utilitaire de validation des identifiants SQL. + +Tu peux maintenant procéder à la clôture documentaire de R4 : +- Enregistrer ma validation propriétaire. +- Mettre à jour les contrats, le TODO et le suivi. +- Enregistrer les décisions et apprentissages pertinents. +- Conserver les résultats exacts des tests. +- Committer et pousser les modifications documentaires. + +BLK-015, RR-13 et l'anomalie A restent des chantiers séparés. + +R4 est terminé. + +Nous pouvons maintenant préparer U2 : la refonte de la manipulation graphique des annotations. + +Je souhaite commencer par la conception graphique, conformément à notre méthode habituelle. + +Reprends les maquettes validées et les nouvelles décisions UX concernant les modales de propriétés des annotations. + +Les objectifs restent : +- Création d'un point directement sur le schéma. +- Création d'une zone en traçant son polygone. +- Déplacement des sommets avec la souris ou le doigt. +- Ajout d'un sommet avec « + » sur un segment. +- Suppression d'un sommet avec « − ». +- Déplacement et redessin d'une zone. +- Modification de la taille d'un point. +- Consultation et modification des propriétés dans une modale. +- Ouverture de la modale de création après le placement du point ou la fin du tracé. + +Les interactions graphiques doivent rester possibles sans que les modales gênent les gestes. + +Prépare les nouvelles maquettes U2, notamment les planches 02 à 06 et 13, ainsi que les éventuels écrans supplémentaires nécessaires. + +Je te laisse autonome pour auditer l'existant, proposer les meilleures interactions et organiser les relectures. + +Présente-moi les maquettes pour validation visuelle avant toute implémentation de U2. + +Aucune fusion ni intervention sur DEV. + +## CLARIFICATIONS +- « Les nouvelles décisions UX concernant les modales de propriétés des annotations » = the owner orientation of + 2026-11-14 (BDR-117), recorded in `docs/development/V1-2-6_UX_PLAN.md` §U2 « Orientation 2026-11-14 », + `docs/development/V1-2-6_UX_DECISIONS.md` row « U2 orientation » and `docs/design/README.md` note of 2026-11-14. +- « Les maquettes validées »: `docs/design/v1-2-6/` boards 01 to 16 (approved for good, not reopened, except boards + 02 to 06 and 13 which the orientation sends back for redrawing), the R0 boards `docs/design/v1-2-6-r0/` 23 to 30 + (validated 2026-11-09, BDR-110; board 26 draws the Annotations tab as U1 built it), the constats boards + `docs/design/v1-2-6-constats/` and the step 7 shell. +- Ratified rules that bind the drawing (`V1-2-6_UX_DECISIONS.md`, `v1-2-6/ARBITRAGES.md`, `V1-2-6_UX_PLAN.md` §U2): + choice 1 (a) a selected zone drags directly with the mouse, an explicit « Déplacer la zone » mode by touch; choice 3 + (b) the point size slider snaps to the sizes used in the view, no number shown, red minimum mark (core + `marker_too_small`); choice 10 (b) the app sidebar hidden in the editor below 1 280 px; O14 A below 1 024 px the + editor is read-only (boards 14 and 16 unchanged); T15 wording « Abandonner » for a form, « Défaire » / « Refaire » + for the history (R0); T18 handle cap per shape; §2 G keyboard (Tab between handles, arrows, Maj by 10, Inser, + Suppr, Entrée, Échap); 44 px touch targets; no coordinate field in the normal journey; curves excluded (curves lot). +- What is open and goes to the owner as an arbitration: any deviation from the 2026-11-14 interaction rules that the + request's « sans que les modales gênent les gestes » leads to, the dialog placement over the drawing, the laterality + default at creation (C25), and any other visible choice the boards make. + +## ACCEPTANCE CRITERIA +1. Boards: a new folder `docs/design/v1-2-6-u2/` holds `maquettes.html`, its data generator and generated data, one + PNG per board rendered with the pinned Chromium (`docs/design/v1-2-6/render.cjs`), a contact sheet (PNG and HTML) + and `REVUE.md` in French. Boards 02 to 06 and 13 are redrawn under their numbers; extra boards, if any, are + numbered from 31. +2. Objectives: each of the nine objectives of the request is drawn on at least one board, and `REVUE.md` holds a + table objective → board(s) → what is shown. +3. Dialogs: properties are read and edited in a modal dialog (read mode first, then a form whose actions reuse the R2 + wording); the creation dialog opens after the point is placed or the trace is finished, the new shape staying + visible; no board shows a gesture on the drawing while a dialog is open, and no dialog covers the shape it + concerns. The rule for when a dialog opens (and when it does not) is written in `REVUE.md`. +4. Geometry on the drawing: point move and size (slider in the fixed strip with the red minimum mark and the snap + marks), vertex drag, « + » on a segment, « − » on the chosen vertex, zone move (mouse direct, touch explicit mode), + redraw keeping the old shape until accepted, each undoable in one step through « Défaire »; no coordinate field. +5. Touch: board 13 at 1 180 px with 44 px targets, the sidebar hidden (choice 10 b), the explicit touch move mode, and + a dialog opened by touch. +6. Keyboard: the alternative to every drag (WCAG 2.5.7) and the focus path into and out of the dialogs (return target) + are drawn or written on the boards. +7. Identity and truth: tokens, shell (five tabs, « Défaire » / « Refaire », save line as built after R2), components and + icons reused from the validated boards with no new colour; annotations at their real coordinates from the equine + draft `document.json` through the generator; every new visible label listed in `REVUE.md` with FR and EN. +8. Arbitrations: `docs/design/v1-2-6-u2/ARBITRAGES.md` lists every choice that needs the owner, each with what the + boards draw, the alternatives, the consequences and a recommendation; any deviation from the 2026-11-14 orientation + is named as such. +9. Reviews: a fresh design review and a fresh conformity check against this contract, their exact results written in + `REVUE.md` (or a `CONTROLE-CONFORMITE.md`), and `impeccable detect` on `maquettes.html` run or its absence stated. +10. Restrictions: the branch diff from c42c655 touches only `docs/`, `.claude/tasks/`, `.claude/memory/`; nothing under + `apps/`, `packages/`, `crates/`, `supabase/`, `scripts/`; no stack started, stopped or written; no merge; DEV + unchanged; the untracked review file still present. + +## FILE SCOPE +docs/design/v1-2-6-u2/**, docs/design/README.md, docs/development/V1-2-6_UX_PLAN.md (U2 note only), +.claude/tasks/TODO.md, .claude/tasks/contracts/this file, .claude/memory/* diff --git a/docs/design/v1-2-6-u2/02-point-creation-desktop.png b/docs/design/v1-2-6-u2/02-point-creation-desktop.png new file mode 100644 index 00000000..f94efada Binary files /dev/null and b/docs/design/v1-2-6-u2/02-point-creation-desktop.png differ diff --git a/docs/design/v1-2-6-u2/03-point-modification-desktop.png b/docs/design/v1-2-6-u2/03-point-modification-desktop.png new file mode 100644 index 00000000..444c798b Binary files /dev/null and b/docs/design/v1-2-6-u2/03-point-modification-desktop.png differ diff --git a/docs/design/v1-2-6-u2/04-zone-creation-desktop.png b/docs/design/v1-2-6-u2/04-zone-creation-desktop.png new file mode 100644 index 00000000..ecd05eb0 Binary files /dev/null and b/docs/design/v1-2-6-u2/04-zone-creation-desktop.png differ diff --git a/docs/design/v1-2-6-u2/05-zone-poignees-desktop.png b/docs/design/v1-2-6-u2/05-zone-poignees-desktop.png new file mode 100644 index 00000000..3bdf9b92 Binary files /dev/null and b/docs/design/v1-2-6-u2/05-zone-poignees-desktop.png differ diff --git a/docs/design/v1-2-6-u2/06-zone-deplacer-redessiner-desktop.png b/docs/design/v1-2-6-u2/06-zone-deplacer-redessiner-desktop.png new file mode 100644 index 00000000..ead2a17a Binary files /dev/null and b/docs/design/v1-2-6-u2/06-zone-deplacer-redessiner-desktop.png differ diff --git a/docs/design/v1-2-6-u2/13-tablette-tactile.png b/docs/design/v1-2-6-u2/13-tablette-tactile.png new file mode 100644 index 00000000..e0a48709 Binary files /dev/null and b/docs/design/v1-2-6-u2/13-tablette-tactile.png differ diff --git a/docs/design/v1-2-6-u2/31-dialogue-proprietes-etats.png b/docs/design/v1-2-6-u2/31-dialogue-proprietes-etats.png new file mode 100644 index 00000000..2f50ef91 Binary files /dev/null and b/docs/design/v1-2-6-u2/31-dialogue-proprietes-etats.png differ diff --git a/docs/design/v1-2-6-u2/32-ouverture-gestes-clavier.png b/docs/design/v1-2-6-u2/32-ouverture-gestes-clavier.png new file mode 100644 index 00000000..e730943b Binary files /dev/null and b/docs/design/v1-2-6-u2/32-ouverture-gestes-clavier.png differ diff --git a/docs/design/v1-2-6-u2/33-refus-et-etats.png b/docs/design/v1-2-6-u2/33-refus-et-etats.png new file mode 100644 index 00000000..0a35de83 Binary files /dev/null and b/docs/design/v1-2-6-u2/33-refus-et-etats.png differ diff --git a/docs/design/v1-2-6-u2/ARBITRAGES.md b/docs/design/v1-2-6-u2/ARBITRAGES.md new file mode 100644 index 00000000..e2f466e3 --- /dev/null +++ b/docs/design/v1-2-6-u2/ARBITRAGES.md @@ -0,0 +1,123 @@ +# U2 : choix à arbitrer par le propriétaire + +Brief du 2026-11-17 (« préparer U2 », « sans que les modales gênent les gestes »), orientation du 2026-11-14 +(BDR-117, `docs/development/V1-2-6_UX_PLAN.md` §U2). Les planches dessinent la recommandation de chaque choix. +Rien n'est implémenté ; aucun choix ci-dessous ne vaut autorisation de code. + +## Tableau de synthèse + +| # | Choix | Écart avec l'orientation du 14/11 | Recommandation | +|---|---|---|---| +| A1 | Quand le dialogue de propriétés s'ouvre | **Oui** (règle 1) | Le premier clic sélectionne seulement ; le dialogue s'ouvre par un clic sur l'annotation déjà sélectionnée, un double-clic, Entrée ou « Propriétés » | +| A2 | Où le dialogue s'ouvre | Précise « ouvert sur le dessin » | Sur la colonne de droite, à sa largeur (22 rem), voile plus léger que celui des constats | +| A3 | La colonne de droite pendant une sélection | Précise « le dessin garde toute sa largeur » | L'aperçu (vues, catégories, liste) reste affiché ; la ligne sélectionnée y est marquée | +| A4 | Latéralité à la création (question C25) | Non, la règle laissait la question ouverte | Aucune valeur par défaut, « Choisir… » obligatoire, comme aujourd'hui | +| A5 | Taille d'un nouveau point | Non | La taille la plus utilisée dans la vue (34 sur la vue principale) | +| A6 | Un seul bandeau fixe au-dessus du dessin | Non, il précise le « bandeau de tracé » | Bandeau unique, hauteur fixe, sur toute la largeur de l'onglet | +| A7 | Outil après « Créer » | Non | Retour à « Sélectionner », le nouvel élément sélectionné | +| A8 | Champs de coordonnées | Non | Retirés partout ; le clavier remplace le glisser | +| A9 | Champ « Couleur » | Non | Gardé dans le formulaire du dialogue, comme aujourd'hui | +| A10 | « Marquer comme relu » | Non | Action directe du dialogue en lecture, comme pour un constat | + +## A1. Quand le dialogue de propriétés s'ouvre · écart avec l'orientation + +- **Orientation du 14/11, règle 1** : un clic sans déplacement sélectionne l'annotation et ouvre son dialogue en lecture. +- **Constat** : le dialogue est modal. Tant qu'il est ouvert, le dessin ne répond plus. Pour corriger une forme, il + faut fermer le dialogue avant chaque geste, et sélectionner une autre zone rouvre un dialogue. C'est la gêne que le + brief du 17/11 demande d'éviter. +- **Dessiné (planches 03, 05, 13, 32)** : le premier clic ou toucher sélectionne seulement (poignées, bandeau, ligne + marquée). Le dialogue s'ouvre par un clic sans déplacement sur l'annotation déjà sélectionnée (la règle 3 de + l'orientation), un double-clic sur une annotation, Entrée sur sa ligne dans la liste, ou « Propriétés » dans le + bandeau. Un glisser n'ouvre jamais le dialogue. +- **Alternatives** : (a) la règle 1 telle quelle ; (b) le dialogue seulement par « Propriétés » et Entrée, sans clic + sur le dessin. +- **Conséquences** : la recommandation coûte un clic de plus pour lire les propriétés ; le bandeau affiche le nom et le + statut dès la sélection. Elle garde le comportement actuel du premier clic (aujourd'hui, un clic sélectionne sans + rien ouvrir). (a) ajoute une fermeture avant chaque correction. (b) cache l'ouverture à qui ne lit pas le bandeau. +- **Recommandation** : celle dessinée. + +## A2. Où le dialogue s'ouvre + +- **Dessiné (02, 04, 13)** : le dialogue s'ouvre au-dessus de la colonne de droite, à sa largeur (352 px), aligné en + haut du dessin. Le dessin n'est jamais couvert, la forme concernée reste visible. Le voile est plus léger (22 % + d'encre) que celui des dialogues de constats (`bg-black/40`) pour que la forme reste lisible dessous. +- **Alternatives** : (a) dialogue centré, taille `lg` (672 px) comme celui d'un constat : il couvre la plus grande + partie d'un dessin de 538 px ; (b) dialogue placé du côté opposé à la forme : sa position change d'une fois à + l'autre. +- **Conséquences** : la recommandation ajoute une variante de placement au composant `Dialog`, le reste (focus, Échap, + historique, saisie protégée) est celui de R2. À 1 024 et 1 280 px la colonne fait la même largeur, le cas est donc le + même. Le dialogue reste modal : le geste sur le dessin attend sa fermeture. +- **Recommandation** : celle dessinée. + +## A3. La colonne de droite pendant une sélection + +- **Aujourd'hui** : sans sélection, la colonne montre l'aperçu (Vues, Catégories, Annotations de la vue) ; avec une + sélection, elle devient le panneau de propriétés. +- **Dessiné** : l'aperçu reste affiché pendant la sélection ; la ligne de l'annotation y est marquée. Les propriétés + passent au dialogue. +- **Alternatives** : (a) colonne retirée, dessin sur toute la largeur (environ 900 px à 1 280 px) et aperçu derrière un + bouton ; (b) colonne repliable. +- **Conséquences** : la liste est aujourd'hui la seule voie clavier pour sélectionner une annotation (les repères du + dessin ne prennent pas le focus) ; la garder visible garde cette voie et le retour du focus. Le dessin reste à 538 px + à 1 280 px, avec le zoom. (a) agrandit le dessin mais cache la liste et oblige à revoir la voie clavier. +- **Recommandation** : celle dessinée ; « le dessin garde toute sa largeur » est lu comme « aucun panneau de propriétés + ne réduit le dessin ». + +## A4. Latéralité à la création (question C25) + +- **Aujourd'hui** : aucune valeur par défaut, « Choisir… » ; « Créer » refuse sans latéralité (« Choisissez la catégorie + et la latéralité (et la vue ouverte pour un accès). »). +- **Dessiné (02, 04, 33 B)** : la même règle. +- **Alternatives** : (a) une valeur par défaut fixe (« Bilatérale ») ; (b) la dernière valeur utilisée. +- **Conséquences** : une valeur par défaut fausse s'enregistre sans que personne ne la voie ; la latéralité compte dans + le bilan. (a) et (b) font gagner un choix par création. +- **Recommandation** : aucune valeur par défaut. + +## A5. Taille d'un nouveau point + +- **Aujourd'hui** : rayon calculé depuis le cadre (`frame.ts:55-59`), environ 74 unités sur la vue principale, plus du + double des points existants (34). +- **Dessiné (02)** : le curseur du bandeau part de la taille la plus utilisée dans la vue (34 sur la vue principale, 27 + sur la tête) ; elle se change avant ou après le placement. +- **Alternative** : garder le rayon calculé. +- **Recommandation** : la taille la plus utilisée ; sans point dans la vue, le rayon calculé. + +## A6. Un seul bandeau fixe + +- **Aujourd'hui** : une ligne « Outil : … » au-dessus du dessin, qui change de hauteur avec ses messages (le dessin se + décale, BLK-013 resté ouvert pour cette ligne), et une barre de tracé sous le dessin, seulement pendant un tracé. +- **Dessiné (toutes les planches)** : un bandeau de hauteur fixe au-dessus du dessin et de l'aperçu, sur toute la + largeur de l'onglet. Il porte la consigne de l'outil, la sélection (nom, statut, taille, « Déplacer la zone », + « Redessiner », « Propriétés », « Désélectionner »), les commandes du tracé et les refus du cœur (deux lignes au plus). +- **Alternative** : bandeau au-dessus du dessin seul (590 px) : les commandes d'une zone n'y tiennent pas sur une ligne. +- **Recommandation** : celle dessinée. + +## A7. Outil après « Créer » + +- **Aujourd'hui et planche 02 d'origine** : l'outil Point reste actif pour enchaîner les points. +- **Dessiné (02 C)** : retour à « Sélectionner », le nouveau point sélectionné, prêt à être glissé ou redimensionné ; + pour enchaîner, on reprend l'outil. +- **Alternative** : garder l'outil actif ; le nouveau point ne se corrige qu'après avoir changé d'outil. +- **Recommandation** : retour à « Sélectionner ». + +## A8. Champs de coordonnées + +- **Aujourd'hui** : « Centre x », « Centre y », « Rayon » et une ligne x, y par sommet dans le panneau. +- **Dessiné** : aucun champ de coordonnées. La voie sans glisser passe par le clavier (planche 32 C) et par + « Déplacer la zone », « Redessiner », « + » et « − ». +- **Alternative** : une section repliée « Coordonnées » dans le formulaire du dialogue, pour une valeur exacte. +- **Recommandation** : retirés, comme l'objectif U2 ratifié (« coordinate fields leave the normal journey »). + +## A9. Champ « Couleur » + +- **Aujourd'hui** : un champ texte dans le panneau (hexadécimal, vide = couleur de la catégorie), absent à la création. +- **Dessiné (31)** : gardé dans le formulaire du dialogue, avec son aide ; en lecture, « Celle de la catégorie » ou la + valeur. +- **Recommandation** : le garder ainsi ; son sélecteur de couleur reste l'affaire du lot catégories (U6). + +## A10. « Marquer comme relu » + +- **Dessiné (31)** : action directe du dialogue en lecture, une modification et un « Défaire », comme dans le dialogue + d'un constat ; « Remettre à confirmer » une fois relu. +- **Alternative** : un champ du formulaire, enregistré avec le reste. +- **Recommandation** : action directe. diff --git a/docs/design/v1-2-6-u2/REVUE.md b/docs/design/v1-2-6-u2/REVUE.md new file mode 100644 index 00000000..38e7bfb6 --- /dev/null +++ b/docs/design/v1-2-6-u2/REVUE.md @@ -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). diff --git a/docs/design/v1-2-6-u2/data.js b/docs/design/v1-2-6-u2/data.js new file mode 100644 index 00000000..232c43a2 --- /dev/null +++ b/docs/design/v1-2-6-u2/data.js @@ -0,0 +1,2 @@ +// generated by gen-data.cjs from document.json +window.DOC = {"name":{"fr":"Cheval","en":"Horse"},"views":[{"id":"main","fr":"Vue latérale gauche","en":"Left lateral view","parent":null,"box":null},{"id":"head","fr":"Tête (vue latérale gauche)","en":"Head (left lateral view)","parent":"main","box":{"min_x":60,"min_y":100,"width":500,"height":380}}],"categories":[{"id":"articulations","fr":"Articulations","en":"Joints","color":"#ff9500"},{"id":"os","fr":"Os","en":"Bones","color":"#a41e65"},{"id":"charnieres-vertebrales","fr":"Charnières vertébrales","en":"Vertebral junctions","color":"#ff0000"},{"id":"zone-colonne","fr":"Segments vertébraux","en":"Vertebral segments","color":"#e100ff"},{"id":"cadrans-du-crane","fr":"Os du crâne","en":"Cranial bones","color":"#1baa08"}],"regions":[{"code":"C","fr":"Cervicales","en":"Cervical","count":7},{"code":"T","fr":"Thoraciques","en":"Thoracic","count":18},{"code":"L","fr":"Lombaires","en":"Lumbar","count":6},{"code":"S","fr":"Sacrales","en":"Sacral","count":5},{"code":"Cd","fr":"Caudales","en":"Caudal","count":18}],"annotations":[{"id":"hind-fetlock","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Boulet postérieur (métatarso-phalangien)","en":"Hind fetlock","zone":"hind-fetlock","zoneFr":"Boulet postérieur (métatarso-phalangien)","region":null,"status":"to_confirm","g":["c",1523,1397,34]},{"id":"hock","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Jarret (tarso-crurale et intertarsiennes)","en":"Hock (tarsal joints)","zone":"hock","zoneFr":"Jarret (tarso-crurale et intertarsiennes)","region":null,"status":"to_confirm","g":["c",1542,1159,34]},{"id":"stifle","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Grasset (fémoro-tibiale et fémoro-patellaire)","en":"Stifle joint","zone":"stifle","zoneFr":"Grasset (fémoro-tibiale et fémoro-patellaire)","region":null,"status":"to_confirm","g":["c",1464,918,34]},{"id":"hip","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Hanche (coxo-fémorale)","en":"Hip joint","zone":"hip","zoneFr":"Hanche (coxo-fémorale)","region":null,"status":"to_confirm","g":["c",1585,612,34]},{"id":"sacroiliac","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Articulation sacro-iliaque","en":"Sacroiliac joint","zone":"sacroiliac","zoneFr":"Articulation sacro-iliaque","region":null,"status":"to_confirm","g":["c",1450,578,34]},{"id":"shoulder","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Épaule (scapulo-humérale)","en":"Shoulder joint","zone":"shoulder","zoneFr":"Épaule (scapulo-humérale)","region":null,"status":"inherited","g":["c",784,907,34]},{"id":"elbow","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Coude (huméro-radio-ulnaire)","en":"Elbow joint","zone":"elbow","zoneFr":"Coude (huméro-radio-ulnaire)","region":null,"status":"to_confirm","g":["c",743.0451049804688,1193,34]},{"id":"carpus","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Carpe (antébrachio-carpienne, médio-carpienne)","en":"Carpus (carpal joints)","zone":"carpus","zoneFr":"Carpe (antébrachio-carpienne, médio-carpienne)","region":null,"status":"to_confirm","g":["c",745,1252,34]},{"id":"fore-fetlock","view":"main","kind":"point","cat":"articulations","lat":"bilateral","fr":"Boulet antérieur (métacarpo-phalangien)","en":"Fore fetlock","zone":"fore-fetlock","zoneFr":"Boulet antérieur (métacarpo-phalangien)","region":null,"status":"to_confirm","g":["c",736,1379,34]},{"id":"fore-sesamoids","view":"main","kind":"point","cat":"os","lat":"bilateral","fr":"Sésamoïdes antérieurs (boulet)","en":"Forelimb sesamoids","zone":"fore-sesamoids","zoneFr":"Sésamoïdes antérieurs (boulet)","region":null,"status":"to_confirm","g":["c",784,1371,34]},{"id":"l6-s1","view":"main","kind":"point","cat":"charnieres-vertebrales","lat":"unpaired","fr":"Charnière L6-S1 (lombo-sacrée)","en":"L6-S1 junction (lumbosacral joint)","zone":"l6-s1","zoneFr":"Charnière L6-S1 (lombo-sacrée)","region":null,"status":"to_confirm","g":["c",1424,515,30]},{"id":"t18-l1","view":"main","kind":"point","cat":"charnieres-vertebrales","lat":"unpaired","fr":"Charnière T18-L1 (thoraco-lombaire)","en":"T18-L1 junction (thoracolumbar)","zone":"t18-l1","zoneFr":"Charnière T18-L1 (thoraco-lombaire)","region":null,"status":"to_confirm","g":["c",1118,528,30]},{"id":"c7-t1","view":"main","kind":"point","cat":"charnieres-vertebrales","lat":"unpaired","fr":"Charnière C7-T1 (cervico-thoracique)","en":"C7-T1 junction (cervicothoracic)","zone":"c7-t1","zoneFr":"Charnière C7-T1 (cervico-thoracique)","region":null,"status":"to_confirm","g":["c",865,528,30]},{"id":"caudal","view":"main","kind":"zone","cat":"zone-colonne","lat":"unpaired","fr":"Vertèbres caudales","en":"Caudal vertebrae","zone":"caudal","zoneFr":"Vertèbres caudales","region":"Cd","status":"inherited","g":["p",[[1655,545],[1662,513],[1742,565],[1780,618],[1763,628],[1724,590],[1682,569]]]},{"id":"sacral","view":"main","kind":"zone","cat":"zone-colonne","lat":"unpaired","fr":"Vertèbres sacrales","en":"Sacral vertebrae","zone":"sacral","zoneFr":"Vertèbres sacrales","region":"S","status":"inherited","g":["p",[[1438,461],[1418.5,556.2],[1510.8,539.5],[1595,538.2],[1641,552],[1641,510],[1606,485],[1515,468]]]},{"id":"lumbar","view":"main","kind":"zone","cat":"zone-colonne","lat":"unpaired","fr":"Vertèbres lombaires","en":"Lumbar vertebrae","zone":"lumbar","zoneFr":"Vertèbres lombaires","region":"L","status":"inherited","g":["p",[[1401.3,457.1],[1386,562],[1232,562],[1130,552],[1131.4,503.2],[1260,475],[1361,454.4]]]},{"id":"thoracic","view":"main","kind":"zone","cat":"zone-colonne","lat":"unpaired","fr":"Vertèbres thoraciques","en":"Thoracic vertebrae","zone":"thoracic","zoneFr":"Vertèbres thoraciques","region":"T","status":"inherited","g":["p",[[1109.9,497.7],[1103,558.9],[1010.3,558.9],[915,552],[873.9,530.7],[826.8,509.5],[841,422],[960,482],[1068,496]]]},{"id":"cervical","view":"main","kind":"zone","cat":"zone-colonne","lat":"unpaired","fr":"Vertèbres cervicales","en":"Cervical vertebrae","zone":"cervical","zoneFr":"Vertèbres cervicales","region":"C","status":"inherited","g":["p",[[468,276],[489,216],[558,248],[586,339],[607,401],[625,447],[649,510],[695.1,528.4],[728.9,520.1],[765.3,472.8],[816.8,453],[796.5,543.7],[730,600],[646,604],[593,565],[552,461],[524,370]]]},{"id":"head-trigger","view":"main","kind":"detail_trigger","cat":"articulations","lat":"unpaired","fr":null,"en":null,"zone":null,"zoneFr":null,"region":null,"status":"inherited","g":["p",[[454,332],[429,202],[408,150],[349,154],[300,188],[269,216],[234,279],[192,318],[164,384],[175,457],[234,468],[265,450],[328,419],[405,394],[443,408]]]},{"id":"parietal","view":"head","kind":"point","cat":"cadrans-du-crane","lat":"unpaired","fr":"Pariétal","en":"Parietal bone","zone":"parietal","zoneFr":"Pariétal","region":null,"status":"inherited","g":["c",348,161,27]},{"id":"frontal","view":"head","kind":"point","cat":"cadrans-du-crane","lat":"unpaired","fr":"Frontal","en":"Frontal bone","zone":"frontal","zoneFr":"Frontal","region":null,"status":"inherited","g":["c",277,214,27]},{"id":"sphenoid","view":"head","kind":"point","cat":"cadrans-du-crane","lat":"unpaired","fr":"Sphénoïde","en":"Sphenoid bone","zone":"sphenoid","zoneFr":"Sphénoïde","region":null,"status":"to_confirm","g":["c",352,300,27]},{"id":"temporal","view":"head","kind":"point","cat":"cadrans-du-crane","lat":"unpaired","fr":"Temporal","en":"Temporal bone","zone":"temporal","zoneFr":"Temporal","region":null,"status":"to_confirm","g":["c",366,214,27]},{"id":"occipital","view":"head","kind":"point","cat":"cadrans-du-crane","lat":"unpaired","fr":"Occipital","en":"Occipital bone","zone":"occipital","zoneFr":"Occipital","region":null,"status":"to_confirm","g":["c",441,190,27]},{"id":"atm","view":"head","kind":"point","cat":"articulations","lat":"unpaired","fr":"Articulation temporo-mandibulaire (ATM)","en":"Temporomandibular joint (TMJ)","zone":"atm","zoneFr":"Articulation temporo-mandibulaire (ATM)","region":null,"status":"to_confirm","g":["c",400,258,27]},{"id":"ssb","view":"head","kind":"point","cat":"articulations","lat":"unpaired","fr":"Synchondrose sphéno-occipitale (SSB)","en":"Spheno-occipital synchondrosis (SBS)","zone":"ssb","zoneFr":"Synchondrose sphéno-occipitale (SSB, sphéno-basilaire)","region":null,"status":"to_confirm","g":["c",437,300,27]},{"id":"hyoid","view":"head","kind":"point","cat":"os","lat":"unpaired","fr":"Appareil hyoïdien","en":"Hyoid apparatus","zone":"hyoid","zoneFr":"Appareil hyoïdien","region":null,"status":"to_confirm","g":["c",376,399,27]},{"id":"c0-c1","view":"head","kind":"point","cat":"charnieres-vertebrales","lat":"unpaired","fr":"Charnière C0-C1 (atlanto-occipitale)","en":"C0-C1 junction (atlanto-occipital joint)","zone":"c0-c1","zoneFr":"Charnière C0-C1 (atlanto-occipitale)","region":null,"status":"to_confirm","g":["c",482,332,27]}],"zones":[{"id":"parietal","fr":"Pariétal"},{"id":"frontal","fr":"Frontal"},{"id":"sphenoid","fr":"Sphénoïde"},{"id":"temporal","fr":"Temporal"},{"id":"occipital","fr":"Occipital"},{"id":"ssb","fr":"Synchondrose sphéno-occipitale (SSB, sphéno-basilaire)"},{"id":"atm","fr":"Articulation temporo-mandibulaire (ATM)"},{"id":"hyoid","fr":"Appareil hyoïdien"},{"id":"c0-c1","fr":"Charnière C0-C1 (atlanto-occipitale)"},{"id":"cervical","fr":"Vertèbres cervicales"},{"id":"c7-t1","fr":"Charnière C7-T1 (cervico-thoracique)"},{"id":"shoulder","fr":"Épaule (scapulo-humérale)"},{"id":"elbow","fr":"Coude (huméro-radio-ulnaire)"},{"id":"carpus","fr":"Carpe (antébrachio-carpienne, médio-carpienne)"},{"id":"fore-fetlock","fr":"Boulet antérieur (métacarpo-phalangien)"},{"id":"fore-sesamoids","fr":"Sésamoïdes antérieurs (boulet)"},{"id":"thoracic","fr":"Vertèbres thoraciques"},{"id":"t18-l1","fr":"Charnière T18-L1 (thoraco-lombaire)"},{"id":"lumbar","fr":"Vertèbres lombaires"},{"id":"l6-s1","fr":"Charnière L6-S1 (lombo-sacrée)"},{"id":"sacral","fr":"Vertèbres sacrales"},{"id":"sacroiliac","fr":"Articulation sacro-iliaque"},{"id":"hip","fr":"Hanche (coxo-fémorale)"},{"id":"stifle","fr":"Grasset (fémoro-tibiale et fémoro-patellaire)"},{"id":"hock","fr":"Jarret (tarso-crurale et intertarsiennes)"},{"id":"hind-fetlock","fr":"Boulet postérieur (métatarso-phalangien)"},{"id":"caudal","fr":"Vertèbres caudales"}],"sizes":{"main":{"30":3,"34":10},"head":{"27":9}}} diff --git a/docs/design/v1-2-6-u2/gen-data.cjs b/docs/design/v1-2-6-u2/gen-data.cjs new file mode 100644 index 00000000..ec014b85 --- /dev/null +++ b/docs/design/v1-2-6-u2/gen-data.cjs @@ -0,0 +1,45 @@ +// node gen-data.cjs: writes data.js (window.DOC) from the equine draft document, so every annotation, name, +// category, laterality, findings zone, vertebral region, review status and coordinate of the U2 boards comes from +// document.json and none is typed by hand. The point sizes of each view (the slider's snap marks) are counted +// from the same data. +const fs = require('fs') +const path = require('path') +const SRC = path.join(__dirname, '../../../supabase/seed/anatomical-sheets/equine/draft/document.json') +const doc = JSON.parse(fs.readFileSync(SRC, 'utf8')) + +const zoneName = Object.fromEntries(doc.finding_zones.map((z) => [z.id, z.name.fr])) +const regions = doc.vertebral_config.regions.map((r) => ({ code: r.code, fr: r.name.fr, en: r.name.en, count: r.count })) +const sizes = {} +for (const a of doc.annotations) { + if (a.geometry.type !== 'circle') continue + sizes[a.view_id] = sizes[a.view_id] || {} + sizes[a.view_id][a.geometry.r] = (sizes[a.view_id][a.geometry.r] || 0) + 1 +} +const out = { + name: doc.name, + views: doc.views.map((v) => ({ id: v.id, fr: v.name.fr, en: v.name.en, parent: v.parent_view_id || null, box: v.view_box || null })), + categories: doc.categories.map((c) => ({ id: c.id, fr: c.name.fr, en: c.name.en, color: c.color })), + regions, + annotations: doc.annotations.map((a) => ({ + id: a.id, + view: a.view_id, + kind: a.kind, + cat: a.category_id, + lat: a.laterality, + fr: a.name ? a.name.fr : null, + en: a.name ? a.name.en : null, + zone: a.finding_zone_id || null, + zoneFr: a.finding_zone_id ? zoneName[a.finding_zone_id] : null, + region: a.vertebral_region_code || null, + status: a.review_status || 'inherited', + g: a.geometry.type === 'circle' + ? ['c', a.geometry.cx, a.geometry.cy, a.geometry.r] + : ['p', a.geometry.points], + })), + zones: doc.finding_zones.map((z) => ({ id: z.id, fr: z.name.fr })), + sizes, +} +const body = 'window.DOC = ' + JSON.stringify(out) + '\n' +fs.writeFileSync(path.join(__dirname, 'data.js'), '// generated by gen-data.cjs from document.json\n' + body) +console.log('annotations', out.annotations.length, 'zones', out.zones.length, 'regions', regions.length, + 'sizes', JSON.stringify(sizes), 'bytes', body.length) diff --git a/docs/design/v1-2-6-u2/maquettes.html b/docs/design/v1-2-6-u2/maquettes.html new file mode 100644 index 00000000..1f2c83bf --- /dev/null +++ b/docs/design/v1-2-6-u2/maquettes.html @@ -0,0 +1,824 @@ + + +
+ +2. Ajouter un point : la taille se choisit dans le bandeau, un clic place le point, le dialogue « Nouveau point » s'ouvre seul, le point reste visible à côté
+3. Modifier un point : sélection sans dialogue, le point se glisse, sa taille se règle au curseur du bandeau ; les propriétés s'ouvrent d'un clic sur le point sélectionné
+4. Ajouter une zone : un clic par sommet, commandes du tracé dans le bandeau ; à la fermeture, le dialogue « Nouvelle zone » s'ouvre seul et la forme reste dessinée
+5. Zone sélectionnée : sommets, « + » au milieu de chaque segment, bulle « − » sur le sommet choisi ; à la souris, glisser l'intérieur déplace la zone
+6. Déplacer une zone (glisser direct à la souris, mode explicite au doigt et au clavier) et la redessiner (l'ancien contour reste jusqu'à la fermeture)
+13. Tablette 1 180 px (au doigt) : poignées agrandies, zones de contact de 44 px, bandeau en 44 px ; toucher la zone sélectionnée ouvre ses propriétés
+31. Dialogue des propriétés : lecture, modification transactionnelle, sortie avec saisie en cours, suppression, lecture seule
+32. Quand le dialogue s'ouvre, et quand il ne s'ouvre pas ; touche Échap ; clavier pour chaque geste ; retour du focus
+33. Refus et états : fermeture refusée, latéralité manquante, déplacement refusé, trop de sommets, lecture seule
+V1-2.6 · géométrie sur le dessin, propriétés dans un dialogue, création par placement ou tracé puis dialogue