Files
faunosteo/.claude/tasks/contracts/2026-11-12-r2-references-tab-1730.md
T

8.8 KiB

CONTRACT — r2-references-tab

  • date: 2026-11-12 | flow: ship-feature | branch: feature/v1-2-anatomical-sheets (commit in place, no finish)
  • status: active
  • plan: .claude/tasks/plans/2026-11-12-r2-references-tab-1730.md

REQUEST (verbatim — IMMUTABLE)

FAUNOSTEO V1-2.6 — Validation du correctif E2E et GO R2

Le propriétaire valide le checkpoint du correctif E2E.

1. Correctif E2E accepté

Le commit 2cdee42 est accepté.

Résultats retenus :

  • Les quatre échecs historiques ont disparu.
  • Deux passages successifs réussis.
  • Le véritable composant WorkingCopyAction est couvert dans e2e:ui.
  • Les contrôles de la fiche historique restent présents dans e2e:shell.
  • Les refus serveur restent couverts.
  • Les 637 fiches préexistantes sont restées inchangées pendant cette intervention.

Conserver la limite documentaire : le dialogue n'est plus testé dans son contexte serveur réel par ce contrôle d'accessibilité.

2. Mémoire — VALIDÉE

Enregistrer :

BLK-014 — admin.spec dialog check depended on shared singleton working-copy state — resolved 2cdee42.

Préciser que la résolution concerne les quatre échecs de ce contrôle, pas tous les risques de concurrence des suites E2E.

LRN-132 — E2E tests and database-wide singleton state.

Documenter :

  • Ne pas exiger qu'une ressource unique soit disponible dans une base persistante partagée.
  • Tester le véritable composant UI indépendamment lorsque nécessaire.
  • Vérifier dans les tests serveur la cohérence de l'état réellement présent.
  • Nettoyer ou archiver exclusivement les ressources créées et identifiées par la suite concernée.
  • Vérifier les identifiants effectivement modifiés par les opérations de nettoyage.
  • Éviter les interactions concurrentes entre suites manipulant une ressource singleton.

Effectuer les contrôles documentaires et commit/push.

3. Risque editor-equine — À encadrer

La suite editor-equine archive temporairement les copies actives de la fiche historique puis les restaure.

Ce comportement a déjà modifié la date de modification de 8c315a12.

Il ne doit plus être exécuté sur une base persistante contenant des données préexistantes à préserver.

Avant de relancer une suite qui inclut editor-equine :

  • Identifier précisément ses écritures.
  • Proposer une isolation reproductible et non destructive pour les ressources préexistantes.
  • Vérifier les interactions possibles avec admin.spec et les autres suites parallèles.
  • Préserver la copie 8c315a12 et ses métadonnées actuelles.
  • Ne pas chercher à rétablir artificiellement une ancienne date.
  • Ne pas supprimer ou réinitialiser la sandbox.

Présenter une correction séparée si nécessaire. Ne pas élargir silencieusement le périmètre R2.

Suivre également les fiches créées par les tests pour éviter l'accumulation de fixtures persistantes.

4. GO — Implémentation de R2

J'autorise R2.0 à R2.6 conformément au plan technique approuvé et aux maquettes R0.

R2.0 — Renommage interne du volet de références.

R2.1 — Cinquième onglet Références et navigation.

R2.2 — Tuiles de références dépliables.

R2.3 — Recherche, tri et actions.

R2.4 — Volet contextuel des références citées par un constat.

R2.5 — Tests et non-régressions.

R2.6 — Documentation, traductions et clôture.

Respecter les décisions A1 à A4 et D1 à D4, ainsi que les exigences enregistrées dans la TODO par a1d4084.

Chaque sous-lot doit être vérifié, commité et poussé avant le suivant.

Ne pas déclencher une suite dangereuse pour les données préexistantes au prétexte qu'elle fait partie des contrôles habituels. Si cela bloque une validation obligatoire, s'arrêter au checkpoint correspondant et proposer une solution.

5. Exigences R2

  • Une référence citée ne peut pas être supprimée.
  • « Retirer de ce constat » retire seulement l'association concernée et reste annulable.
  • Aucune modification en lecture seule.
  • Recherche et tri en TypeScript, exclusivement pour l'affichage.
  • Aucune mutation de l'ordre enregistré ou du document.
  • Volet contextuel sans déplacement du schéma.
  • Navigation clavier et gestion du focus conformes aux maquettes.
  • Accessibilité, mobile et prefers-reduced-motion respectés.
  • Tableau exhaustif des nouveaux libellés FR/EN à présenter avant leur validation définitive.
  • Documenter l'exception TypeScript dans la revue d'architecture Rust.

6. Restrictions

Aucune intervention sur db:trial ou DEV.

Les tests automatisés utilisent uniquement les environnements autorisés et ne doivent jamais modifier des données préexistantes à préserver.

Ne pas toucher à la fiche équine historique ni à la copie d'essai manuelle.

Aucune migration SQL, modification Rust ou worker hors périmètre.

Aucune suppression de données, aucune fusion et aucun déploiement.

Préserver le fichier de revue ChatGPT non suivi.

Ne pas commencer R3, R4, U2 ou U2b.

7. Checkpoint final

Fournir :

  • La liste des sous-lots R2 réalisés.
  • Les commits et leur état de push.
  • Les résultats exacts des tests exécutés et ceux volontairement non exécutés.
  • Les revues indépendantes et les éventuelles réserves.
  • Le statut du risque editor-equine.
  • Le tableau FR/EN des nouveaux libellés.
  • Le protocole de test manuel sur db:trial.

S'arrêter après R2 et attendre la validation utilisateur.

CLARIFICATIONS

Q: family detail « n références » button? / A: same panel with family words (« Retirer de cette famille », badge « cette famille », « N références citées par cette famille »); new FR/EN labels in the checkpoint table. [gated 2026-11-12] Q: 640-1 023 px tab row? / A: all five tabs shown; the row may wrap (fixed per width, never moves on interaction, no horizontal scroll). [gated 2026-11-12] Q: « Retirer » marks the finding / family « À confirmer » (core rule, edit.rs)? / A: accepted; documented in docs and db:trial protocol; one « Défaire » restores both. [gated 2026-11-12] Q: shell gate with editor-equine? / A: excluded from every run (owner §3, §4 « ne pas déclencher une suite dangereuse »); its helper calls are updated for typecheck only, never run; per-id snapshot of pre-existing anatomical_sheets before/after each shell run. Q: where does the FR/EN table live? / A: docs/development/V1-2-6_R2_LABELS.md (decided in plan, shown at the gate).

ACCEPTANCE CRITERIA

Seed (from the request); design criteria appended at STEP 3 with [gated].

  1. Five editor tabs in the order Général, Annotations, Constats, Références, Vérification; below 640 px « Plus » holds Général, Constats, Références; no header « Références » button.
  2. A cited reference never shows « Supprimer » (hint instead); an uncited one keeps « Supprimer » + existing dialog; the core refusal stays the authority.
  3. « Retirer de ce constat / cette famille » removes only that association, one « Défaire » restores it; the reference stays in the document.
  4. Read-only and no-right modes show no edit control in the tab or the panel.
  5. Search and the four sorts are TypeScript display functions over ids; the document text, stored order, ids and history are identical before and after any search or sort (tested).
  6. The panel opens only from a finding or family, width ≤ 34 rem and ≤ available width, slide 180 / 140 ms, none under reduced motion, page inert and panel unreachable while closed or exiting, focus back to the trigger if it still exists; no layout shift of the tab content on open / close.
  7. A1 to A4 hold; « Aller à » from Vérification opens the right tile, open and focused; references reachable when a search returns nothing (clear button).
  8. Exhaustive FR/EN table of new and changed labels with ambiguities: docs/development/V1-2-6_R2_LABELS.md; Rust exception rows in RUST_ARCHITECTURE_REVIEW.md Part II.
  9. Gates per sub-lot: typecheck, lint, test:run, build; e2e:ui; e2e:shell on db:sandbox without editor-equine; pre-existing rows unchanged per id; one commit + push per sub-lot.
  10. No change under supabase/, crates/, scripts/db-trial*, docker/; no db:trial / DEV access; untracked review file kept; no merge.

FILE SCOPE

apps/app/src/editor/{tabs,navigation,focusRequest,useEditorNavigation,verification,editingContext}.ts, apps/app/src/editor/annotations/deselect.ts, apps/app/src/editor/references/** (new sort.ts), apps/app/src/components/editor/{EditorWorkspace,EditorTabBody,EditorTabs,DraftHeader,HeaderActions,KeptPlace}.tsx, apps/app/src/components/editor/references/, apps/app/src/components/editor/findings/{FindingsTab,FindingContent,FindingDetail}.tsx, apps/app/src/components/editor/tabs/ (new ReferencesTab), apps/app/src/i18n/{fr,en}.ts, apps/app/tests/unit/, apps/app/e2e/{support,shell,ui}/, docs/development/{V1-2-6_U1_CORRECTIONS,BROWSER_TESTS,V1-2-6_OWNER_TRIAL,RUST_ARCHITECTURE_REVIEW,V1-2-6_R2_LABELS}.md, docs/design/README.md, CLAUDE.md (tree), this contract, the plan, .claude/tasks/TODO.md, memory.