games/docs/rules/FILE_CONTRACTS.md

Contrats des fichiers principaux

• README.md présente le dépôt et ses entrées principales.
• RULES.md indexe les règles normatives.
• ROADMAP.md conserve le planning durable et son historique de scope via ( ), (x), (d) et (c).
• CHANGELOG.md conserve une synthèse inversement chronologique à partir des jalons RC et stables.
• docs/000-README.md indexe la documentation détaillée.
• docs/rules/ contient les règles durables.
• docs/ideas/ contient des idées et variantes non engagées.
• docs/studies/ contient des analyses comparatives non normatives préparant une décision.
• docs/architecture/ contient les décisions et descriptions d'architecture retenues.
• docs/objectives/ décrit les objectifs et la stratégie produit/technique.
• docs/games/ classe les familles de jeux, leurs contrôles et leurs évolutions.
• docs/engine/ décrit l’évolution fonctionnelle des générations de moteur.
• docs/monetization/ décrit les modèles de monétisation indépendamment des fournisseurs.
• docs/services/ décrit leaderboards, backend, partage, anti-cheat et services communautaires.
• docs/development/ décrit les workflows de développement non normatifs complémentaires aux règles.
• docs/testing/ décrit l’architecture des tests, leur placement et les stratégies de sélection.
• crates/common/ contient les bibliothèques transverses indépendantes d’une génération spécifique du moteur, notamment le socle de logging.
• deltas/ contient un document par livraison ou correctif versionné.
• prompts/ peut contenir les prompts de reprise de session lorsqu'ils deviennent utiles.
• scripts/ contient des audits en lecture seule et des outils du dépôt.
• assets/ contient les ressources runtime communes et spécifiques aux jeux ; aucune ressource runtime n'est placée dans une crate Rust.
• Android/ contient le projet Gradle multi-module et son code Java commun/spécifique.
• crates/apps/ contient les exécutables de développement et launchers Rust, notamment les runners Desktop par jeu.

Tauri

• crates/apps/<game>-tauri/frontend/ contient le frontend Vite/TypeScript versionné.
• crates/apps/<game>-tauri/src/lib.rs est la façade Rust de l'app Tauri.
• crates/apps/<game>-tauri/src/tauri.rs assemble Tauri et porte le pont Web/Rust.
• crates/apps/<game>-wasm/ contient l'adaptation WebAssembly distincte.
• Les bindings JavaScript et modules .wasm générés restent ignorés par Git.