games/docs/plans/001-V0_3_0_WEB_SNAKE_POC_PLAN.md

Plan v0.3.0 — baseline Snake et premier POC Web direct

But de la version

0.3.0 ouvre la série de POC 0.3.x. La version doit rendre Snake suffisamment portable pour servir de jeu-sonde et valider un premier host de bout en bout : le navigateur Web direct.

La version doit rester assez petite pour être fermée dans la session qui l'ouvre. Si une tranche devient trop lourde, elle est scindée ; si le scope global ne tient plus, la partie non indispensable est reportée à une version suivante.

Base et décisions acquises

Base stable : 0.2.0.

Décisions issues du cadrage 0-pre.1 :

• Snake reste le jeu-sonde principal ;
• le premier host de 0.3.0 est Web navigateur direct ;
• Tauri Android est reporté à 0.3.1 ;
• le gameplay reste dans game-snake-poc ;
• le chemin Web utilise Cargo, wasm-bindgen et Vite/TypeScript, sans orchestrateur Python ;
• le host navigateur possède un shell HTML piloté par Vite/TypeScript, avec Bootstrap 5 pour le layout/les contrôles et un Canvas dédié au rendu du jeu ; Bootstrap ne porte aucune règle de gameplay ;
• aucune abstraction n'est extraite avant qu'un besoin partagé réel soit observé.

Scope

La version couvre :

• nettoyage de la baseline Snake et de ses dépendances de plateforme ;
• adaptation WASM dédiée à Snake ;
• frontend Web avec shell HTML responsive, Bootstrap 5, Canvas, clavier et contrôles directionnels tactiles ;
• resize/lifecycle adaptés au navigateur ;
• branchement des assets, du logging et de la provenance runtime nécessaires au POC ;
• maintien du runner Desktop SDL3 comme témoin de non-régression ;
• documentation des duplications observées et des extractions réellement justifiées.

Hors périmètre : Tauri Android/Desktop Snake, Android natif multi-ABI, réseau realtime, WebTransport/QUIC, Uroburas, ads, billing, auth, leaderboard et nouveau moteur.

Prévision souple

Les numéros ci-dessous sont des repères de progression, pas un contrat rigide. Une découverte peut insérer un fix, scinder une tranche ou décaler les numéros suivants sans forcer la fermeture.

0-pre.1 — cadrage

Audit de la baseline, requirements, choix du host Web, sizing et validations prévues. Le présent plan manquant à la livraison initiale est ajouté par 0-pre.1.fix.1.

0-pre.1.fix.1 — plan et règles de suivi

Créer docs/plans/, formaliser le caractère vivant du plan, corriger le contrat des archives taggées et rendre explicite qu'une session est planifiée pour fermer au minimum la version concrète ouverte.

0-pre.2 — baseline Snake portable

Nettoyer les dépendances inutiles/spécifiques au launcher, stabiliser la frontière gameplay/input et confirmer les tests Snake ainsi que le runner Desktop SDL3.

Livraison candidate : engine-v1-platform-api est retiré des crates de gameplay Snake et Reflex où il n'est pas consommé ; les launchers qui utilisent réellement les capacités plateforme conservent leur dépendance. Le contrat Snake est fixé sur EngineGame, InputState, les quatre actions directionnelles et EngineScene, sans SDL3, DOM, Canvas ni API plateforme dans la crate de gameplay. Aucun adapter WASM n'est introduit avant 0-pre.3.

Gate : audits statiques, cargo check --workspace, tests ciblés Snake et vérification du graphe de dépendances des crates de gameplay. Un smoke Desktop n'est requis que si le runtime SDL ou son mapping est modifié.

0-pre.3 — adaptation Snake WASM

Introduire game-snake-poc-wasm, adapter WASM minimal dédié à Snake. La crate possède SnakeState, le FixedStepRunner et une direction logique en attente consommée au prochain tick(). Elle expose à wasm-bindgen les quatre directions, le score, la longueur et la scène normalisée nécessaire au futur Canvas, sans SDL3, Tauri, DOM, frontend ni engine-v1-platform-api.

Livraison candidate : la crate est membre du workspace et la distribution statique vérifie sa présence. Le bridge reste volontairement spécifique à Snake ; aucune abstraction commune avec game-reflex-poc-wasm n'est extraite avant observation d'une duplication réellement problématique.

Gate : audits statiques, cargo check --workspace, Clippy ciblé, tests de l'adapter, build wasm32-unknown-unknown, génération wasm-bindgen --target web dans ../builds/sasedev-games/ et graphe de dépendances. Aucun build Vite/Bootstrap ni smoke navigateur n'est requis avant 0-pre.4.

0-pre.4 — frontend Web/Vite, shell Bootstrap 5 et contrôles

Créer le frontend Vite/TypeScript avec un document HTML responsive servant de shell au jeu. Utiliser Bootstrap 5 côté frontend pour la mise en page, les états UI et les contrôles tactiles ; conserver le rendu du jeu dans un Canvas et les règles de gameplay dans Rust/WASM. Brancher clavier, boutons directionnels tactiles, chargement/erreur et affichage d'état nécessaires au POC.

Gate : build Web par le chemin natif prévu et smoke navigateur couvrant Canvas, clavier, contrôles tactiles et comportement responsive du shell.

0-pre.5 — intégration plateforme complète

Fermer resize/lifecycle, assets, logging et provenance runtime du POC ; vérifier que Desktop SDL reste intact.

Gate : tests ciblés, build Web et smoke navigateur couvrant les requirements de 0.3.0.

0-pre.6 — correction/extraction seulement si prouvée

Tranche conditionnelle. Elle n'existe que si les POC précédents révèlent une duplication réelle, une frontière mal placée ou un défaut nécessitant une correction structurante avant stabilisation. Sinon elle est omise.

2-beta.1 — validation large

Scope feature-complete. Exécuter les gates workspace applicables, les tests ciblés et les validations Web/Desktop prévues. Aucun nouveau scope.

2-beta.2 — consolidation documentaire et transmission

Réconcilier l'état réellement validé avec la documentation durable et le plan actif, puis mettre à jour CHANGELOG.md, ROADMAP.md et l'historique applicable. Préparer et vérifier le prompt de la version/session suivante à partir de cet état, sans prétendre à des validations non exécutées.

Cette tranche est une responsabilité obligatoire du cycle même si son numéro doit être décalé par des fixes ou une beta supplémentaire. La documentation spécifique à une fonctionnalité reste mise à jour dans la tranche qui introduit cette fonctionnalité ; 2-beta.2 réalise la consolidation transversale, elle ne sert pas à reporter toute la documentation en fin de version.

Gate : cohérence docs/plan/deltas/CHANGELOG.md/ROADMAP.md/history/prompt, puis audits documentaires applicables.

3-rc.1 — candidate gelée

Reproductibilité, validation finale de la candidate et derniers défauts strictement nécessaires à la publication. Le prompt suivant préparé pendant la consolidation est vérifié/complété si l'état RC apporte une information nouvelle. Aucun nouveau POC ni nouvelle capability.

0.3.0 — release stable

Publication mécanique de l'état RC validé.

Suivi et ajustements

Le plan est révisé lorsqu'un résultat réel modifie la trajectoire. Un changement de numérotation n'est pas un problème ; une responsabilité importante ne doit en revanche pas être comprimée artificiellement pour respecter le forecast initial.

La session ne doit pas être planifiée pour s'arrêter à pre.2, pre.4 ou beta : ces identifiants sont des tranches de la même version. Si 0.3.0 devient trop grande, le scope non indispensable est déplacé vers 0.3.1+ afin de préserver une version complète par session.

Version suivante envisagée

0.3.1 reste le candidat pour le second host Snake, Tauri Android, en réutilisant la baseline Web/WASM réellement validée par 0.3.0.