docs(docs): R2 labels table, Rust exception, trial protocol

V1-2-6_R2_LABELS.md: the 45 i18n keys R2 adds, changes or removes
(FR, provisional EN, where, status) with the ambiguities and the
pending add-draft cancel question. RUST_ARCHITECTURE_REVIEW Part II:
class C rows for the display-only reference modules (BDR-114 A).
U1_CORRECTIONS §R2 status; BROWSER_TESTS: the two new specs, five
tabs, editor-equine never run, the admin.spec crash risk;
OWNER_TRIAL §4.10 db:trial protocol for R2 and stale four-tab /
old-panel text updated; CLAUDE.md tree.
This commit is contained in:
bchanot committed 2026-11-12 22:49:17 +01:00
1 parent 4b7d2542fd
commit 2182307c62
6 files changed
+285 -13

No files matched your search

+4 -1
View File
@@ -215,6 +215,7 @@ faunosteo/
│ ├─ auth/{validation,redirects,useAuthFailureMessage}.ts ← Zod schemas (i18n keys), safe next path, failure phrasing
│ ├─ auth/{navigationHint,stepUp,useStepUp,useMfaFailureMessage}.ts ← V1-2.5: nav entries from own grants + roles (a hint, never a gate), verified factors for a step-up, in-action step-up on aal2_required, MFA failure phrasing
│ ├─ admin/{filters,labels,permissions,useAdminQuery,validation}.ts ← V1-2.5 admin screens: sheet list filters, status labels, capability checks for display, page-local query, form schemas
│ ├─ editor/references/{filter,citations,panel,sort,view,referenceTypes,safeLink}.ts ← V1-2.6 R2 Références tab: display-only search, citer lists, panel entries, the four sorts, shown set, type order, safe links (TypeScript by owner exception BDR-114 (A), `RUST_ARCHITECTURE_REVIEW.md` II.3)
│ ├─ catalogue/{catalogue,failure,framing,preview,useCardDetails,useCatalogue,useEmptyTap,useFraming,useSheetVersion,versionText}.ts ← V1-2.5 catalogue: reads, closed failure kinds, canvas zoom and pan, PreviewSheet load path (hash, fingerprint, caps checked by the core); useEmptyTap (R1, D6b): a press on the drawing outside any annotation, told from drags and multi-pointer gestures
│ ├─ account/{validation,useProfileForm}.ts ← account section schemas + one-save form hook
│ ├─ config/env.ts ← runtime config resolution
@@ -253,6 +254,8 @@ faunosteo/
│ │ ├─ animals/{AnimalForm,ArchiveAnimalDialog,AnimalNotFound}.tsx
│ │ ├─ relations/{AnimalRelations,RelationPanel,RelationActionDialog,RelationDialogs,RecordPicker,Pickers}.tsx ← in-page link panel, end / dates / void confirmations
│ │ ├─ admin/{ActivateSpeciesDialog,GrantList,GrantPanel,RevokeGrantDialog,SheetBadges,SpeciesDialog,WorkingCopyAction}.tsx ← V1-2.5 rights, species and sheet pieces
│ │ ├─ editor/references/{ReferenceTiles,ReferenceTile,ReferenceFacts,ReferenceEditor,NewReferenceTile,ReferenceToolbar,NoResult,CitersList,CitationsPanel,CitationsLayer}.tsx + use{ReferenceView,ReferenceLibrary,ReferenceEdit,TileState,CitationsPanel}.ts ← V1-2.6 R2: collapsible tiles, toolbar, the citations panel opened from a finding (motion/react slide), their view and tile state hooks
│ │ ├─ editor/tabs/ReferencesTab.tsx ← V1-2.6 R2: the fifth editor tab (toolbar, tiles, add tile, reorder hint)
│ │ ├─ catalogue/{CatalogueCanvas,CatalogueCard,CatalogueFailureNotice,SheetAside,VersionLine,ZonePanel}.tsx ← V1-2.5 catalogue pieces (boards 01 to 03)
│ │ ├─ shell/{AppLayout,SidebarNav,MobileDrawer,UserBadge,SignOutButton,AccessDenied,PermissionsUnavailable}.tsx ← AccessDenied: « Accès non autorisé » on the server's refusal (V1-2.5); PermissionsUnavailable: own grants unreadable, Retry (V1-2.5 checkpoint)
│ │ └─ account/{SectionCard,SaveRow,AvatarSection,PersonalInfoForm,ProfessionalInfoForm,PreferencesForm,SecurityPanel,RoleBadges,MfaFactors,EnrolTotp}.tsx ← MfaFactors + EnrolTotp: TOTP factors in Sécurité (V1-2.5; the secret lives in component state only)
@@ -266,7 +269,7 @@ faunosteo/
├─ tests/
│ ├─ setup.ts
│ └─ unit/*.test.ts
├─ e2e/ ← Playwright (V1-1.3): playwright.{ui,shell}.config.ts, support/{browser,sandbox,shell,records,admin,catalogue}.ts, ui/*.spec.ts, shell/*.spec.ts (V1-2.5: admin, catalogue), harness/{dialog,working-copy}.{html,tsx} (dev server only, never built)
├─ e2e/ ← Playwright (V1-1.3): playwright.{ui,shell}.config.ts, support/{browser,sandbox,shell,records,admin,catalogue}.ts, ui/*.spec.ts, shell/*.spec.ts (V1-2.5: admin, catalogue; V1-2.6 R2: editor-references, editor-citations), harness/{dialog,working-copy}.{html,tsx} (dev server only, never built)
├─ docker/
│ ├─ entrypoint.sh ← injects env.js at container start
│ └─ nginx.conf ← SPA fallback + PORT envsubst
+44 -1
View File
@@ -10,7 +10,7 @@ engines are installed. The suites live in `apps/app/e2e`.
| Command | Backend | Dev server | Content |
|---|---|---|---|
| `pnpm e2e:ui` | none | Vite on `127.0.0.1:5191` | `e2e/ui/dialog.spec.ts`: the D13 contract of the shared Dialog on a test page; `e2e/ui/working-copy.spec.ts`: the real `WorkingCopyAction` and its dialog on a test page (axe, layout, keyboard, fr and en, desktop and 375 px); `e2e/ui/local-tool.spec.ts`: the disclaimer, edit and replace dialogs on the real local-tool routes |
| `pnpm e2e:shell` | the isolated stack of `pnpm db:sandbox` | Vite on `127.0.0.1:5192` | `e2e/shell/shell.spec.ts`: sign-in, dashboard, the account photo confirmation, the phone drawer; `e2e/shell/clients.spec.ts`: the client journeys (V1-1.5); `e2e/shell/animals.spec.ts`: the animal and relation journeys (V1-1.6, contract §11.8); `e2e/shell/responsive.spec.ts`: no sideways scroll on nine shell pages, the archive confirmations and the drawer at 320, 360, 375, 390 and 430 px (phone project) and 1280 px, long values, the dashboard e-mail shown whole (RESP-01); `e2e/shell/admin.spec.ts` (V1-2.5): A0 the owner's bootstrap (two TOTP factors from Sécurité, the step-up at `/app/admin` and inside a factor action, no second factor from `aal1`, refresh keeping `aal1` and `aal2`, rights granted and revoked with their reason), A1 a sheet created by an editor on a new inactive species, S1 a species created inactive then activated by the owner, the creation page when the own-grants read fails (« Impossible de vérifier vos autorisations » and « Réessayer », never the form; Retry brings the form back), access per right (a reviewer-only account refused on the creation page), axe and no sideways scroll on every admin page; `e2e/shell/catalogue.spec.ts` (V1-2.5): P1 a reader searches, opens a sheet, picks a zone, reads a retired version, drafts and archived sheets never listed, the same refusal for an existing and an unknown sheet without access, 320, 375 and 430 px with the whole drawing in the box at opening; at 320 and 375 px the zone panel's live region present before a pick and naming the picked zone, the « Références » card starting at or below the drawing's bottom; `e2e/shell/editor-*.spec.ts` (V1-2.6, the draft editor level 1, contract C16 to C34): `editor-drawings` (A2: a hostile file refused with no cleaning box, an Inkscape export cleaned after its preview, a valid file attached, a detail view by crop, the same bytes attached twice), `editor-annotations` (A3: points, zones and links by clicks and by keyboard only, move by drag, a click with jitter never moves, numeric edits, undo and redo, review and delete), `editor-geometry` (a click near a frame edge with the corrected position confirmed and cancelled, an inherited out-of-frame point repaired through the geometry group, a crop change refused when it would invalidate a point, an unmeasured view with its tools disabled, touch-action and a touch drag in real Chromium), `editor-structures` (A4: categories, references, regions, findings tree, reorder, mark reviewed, delete with dependents), `editor-journey` (the steps of `V1-2-6_OWNER_TRIAL.md` §4 with two editor accounts: creation, drawing, findings, annotations, save, reload with the beforeunload dialog and the recovery offer, conflict, submission, the round read back in SQL), `editor-recovery` (two sessions, an older local copy restored then saved over a newer revision, a pending offer blocking edits, an unreadable copy kept until « Ignorer », Escape on the conflict read, the editor grant revoked, the admin role removed and the grant expired under an open session), `editor-access` (a reviewer-only account read-only, the not-found screen for an editor without the admin role and for an admin without a capability, 320, 375 and 800 px read-only, 1 024 px editing, axe on every tab edit and read-only), `editor-deselect` (R1, D5 and D6b: « Désélectionner » with its live region, the focus on the list row and the document unchanged; Escape over the canvas, a field, the delete dialog, the references panel and a tracing; mouse clicks on empty parts deselecting, on annotations selecting; zoom, pan, marker drag and Ctrl+wheel keeping the selection; a typed value applied by the deselecting click; at 1 280 px with `hasTouch` and CDP touch taps near annotations and the canvas bottom deselecting once, drags, two-finger taps and pinch keeping the selection, with the pointer events counted by a recorder; the read-only twin at 375 px and Escape closing « Plus » before deselecting; the drawing's top unchanged when a point, a zone and a link are selected then deselected, on desktop and on the read-only twin at 375 px, with the selection tag out of the visual flow), `editor-equine` (the historical equine sheet opened as a working copy, a copy left active by an earlier run set aside and put back; commit latency on it and on a synthetic document near 2 MiB, printed as `LATENCY` lines and kept as test annotations, budget 500 ms per commit on the equine copy; one empty click on a bone of the horse drawing deselects, D6b). U1 shell (V1-2.6 U1, the four-tab shell): `editor-shell` (kept-mounted places, focus on a named element, the open panel leaving the header and the tab row clickable at 1 024 and 1 280 px, the sidebar from 1 280 px and the drawer, canvas widths), `editor-shell-journeys` (four tabs, cross-tab undo, typed text then the header undo, a refused field kept through a real Shift+Tab to « Défaire », Ctrl+ZLine truncated
| `pnpm e2e:shell` | the isolated stack of `pnpm db:sandbox` | Vite on `127.0.0.1:5192` | `e2e/shell/shell.spec.ts`: sign-in, dashboard, the account photo confirmation, the phone drawer; `e2e/shell/clients.spec.ts`: the client journeys (V1-1.5); `e2e/shell/animals.spec.ts`: the animal and relation journeys (V1-1.6, contract §11.8); `e2e/shell/responsive.spec.ts`: no sideways scroll on nine shell pages, the archive confirmations and the drawer at 320, 360, 375, 390 and 430 px (phone project) and 1280 px, long values, the dashboard e-mail shown whole (RESP-01); `e2e/shell/admin.spec.ts` (V1-2.5): A0 the owner's bootstrap (two TOTP factors from Sécurité, the step-up at `/app/admin` and inside a factor action, no second factor from `aal1`, refresh keeping `aal1` and `aal2`, rights granted and revoked with their reason), A1 a sheet created by an editor on a new inactive species, S1 a species created inactive then activated by the owner, the creation page when the own-grants read fails (« Impossible de vérifier vos autorisations » and « Réessayer », never the form; Retry brings the form back), access per right (a reviewer-only account refused on the creation page), axe and no sideways scroll on every admin page; `e2e/shell/catalogue.spec.ts` (V1-2.5): P1 a reader searches, opens a sheet, picks a zone, reads a retired version, drafts and archived sheets never listed, the same refusal for an existing and an unknown sheet without access, 320, 375 and 430 px with the whole drawing in the box at opening; at 320 and 375 px the zone panel's live region present before a pick and naming the picked zone, the « Références » card starting at or below the drawing's bottom; `e2e/shell/editor-*.spec.ts` (V1-2.6, the draft editor level 1, contract C16 to C34): `editor-drawings` (A2: a hostile file refused with no cleaning box, an Inkscape export cleaned after its preview, a valid file attached, a detail view by crop, the same bytes attached twice), `editor-annotations` (A3: points, zones and links by clicks and by keyboard only, move by drag, a click with jitter never moves, numeric edits, undo and redo, review and delete), `editor-geometry` (a click near a frame edge with the corrected position confirmed and cancelled, an inherited out-of-frame point repaired through the geometry group, a crop change refused when it would invalidate a point, an unmeasured view with its tools disabled, touch-action and a touch drag in real Chromium), `editor-structures` (A4: categories, references, regions, findings tree, reorder, mark reviewed, delete with dependents), `editor-journey` (the steps of `V1-2-6_OWNER_TRIAL.md` §4 with two editor accounts: creation, drawing, findings, annotations, save, reload with the beforeunload dialog and the recovery offer, conflict, submission, the round read back in SQL), `editor-recovery` (two sessions, an older local copy restored then saved over a newer revision, a pending offer blocking edits, an unreadable copy kept until « Ignorer », Escape on the conflict read, the editor grant revoked, the admin role removed and the grant expired under an open session), `editor-access` (a reviewer-only account read-only, the not-found screen for an editor without the admin role and for an admin without a capability, 320, 375 and 800 px read-only, 1 024 px editing, axe on every tab edit and read-only), `editor-deselect` (R1, D5 and D6b: « Désélectionner » with its live region, the focus on the list row and the document unchanged; Escape over the canvas, a field, the delete dialog, the citations panel (opened from a finding) and a tracing; mouse clicks on empty parts deselecting, on annotations selecting; zoom, pan, marker drag and Ctrl+wheel keeping the selection; a typed value applied by the deselecting click; at 1 280 px with `hasTouch` and CDP touch taps near annotations and the canvas bottom deselecting once, drags, two-finger taps and pinch keeping the selection, with the pointer events counted by a recorder; the read-only twin at 375 px and Escape closing « Plus » before deselecting; the drawing's top unchanged when a point, a zone and a link are selected then deselected, on desktop and on the read-only twin at 375 px, with the selection tag out of the visual flow), `editor-equine` (the historical equine sheet opened as a working copy, a copy left active by an earlier run set aside and put back; commit latency on it and on a synthetic document near 2 MiB, printed as `LATENCY` lines and kept as test annotations, budget 500 ms per commit on the equine copy; one empty click on a bone of the horse drawing deselects, D6b). U1 shell (V1-2.6 U1, the tabbed shell): `editor-shell` (kept-mounted places, focus on a named element, the open panel leaving the header and the tab row clickable at 1 024 and 1 280 px, the sidebar from 1 280 px and the drawer, canvas widths), `editor-shell-journeys` (five tabs, cross-tab undo, typed text then the header undo, a refused field kept through a real Shift+Tab to Line truncated
Each suite runs on two Chromium projects: `chromium-desktop` (1280 × 800) and
`chromium-375` (375 × 667, mobile viewport, touch). A test tagged `@phone`
@@ -66,6 +66,37 @@ flight when the last check passed is dropped with the context instead of
failing the test (the V1-1.6 verifier saw the client journey fail that way once
the client page reloads its animals after a restore).
### The Références specs (V1-2.6 R2)
`e2e/shell/editor-references.spec.ts` covers the Références tab. Tiles in edit mode: closed, open and edit tiles
with axe in each state; « Terminer » keeping the edit view while a field is refused; the tile headers as a keyboard
walk (Tab between them, Enter and Space open); « Aller à » on a citer opening Constats on it. Search, sort and add:
the four sorts, search, clear, no result and the move buttons with the server document never changing; adding a
reference, saving it, then deleting an uncited one; a tile in edit keeping its place under a sort and a search.
Read-only at 375 px: « Plus » lists Références, tiles keep DOI, URL and « Aller à », no edit control.
`e2e/shell/editor-citations.spec.ts` covers the citations panel opened from a finding. Editing: opens filtered on
its finding, « Retirer de ce constat » then one « Défaire », the saved status; a long list scrolls inside the panel
and the page never moves; the last citation gone keeps the panel with its line, then it closes on a tab; « Tout
afficher » closes it, resets search and sort, keeps open tiles and focuses the tab heading; Escape in a tile field
neither closes the panel nor commits, ✕ then commits; a refused draft cancels the close; the page and the panel
stay inert through the exit (sampled in the page). Each close path (✕, Escape, scrim, « Tout afficher », « Aller
à », a tab choice) runs with and without reduced motion and checks where the focus lands, and the slide happens
only when motion is allowed. Read-only at 375 px: full width through « Plus » then Constats, no edit control, axe.
Layout additions in `e2e/shell/editor-shell-layout.spec.ts`: five tabs everywhere the four were checked (no
sideways scroll from 1 024 to 1 280 px, axe from the top, read-only at 320, 375 and 768 px); the open panel at most
34 rem and never wider than the viewport, the document size unchanged before, during and after; the canvas width
equal before the panel opens and after a tab switch closes it; at 375 px read-only the panel full width, its
bottom on the viewport bottom through a height change and a rotation, the drawing box unchanged.
`e2e/support/editor.ts` gains `openCitations` (optional expansion budget, waits for the heading focus) and
`closeCitations`.
Running them: `editor-equine.spec.ts` is never run on a persistent sandbox that holds data to preserve (owner,
2026-11-12), because it sets aside and puts back the working copy of the historical sheet. A shell run names every
spec by its full path, never a directory or a pattern. After the R2 commits `editor-equine.spec.ts` was updated
for typecheck only and never run.
## 2. Prerequisites
- The repository's Node and pnpm, `pnpm install`.
@@ -176,6 +207,18 @@ suite needs Docker in the runner for the sandbox.
they are scanned from the top of the page (`expectAccessibleFromTop`), where
nothing sits under the bar. The controls are 44 px high either way.
- `e2e/shell/admin.spec.ts` (A0, the owner's bootstrap, and the admin screens) can end in « Target crashed »
during axe. Known cause, not a product regression: the rights screen renders every catalogue grant at once
(`list_catalog_grants` takes no argument, `GrantList` shows all of them), the sandbox's accumulated e2e fixtures
took it from 753 to 1 282 grants, and the renderer dies under memory pressure. Seen in the R2.3 and R2.5 runs
(3 failures in the R2.5 sweep). Open risk: a run-scoped fixture cleanup or a paginated grant list would end it,
neither is done. Rerun the spec alone to separate a crash from a real failure.
- The layout spec skips the landscape 667 × 375 sample at scroll 0: the panel's trigger is in Places, below
the fold there, so only about 13 px of the panel show before a scroll. Documented limit, no proof either way.
- A control placed below a field whose blur-commit is refused can lose its first click, because the error line
moves the layout between mouse down and click. An editor-wide pattern found while writing the Références specs
(« Terminer » got a `mousedown` guard); the general cure is not done.
## 7. Adding a test
Import `test` and `expect` from `e2e/support/browser.ts` (the request guard
@@ -302,6 +302,10 @@ concrete constraint.
| `packages/supabase` client factory, auth/profile wrappers, `database.types.ts`, PGlite harness | vendor SDK, generated types, test infra | TS | no Rust GoTrue client for the browser; PGlite is a JS/WASM library | no | none | none | | **C** | n/a |
| `auth/validation.ts`, `account/validation.ts` (Zod, i18n keys) | form field rules | Zod | portable but React-bound (retained list); the constraints are duplicated in SQL CHECKs and `config.toml` and drift (trim, UTF-16 vs `char_length`, `''` on names) | no | | | one constants module + a PGlite test reading `pg_constraint` and `config.toml` with the counting rule recorded (separate chore, D-R7) | **C** | chore |
| `lib/{dates,id}.ts` | `nowIso`, `todayIso`, `formatDate` (screen), `generateId` | Web APIs | clock and ids injected into the core; screen dates stay `Intl` | no | | | | **C** | n/a |
| `apps/app/src/editor/references/{filter,citations,panel}.ts` | Références tab and citations panel: search match on citation, DOI and URL (`folded`); who cites each reference (`citersOf`); the citations and the path of one finding | TS over the validated document | portable (pure functions), but display lists over the document the core already validated; the one rule nearby, which finding depends on a reference, stays the core's `sheet.dependents` | no | none; read in `useMemo` on the parsed document | none | existing unit suites (`editor-references-view`, `editor-citations`) | **C**: display-only search and listing over validated data, no business rule, no mutation; owner decision BDR-114 (A) 2026-11-12 | n/a |
| `apps/app/src/editor/references/{sort,view,referenceTypes}.ts` | the four display orders of the Références tab (sheet, citation A to Z, count, type), the shown set after search and sort | TS, `Intl.Collator` of the current language | the collation needs the browser's ICU data (a Rust equivalent would ship its own); a pure function of positions that never writes the document, the stored order or the history | no | none | none | `editor-reference-sort.test.ts` (stable, equal keys keep the stored order, inputs untouched), view suites | **C**: display-only ordering, no business rule, no mutation; BDR-114 (A) | n/a |
| `apps/app/src/editor/references/safeLink.ts` | `http` and `https` link target for a URL, `https://doi.org/` target for a well-formed DOI | TS (`URL`) | portable; it builds a display link, it validates no stored field (the core's reference rules stay authoritative) | no | none | none | `editor-safe-link.test.ts` | **C**: display-only link building over validated data; BDR-114 (A) | n/a |
| `apps/app/src/components/editor/references/useReferenceView.ts` | search text and sort choice (React state), tile order handed to the tab | React hook | holds view state only and calls the pure functions above; it reaches no wasm call and no document write | no | none | none | `editor-references-view.test.tsx` | **C**: React state of a display view; BDR-114 (A) | n/a |
| `i18n/*` (281 keys ×2, `useT`, `pickLocaleLabel`) | UI strings | TS | UI data and hook; the engine's 25 archived labels move with the engine | no | | | parity test | **C** | n/a |
| `config/env.ts`, `lib/supabase.ts`, providers, guards, routes, components, styles | runtime config, React | TS | glue | no | | | | **C** | n/a |
| `vite/sheet-bundle.ts`, ESLint, Vite, vitest configs | build tooling | Node | Vite plugin API is JavaScript | no | | | | **C** | n/a |
@@ -325,6 +329,13 @@ concrete constraint.
and error shapes, UI form schemas and dictionaries, platform clock/crypto
and screen date formatting, the browser rasteriser (DOM), Vite asset
wiring and tooling, SQL and RLS, the public web framework (D-R8).
Exception for the Références tab (owner decision BDR-114 (A), 2026-11-12):
search, sort, citer lists and link building under
`apps/app/src/editor/references/` stay in TypeScript. They only order, filter and format the
document the core has already validated, hold no business rule and never
mutate it. The limit: any rule that would change the document, or that the
PDF or the server must share (what may be deleted, what a citation
requires, a count stored or archived), moves to `crates/core`.
---
+83 -11
View File
@@ -117,7 +117,7 @@ Chaque étape donne l'action et le résultat attendu. Notez tout écart avec la
acceptée), renseignez « Nom (français) », « Nom (anglais) » et l'identifiant (slug, par exemple `essai-chien`),
« Créer la fiche ».
2. Attendu : la création ouvre directement le brouillon vide dans l'éditeur, sans page intermédiaire, avec
quatre onglets (Général, Annotations, Constats, Vérification). Une fiche neuve et vide s'ouvre
cinq onglets (Général, Annotations, Constats, Références, Vérification). Une fiche neuve et vide s'ouvre
sur l'onglet « Général ».
3. Dans « Général », tapez des espaces autour d'un nom (par exemple ` Essai `) et validez. Attendu : les espaces
du début et de la fin sont retirés des noms et des libellés courts de l'éditeur ; les descriptions, notes,
@@ -243,7 +243,8 @@ dans « Gérer les vues » (onglet Annotations) avec un recadrage, puis « Chois
À dérouler sur la fiche non équine de 4.1, après les étapes 4.2 et 4.3 (il faut au moins une annotation et un
constat avec une référence). La fiche de démonstration n'est pas créée par la commande d'essai : c'est celle que
vous avez créée dans l'interface.
1. Les quatre onglets : « Général », « Annotations », « Constats », « Vérification ». Passez de l'un à l'autre à
1. Les onglets (cinq depuis R2, voir 4.10 ; « Références » s'insère avant « Vérification ») : « Général »,
« Annotations », « Constats », « Références », « Vérification ». Passez de l'un à l'autre à
la souris, puis au clavier (flèches gauche et droite dans la rangée d'onglets). Revenez sur un onglet : ce que
vous y aviez saisi et sélectionné est resté.
2. Dans « Général », modifiez un nom sans enregistrer. Passez sur « Annotations » et cliquez « Défaire » à droite
@@ -258,10 +259,8 @@ vous avez créée dans l'interface.
ou l'en-tête de l'application ne fait rien. iOS Safari : à vérifier à la main, non couvert par les tests.
À chaque sélection et désélection, le dessin reste à sa place : aucune étiquette « Sélection : … » ne s'affiche
au-dessus.
4. Références : le bouton « Références » de l'en-tête ouvre un panneau latéral (non modal) avec une recherche sur
la citation, le DOI et l'URL (« Rechercher une référence »). Dans « Constats », sélectionnez un constat qui cite
une référence : le bouton « n référence(s) » ouvre le même panneau limité à « Citées par « … » (n) », avec « Tout afficher (n) » pour revenir à la liste entière.
« Fermer les références » ou Échap ferme le panneau et rend le focus au bouton qui l'a ouvert.
4. Références : remplacé par 4.10. Le bouton « Références » de l'en-tête n'existe plus ; les références ont leur
onglet, et le panneau latéral s'ouvre depuis un constat seulement.
5. Dans « Annotations », la carte « Vues » propose « Gérer les vues », la carte « Catégories » « Modifier les
catégories », et une entrée « Régions vertébrales (n régions) » est toujours là. Chacun ouvre sa section pleine largeur avec
« Retour au dessin » en tête. Une saisie commencée dans une section reste là quand vous revenez au dessin puis
@@ -271,6 +270,67 @@ vous avez créée dans l'interface.
libérée. Sous 1 024 px l'éditeur passe en lecture seule (voir les limites) ; en dessous de 640 px, deux
onglets restent visibles et « Plus » ouvre les deux autres.
### 4.10 Démonstration R2 : l'onglet Références
À dérouler sur la fiche de 4.9, qui porte au moins un constat citant une référence et une référence non citée
(ajoutez-la à l'étape 8 sinon). Libellés : `V1-2-6_R2_LABELS.md`. Rien dans ce parcours n'est lancé par Claude : la
pile d'essai et les vérifications sont les vôtres. Chaque étape donne l'action, puis l'attendu.
1. Onglets. Action : ouvrez la fiche à 1 280 px, puis réduisez la fenêtre sous 640 px. Attendu : cinq onglets
« Général », « Annotations », « Constats », « Références », « Vérification » ; sous 640 px deux onglets restent
visibles et « Plus » ouvre les autres, « Références » compris. Plus de bouton « Références » dans l'en-tête.
2. Tuiles. Action : ouvrez « Références ». Attendu : une tuile fermée montre la citation, son type et « Citée n
fois » (ou « Non citée »). Ouvrez-en une (clic, Entrée ou Espace sur l'en-tête) : DOI, URL, liste des citants
avec « Aller à », et pour un citant une pastille « famille » ou « ce constat ». « Modifier » passe la tuile en
modification (titre « Modifier la référence ») ; « Terminer » sort de la modification.
3. Citée ou non. Action : comparez une référence citée et une référence non citée, tuiles ouvertes. Attendu : la
citée n'a pas de « Supprimer » mais l'aide « Pour supprimer cette référence, retirez d'abord chacune de ses
citations… » ; la non citée offre « Supprimer ».
4. Recherche. Action : tapez un mot de la citation, puis un bout de DOI ou d'URL, puis un texte absent, puis
cliquez ✕ (« Effacer la recherche »). Attendu : le décompte devient « n références sur N » ; sans résultat,
« Aucune référence ne contient « … » » et « La recherche porte sur la citation, le DOI et l'URL. » avec le
bouton d'effacement ; ✕ vide le champ et rend le focus au champ.
5. Tris. Action : « Trier par » puis chacun de « Ordre de la fiche », « Citation (A → Z) », « Nombre de
citations », « Type ». Attendu : l'ordre des tuiles change à chaque choix, sans effet sur la fiche : si rien d'autre n'a changé,
« Enregistrer » reste inactif (le tri n'écrit pas dans le document), et revenir à « Ordre de la fiche » rend
l'ordre d'origine. Enregistrer après un tri, avec une autre modification, ne change pas l'ordre des références
côté serveur. « Monter » et « Descendre » n'existent que dans
« Ordre de la fiche » sans recherche ; sinon la ligne « Pour réorganiser, affichez l'ordre de la fiche sans
recherche. » les remplace.
6. Une tuile en modification pendant un tri ou une recherche. Action : modifiez une tuile, puis changez le tri
ou la recherche sans « Terminer ». Attendu : la tuile reste à sa place et ne disparaît pas de la liste.
7. Constat. Action : dans « Constats », sélectionnez un constat qui cite des références. Attendu : un bouton « n
référence(s) » apparaît ; une famille n'en a pas (elle garde sa liste en ligne et « Retirer »).
8. Ajouter. Action : « Ajouter une référence ». Attendu : une tuile d'ajout s'ouvre, le focus sur le champ
Citation ; type et citation sont obligatoires (« Type et citation obligatoires. »). Ajoutée, la référence se
place en fin d'ordre de la fiche, recherche et tri remis à zéro, la tuile ouverte. Point en
attente : cette tuile n'a pas de bouton d'annulation (question au propriétaire, `V1-2-6_R2_LABELS.md` §4).
9. Panneau. Action : cliquez « n référence(s) » du constat. Attendu : un panneau glisse depuis la droite (34 rem
au plus), le reste de la page est voilé et inerte, le focus va sur « Références citées ». Il liste les
références de ce constat dans l'ordre du constat, avec « Modifier », « Retirer de ce constat » et « Aller à »,
et la ligne « n références citées par ce constat ».
10. Retirer puis défaire. Action : « Retirer de ce constat » sur une tuile, puis « Défaire » (en haut, à droite de
la rangée d'onglets). Attendu : après le retrait, la citation quitte le panneau (la référence reste dans
l'onglet « Références »), le constat passe à « À confirmer » ; un seul « Défaire » rend la citation et le
statut ensemble. Retirez la dernière citation : le panneau reste ouvert avec « Ce constat ne cite plus aucune
référence. ».
11. « Tout afficher ». Action : « Tout afficher dans l'onglet Références ». Attendu : le panneau se ferme, l'onglet
« Références » s'ouvre, recherche et tri remis à zéro, les tuiles ouvertes restées ouvertes, le focus sur le
titre de l'onglet.
12. Fermetures. Action : rouvrez le panneau, puis fermez-le par Échap, par ✕ (« Fermer les références »), par un
clic sur le voile, par un clic sur un onglet. Attendu : Échap, ✕ et le voile rendent le focus au bouton « n
référence(s) » qui l'a ouvert ; un clic sur un onglet ouvre cet onglet, focus sur son bouton. Échap dans un
champ d'une tuile du panneau ne ferme pas le panneau ; ✕ valide alors la saisie. Une saisie refusée annule la
fermeture demandée : le panneau reste, le champ garde le focus et le message s'affiche.
13. Mouvement réduit. Action : activez la réduction des animations dans le système, rouvrez et fermez le panneau.
Attendu : plus de glissement, le panneau apparaît et disparaît d'un coup ; le focus se comporte pareil.
14. Téléphone. Action : fenêtre à 375 px (lecture seule sous 1 024 px). Attendu : « Plus » mène à « Références » ;
les tuiles gardent DOI, URL et « Aller à », sans « Modifier », « Supprimer », « Monter » ni « Descendre » ;
le panneau prend toute la largeur, sans dépasser l'écran. Passer sous 1 024 px avec le panneau ouvert le
laisse ouvert, en lecture.
15. Vérification. Action : dans « Vérification », cliquez « Aller à Références » sur une anomalie de référence.
Attendu : l'onglet « Références » s'ouvre sur la tuile, ouverte et focalisée. Aucun parcours de l'interface
connu ne fabrique cette anomalie (non vérifié) : ce cas n'est couvert que par les tests automatiques, passez
cette étape si Vérification n'en liste aucune.
## 5. Limites à connaître
- Risque résiduel RR-12 : les opérations du catalogue lisent la mention `aal2` du jeton, pas la session vivante.
Un jeton émis à `aal2` reste accepté après la suppression du facteur, jusqu'à son expiration (une heure).
@@ -292,8 +352,7 @@ vous avez créée dans l'interface.
### Limites connues de U1
- Une décision en attente sur une vue (nettoyage de l'illustration, réparation des annotations, retour à
l'illustration parente) n'est pas perdue par un simple changement d'onglet, de section ou l'ouverture du panneau
des références : elle est retenue, signalée par une ligne « … attend votre décision » avec « Reprendre », et ne
l'illustration parente) n'est pas perdue par un simple changement d'onglet ou de section : elle est retenue, signalée par une ligne « … attend votre décision » avec « Reprendre », et ne
se rouvre que par ce bouton. Elle est perdue quand sa vue disparaît (« Défaire », abandon des modifications,
rechargement, suppression de la vue), et « Refaire » ne la ramène pas.
- Une décision en attente au moment d'une soumission reste affichée comme ligne en attente, sans bouton d'action,
@@ -312,12 +371,13 @@ vous avez créée dans l'interface.
une modification non enregistrée, comme au niveau 1.
- La fenêtre de réparation des annotations garde les géométries saisies au passage sous 1 024 px, mais pas le
message de refus d'une application ni une saisie illisible encore en cours dans un groupe de géométrie.
- Tant que le panneau des références est ouvert, le contenu des onglets n'est pas atteignable au clavier (il est
inerte sous le voile) : on parcourt d'abord le panneau, le contenu après sa fermeture.
- Tant que le panneau des citations est ouvert (ou se ferme), la page est inerte sous le voile : on parcourt
d'abord le panneau. Il ne s'ouvre que depuis un constat, dans « Constats », et se ferme à tout changement
d'onglet (voir 4.10 et les limites de R2).
- « Gérer les vues », « Modifier les catégories » et « Régions vertébrales » ouvrent les éditeurs existants en
section pleine largeur ; U3, U4 et U6 les remplacent.
- Largeur du dessin (choix 2.6) : 538 px à 1 024 px et à 1 280 px (la barre latérale revient à 1 280 px), 694 px
à 1 180 px, 793 px à 1 279 px ; le panneau des références ouvert ne la change pas.
à 1 180 px, 793 px à 1 279 px ; la largeur est la même avant l'ouverture du panneau des citations et après sa fermeture.
- Le parcours automatique sur un second appareil du réseau local (`e2e/lan/trial-lan.spec.ts`) n'a pas été
exécuté : il demande cette pile d'essai. Votre essai depuis un autre appareil (section 3) en est la première
vérification.
@@ -327,6 +387,18 @@ vous avez créée dans l'interface.
précédent), à confirmer par une reproduction non destructive ou un test isolé. Les 192 réussites sans échec
datent du commit 81fba46 sur une pile neuve, pas du dernier commit.
### Limites connues de R2
- La tuile « Ajouter une référence » n'a pas de bouton d'annulation : question posée au propriétaire le
2026-11-12, sans réponse. Le libellé et la place d'un éventuel bouton sont à décider.
- Sur un téléphone en paysage (667 × 375) et en haut de page, le panneau n'est visible que sur environ 13 px :
son déclencheur est dans la zone sous la ligne de flottaison, il faut d'abord défiler.
- Un bouton placé sous un champ dont la saisie est refusée peut perdre son premier clic (la ligne d'erreur décale
la mise en page) : défaut de tout l'éditeur, pas propre à R2, non corrigé.
- Passer en lecture seule (fenêtre sous 1 024 px) laisse le panneau ouvert, en lecture.
- Le plantage « Target crashed » du test automatique des écrans d'administration (`admin.spec.ts`, écran des
droits chargé avec toutes les attributions accumulées par les tests) ne concerne que les tests : aucun écran
d'essai n'est touché. Il ne s'observe pas dans cet essai manuel.
## Repli facultatif : tunnel SSH
Le réseau local suffit normalement. Hors de ce réseau, ou si l'essai tourne en `FAUNOSTEO_TRIAL_HOST=127.0.0.1`,
ouvrez un tunnel depuis l'autre ordinateur :
+111
View File
@@ -0,0 +1,111 @@
# V1-2.6 R2 : libellés de l'onglet Références
Statut : R2 construit sur `feature/v1-2-anatomical-sheets`, en attente de la validation du propriétaire.
Source : `git diff 49867ba..HEAD -- apps/app/src/i18n` (`fr.ts` et `en.ts`), 45 lignes ci-dessous : 39 clés
nouvelles, 2 modifiées, 4 retirées. Les deux dictionnaires portent les mêmes clés.
Règles de lecture :
- Les libellés français viennent de `docs/design/v1-2-6-r0/REVUE.md` (planches 23 à 27) : formulation ratifiée.
- Trois libellés français sont provisoires et ont été acceptés par le propriétaire le 2026-11-12 :
« Ce constat ne cite plus aucune référence. », « Référence introuvable » et « Saisie non appliquée : … ».
Ils sont marqués « provisoire, accepté 2026-11-12 » dans la colonne Statut.
- Tous les libellés anglais sont une base de travail. Aucun n'a été ratifié un par un (décision du propriétaire).
- Les clés `editor.references.close` (« Fermer les références ») et `editor.references.search` (« Rechercher une
référence ») et `editor.findings.references_open_*` (déclencheur « n référence(s) ») sont inchangées.
## 1. Clés nouvelles et modifiées
| Clé | FR | EN (provisoire) | Où | Statut | Notes |
|---|---|---|---|---|---|
| `editor.tab.references` | Références | References | Rangée d'onglets de l'éditeur (sous « Plus » sous 640 px), titre de l'onglet, annonce de navigation | nouveau | |
| `editor.references.panel_title` | Références citées | Cited references | Panneau des citations, en-tête | nouveau | |
| `editor.references.panel_count_one` | {count} référence citée par ce constat | {count} reference cited by this finding | Panneau des citations, ligne de décompte | nouveau | |
| `editor.references.panel_count_other` | {count} références citées par ce constat | {count} references cited by this finding | Panneau des citations, ligne de décompte | nouveau | |
| `editor.references.panel_show_all` | Tout afficher dans l'onglet Références | Show all in the References tab | Panneau des citations, bouton de bas de liste | nouveau | Ferme le panneau, ouvre l'onglet, remet recherche et tri à zéro. |
| `editor.references.panel_empty` | Ce constat ne cite plus aucune référence. | This finding no longer cites any reference. | Panneau des citations, état à zéro | nouveau ; provisoire, accepté 2026-11-12 | Libellé provisoire, accepté 2026-11-12. |
| `editor.references.remove_citation` | Retirer de ce constat | Remove from this finding | Panneau des citations, tuile (action) | nouveau | Voir ambiguïté 2 : « Retirer » ailleurs. |
| `editor.references.this_finding` | ce constat | this finding | Onglet Références, tuile ouverte, liste des citants | nouveau | Désigne le constat qui est lui-même le citant. |
| `editor.references.missing` | Référence introuvable | Reference not found | Panneau des citations, ligne d'un identifiant sans référence | nouveau ; provisoire, accepté 2026-11-12 | Libellé provisoire, accepté 2026-11-12. |
| `editor.references.draft_dropped` | Saisie non appliquée : {field} | Entry not applied: {field} | Annonce (région live) quand le panneau est fermé de force et qu'une saisie refusée est abandonnée | nouveau ; provisoire, accepté 2026-11-12 | Libellé provisoire, accepté 2026-11-12. {field} est le libellé du champ refusé (Type, Citation, DOI ou Adresse web (URL)). Voir ambiguïté 5. |
| `editor.references.cited_one` | Citée {count} fois | Cited {count} time | Onglet Références et panneau, en-tête de tuile | modifié : « citée {count} fois » → « Citée {count} fois » (EN : « cited {count} time » → « Cited {count} time ») | Modifié : majuscule initiale. FR : « Citée 1 fois » (même forme pour 1 et plus). |
| `editor.references.cited_other` | Citée {count} fois | Cited {count} times | Onglet Références et panneau, en-tête de tuile | modifié : « citée {count} fois » → « Citée {count} fois » (EN : « cited {count} times » → « Cited {count} times ») | Modifié : majuscule initiale. |
| `editor.references.uncited` | Non citée | Not cited | Tuile, en-tête | nouveau | |
| `editor.references.citers_one` | Citée {count} fois, par : | Cited {count} time, by: | Tuile ouverte, intitulé de la liste des citants | nouveau | |
| `editor.references.citers_other` | Citée {count} fois, par : | Cited {count} times, by: | Tuile ouverte, intitulé de la liste des citants | nouveau | |
| `editor.references.no_citers` | Aucun constat ni aucune famille ne cite cette référence. | No finding or family cites this reference. | Tuile ouverte, aucun citant | nouveau | |
| `editor.references.family` | famille | family | Tuile ouverte, pastille d'un citant famille | nouveau | Voir ambiguïté 1. |
| `editor.references.go_to` | Aller à | Go to | Tuile ouverte, bouton sur un citant | nouveau | Vérification dit « Aller à {tab} » (autre clé). |
| `editor.references.edit` | Modifier | Edit | Tuile ouverte et panneau, bouton | nouveau | |
| `editor.references.done` | Terminer | Done | Tuile en modification, bouton | nouveau | Ferme la modification, sans bouton « Annuler » associé. Voir ambiguïté 3. |
| `editor.references.edit_title` | Modifier la référence | Edit the reference | Tuile en modification, titre | nouveau | |
| `editor.references.url_label` | URL | URL | Tuile ouverte, ligne de faits | nouveau | |
| `editor.references.none_doi` | Aucun | None | Tuile ouverte, DOI absent | nouveau | Genre : « Aucun » (DOI masculin). |
| `editor.references.none_url` | Aucune | None | Tuile ouverte, URL absente | nouveau | Genre : « Aucune » (adresse féminin). |
| `editor.references.new_tab` | (nouvel onglet) | (new tab) | Texte réservé aux lecteurs d'écran après un lien externe | nouveau | |
| `editor.references.delete_hint` | Pour supprimer cette référence, retirez d'abord chacune de ses citations : « Aller à », puis « Retirer » dans le détail du constat ou de la famille. | To delete this reference, first remove each of its citations: “Go to”, then “Remove” in the finding's or family's detail. | Tuile ouverte d'une référence citée, à la place de « Supprimer » | nouveau | Cite deux libellés existants : « Aller à » et « Retirer ». |
| `editor.references.add` | Ajouter une référence | Add a reference | Onglet Références, barre d'outils, bouton | nouveau | |
| `editor.references.add_help` | Type et citation obligatoires. | Type and citation required. | Tuile d'ajout, aide sous le formulaire | nouveau | |
| `editor.references.clear_search` | Effacer la recherche | Clear the search | Barre d'outils (bouton ✕) et état sans résultat | nouveau | |
| `editor.references.sort_by` | Trier par | Sort by | Barre d'outils, étiquette du sélecteur de tri | nouveau | |
| `editor.references.sort.sheet` | Ordre de la fiche | Sheet order | Barre d'outils, option de tri | nouveau | Seul tri où « Monter » et « Descendre » agissent. |
| `editor.references.sort.citation` | Citation (A → Z) | Citation (A → Z) | Barre d'outils, option de tri | nouveau | Ordre alphabétique de la langue courante. |
| `editor.references.sort.count` | Nombre de citations | Number of citations | Barre d'outils, option de tri | nouveau | Décroissant, égalités dans l'ordre de la fiche. |
| `editor.references.sort.type` | Type | Type | Barre d'outils, option de tri | nouveau | Ordre métier des types, pas alphabétique. |
| `editor.references.count_one` | {count} référence | {count} reference | Barre d'outils, décompte sans recherche | nouveau | |
| `editor.references.count_other` | {count} références | {count} references | Barre d'outils, décompte sans recherche | nouveau | |
| `editor.references.count_of_one` | {count} référence sur {total} | {count} reference of {total} | Barre d'outils, décompte avec recherche | nouveau | |
| `editor.references.count_of_other` | {count} références sur {total} | {count} references of {total} | Barre d'outils, décompte avec recherche | nouveau | |
| `editor.references.reorder_hint` | Pour réorganiser, affichez l'ordre de la fiche sans recherche. | To reorder, show the sheet order without a search. | Onglet Références, sous la barre d'outils quand « Monter » et « Descendre » sont absents | nouveau | |
| `editor.references.no_result` | Aucune référence ne contient « {q} ». | No reference contains “{q}”. | Onglet Références, état sans résultat | nouveau | {q} est le texte tapé, rogné. |
| `editor.references.no_result_scope` | La recherche porte sur la citation, le DOI et l'URL. | The search covers the citation, the DOI and the URL. | Onglet Références, état sans résultat | nouveau | |
## 2. Clés retirées
Aucune n'est lue par le code (recherche faite sur `src`, `tests` et `e2e`, `editor-equine` compris).
| Clé | FR | EN (provisoire) | Où | Statut | Notes |
|---|---|---|---|---|---|
| `editor.references.open` | Références | References | Bouton « Références » de l'en-tête (supprimé, remplacé par l'onglet) | retiré | |
| `editor.references.cited_by` | Citées par « {name} » ({count}) | Cited by « {name} » ({count}) | Ancien panneau latéral, puce de filtre (supprimée) | retiré | |
| `editor.references.show_all` | Tout afficher ({count}) | Show all ({count}) | Ancien panneau latéral, lien de retour (remplacé par `panel_show_all`) | retiré | |
| `editor.references.no_match` | Aucune référence ne correspond. | No reference matches. | Ancien panneau latéral, état sans résultat (remplacé par `no_result`) | retiré | |
## 3. Ambiguïtés de vocabulaire
1. « famille » contre « Catégorie ». La pastille d'un citant dans une tuile ouverte dit « famille »
(`editor.references.family`, choix A4 de REVUE). L'éditeur dit encore « Catégorie »
(`editor.element.category`) dans le détail d'un constat et dans les listes. Les deux mots désignent le même
objet jusqu'à la correction U2b F7, qui doit harmoniser. À trancher avant F7 : lequel des deux reste.
2. « Retirer » contre « Retirer de ce constat ». « Retirer » (`editor.action.remove`) est le bouton du détail
d'un constat ou d'une famille : il retire la citation de l'élément affiché. « Retirer de ce constat » est le
bouton de la tuile dans le panneau : même effet, nommé pour sa portée parce que le panneau montre des
références, pas un constat.
3. « Défaire » contre « Annuler ». « Défaire » (`editor.history.undo`) est l'historique de l'éditeur : après
« Retirer de ce constat », un seul « Défaire » rend la citation et le statut du constat. « Annuler »
appartient aux boîtes de dialogue (suppression, nettoyage, réparation) et abandonne sans toucher l'historique.
« Terminer » (`editor.references.done`) ferme la modification d'une tuile et ne s'appelle ni l'un ni l'autre.
Le même mot existe dans les relations (`relations.end.action`, « Terminer ») : écrans distincts, pas de
collision visible.
4. Singulier contre pluriel du verbe « Citée ». FR : « Citée 1 fois » (pas de « Cité » au masculin, la
référence est féminine). EN : « Cited 1 time » contre « Cited 2 times ».
5. « Saisie non appliquée : {field} ». {field} est le libellé du champ dont la valeur refusée a été
abandonnée : « Type », « Citation », « DOI » ou « Adresse web (URL) » (clés `editor.reference.*`,
existantes). Les parenthèses de « Adresse web (URL) » se lisent mal dans la phrase.
6. « URL » seul. La ligne de faits d'une tuile ouverte dit « URL » (`editor.references.url_label`), le
formulaire dit « Adresse web (URL) » : deux formes pour un champ.
7. Termes anglais proches de la terminologie de l'application. « finding » (déjà « Findings » pour l'onglet
Constats) et « family » (le formulaire anglais dit « Category » : même objet, deux mots, voir 1) ; « reference »
désigne la bibliographie, jamais une référence de fiche ou de vue ; « Cited references » (panneau) contre
« References » (onglet) ; « Entry not applied » : « Entry » peut se lire comme une entrée de liste. « Done »
(EN) contre « Terminer » (FR) : le verbe anglais est moins précis.
8. « Aucun » et « Aucune ». DOI absent : « Aucun » ; URL absente : « Aucune ». L'accord suit le genre, la
cohérence visuelle est faible.
## 4. Comportement visible en attente du propriétaire
- **Tuile d'ajout sans bouton d'annulation.** La tuile « Ajouter une référence » ne se referme que par l'ajout
(planche 24 E ne montre pas de bouton d'annulation). La question a été posée au propriétaire le 2026-11-12 et
reste sans réponse : en attendant, un brouillon d'ajout ne s'abandonne pas par un bouton. Ce qu'il devient quand on
change d'onglet ou recharge la page n'est pas documenté ici (non vérifié).
Un bouton « Annuler » ajouterait une clé et une ambiguïté de plus avec « Défaire » (voir 3).
- **Aucun libellé EN ratifié.** Voir la note de tête.
+32
View File
@@ -171,6 +171,38 @@ The criteria below are the contract as written.
### R2 — The Références tab (D1 to D4)
Status (2026-11-12): built on `feature/v1-2-anatomical-sheets`, awaiting the owner's validation (nothing merged,
nothing deployed). Commits: `65a8fd3` (plan, rev 4 after the owner's GO), `fc3fec7` R2.0 (the panel's place renamed
`citations`), `4499bc7` R2.1 (fifth tab, panel from a finding), `c21995b` R2.2 (collapsible tiles), `3baac4d` R2.3
(search, sort, count, add), `8db6f42` R2.4 (contextual panel, board 25), `4b7d254` R2.5 (non-regression sweep).
Labels: `V1-2-6_R2_LABELS.md`. Decision record: BDR-114. What the build settled against the text below:
- The panel opens from a finding only (owner, 2026-11-12). The family's former trigger is removed; a family keeps
its inline list and « Retirer ».
- « Retirer de ce constat » removes that one citation (the reference stays in the document) and marks the finding
« À confirmer » (core rule, `edit.rs`); one « Défaire » restores the citation and the status together.
- Zero state: when the last citation is gone the panel stays open with « Ce constat ne cite plus aucune
référence. » and closes on a tab change.
- Selecting a tab closes the panel. Every close (✕, Escape outside a field, scrim, tab, « Aller à », « Tout
afficher », element gone) records one pending move applied after the exit: the focus goes back to the trigger,
else to the active tab button.
- A read-only flip (window under 1 024 px) keeps the panel open, in its read view.
- Motion goes through `motion/react` (slide in 180 ms, out 140 ms, none under reduced motion, callbacks still
fire), not through the Tailwind `motion-reduce:` text below: deviation approved by the owner, 2026-11-12.
- The Places area keeps a permanent `dvh` minimum height so that opening the panel never changes the document's
size; the panel fits the visible viewport at every scroll position.
- Limits: at 667 × 375 (landscape phone) and scroll 0 about 13 px of the panel show, because the trigger sits in
Places, itself below the fold, so a scroll comes first (the e2e skips that sample). A control below a field
whose blur-commit is refused can lose its first click, the error line shifting the layout: an editor-wide
pattern, not a regression, left out of R2. `admin.spec.ts` crashes during axe (« Target crashed ») under the
accumulated sandbox grants, not an R2 regression (`BROWSER_TESTS.md` §6). The add draft's missing cancel
control is an open question to the owner (`V1-2-6_R2_LABELS.md` §4).
- Gates at `4b7d254`: typecheck, lint, `test:run` (app 1488), build, `e2e:ui` 251; `e2e:shell` sweep of 21 specs
without `editor-equine`: 219 passed, 116 skipped, 3 failed (all `admin.spec.ts`), full-row guard clean.
`editor-equine.spec.ts` was updated for typecheck and never run.
Original plan text:
- Tab model: `EDITOR_TABS` gains `references` between `findings` and `verification` (`apps/app/src/editor/tabs.ts:6-11`),
`SHOWN.small` keeps it under « Plus » (:18). The id collides with the panel's `data-place` name `references`: the
panel place is renamed first (internal name, no visible effect). Touched with it: `navigation.ts` `targetOfKey`