chore(memory): BDR-107 trial arbitrations, R0-R4 and anomalies A-C tracking
This commit is contained in:
1 parent
3d64146164
commit
95009069ca
4 files changed
+200
No files matched your search
@@ -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.
|
||||
@@ -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
|
||||
@@ -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/*
|
||||
Reference in new issue
Block a user