pierre/Ustagammon
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Activity

Retours des premiers joueurs : pions blancs et noirs, numéros sur le cadre, flèches du tutoriel, jans #58

Manually merged
pierre merged 9 commits from retours-joueurs into main 2026-11-12 08:09:56 +00:00
Conversation 0 Commits 9 Files Changed 23
+645 -172
pierre commented 2026-11-12 02:35:55 +00:00
Owner
Copy Link
Copy Source

Pourquoi

Les premiers joueurs de l'Atelier du Huit ont fait des retours, relayés par Pierre. La session design les a traduits en règles (MR !54 et !55, ADR 0010 amendé le 2026-11-11, charte dans docs/identite/charte/) :

  • les pions sombres se voyaient mal sur la barre en noyer ;
  • les joueurs préféraient des pions blancs et noirs aux pions ivoire et noyer ;
  • en portrait, les numéros des flèches, posés entre les deux rangées, encombraient le plateau ;
  • le tracé en pointillés de l'étape 2 du tutoriel ne montrait que le sens des pions du joueur ;
  • les textes parlaient de « camp », alors que les joueurs disent « jan ».

Quoi

  • Pions. Ceux du joueur sont blancs et ceux de l'ordinateur noirs, chacun avec un contour gris. Les dés et le videau suivent. Le logo et le cadre ne changent pas.
  • Numéros des flèches. Ils sont sur le cadre, en portrait comme en paysage, à 12 px au moins.
  • Étape 2 du tutoriel. Deux flèches circulaires sous les pions montrent le sens de chaque camp : une claire pour vos pions, une sombre pour ceux de l'ordinateur.
  • Vocabulaire. Le tutoriel et l'aide disent « jan intérieur » (flèches 1 à 6). Le glossaire gagne « Jan intérieur » et « Jan extérieur » et perd « Camp ». Le tutoriel parle de pions blancs et noirs.

Comment

Le travail a été délégué à un sous-agent, interrompu une fois par la limite d'usage.

  • Couleurs. Les valeurs de tokens.json sont reportées dans les variables CSS de web/app.css, pour les trois blocs de thème. Le TypeScript ne contient aucune couleur.
  • Cadre. En portrait, geometry.ts donne au cadre une bande haute et une bande basse, comme en paysage. Les pions passent d'un rayon de 20 à environ 18,9 unités.
  • Flèches du tutoriel. drawDirections (tutorial-view.ts) trace les deux flèches en classes CSS, insérées avant les pions pour passer dessous.
  • Jans. Les types HomeBoard et OuterBoard (board-model.ts) relient les fiches au code (ADR 0008) et placent les flèches du tutoriel. Ils ne portent aucune règle de jeu.
  • Recette. checkerContrasts (tests/browser/recette.mjs) trouve le fond sous chaque pion et mesure le contraste de son contour et de sa couleur. Le nouveau script tests/browser/retours-joueurs.mjs l'applique aux deux thèmes : pions sur la barre, position de départ, étape 2 du tutoriel. Il vérifie aussi que les numéros sont hors du fond du plateau.

Contraste du contour des pions sur la barre :

Pions Thème clair Thème sombre
Ordinateur 6,79:1 8,47:1
Joueur 2,73:1 3,40:1

Vérification :

  • make lint : aucun problème ;
  • make test : 10/10 ;
  • make test-browser : suite complète au vert dans Chromium et Firefox à la deuxième passe.

À la première passe, play.mjs a échoué une fois sous Firefox : boundingBox() nul dans touchTarget, du code que cette MR ne touche pas. Le test est passé ensuite, seul puis dans la suite complète. Un agent de corrections travaille en ce moment sur la fragilité de ce test.

Choix et compromis

  • Règle de contraste. Elle porte sur les pions de l'ordinateur, comme le dit recette-ux.md. Les pions blancs sont mesurés et journalisés, sans seuil.
  • Miniatures étroites. Sous 275 px, les numéros passent sous 12 px plutôt que d'écraser les flèches.
  • Fiche « Camp ». Elle est supprimée, sans redirection : aucun lien interne n'y menait plus.
  • Filet intérieur des pions. Il n'est pas dessiné, car il compliquerait l'animation.

Risques et déploiement

  • Aucun format durable ne change. Seule l'adresse #/glossaire/camp ne mène plus à une fiche.
  • En portrait, les pions sont légèrement plus petits. Les tests de géométrie vérifient qu'une pile de cinq pions ne déborde pas.
  • Retour arrière : annuler la fusion.

Comment vérifier

make lint && make test && make test-browser
BROWSERS=chromium SCRIPTS=retours-joueurs make test-browser
cat build/browser-shots/retours-joueurs/contrastes.txt

À la main, ouvrir #/position/4HPwAVDgc/ABUA puis #/tutoriel/2, en thème clair puis en thème sombre.

Hors périmètre

  • Pion blanc sur flèche paire (thème clair). Il n'atteint 3:1 ni par son contour (2,41:1) ni par sa couleur (2,03:1). La question est soumise à la session design.
  • Filet intérieur des pions. Non dessiné.
  • Fragilité de touchTarget dans play.mjs. Traitée par l'agent des corrections.

Generated with Claude Code https://claude.com/claude-code

## Pourquoi Les premiers joueurs de l'Atelier du Huit ont fait des retours, relayés par Pierre. La session design les a traduits en règles (MR !54 et !55, ADR 0010 amendé le 2026-11-11, charte dans `docs/identite/charte/`) : - les pions sombres se voyaient mal sur la barre en noyer ; - les joueurs préféraient des pions blancs et noirs aux pions ivoire et noyer ; - en portrait, les numéros des flèches, posés entre les deux rangées, encombraient le plateau ; - le tracé en pointillés de l'étape 2 du tutoriel ne montrait que le sens des pions du joueur ; - les textes parlaient de « camp », alors que les joueurs disent « jan ». ## Quoi - **Pions.** Ceux du joueur sont blancs et ceux de l'ordinateur noirs, chacun avec un contour gris. Les dés et le videau suivent. Le logo et le cadre ne changent pas. - **Numéros des flèches.** Ils sont sur le cadre, en portrait comme en paysage, à 12 px au moins. - **Étape 2 du tutoriel.** Deux flèches circulaires sous les pions montrent le sens de chaque camp : une claire pour vos pions, une sombre pour ceux de l'ordinateur. - **Vocabulaire.** Le tutoriel et l'aide disent « jan intérieur » (flèches 1 à 6). Le glossaire gagne « Jan intérieur » et « Jan extérieur » et perd « Camp ». Le tutoriel parle de pions blancs et noirs. ## Comment Le travail a été délégué à un sous-agent, interrompu une fois par la limite d'usage. - **Couleurs.** Les valeurs de `tokens.json` sont reportées dans les variables CSS de `web/app.css`, pour les trois blocs de thème. Le TypeScript ne contient aucune couleur. - **Cadre.** En portrait, `geometry.ts` donne au cadre une bande haute et une bande basse, comme en paysage. Les pions passent d'un rayon de 20 à environ 18,9 unités. - **Flèches du tutoriel.** `drawDirections` (`tutorial-view.ts`) trace les deux flèches en classes CSS, insérées avant les pions pour passer dessous. - **Jans.** Les types `HomeBoard` et `OuterBoard` (`board-model.ts`) relient les fiches au code (ADR 0008) et placent les flèches du tutoriel. Ils ne portent aucune règle de jeu. - **Recette.** `checkerContrasts` (`tests/browser/recette.mjs`) trouve le fond sous chaque pion et mesure le contraste de son contour et de sa couleur. Le nouveau script `tests/browser/retours-joueurs.mjs` l'applique aux deux thèmes : pions sur la barre, position de départ, étape 2 du tutoriel. Il vérifie aussi que les numéros sont hors du fond du plateau. Contraste du contour des pions sur la barre : | Pions | Thème clair | Thème sombre | | --- | --- | --- | | Ordinateur | 6,79:1 | 8,47:1 | | Joueur | 2,73:1 | 3,40:1 | Vérification : - `make lint` : aucun problème ; - `make test` : 10/10 ; - `make test-browser` : suite complète au vert dans Chromium et Firefox à la deuxième passe. À la première passe, `play.mjs` a échoué une fois sous Firefox : `boundingBox()` nul dans `touchTarget`, du code que cette MR ne touche pas. Le test est passé ensuite, seul puis dans la suite complète. Un agent de corrections travaille en ce moment sur la fragilité de ce test. ## Choix et compromis - **Règle de contraste.** Elle porte sur les pions de l'ordinateur, comme le dit `recette-ux.md`. Les pions blancs sont mesurés et journalisés, sans seuil. - **Miniatures étroites.** Sous 275 px, les numéros passent sous 12 px plutôt que d'écraser les flèches. - **Fiche « Camp ».** Elle est supprimée, sans redirection : aucun lien interne n'y menait plus. - **Filet intérieur des pions.** Il n'est pas dessiné, car il compliquerait l'animation. ## Risques et déploiement - Aucun format durable ne change. Seule l'adresse #/glossaire/camp ne mène plus à une fiche. - En portrait, les pions sont légèrement plus petits. Les tests de géométrie vérifient qu'une pile de cinq pions ne déborde pas. - Retour arrière : annuler la fusion. ## Comment vérifier ``` make lint && make test && make test-browser BROWSERS=chromium SCRIPTS=retours-joueurs make test-browser cat build/browser-shots/retours-joueurs/contrastes.txt ``` À la main, ouvrir #/position/4HPwAVDgc/ABUA puis #/tutoriel/2, en thème clair puis en thème sombre. ## Hors périmètre - **Pion blanc sur flèche paire (thème clair).** Il n'atteint 3:1 ni par son contour (2,41:1) ni par sa couleur (2,03:1). La question est soumise à la session design. - **Filet intérieur des pions.** Non dessiné. - **Fragilité de `touchTarget` dans `play.mjs`.** Traitée par l'agent des corrections. Generated with Claude Code https://claude.com/claude-code
pierre added 7 commits 2026-11-12 02:35:55 +00:00
Plan : retours des premiers joueurs 0e17334f45 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Pions blancs et noirs, avec contour : valeurs de tokens.json dans app.css cfdbc1cedc 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Numéros des flèches sur le cadre en portrait aussi 09a2ddf566 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Tutoriel : deux flèches circulaires ; les jans remplacent le camp 966822084a 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Recette : contraste du contour des pions, retours des joueurs dans le navigateur 8c2043aca5 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Recette des retours : capture après le bandeau, capture si le bouton reste caché 5a13c40bbb 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Plan des retours des premiers joueurs clos : résultat dans la description de la MR 57eeb19630 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
pierre added 2 commits 2026-11-12 08:05:48 +00:00
Fusion de main (contour des pions blancs, règle de recette des pions du joueur) dans retours-joueurs 9f0f20896b 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contour des pions blancs plus sombre en thème clair ; recette des pions du joueur a238da77ec 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
pierre manually merged commit 109655537f into main 2026-11-12 08:09:56 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
pierre (Pierre Martin)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: pierre/Ustagammon#58