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