<!-- file: README.md -->
<!-- version: 6 -->

# games.sasedev

Workspace expérimental puis productif pour des jeux multiplateformes principalement développés en Rust, avec une première orientation Android et un socle SDL3.

## Principes de départ

- un seul workspace Cargo ;
- toutes les crates Rust sous `crates/` ;
- générations de moteur coexistantes sous `crates/engines/engine-vN-*` ;
- une ou plusieurs crates par jeu sous `crates/games/` ;
- assets hors des crates sous `assets/` ;
- `assets/common/` pour les ressources mutualisées et un répertoire par jeu pour les ressources spécifiques ;
- frontend Android sous `Android/`, en Java, avec une partie commune et une partie spécifique par jeu ;
- monétisation optionnelle et spécifique à chaque plateforme/distribution ;
- runner Desktop natif SDL3 par défaut, avec variante Tauri uniquement si un besoin futur la justifie ;
- documentation sous `docs/` ;
- règles normatives indexées par `RULES.md` ;
- livraison par archives delta versionnées ;
- versionnement SemVer avec labels de maturité normalisés.

## Baseline

Version stable de référence : `0.1.0`.

Version candidate en cours de conception : `0.2.0-0-pre.1`.

Les deux premiers jeux sont des POC structurels : `game-reflex-poc` et `game-snake-poc`. Ils existent d'abord pour valider les frontières du workspace, le moteur, les assets et le packaging multiplateforme.

## Entrées documentaires

- [`RULES.md`](RULES.md)
- [`ROADMAP.md`](ROADMAP.md)
- [`CHANGELOG.md`](CHANGELOG.md)
- [`docs/000-README.md`](docs/000-README.md)
- [`docs/architecture/001-WORKSPACE_ARCHITECTURE.md`](docs/architecture/001-WORKSPACE_ARCHITECTURE.md)
- [`docs/objectives/001-PROJECT_OBJECTIVES.md`](docs/objectives/001-PROJECT_OBJECTIVES.md)
- [`docs/games/001-GAME_CLASSIFICATION.md`](docs/games/001-GAME_CLASSIFICATION.md)

## Diagnostics et tests

Les socles transverses `crates/common/game-assets-lib` et `crates/common/game-logging-lib` fournissent respectivement la résolution logique des assets et le tracing commun. Les tests unitaires résident hors `src/` sous `unit_tests/`; les tests d’intégration/environnement résident sous `tests/`.