Plans : retours des joueurs (Crawford sur la barre, abandon), analyse du match

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/etape-1.md

@@ -26,7 +26,9 @@ Repris du cadrage (modules, écrans clés, IA générative en V1) et des ADR 001
 | 1g. Accueil, tutoriel et leçons (fait) | Accueil (reprendre, nouvelle partie, prochaine leçon, progression résumée), tutoriel des règles interactif et illustré (0e.5), cinq premières leçons numérotées (ADR 0011) avec positions et « à vous de jouer », progression locale ; contenus CC BY-SA 4.0 livrés sans relecture préalable, sous les garde-fous du moteur (décision du 2026-11-09) | 0e.5, 1a |
 | 1h. Progression | Historique des parties et courbe du taux d'erreur | 1b, 1e |
 | 1i. Plateau soigné | Dessin du plateau aligné sur la charte (`docs/identite/charte/board.js`), animations des pions, glisser-déposer en plus du toucher, double toucher pour le seul coup évident | 0e.3 |
-| 1j. Plan de test (fait) | `docs/guide-test-etape-1.md` : parcours du débutant et du joueur de club sur le téléphone, avec ce qu'il faut rapporter | toutes |
+| 1k. Retours des joueurs, 2e lot | Crawford signalé sur la barre ; abandon (simple, gammon, backgammon) accepté ou refusé par l'ordinateur selon GNU Backgammon (plan `2026-11-12-retours-joueurs-2.md`) | 1c, 1e |
+| 1l. Analyse du match | Bilan et courbe d'un match entier (chances de gagner le match), erreurs de videau sur tout le match, prompt et export SGF du match (plan `2026-11-12-analyse-du-match.md`) | 1c, 1e, 1f |
+| 1j. Plan de test | `docs/guide-test-etape-1.md` : parcours du débutant et du joueur de club sur le téléphone, avec ce qu'il faut rapporter | toutes |
 
 ## Orientation donnée par Pierre
 

docs/guide-test-etape-1.md

@@ -1,154 +0,0 @@
-# Guide de test de l'étape 1 : « Jouer et comprendre »
-
-Document temporaire : il sert à la vérification de l'étape 1 avec Pierre, sur
-le Fairphone 4, et sera supprimé à la clôture de l'étape (ce qui en reste de
-durable va dans le journal).
-
-**Critère de fin de l'étape** (cadrage) : un débutant apprend et joue seul ; un
-joueur de club comprend ses erreurs.
-
-Le guide suit deux parcours : celui du **débutant** (parties A à C) et celui du
-**joueur de club** (parties D à F). Une partie G regroupe ce qui est commun
-(installation, hors ligne, mise à jour, affichage). Comptez environ une heure
-pour l'ensemble, en plusieurs fois si besoin : l'application reprend là où
-vous en étiez.
-
-Pour chaque point : cochez ce qui marche, et notez ce qui coince avec le
-numéro du point (par exemple « C4 : le bilan s'ouvre deux fois »). Une capture
-d'écran aide beaucoup.
-
-## Avant de commencer
-
-- Adresse : https://ustagammon.sans.pub, dans Chrome sur le Fairphone 4.
-- Version : le menu, puis « Aide et glossaire », onglet « À propos », donne le
-  numéro de version (un commit). Notez-le en tête de vos retours.
-- Pour repartir de zéro (comme un nouveau joueur) : dans Chrome, Paramètres du
-  site pour ustagammon.sans.pub, puis « Effacer et réinitialiser ». Toutes les
-  parties et la progression sont alors perdues.
-
-## A. Premier contact (débutant)
-
-1. Ouvrez l'application après l'avoir réinitialisée. L'écran de premier
-   lancement propose « Je découvre » et « Je connais les règles ».
-2. Touchez « Je découvre » : le tutoriel des règles s'ouvre à l'étape 1 sur 8.
-3. Suivez les huit étapes jusqu'au bout. À chaque écran « à vous » : jouez
-   d'abord un mauvais coup (le pion revient, une phrase explique sans
-   reproche), puis le bon (coche, « Continuer »).
-4. Étape 2 : deux flèches circulaires montrent le sens de chaque camp, sous
-   les pions.
-5. Le texte est-il clair pour quelqu'un qui n'a jamais joué ? Notez les mots
-   ou phrases qui bloquent. Les mots soulignés ouvrent leur fiche du glossaire.
-6. À la fin, l'accueil propose la suite (partie, leçons).
-
-**À rapporter** : une étape incompréhensible, un coup juste refusé ou un coup
-faux accepté, un texte coupé ou qui déborde.
-
-## B. Première partie (débutant)
-
-1. Depuis l'accueil, « Nouvelle partie » : choisissez « Partie libre » et le
-   niveau « Débutant », conseil du maître activé, puis « Commencer la partie ».
-2. Touchez les dés pour les lancer. Touchez un pion : s'il n'a qu'une case
-   d'arrivée, il y va tout seul ; sinon, ses cases d'arrivée s'allument.
-3. Essayez aussi de glisser un pion avec le doigt jusqu'à sa case ; lâché
-   ailleurs, il revient à sa place.
-4. Un double toucher sur un pion joue le coup évident s'il n'y en a qu'un.
-5. Avant de valider, « Annuler » reprend le dernier pion, un à la fois. Puis
-   validez en touchant les dés ou « Jouer ce coup ».
-6. Après votre coup, une ligne discrète du maître apparaît (« Bon coup. »,
-   « Erreur. J'aurais joué… »). Touchez-la : la feuille montre votre coup et
-   celui du maître, joués pion par pion.
-7. Regardez le coup de l'ordinateur : ses pions glissent, des traces restent,
-   « Revoir » le rejoue. Touchez la notation du coup : la fiche « Notation des
-   coups » s'ouvre.
-8. Quand aucun coup n'est possible, les dés sont barrés : touchez-les pour
-   passer.
-9. Jouez la partie jusqu'au bout.
-
-**À rapporter** : un pion qui ne bouge pas comme prévu, un geste raté, une
-phrase du maître fausse ou blessante, la durée d'un tour de l'ordinateur si
-elle dépasse 2 s.
-
-## C. Bilan, leçons et retour (débutant)
-
-1. En fin de partie, le bilan s'affiche : l'issue, ce qui a fait la
-   différence, vos décisions comptées, votre jeu et vos dés, le coup à revoir.
-2. « Rejouer » relance une partie avec les mêmes réglages ; « Changer les
-   réglages » ouvre l'écran « Nouvelle partie ».
-3. Depuis l'accueil, ouvrez « Toutes les leçons » puis la leçon 1. Suivez-la,
-   en faisant au moins un exercice faux puis juste.
-4. Revenez à la liste : la leçon affiche « k exercices sur n ». Fermez
-   l'application, rouvrez-la : la progression est gardée.
-5. Faites les cinq leçons si vous avez le temps : chaque réponse attendue est
-   le meilleur coup du moteur.
-
-**À rapporter** : une explication de leçon qui vous semble fausse ou trop
-difficile pour un débutant, un exercice où le refus ne met pas sur la voie.
-
-## D. Match et niveaux (joueur de club)
-
-1. « Nouvelle partie » : choisissez « Match », 3 points, niveau « Avancé »,
-   puis « Commencer le match ».
-2. Le score du match s'affiche (« Match en 3 points ») ; à 2 points d'un
-   joueur, la partie Crawford est signalée et le videau disparaît.
-3. Doublez au moins une fois (le videau demande confirmation). Répondez au
-   moins une fois à un double de l'ordinateur (Prendre ou Passer).
-4. Entre deux parties, « Partie suivante » ; à la fin du match, le score final.
-5. Le niveau de l'ordinateur paraît-il juste ? « Champion » est le plus fort.
-
-**À rapporter** : une décision de videau de l'ordinateur qui vous surprend
-(notez la position avec « Copier le lien de la position » dans le menu), un
-score de match faux.
-
-## E. Comprendre ses erreurs (joueur de club)
-
-1. Après une partie, depuis le bilan, « Voir l'analyse ».
-2. La courbe de vos chances de gagner se parcourt du doigt ; toucher un point
-   ouvre le coup.
-3. Le visualiseur montre « Votre coup » et « Le coup du maître ». Les chiffres
-   du moteur sont repliés en dessous.
-4. Filtrez la liste des coups par appréciation (erreurs, grosses erreurs).
-5. Sur un coup, « Rejouer d'ici » : une branche part de ce coup, la partie
-   d'origine reste dans « Mes parties ».
-6. Sur une erreur, « Demander à une IA » : le prompt s'affiche, « Copier le
-   prompt » confirme par « ✓ Copié ». Collez-le dans l'IA de votre choix et
-   jugez la réponse.
-7. Ouvrez la progression (la ligne de l'accueil) après trois parties : la
-   courbe du taux d'erreur, la liste des parties, « Créer des exercices ».
-8. « Mes parties » (menu) : reprenez une ancienne partie, exportez-en une en
-   SGF et ouvrez-la dans GNU Backgammon de bureau (`load game fichier.sgf`).
-
-**À rapporter** : une analyse qui contredit ce que vous pensiez (c'est peut-être
-juste, mais notez-la), un prompt incomplet, une partie absente de la liste.
-
-## F. Liens et positions (joueur de club)
-
-1. Dans le menu, « Copier le lien de la position ». Ouvrez ce lien dans un
-   nouvel onglet : la même position s'affiche, avec « Jouer à partir d'ici ».
-2. L'aide, une question de l'aide, un terme du glossaire, la progression : chaque
-   écran a son adresse ; le bouton retour du téléphone ferme d'abord la feuille
-   ouverte, puis revient à l'écran précédent.
-
-## G. Commun : installation, hors ligne, affichage
-
-1. Après une partie terminée, l'accueil propose « Installer l'application » :
-   installez-la, puis ouvrez-la depuis l'écran d'accueil du téléphone.
-2. Mode avion : l'application s'ouvre et se joue normalement.
-3. Tournez le téléphone : en paysage, le plateau prend l'écran, la partie
-   continue sans perte. Essayez « Plein écran » dans le menu.
-4. Menu, thème clair puis sombre : les pions blancs et noirs se distinguent
-   bien partout, y compris sur la barre.
-5. Vibrations : pion posé, pion frappé, double de l'ordinateur, fin de partie.
-   Coupez-les dans le menu.
-6. Mise à jour : à la prochaine publication, le bandeau « Nouvelle version
-   prête » apparaît en bas ; « Mettre à jour » vous ramène à votre partie.
-7. Performances : notez si l'application ralentit, chauffe ou se recharge
-   seule (elle fait tourner deux moteurs : un pour jouer, un pour analyser).
-
-## Ce qu'il faut rapporter
-
-- Le numéro de version (onglet « À propos »).
-- Pour chaque problème : le numéro du point, ce que vous avez fait, ce que vous
-  attendiez, ce qui s'est passé, et si possible une capture ou le lien de la
-  position.
-- Votre avis sur les deux critères : un débutant peut-il apprendre et jouer
-  seul ? Un joueur de club comprend-il ses erreurs ?

docs/identite/charte/ecrans-etape-1.md

@@ -255,14 +255,28 @@ Maquette « Progression ».
 
 - Une phrase de synthèse, factuelle (« Sur vos 8 dernières parties, vous
   faites moins d'erreurs : votre taux d'erreur est passé de 14 à 7. »). Si la
-  tendance monte, la phrase reste encourageante et sans reproche (« Votre
-  taux d'erreur remonte un peu ces derniers jours. Les leçons sont là
-  pour reprendre un point. »).
+  tendance monte, la phrase reste encourageante et sans reproche, sans
+  minimiser ni dramatiser (« Sur vos 8 dernières parties, votre taux
+  d'erreur remonte, de 7 à 12. Les leçons sont là pour reprendre un
+  point. »).
 - La courbe du taux d'erreur par partie terminée, avec le rappel « plus bas,
-  c'est mieux » dans son titre, le dernier point en `verdict-good`, et un lien
-  vers la fiche « taux d'erreur ».
-- La liste des parties (résultat, date, niveau de l'ordinateur, taux d'erreur
-  en chiffre gras aligné à droite), chacune ouvrant son bilan.
+  c'est mieux » dans son titre et un lien vers la fiche « taux d'erreur ».
+  Le dernier point est plus gros, à l'encre du texte ; il ne passe en
+  `verdict-good` que si la tendance baisse (le vert dit « mieux », jamais
+  « dernier »). Les valeurs s'écrivent au-dessus du premier et du dernier
+  point seulement ; l'axe ne porte que la ligne du 0, sans chiffres qui
+  doublent ceux des points.
+- La liste des parties : chaque ligne est un seul lien vers son bilan
+  (chevron à droite), sans bouton par ligne ; l'analyse s'ouvre depuis le
+  bilan. Sur la ligne : le résultat court (« Gagnée, 1 point », « Perdue,
+  gammon, 2 points », jamais « partie simple »), puis en `caption`
+  `text-muted` la date et le niveau (« 12 nov. 2026 · contre
+  Intermédiaire », le niveau sans couleur), et à droite le taux d'erreur en
+  chiffre gras.
+- Sans partie terminée : une phrase et « Nouvelle partie » en action
+  principale, pleine largeur en portrait.
+- Pas de bouton « Retour » dans l'en-tête : la barre du haut et le retour du
+  téléphone suffisent, comme sur la liste des leçons.
 - Moins de trois parties analysées : pas de courbe, une phrase « Votre
   courbe apparaîtra après trois parties. ».
 

docs/plans/2026-11-12-analyse-du-match.md

@@ -0,0 +1,42 @@
+# Analyse d'un match entier
+
+- **Date** : 2026-11-12
+- **Étape** : 1 (demande de Pierre)
+- **Statut** : prévu (après le 2e lot de retours des joueurs, et une fois les maquettes de la session « identité » disponibles)
+- **Exécutant** : sous-agent general-purpose, dans un worktree
+
+## Objectif
+
+Demande de Pierre du 2026-11-12 : « proposer une analyse complète du match, notamment pour l'utilisation du videau (pas que l'analyse d'une manche) ». Il cite son propre exemple : mené 4-0 après deux parties, il a gagné le match en 5 points trois parties plus tard.
+
+Aujourd'hui, chaque partie d'un match a son bilan et son analyse (1e), mais rien ne montre le match dans son ensemble.
+
+## Consignes
+
+Respecter les ADR 0007, 0008, 0011 et 0013. Suivre les règles et maquettes de la session « identité ».
+
+1. **Bilan du match.** Une adresse (par exemple `#/matchs/<id>/bilan`) donne :
+   - le résultat et le déroulé du score, partie par partie ;
+   - le taux d'erreur du joueur sur tout le match, à la manière de gnubg (statistiques du match) ;
+   - les erreurs de videau regroupées : doubles manqués, mauvais doubles, prises et refus fautifs ;
+   - le moment décisif ;
+   - « le coup à revoir » du match.
+2. **Courbe du match.** Elle suit les chances de gagner le match (MWC, tables d'équité de match du moteur) à travers toutes les parties, et non les chances de gagner la partie. Toucher un point ouvre la décision.
+3. **Données.**
+   - Réutiliser les analyses déjà rangées dans les journaux de chaque partie (`review`).
+   - Relier les parties d'un même match. Aujourd'hui, une partie = un journal (choix de 1c). Il faut un identifiant de match commun, avec un format durable et une migration testée. Les matchs déjà joués sont rattachés si c'est possible, sinon on le dit honnêtement.
+   - Les équités de match viennent du moteur. Le domaine ne fait aucun calcul de table d'équité.
+4. **Accès.** Depuis le bilan de la dernière partie d'un match, « Voir l'analyse du match ». Depuis « Mes parties » et la progression, le match apparaît comme une entrée.
+5. **Prompt.** Un gabarit « bilan de mon match », avec un bouton « Demander à une IA » (1f).
+6. **Export SGF.** Exporter le match entier : MI et toutes les parties.
+7. **Tests.** Scénario Gherkin d'un match en 5 points avec dés imposés, où le joueur remonte après avoir été mené. Tests unitaires de l'agrégation, référence MWC comparée à gnubg de bureau.
+
+Tests : `make lint`, `make test`, `make test-browser`, captures pour la recette design.
+
+## Critères de réussite
+
+Sur un match joué jusqu'au bout, le bilan du match reprend les erreurs de videau de toutes les parties, et la courbe des chances de gagner le match est continue d'une partie à l'autre. Les trois commandes passent.
+
+## Résultat
+
+À remplir à la clôture.

docs/plans/2026-11-12-retours-joueurs-2.md

@@ -0,0 +1,53 @@
+# Retours des joueurs, 2e lot : Crawford sur la barre, abandon
+
+- **Date** : 2026-11-12
+- **Étape** : 1 (retours des joueurs relayés par Pierre)
+- **Statut** : prévu (après 1h et 1i, et les maquettes de la session « identité »)
+- **Exécutant** : sous-agent general-purpose, dans un worktree
+
+## Objectif
+
+Deux retours de joueurs relayés par Pierre le 2026-11-12 :
+- « il serait bien que le Crawford soit en évidence sur la barre plutôt » ;
+- « possibilité de pouvoir abandonner (un petit drapeau ?) si on sait qu'on va perdre, et pouvoir proposer simple, gammon, backgammon sans que l'ordinateur ne se fasse arnaquer (il refuse un simple si on sait qu'il y aura gammon par exemple) ».
+
+## Consignes
+
+Respecter les ADR 0005, 0007, 0008, 0011 et 0013. Suivre les règles et les maquettes de la session « identité », qui seront ajoutées dans `docs/identite/charte/`.
+
+1. **Crawford sur la barre.** L'indication de la partie Crawford est placée sur la barre du plateau, en portrait et en paysage, à l'endroit fixé par la charte.
+
+2. **Abandon, côté moteur.**
+   - La décision d'accepter ou de refuser un abandon (simple, gammon ou backgammon) reprend le code de GNU Backgammon de bureau qui répond à un abandon proposé par l'humain : évaluation de la position, équité de l'abandon (`getResignation`, `getResignEquity` ou leurs équivalents dans gnubg 1.08.003), comparaison à l'équité de la partie continuée. Les sources sont citées fichier et ligne.
+   - Ces fichiers ne sont pas dans la copie : porter le code dans `engine.c`, comme pour la chance en 1a, sans modifier `engine/gnubg/`.
+   - Exposer la décision par `engine.h`, `engine-cli` et l'adaptateur.
+   - Ajouter des positions de référence comparées à gnubg de bureau (Docker), avec au moins :
+     - un simple refusé parce que le gammon est probable ;
+     - un simple accepté ;
+     - un gammon accepté ;
+     - un cas de match.
+
+3. **Abandon, côté domaine.**
+   - Un événement d'abandon, proposé puis accepté ou refusé, rétrocompatible : migration testée (ADR 0007).
+   - Fin de partie avec les points selon la valeur de l'abandon et le videau.
+   - Prise en compte dans le match (score, Crawford), le bilan, la progression et l'export SGF (convention de gnubg pour l'abandon).
+
+4. **Abandon, côté interface.**
+   - Le drapeau, la feuille de choix et la réponse de l'ordinateur, selon la charte.
+   - Messages dans le ton du maître, ajoutés à `docs/maitre/phrases.md` ou à une source sœur.
+
+5. **Aide et glossaire.**
+   - Fiche « Abandon » (resign).
+   - Scénarios Gherkin avec dés imposés : abandon accepté, abandon refusé, abandon en match.
+
+Tests : `make lint`, `make test`, `make test-browser` (suite complète), avec captures pour la recette design.
+
+## Critères de réussite
+
+- Sur une position de référence où le gammon est probable, un abandon simple est refusé, comme dans gnubg de bureau.
+- Un abandon accepté termine la partie avec les bons points.
+- Les trois commandes passent.
+
+## Résultat
+
+À remplir à la clôture.