Statut : à faire (LOT-77 écrit ce document ; la filière LOT-30 → LOT-84 l'applique). Dépend de vision.md (le catalogue en JSON d'EX-VIS-007) et de architecture.md (frontière Core / HMI).

Le jeu visé est un bac à sable dans un univers complet : dix régions, seize classes, treize espèces, cent-soixante-seize créatures. Aucune de ces valeurs ne peut vivre dans du C++ — ni en constante, ni en switch, ni en table codée en dur. Ce document porte les exigences de la filière données : d'où vient une donnée, ce qu'elle promet, et comment le moteur se comporte quand elle promet plus qu'il ne sait tenir.

Il ne dit pas ce que contiennent les catalogues — c'est l'objet de [regles-dnd.md](Règles d20), rpg.md, combat.md et inventaire.md. Il dit comment ils sont produits, validés et honorés.

1. Provenance

Le projet est privé et sans diffusion : les licences du corpus ne contraignent pas l'usage. Mais elles ne sont pas supprimées, elles sont endormies — elles se réveillent le jour d'une publication. La discipline qui garde cette porte ouverte tient en un champ.

EX-CNT-001 — Toute donnée produite doit porter un champ source parmi srd, tanares, phb-fr et original. Le jour où la question « qu'est-ce qui devrait sauter en cas de publication ? » se pose, elle se répond par une requête et non par une relecture de tout le catalogue. Le coût est d'une ligne par fichier, payée d'avance ; la relecture, elle, se paierait sur des milliers d'entrées et se tromperait.
EX-CNT-002 — Le champ source est obligatoire au schéma, pas recommandé par convention : une donnée qui ne le porte pas fait échouer la validation. Une discipline facultative n'est pas tenue sur cinq mille fichiers.

2. Contrats avant données

EX-CNT-010 — Chaque famille de données (créature, objet, arme, armure, sort, espèce, classe, historique, état, type de dégâts) doit être décrite par un JSON Schema, et toute donnée livrée doit être validée en intégration continue. Un échec doit nommer le fichier et la ligne fautifs : un message qui dit seulement « donnée invalide » sur un catalogue de mille entrées ne sert à rien.
EX-CNT-011 — Les énumérations partagées entre le C++ et les schémas (types de dégâts, conditions, écoles de magie…) doivent être vérifiées identiques par un test. C'est le point exact où une donnée et un moteur divergent en silence : le JSON déclare psychique, le C++ ne connaît que Psychic, la valeur tombe dans le cas par défaut, et le sort cesse de faire des dégâts sans que rien ne l'annonce. Ajouter une valeur d'un seul côté doit faire échouer la compilation ou un test, jamais produire un jeu silencieusement faux.
EX-CNT-012 — Le chargement d'un catalogue doit passer par une brique de lecture unique — ouverture, parsage, validation par schéma, report d'erreur situé, conversion vers un agrégat typé. Aucun catalogue ne porte sa propre routine de lecture ni sa propre validation écrite à la main. Le dépôt en comptait six variantes avant que la filière n'existe ; en ajouter une par catalogue serait multiplier par vingt un défaut déjà identifié.

3. Extraction du corpus

Les données proviennent de PDF, par une chaîne d'extraction outillée. Cette chaîne n'est pas un script jetable : elle est rejouée à chaque correction du corpus.

EX-CNT-020 — L'extraction doit être reproductible : deux exécutions successives sur le même document produisent des sorties identiques. Chaque document source est enregistré dans un manifeste avec son empreinte SHA-256, son nombre de pages et son décalage de pagination. Une empreinte qui ne correspond plus doit faire échouer l'extraction, et non produire des données silencieusement décalées : les livres du corpus sont paginés en double page, et une correspondance fausse cible systématiquement le mauvais chapitre.
EX-CNT-021 — Un tableau ne doit jamais être extrait par un mode de rendu en flux de texte (-layout ou équivalent), mais par regroupement des mots selon leur coordonnée. Le mode en flux mélange les colonnes : sur la table des armes, il attribue le poids et le prix à l'arme de la ligne suivante. La donnée est alors fausse, et fausse silencieusement — ce qui est pire qu'une extraction qui échoue.
EX-CNT-022 — Une image doit être obtenue par rendu d'une région de page, jamais par extraction de l'objet image brut : sur ce corpus, le flux brut produit des zones de bruit vert et cyan, quand le rendu passe par la composition complète et donne un résultat exact. Corollaire assumé : le rendu embarque tout ce qui est dessiné dans la région, texte compris, ce qui rend l'extraction d'illustrations semi-automatique — l'outil propose, l'humain recadre.
EX-CNT-023 — Le corpus source et le texte intermédiaire produit par l'extraction ne sont pas versionnés ; les données finales le sont. Le corpus pèse des centaines de mégaoctets de binaires que le gestionnaire de versions compresse mal et que chaque clone traînerait. L'intermédiaire, lui, se régénère à la demande — le versionner reviendrait à versionner un cache.

4. Ce qu'une donnée promet

C'est le cœur de ce document. Le catalogue sera complet longtemps avant le moteur : importer une classe prend une après-midi, faire que le moteur la joue correctement est un programme entier. L'écart doit être déclaré et consultable, jamais découvert en jeu.

EX-CNT-030 — Toute donnée doit déclarer les mécanismes qu'elle exige (emplacements de sorts, ressource propre, liste de sorts dédiée, choix de sous-classe à un niveau donné, substitution de profil…). Une donnée qui ne déclare rien promet de ne rien exiger, et le moteur peut la servir en confiance.
EX-CNT-031 — Le moteur doit refuser en le disant ce qu'il ne sait pas honorer : toute donnée exigeant un mécanisme absent est listée au chargement et n'est jamais jouée en silence. Une classe dont la ressource propre n'existe pas dans le moteur ne doit pas se présenter comme une classe ordinaire amputée de ce qui la définit — c'est ainsi qu'on livre un jeu qui ment sur ce qu'il sait faire. La liste des mécanismes manquants est un état d'avancement consultable, pas une erreur fatale.
EX-CNT-032 — Une donnée provisoire doit porter un champ de statut le déclarant, l'intégration continue doit énumérer ce qui le porte, et son critère de retrait doit être écrit d'avance. Une donnée provisoire non marquée devient permanente par accident : c'est la façon la plus banale dont un échafaudage finit en mur porteur.

5. Assets

EX-CNT-040 — Une donnée doit désigner son illustration par une clé d'asset, jamais par un chemin de fichier. Un chemin dans une donnée de règle lie le catalogue à l'arborescence du disque : tout déplacement de dossier casse alors des créatures.
EX-CNT-041 — Toute clé d'asset sans image doit obtenir un marqueur généré, de sorte que le jeu tourne complet avant qu'aucune illustration ne soit produite. L'intégration continue liste les clés encore servies par un marqueur sans échouer : c'est un état d'avancement, pas un défaut. La production graphique devient un remplacement progressif, jamais un préalable bloquant.

6. Contrôle de plausibilité

La validation par schéma dit qu'un fichier est bien formé. Elle ne dit rien de sa plausibilité : un loup à classe d'armure 47, une épée à trois pièces d'or au lieu de trente, une créature de facteur ⅛ avec quatre-vingt-dix points de vie franchissent un schéma sans broncher.

EX-CNT-050 — Les catalogues doivent être soumis à un contrôle statistique de plausibilité : bornes attendues d'une valeur au regard des autres champs de la même entrée. Ce qui sort des bornes est signalé, pas rejeté — une créature volontairement hors norme existe, une extraction ratée aussi, et seul un humain les distingue. Une anomalie acceptée est enregistrée dans la donnée pour ne pas être re-signalée à chaque exécution : un avertissement qu'on réapprend à ignorer ne protège plus de rien.

7. Atlas du monde

Les catalogues précédents décrivent des choses — une créature, une arme, un don. L'atlas décrit un espace, et un espace a une propriété qu'aucune liste n'a : on peut s'y perdre, ou plutôt, un morceau peut devenir inaccessible sans que rien ne le dise.

EX-CNT-060 — Les statistiques régionales doivent être typées : une note prise dans une énumération fermée et ordonnée, jamais du texte libre. Ce sont des paramètres de jeu — présence de monstres, accès à la magie, prospérité — et un moteur qui doit comparer « Very High » à « High » par une comparaison de chaînes le fera dans l'ordre alphabétique, où High précède Very High mais aussi Low.
EX-CNT-061 — Une statistique régionale doit pouvoir porter plusieurs appréciations avec leur portée. La source distingue le nord du sud, la surface du souterrain ; aplatir ces cas sur une valeur unique invente une donnée, et les laisser en texte libre viole l'EX-CNT-060. Une région uniforme n'en porte qu'une, sans portée — le cas courant reste simple.
EX-CNT-062 — Le graphe des régions doit être connexe et son voisinage symétrique, et les deux doivent être vérifiés en intégration continue sur la donnée livrée, pas seulement par l'outil qui l'a produite. Une région injoignable est du contenu que personne ne verra jamais : le jeu se lance, la région existe, elle est simplement au bout d'aucun trajet — il n'y a aucun symptôme à observer.