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

@@ -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/*