From 3d6aacad9903798cc79e055c22dbc9f2193e7801 Mon Sep 17 00:00:00 2001 From: bchanot Date: Thu, 19 Nov 2026 21:15:41 +0100 Subject: [PATCH] docs(docs): rev 5 owner decisions, trial steps and test notes --- docs/ANNOTATION-RENDERING.md | 16 +++---- docs/development/V1-2-6_OWNER_TRIAL.md | 60 ++++++++++++++++++++------ docs/development/V1-2-6_UX_TESTS.md | 4 +- 3 files changed, 58 insertions(+), 22 deletions(-) diff --git a/docs/ANNOTATION-RENDERING.md b/docs/ANNOTATION-RENDERING.md index e134ab8e..8cd2a2b0 100644 --- a/docs/ANNOTATION-RENDERING.md +++ b/docs/ANNOTATION-RENDERING.md @@ -259,14 +259,14 @@ scroll nor a collapsing browser toolbar. The box is unchanged when the browser window (not the screen) is 1 024 × 768, 1 180 × 820 or 1 280 × 800, and smaller in shorter windows (capped below 672, 789 and 672 px of window height at those widths; a tablet's browser toolbars take their height off the screen's); a -capped box sits left, with spare width on its right. The 9.25 rem assumes one -row of view chips: a sheet whose chips wrap to a second row makes the column -about 38 px taller than the cap allows, so where the cap binds the column's -top goes under the strip at the end of the page. Its focusables carry only the bar's margin there (the -strip's margin, larger than the pinned top, would scroll the page on a focus of -a pinned control). Below 644 px of window height the tool column (365 px) no -longer fits beside a capped box: nothing is pinned or capped, and the drawing -scrolls under the strip as before, with the strip's margin on its focusables. +capped box sits left, with spare width on its right. The column's focusables carry +only the bar's margin there (the strip's margin, larger than the pinned top, would +scroll the page on a focus of a pinned control). The 9.25 rem +assumes one row of view chips: a sheet whose chips wrap to a second row makes the column +about 38 px taller than the cap allows, so where the cap binds the column's top goes +under the strip at the end of the page. Below 644 px of window height the tool column +(365 px) no longer fits beside a capped box: nothing is pinned or capped, and the +drawing scrolls under the strip as before, with the strip's margin on its focusables. The editor page's other focusables (criterion 25: the header's « Enregistrer », the tab row, « Défaire » and « Refaire », the notices' controls) carry a smaller margin, diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md index d783b05a..9162e926 100644 --- a/docs/development/V1-2-6_OWNER_TRIAL.md +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -686,6 +686,20 @@ d'essai (rôle `admin` et habilitation `sheet_editor`), double authentification `docs/design/v1-2-6-u2/` (arbitrages A1 à A15). U2 n'ajoute aucune migration : la pile garde ses données, l'application sert le code de cette branche. Claude n'écrit rien sur la pile d'essai : vous lancez vous-même les commandes. +Décisions du 19 novembre 2026, enregistrées telles que vous les avez prises : +- D1, validée : la raison d'un « Défaire » ou d'un « Refaire » indisponible s'affiche dans une petite bulle sous le + bouton, au toucher, à la souris et au clavier, sans rien déplacer. +- D2, validée : la marge de focus de l'éditeur (le focus clavier s'arrête sous la barre du haut) vaut à toutes les + largeurs, y compris sous 1 024 px. +- D3, validée : les modifications de `AppLayout.tsx`, `leaveGuardStore.ts`, `anchoredPlace.ts` et `layer.rs` sont + acceptées, comme justifiées par le périmètre de U2. +- D4, refusée : la pile d'essai de développement n'est pas réinitialisée ; ses données sont gardées et les limites de + vérification restent documentées (`V1-2-6_UX_TESTS.md`, U2). +- D5, acceptée avec réserve : les échecs des tests de bout en bout hors de l'éditeur ne bloquent pas cet essai. Ils ne + sont ni résolus ni tous formellement indépendants de U2 ; l'écart du catalogue (de quatre à six échecs) a été + vérifié sans rien détruire et n'est pas attribué à U2 (voir `V1-2-6_UX_TESTS.md`). +Votre remarque sur la bande des outils a mené à épingler le dessin sous la bande (étape 18). + Préparation. Une commande à la fois, depuis la racine du worktree : ```bash @@ -790,16 +804,30 @@ Tablette en paysage (au moins 1 024 px de large ; en dessous, l'éditeur est en 18. Tablette et fenêtres de 1 024, 1 180 et 1 280 px : la bande qui reste en haut. Action : faites défiler la page avec une annotation sélectionnée. Attendu : la bande reste entière sous la barre du haut, rien ne bouge et rien n'est caché derrière. Un Tab sur une commande de la bande ou sur un lien de la barre ne fait pas défiler la page. - Sur la tablette, faites défiler la page des annotations jusqu'à la fin : aucune partie du dessin, de ses boutons - de vue, de la rangée d'ajout ou de la ligne de message ne passe sous la bande. Si une partie y passe, notez-le : - la fenêtre fait alors moins de 644 px de haut. + Le dessin est épinglé sous la bande : à partir de 1 024 px de large et de 644 px de haut, la colonne du dessin + (boutons de vue, outils, dessin, rangée d'ajout, ligne de message) reste en place sous la bande pendant que la + liste de droite défile, et cette liste continue de passer sous la bande. Sur la tablette, faites défiler la page + des annotations jusqu'à la fin : aucune partie de la colonne ne passe sous la bande. Si une partie y passe, notez + la hauteur de la fenêtre et la vue : une fenêtre de moins de 644 px de haut n'épingle rien, mais le dessin peut + aussi passer sous la bande dans une fenêtre plus haute (boutons de vue sur deux rangées, colonne limitée par la + hauteur). Sur un vrai iPad, le dessin peut être plus petit et collé à gauche, avec une bande libre à sa droite : + c'est attendu, pas un défaut, car les barres du navigateur réduisent la fenêtre. Notez aussi tout + déplacement du dessin à l'écran quand vous sélectionnez une rangée, tout défilement sur le côté, et un Tab sur + un contrôle du dessin qui ferait défiler la page. 19. Refaire retenu. Préparez quelque chose à défaire et à refaire : créez un point, déplacez-le d'un pas aux flèches validé par Entrée, puis « Défaire ». Action : outil « Zone », posez un sommet (la boîte de « Point » s'ouvre tout de suite et cache l'en-tête : prenez « Zone »), puis donnez le focus à « Refaire » puis à « Défaire » : un lecteur - d'écran lit la raison. Appuyez dessus : la raison s'affiche sous le dessin et rien d'autre ne se passe. Puis + d'écran lit la raison. Appuyez dessus : la raison s'affiche dans une bulle sous le bouton et rien d'autre ne se passe. Puis « Annuler le tracé », reprenez l'outil « Sélectionner et déplacer », déplacez le point par deux flèches sans valider et cliquez « Refaire » à la souris : la raison s'affiche, la série reste en attente. Cliquez « Défaire » : la série est annulée, et « Refaire » remet le déplacement d'un pas. Sans rien à refaire, « Refaire » reste grisé sans phrase. +20. La bulle. Action : avec « Refaire » retenu (étape 19), appuyez dessus à la souris, au doigt, puis au clavier + (Entrée, Espace). Attendu : une bulle apparaît sous le bouton, entière dans la fenêtre et sous la barre du haut ; + rien ne bouge, ni le dessin ni la bande, et la page ne s'élargit pas. Elle se ferme quand la retenue prend fin, + quand vous changez d'onglet, quand le focus quitte le bouton, quand vous appuyez ailleurs, quand la page défile, + quand une boîte s'ouvre, et par Échap. Échap : le premier ferme la bulle seule ; le suivant fait ce qu'il faisait + (pendant une création, il demande « Abandonner la création ? »). Dans un champ de texte, Échap ferme la bulle et + atteint aussi le champ. Essayez sur un autre onglet que « Annotations » : la bulle s'y affiche aussi. #### Acceptés pendant la construction Vous avez accepté ces quatre comportements ; ils ne sont plus à juger : @@ -813,13 +841,19 @@ Ces points s'écartent des planches ou n'y figurent pas. Ils ont été tranchés chacun s'il vous convient. Interprétations et écarts par rapport aux planches : -- La raison d'un « Défaire » ou d'un « Refaire » indisponible s'affiche dans la ligne sous le dessin. Sur tablette, - page en haut, cette ligne est sous le bas de l'écran quand le bouton est visible (mesuré en 1 024 × 768, - 1 180 × 820 et 1 280 × 800 : bas de la ligne à y 893, 966 et 892). Un lecteur d'écran lit la raison au focus ; - à l'œil, un appui semble ne rien faire. Dites où placer cette raison : près du bouton, ou ailleurs. -- Un focus clavier sur l'onglet, « Enregistrer », « Défaire » ou « Refaire » s'arrête sous la barre du haut à toutes - les largeurs, y compris sous 1 024 px. Le contrat demandait que rien ne change sous 1 024 px ; avant, ce focus - pouvait rester caché sous la barre. Dites si vous gardez ce changement ou s'il faut le limiter aux grands écrans. +- La bulle de la raison d'un « Défaire » ou d'un « Refaire » indisponible (D1, décidée) : elle se pose sous la + rangée d'onglets, sous le bouton appuyé, large de 18 rem au plus. Tant que la bande s'affiche, son bord droit + s'arrête 4 px à gauche de la zone des commandes de la bande : elle peut donc se placer à gauche de son bouton + plutôt que juste dessous. Sans bande (autre onglet, ou sous 1 024 px), elle est juste sous le bouton. Elle ne + recouvre jamais « Défaire ». Elle se ferme quand la retenue prend fin, au changement d'onglet, quand le focus + quitte le bouton, à un appui ailleurs, au défilement de la page, à l'ouverture d'une boîte, et par Échap. Échap : + le premier ferme la bulle seule ; dans un champ de texte, il atteint aussi le champ. Dites si ces règles vous + conviennent. +- Le dessin épinglé (suite de votre remarque sur la bande) : la colonne du dessin reste sous la bande à partir de + 1 024 px de large et 644 px de haut ; dans une fenêtre plus courte que 672 px (1 024 et 1 280 px de large) ou 789 px + (1 180 px), le dessin est plus petit et collé à gauche ; sous 644 px de haut, rien n'est épinglé et le dessin passe + sous la bande comme avant. La liste de droite passe toujours sous la bande. Sur un iPad, les barres du navigateur + réduisent la fenêtre : le dessin peut y être plus petit que dans les mesures. Dites si cela vous convient. - « Reprendre le tracé » montre maintenant la zone fermée avec ses poignées, comme la planche 04 C. Pendant le glissé d'un sommet, le contour en attente reste en place et le contour glissé s'affiche en aperçu. On ne glisse pas la zone en attente par l'intérieur, et une forme reprise de plus de 40 sommets n'a pas de poignées. @@ -866,11 +900,11 @@ Interprétations et écarts par rapport aux planches : comme avant. Les trois phrases exactes : « Refaire est suspendu pendant la modification en cours : annulez-la avec Défaire pour pouvoir refaire. », « Refaire est suspendu pendant une création : abandonnez-la pour pouvoir refaire. » et « Indisponible pendant une création : créez l'annotation ou abandonnez-la. » Un appui sur un bouton - retenu affiche la raison sous le dessin et ne fait rien d'autre ; un appui à la souris n'enregistre plus une série + retenu affiche la raison dans la bulle et ne fait rien d'autre ; un appui à la souris n'enregistre plus une série en attente. « Défaire » pendant une modification en cours l'annule sans l'enregistrer, à la souris, au doigt ou par Ctrl+Z, et ce qui était à refaire le reste. Quitter la poignée par Tab enregistre la série, comme avant : il n'y a alors plus rien à refaire. Ctrl+Z ou Cmd+Z pendant une création reste muet. Sur un autre onglet, un appui - n'affiche rien : la raison est seulement lue au focus. + affiche aussi la bulle. - La touche « + » sur un sommet focalisé insère un sommet après lui, et Retour arrière retire comme Suppr. Après un Ctrl+Z, ces touches agissent sur la poignée qui a le focus. « + » sur la boîte du dessin zoome toujours. - La bande reste collée sous la barre du haut à partir de 1 024 px. La loupe peut se peindre par-dessus la bande près diff --git a/docs/development/V1-2-6_UX_TESTS.md b/docs/development/V1-2-6_UX_TESTS.md index 0944ee9f..0a877050 100644 --- a/docs/development/V1-2-6_UX_TESTS.md +++ b/docs/development/V1-2-6_UX_TESTS.md @@ -50,7 +50,7 @@ Implemented (contract `.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md`) ## U2 · Points and polygons -Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 4; boards `docs/design/v1-2-6-u2/`, A1 to A15 and the three adjustments). Rule numbers (R-n) are the plan's. Gates (plan Task 16) on the final head, 2026-11-19 (code at da8642dd, this page's figures added after): `pnpm check:all` exit 0 (app 2 140, core-wasm 67, supabase 182 tests, e2e:ui 253); the shell suite without `editor-equine.spec.ts` 330 passed, 17 failed, 5 not run, all in four files outside the editor: admin (6) and catalogue-integrity (6) failing with the same timeouts before U2 (sandbox data; the 56c75b1 baseline log has 4 catalogue-integrity failures), catalogue (3) and admin-sheets-list (2) failing only under the parallel run with « Target crashed » and passing 16/16 with one worker (`--workers=1`, 2026-11-19); `pnpm db:sandbox test` 105 passed, 10 skipped, and `test-db` Files=21 Tests=1958 FAIL on `014_animals_relations` (2) and `021_sheet_verification_jobs` (23), identical to before U2, which changes no SQL (run at 0aa0f6bc); `up fresh` is the owner's call; both opt-in measures rerun (figures in the Performance row). The owner trial is pending. The suites run on the sandbox only (`pnpm db:sandbox`). +Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 4 then rev 5 (owner decisions D1 to D5, 2026-11-19); boards `docs/design/v1-2-6-u2/`, A1 to A15 and the three adjustments). Rule numbers (R-n) are the plan's. Gates (plan Task 16) on the final head, 2026-11-19 (code at da8642dd, this page's figures added after): `pnpm check:all` exit 0 (app 2 140, core-wasm 67, supabase 182 tests, e2e:ui 253); the shell suite without `editor-equine.spec.ts` 330 passed, 17 failed, 5 not run, all in four files outside the editor (figures of the rev 4 code; figures on the final code to be added by the controller). These environment failures are named with their evidence and are not resolved; none is presented as formally independent of U2. Owner decision D5 (2026-11-19): they do not block the manual trial. `admin` (6): timeouts that the 56c75b1 baseline log also shows (sandbox data); no further attribution. `catalogue-integrity` (6): not attributed to U2. The pre-U2 commit 56c75b1 fails the same 6 of 6 tests, on the same assertion, with the same timings, on the same data (2026-11-19, one worker, read-only counts, nothing deleted); the published versions rose from 426 to about 690 in a day of runs, and the failing set grew from 4 to 6 in both trees, so volume is the inferred cause (the card list loads every card before the search narrows it past the 10 s wait). Volume causation is inferred from that trend and the identical baseline, not isolated: a low-volume run needs a reset, which D4 forbids. `catalogue` (3) and `admin-sheets-list` (2): « Target crashed » under the parallel run; both pass 16/16 with one worker (`--workers=1`, 2026-11-19); the logs show nothing more. `pnpm db:sandbox test` 105 passed, 10 skipped, and `test-db` Files=21 Tests=1958 FAIL on `014_animals_relations` (2) and `021_sheet_verification_jobs` (23), identical to before U2, which changes no SQL (run at 0aa0f6bc). The sandbox is never reset or rebuilt on this work (D4). Both opt-in measures rerun (figures in the Performance row). The owner trial is pending. The suites run on the sandbox only (`pnpm db:sandbox`). | Kind | Tests | |---|---| @@ -60,6 +60,8 @@ Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 4; boards ` | E2E mouse | drag a vertex, « + », « − », zone drag on a selected zone, redraw accepted, redraw refused by `interior_too_small` keeps and restores the old shape, undo and redo of each (`editor-zones.spec.ts`); a point: handle drag, size by a click on the track, the move mode (`editor-annotations.spec.ts`); the properties dialog opens over the right column and never over the drawing, a click on the veil does nothing, a double click on the selected zone opens it and inserts no vertex, a typed form then Back asks, a width crossing below 1 024 px keeps the draft (`editor-properties.spec.ts`); « Défaire » in the message line undoes the same entry as the header button, which carries the accessible name « Défaire la dernière modification » (T15; EN « Undo the last change »); during a held arrow series a mouse press on « Défaire » cancels it and « Refaire » restores the earlier move (`editor-annotations.spec.ts`); a Tab and Shift+Tab walk over the drawing place's native controls, and a keyboard Delete whose next vertex starts under the strip, land below the strip at 1 024, 1 180 and 1 280 px (`editor-geometry.spec.ts`) | | E2E touch (`hasTouch`, 1 024, 1 180, 1 280 px; CDP `Input.dispatchTouchEvent`) | one finger drags a vertex and the point under the loupe; every handle hit circle is at least 44 px; one finger off the handles moves nothing and shows the hint once, with no hint over a page scroll; two fingers zoom and pan; finger 1 on a vertex handle then finger 2: the drag is cancelled, the shape restored, nothing committed, the pinch zooms (Review Focus 1); the move mode by a finger; a tap on the selected shape opens the dialog and it stays open (Review Focus 5), with a chosen vertex it unchooses; the trace closes from a finger within 22 px; page scroll over the canvas with a selection and outside it (`editor-touch.spec.ts`, `editor-properties.spec.ts`, `editor-deselect.spec.ts`) | | Layout (A14) | `expectNoShift` (`e2e/support/layout.ts`) at 1 024, 1 180 and 1 280 px: no box of the canvas, the strip, the aside or the header moves, `scrollHeight` and the scrollbar gutter are unchanged, and the layout-shift sum is zero around selection, strip content, a message showing and expiring, the hint, a dialog opening and closing, mode entry and exit, and the first commit's save line; `scrollbar-gutter: stable` on the editor page only (`editor-annotations.spec.ts`) | +| Held reason bubble (D1, criterion 33) | unit (`editor-held-bubble.test.tsx`, `editor-history-buttons.test.tsx`): a press by click, Enter, Space, mouse and touch shows the reason in a portalled `position: fixed` bubble, with and without the strip's commands to clear; one announcement per press through an always-mounted `role="status"` region, `aria-describedby` kept; closing on the hold ending, a tab change, blur, a press elsewhere, a scroll, a wheel, a touchmove, a dialog opening and Escape; the first Escape closes the bubble alone, the second reaches the creation question or drops the pending preview, in a text field Escape also reaches the field; e2e (`editor-annotations.spec.ts`) at 1 024, 1 180 and 1 280 px: the bubble inside the window, under the bar, within 8 px under its button, at most 288 px wide, over neither « Défaire » nor the strip's commands, `expectNoShift`, `scrollWidth` unchanged, axe open, repeated scrolled and from the keyboard, the scroll awaited by a helper that waits for three still animation frames | +| Pinned drawing column (Task 17, criterion 32) | `editor-geometry.spec.ts` at 1 024, 1 180 and 1 280 px: at each scroll step the column's top is below the strip, its bottom in the window once stuck, the canvas painted at its top centre, its size constant, no sideways scroll; a focus never scrolls the page (« Défaire », a chip, a handle, the canvas box) and the add button, below the fold, is revealed below the strip; Delete and Insert on a pinned vertex keep the page still; a row selection moves neither the page nor the drawing; at 1 180 × 700 the canvas is capped and the column fits the window; at 1 024 × 600 (below 644 px) nothing is pinned and the Task 14 focus tests run there; `editor-deselect` and `editor-journey` presses no longer scroll to the page top | | Keyboard | create a zone, add and remove a vertex, move the zone, validate, without a pointer; « + » inserts and Backspace removes on a focused vertex, Backspace after an undo acts on the same focused handle; Ctrl+Z on a focused handle after arrow moves only cancels the preview and a later Enter commits nothing stale; after undoing « + », « − » never removes the wrong vertex; « Désélectionner » commits a pending series | | Paths (T16) | a path annotation gets no handle, no « + » or « − », no zone move in either mode, no keyboard move; its `d` is byte-identical after every gesture on its neighbours, a save and a reload; « Remplacer par un polygone » stays the only change: explicit, validated by the core, the path kept while tracing, on Escape and on a refusal; one undo entry restoring the exact `d`, redo restoring the polygon (owner, BDR-101) | | Accessibility | axe on selection, tracing, move states and the dialog in read and edit modes; handle names (« Point {nom} », « Sommet {n} de {nom} », « Ajouter un sommet après le sommet {n} de {nom} », « Retirer le sommet {n} de {nom} », the handle group « Sommets de {nom} »); live-region message after a move; WCAG 2.5.7: the move mode with four arrow buttons is the single-pointer path without dragging (A11) |