diff --git a/.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md b/.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md new file mode 100644 index 00000000..76d5c729 --- /dev/null +++ b/.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md @@ -0,0 +1,95 @@ +# V1-2.6 new editor UX: feasibility audit (read-only, 2026-11-05) + +Brief « V1-2.6 : nouvelles maquettes UX approuvées sur le principe ». Read-only analysis of `crates/core` and the +V1-2.6 editor on `feature/v1-2-anatomical-sheets`; nothing built or run. Owner-facing summary in +`docs/design/v1-2-6/REVUE.md` § Faisabilité. Classes: SUPPORTED, UI-ONLY, CORE-OP MISSING, SCHEMA CHANGE. + +## 1. Annotation categories: SCHEMA CHANGE (fixed categories, opacity) +- No fixed category. Equine draft: articulations #ff9500, os #a41e65, charnieres-vertebrales #ff0000, zone-colonne + #e100ff, cadrans-du-crane #1baa08; only the legacy importer names them (curation/legacy/categories.rs:15-29). + New sheet: `categories: []` (domain/sheet/create.rs:27); drawing tools disabled until one exists + (EditableAnnotations.tsx:113,138). +- Schema `{id, name, color: #rrggbb | null}` (schema.rs:219-228); `is_hex_color` = 7 chars, no alpha (domain/js.rs:180-183). +- Delete refused with `has_dependents` only while used (edit.rs:570-577, 903-908); every row has Delete + (general/CategoriesSection.tsx:108-116). +- Opacity: constants only. Point twin 0.65 main / 0.5 detail (anatomy/layer.rs:94,242), zone 0.3 (layer.rs:299), + trigger 0.06 (layer.rs:308), PDF highlight 0.85 (compose.rs:42), CSS selected 0.85 (styles/index.css:14); + ANNOTATION-RENDERING.md:25-27. No stroke-opacity. +- Displayed colour: annotation.color, else category colour, else #888888 (layer.rs:13,147-155). +- A schema change touches: ts-rs types; frozen N-1 reader `.strict()` (packages/core-wasm/tests/n-1/.../schema.ts:66-72); + PDF snapshot embeds categories (archive/snapshot_rules.rs:160-162); fingerprint = JCS of the validated document + (fingerprint.rs:1-11, equine alias :43-48); review digests (review.rs:349-382); SQL pins (migrations + 20261010100000:12, 20261028110000:424); worker verdict strict read (verdict.rs:264-274); f64 breaks `Eq` on + AnnotationCategory (schema.rs:219); rendering change → ANNOTATION-RENDERING.md first, R3/R4 goldens owner decision. + +## 2. Category and vertebral region: no link (UI-ONLY filter, or new rule) +- Only rule: region code exists, `annotation.region.missing` (validate.rs:348-365); also `region.code.duplicate` + (validate.rs:391), `region.count_range.invalid` (validate.rs:502-526). Code grammar: 1-16 chars, alnum, `_`, `-`, + alnum first (domain/js.rs:169-177). +- Practitioner picker keyed on `vertebral_region_code`, never on the category (domain/editor/zone.rs:101-102, + 336-346; index.rs:145-164). Equine: only the 5 zone-colonne polygons carry a code. + +## 3. Points: SUPPORTED (move, numeric radius); radius drag UI-ONLY +- Drag translates cx, cy after 4 CSS px, rounded 0.01 (editor/annotations/gesture.ts:5,12-22); one `update` on + pointer-up (useMoveGesture.ts:98-105; annotationCommit.ts:93-104). +- Checks after commit (issues.ts:123-175): `out_of_frame` (frame.rs:113-119,167-174), `too_small` when + 2·max(2, r−12)·scale < 4 CSS px (layer.rs:260-262; frame.rs:63-67,160-165,219-221); no interior check on circles. +- r > 0 only (schema.rs:335-336). « 12 + 3 % » is a page default (editor/annotations/frame.ts:55-59). + +## 4. Polygons: SUPPORTED as `update` of the points array; vertex drag / segment insert UI-ONLY +- Add vertex inserts the midpoint after the selected row (geometryEdit.ts:91-111); remove disabled at 3 + (GeometryGroup.tsx:320); schema refuses < 3 (schema.rs:365-372). Overlay vertices `pointer-events-none` + (AnnotationOverlay.tsx:48-66,125). +- Checks: out_of_frame, too_small, `interior_too_small` (frame.rs:206-254; interior.rs:33-43). Self-intersection + allowed, nonzero fill decides (interior.rs:283). +- Undo: one entry per accepted commit, 8 MiB (undo.ts:7,52-74; editorEdit.ts:45-61); Ctrl+Z / Ctrl+Shift+Z + (useUndoShortcuts.ts:8-24). Preview on move, core on pointer-up (useMoveGesture.ts:90-105); < 61 ms on equine. + +## 5. Paths: CORE-OP MISSING (point editing and translation) +- Core reads `d` to measure only (anatomy/path.rs:51-133): private Cursor/Pen, no segment model, no writer. + App: paths neither editable nor draggable (geometryEdit.ts:31-35; gesture.ts:32); C45 never reshaped + (repair.ts:55-70,95-100). No seed contains a path. +- Existing proposal, not built: `.claude/tasks/plans/2026-11-04-v1-2-6-path-repair-core-proposal.md` + (`sheet.path_points`, `sheet.path_move_points`, wasm 583 126 / 600 000 B gzip). +- Lossless handle editing also needs: number byte spans, relative-command compensation, H/V, implicit S/T controls, + arcs (endpoint only). Reusable: path.rs number grammar (private), `json::js_number` (json.rs:18), + `svg/number.rs:122`. + +## 6. Detail views: crop SUPPORTED; derived asset not needed; remap on replacement MISSING +- `compose_canvas` clones the whole sanitised asset, root becomes `` keeping defs and transforms, only the root + viewBox is the frame (compose.rs:94-160); reader strips only root class/style/transform/filter/mask/clip-path + (svg/sanitize.rs:243-249). +- Coordinates in the user space of the drawing shown (own asset, else up the parent chain) (compose.rs:74-90; + frame.rs:6-11). +- Replacement: clean_svg (crates/wasm/src/lib.rs:160) → upload → `addDrawing` (editorEdit.ts:85-104) → view + `update` of `svg_asset_id` (drawingUpload.ts:185); numbers kept, read in the new space. View box or drawing change: + geometry untouched, annotations → `to_confirm` (edit.rs:792-857); page refuses new geometry errors + (issues.ts:141-160); repair dialog only for previously unmeasured views (repair.ts:132-151, C33). + +## 7. Name suggestion from a rectangle: CORE-OP MISSING +- No rectangle query or hit-test; clicks resolve through DOM `data-anno-id` (ops.rs:297,311-319; + useCanvasGestures.ts:57-64). Internal blocks: `frame::geometry_bounds`, `placement` (frame.rs:167-204), index + `name()` (index.rs:166-179). Sketch: `sheet.annotations_in_rect` {document, view_id, rect} → + [{id, name, category_id, inside|partial}]. + +## 8. Touch +- One pointer pans, two pinch, zoom 1-6, wheel, keyboard (catalogue/useFraming.ts:46-148; framing.ts:20); + `touch-action: none` while a tool or drag is active (useCanvasGestures.ts:76-84). +- No touch-sized handles (AnnotationOverlay.tsx:116). Move gesture has no pointerId check (useMoveGesture.ts:82-105). +- LRN-108 Chromium tap tolerance, observation only. `MIN_EDIT_WIDTH` 1024 (editor/mode.ts:21; useViewport.ts:9-13). + +## 9-10. References, Général +- Only finding categories and nodes cite references (schema.rs:551,579); PDF snapshot drops them + (snapshot_rules.rs:115,133,159). +- Général: Fiche (name, description, scope disclaimer FR/EN), Attribution, Catégories (GeneralTab.tsx:22-24). + No template text anywhere; contract §7.4 « No template of scientific content is shipped »; publication needs a + non-blank disclaimer FR and EN, `publish.disclaimer.missing` (migration 20261028110000:206-214). + +## 11. Reusable states +Modes edit, narrow, rights, frozen, historical, inactive (mode.ts:12-18; ModeNotice.tsx); DraftHeader statuses; +RecoveryNotice; CopyIssueNotice; ConflictDialog; BlockKind refusals (editorTypes.ts:13-23); frame refusal and repair +dialog (i18n/fr.ts:1420-1434); canvas failure (AnnotationCanvas.tsx:164-188); delete dialog. + +## Constraints in force +BDR-043 (rules in Rust, no TS path parser), BDR-086, BDR-091, BDR-092, BDR-068, BDR-019, LRN-103, LRN-108; contract +§8.3 level-2 deferrals and §8.4 O14 A; `crates/**` outside V1-2.6 scope without owner approval. diff --git a/.claude/memory/journal.md b/.claude/memory/journal.md index 482f37f7..703db379 100644 --- a/.claude/memory/journal.md +++ b/.claude/memory/journal.md @@ -524,3 +524,6 @@ R5.4: `draft/{labels,changelog,review_report,drawing,overlay,app_review,svg_comp - V1-2.6 lots A-M done on feature/v1-2-anatomical-sheets, HEAD 7a4ce9e. Fresh sandbox contract order green (1992 / e2e 148+46 skip / sandbox 105), check:all green, security PASS, verifier 33/34 then order fixed. Stop at owner checkpoint; R12 state files, m3, sign-out copy, labels pending owner. - V1-2.6 owner checkpoint decisions applied (lot N: C35-C44), code 5e0aa62. Fresh sandbox contract order green (1992 / e2e 150+48 skip / sandbox 105), check:all green, security PASS, fresh verifiers: all criteria met except checkpoint-report parts. Guide run from durable worktree. Stop: ready for owner trial. - V1-2.6 lot O: free paths never reshaped (core proposal written, not built), explicit category zone, owner trial on LAN 192.168.1.100:5193 behind a Host filter (no CORS, no ws, upgrades closed). Fresh verifier final pass CONFORME 0 NOT MET. Stop: ready for owner trial. + +## 2026-11-05 +- V1-2.6 new editor UX maquettes: 16 boards docs/design/v1-2-6 (desktop, tablet, phone), REVUE.md, core feasibility audit. Missing core: annotations_in_rect, path point edit/translate, remap on drawing swap; schema change for fixed categories + opacity. Reopens §8.3, O14 A, §8.2, §7.4. Design review + verifier gaps fixed. No code, no DEV. Stop at graphic checkpoint. diff --git a/.claude/tasks/TODO.md b/.claude/tasks/TODO.md index 3bb4093b..8af151f8 100644 --- a/.claude/tasks/TODO.md +++ b/.claude/tasks/TODO.md @@ -673,6 +673,9 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet - [x] L4 gates: check:all green (dcb1a94; delta = sandbox test + docs), fresh stack test-db 1965, e2e:shell 110 + 8 skipped, sandbox test 103 + 10 skipped after e2e, upgrade from M6 1965 + types match; security PASS x2; verifier ECARTS(6) -> CONFORME; two state-dependent sandbox tests fixed (0499a39, f5456f3); suites need a fresh stack in order test-db, e2e:shell, test - [ ] V1-2.6 editor level 1: plan APPROVED by the owner 2026-11-03 (brief « GO propriétaire V1-2.6 »: 13 lots A-M, C1-C24, 8 visible choices, M8 sandbox only, no JSON export button, recovery messages exact), gated on a targeted independent re-check of the six FATAL fixes. Re-check 2026-11-03: REMAINING(2) — fixes 1-5 closed, I1-I5 hold; fix 6 (r = 12 + 3 %) opens `out_of_frame` on frames under ~25.5 units (hitbox r in frame bounds); I6 broken: the first commit overwrites a pending recovery copy before « Restaurer » / « Ignorer »; 2 MINOR (N source when the admin read fails, two-copy cap). Executor NOT launched; STOP for the owner. Owner arbitrations 2026-11-03 (« arbitrages propriétaire sur REMAINING(2) »): C25-C31 gated, plan revised; second targeted re-check: REMAINING(1), no BLOCKER, F1 MAJOR (accept trusted the core's silence on unmeasured views) + 7 MINOR, all integrated in the plan. Owner GO 2026-11-04 (« GO propriétaire après REMAINING(1) »): F1 fix approved, C26 refined by seven repair rules, minor effects approved; C32-C34 gated; execution of lots A-M authorised, no third plan review. 2026-11-04 13:08 the scratchpad worktree was removed by the harness cleanup (LRN-114): commits safe on origin (8343528), uncommitted lot H + lot G fix lost; worktree recreated at /home/bchanot/Documents/faunosteo-v1-2 (owner authorisation); resume ledger `.claude/tasks/plans/2026-11-03-v1-2-6-execution.md`. Contract `.claude/tasks/contracts/2026-11-03-v1-2-6-editor-1509.md`, plan `.claude/tasks/plans/2026-11-03-v1-2-6-editor.md`; sandbox only, no DEV, no worker on DEV, no merge, no V1-2.7; STOP at the V1-2.6 owner checkpoint (trial procedure) - [x] A M8 draft_last_save (2f824a9) · [x] B sheet asset accessors (f7e7bf4) · [x] C preview mutators, edit ops, ids (173be59..cfd49c7) · [x] D editor store, undo, recovery (7f1d440..b14509f) · [x] E route, modes, tabs (6aba971) · [x] F Général, Références, Vertèbres (d163b2c) · [x] G views + upload (8343528, 1bbf97e, 7ea9619) · [x] H Annotations (2609785, 3f15762) · [x] I Constats (92c595c, 91d06c9) · [x] J Vérification + submit (447d0a4..3d589e1) · [x] K e2e (5097fd7..4cc27a8) · [x] L owner trial tooling (ac5fbfb) · [x] M gates, reviews, checkpoint (071b58a..7a4ce9e; checkpoint report 2026-11-04, owner trial pending) · [x] N owner checkpoint decisions (C35-C44: be4f468..5e0aa62; ready for the owner trial, guide verified from the worktree) · [x] O last decisions (C45-C48: free paths never reshaped, explicit category zone, LAN trial on 192.168.1.100:5193; a69eba5..9b86f54) · [ ] owner manual trial + - [ ] V1-2.6 new editor UX maquettes (owner brief 2026-11-05 « nouvelles maquettes UX approuvées sur le principe »; contract `.claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md`): mockups + feasibility audit only, no core/app code, no DEV, no merge, no V1-2.7; STOP at the graphic checkpoint + - [x] core feasibility audit (`.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md`) · [x] 16 boards + contact sheet + sources in `docs/design/v1-2-6/` · [x] REVUE.md (journey, 11 choices, contradictions, feasibility) · [x] fresh design review (6 MUST-FIX, 10 SHOULD applied; board 08 name finding wrong: frame holds Coude) + verifier ECARTS(2) U2/U9 fixed after (custom category menu, phone redraw), no re-verify · [x] commit + push branch · [ ] owner graphic checkpoint + - [ ] separate tracks kept apart: TOTP asked at sign-in; missing illustrations blocking the copy of the historical equine sheet - [ ] MANDATORY before merging V1-2 into develop (owner 2026-11-03): registry id reconciliation. LRN-095 collides: develop 09655b2 « Port a safe runner verbatim… » (2026-11-02) vs V1-2 « pgTAP across PGlite and the real Supabase image… » (2026-10-28, cited by BDR-084 and the V1-2.1 TODO lines). BLK-013 exists on develop only (« e2e:avatar on develop reached DEV »): `memory.sh` on V1-2 would hand out BLK-013 again, so a V1-2 blocker needs its id checked against develop first. Same for the TODO release-readiness ids: RR-11 is develop's (« sandbox-only e2e follow-ups »), V1-2 uses RR-12. No renumbering during V1-2.6 unless needed; renumber one side and patch its citers at the merge - [ ] V1-2.5 catalogue, admin space, rights, species, MFA · V1-2.6 editor level 1 · V1-2.7 preview, review, publication UI · V1-2.8 equine working copy and review preparation · V1-2.9 FR/EN acceptance and closure (owner checkpoints V1-2.3, V1-2.4, V1-2.6, V1-2.7, V1-2.8, V1-2.9 + each DEV operation of contract §16.11) diff --git a/.claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md b/.claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md new file mode 100644 index 00000000..9eb34c91 --- /dev/null +++ b/.claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md @@ -0,0 +1,34 @@ +# Contract: V1-2.6 new editor UX maquettes (owner brief of 2026-11-05) + +Brief « V1-2.6 : nouvelles maquettes UX approuvées sur le principe ». Deliverable: mockups and a feasibility +audit only. No change to `crates/`, `apps/`, `packages/`, `supabase/` (except reading), no DEV, no merge, +no V1-2.7. TOTP-at-login and the missing equine illustrations stay separate tracks. STOP at the graphic +checkpoint before any implementation. + +## Criteria + +- U1 Navigation: four tabs Général, Annotations, Constats, Vérification; views, drawings and vertebral + settings inside Annotations; references reachable from a secondary surface. +- U2 Categories: Os, Articulations, Vertèbres always present and not deletable, colour and opacity editable; + custom categories added, edited, deleted in a folding panel of Annotations; « Ajouter une catégorie » during + point or zone creation opens that panel; palette + opacity with synchronised values; annotations inherit + their category's look. +- U3 Direct editing: Point and Zone tools; points and zones moved on the drawing; radius by slider; no + coordinate shown in the normal UI. +- U4 Polygons: vertices on selection, vertex drag, + at segment midpoints, − bubble on a clicked vertex, + whole-zone move in an explicit mode, redraw tool, undo/redo for all of it; curves keep their control + points (no destructive simplification). +- U5 Touch: equivalent finger interactions on tablet and phone, handles sized for touch. +- U6 Detail views: tool, rectangle on the drawing, FR/EN name proposed, derived view framed, annotatable; + no `viewBox` numbers shown; replacement by a specific SVG; vector quality preserved. +- U7 Vertebrae: no standalone tab; « Configurer les régions vertébrales » from the Vertèbres category; + regions, codes, counts, ranges and rules kept. +- U8 Général simplified; controlled prefill of « Périmètre et limites » from a common text that never + erases sheet-specific legal or anatomical text. +- U9 Boards desktop and mobile for: main editor; point create + modify; zone create; polygon selection with + +/−; zone move and redraw; categories and colours; detail view by selection; vertebral regions; error, + read-only and save states. +- U10 Identity kept (tokens, Step 7 shell, V1-2.4 components); contact sheet, individual PNGs and sources in + `docs/design/v1-2-6/`, easy to open. +- U11 Feasibility audit against the current Rust core: missing operations named (vertex editing, path + editing, derived views, categories model), contradictions with ratified decisions listed for the owner. diff --git a/docs/design/README.md b/docs/design/README.md index ce6f5b95..f27d9597 100644 --- a/docs/design/README.md +++ b/docs/design/README.md @@ -105,3 +105,17 @@ Accepted deviations (owner 2026-11-02, V1-2.5): the boards stay as approved, not Condition: it stays identifiable and accessible (a live region in the panel names the picked zone). 2. On a phone, « Références » is a plain, non-collapsible card (`03`). Condition: it does not hide the anatomical area (it starts at or below the drawing's bottom, checked at 320 and 375 px). + +## v1-2-6/ — V1-2.6 graphic editor maquettes (proposal, not validated) + +Produced 2026-11-05 on the owner's brief « V1-2.6 : nouvelles maquettes UX approuvées sur le principe » +(contract `.claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md`). A proposal until the owner validates it: +boards `04` and `05` of v1-2-4 stay the editor reference meanwhile. Sixteen boards, desktop, tablet and phone: +four tabs (Général, Annotations, Constats, Vérification), references in a side panel, point and zone tools with +direct manipulation (vertex handles, « + » on segments, « − » bubble, move and redraw modes, undo/redo), fixed +categories Os / Articulations / Vertèbres with colour and opacity, detail view drawn as a rectangle, vertebral +regions from the Vertèbres category, editor states, touch variants. Same identity and components as v1-2-4; the +drawing and every geometry come from the equine draft. Source `maquettes.html` and `planche-contact.html`, +rendered by `render.cjs`; `REVUE.md` holds the journey, the choices to arbitrate, the contradictions with +ratified decisions (§8.3 level 2, §8.4 O14 A, §8.2 numeric fields, §7.4 templates, BDR-096) and the feasibility +against the Rust core (detail: `.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md`). diff --git a/docs/design/v1-2-6/01-editeur-annotations-desktop.png b/docs/design/v1-2-6/01-editeur-annotations-desktop.png new file mode 100644 index 00000000..d5c6f470 Binary files /dev/null and b/docs/design/v1-2-6/01-editeur-annotations-desktop.png differ diff --git a/docs/design/v1-2-6/02-point-creation-desktop.png b/docs/design/v1-2-6/02-point-creation-desktop.png new file mode 100644 index 00000000..7800b2d3 Binary files /dev/null and b/docs/design/v1-2-6/02-point-creation-desktop.png differ diff --git a/docs/design/v1-2-6/03-point-modification-desktop.png b/docs/design/v1-2-6/03-point-modification-desktop.png new file mode 100644 index 00000000..3b4af3a0 Binary files /dev/null and b/docs/design/v1-2-6/03-point-modification-desktop.png differ diff --git a/docs/design/v1-2-6/04-zone-creation-desktop.png b/docs/design/v1-2-6/04-zone-creation-desktop.png new file mode 100644 index 00000000..ea82f84c Binary files /dev/null and b/docs/design/v1-2-6/04-zone-creation-desktop.png differ diff --git a/docs/design/v1-2-6/05-zone-poignees-desktop.png b/docs/design/v1-2-6/05-zone-poignees-desktop.png new file mode 100644 index 00000000..cc6b1e7d Binary files /dev/null and b/docs/design/v1-2-6/05-zone-poignees-desktop.png differ diff --git a/docs/design/v1-2-6/06-zone-deplacer-redessiner-desktop.png b/docs/design/v1-2-6/06-zone-deplacer-redessiner-desktop.png new file mode 100644 index 00000000..d6e68d0e Binary files /dev/null and b/docs/design/v1-2-6/06-zone-deplacer-redessiner-desktop.png differ diff --git a/docs/design/v1-2-6/07-categories-couleurs-desktop.png b/docs/design/v1-2-6/07-categories-couleurs-desktop.png new file mode 100644 index 00000000..60d90109 Binary files /dev/null and b/docs/design/v1-2-6/07-categories-couleurs-desktop.png differ diff --git a/docs/design/v1-2-6/08-vue-detaillee-creation-desktop.png b/docs/design/v1-2-6/08-vue-detaillee-creation-desktop.png new file mode 100644 index 00000000..65eee248 Binary files /dev/null and b/docs/design/v1-2-6/08-vue-detaillee-creation-desktop.png differ diff --git a/docs/design/v1-2-6/09-regions-vertebrales-desktop.png b/docs/design/v1-2-6/09-regions-vertebrales-desktop.png new file mode 100644 index 00000000..c737bf3e Binary files /dev/null and b/docs/design/v1-2-6/09-regions-vertebrales-desktop.png differ diff --git a/docs/design/v1-2-6/10-general-desktop.png b/docs/design/v1-2-6/10-general-desktop.png new file mode 100644 index 00000000..56f7be9d Binary files /dev/null and b/docs/design/v1-2-6/10-general-desktop.png differ diff --git a/docs/design/v1-2-6/11-constats-references-desktop.png b/docs/design/v1-2-6/11-constats-references-desktop.png new file mode 100644 index 00000000..ddfd5233 Binary files /dev/null and b/docs/design/v1-2-6/11-constats-references-desktop.png differ diff --git a/docs/design/v1-2-6/12-etats-desktop.png b/docs/design/v1-2-6/12-etats-desktop.png new file mode 100644 index 00000000..a988c400 Binary files /dev/null and b/docs/design/v1-2-6/12-etats-desktop.png differ diff --git a/docs/design/v1-2-6/13-tablette-tactile.png b/docs/design/v1-2-6/13-tablette-tactile.png new file mode 100644 index 00000000..0b3a2b36 Binary files /dev/null and b/docs/design/v1-2-6/13-tablette-tactile.png differ diff --git a/docs/design/v1-2-6/14-telephone-edition.png b/docs/design/v1-2-6/14-telephone-edition.png new file mode 100644 index 00000000..ea0d11f9 Binary files /dev/null and b/docs/design/v1-2-6/14-telephone-edition.png differ diff --git a/docs/design/v1-2-6/15-telephone-categories-etats.png b/docs/design/v1-2-6/15-telephone-categories-etats.png new file mode 100644 index 00000000..328286ce Binary files /dev/null and b/docs/design/v1-2-6/15-telephone-categories-etats.png differ diff --git a/docs/design/v1-2-6/16-telephone-trace-etats.png b/docs/design/v1-2-6/16-telephone-trace-etats.png new file mode 100644 index 00000000..5e688e39 Binary files /dev/null and b/docs/design/v1-2-6/16-telephone-trace-etats.png differ diff --git a/docs/design/v1-2-6/REVUE.md b/docs/design/v1-2-6/REVUE.md new file mode 100644 index 00000000..e7a1f247 --- /dev/null +++ b/docs/design/v1-2-6/REVUE.md @@ -0,0 +1,101 @@ +# 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**. 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 | + +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. 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. Aucun n'est tranché sans le propriétaire. + +1. **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. +2. **Annuler / Rétablir en bouton flottant** sur le dessin, en bas à gauche au bureau et sur tablette, en haut à droite au téléphone, plus un message « … déplacé · Annuler » après chaque geste (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. +3. **Taille du point sans valeur chiffrée** : curseur de « Petit » à « Grand », avec un trait rouge au minimum touchable. +4. **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. +5. **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 ». +6. **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. +7. **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. +8. **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. +9. **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. +10. **Tablette** : la barre latérale de l'application se replie derrière le menu pour laisser la place au dessin. +11. **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. diff --git a/docs/design/v1-2-6/maquettes.html b/docs/design/v1-2-6/maquettes.html new file mode 100644 index 00000000..493635da --- /dev/null +++ b/docs/design/v1-2-6/maquettes.html @@ -0,0 +1,769 @@ + + + + +Faunosteo V1-2.6 éditeur graphique (proposition) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

1. Éditeur, onglet Annotations, dessin principal (desktop 1 280 px) · quatre onglets, Références en accès secondaire

+
+ + + +
+

2. Ajouter un point : outil Point, clic sur le dessin, propriétés et rayon au curseur ; « Ajouter une catégorie » ouvre le volet Catégories

+
+ + + +
+

3. Modifier un point : glisser sur le dessin, taille au curseur, propriétés ; Annuler / Rétablir sur le dessin

+
+ + + +
+

4. Ajouter une zone : outil Zone, un clic par sommet, fermeture sur le premier sommet ou « Terminer »

+
+ + + +
+

5. Zone sélectionnée : sommets visibles, « + » au milieu des segments, bulle « − » sur le sommet cliqué ; courbes conservées avec leurs points de contrôle

+
+ + + +
+

6. Déplacer une zone entière (mode explicite) et redessiner une zone (propriétés et liens conservés)

+
+ + + +
+

7. Catégories et couleurs : volet dépliable de l'onglet Annotations ; Os, Articulations, Vertèbres fixes ; palette, opacité synchronisée, aperçu

+
+ + + +
+

8. Créer une vue détaillée : tracer un rectangle sur le dessin, nom FR/EN proposé, cadrage dérivé du même SVG, accès ajouté sur la vue principale

+
+ + + +
+

9. Configurer les régions vertébrales : depuis la catégorie Vertèbres, plus d'onglet autonome ; régions, codes, nombres, plages et règles du modèle

+
+ + + +
+

10. Onglet Général simplifié : identité de la fiche, périmètre et limites à partir d'un texte commun, attribution ; réglages techniques repliés

+
+ + + +
+

11. Références en accès secondaire : volet latéral ouvert depuis l'en-tête ou depuis un constat qui les cite (ici sur l'onglet Constats)

+
+ + + +
+

12. États : enregistrement, refus d'une modification sur le dessin, lecture seule, récupération locale

+
+ + + +
+

13. Tablette 1 180 px (au doigt) : poignées agrandies, zones de contact de 44 px, mêmes outils ; deux doigts pour zoomer et déplacer le dessin

+
+ + + +
+

14. Téléphone 375 px, proposition d'édition au doigt (demande de revenir sur O14 A) : zone et poignées, point et taille, vue détaillée, état réduit

+
+ + + +
+

15. Téléphone 375 px : catégories et couleur, régions vertébrales, lecture seule selon la règle actuelle (O14 A)

+
+ + + +
+

16. Téléphone 375 px (même proposition) : tracer une zone, modifier un point, déplacer une zone, refus et enregistrement, redessiner une zone

+
+ + + diff --git a/docs/design/v1-2-6/planche-contact.html b/docs/design/v1-2-6/planche-contact.html new file mode 100644 index 00000000..7d46fe1a --- /dev/null +++ b/docs/design/v1-2-6/planche-contact.html @@ -0,0 +1,64 @@ + + + + +Faunosteo V1-2.6 éditeur graphique, planche-contact + + + + +
+
+
Faunosteo +

Éditeur graphique des fiches anatomiques

+

V1-2.6 · nouvelle direction UX, maquettes fonctionnelles desktop, tablette et téléphone

+
Proposition, non validée
Brief du 05/11/2026 · branche feature/v1-2-anatomical-sheets
Sources : maquettes.html, rendu par render.cjs
+
+
+
+ + + diff --git a/docs/design/v1-2-6/planche-contact.png b/docs/design/v1-2-6/planche-contact.png new file mode 100644 index 00000000..75d19adc Binary files /dev/null and b/docs/design/v1-2-6/planche-contact.png differ diff --git a/docs/design/v1-2-6/render.cjs b/docs/design/v1-2-6/render.cjs new file mode 100644 index 00000000..908d3617 --- /dev/null +++ b/docs/design/v1-2-6/render.cjs @@ -0,0 +1,19 @@ +// node render.cjs : one PNG per [data-board] element, plus the full page (all.png). +// PW_MODULE = the absolute path of apps/app/node_modules/@playwright/test (the pinned Chromium). +const path = require('path') +const { chromium } = require(process.env.PW_MODULE) +;(async () => { + const [html, out] = process.argv.slice(2) + const browser = await chromium.launch() + const page = await browser.newPage({ viewport: { width: 1400, height: 900 }, deviceScaleFactor: 1 }) + await page.goto('file://' + path.resolve(html)) + await page.waitForLoadState('networkidle') + const boards = await page.$$('[data-board]') + for (const b of boards) { + const name = await b.getAttribute('data-board') + await b.screenshot({ path: path.join(out, name + '.png') }) + } + await page.screenshot({ path: path.join(out, 'all.png'), fullPage: true }) + await browser.close() + console.log('boards', boards.length) +})()