Développer et contribuer
Démarrer
Lire README.md ou README.fr.md, puis CONTRIBUTING.md / CONTRIBUTING.fr.md. Installer Node 24.22.3 ; pour le binaire Windows, Rust 1.88.0, MSVC et WebView2. Le harness Node/Lua fonctionne sans WoW, sur Windows et Linux.
npm ci --ignore-scripts
npm run verify
npm --prefix documentation ci --ignore-scripts
npm --prefix documentation run verifyCréer une branche courte, par exemple docs/prix-historiques ou fix/retours-variantes. Les commits expliquent une modification cohérente et sa raison. La PR décrit le problème concret, le comportement obtenu, les validations exécutées et les limites restantes.
Où modifier
| Besoin | Point de départ |
|---|---|
| Calcul / décision | engine/lib |
| Interface desktop | engine/public |
| Shell natif | source/src-tauri |
| Jeu / TSM | addon/DonjonsEtPognons |
| Harness / packaging | scripts et tests |
| Référence humaine | documentation/content et content/en |
Reproduire un défaut financier avec une fixture synthétique avant correction. Couvrir les frontières pertinentes : identité, âge, commission, quantité, réserve, relecture. Un test qui recopie simplement la formule n'est pas une preuve indépendante.
Avant de proposer
Exécuter les contrôles concernés, mettre à jour les deux langues et le changelog, vérifier git diff --check et l'absence de fichiers privés. Toute nouvelle source partageable doit entrer dans release-files.json ; ne pas élargir l'export à tout le répertoire. Les dépendances restent épinglées avec lockfiles. Les décisions structurantes nécessitent un ADR.
Le code conserve sa licence MIT existante. Le dépôt privé ne modifie pas cette licence. Les dépendances et assets tiers gardent leurs propres conditions ; consulter LICENSE et docs/ASSET-NOTICES.txt avant redistribution.
