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).
This commit is contained in:
bchanot committed 2026-11-09 12:19:38 +01:00
1 parent 0467885527
commit da95b846e4
2 files changed
+6 -4

No files matched your search

+1
View File
@@ -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 (`<Activity>`), 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)
+5 -4
View File
@@ -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