# Guide de test : Ustagammon sur le Fairphone 4 (étape 0)

Document temporaire de l'étape 0 : il sera supprimé avec `docs/etape-0.md`.

Deux tests sur le téléphone :

- **Étape 0d : jouer une partie** (section suivante), sur le site publié ;
- **Étape 0b : mesurer le moteur** (déjà fait le 2026-11-02), sur une page servie par
  le PC.

## Étape 0d : jouer une partie sur le téléphone

Le but : installer l'application sur le Fairphone 4, jouer une partie
complète contre l'ordinateur, vérifier qu'elle marche sans réseau, et
rapporter ce que vous avez constaté. Comptez une demi-heure.

### Ouvrir et installer l'application

1. Sur le Fairphone, ouvrez Chrome et allez sur https://ustagammon.sans.pub.
2. Attendez que le plateau s'affiche et que le message « Chargement du
   moteur… » laisse place à une consigne (par exemple « À vous : lancez les
   dés. » ou « L'ordinateur réfléchit… »). La première fois, le moteur se
   télécharge (environ 7 Mo) : quelques secondes en Wi-Fi.
3. Installez l'application : menu de Chrome (les trois points), puis
   « Installer l'application » ou « Ajouter à l'écran d'accueil ». Une icône
   (deux pions sur du bois) apparaît sur l'écran d'accueil.
4. Fermez Chrome et ouvrez Ustagammon depuis cette icône : l'application
   s'ouvre en plein écran, sans barre d'adresse.

### Jouer une partie complète

Suivez le scénario « Jouer une partie contre l'ordinateur »
(`docs/scenarios/jouer-une-partie.feature`), qui est aussi l'aide de
l'application : bouton « Aide », en haut.

1. Une partie commence d'elle-même au premier lancement, par le jet
   d'ouverture (un dé chacun) : le message dit qui commence. « Nouvelle
   partie », en haut, en recommence une.
2. Quand c'est à vous : touchez « Lancer les dés » (ou « Doubler », pour
   proposer de doubler avant de lancer).
3. Pour jouer : touchez un pion entouré de vert, puis l'une des cases
   d'arrivée en surbrillance ; recommencez pour chaque dé. Pour sortir un
   pion, touchez le bac à droite, en bas. « Annuler » remet les pions du coup
   en cours à leur place.
4. Le coup est envoyé dès qu'il est complet ; l'ordinateur joue ensuite, et
   le message dit son coup et son temps de calcul, par exemple
   « L'ordinateur a joué 6-4 : 24/18 13/9 (0,3 s) ». Les petits points
   orange marquent ses cases de départ et d'arrivée (dans sa numérotation :
   sa case 24 est votre case 1).
5. Si l'ordinateur vous propose de doubler : « Prendre » ou « Passer ».
   Essayez au moins une fois de doubler vous-même.
6. En fin de partie, le message donne le gagnant, la sorte de victoire
   (simple, gammon ou backgammon) et les points.

En cours de partie, fermez l'application (balayez-la dans la liste des
applications ouvertes), puis rouvrez-la : la partie doit reprendre là où vous
en étiez.

### Vérifier le hors ligne

1. Après avoir ouvert l'application au moins une fois (attendez une
   vingtaine de secondes après le premier chargement, le temps que tout soit
   mis de côté), fermez-la.
2. Passez le téléphone en mode avion.
3. Rouvrez Ustagammon depuis son icône : le plateau, l'ordinateur et l'aide
   doivent fonctionner comme avant.
4. Repassez en mode normal.

### Ce qu'il faut rapporter

Dans la conversation avec Claude Code :

- les **temps des coups de l'ordinateur** : ceux affichés dans les messages
  (le plus long que vous avez vu), et votre ressenti (attente gênante ou
  non) ;
- si la partie est allée **jusqu'au bout**, et son résultat ;
- si la **reprise** après fermeture et le **mode avion** ont marché ;
- tout ce qui gêne : plateau trop petit, case difficile à toucher, texte
  incompréhensible, bouton qui ne répond pas, couleurs peu lisibles (thème
  clair ou sombre du téléphone) ;
- une **capture d'écran** (bouton marche + volume bas) de tout problème.

Si vous le pouvez, refaites l'essai dans Firefox sur le téléphone (sans
l'installer) et dites si les temps de l'ordinateur sont nettement plus longs.

## Étape 0b : mesurer le moteur

Le but : ouvrir sur le téléphone une page web où le moteur de backgammon
calcule, puis lancer une mesure et coller son rapport dans la conversation.
Comptez un quart d'heure.

### 1. Préparer le PC

1. Ouvrez un terminal dans le dossier du projet (`~/Code/ustagammon`).
2. Si ce n'est pas déjà fait, tapez `make setup` puis Entrée. Cela prépare les
   outils. La première fois, c'est long ; ensuite, c'est immédiat.
3. Le PC et le téléphone doivent être sur **le même Wi-Fi** (la même box).

### 2. Lancer la page

1. Tapez `make deploy` puis Entrée.
2. La première fois, le moteur se compile : quelques minutes.
3. Le terminal affiche deux adresses, par exemple :

   ```
   Application : http://192.168.1.21:8080/
   Test du moteur : http://192.168.1.21:8080/moteur/
   Page de mesure : http://192.168.1.21:8080/moteur/bench.html
   ```

   Vos chiffres peuvent être différents : notez ceux de votre écran.
4. Laissez ce terminal ouvert pendant tout le test. Pour arrêter la page à la
   fin : Ctrl+C dans le terminal.

### 3. Essayer un meilleur coup

1. Sur le Fairphone, ouvrez le navigateur (Chrome ou Firefox).
2. Tapez l'adresse du **test du moteur** dans la barre d'adresse, exactement
   comme affichée (avec `http://` et `:8080`). Les pages de test sont aussi
   publiées : https://ustagammon.sans.pub/moteur/ et
   https://ustagammon.sans.pub/moteur/bench.html.
3. Attendez le message « Moteur prêt, chargé en … ms ».
4. Dans « Exemple », choisissez une position, par exemple « middlegame-1 ».
5. Dans « Niveau », choisissez « fort (2 plis) ».
6. Touchez « Meilleur coup ».
7. La page affiche le coup conseillé et le **temps de calcul**. Notez ce temps
   si vous voulez, il sera aussi dans le rapport.

### 4. Lancer la mesure

1. En bas de la page, touchez « Page de mesure » (ou tapez l'adresse de la
   page de mesure).
2. Touchez « Lancer la mesure ».
3. Attendez « Mesure terminée » : de une à quelques minutes. Pendant ce temps,
   gardez l'écran allumé et la page ouverte, sans changer d'application.
4. Un tableau résume les résultats : « OK » si le seuil est respecté,
   « dépassé » sinon.

### 5. Envoyer le rapport

1. Touchez « Copier les résultats ».
2. Si la page dit « Rapport copié », c'est bon.
3. Sinon, le texte du rapport est sélectionné : faites un appui long dessus,
   puis « Copier ».
4. Collez le rapport dans la conversation avec Claude Code (sur le téléphone,
   ou envoyez-le vous sur le PC).

Si vous en avez le temps, refaites la mesure une deuxième fois (rechargez la
page de mesure) et collez aussi ce second rapport : cela montre si les temps
sont stables. Si les deux navigateurs sont installés, faites la mesure dans
Chrome **et** dans Firefox : sur le PC, Firefox s'est montré nettement plus
lent, et le rapport indique le navigateur utilisé.

### Si la page ne s'ouvre pas

- **Vérifiez l'adresse** : `http://` (et non `https://`), les chiffres exacts,
  et `:8080` à la fin.
- **Vérifiez le Wi-Fi** : le téléphone doit être sur le même réseau que le PC,
  pas sur la 4G ni sur un Wi-Fi invité.
- **Vérifiez que la page tourne** : sur le PC, ouvrez
  `http://localhost:8080/` dans un navigateur. Si elle ne s'ouvre pas non
  plus, relancez `make deploy` et lisez le message d'erreur.
- **Le pare-feu du PC** peut bloquer le téléphone. S'il est actif
  (`sudo ufw status` affiche « Status: active »), autorisez le port le temps
  du test : `sudo ufw allow 8080/tcp`, puis à la fin `sudo ufw delete allow
  8080/tcp`.
- **« Le moteur n'a pas pu se charger »** : notez le message exact et
  collez-le dans la conversation. Essayez aussi l'autre navigateur (Chrome ou
  Firefox), à jour.
- **Le port 8080 est déjà pris** : un autre programme l'utilise. Lancez
  `make deploy WEB_PORT=8081` et utilisez `:8081` dans l'adresse.