89 lines
2.7 KiB
Markdown
89 lines
2.7 KiB
Markdown
# 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/
|