chore(memory): BDR-107 trial arbitrations, R0-R4 and anomalies A-C tracking

This commit is contained in:
bchanot committed 2026-11-09 16:13:06 +01:00
1 parent 3d64146164
commit 95009069ca
4 files changed
+200

No files matched your search

+8
View File
@@ -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.
+1
View File
@@ -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
+11
View File
@@ -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 (`<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)
@@ -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/*