Ransom-s-wake/README.md

Ransom’s Wake — Prototypes

Le POC A validé couvre le pilotage et la survie. Le POC B validé couvre un sonar manuel reconstruisant progressivement une carte bathymétrique 3D continue.

POC A — périmètre validé

• Pilotage 3D inertiel depuis l'habitacle, derrière un hublot circulaire.
• Oxygène consommé en continu.
• Batterie consommée uniquement sous propulsion.
• Profondeur nominale, zone critique et rupture de coque.
• Dégâts de collision.
• Alarmes visuelles et sonores.
• Estimation du coût de retour.
• Éjection volontaire.
• Parcours whitebox en trois étapes.

Le sonar, les épaves, le commerce, la narration et les sauvegardes de campagne sont volontairement absents.

POC B — périmètre validé

• Zone de calibration avec fond sculpté, passage et objet métallique.
• Scan manuel de 2,5 secondes, révélé du proche vers le lointain.
• Surface bathymétrique continue, ombrée et colorée selon l'altitude.
• Portée de 95 mètres sur une ouverture de 76°.
• Petit écran de cockpit et grande vue partageant le même rendu.
• Ancien scan remplacé progressivement par le nouveau.

Prérequis

• Godot 4.7.1.

Lancer

Depuis le dossier du projet :

godot --editor --path .

Ou lancer directement le POC :

godot --path .

Le projet lance désormais le POC B. Pour relancer le POC A validé :

godot --path . --scene res://scenes/poc_a.tscn

Contrôles

Touche	Action
W / S	Avancer / reculer
A / D	Tourner à gauche / droite
Espace / Ctrl	Monter / descendre
Maj	Forte poussée
Souris	Caméra et orientation
X maintenu	Éjection volontaire
F9	Forcer un état critique pour tester les alarmes
Échap	Libérer ou capturer la souris
Entrée	Recommencer après succès ou perte
F	Impulsion sonar dans le POC B
Tab	Agrandir ou fermer l'écran sonar du POC B

Tests

Barrière qualité complète obligatoire :

bash scripts/quality_gate.sh

Elle vérifie les frontières d'architecture, charge tous les scripts et scènes, puis exécute les tests unitaires et d'intégration.

Commandes individuelles pour diagnostic :

godot --headless --path . --script res://tests/run_tests.gd

Test d'intégration du POC B :

godot --headless --path . --script res://tests/run_poc_b_integration.gd

Documents

• Plan général : docs/GAME_DESIGN_PLAN.md
• Objectifs et protocole du POC : docs/POC_A.md
• Bilan technique du POC A : docs/POC_A_TECHNICAL_BASELINE.md
• Objectifs et protocole du POC B : docs/POC_B.md
• Bilan technique du POC B : docs/POC_B_TECHNICAL_BASELINE.md
• Barrières techniques de production : docs/ENGINEERING_GUARDRAILS.md
• Cadrage technique de la verticale : docs/VERTICAL_SLICE_TECHNICAL_PLAN.md
• Décisions d'architecture : docs/adr/