From c061b6d41bda13e053624ef65daa1672020c26c0 Mon Sep 17 00:00:00 2001 From: Pierre MARTIN Date: Tue, 3 Nov 2026 15:02:01 +0100 Subject: [PATCH] Plan 0e.5 : accueil, installation, tutoriel, aide Co-Authored-By: Claude Opus 5.5 --- docs/feuille-de-route.md | 2 +- .../plans/2026-11-03-accueil-tutoriel-aide.md | 59 +++++++++++++++++++ 2 files changed, 60 insertions(+), 1 deletion(-) create mode 100644 docs/plans/2026-11-03-accueil-tutoriel-aide.md diff --git a/docs/feuille-de-route.md b/docs/feuille-de-route.md index 88a9530..d19aa37 100644 --- a/docs/feuille-de-route.md +++ b/docs/feuille-de-route.md @@ -25,7 +25,7 @@ Demandes de Pierre du 2026-11-03, traitées avant d'ouvrir l'étape 1. | --- | --- | --- | --- | | 0e.3 | Révision UX arbitrée (session « identité », sur délégation de Pierre) : portrait stable, bandeaux de compte de points, menu en feuille et nouvelle partie annulable, vibrations, écran allumé, paysage « plateau = écran » dès la rotation (ADR 0012 amendé) | ⏳ | `plans/2026-11-03-revision-ux.md` | | 0e.4 | Position dans l'adresse : chaque position du plateau a un lien direct (ADR 0013) | ⏳ | `plans/2026-11-03-position-dans-l-adresse.md` | -| 0e.5 | Page d'accueil, installation en un toucher (« Ajouter à l'écran d'accueil », proposée par l'app), tutoriel des règles très didactique avec plateaux illustrés, aide réécrite sur un ton plus humain ; textes à valider par Pierre | ⏳ | | +| 0e.5 | Page d'accueil, installation en un toucher (« Ajouter à l'écran d'accueil », proposée par l'app), tutoriel des règles très didactique avec plateaux illustrés, aide réécrite sur un ton plus humain ; textes à valider par Pierre | ⏳ | `plans/2026-11-03-accueil-tutoriel-aide.md` | ## Étapes suivantes diff --git a/docs/plans/2026-11-03-accueil-tutoriel-aide.md b/docs/plans/2026-11-03-accueil-tutoriel-aide.md new file mode 100644 index 0000000..addb98b --- /dev/null +++ b/docs/plans/2026-11-03-accueil-tutoriel-aide.md @@ -0,0 +1,59 @@ +# Accueil, installation, tutoriel des règles, aide (0e.5) + +- **Date** : 2026-11-03 +- **Étape** : 0e.5 (feuille de route), qui couvre aussi le tutoriel de 1g +- **Statut** : prévu (après la fusion de 0e.4) +- **Exécutant** : sous-agent general-purpose, dans un worktree + +## Objectif + +Traiter les points 2 et 3 du message de Pierre du 2026-11-03 et sa demande d'installation en un toucher : +- une page d'accueil ; +- l'installation proposée par l'app ; +- un tutoriel des règles très didactique, illustré par le plateau ; +- une aide plus humaine. + +## Références + +- Règles : `docs/identite/charte/accueil-tutoriel-aide.md`. Le texte du tutoriel y figure en première version, à faire valider par Pierre. +- Maquettes : https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe, rangée « Étape 0e.5 » et artboard « Accueil ». +- ADR 0008 (source unique), ADR 0013 (positions par identifiants gnubg). + +## Consignes + +1. **Accueil**, selon la charte : + - au premier lancement, et une seule fois, le choix entre « Je découvre » et « Je connais les règles » ; + - ensuite : la partie en cours, la carte d'installation, la prochaine leçon et la progression résumée. La leçon et la progression restent en attente tant que 1g et 1h n'existent pas : n'afficher que ce qui existe. +2. **Installation** : + - sous Chrome, garder l'invite reçue avec `beforeinstallprompt` ; + - sous Firefox et sur iPhone, une feuille en 3 étapes ; + - la carte n'apparaît qu'à partir de la première partie terminée. « Plus tard » la masque, et elle ne revient qu'une fois, après 3 parties. Le menu garde une ligne tant que l'app n'est pas installée ; + - plus rien en `display-mode: standalone` ni après l'événement `appinstalled`. +3. **Tutoriel**, en 8 étapes : + - le texte vit dans un fichier source unique sous `docs/` (par exemple `docs/tutoriel/`), copié dans le site par `make site` comme le glossaire, sous licence CC BY-SA 4.0 ; + - positions données par leurs identifiants gnubg ; + - sur les écrans « à vous », le moteur vérifie le coup joué en le comparant aux coups attendus de l'étape ; + - le coup illustré se joue seul après 1 s, avec « Revoir » ; + - un test vérifie que chaque position du tutoriel est valide pour le moteur et que chaque coup attendu est légal ; + - ajouter la fiche du glossaire « camp ». +4. **Aide**, en trois onglets : + - « Jouer » : les scénarios deviennent des questions repliables. Le titre est la question et la description la réponse ; les étapes Gherkin sont cachées. Reformuler les titres des `.feature` sans casser les tests ; + - « Les mots du jeu » : les cartes du glossaire, avec une recherche ; + - « À propos » : licence, crédits, version ; + - le tutoriel est proposé en tête de l'aide. +5. **Scénarios Gherkin** : premier lancement, installation, suivre le tutoriel. +6. **`make test-browser`** : + - premier lancement, tutoriel complet avec ses écrans « à vous », aide ; + - `beforeinstallprompt` simulé dans Chromium ; + - captures dans `build/browser-shots/accueil-tutoriel/` pour la recette design. + +`make lint`, `make test` et `make test-browser` doivent passer. Aucune nouvelle dépendance. + +## Critères de réussite + +- Un débutant suit le tutoriel jusqu'au bout sur le téléphone, et chaque écran « à vous » accepte le bon coup et refuse les autres. +- Les trois commandes passent, et les captures sont livrées pour la recette. + +## Résultat + +À remplir à la clôture.