diff --git a/CLAUDE.md b/CLAUDE.md index 11341790..92272bae 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 diff --git a/docs/development/BROWSER_TESTS.md b/docs/development/BROWSER_TESTS.md index a7229bda..67bbb68f 100644 --- a/docs/development/BROWSER_TESTS.md +++ b/docs/development/BROWSER_TESTS.md @@ -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+Z outside and inside a field, « Aller à » for each issue kind, the save line from the count to « Enregistrement… » to the time and revision), `editor-shell-crossing` (every edit-only part typed, a 1 024 px crossing, no edit control and the focus on the shown tab, widening with the values back; the section and the panel open; unsaved work and the recovery copy kept; a drag across the crossing commits nothing; delete and discard confirmations closing; a decision withheld under the panel waiting for « Reprendre »), `editor-shell-layout` (no sideways scroll at 1 024, 1 180, 1 279 and 1 280 px on the four tabs, the sections and the panel, and at 320, 375 and 768 px read-only; axe from the top on every place; the canvas width without and with the panel as `canvas-width` and `canvas-width-panel` annotations; the keyboard order header, tab list, « Défaire », « Refaire », the panel when open, then tools, canvas and side column); the equine spec also times commit to paint with every place visited. Editor accounts, drafts and drawings are prepared by `e2e/support/editor.ts` (a drawing in its stored form, written by the core); `e2e/support/warm-up.ts` is the suite's global setup (the dev server reloads the page once when a route first loads a dependency, so one throwaway session visits the editor routes before the tests). Editing needs 1 024 px: these specs skip the 375 px project | +| `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 « Défaire », Ctrl+Z outside and inside a field, « Aller à » for each issue kind, the save line from the count to « Enregistrement… » to the time and revision), `editor-shell-crossing` (every edit-only part typed, a 1 024 px crossing, no edit control and the focus on the shown tab, widening with the values back; the section and the panel open; unsaved work and the recovery copy kept; a drag across the crossing commits nothing; delete and discard confirmations closing; a decision withheld under the panel waiting for « Reprendre »), `editor-shell-layout` (no sideways scroll at 1 024, 1 180, 1 279 and 1 280 px on the five tabs, the sections and the citations panel, and at 320, 375 and 768 px read-only; axe from the top on every place; the canvas width without and with the panel as `canvas-width` and `canvas-width-panel` annotations; the keyboard order header, tab list, « Défaire », « Refaire », the panel when open, then tools, canvas and side column); the equine spec also times commit to paint with every place visited. Editor accounts, drafts and drawings are prepared by `e2e/support/editor.ts` (a drawing in its stored form, written by the core); `e2e/support/warm-up.ts` is the suite's global setup (the dev server reloads the page once when a route first loads a dependency, so one throwaway session visits the editor routes before the tests). Editing needs 1 024 px: these specs skip the 375 px project | 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 diff --git a/docs/development/RUST_ARCHITECTURE_REVIEW.md b/docs/development/RUST_ARCHITECTURE_REVIEW.md index 1fabc9bc..80cf9a52 100644 --- a/docs/development/RUST_ARCHITECTURE_REVIEW.md +++ b/docs/development/RUST_ARCHITECTURE_REVIEW.md @@ -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`. --- diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md index a183ec7e..e479d9cf 100644 --- a/docs/development/V1-2-6_OWNER_TRIAL.md +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -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 : diff --git a/docs/development/V1-2-6_R2_LABELS.md b/docs/development/V1-2-6_R2_LABELS.md new file mode 100644 index 00000000..08397837 --- /dev/null +++ b/docs/development/V1-2-6_R2_LABELS.md @@ -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. diff --git a/docs/development/V1-2-6_U1_CORRECTIONS.md b/docs/development/V1-2-6_U1_CORRECTIONS.md index 101600fb..5b578427 100644 --- a/docs/development/V1-2-6_U1_CORRECTIONS.md +++ b/docs/development/V1-2-6_U1_CORRECTIONS.md @@ -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`