Ustagammon/docs/guide-test-etape-1.md

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 ?