diff --git a/.claude/memory/decisions.md b/.claude/memory/decisions.md index bd6a29ae..994c7a28 100644 --- a/.claude/memory/decisions.md +++ b/.claude/memory/decisions.md @@ -878,3 +878,11 @@ Owner brief « V1-2.6 UX — Décisions au checkpoint U1 », 2026-11-09. Owner d Alternatives not taken: sandbox reset for a green verdict; paging folded into U1 or U2; U1 limits moved to U2. Status: in force. Completes BDR-105. + +## BDR-107 — V1-2.6 U1 trial arbitrations: References tab back, Défaire/Refaire, deselect, generic sheet list, trial stack, anomalies A-C (2026-11-09) +- **Status**: accepted +Owner brief « V1-2.6 UX — Arbitrages du premier essai propriétaire » 2026-11-09, after U1 trial diagnosis. +Decided: fifth main tab « Références » between Constats and Vérification; header Références button removed; contextual panel only from finding detail, filtered, « Tout afficher » → tab, ~34 rem, slide 150-200 ms, prefers-reduced-motion honoured; tiles collapsible, search + clear, sort doc order (default) / A-Z / citation count / type, sort never touches document, reorder only in doc order; <640 px Références in « Plus ». History « Défaire » / « Refaire » (T15 history part superseded, form « Abandonner » kept). « Désélectionner » near « Supprimer »; Escape deselects when no dialog/priority panel/menu/tracing consumes it; deselect = UI state, no doc change, no history; empty-canvas click left to U2. Sheet list: search + clear, sort last modification (default) or name, date visible, better admin home card; no section by UUID/name/slug/test convention, generic, no test filter. Dedicated persistent manual trial stack separate from sandbox (plan only). Test anomalies A fictitious fingerprints, B working copy never archived by sheets-admin.sandbox.ts, C silent card integrity failure: tracked apart from U1/U2. Lots R0 boards → R1 labels/deselect → R2 References tab → R3 list → R4 card warning (independent). SQL or Rust change → own checkpoint. +Supersedes: U1 AC1, AC3 (header opener), AC4 labels, AC12/AC13 panel target, AC17 panel tests; checkpoint choices 5, 10 (carried), 15; board 11 once R0 validated. Not contradicted: BDR-099 item 5 (catalogue phone card), U2b F5 (panel slot kept). +Rejected alternative (owner): UI section for historical sheets, test-data filter in product. +Docs: docs/development/V1-2-6_U1_CORRECTIONS.md, docs/development/TRIAL_STACK.md, docs/design/v1-2-6-r0/. Contract .claude/tasks/contracts/2026-11-09-v1-2-6-trial-arbitrations.md. Next: owner validates R0 boards + arbitrations A1-A15; no code before. diff --git a/.claude/memory/journal.md b/.claude/memory/journal.md index da06f8e7..1f6863c1 100644 --- a/.claude/memory/journal.md +++ b/.claude/memory/journal.md @@ -540,3 +540,4 @@ R5.4: `draft/{labels,changelog,review_report,drawing,overlay,app_review,svg_comp ## 2026-11-09 - V1-2.6 U1 implemented: lots A-I 9ec232a..da95b84, verifier 22/22, security PASS, final review fixes 0467885/da95b84 re-review clean. Shell at da95b84 188/90/4 (admin.spec:717 working-copy slot, sandbox state). Owner checkpoint decisions BDR-106: 5 files + 3 rewrites accepted, checkpoint open, RR-13 rights paging track. LRN-120-122. U2 not started. +- 2026-11-09 U1 trial arbitrations: R0 boards 23-30 + corrections plan + trial stack plan; design review APPROVE WITH FIXES applied, verifier ECARTS(1) fixed; awaiting owner validation diff --git a/.claude/tasks/TODO.md b/.claude/tasks/TODO.md index 4ad0f6de..659fd154 100644 --- a/.claude/tasks/TODO.md +++ b/.claude/tasks/TODO.md @@ -684,6 +684,17 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet - [ ] confirm the 4 `admin.spec.ts:717` failures at da95b84 (fr/en × desktop/375, « Créer une copie de travail » disabled: single working-copy slot taken by an earlier run, `WorkingCopyAction.tsx:88`) are sandbox-state dependent: non-destructive reproduction or isolated test; never a sandbox reset to get green (owner 2026-11-09). Linked: RR-13 admin scenario independence - [ ] U1 reservations kept in U1, not moved to U2 without justification (owner 2026-11-09; `V1-2-6_OWNER_TRIAL.md` « Limites connues de U1 », checkpoint §7.3): N4 in-place field loses a refused value · N6 upload in flight attaches in narrow mode · repair window drops refusal `result` and unparseable draft · local recovery copy in tab sessionStorage · references panel makes tab panels inert · canvas 538 px at 1 024/1 280 (choice 2.6) · `trial-lan.spec.ts` not run · LOW `usePress` (HistoryButtons.tsx) over 25 lines - [ ] 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 + - [ ] V1-2.6 U1 corrections after the owner's first trial (brief « V1-2.6 UX — Arbitrages du premier essai propriétaire », 2026-11-09, BDR-107; contract `.claude/tasks/contracts/2026-11-09-v1-2-6-trial-arbitrations.md`; plan `docs/development/V1-2-6_U1_CORRECTIONS.md`): design and docs only so far, no app/scripts/SQL/Rust code, no DEV, sandbox untouched, no merge, no U2/U2b/V1-2.7 + - [ ] R0 boards 23-30 `docs/design/v1-2-6-r0/` (References tab, contextual panel, Défaire/Refaire, Désélectionner + Escape, phone « Plus », sheet list, home card, catalogue integrity card): owner graphic validation pending + - [ ] R1 history « Défaire » / « Refaire » + « Désélectionner » + Escape priority (after R0 validation and its own go) + - [ ] R2 fifth tab « Références », tiles, search + clear, view-only sort, panel from a finding only (34 rem, 150-200 ms slide, reduced motion) (after R0 validation and its own go) + - [ ] R3 sheet list search, sort, date, home card; date source arbitration A7 (payload `anatomical_sheets.updated_at` misses draft saves: 28/219 on the sandbox; true date = SQL read change, own checkpoint) + - [ ] R4 catalogue card integrity warning (independent fix, = anomaly C): `useCardDetails.ts` drops a failed `loadVersion` silently; UI only, check never bypassed + - [ ] owner arbitrations A1-A15 (`V1-2-6_U1_CORRECTIONS.md` §6, `TRIAL_STACK.md` §6) + - [ ] 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. + - [ ] 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. + - [ ] Test anomaly C (owner 2026-11-09, separate from U1/U2): integrity failure invisible in catalogue cards; implemented as lot R4; failure shown, never hidden or bypassed. + - [ ] Dedicated persistent manual trial stack (owner 2026-11-09, D8): plan `docs/development/TRIAL_STACK.md` (prefix `faunosteo_trial_`, ports 58xxx + 5194, named volumes, own secrets 1-year keys, equine seed only + `pnpm assets:upload`, suite guard in `stack.ts`, memory caps); nothing created; needs arbitrations A11-A15 and its own go. - [ ] Rights screen lists every catalogue grant unbounded (list_catalog_grants, GrantList): 2 306 rows crash axe at 8 workers on a long-lived sandbox. Owner 2026-11-09 (BDR-106): own priority track RR-13, separate from U1 and U2, not implemented now. - [ ] 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/.claude/tasks/contracts/2026-11-09-v1-2-6-trial-arbitrations.md b/.claude/tasks/contracts/2026-11-09-v1-2-6-trial-arbitrations.md new file mode 100644 index 00000000..023cba6e --- /dev/null +++ b/.claude/tasks/contracts/2026-11-09-v1-2-6-trial-arbitrations.md @@ -0,0 +1,180 @@ +# CONTRACT — v1-2-6-trial-arbitrations +- date: 2026-11-09 | flow: design and documentation only (R0 mockups, plans, tracking) | branch: feature/v1-2-anatomical-sheets +- status: active +- worktree: /home/bchanot/Documents/faunosteo-v1-2 (every command from this absolute path; never DEV: the + `supabase_*_faunosteo` containers are DEV). The sandbox `faunosteo_dbsandbox_*` is read only (select queries), never + reset, cleaned or written; the owner's running trial (`faunosteo_dbsandbox_trial_gateway`) is left alone. +- base: 8cb681e. Commit in place, push; no merge, no `gitflow.sh finish`. +- untracked file kept: `faunosteo-v1-2-6-revue-ux-chatgpt.md`. + +## REQUEST (verbatim — IMMUTABLE) + +# FAUNOSTEO — V1-2.6 UX — Arbitrages du premier essai propriétaire + +Le propriétaire a examiné le diagnostic et prend les décisions suivantes. + +## 1. Références : nouvelle direction approuvée + +Rétablir un cinquième onglet principal « Références », placé entre Constats et Vérification. + +L'onglet devient le point d'accès principal à la bibliothèque de références. + +Le bouton Références de l'en-tête devient inutile et sera supprimé. + +Conserver un volet contextuel accessible depuis le détail d'un constat, filtré sur ses citations, avec une action « Tout afficher » menant à l'onglet principal. + +Le volet sera plus large, environ 34 rem sous réserve de l'espace disponible, avec une animation latérale discrète de 150 à 200 ms et prise en compte de prefers-reduced-motion. + +L'onglet principal présentera : +- Des tuiles repliables et dépliables. +- La citation abrégée, le type et le nombre de citations en état fermé. +- Les informations complètes, DOI, URL et actions en état ouvert. +- Une recherche instantanée avec bouton d'effacement. +- Un tri par ordre documentaire, A–Z, nombre de citations ou type. +- L'ordre documentaire comme tri par défaut. + +Le tri ne doit jamais modifier le document. Les commandes de réorganisation ne sont disponibles que lorsque l'ordre documentaire est affiché. + +Préserver les modifications non enregistrées, le focus, « Aller à », les permissions, le mode lecture seule et les tests d'accessibilité. + +Sous 640 px, intégrer Références au menu « Plus ». + +IMPORTANT : conformément aux règles du projet, produire les nouvelles maquettes et obtenir leur validation avant toute modification du code de l'interface. + +## 2. Historique + +Valider « Défaire » / « Refaire » à la place de « Annuler » / « Rétablir » pour l'historique. + +Conserver des noms accessibles explicites, les raccourcis clavier et la distinction avec les boutons Annuler des dialogues. + +## 3. Désélection + +Prévoir un bouton « Désélectionner » près de « Supprimer ». + +Échap désélectionne si aucun dialogue, volet prioritaire, menu ou tracé en cours ne consomme cette touche. + +La désélection est un état d'interface, sans modification du document ni entrée d'historique. + +Le clic sur une zone vide du dessin reste à définir dans U2. + +## 4. Liste des fiches + +Prévoir : +- Recherche instantanée et effacement. +- Tri par dernière modification (par défaut) ou nom. +- Date de dernière modification visible. +- Amélioration des cartes de l'accueil Administration. + +Ne pas coder une section dédiée aux fiches historiques sur la base d'UUID, noms, slugs ou conventions propres aux tests. + +La liste doit rester générique pour toutes les espèces. + +Ne pas ajouter de filtre de test artificiel au produit. + +## 5. Isolation des environnements + +Le propriétaire choisit une pile d'essai manuelle dédiée et persistante, séparée de la sandbox automatisée. + +Préparer un plan technique pour cette séparation : +- Conteneurs, réseau et ports distincts. +- Secrets, stockage et base de données distincts. +- Aucun accès accidentel des suites E2E à la pile manuelle. +- Commandes explicites pour démarrer et arrêter la pile. +- Procédure de création d'un compte d'essai. +- Méthode sûre de retrouver la fiche équine et ses illustrations. +- Isolation mémoire et ressources pour éviter toute perturbation de DEV. + +Ne pas créer, réinitialiser ou supprimer de pile pour le moment. + +Ne pas toucher aux données existantes. + +## 6. Anomalies de test à corriger séparément + +Créer des éléments de suivi dédiés pour : + +A. Empreintes fictives utilisées par certaines suites de test : remplacer la fabrication de fausses empreintes par le calcul réel du cœur, sans affaiblir les contrôles d'intégrité. + +B. Copie de travail créée par sheets-admin.sandbox.ts et jamais archivée : corriger l'indépendance et le nettoyage des tests, sans toucher à la copie existante avant autorisation. + +C. État d'échec du contrôle d'intégrité dans les cartes du catalogue : afficher un avertissement compréhensible dès la liste, sans masquer ni contourner l'échec. + +Conserver ces travaux distincts de la refonte graphique U1 et de U2. + +## 7. Plan de correction UX + +Préparer les lots suivants : +- R0 : nouvelles maquettes et validation propriétaire. +- R1 : libellés de l'historique et désélection. +- R2 : cinquième onglet Références et présentation des références. +- R3 : recherche, tri et présentation générique de la liste des fiches. +- R4 : signalement visuel des échecs d'intégrité dans le catalogue, en correctif indépendant. + +Prévoir les tests unitaires, E2E, d'accessibilité et de non-régression adaptés. + +Toute modification du schéma SQL ou du cœur Rust nécessite un checkpoint spécifique. + +## 8. Restrictions + +Cette intervention est limitée à la conception, à la documentation et aux propositions de plan. + +Aucun code d'application ou de scripts ne doit encore être modifié. + +Ne pas toucher à DEV. + +Ne pas réinitialiser ni nettoyer la sandbox. + +Ne supprimer, archiver ou modifier aucune fiche existante. + +Ne pas fusionner, déployer ni commencer U2, U2b ou V1-2.7. + +Préserver les fichiers non suivis. + +Soumettre les maquettes, les plans et les arbitrages éventuels au propriétaire, puis s'arrêter. + +## CLARIFICATIONS +- Fact found before the plan (2026-11-09, read-only): `save_sheet_draft` writes `anatomical_sheet_versions` only + (`supabase/migrations/20261028110000_sheet_review_workflow.sql:569-630`), while the admin list payload carries + `anatomical_sheets.updated_at` (`supabase/migrations/20261102100000_sheet_admin_reads.sql:54`). On the sandbox, 28 of + 219 official sheets have a version newer than the sheet row. A true « dernière modification » therefore needs a read + change in SQL (owner checkpoint, request §7) or a documented approximation: this is an arbitration for the owner, + never settled by the implementer. +- Open questions are listed for the owner in `docs/development/V1-2-6_U1_CORRECTIONS.md`, never answered by the + implementer. + +## ACCEPTANCE CRITERIA +1. R0 boards (request §1 to §4, §6 C): a new folder `docs/design/v1-2-6-r0/` 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 and `REVUE.md`. The boards draw: the editor with five tabs and no « Références » header button; the + Références tab (collapsed and expanded tiles, instant search with a clear button, the four sorts with document order + as default, reorder commands only in document order, empty result, read-only mode); the contextual panel opened + from a finding (filtered, « Tout afficher », about 34 rem, slide 150-200 ms and its reduced-motion variant); history + « Défaire » / « Refaire » next to a dialog « Annuler »; « Désélectionner » next to « Supprimer » and the Escape + priority; the phone « Plus » menu holding Références; the admin sheet list (search, clear, sort by last change or + name, visible date, generic for every species, no historical section, no test filter) on desktop and phone; the + Administration home card; the catalogue card in integrity failure. +2. Data truth: every reference, citation count, finding name and type on the boards comes from the equine draft + `supabase/seed/anatomical-sheets/equine/draft/document.json` through the generator; staging text (sheet list rows, + dates, user names, unsaved counts) is listed as such in `REVUE.md`. No board uses a test-data name (`Fiche e2e`, + `Cheval sandbox`, slugs `e2e-`, `sb-`, `wc-`, `perf-`). +3. Identity: the boards reuse the validated identity (tokens, shell, components, icons) of `docs/design/v1-2-6/` and + the U1 shell as built (`apps/app/src/components/editor/*`), with no new design system; each visible label that is + new is listed in `REVUE.md` with its FR and EN proposal. +4. Plan (request §7): `docs/development/V1-2-6_U1_CORRECTIONS.md` records the owner's decisions of this brief, which + earlier validated decisions they supersede (checkpoint §1 choices, contract AC, board 11, BDR-099 item 5, U2b F5) + and lots R0 to R4, each with files, unit, e2e, accessibility and non-regression tests, gates, and any SQL or Rust + need flagged as a specific checkpoint; the open arbitrations are listed with a recommendation each. +5. Trial stack (request §5): `docs/development/TRIAL_STACK.md` is a technical plan covering the seven points of the + request, grounded in `scripts/db-sandbox.sh` and the e2e support code with file:line references; it proposes the + command names as an arbitration; nothing is created, started or stopped. +6. Tracking (request §6): `.claude/tasks/TODO.md` holds three separate items A, B, C with their cause, files and + constraint (A no weaker integrity check, B no change to the existing copy before authorisation, C failure shown + never hidden), a trial-stack item, and the R0-R4 line; memory records the owner's decisions (BDR) through + `memory.sh`. +7. Restrictions (request §8): the branch diff from 8cb681e touches only `docs/`, `.claude/tasks/`, `.claude/memory/`; + no file under `apps/`, `packages/`, `crates/`, `supabase/`, `scripts/` changes; the sandbox holds the same official + sheet count (219) and the same working copy `8c315a12-20d4-4432-9db3-7cb88b27a5b4` before and after; the untracked + review file is still present. + +## FILE SCOPE +docs/design/v1-2-6-r0/**, docs/design/README.md, docs/development/V1-2-6_U1_CORRECTIONS.md, +docs/development/TRIAL_STACK.md, .claude/tasks/TODO.md, .claude/tasks/contracts/this file, .claude/memory/*