# 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/