docs(docs): rev 5 owner decisions, trial steps and test notes
This commit is contained in:
1 parent
b5dcb766b1
commit
3d6aacad99
3 files changed
+58
-22
No files matched your search
@@ -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,
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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) |
|
||||
|
||||
Reference in new issue
Block a user