ADR 0013 amendé : une adresse pour chaque écran, de vrais liens

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Pierre MARTIN
2026-11-03 19:55:57 +01:00
co-authored by Claude Opus 5.5
parent 5f66535051
commit 342011ad0d
4 changed files with 59 additions and 8 deletions
+38
View File
@@ -47,3 +47,41 @@ moteur sait les lire et les écrire (`engine.h`).
- Les liens restent valables tant que GNU Backgammon garde ces formats, stables
depuis des années.
- Les liens contiennent la position, rien d'autre : pas de donnée personnelle.
## Amendements
### 2026-11-03 — Une adresse pour chaque écran, des liens plutôt que des états
Demandé par Pierre : « il faudra vraiment que chaque page (l'aide, etc.) ait
une URL. Utilise des liens accessibles, pas des états. » Aucun lien de
position n'a encore circulé : le format ci-dessus est remplacé par un schéma
unique pour tous les écrans, avant sa première mise en œuvre.
- Chaque écran a son adresse, dans le fragment (pour les mêmes raisons
qu'au-dessus : hors ligne, service worker, aucune configuration serveur) :
| Écran | Adresse |
| --- | --- |
| Partie en cours | `#/` |
| Accueil | `#/accueil` |
| Aide (onglet Jouer) | `#/aide`, une question : `#/aide/<identifiant>` |
| Les mots du jeu | `#/glossaire`, un terme : `#/glossaire/<fichier sans .md>` |
| À propos | `#/a-propos` |
| Tutoriel | `#/tutoriel`, une étape : `#/tutoriel/<n>` |
| Mes parties | `#/parties`, une partie : `#/parties/<id>` |
| Réglages / menu | `#/menu` |
| Une position | `#/position/<Position ID>/<Match ID>` (Match ID facultatif) |
Les identifiants de gnubg sont encodés avec `encodeURIComponent`. Les
écrans à venir (analyse, leçons, progression) suivront le même schéma.
- On change d'écran par de vrais liens (`<a href="#/aide">`), pas par des
boutons qui modifient un état caché : le lien se partage, s'ouvre dans un
nouvel onglet, se lit aux lecteurs d'écran comme un lien, et le bouton
« retour » du téléphone ramène à l'écran précédent. Les actions de jeu
(lancer, jouer, doubler) restent des boutons : elles ne sont pas des écrans.
- Les feuilles (menu, explication) et panneaux qui sont des écrans à part
entière ont aussi leur adresse ; une confirmation ou un bandeau éphémère
n'en a pas.
- Une adresse inconnue mène à la partie en cours avec un message clair.
- L'adresse de l'écran courant est la source de vérité de la navigation :
l'application l'écoute (`hashchange`) et dessine l'écran correspondant.