pierre/Ustagammon
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Activity

ADR 0013 : position dans l'adresse ; plan 0e.4 #29

Manually merged
pierre merged 1 commits from position-dans-adresse-plan into main 2026-11-03 13:51:07 +00:00
Conversation 0 Commits 1 Files Changed 4
+90 -1
pierre commented 2026-11-03 09:25:51 +00:00
Owner
Copy Link
Copy Source

Pourquoi

Au premier test sur le téléphone, le 2026-11-03, Pierre a demandé ceci (point 4 de son message) : « il serait top qu'avec la seule URL on puisse arriver à une position du plateau, ainsi chaque position pourrait être un lien direct vers lui ».

Le besoin est le sien. Le format de l'adresse est un choix technique, qui sera durable dès que des liens circuleront. Il est donc consigné dans un ADR avant toute implémentation.

Quoi

  • ADR 0013, « Une position du plateau dans l'adresse de la page » :
    • format #position=<Position ID>&match=<Match ID>, avec les identifiants de GNU Backgammon placés dans le fragment de l'adresse ;
    • une vue non jouable de la position, avec « Jouer à partir d'ici » et « Retour à ma partie » ;
    • « Copier le lien de la position » ;
    • un message clair si le lien est illisible.
  • Plan de la sous-étape 0e.4 : docs/plans/2026-11-03-position-dans-l-adresse.md.
  • Index des ADR et feuille de route mis à jour.

Comment

Les identifiants de gnubg décrivent déjà toute la position. Le moteur sait les lire et les valider : il n'y a rien à réimplémenter (ADR 0007).

Le fragment ne part jamais au serveur. Le service worker sert donc la même page en cache, et le lien marche hors ligne.

Choix et compromis

Option Décision Raison
Paramètres de requête Écartés Ils changent l'adresse mise en cache.
XGID Écarté pour l'instant Il pourra s'ajouter à l'import plus tard.
Format maison Écarté Il faudrait le décoder sans le moteur.

Le comportement à l'ouverture d'un lien (vue non jouable, puis « Jouer à partir d'ici ») est une proposition minimale. Pierre peut l'ajuster.

Risques et déploiement

Documentation seule.

Comment vérifier

make lint && make test

Hors périmètre

  • L'implémentation, après la révision UX (0e.3), qui touche les mêmes fichiers.
  • L'import XGID.

Generated with Claude Code https://claude.com/claude-code

## Pourquoi Au premier test sur le téléphone, le 2026-11-03, Pierre a demandé ceci (point 4 de son message) : « il serait top qu'avec la seule URL on puisse arriver à une position du plateau, ainsi chaque position pourrait être un lien direct vers lui ». Le besoin est le sien. Le format de l'adresse est un choix technique, qui sera durable dès que des liens circuleront. Il est donc consigné dans un ADR avant toute implémentation. ## Quoi - **ADR 0013, « Une position du plateau dans l'adresse de la page »** : - format `#position=<Position ID>&match=<Match ID>`, avec les identifiants de GNU Backgammon placés dans le fragment de l'adresse ; - une vue non jouable de la position, avec « Jouer à partir d'ici » et « Retour à ma partie » ; - « Copier le lien de la position » ; - un message clair si le lien est illisible. - **Plan de la sous-étape 0e.4** : `docs/plans/2026-11-03-position-dans-l-adresse.md`. - **Index des ADR et feuille de route** mis à jour. ## Comment Les identifiants de gnubg décrivent déjà toute la position. Le moteur sait les lire et les valider : il n'y a rien à réimplémenter (ADR 0007). Le fragment ne part jamais au serveur. Le service worker sert donc la même page en cache, et le lien marche hors ligne. ## Choix et compromis | Option | Décision | Raison | | --- | --- | --- | | Paramètres de requête | Écartés | Ils changent l'adresse mise en cache. | | XGID | Écarté pour l'instant | Il pourra s'ajouter à l'import plus tard. | | Format maison | Écarté | Il faudrait le décoder sans le moteur. | Le comportement à l'ouverture d'un lien (vue non jouable, puis « Jouer à partir d'ici ») est une proposition minimale. Pierre peut l'ajuster. ## Risques et déploiement Documentation seule. ## Comment vérifier ``` make lint && make test ``` ## Hors périmètre - L'implémentation, après la révision UX (0e.3), qui touche les mêmes fichiers. - L'import XGID. Generated with Claude Code https://claude.com/claude-code
pierre added 1 commit 2026-11-03 09:25:52 +00:00
ADR 0013 : position dans l'adresse ; plan 0e.4 b28a37d411 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
pierre manually merged commit 7c1163054a into main 2026-11-03 13:51:07 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
pierre (Pierre Martin)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: pierre/Ustagammon#29