195 lines
12 KiB
Markdown
195 lines
12 KiB
Markdown
# 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: closed 2026-11-09 (closing counter-check CONFORME; R0 graphically validated, BDR-110)
|
||
- 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/*
|
||
|
||
## CLARIFICATIONS (owner brief « R0 — Décisions propriétaire et dernière validation graphique », 2026-11-09, BDR-108)
|
||
- Ratified A3, A6 (with precision), A7 (dedicated SQL checkpoint, interim without date), A11 name `pnpm db:trial`;
|
||
A12 decided as « keep `db:sandbox trial*` for now »; A13 decided as two accounts; secret renewal; R4 accepted.
|
||
- Asked in this round, docs only: review archive outside the repository (8 boards, contact sheet, REVUE.md,
|
||
V1-2-6_U1_CORRECTIONS.md, TRIAL_STACK.md, full A1-A15 table `docs/design/v1-2-6-r0/ARBITRAGES.md`); a targeted
|
||
independent counter-check of the two last conformity fixes (criterion 3); the `impeccable detect` status and a
|
||
compliant proposal, nothing installed or run. Stop at the graphic checkpoint.
|
||
|
||
## CLARIFICATIONS (owner graphic verdict « R0 — Verdict de revue graphique propriétaire », 2026-11-09, BDR-109)
|
||
- FILE SCOPE gains `docs/development/V1-2-6_R3_SQL_CHECKPOINT.md` (asked by the owner under A7 « préparer un checkpoint
|
||
SQL dédié »; created in 84aba41 before this line; flagged out of scope by the counter-check of this round).
|
||
- Authorised this round: boards 23, 24, 26 corrected, annotations of 28 and 29, `impeccable detect` 4.1.0 from the
|
||
local cache without network; 25, 27, 30 byte-identical; then the final R0 checkpoint.
|