docs(docs): rev 5 owner decisions, trial steps and test notes

This commit is contained in:
bchanot committed 2026-11-19 21:15:41 +01:00
1 parent b5dcb766b1
commit 3d6aacad99
3 files changed
+58 -22

No files matched your search

+47 -13
View File
@@ -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