docs(docs): record the R2 finish and its trial steps

This commit is contained in:
bchanot committed 2026-11-13 22:41:01 +01:00
1 parent dfc8965844
commit 89acdfd4fd
6 files changed
+208 -35

No files matched your search

+26 -20
View File
@@ -10,7 +10,7 @@ engines are installed. The suites live in `apps/app/e2e`.
| Command | Backend | Dev server | Content |
|---|---|---|---|
| `pnpm e2e:ui` | none | Vite on `127.0.0.1:5191` | `e2e/ui/dialog.spec.ts`: the D13 contract of the shared Dialog on a test page; `e2e/ui/working-copy.spec.ts`: the real `WorkingCopyAction` and its dialog on a test page (axe, layout, keyboard, fr and en, desktop and 375 px); `e2e/ui/local-tool.spec.ts`: the disclaimer, edit and replace dialogs on the real local-tool routes |
| `pnpm e2e:shell` | the isolated stack of `pnpm db:sandbox` | Vite on `127.0.0.1:5192` | `e2e/shell/shell.spec.ts`: sign-in, dashboard, the account photo confirmation, the phone drawer; `e2e/shell/clients.spec.ts`: the client journeys (V1-1.5); `e2e/shell/animals.spec.ts`: the animal and relation journeys (V1-1.6, contract §11.8); `e2e/shell/responsive.spec.ts`: no sideways scroll on nine shell pages, the archive confirmations and the drawer at 320, 360, 375, 390 and 430 px (phone project) and 1280 px, long values, the dashboard e-mail shown whole (RESP-01); `e2e/shell/admin.spec.ts` (V1-2.5): A0 the owner's bootstrap (two TOTP factors from Sécurité, the step-up at `/app/admin` and inside a factor action, no second factor from `aal1`, refresh keeping `aal1` and `aal2`, rights granted and revoked with their reason), A1 a sheet created by an editor on a new inactive species, S1 a species created inactive then activated by the owner, the creation page when the own-grants read fails (« Impossible de vérifier vos autorisations » and « Réessayer », never the form; Retry brings the form back), access per right (a reviewer-only account refused on the creation page), axe and no sideways scroll on every admin page; `e2e/shell/catalogue.spec.ts` (V1-2.5): P1 a reader searches, opens a sheet, picks a zone, reads a retired version, drafts and archived sheets never listed, the same refusal for an existing and an unknown sheet without access, 320, 375 and 430 px with the whole drawing in the box at opening; at 320 and 375 px the zone panel's live region present before a pick and naming the picked zone, the « Références » card starting at or below the drawing's bottom; `e2e/shell/editor-*.spec.ts` (V1-2.6, the draft editor level 1, contract C16 to C34): `editor-drawings` (A2: a hostile file refused with no cleaning box, an Inkscape export cleaned after its preview, a valid file attached, a detail view by crop, the same bytes attached twice), `editor-annotations` (A3: points, zones and links by clicks and by keyboard only, move by drag, a click with jitter never moves, numeric edits, undo and redo, review and delete), `editor-geometry` (a click near a frame edge with the corrected position confirmed and cancelled, an inherited out-of-frame point repaired through the geometry group, a crop change refused when it would invalidate a point, an unmeasured view with its tools disabled, touch-action and a touch drag in real Chromium), `editor-structures` (A4: categories, references, regions, findings tree, reorder, mark reviewed, delete with dependents), `editor-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, cLine truncated
| `pnpm e2e:shell` | the isolated stack of `pnpm db:sandbox` | Vite on `127.0.0.1:5192` | `e2e/shell/shell.spec.ts`: sign-in, dashboard, the account photo confirmation, the phone drawer; `e2e/shell/clients.spec.ts`: the client journeys (V1-1.5); `e2e/shell/animals.spec.ts`: the animal and relation journeys (V1-1.6, contract §11.8); `e2e/shell/responsive.spec.ts`: no sideways scroll on nine shell pages, the archive confirmations and the drawer at 320, 360, 375, 390 and 430 px (phone project) and 1280 px, long values, the dashboard e-mail shown whole (RESP-01); `e2e/shell/admin.spec.ts` (V1-2.5): A0 the owner's bootstrap (two TOTP factors from Sécurité, the step-up at `/app/admin` and inside a factor action, no second factor from `aal1`, refresh keeping `aal1` and `aal2`, rights granted and revoked with their reason), A1 a sheet created by an editor on a new inactive species, S1 a species created inactive then activated by the owner, the creation page when the own-grants read fails (« Impossible de vérifier vos autorisations » and « Réessayer », never the form; Retry brings the form back), access per right (a reviewer-only account refused on the creation page), axe and no sideways scroll on every admin page; `e2e/shell/catalogue.spec.ts` (V1-2.5): P1 a reader searches, opens a sheet, picks a zone, reads a retired version, drafts and archived sheets never listed, the same refusal for an existing and an unknown sheet without access, 320, 375 and 430 px with the whole drawing in the box at opening; at 320 and 375 px the zone panel's live region present before a pick and naming the picked zone, the « Références » card starting at or below the drawing's bottom; `e2e/shell/editor-*.spec.ts` (V1-2.6, the draft editor level 1, contract C16 to C34): `editor-drawings` (A2: a hostile file refused with no cleaning box, an Inkscape export cleaned after its preview, a valid file attached, a detail view by crop, the same bytes attached twice), `editor-annotations` (A3: points, zones and links by clicks and by keyboard only, move by drag, a click with jitter never moves, numeric edits, undo and redo, review and delete), `editor-geometry` (a click near a frame edge with the corrected position confirmed and cancelled, an inherited out-of-frame point repaired through the geometry group, a crop change refused when it would invalidate a point, an unmeasured view with its tools disabled, touch-action and a touch drag in real Chromium), `editor-structures` (A4: categories, references, regions, findings tree, reorder, mark reviewed, delete with dependents; 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 asidLine truncated
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.