Validate POC A and POC B foundations

README.md

@@ -0,0 +1,88 @@
+# 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
+- Décisions d'architecture : docs/adr/