Implement production vertical slice foundation

README.md

@@ -1,4 +1,31 @@
-# Ransom’s Wake — Prototypes
+# Ransom’s Wake
+
+La première tranche de pilotage de la verticale est désormais la scène
+principale. `Nouvelle partie` ouvre un court parcours sous-marin en vue cockpit :
+le clavier pilote une coque inertielle, la souris déplace seulement le regard et
+les snapshots du domaine alimentent les instruments physiques à 60 Hz.
+
+Les POC A et B restent disponibles comme références jetables ; aucun code de
+production sous `game/` n'en dépend.
+
+## Fondations de production
+
+- Renderer Forward+ unique.
+- Règles de plongée résolues selon améliorations, difficulté et accessibilité.
+- Oxygène, batterie, coque, pression, alertes et éjection possédés par
+  `DiveSession`.
+- Contrats séparés pour tick, télémétrie, collisions, outils et retour.
+- `DiveUpdate` cohérent composé d'un snapshot et d'événements typés.
+- Acteur sous-marin de production derrière des contrats de commande et de
+  télémétrie typés.
+- Habitacle 3D solidaire de la coque : hublot occultant, consoles, commandes,
+  éclairage et emplacement réservé au sonar.
+- Instruments physiques à valeurs réelles ; le HUD reste réservé aux alertes,
+  à l'éjection et aux états terminaux.
+- Pause qui suspend les ticks, confirmations de sortie et premier remappage avec
+  détection des conflits.
+
+## Prototypes validés
 
 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.
@@ -28,7 +55,7 @@ Le sonar, les épaves, le commerce, la narration et les sauvegardes de campagne
 
 ## Prérequis
 
-- Godot 4.7.1.
+- Godot 4.7.2.
 
 ## Lancer
 
@@ -36,15 +63,16 @@ Depuis le dossier du projet :
 
     godot --editor --path .
 
-Ou lancer directement le POC :
+Ou lancer directement la fondation de production :
 
     godot --path .
 
-Le projet lance désormais le POC B. Pour relancer le POC A validé :
+Pour relancer les POC validés :
 
     godot --path . --scene res://scenes/poc_a.tscn
+    godot --path . --scene res://scenes/poc_b.tscn
 
-## Contrôles
+## Contrôles de la tranche de production
 
 | Touche | Action |
 |---|---|
@@ -52,13 +80,12 @@ Le projet lance désormais le POC B. Pour relancer le POC A validé :
 | A / D | Tourner à gauche / droite |
 | Espace / Ctrl | Monter / descendre |
 | Maj | Forte poussée |
-| Souris | Caméra et orientation |
+| Souris | Déplacer le regard dans le hublot uniquement |
 | 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 |
+| R | Recentrer le regard |
+| Échap | Pause / retour |
+
+Les commandes propres aux POC restent décrites dans leurs documents respectifs.
 
 ## Tests
 
@@ -72,6 +99,9 @@ puis exécute les tests unitaires et d'intégration.
 Commandes individuelles pour diagnostic :
 
     godot --headless --path . --script res://tests/run_tests.gd
+    godot --headless --path . --script res://tests/unit/run_dive_foundation_tests.gd
+    godot --headless --path . --script res://tests/unit/run_vehicle_application_tests.gd
+    godot --headless --path . --script res://tests/integration/run_vertical_slice_foundation.gd
 
 Test d'intégration du POC B :
 
@@ -86,4 +116,6 @@ Test d'intégration du POC B :
 - 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
+- Design system UI de la verticale : docs/UI_DESIGN_SYSTEM.md
+- Propositions visuelles UI : Design-Proposal/README.md
 - Décisions d'architecture : docs/adr/