From 89acdfd4fdcc61286911835245bdd7c65b931492 Mon Sep 17 00:00:00 2001 From: bchanot Date: Fri, 13 Nov 2026 22:41:01 +0100 Subject: [PATCH] docs(docs): record the R2 finish and its trial steps --- CLAUDE.md | 6 +- docs/design/README.md | 15 ++++ docs/development/BROWSER_TESTS.md | 46 +++++++----- docs/development/V1-2-6_OWNER_TRIAL.md | 89 +++++++++++++++++++---- docs/development/V1-2-6_R2_LABELS.md | 22 +++++- docs/development/V1-2-6_U1_CORRECTIONS.md | 65 +++++++++++++++++ 6 files changed, 208 insertions(+), 35 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 92272bae..6f115685 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -216,6 +216,7 @@ faunosteo/ │ ├─ 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) +│ ├─ editor/history/{entry,useEditorHistory}.ts + editor/{findingLayer,useReferenceMoves}.ts ← R2 finish: the editor view in the browser history (entries carry sheet and account ids, navigation only; pure planning of push / replace / back, write budget; the reconcile hook), the finding layer and the reference moves │ ├─ 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 @@ -254,7 +255,10 @@ 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/references/{ReferenceTiles,ReferenceTile,ReferenceFacts,ReferenceToolbar,NoResult,CitersList,CitationsPanel,CitationsSheet,ReferenceDialog,ReferenceForm}.tsx + use{ReferenceView,ReferenceLibrary,TileState,CitationsPanel}.ts ← V1-2.6 R2 and finish: read-only tiles, toolbar with the finding filter chip, the citations modal side sheet opened from a finding, the reference dialog and its form, their view and tile state hooks +│ │ ├─ editor/findings/{FindingDialog,FindingView,FindingEditForm,FindingCreateForm,FindingActions,FindingCitations,DiscardConfirm,ReadOnlyNotice,useDirtyGuard}.tsx ← R2 finish: the finding dialog (view and transactional edit modes, creation), discard confirmation, dirty guard +│ │ ├─ editor/useMoreMenu.ts ← R2 finish: « Plus » overlay state, dismiss (Escape, outside press) and the CloseWatcher back request +│ │ ├─ ui/afterModalsClosed.ts ← R2 finish: runs a callback once no `dialog[open]` remains (focus landings, queued announcements) │ │ ├─ 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) diff --git a/docs/design/README.md b/docs/design/README.md index fa8ac48a..66e25064 100644 --- a/docs/design/README.md +++ b/docs/design/README.md @@ -151,3 +151,18 @@ view-only sort; contextual references panel opened from a finding only (34 rem, « Désélectionner » and the Escape priority; phone « Plus »; generic admin sheet list and home card; catalogue card in integrity failure. Once validated they replace board 11 of `v1-2-6/` as the references reference. Plan and open arbitrations: `docs/development/V1-2-6_U1_CORRECTIONS.md`; review, labels and points: `v1-2-6-r0/REVUE.md`. + +2026-11-13: R2 finish. No new mockup was made. The owner brief « finition R2 » plus the owner's gate of the same day +validated the plan's R2F-9 changes to the ratified R2 screens (boards 23 to 27, `v1-2-6-r0/`). The design reference for +these screens is now the code plus `docs/development/V1-2-6_U1_CORRECTIONS.md` §R2 (« Finition 2026-11-13 »). The six +approved changes: +1. Transactional forms in the finding and reference dialogs: one undoable operation per save (BDR-050 re-planned). +2. The citations panel becomes a modal side sheet over the finding dialog, still opened from a finding only (D2, boards 24 + and 25, P16 and P17); its section geometry and the landscape cramped exception are gone. +3. The editor's view layers (tab, section, finding dialog, sheet, reference dialog, filter) live in the browser history, + navigation state only, never typed data, personal searches or drafts (A2). +4. « Tout afficher dans l'onglet Références » filters the tab by the finding, with a removable chip (A3). +5. « Plus » opens as an overlay dropdown (board 27 A), closed first by the Android Back request where the browser + offers it. +6. No new mockups for such changes: the owner brief and the gate stand as validation. +Not changed: the clients and animals list searches are not kept in browser history (BDR-078 stands). diff --git a/docs/development/BROWSER_TESTS.md b/docs/development/BROWSER_TESTS.md index 415f7c4e..588c2af6 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-references` (R2: cancel adding by button and by Escape, a tile edited out of the search), `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` (667 × 375 reached by touch, and the worst case placed by script; 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 | +| `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; since the finish findings and references go through their dialogs, the delete dialog stacked over the finding dialog), `editor-references` (R2 and finish: read-only tiles, the reference dialog from « Modifier » and « Ajouter » with axe, its draft and its read-only flip, a tile edited out of the search keeping its place), `editor-journey` (the steps of `V1-2-6_OWNER_TRIAL.md` §4 with two editor accounts, a finding created through its dialog and the dialog closed before the next add: 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` (the finding dialog and the citations sheet scanned by axe at the widths; 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 sheet over the finding dialog (Escape closes the sheet, a second one the dialog, a third deselects) 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 sheet and the finding dialog closed between visits since the finish; 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` (the Références tab keeping its search; 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` (a finding opening in its dialog in view mode, the row holding the focus once closed; 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` (the findings creation form kept in its dialog while narrow, draft, focus and a notice kept; 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` (since the finish the citations sheet replaces the panel: its width, no document size change, the Tab order kept inside the sheet, the whole screen at 667 × 375 through a rotation, the cramped-landscape and swipe-reach cases gone; before: 667 × 375 reached by touch, and the worst case placed by script; 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-history` (finish, R2F-1: tabs, an Annotations section, « Retour au dessin », arrow-key walks as one entry, the scroll offset, a reload, a DeleteDialog open at Back), `editor-finding-dialog` (finish, R2F-3: click, Enter and Space opening it, a pristine and a changed « Enregistrer », « Abandonner » and a width flip keeping the draft, a dirty Escape and Back asking, deletion landing on the nearest row, creation as a layer, a vanished element, Back and Forward walking the layers), `editor-reference-journey` (finish, R2F-5 and R2F-6: the owner's eight steps at 1280 and 375 px, every Back, a reload keeping the filtered tab and chip but no form, the chip × removing the filter by replace, a double click and a held Escape popping one entry, a dirty reference dialog kept across Back) and `editor-more-menu` (finish, R2F-7: the « Plus » overlay at several widths with axe, closing on a choice, an outside tap and Escape; the sidebar fixed at 1280 and 1024 px and scrolling alone at 1280 × 500). 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` @@ -68,21 +68,25 @@ 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-references.spec.ts` covers the Références tab. Tiles: closed and open with axe in each state; the +reference dialog from « Modifier » and « Ajouter » (axe, draft kept, read-only flip) since the R2 finish, which replaced +the inline edit view and the add tile; 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; an +edited tile 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. +`e2e/shell/editor-citations.spec.ts` covers the citations of a finding, a modal side sheet over its dialog since the R2 +finish (2026-11-13; the cramped and geometry cases of the panel are gone). Editing: the sheet opens over the finding +dialog, « Retirer de ce constat » then one « Défaire », the saved status; a long list scrolls inside the sheet and +the page never moves; the last citation gone keeps the sheet with its line, Escape closes it and the dialog stays; +« Tout afficher » closes both layers, clears the search, keeps the sort and the open tiles, and Back returns to the +sheet; « Modifier » opens the reference dialog over the sheet and « Enregistrer » closes it only, with one undo; a dirty +reference dialog keeps its draft on ✕ and on Back; the exiting sheet is inert and a second close finds nothing; +keyboard (Enter opens, Tab in order, Escape closes only the sheet); each close path (✕, Escape, the scrim, Back, +« Tout afficher », « Aller à ») 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; by touch, taps act on the +sheet only. 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 @@ -92,7 +96,9 @@ bottom on the viewport bottom through a height change and a rotation, the drawin `e2e/support/editor.ts` gains `openTab` (a tab at any width, through « Plus » below 640 px), `libraryRoot` (the Références tab's place), `openCitations` (optional expansion budget, waits for the heading focus) and `closeCitations`; `openReferences` and `closeReferences` are gone, and the warm-up (`e2e/support/warm-up.ts`) -opens the citations panel instead. +opens the citations panel instead. The finish adds `findingDialog`, `referenceDialog`, `openFinding`, `closeFinding`, +`showCitations`, `startReference`, `addReference`, `referenceSettled`, `layersSettled`, `revealFinding` and +`expectNoDialog`. 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 @@ -218,8 +224,8 @@ suite needs Docker in the runner for the sandbox. rows: capped (2 526 grants) 16 passed, 0 failed; full (2 551) 11 passed, 5 failed, 4 « Target crashed »; capped again (2 570) 16 passed, 0 failed. Still failing on the accumulated sandbox: A0 « the rights screen with grants » and « admin screens » (fr or en, desktop and 375). The cure, a paginated grant list, is RR-13; BLK-015 - stays open. Rerun the spec alone to separate a crash from a real failure: that isolated run is a diagnosis, - never the gate. + stays open. Unchanged by the R2 finish (2026-11-13). Rerun the spec alone to separate a crash from a real failure: + that isolated run is a diagnosis, never the gate. - The layout spec covers the landscape 667 × 375 sample in two parts, in one test of the phone project. The citations trigger sits at 811 to 855 px at scroll 0. (A) Touch only: CDP `Input.dispatchTouchEvent` swipes of 200 px (`Input.synthesizeScrollGesture` with `touch` scrolls nothing in this Chromium) until the trigger is wholly on @@ -228,8 +234,8 @@ suite needs Docker in the runner for the sandbox. bottom on the viewport bottom (gap 0, scrollY 480); a tap opens the panel, heading and ✕ in view and hit-testable, scrollY unchanged. B is programmatic because a touch swipe under about 60 px scrolls nothing (slop) and the gain varies under load, so a pixel-exact touch landing is not reproducible (an earlier calibrated version oscillated - by 55 px in the full sweep). Remaining exception: the - rotation to 667 × 375 with the panel open at scroll 0 keeps a cramped view (not built, an option for the owner). + by 55 px in the full sweep). The remaining exception (the + rotation to 667 × 375 with the panel open at scroll 0) is gone with the finish: the panel is a modal side sheet. - 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. diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md index 2eb980da..9c762721 100644 --- a/docs/development/V1-2-6_OWNER_TRIAL.md +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -344,6 +344,59 @@ pile d'essai et les vérifications sont les vôtres. Chaque étape donne l'actio le bas au doigt jusqu'à « Références citées » sous le constat, puis touchez ce bouton. Attendu : le panneau s'ouvre, son titre et ✕ sont visibles et touchables, sans que la page ait bougé. +### 4.11 Finition R2 +À dérouler sur la fiche de 4.9 et 4.10, qui porte un constat A citant au moins deux références. Cette finition +remplace l'édition en ligne des tuiles et le panneau de 4.10 : là où 4.10 et 4.11 diffèrent, 4.11 fait foi. Libellés : +`V1-2-6_R2_LABELS.md` §5 à §7. Rien dans ce parcours n'est lancé par Claude. Chaque étape donne l'action, puis +l'attendu. Les étapes 1 à 11 se font à 1 280 px, les étapes 12 à 14 sur téléphone. +1. Le parcours en huit temps. Action : onglet « Constats » ; ouvrez le constat A ; cliquez « 2 références » ; dans le + volet, cliquez « Tout afficher dans l'onglet Références » ; regardez l'onglet ; appuyez sur Précédent du navigateur. + Attendu : le volet des références citées s'ouvre à droite ; l'onglet « Références » n'affiche que les deux + références du constat A, sous la pastille « Références du constat : A » avec son « × » ; Précédent ramène au constat + A, volet ouvert, dans l'état où vous l'aviez quitté. Un second Précédent ferme le volet, un troisième ferme le + constat, sans quitter l'éditeur. Suivant refait le chemin. +2. Ajouter un constat. Action : « Constats », bouton d'ajout, remplissez les noms, « Créer ». Attendu : la fiche du + nouvel élément s'ouvre en lecture dans la boîte de dialogue ; Précédent revient à l'arbre. +3. Modifier un constat. Action : ouvrez un constat, « Modifier », changez un nom et une description. Attendu : rien + n'est écrit tant que vous n'avez pas cliqué « Enregistrer » ; « Défaire » (en haut) est hors d'atteinte pendant que la boîte + est ouverte. +4. Annuler avec une modification. Action : même formulaire, changez un champ, cliquez « Annuler » (puis refaites avec + Échap, puis avec Précédent). Attendu : « Abandonner les modifications ? » avec « Continuer la saisie » (focalisé) + et « Abandonner » ; « Continuer la saisie » garde votre texte ; « Abandonner » revient à la lecture sans rien + écrire. Sans modification, « Annuler » revient directement. +5. Enregistrer puis défaire. Action : changez deux champs, « Enregistrer », fermez la boîte, cliquez « Défaire ». + Attendu : « Modifications enregistrées » après l'enregistrement ; un seul « Défaire » rend les deux champs + ensemble (une opération par enregistrement) ; « Refaire » les remet. +6. Ajouter une référence. Action : onglet « Références », « Ajouter une référence », type et citation, « Enregistrer ». + Attendu : une boîte de dialogue ; un champ obligatoire vide est refusé sur le champ ; une adresse hors http(s) + aussi ; la ligne « Référence ajoutée : … » avec « Afficher » ; la liste ne bouge pas (la tuile est en fin de liste). +7. Modifier une référence. Action : ouvrez une tuile, « Modifier », changez la citation, « Enregistrer ». Attendu : + les tuiles sont en lecture seule (disclosure, « Modifier », « Supprimer » ou l'aide d'une référence citée) ; après + l'enregistrement la tuile garde sa place dans la liste, avec recherche, tri et tuiles ouvertes inchangés. +8. Le filtre. Action : refaites le chemin de l'étape 1 jusqu'à l'onglet filtré, tapez dans la recherche, changez le + tri, cliquez le « × » de la pastille. Attendu : recherche et tri restent utilisables dans le filtre ; « × » rend + toutes les références ; « Revenir au constat » rouvre le constat A tant que le filtre est posé. +9. Recharger. Action : sur l'onglet filtré, rechargez la page (F5). Attendu : l'onglet et la pastille sont gardés ; ni + formulaire ouvert ni texte de recherche ; Précédent ramène alors au volet. +10. Historique et comptes. Action : ouvrez le constat A, changez de fiche (ou déconnectez-vous puis connectez un autre + compte), puis appuyez sur Précédent. Attendu : aucune boîte ni aucun filtre d'une autre fiche ou d'un autre + compte ne revient : l'historique repart de zéro. +11. Menu latéral. Action : à 1 280 px, défilez une page longue (Constats avec beaucoup de lignes). Attendu : le menu de + gauche reste en place ; fenêtre basse (500 px), il défile seul sans dépasser. +12. « Plus » sur téléphone. Action : sous 640 px, touchez « Plus ». Attendu : une liste se déroule sous la rangée + d'onglets sur toute la largeur, sans rien décaler, avec un fondu léger ; choisir une entrée la ferme et ouvre + l'onglet. +13. Fermer « Plus ». Action : ouvrez « Plus », puis (a) touchez hors du menu, (b) rouvrez et utilisez le geste ou le + bouton Retour d'Android. Attendu : (a) le menu se ferme et la page ne reçoit pas ce toucher ; (b) Retour ferme le + menu d'abord, sans changer de page ; un second Retour agit comme d'habitude. Point non prouvé sur appareil : voir + les limites. +14. Limites sur téléphone. Action : (a) limite 1 : supprimez un constat depuis son dialogue, puis appuyez une fois sur + Retour ; (b) limite 6 : avec « Plus » ouvert, si Retour ne le ferme pas, notez le navigateur et sa version ; + (c) limite 7 : « Plus » ouvert, touchez un bouton de la page. Attendu : (a) rien de visible la première fois, la + seconde remonte l'historique ; (b) un navigateur sans `CloseWatcher` laisse Retour naviguer, Échap et le toucher + extérieur ferment quand même ; (c) le toucher ne ferme que le menu, il faut le renouveler pour agir sur le + bouton. Dites si l'un de ces trois comportements vous gêne. + ## 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). @@ -401,19 +454,29 @@ pile d'essai et les vérifications sont les vôtres. Chaque étape donne l'actio datent du commit 81fba46 sur une pile neuve, pas du dernier commit. ### Limites connues de R2 -- Annuler ou refaire qui remplace une saisie en attente dans une vue montée la perd. Deux saisies perdues lors - d'un même passage en lecture seule : seule la dernière est annoncée. (« Défaire » ou « Refaire » qui retire une - référence dont la tuile porte une saisie refusée l'annonce désormais une fois, champs nommés ; un rechargement - complet de la page sort de ce cadre : la page disparaît, la copie locale de secours s'applique.) -- Sur un téléphone en paysage (667 × 375), le panneau ouvert en haut de page puis la rotation donnent une vue - à l'étroit (environ 13 px du panneau visibles) : cas non construit, une option à décider. Ouvert au toucher après - avoir défilé (étape 19), il est entièrement visible. -- 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. +La finition du 2026-11-13 (§4.11) retire trois limites : le panneau ouvert en haut de page puis la rotation en +667 × 375 (le volet est maintenant modal, sur toute la hauteur), les deux saisies refusées annoncées comme une seule, +et la saisie en attente perdue par « Défaire » ou « Refaire » (plus de saisie en ligne : les formulaires sont des +boîtes de dialogue transactionnelles, hors d'atteinte de « Défaire » tant qu'elles sont ouvertes). +Limites de la finition, acceptées par le propriétaire à condition qu'aucune modification ne soit perdue en silence : +1. Supprimer un constat remplace l'entrée de son dialogue : le Retour suivant ne montre rien une fois. +2. « Aller à » vers un autre onglet fait deux entrées d'historique (l'onglet, puis le dialogue). +3. Un geste fait dans le même instant qu'un Retour en cours peut être avalé (hors d'atteinte à vitesse humaine). +4. « Aller à » un constat ouvre son dialogue en lecture. +5. La recherche de l'onglet Références est abandonnée quand on change d'onglet ; Retour rend la vue filtrée. +6. Le Retour d'Android qui ferme « Plus » repose sur `CloseWatcher` (Chrome Android) : prouvé par un test à + doublure seulement, pas sur un appareil. Sans `CloseWatcher`, Retour navigue comme avant ; Échap et le toucher + extérieur ferment toujours. +7. Un toucher hors du menu « Plus » ouvert le ferme seulement : la page ne reçoit pas ce toucher. +8. Après un choix dans « Plus » au clavier, le focus va au corps de la page (comportement antérieur). +9. BLK-015 : `admin.spec.ts` échoue encore sur la pile cumulée (accumulation d'attributions, la pagination est + RR-13), inchangé par la finition. Il ne s'observe pas dans cet essai manuel. +Limites de R2 qui subsistent : +- 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 des formulaires en ligne de l'éditeur, non corrigé. +- Passer en lecture seule (fenêtre sous 1 024 px) avec un dialogue ouvert garde la saisie, champs en lecture seule et + « Enregistrer » inactif, avec une note ; seul « Abandonner » reste. +- Un rechargement complet de la page sort de ce cadre : la page disparaît, la copie locale de secours s'applique. ## 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`, diff --git a/docs/development/V1-2-6_R2_LABELS.md b/docs/development/V1-2-6_R2_LABELS.md index 556c4fef..bcdef62e 100644 --- a/docs/development/V1-2-6_R2_LABELS.md +++ b/docs/development/V1-2-6_R2_LABELS.md @@ -3,6 +3,9 @@ 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`), 47 lignes ci-dessous : 41 clés nouvelles, 2 modifiées, 4 retirées. Les deux dictionnaires portent les mêmes clés. +Ces totaux valent pour R2 seul, avant la finition. Les §5 à §7 donnent la finition du 2026-11-13 (`git diff +36c6eb3..HEAD -- apps/app/src/i18n`) : 18 clés nouvelles, 6 retirées, aucune modifiée. Les §1 et §2 sont l'état de R2, +pas l'état courant : les clés retirées en §6 y figurent encore. 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. @@ -117,7 +120,7 @@ Aucune n'est lue par le code (recherche faite sur `src`, `tests` et `e2e`, `edit ## 5. Finition du 2026-11-13 : dialogue des constats (tâche 2) -Neuf clés nouvelles dans `fr.ts` et `en.ts` (une ligne chacune), une clé retirée. Les libellés EN sont provisoires, +Dix clés nouvelles dans `fr.ts` et `en.ts` (une ligne chacune, la dixième, `editor.findings.draft_dropped`, en fin de tableau), une clé retirée. Les libellés EN sont provisoires, comme tous les autres. | Clé | FR | EN (provisoire) | Où | @@ -131,6 +134,7 @@ comme tous les autres. | `editor.findings.gone` | Ce constat n'existe plus | This finding no longer exists | Annonce quand l'élément d'un dialogue disparaît | | `editor.findings.flip_narrow` | Élargissez la fenêtre pour poursuivre : votre saisie est conservée. | Widen the window to continue: your entry is kept. | Dialogue, formulaire gardé quand la largeur passe sous 1 024 px | | `editor.findings.flip_blocked` | La modification n'est plus possible : votre saisie est conservée, vous pouvez seulement l'abandonner. | Editing is no longer possible: your entry is kept, you can only discard it. | Dialogue, formulaire gardé quand les droits, la revue ou l'archivage coupent l'édition | +| `editor.findings.draft_dropped` | Saisie abandonnée | Entry discarded | Annonce quand un dialogue ouvert est abandonné (« Abandonner », ou fermeture forcée par un changement de mode) ; réutilisée par le dialogue de référence | Retirée : `editor.live.references_closed` (« Références fermées »). La fermeture de la feuille n'est plus annoncée : le focus revient sur « n références » et la lecture d'écran le dit. @@ -165,3 +169,19 @@ Comportement modifié : « Tout afficher dans l'onglet Références » filtre la du propriétaire, 2026-11-13) ; le compteur se lit dans le filtre (« n références » sur celles du constat) ; le retour au constat dépile l'entrée du dessous quand elle montre ce constat, sinon rouvre son dialogue. Après une création, la liste ne bouge plus : la nouvelle tuile se trouve à la fin, « Afficher » y mène. + +## 7. Finition du 2026-11-13 : totaux et « Plus » (tâche 4) + +Les tâches 1 et 4 n'ajoutent ni ne retirent aucune clé : l'historique, les primitives de dialogue, le menu « Plus » en +surimpression et le menu latéral fixe réutilisent les libellés existants (`editor.tab.*`, `editor.tab.more`, +`editor.history.*`). + +Bilan de la finition sur `fr.ts` et `en.ts` (mêmes clés dans les deux) : +- 18 clés nouvelles : 10 sous `editor.findings.*` (§5), 7 sous `editor.references.*` et `editor.reference.url_invalid` + (§6), soit 10 + 8. +- 6 clés retirées : `editor.live.references_closed` (§5) ; `editor.references.draft_dropped`, `editor.references.done`, + `editor.references.add_help`, `editor.references.add_cancel` et `editor.reference.required` (§6). +- Solde : +12 clés dans chaque dictionnaire. +- Les §3 et §4 ci-dessus parlent de « Terminer », « Annuler l'ajout » et « Saisie non appliquée » : ces trois + libellés n'existent plus. Dans le §3, seuls les passages sur ces libellés sont périmés (ambiguïtés 3, 5 et 9) ; la + première puce du §4 l'est entièrement. diff --git a/docs/development/V1-2-6_U1_CORRECTIONS.md b/docs/development/V1-2-6_U1_CORRECTIONS.md index 3a20eddb..0e866d19 100644 --- a/docs/development/V1-2-6_U1_CORRECTIONS.md +++ b/docs/development/V1-2-6_U1_CORRECTIONS.md @@ -265,6 +265,71 @@ deletion): the accumulated sandbox: A0 « the rights screen with grants » and « admin screens » (fr or en, desktop and 375, the locale varies from run to run). The cure, a paginated grant list, belongs to RR-13; blocker BLK-015 stays open. +#### Finition 2026-11-13 + +Status: built on `feature/v1-2-anatomical-sheets` on top of `36c6eb3`, awaiting the owner's trial (nothing merged, +nothing deployed). Source: the owner brief « finition R2 » (items 1 to 9) and the plan +`.claude/tasks/plans/2026-11-13-r2-ux-finish-1624.md` (R2F-1 to R2F-9). Labels: `V1-2-6_R2_LABELS.md` §5 to §7. +Trial: `V1-2-6_OWNER_TRIAL.md` §4.11. Browser proofs: `BROWSER_TESTS.md`. + +Commits: +- Task 1, dialog primitives and editor history: `553a0e5`, `69e225c`, `792394d`, `8e4f026`. +- Task 2, finding dialog and citations side sheet: `18085ce`, `4731a33`, `c893dec`, `b703333`, `20905ad`, `af300de`, + `e2d020b`. +- Task 3, reference dialog, read-only tiles, filter by finding, owner journey: `8031e00`, `7a64daf`, `8b42816`, + `3bb3603`, `8a60128`. +- Task 4, « Plus » overlay and sticky sidebar: `ca5804a`, `dfc8965`. + +Behaviour: +- Dialogs. A finding opens in a modal dialog (view mode, then « Modifier »); a reference opens in its own dialog (edit + or create). Forms are transactional: « Enregistrer » writes one history entry (nothing when pristine), « Annuler » or + any close with a change asks « Abandonner les modifications ? » first. A save is one « Défaire ». Reference tiles + are read-only (disclosure, « Modifier », « Supprimer » or the cited hint). Focus returns to the opener. +- Side sheet. The citations panel is a modal sheet at the right edge (34 rem at most) stacked over the finding dialog, + usable by keyboard and touch. Content as before: read tiles, « Modifier », « Retirer de ce constat », « Aller à », + « Tout afficher ». +- History. Tab, Annotations section, finding dialog, finding creation, sheet, reference dialog, filter are browser + history entries (`apps/app/src/editor/history`). Back and Forward restore the view and the scroll; a reload keeps + tab and filter, never a form. Entries carry the sheet and account ids and hold navigation only; they are reset on a + sheet or account change. A Back that would drop a dirty form re-pushes the view and shows the confirmation. +- Filter. « Tout afficher dans l'onglet Références » shows only the references the finding cites, with the chip + « Références du constat : » and its « × », plus « Revenir au constat ». Search and sort stay usable. The + owner's eight steps (finding A, « 2 références », sheet, « Tout afficher », filtered tab, Back, back on A with the + sheet open) are proved at 1280 and 375 px. +- « Plus ». The menu is an overlay under the tab row (no layout shift, light fade), closed by a choice, an outside + press, Escape, a tab change and, where the browser offers `CloseWatcher`, the Android Back request. +- Sidebar. The left menu stays in place while the page scrolls (own scroll when taller than the window). + +Owner decisions (gate 2026-11-13): R2F-9 items 1 to 6 approved. Item 7: the clients and animals list searches are NOT +kept in browser history (BDR-078 stands). Precisions: one undoable operation per save; the side sheet usable by keyboard +and touch; history keeps navigation state, never typed data, personal searches or drafts; history reset on a sheet or +account change; the Android Back request closes « Plus » first; no new mockups; the limits below are accepted +provided no user change is lost silently. + +Stated limits: +1. Deleting a finding replaces its dialog entry, so the next Back press does nothing visible once (R2F-3). +2. « Aller à » to another tab makes two history entries (tab, then dialog). +3. A move made in the same instant as a pending Back can be swallowed (not reachable at human speed). +4. « Aller à » a finding opens its dialog in view mode. +5. The search filter of the References tab is dropped on a tab move; Back still restores the filtered view. +6. Android Back closing « Plus » relies on `CloseWatcher` (Chrome Android). Proved by a stub test only, not on a + device. Without `CloseWatcher`, Back navigates as before; Escape and an outside press still close. +7. A tap outside the open « Plus » menu only closes it (the page does not receive that tap). +8. After choosing a « Plus » entry by keyboard, focus goes to the page body (pre-existing). +9. BLK-015: `admin.spec.ts` still fails on the accumulated sandbox (grant accumulation; pagination is RR-13). + Unchanged by the finish. +Also stated in the plan: leaving the editor by Back past its first entry is unguarded (BDR-078, recovery copy); +Chromium's skippable-entry intervention and Android's close-watcher grouping of two restored dialogs are untested +(Playwright's `goBack` bypasses them) and are checked in the owner's phone trial. + +Gone with the finish, so struck from « Limits kept after the corrections » above: the cramped view after a rotation to +667 × 375 with the panel open at scroll 0 (the panel is now a modal sheet at full height); the two refused drops spoken +as one (`draft_dropped` for references and the inline drafts are removed); a pending draft lost by undo or redo in a +mounted edit view (no inline draft remains, « Défaire » and « Refaire » are unreachable while a dialog is open). Still +true: a button under a field whose blur-commit is refused can lose its first click (other inline editor forms). + +Status: awaiting the owner's trial (§4.11). Not run on a device: Android Back with a real `CloseWatcher`. + Original plan text: - Tab model: `EDITOR_TABS` gains `references` between `findings` and `verification` (`apps/app/src/editor/tabs.ts:6-11`),