Écran de progression (#/progression) : courbe du taux d'erreur, parties, exercices

La ligne de progression de l'accueil y mène. Les taux viennent des
analyses rangées ; les parties non analysées le sont en arrière-plan.
« Créer des exercices » ouvre le prompt du gabarit exercices, avec les
thèmes des erreurs comptés sur les faits du moteur.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Pierre MARTIN
2026-11-12 13:50:02 +01:00
co-authored by Claude Opus 5.5
parent 0493858c1a
commit fdbbff50ea
26 changed files with 1531 additions and 29 deletions
+25
View File
@@ -218,3 +218,28 @@ sur le modèle du tutoriel :
liste après la dernière. Le menu a une ligne « Les leçons ».
- Ces adresses se partagent : le contenu des leçons est le même pour tous ;
seule la progression (barre, état) dépend de l'appareil.
### 2026-11-12 — Adresses de la progression
Ajoutées avec l'écran de progression (étape 1h), dans le même schéma :
| Écran | Adresse |
| --- | --- |
| Progression : courbe du taux d'erreur et parties terminées | `#/progression` |
| Prompt « Créer des exercices », depuis la progression | `#/progression/ia` |
- La ligne de progression de l'accueil est un lien vers `#/progression`.
L'écran est une page, comme l'analyse : « Retour » (et Échap, et le
retour du téléphone) revient à l'écran d'avant, l'accueil s'il a été
ouvert par son adresse.
- Chaque partie de la liste est un lien vers son bilan
(`#/parties/<id>/bilan`) ; « Analyse » vers son analyse
(`#/parties/<id>/analyse`). Fermer le bilan ramène à la progression.
- « Créer des exercices » suit la règle des prompts (amendement du
2026-11-10) : le bouton ouvre la feuille du prompt, dans sa propre
feuille au-dessus de la progression (« ‹ Progression »), où le texte se
relit avant d'être copié. Rechargée, l'adresse recalcule le prompt à
partir des analyses enregistrées ; sans partie analysée, ou sans erreur,
la feuille le dit, jamais une page cassée.
- Comme « Mes parties », ces adresses n'ont de sens que sur l'appareil qui
a joué les parties : ce ne sont pas des liens à partager.
+4
View File
@@ -27,6 +27,10 @@ les noms des niveaux de l'ordinateur, dans le même ordre :
| 0,020 à 0,032 | Intermediate | Amateur |
| 0,032 et plus | Beginner | Débutant |
L'écran de progression l'écrit en millièmes, comme GNU Backgammon (« mEMG ») :
14 veut dire 0,014 d'équité perdue par décision. Sa courbe montre ce taux
partie après partie ; plus elle descend, mieux vous jouez.
Le bilan montre à côté la [chance](chance.md) de vos dés sur la partie : par
tour, la chance de vos jets ; « un peu » pour vous ou contre vous au-delà de
0,03 par tour, « nettement » au-delà de 0,06, comme GNU Backgammon. La
+32 -2
View File
@@ -1,7 +1,7 @@
# Les phrases du maître
Les mots et les phrases du conseil du maître (étape 1d) et du bilan de fin
de partie (étape 1e), en une seule source (ADR 0008) : `make site` copie ce
Les mots et les phrases du conseil du maître (étape 1d), du bilan de fin
de partie (étape 1e) et de l'écran de progression (étape 1h), en une seule source (ADR 0008) : `make site` copie ce
dossier dans le site publié
(`docs/maitre/`), l'application le lit à l'exécution
(`app/src/domain/analysis/phrases.ts`), et `make test` rend chaque gabarit
@@ -39,6 +39,9 @@ mots entre accolades sont remplis avec les données du moteur :
| `{roll}` | le jet, « 3-1 » |
| `{hits}` | le nombre de pions frappés, en chiffres |
| `{dice}` | la chance de vos dés sur la partie, en mots (bilan, étape 1e) |
| `{parties}` | le nombre de parties analysées sur la courbe (progression, étape 1h) |
| `{debut}` | le taux d'erreur moyen de la plus ancienne moitié de ces parties, en millièmes (14 pour 0,014) |
| `{fin}` | le même, sur la plus récente moitié |
Un fait (sections `fait.…`) s'ajoute à la phrase seulement si la ligne reste
sous 140 caractères.
@@ -281,3 +284,30 @@ erreurs.
## bilan.aucun-coup
- Aucun coup à revoir : vous avez joué comme je l'aurais fait.
## progression.baisse
Écran de progression (étape 1h), au moins trois parties analysées : le
taux d'erreur moyen de la plus récente moitié des parties est plus bas que
celui de la plus ancienne (moyennes arrondies en millièmes ; la partie du
milieu, quand leur nombre est impair, ne compte dans aucune).
- Sur vos {parties} dernières parties, vous faites moins d'erreurs : votre taux d'erreur est passé de {debut} à {fin}.
## progression.hausse
Le taux moyen remonte : la phrase reste encourageante, sans reproche.
- Sur vos {parties} dernières parties, votre taux d'erreur remonte un peu, de {debut} à {fin}. Les leçons sont là pour reprendre un point.
## progression.stable
Les deux moyennes, arrondies, sont égales.
- Sur vos {parties} dernières parties, votre taux d'erreur reste à {fin}.
## progression.attente
Moins de trois parties analysées : pas encore de courbe.
- Votre courbe apparaîtra après trois parties.
+1 -1
View File
@@ -23,7 +23,7 @@ d'après le cadrage, **à relire** par Pierre.
| [videau.md](videau.md) | Expliquer cette décision de videau | Feuille du maître, bilan, analyse |
| [bilan.md](bilan.md) | Bilan de ma partie | Bilan de fin de partie |
| [concept.md](concept.md) | Expliquer ce concept | Fiche d'un terme du glossaire |
| [exercices.md](exercices.md) | Créer des exercices | Progression (étape 1h, pas encore de bouton) |
| [exercices.md](exercices.md) | Créer des exercices | Écran de progression (étape 1h) |
Chaque prompt contient :
+7 -3
View File
@@ -1,8 +1,8 @@
# Créer des exercices
Prévu pour l'écran de progression (étape 1h) : le gabarit est écrit et
testé, sans bouton pour l'instant. Il rassemble les erreurs de vos
dernières parties analysées. Texte sous licence CC BY-SA 4.0 (voir
Le bouton « Créer des exercices » de l'écran de progression (étape 1h,
`#/progression/ia`). Il rassemble les erreurs de vos dernières parties
analysées (les 20 plus récentes au plus), et ce qui y revient. Texte sous licence CC BY-SA 4.0 (voir
[README.md](README.md)).
Repères propres à ce gabarit :
@@ -11,6 +11,7 @@ Repères propres à ce gabarit :
| --- | --- |
| `{parties}` | le nombre de parties analysées |
| `{erreurs}` | vos erreurs les plus coûteuses sur ces parties, avec leur coût |
| `{themes}` | ce qui revient dans toutes vos imprécisions et erreurs de ces parties, compté sur les plateaux décodés par le moteur : combien de coups et de décisions de videau ; combien de fois le coup du maître frappait un pion et le vôtre non, faisait un point que le vôtre ne faisait pas, ou l'inverse (votre coup frappait, le sien non) |
| `{position_titre}` | la plus coûteuse d'entre elles |
## Gabarit
@@ -23,6 +24,9 @@ Voici mes {parties} dernières parties contre l'ordinateur, analysées par GNU B
Mes erreurs les plus coûteuses, avec leur coût en équité :
{erreurs}
Ce qui revient dans ces erreurs, compté sur les plateaux décodés par GNU Backgammon :
{themes}
{position_titre} (GNU Backgammon, Position ID : {position_id}, Match ID : {match_id} ; ces identifiants la décrivent du point de vue du joueur qui a la main : {au_trait}).
Elle s'ouvre aussi à cette adresse : {lien}
+1
View File
@@ -66,4 +66,5 @@ Règles d'écriture :
| [decouvrir-l-application.feature](decouvrir-l-application.feature) | Premier lancement et accueil | Étape 0e.5 |
| [apprendre-les-regles.feature](apprendre-les-regles.feature) | Apprendre les règles avec le tutoriel | Étape 0e.5 |
| [suivre-une-lecon.feature](suivre-une-lecon.feature) | Progresser avec les leçons, garder sa progression | Étape 1g |
| [suivre-ma-progression.feature](suivre-ma-progression.feature) | Suivre sa progression : courbe du taux d'erreur, parties, exercices | Étape 1h |
| [installer-l-application.feature](installer-l-application.feature) | Installer l'application | Étape 0e.5 |
@@ -0,0 +1,57 @@
# language: fr
Fonctionnalité: Suivre ma progression
« Votre progression », depuis la ligne de progression de l'accueil, montre
votre taux d'erreur partie après partie : plus il est bas, mieux vous avez
joué. Chaque partie terminée y figure avec son résultat, sa date, le niveau
de l'ordinateur et son taux d'erreur, celui de son bilan ; touchez-la pour
rouvrir son bilan, ou son analyse. Une phrase du maître dit, en chiffres,
comment évolue votre taux d'erreur.
Scénario: Comment voir ma progression ?
Après trois parties analysées, la courbe montre un point par partie, de
la plus ancienne à la plus récente. Chaque point est le taux d'erreur du
bilan de la partie, en millièmes : 14 veut dire que vous avez perdu en
moyenne 0,014 d'équité par décision.
Étant donné que vous avez terminé trois parties contre l'ordinateur
Et que le maître les a analysées
Quand vous ouvrez votre progression
Alors la courbe a trois points, chacun égal au taux d'erreur du bilan de sa partie
Et la phrase du maître compare vos premières parties aux dernières
Scénario: Quand ma courbe apparaît-elle ?
Il faut trois parties terminées et analysées. Avant, la liste de vos
parties est déjà là, avec leur taux d'erreur.
Étant donné que vous avez terminé deux parties contre l'ordinateur
Et que le maître les a analysées
Quand vous ouvrez votre progression
Alors il n'y a pas encore de courbe
Et la phrase de votre progression est « Votre courbe apparaîtra après trois parties. »
Scénario: Et une partie que le maître n'a pas encore analysée ?
Elle est analysée en arrière-plan quand vous ouvrez votre progression, et
elle rejoint la courbe dès que son analyse est finie. Les parties déjà
analysées ne sont jamais recalculées.
Étant donné que vous avez terminé trois parties contre l'ordinateur
Et que le maître n'a analysé que les deux premières
Quand vous ouvrez votre progression
Alors la troisième partie attend son analyse, sans taux d'erreur
Quand son analyse en arrière-plan est finie
Alors la courbe a trois points, chacun égal au taux d'erreur du bilan de sa partie
Et les deux premières parties n'ont pas été analysées de nouveau
Scénario: Comment créer des exercices sur mes erreurs ?
« Créer des exercices » prépare une question pour une IA : vos erreurs
les plus coûteuses sur vos dernières parties, avec leur coût d'après le
moteur, ce qui y revient (pions frappés, points faits par le coup du
maître et pas par le vôtre), et la position de la plus coûteuse. Votre
niveau n'y figure qu'à partir de 20 décisions analysées en tout.
Étant donné que vous avez terminé trois parties contre l'ordinateur
Et que le maître les a analysées
Quand vous demandez des exercices
Alors la question cite vos erreurs avec leur coût et ce qui y revient
Et elle ne donne votre niveau que si vos parties comptent au moins 20 décisions