From da95b846e42e72c3da13f709c39032992e696444 Mon Sep 17 00:00:00 2001 From: bchanot Date: Mon, 9 Nov 2026 12:19:38 +0100 Subject: [PATCH] docs(app): final review wording and TODO shortcut Owner trial: references search wording (citation, DOI, URL), the N4 error message returns on widening. TODO: harvest the sheetDocument.ts parse-cache shortcut (limit and upgrade path). --- .claude/tasks/TODO.md | 1 + docs/development/V1-2-6_OWNER_TRIAL.md | 9 +++++---- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/.claude/tasks/TODO.md b/.claude/tasks/TODO.md index 38985279..06a15abd 100644 --- a/.claude/tasks/TODO.md +++ b/.claude/tasks/TODO.md @@ -681,6 +681,7 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet - [x] static audits (core model, rendering/PDF/N-1, geometry/wasm, SQL/worker, editor/tests) · [x] docs/development V1-2-6_UX_{PLAN,COMPATIBILITY,TESTS,RISKS,DECISIONS}.md (sub-steps U0-U9, decisions T1-T19) · [x] independent review (3 lenses: CONCERNS 5/9/6, no BLOCKER) + fixes integrated (plan §6) · [x] commit + push branch · [x] owner answers 2026-11-05 (brief « V1-2.6 UX — Ratification des décisions techniques », BDR-100): T11 approved, T16 conditional deferral (curves lot), T2/T3 conditional on proofs, T4 no residual gap, T5 history preserved, T9 three actions, T10 navigation type, T12 principle · [x] five docs updated (decisions, compatibility §0/§7/§8, tests, risks + blocking criteria, plan §7) · [x] LRN-118 (wasm measuring rule) · [x] independent reviews: correctness challenger CONCERNS(5 MAJOR, 7 MINOR) integrated; verifier ECARTS(2) fixed; targeted re-check ECARTS(2) (one U6 test assumed permissive save, deploy order said all rounds) fixed · [x] third independent check before commit (2026-11-05): ECARTS(2) on K10/K11 (R-3 mitigation, U6 objective on older T4 scope, write-lock test assumed stripping save, T16 count scope in two forms) fixed · [x] fresh targeted re-check: CONFORME 12/12 (G1-G4 closed; 7 observations kept for U0) · [x] commit + push · [x] owner answers 2026-11-05 (brief « Autorisation U0 uniquement », BDR-101): T4 both SQL checks approved (O22 amended), T5 defaults, T10 option B, T15, T16 count before activation, « Remplacer par un polygone » explicit · [x] T17 answered 2026-11-06 (BDR-102) · [ ] still open: T12 text (before U7), T6 (V1-2.8), T14 follow-up; T1 only if a measure exceeds · [x] owner authorisation to start U0 (2026-11-05) - [ ] V1-2.6 UX U0, contract and decisions, docs only (contract `.claude/tasks/contracts/2026-11-05-v1-2-6-ux-u0.md`; no code, no SQL, no DEV, no U1): [x] V1-2 contract §6.2, §6.4, §6.7, §7.4, §8.2-§8.4, §12.2 + §17.1 (O22), §16.7, §16.12, §17.12 · [x] level-1 contract C3, C4, C5, C6, C7, C8, C11, C13, C16, C18, C20, C25, C28, C32, C33, C40, with the precedence rule of its header · [x] docs/design/README.md · [x] rules sheet-model.md, schemas.md · [x] five UX docs · [x] BDR-101 · [x] preconditions (r5:import-equine --check clean, seed 22/6/0 paths, wasm 592 143 B) · [x] independent verification: ECARTS x6 fixed, then CONFORME 12/12 (2026-11-06); open points for U2/U6 not in docs: point edge-size handle (boards 02/03), default laterality of the automatic access (U6), §15 replay text vs the category.fixed.* filter · [x] commit + push · [x] owner U0 checkpoint (approved for good in the brief « Autorisation de U1 uniquement », 2026-11-06) - [ ] V1-2.6 UX U1, editor shell (brief « Autorisation de U1 uniquement » + « U1 — Validation de la conception interne », approach A; contract `.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md`; plan `.claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md`, lots A, B1, B2, C-I; no Rust/SQL/worker/scripts, no DEV, no merge, no U2): [x] design approach A validated by the owner with 10 precisions · [x] owner choices 2026-11-06 (server save time, non-modal references panel, citation button in the finding's detail, board 01 annotation card) · [x] plan written + three-lens challenge (correctness CONCERNS 6, robustness CONCERNS 5, simplicity CONCERNS 2, no BLOCKER) integrated · [x] U1 design confirmed by the owner 2026-11-06 (BDR-104; no data deletion implicit in the plan approval, sandbox included) · [x] authorisation checkpoint page `docs/development/V1-2-6_UX_U1_CHECKPOINT.md` (18 choices, amendments 2.1-2.9, audits traced, sandbox reset scope, lot criteria; challenger reports archived `.claude/audits/2026-11-06-v1-2-6-u1-plan-challenges.md`; contract `.claude/tasks/contracts/2026-11-06-v1-2-6-u1-authorisation-checkpoint.md`, fresh verifiers ECARTS(3) → ECARTS(1) → last gap fixed, not re-verified) · [x] owner U1 authorisation 2026-11-06 (brief « Ratification finale U1 et autorisation conditionnelle d'implémentation », BDR-105): 18 choices, approach A, AC3/4/5/7/17 and 2.6-2.9 applied to the contract; precautions 2.8 (no silent loss on 1 024 px crossing or recovery decision) and AC7 (save time rights); per-operation sandbox go · [ ] precautions investigated and written in the contract · [ ] targeted counter-check (3 confirmation fixes + 2 precautions), blocking gaps fixed and re-checked · [x] lots A-H (A 95b1b7e; B1 bc2dba7..ca184da; B2a 6689827..9d89dae; B2b c57af64..51fd3db; C 6131225..cf9c300; D ab51ea7; E 99b669b..89da8d3; F 580ff28..925d843; G 23900f3..9c03cf2; H 0bb150f..606f7ba) · [ ] Lot I open (docs and pre-reset gates in part 1; part 2 waits for the owner's sandbox go) · [ ] gates, verifier, security · [ ] owner U1 checkpoint + - [ ] shortcut: `apps/app/src/editor/sheetDocument.ts:15` keeps the last parsed document in one module-level entry (every kept place reads the document, one parse serves them all per commit), not store state. Limit: module state against the « no global state » rule, one entry. Upgrade path: the store holds the parsed document next to its text and the places select it - [ ] Rights screen lists every catalogue grant unbounded (list_catalog_grants, GrantList): 2 306 rows crash axe at 8 workers on a long-lived sandbox; needs SQL paging, outside U1 (no SQL); owner decision. Evidence: .superpowers investigation, admin.spec 9/9 crashes on 89da8d3, 580ff28, 606f7ba. - [ ] V1-2.6 UX complement « annotations ↔ constats » (owner brief 2026-11-06 « Nouvelle exigence UX : navigation bidirectionnelle »; contract `.claude/tasks/contracts/2026-11-06-v1-2-6-findings-nav-design.md`; design only, U1 plan untouched, no code, no DEV): [x] relations audit (one link `finding_zone_id`, no new association, equine draft 1:1) · [x] boards 17-22 `docs/design/v1-2-6-constats/` · [x] study `docs/development/V1-2-6_UX_FINDINGS_NAV.md` (no U1 integration point needed, sub-step U2b proposed, risks, tests, decisions F1-F21) · [x] fresh design review APPROVE WITH FIXES (3 MUST-FIX, 16 SHOULD), fixes applied · [x] fresh verifier ECARTS(4) → ECARTS(2) → CONFORME 9/9 (round 3; 567da67 came after it, not covered) · [x] owner principle validation 2026-11-06 (brief « Validation de principe U2b et préparation des checkpoints », BDR-103): U2b retained after U2 and before U3, F1/F2/F6/F8/F22 approved, F7 for the term « Famille », F3/F4 in part · [x] decisions F1-F22 table (alternatives, consequences, state), F2 groups vs leaves, F3 field list, F4 view semantics, boards with their decisions in study §7.4, U2b entry in `V1-2-6_UX_PLAN.md` §3, LRN-119 (``), contract `.claude/tasks/contracts/2026-11-06-v1-2-6-findings-nav-decisions.md` · [x] fresh verifier on that contract: ECARTS(9) → fixed → CONFORME 11/11 (6 observations outside criteria kept for the owner) · [x] owner 2026-11-06 (brief « U1 / U2b — Derniers arbitrages avant implémentation », BDR-104): F2 leaves, F3, F4 model A, F8, F22 decided; study §6-§7 updated · [x] owner: F5, F9-F21 approved as recommended, precisions F3, F8, F11-F14, F22 (brief « Ratification finale U1 … », 2026-11-06, BDR-105); study header, §6 tests, §7 table, 7.2, 7.3, UX PLAN U2b entry, REVUE, DECISIONS pointer updated; no implementation · [ ] U2b authorisation (after U2, before U3) - [ ] follow-up candidates (owner T14): multi-tab notice; RR item for the rollback limit of the category model (new id, reconcile with develop) diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md index d1eaf4bb..6b5d6726 100644 --- a/docs/development/V1-2-6_OWNER_TRIAL.md +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -243,9 +243,9 @@ vous avez créée dans l'interface. 2. Dans « Général », modifiez un nom sans enregistrer. Passez sur « Annotations » et cliquez « Annuler » à droite de la rangée d'onglets. Attendu : le nom d'origine revient dans « Général » ; « Rétablir » le remet. Un champ en cours de saisie est validé avant l'annulation, donc sa saisie est la dernière modification annulée. -3. Références : le bouton « Références » de l'en-tête ouvre un panneau latéral (non modal) avec un filtre par nom. - Dans « Constats », sélectionnez un constat qui cite une référence : le bouton « n référence(s) » ouvre le même - panneau limité à « Citées par « … » (n) », avec « Tout afficher (n) » pour revenir à la liste entière. +3. Références : le bouton « Références » de l'en-tête ouvre un panneau latéral (non modal) avec une recherche sur + la citation, le DOI et l'URL (« Rechercher une référence »). Dans « Constats », sélectionnez un constat qui cite + une référence : le bouton « n référence(s) » ouvre le même panneau limité à « Citées par « … » (n) », avec « Tout afficher (n) » pour revenir à la liste entière. « Fermer les références » ou Échap ferme le panneau et rend le focus au bouton qui l'a ouvert. 4. Dans « Annotations », la carte « Vues » propose « Gérer les vues », la carte « Catégories » « Modifier les catégories », et une entrée « Régions vertébrales (n régions) » est toujours là. Chacun ouvre sa section pleine largeur avec @@ -291,7 +291,8 @@ vous avez créée dans l'interface. quand la fenêtre s'élargit de nouveau. - Exception à la règle précédente : un champ qui passe sur place à sa valeur en lecture seule (hors des parties d'édition conservées) perd une saisie que l'enregistrement de la modification a refusée ; le message d'erreur - reste affiché. Un champ placé dans une partie conservée garde sa saisie. + disparaît avec le champ en lecture seule et revient si la fenêtre s'élargit de nouveau. Un champ placé dans une + partie conservée garde sa saisie. - Une illustration en cours d'envoi quand la fenêtre passe sous 1 024 px est quand même rattachée à sa vue : c'est une modification non enregistrée, comme au niveau 1. - La fenêtre de réparation des annotations garde les géométries saisies au passage sous 1 024 px, mais pas le