foundryvtt-reve-de-dragon/test/README.md

Tests — Rêve de Dragon FoundryVTT

Architecture

tests/
├── rdd_test_plan.md          # Plan de test (227 cas, 33 sections)
└── scripts/
    ├── tc-header.sh           # Fonctions partagées (login, assertions, extraction JSON)
    ├── run-all-tests.sh       # Orchestrateur (sélection, exécution, rapport final)
    ├── tc-01-infrastructure.sh … tc-31-meteo.sh   # 29 scripts TC
    └── …

Tous les scripts utilisent chrome-devtools (CLI) pour interagir avec Foundry via evaluate_script.

Lancement

Prérequis

• Foundry VTT démarré sur https://localhost:31000
• Chrome-devtools connecté au navigateur (port 9222)
• Le monde « Reve de Dragon » chargé et game.ready = true

Orchestrateur — run-all-tests.sh

L'orchestrateur exécute une sélection de tests et affiche un rapport final.

# Tous les tests
./tests/scripts/run-all-tests.sh --tests all

# Sous-ensemble (syntaxe: numéros séparés par virgules, ranges avec tiret)
./tests/scripts/run-all-tests.sh --tests 01,08,10,22

# TC-08 à TC-16 (plage)
./tests/scripts/run-all-tests.sh --tests 08-16

# Tests critiques uniquement
./tests/scripts/run-all-tests.sh --tests 01,02,08,10,12,15,16,22,27

# Sans le rapport final
./tests/scripts/run-all-tests.sh --tests all --no-report

# Aide
./tests/scripts/run-all-tests.sh --help

Démarrage du monde : si game.ready n'est pas détecté au lancement, le script affiche les instructions et attend que l'utilisateur démarre le monde manuellement dans le navigateur (sélection du monde, connexion GM), puis appuie sur ENTRÉE. Timeout de 120s.

Script individuel

# Sur une session déjà active (game.ready=true)
./tests/scripts/tc-08-roll-v1.sh

# Avec login auto (nécessite PASS=admin password)
PASS=Slaanesh666 ./tests/scripts/tc-08-roll-v1.sh --navigate

Liste des tests

TC	Script	Description	Tests
TC-01	tc-01-infrastructure.sh	Infrastructure cœur (settings, classes, sheets)	15
TC-02	tc-02-acteur-personnage.sh	Acteur personnage (caracs, comp, santé, moral)	20
TC-03	tc-03-acteur-creature.sh	Acteur créature	3
TC-04	tc-04-acteur-entite.sh	Acteur entité	4
TC-05	tc-05-acteur-vehicule.sh	Acteur véhicule	2
TC-06	tc-06-acteur-commerce.sh	Acteur commerce	3
TC-07	tc-07-feuilles-item.sh	Feuilles d'item (44 types, scroll)	44
TC-08	tc-08-roll-v1.sh	Système de jet V1 (RdDRoll)	8
TC-09	tc-09-roll-v2.sh	Système de jet V2 (RollDialog)	4
TC-10	tc-10-des-custom.sh	Dés custom (d8 TMR, d8 draconic, d12 heure)	5
TC-11	tc-11-combat.sh	Combat (RdDCombat, initiative)	3
TC-12	tc-12-calendrier.sh	Calendrier / temps	6
TC-13	tc-13-sommeil.sh	Sommeil / repos (château dormant, stress)	3
TC-14	tc-14-voyage.sh	Voyage (dialog fatigue)	2
TC-15	tc-15-tmr.sh	TMR (recherche, aléatoire, coordonnées)	7
TC-16	tc-16-commandes-chat.sh	Commandes chat (/table, /meteo, /ddr, /chrono)	11
TC-17	tc-17-token-hud.sh	Token HUD	2
TC-18	tc-18-dialogues.sh	Dialogues V2 (positionnement, boutons)	3
TC-19	tc-19-tirage.sh	Tirage (FenetreRechercheTirage)	2
TC-20	tc-20-gen-aleatoire.sh	Génération aléatoire (nom)	2
TC-22	tc-22-compendiums.sh	Compendiums (packs, drag → acteur)	6
TC-23	tc-23-css-ui.sh	CSS / UI (police, sélecteurs natifs)	3
TC-25	tc-25-hotbar.sh	Hotbar (RdDHotbar)	2
TC-26	tc-26-possession.sh	Possession V2	2
TC-27	tc-27-active-effects.sh	Active effects (création, application, suppression)	6
TC-28	tc-28-journal.sh	Journal sheet	2
TC-29	tc-29-coeur.sh	Cœur (attachment)	2
TC-30	tc-30-appreciation.sh	Appréciation	2
TC-31	tc-31-meteo.sh	Météo	3

TC-21 (Migrations), TC-24 (Export), TC-32 (Sons), TC-33 (Remote/Socket) sont manuels uniquement (MAN dans le plan de test).

API des scripts

Variables d'environnement

Variable	Rôle	Défaut
URL	URL Foundry	https://localhost:31000
PASS	Mot de passe admin (pour --navigate)	requis si --navigate
PASS_USER	Mot de passe utilisateur (si différent)	vide

Fonctions partagées (tc-header.sh)

Fonction	Description
jse_get "JS_BODY"	Exécute () => { JS_BODY } synchrone, retourne le JSON
jse_get_async "JS_BODY"	Exécute async () => { JS_BODY }, retourne le JSON
jse_wait_ready TIMEOUT POLL	Poll game.ready pendant TIMEOUT secondes
tc_login	Navigation + login admin (via --navigate)
tc_ensure_ready	Vérifie game.ready, login si --navigate
eval_ok "$JSON" "key"	Extrait une clé du JSON résultat
tc_console_errors	Compte les erreurs console
assert_eq / assert_gt / assert_contains	Assertions
pass / fail / die	Affichage des résultats

Conventions

• Chaque script est autonome : setup (création d'acteurs/items) → tests → cleanup.
• Le polling game.ready est interne à un seul evaluate_script asynchrone (pas de boucle bash) pour éviter les races de page.
• Les opérations lourdes (création d'acteurs, ouverture de sheets) sont regroupées dans un seul evaluate_script atomique.
• Chaque script affiche ✔/✘ par test et un résumé final N / M passed.

Commandes utiles (console manuelle)

CONFIG.debug.hooks = true  # log tous les hooks Foundry