Files
faunosteo/.claude/tasks/contracts/2026-11-09-v1-2-6-trial-arbitrations.md

12 KiB
Raw Permalink Blame History

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.