games/docs/000-README.md

Documentation games.sasedev

Objectifs

• objectives/001-PROJECT_OBJECTIVES.md — finalité, principes structurants, stratégie de construction et vision du SDK.

Idées et études

• ideas/000-README.md — rôle des idées non engagées et règles de maturation.
• studies/000-README.md — rôle des études comparatives non normatives.

Architecture

• architecture/001-WORKSPACE_ARCHITECTURE.md — workspace, générations de moteur, jeux, runners, assets et Android.
• architecture/002-ANDROID_ARCHITECTURE.md — séparation Rust/SDL3/Java/JNI et modules Android.
• architecture/003-SDL3_PLATFORM_ABSTRACTION.md — frontière SDL3 entre Desktop, Android et Web.
• architecture/004-INPUT_AND_CONTROLS.md — abstraction clavier, souris, gamepad, tactile, gestes et capteurs.
• architecture/005-ASSET_ARCHITECTURE.md — assets communs/spécifiques hors crates et packaging.
• architecture/009-ENGINE_V1_RENDER_SCENE.md — scène 2D portable, rectangles normalisés et backend SDL3.
• architecture/010-RUNTIME_PROVENANCE.md — provenance plateforme/device/runtime/input pour sessions, scores et analytics.
• architecture/011-POST_0_1_0_DIRECTION.md — décisions de transition entre le POC stable 0.1.0 et la conception modulaire 0.2.0.

Jeux

• games/001-GAME_CLASSIFICATION.md — familles de jeux rapides, déclinaisons, contrôles et potentiel d'évolution.

Moteur

• engine/001-ENGINE_EVOLUTION.md — construction incrémentale, équivalent fonctionnel d'un moteur 2D léger, ECS, physique et générations.

Monétisation

• monetization/001-MONETIZATION.md — publicité, rewarded, interstitiels, billing, médiation et configuration distante.

Services

• services/001-ONLINE_AND_VIRAL_SERVICES.md — leaderboards, challenges, partage, progression, replays, anti-cheat et backend.

Développement

• development/001-DESKTOP_RUNNERS.md — runners Desktop séparés des crates lib de jeu.

Règles

Voir ../RULES.md, notamment rules/RULES_DOCUMENTATION.md pour la gouvernance documentaire, rules/RULES_COMMANDS.md pour la politique d'exécution et rules/RULES_VALIDATION_MATRIX.md pour la matrice des gates.

Validation

• validation/001-VALIDATION_GATES.md — gates manuelles du workspace.

• development/002-DESKTOP_DISTRIBUTIONS.md — distributions Desktop natives et variante Tauri optionnelle.

Tests et diagnostics

• testing/001-TEST_ARCHITECTURE.md — séparation unit_tests/ / tests/, tests ciblés et tracing de test.
• testing/002-BETA_VALIDATION_MATRIX.md — matrice beta Desktop SDL3, Tauri/WASM et Android multi-appareils.
• testing/003-RC_VALIDATION_MATRIX.md — matrice RC de reproductibilité, packaging final et promotion vers 0.1.0.
• development/003-TRACING_AND_DIAGNOSTICS.md — socle tracing, subscriber et appender communs.
• development/004-SDL3_DESKTOP_PREREQUISITES.md — prérequis SDL3 Desktop, stratégie de liaison système et vérification pkg-config.
• development/005-DESKTOP_WINDOW_POLICY.md — taille initiale, redimensionnement et séparation future entre fenêtre physique et résolution virtuelle.
• development/006-ANDROID_RUST_NATIVE_BUILD.md — build cdylib Rust Android, cargo-ndk, packaging jniLibs et symbole SDL_main.
• development/007-ANDROID_JNI_BRIDGE.md — frontière Java/JNI minimale, version de contrat et séparation avec l'input SDL3.

Historique validé

• ../history/000-README.md — convention et navigation de l'historique transitoire immuable des jalons validés.