ADR 0008 : glossaire et scénarios, source unique pour le code, l'aide et les tests

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 13:45:34 +01:00
parent 463bc6f553
commit 77ca5a60ca
36 changed files with 518 additions and 1 deletions
@@ -0,0 +1,30 @@
+# Scénarios d'utilisation
+
+La documentation utilisateur d'Ustagammon : un fichier par tâche réelle d'un
+joueur, écrit pour lui. Ces fichiers sont la seule source (ADR 0008) :
+l'application les affiche comme pages d'aide, et ils servent de tests de bout
+en bout.
+
+Tant que l'outil d'exécution n'est pas choisi (avec le socle, fin de
+l'étape 0), les scénarios se déroulent à la main : ils servent alors de guide
+de test.
+
+## Format
+
+Markdown avec Gherkin (`.feature.md`), étapes en français :
+
+- `# Fonctionnalité : <la tâche>`, puis un court paragraphe qui explique à quoi
+  elle sert, pour le joueur ;
+- `## Scénario : <un cas précis>` ;
+- des étapes en liste : `* Étant donné …`, `* Quand …`, `* Et …`, `* Alors …`.
+
+Règles d'écriture : la deuxième personne (« vous »), les mots du glossaire
+(`docs/glossaire/`), des étapes que le joueur peut faire et vérifier lui-même,
+pas de détail technique. La syntaxe exacte sera validée avec l'outil
+d'exécution.
+
+## Scénarios
+
+| Fichier | Tâche | Depuis |
+| --- | --- | --- |
+| [jouer-une-partie.feature.md](jouer-une-partie.feature.md) | Jouer une partie contre l'ordinateur | Étape 0d |
@@ -0,0 +1,48 @@
+# Fonctionnalité : Jouer une partie contre l'ordinateur
+
+Vous jouez une partie complète contre l'ordinateur, qui s'appuie sur le moteur
+GNU Backgammon. L'application tire les dés, vous propose uniquement des coups
+permis par les règles, et l'ordinateur joue et décide du videau tout seul.
+
+## Scénario : Commencer une partie
+
+* Étant donné que vous avez ouvert Ustagammon
+* Quand vous touchez « Nouvelle partie »
+* Alors le plateau s'affiche avec les pions en position de départ
+* Et le premier jet de dés désigne qui commence
+
+## Scénario : Jouer votre coup
+
+* Étant donné que c'est à vous de jouer et que les dés sont tirés
+* Quand vous touchez un pion puis la case où vous voulez l'amener
+* Alors le pion s'y déplace si ce déplacement est permis par les dés
+* Et un déplacement interdit est refusé sans changer le plateau
+* Quand vous avez utilisé vos dés
+* Alors votre coup est validé et c'est au tour de l'ordinateur
+
+## Scénario : L'ordinateur joue
+
+* Étant donné que c'est au tour de l'ordinateur
+* Quand ses dés sont tirés
+* Alors il joue son coup en moins de 2 secondes
+* Et son coup s'affiche sur le plateau
+
+## Scénario : Prendre le double de l'ordinateur
+
+* Étant donné que l'ordinateur vous propose de doubler
+* Quand vous touchez « Prendre »
+* Alors la partie continue à valeur doublée
+* Et le videau passe de votre côté : vous seul pourrez redoubler
+
+## Scénario : Passer le double de l'ordinateur
+
+* Étant donné que l'ordinateur vous propose de doubler
+* Quand vous touchez « Passer »
+* Alors la partie s'arrête
+* Et vous perdez la partie à sa valeur d'avant le double
+
+## Scénario : Finir la partie
+
+* Étant donné qu'un joueur a sorti tous ses pions
+* Alors la partie s'arrête
+* Et le résultat indique le gagnant et les points gagnés : simple, gammon ou backgammon, multipliés par le videau