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

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.