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

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

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-web` puis Entrée.
2. La première fois, le moteur se compile : quelques minutes.
3. Le terminal affiche deux adresses, par exemple :

   ```
   Page de test : http://192.168.1.21:8080/
   Page de mesure : http://192.168.1.21:8080/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 de la **page de test** dans la barre d'adresse, exactement
   comme affichée (avec `http://` et `:8080`).
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 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-web` 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 WEB_PORT=8081` et utilisez `:8081` dans l'adresse.