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

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.