Pierre MARTINandClaude Opus 5.5
a8636b3f83
L'application est à la racine du site : plateau en SVG, saisie au toucher (pion puis case d'arrivée, proposées à partir du moteur), boutons du jet, du videau et de nouvelle partie, coup de l'ordinateur affiché avec son temps, fin de partie, reprise depuis localStorage, aide lue dans les copies de docs/. Le moteur tourne dans le Web Worker existant ; main.ts est le seul assembleur (nouvelles règles dependency-cruiser). Le service worker met tout le site en cache, avec une empreinte du contenu comme version. Les pages de test du moteur passent sous /moteur/. Politique de sécurité du contenu dans le Caddyfile ; make test-browser joue une partie dans Chromium et Firefox sans écran (Playwright, hors de make test). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
74 lines
4.0 KiB
Markdown
74 lines
4.0 KiB
Markdown
# Crédits
|
|
|
|
Ustagammon est un logiciel libre sous licence GPLv3 (voir `LICENSE`).
|
|
Les contenus pédagogiques (leçons, textes) sont sous licence CC BY-SA 4.0.
|
|
|
|
## Moteur
|
|
|
|
- **GNU Backgammon** — https://www.gnu.org/software/gnubg/
|
|
Copyright © les auteurs de GNU Backgammon. Licence GPLv3 ou ultérieure.
|
|
Ustagammon s'appuie entièrement sur son moteur pour les règles, les coups,
|
|
le videau et les évaluations. Copie non modifiée de son cœur dans
|
|
`engine/gnubg/` (commit 14b6798 ; liste dans `engine/gnubg/PROVENANCE.md`),
|
|
avec ses poids `gnubg.weights` dans `engine/data/`.
|
|
- **Table d'équité de match Kazaross-XG2** (`engine/data/Kazaross-XG2.xml`),
|
|
Copyright © 2011 Neil Kazaross, transcrite pour gnubg par Michael Petch ;
|
|
distribuée avec gnubg, copie libre sous réserve de garder sa notice.
|
|
|
|
Étudié comme référence de lecture, sans reprise de code :
|
|
|
|
- **CBG**, portage Android de GNU Backgammon (GPLv3) —
|
|
https://github.com/clavierhaus/gnubg-android ; son fichier
|
|
`jni-bridge/src/stubs.c` a servi de repère pour isoler le cœur de gnubg.
|
|
|
|
## Outils de développement
|
|
|
|
- **ShellCheck** (GPLv3), analyse des scripts shell, utilisé via Docker.
|
|
- **Node.js** (MIT), image `node:22.11.0-alpine3.20`, et **@cucumber/gherkin**
|
|
(MIT), analyseur Gherkin qui valide les scénarios de `docs/scenarios/`.
|
|
- **Debian** (image Docker `debian:trixie`, logiciels libres sous leurs
|
|
licences respectives), base de l'image du gnubg de référence.
|
|
- **GNU Backgammon** (GPLv3 ou ultérieure), compilé dans Docker au commit
|
|
14b67984737ded0f6de43d63dcb789f729d9b06b depuis
|
|
https://git.savannah.gnu.org/git/gnubg.git, sert de référence aux tests
|
|
(`docker/gnubg-reference/`, `tests/reference/`). Les résultats de
|
|
`tests/reference/results/` et les données `gnubg.wd`, `gnubg_os0.bd`,
|
|
`gnubg_ts0.bd` sont produits par ce programme.
|
|
- **Image `ustagammon/build-c`** (`docker/build-c/Dockerfile`), construite sur
|
|
Debian trixie : gcc (GPLv3 avec exception d'exécution), make (GPLv3),
|
|
GLib (LGPL 2.1 ou ultérieure, uniquement pour les outils `makeweights` et
|
|
`makebearoff` lancés au build ; le moteur embarqué n'en contient rien),
|
|
**Python 3** (licence PSF, compatible GPL), qui exécute le comparateur
|
|
`tests/reference/compare.py`, et **jq** (licence MIT), qui lit les JSON
|
|
dans `tests/test_reference.sh`. Aucun des deux n'est utilisé sur le PC.
|
|
Le serveur HTTP de Python sert aussi le site sur le réseau local (`make deploy`).
|
|
- **Emscripten** (licence MIT et University of Illinois/NCSA), image Docker
|
|
`emscripten/emsdk:3.1.64`, compile le moteur en WebAssembly
|
|
(`make engine-wasm`). Le code JavaScript qu'il génère
|
|
(`build/wasm/engine.mjs`) et sa bibliothèque C (musl, licence MIT) sont
|
|
inclus dans le moteur WebAssembly, licences compatibles GPLv3. L'image
|
|
fournit aussi **Node.js** (MIT), qui rejoue la suite de contrat sur le
|
|
moteur WebAssembly et lance `make bench`.
|
|
- **Image `ustagammon/web`** (`docker/web/Dockerfile`), construite sur
|
|
`node:22.11.0-alpine3.20` : **TypeScript** 6.0.3 (Apache-2.0), qui compile
|
|
`app/` ; **@types/node** 22.20.5 (MIT), types de Node pour les tests ;
|
|
**Biome** 2.5.15 (MIT ou Apache-2.0), lint et formatage ;
|
|
**@cucumber/cucumber** 12.9.0 (MIT), qui exécute les scénarios de
|
|
`docs/scenarios/` ; **dependency-cruiser** 18.6.0 (MIT), qui vérifie les
|
|
règles d'architecture. Ces outils et leurs dépendances servent seulement à
|
|
compiler et tester : rien n'est embarqué dans l'application.
|
|
- **Playwright** 1.48.2 (Apache-2.0), image Docker
|
|
`mcr.microsoft.com/playwright:v1.48.2-noble` (Chromium, Firefox, WebKit,
|
|
sous leurs licences libres) et paquet npm `playwright`, installé dans
|
|
`build/browser-tools/` : joue une partie dans des navigateurs sans écran
|
|
(`make test-browser`). Outil de test seulement, hors de `make test`.
|
|
|
|
## Serveur de production
|
|
|
|
- **Caddy** (Apache-2.0), image `caddy:2.8.4-alpine`, serveur statique du
|
|
site publié sur CapRover (`deploy/`).
|
|
|
|
## Remerciements
|
|
|
|
À l'Atelier du Huit, café associatif de Cugnaux, et à Philippe, qui y transmet le jeu.
|