Ransom-s-wake/docs/briefs/cockpit-modeles-integration.md

# Brief — intégrer les cinq modèles du cockpit

**Statut : exécuté.** Ce brief a servi à l'intégration des cinq premiers modèles ; sept autres (hublot, coque, lampe, bouteille, mains courantes, console) ont suivi et la cabine a été reconstruite autour. Il reste comme trace des décisions (section 10) ; l'état réel est celui du code et de `assets/README.md`.

Rédigé le 2026-10-06 à partir d'une lecture du dépôt (code non exécuté, barrière non lancée) et des
modèles produits dans une session Blender séparée. Tout ce qui est marqué « non vérifié » doit être
vérifié avant d'être cru.

---

## 1. Objectif

Le cockpit de production (`game/presentation/cockpit/`) fabrique aujourd'hui tous ses instruments en
code, à partir de primitives. Cinq modèles 3D texturés existent maintenant pour les instruments
principaux. Le travail : les importer, les placer dans `cockpit_interior.tscn` à la place de la géométrie
procédurale qu'ils remplacent, et les brancher sur les mêmes données qu'aujourd'hui, sans déplacer une
seule règle de jeu.

Ce n'est pas une refonte du cockpit. Coque, hublot, équipements latéraux, tuyauterie, lampes en cage,
consoles, leviers et HUD restent tels quels.

Terminé quand :
- les cinq modèles sont dans la scène, à l'échelle, orientés vers la caméra du pilote ;
- les quatre aiguilles, les voyants d'alerte et l'écran du sonar affichent les mêmes données qu'avant ;
- `bash scripts/quality_gate.sh` passe, sans contrôle affaibli ;
- des captures à 1280 × 720 et 1920 × 1080 sont jointes, à côté de
  `docs/visual_targets/cockpit-objective-v1.jpg`.

## 2. À lire avant de toucher au code

Obligatoire par `AGENTS.md` : `docs/ENGINEERING_GUARDRAILS.md`, puis :
- `docs/adr/0004-forward-plus-only.md` — matériaux PBR, post-traitement en réglage de qualité ;
- `docs/adr/0006-sonar-contract-and-acquisition-gate.md` — une seule texture sonar, un seul renderer ;
- `docs/adr/0008-composition-owned-service-lifetimes.md` — la composition câble, la présentation affiche ;
- `docs/visual_targets/README.md` et l'image cible ;
- `docs/VERTICAL_SLICE_TECHNICAL_PLAN.md` L823-842 — hiérarchie visuelle du cockpit, ce qui relève de la
  tranche 6 ;
- `game/presentation/cockpit/assets/README.md` — registre de provenance, à compléter.

## 3. Les cinq modèles

### 3.1 Où ils sont

Copiés le 2026-10-06 dans `game/presentation/cockpit/assets/models/`, **non suivis par git** (décision 8 :
ne pas les commiter sans l'accord d'Olivier). Jamais ouverts dans Godot.

| Fichier | Poids | Pièce |
|---|---|---|
| `gauge_panel.glb` | ~20 Mo | tableau de jauges |
| `sonar.glb` | ~15 Mo | écran sonar |
| `switch_panel.glb` | ~16 Mo | panneau d'interrupteurs |
| `alert_box.glb` | ~4,5 Mo (atlas 1024²) | boîtier d'alerte à trois voyants |
| `speaker.glb` | ~4,5 Mo (atlas 1024²) | boîtier haut-parleur |

Les sources (scripts Blender, `.blend`) restent dans un dossier temporaire de session, hors dépôt :
`C:\Users\olivi\AppData\Local\Temp\claude\C--Users-olivi-Projects-Ares-Shift--claude-worktrees-blender-game-piece-c61349\7aedfdfa-be9c-40ed-8dc7-d4243ff07bc3\scratchpad\`.
Ne pas les modifier ; une retouche de modèle se demande à Olivier.

Environ 60 Mo au total, presque entièrement des textures PNG embarquées, 2048² sauf mention (couleur, ORM, normales,
parfois émission). **Les textures bougent encore** : des passes d'équilibrage sont en cours. Les noms de
fichiers, les noms de nœuds et les pivots sont stables. Importer par référence au `.glb`, sans recopier
maillages ni matériaux dans la scène, pour qu'un fichier remplacé se mette à jour seul.

Ce seront les **premiers assets 3D importés du dépôt** : aucun `.glb`, `.gltf`, `.obj` ni `.fbx` n'y existe.

### 3.2 Conventions communes

- glTF 2.0, mètres, exporté de Blender avec +Y vers le haut. Dans Blender la façade regarde −Y, donc
  **dans Godot la façade regarde +Z** — même convention que le `Dashboard` actuel. Non vérifié à l'import.
- Chaque modèle a une racine maillée et, selon les cas, des enfants séparés pour ce qui s'anime ou
  s'allume. Les enfants n'ont ni rotation ni échelle propres, sauf les aiguilles (voir 5.1).
- Échelle de création arbitraire, différente par pièce : voir section 4.
- Matériaux simple face, texture d'occlusion déclarée (canal rouge de l'ORM), tangentes exportées.
- Extension glTF utilisée : `KHR_materials_emissive_strength` sur les matériaux émissifs.

### 3.3 Contrat de chaque modèle

**Tableau de jauges — `gauge_panel.glb`** (créé à 1,2 m de large, origine au bas-centre de la façade)
- `GaugePanel` : boîtier, panneaux, lunettes, vis, interrupteurs décoratifs, barre à deux manchons.
- `GaugeDials` : les quatre cadrans imprimés, un matériau, une texture 4096 × 1024.
- `Needle_Oxygen`, `Needle_Battery`, `Needle_Hull`, `Needle_Depth` : une aiguille chacune, origine sur
  l'axe du cadran, deux surfaces (lame, axe). Voir 5.1 pour l'angle.
- Six voyants, enfants séparés de `GaugePanel`, chacun avec son matériau émissif `GP_<nom du nœud>` :
  `Light_OxygenOk` (vert), `Light_OxygenWarn`, `Light_BatteryWarn`, `Light_HullWarn`, `Light_Strip_0`,
  `Light_Strip_1` (ambre). **Propriété à piloter : `emission_energy_multiplier`**, 0 = éteint (verre
  sombre coloré), 1 = allumé. **Ne pas masquer un nœud `Light_*`** : les faces du boîtier sous la
  lentille sont supprimées, on verrait un trou. Éteindre par l'émission seulement.
- Le boîtier `Gauges_Body` n'a plus aucune émission. Les cadrans `Gauges_Dials` portent un léger
  rétro-éclairage (facteur d'émission 0,2 sur leur propre texture), pilotable aussi.

**Écran sonar — `sonar.glb`** (créé à 1,0 m de large, origine au centre du boîtier)
- `Sonar` : boîtier, renfoncement, trois boutons ambre (émission cuite, toujours allumés), deux molettes,
  deux poignées laiton, presse-étoupe.
- `SonarScreen` : la vitre, maillage plat séparé, matériau émissif propre portant une image fixe de
  démonstration. **UV de 0 à 1 sur l'image visible.** Vitre visible : 0,690 × 0,434 à l'échelle de
  création, soit un rapport de **1,59**.

**Panneau d'interrupteurs — `switch_panel.glb`** (créé à 0,7 m de large, origine au bas-centre de la façade,
façade inclinée de 27° vers l'arrière)
- `SwitchPanel` : boîtier, plaque, cadres. `SwitchLabels` : étiquettes, matériau et texture propres
  (POMPE 1, POMPE 2, SPOT, ALARME, ECLAIRAGE, VENTILATION, SONAR, NAVIGATION, AUXILIAIRE).
- Dix enfants animables, pose de repos à rotation nulle, **rotation autour de X** :

| Nœuds | Plage (`rotation_degrees.x`) |
|---|---|
| `Toggle_Eclairage`, `Toggle_Ventilation`, `Toggle_Sonar`, `Toggle_Navigation`, `Toggle_Auxiliaire` | 0 (bas) → −70 (haut) |
| `Rocker_Pompe1`, `Rocker_Pompe2`, `Rocker_Spot` | 0 → +16 |
| `Cover_Alarme` (capot rouge) | 0 (fermé) → −100 (relevé) |
| `Lever_Alarme` | 0 → −100 environ ; traverse le capot s'il est levé capot fermé |

Plages vérifiées en pose dans Blender, pas dans Godot.

**Boîtier d'alerte — `alert_box.glb`** (créé à 0,30 m de large hors pattes, origine au bas-centre)
- `AlertBox` : boîtier, grille, plaque, étiquettes laiton ALERTE / ATTENTION / DANGER, presse-étoupes.
- `Lamp_Alerte` (vert), `Lamp_Attention` (ambre), `Lamp_Danger` (rouge) : une lentille chacune, matériaux
  `AB_Lamp_Alerte`, `AB_Lamp_Attention`, `AB_Lamp_Danger`, texture d'émission propre.
  **Propriété à piloter : `emission_energy_multiplier`** du matériau de la lentille. 0 = éteint
  (la lentille reste lisible en verre coloré), 1,0 = allumé comme conçu.

**Haut-parleur — `speaker.glb`** (créé à 0,26 m de large hors pattes, origine au bas-centre)
- `Speaker`, un nœud, matériau `Speaker_Body`. Rien d'animé, rien d'allumé.

## 4. Échelle et placement

**Se caler sur le cockpit existant, pas sur une maquette extérieure.** Le cockpit de production a déjà
ses cotes et sa caméra ; les modèles s'y adaptent.

Repères du cockpit actuel (`cockpit_interior.tscn`, mètres, avant = −Z) :
- caméra : `(0, 0.52, −0.48)`, FOV 82° ; regard libre ±30° en lacet, −17° à +11,5° en tangage, plus un
  retour de mouvement (jusqu'à environ −35° / +29,5° en tangage, ±8,8° en roulis). **Aucune translation.**
- `%Dashboard` : `(0, 0.05, −1.22)`, incliné de −12°, dalle de 1,56 × 0,44 × 0,14 ;
- bloc d'instruments actuel : 1,42 m de large ; cadrans de 0,203 / 0,203 / 0,186 / 0,242 m de diamètre ;
- `SonarMonitor` : `(0.54, 0.59, −1.04)`, rotation `(−5°, −42°, −2°)`, écran actuel de 0,216 × 0,141 m ;
- hublot : centre `(0, 0.47, −1.32)`, vitre de 1,12 m.

Conséquences, à vérifier une fois les modèles importés :
- **Tableau de jauges** : ses cadrans font environ 0,21 m (petits) et 0,27 m (profondeur) à l'échelle de
  création. Il tombe donc presque juste **à l'échelle 1** sur le bloc d'instruments actuel. Le poser sur
  `%Dashboard`, nom et chemin à décider (voir 7).
- **Sonar** : pour retrouver un écran d'environ 0,216 m de large, échelle d'environ **0,31**. Garder la
  position et l'orientation de `SonarMonitor`, tourné vers la caméra.
- **Panneau d'interrupteurs, boîtier d'alerte, haut-parleur** : pas d'équivalent exact aujourd'hui.
  Tailles réelles plausibles proposées par l'étude d'ensemble : 0,26 m, 0,135 m et 0,145 m de large
  (échelles 0,37, 0,45 et 0,56). Emplacements d'après l'image cible : interrupteurs en bas à gauche,
  boîtier d'alerte sur la paroi gauche, haut-parleur sur la paroi droite. Ajuster à l'œil contre la cible.

**Contrainte de point de vue, importante.** Les modèles ont été faits pour une caméra à position fixe :
dos ouverts, faces invisibles supprimées. Ils sont sains tant que la caméra reste dans un cône d'environ
35° (40° pour le sonar) autour de la normale de leur façade. La caméra du jeu ne se translate pas, donc
une fois chaque pièce tournée vers elle, tourner la tête ne change rien. À faire : après placement,
mesurer l'angle entre la normale de chaque façade et la direction pièce → caméra ; au-delà de 30°,
réorienter la pièce plutôt que d'accepter le risque. Regarder aussi chaque pièce en tangage extrême.

Une maquette Blender du cockpit entier existe (`…\scratchpad\capsule\capsule_layout.json`), dérivée de
la seule image cible, avec ses propres cotes. Elle ne fait pas foi ici : elle suppose un cockpit plus
grand et une caméra différente. Utile seulement comme idée de disposition relative.

## 5. Brancher les instruments

Règle du dépôt : la présentation affiche des instantanés, elle ne calcule aucune règle. Le chemin de
données ne change pas — `VerticalSliceRoot` appelle `present(update, telemetry)` à chaque pas physique,
`CockpitInstrumentPanel` puis `CockpitDetailing` redistribuent des valeurs simples. Seul le dernier
maillon change : ce qui tourne et ce qui s'allume.

### 5.1 Aiguilles

Aujourd'hui (`cockpit_analog_gauges.gd` L263-265) :
`needle.rotation_degrees.z = lerpf(125.0, −125.0, ratio)`, balayage de 250°.

Les cadrans des nouveaux modèles sont imprimés pour un balayage de **240°** :

`rotation_degrees.z = 120 − 240 × ratio`

- ratio 0 → +120° (en bas à gauche), ratio 1 → −120° (en bas à droite), sens horaire vu du pilote.
- **Les aiguilles ne sont pas à zéro dans le fichier** : elles sont exportées dans une pose de
  démonstration (ratios 0,70 / 0,50 / 0,90 / 0,54). Écrire l'angle absolu, ne pas additionner.
- Formule vérifiée par lecture du `.glb` et dans Blender. **Signe non vérifié dans Godot** : poser les
  quatre aiguilles à 0, 0,5 et 1 et regarder où elles pointent avant de conclure.
- Les ratios restent ceux choisis dans `CockpitDetailing.present` (L49-60). Ne pas les recalculer ailleurs.

Graduations imprimées : oxygène, batterie et coque de 0 à 100 %, avec bande rouge 0-17, jaune 17-29,
verte 29-100. **Profondeur imprimée de 0 à 100 %** (décision 1), sans bande de couleur, avec un repère
rouge juste après 100 : l'aiguille trace `profondeur courante / profondeur certifiée`, comme aujourd'hui.

### 5.2 Voyants d'alerte

Aujourd'hui `CockpitAnalogGauges._update_indicator_bank` (L140-150) allume exactement un voyant sur trois
selon `snapshot.alerts.maximum` : vert sous ATTENTION, ambre pour ATTENTION et RETURN, rouge pour
CRITICAL et FAILURE ; allumé = énergie 2,8, éteint = 0,04.

Le boîtier d'alerte porte exactement ces trois voyants. Même correspondance, en pilotant
`emission_energy_multiplier` de chaque lentille. Qui reprend ce rôle — boîtier d'alerte, voyants du
tableau, ou les deux — est la décision 2.

Rappel du plan de jeu (`GAME_DESIGN_PLAN.md` L258-268) : aucune information critique ne dépend de la
seule couleur. Les étiquettes ALERTE / ATTENTION / DANGER et la position des voyants y contribuent ;
le panneau d'alerte du HUD reste.

### 5.3 Écran du sonar

Aujourd'hui `CockpitInstrumentPanel.attach_sonar_texture` (L85-94) pose sur `%SonarScreen` un
`StandardMaterial3D` non éclairé portant la texture du `SubViewport` (960 × 540), en `material_override`.

Avec le modèle : même méthode, sur le nœud `SonarScreen` importé. Points à respecter :
- le test exige que `%SonarScreen` soit un `MeshInstance3D` à nom unique, dont le +Z local est la normale
  sortante, tourné vers la caméra (voir 7). La vitre du modèle regarde +Z après import ; à vérifier ;
- le `material_override` remplace l'image de démonstration embarquée : voulu ;
- une seule texture partagée entre vue compacte et vue agrandie (ADR 0006), asserté par le test ;
- **rapport d'aspect** : la texture est en 16:9 (1,78), la vitre du modèle en 1,59, l'ancien quad en 1,53.
  L'image est déjà écrasée d'environ 14 % aujourd'hui. Décision 3.
- ne pas ajouter de grille ni de tracé factice par-dessus : le test interdit tout nœud `SonarReferenceTrace`,
  et l'ancienne grille en boîtes émissives (`SonarGridVertical/Horizontal`) disparaît avec l'ancienne console.

### 5.4 Interrupteurs

Purement décoratifs aujourd'hui, et ils le restent dans ce lot : aucune interaction, aucun raycast,
aucune action d'entrée n'existe. Les laisser en pose de repos. Les rendre manipulables serait un nouveau
périmètre traversant entrées, application et présentation (décision 4).

### 5.5 Haut-parleur

Décor. Il n'y a aucun audio dans `game/` aujourd'hui.

## 6. Rendu : ce qui conditionne l'aspect

Les modèles ont été réglés et jugés sous une transformation de couleur linéaire (« Standard » de
Blender). Bonne nouvelle : le projet est au tonemapper par défaut de Godot, **Linear**, donc proche.
Sous une courbe filmique ou AgX, les mêmes modèles sortent pâles et délavés ; ce piège a déjà coûté
plusieurs corrections à tort. Ne pas toucher aux textures pour compenser un réglage d'environnement.

État actuel, relevé dans `game/world/sites/vehicle_test_environment.tscn` : tonemap non réglé (Linear),
**glow éteint, SSAO éteint**, brouillard et brouillard volumétrique actifs, ambiance
`ambient_light_source = 3` sans ressource Sky. Conséquences :
- **Voyants** : sans glow, pas de halo. Les lentilles se lisent par leur seule surface. Les halos de
  l'image cible n'ont pas été peints dans les textures, exprès. Décision 5.
- **Forces d'émission** : réglées sur un éclairage d'essai. À recaler ici, par `emission_energy_multiplier`
  ou l'énergie d'émission du matériau, pas en retouchant les textures.
- **Occlusion** : chaque modèle porte une occlusion cuite, qui n'agit que sur la lumière ambiante, et une
  crasse de contact cuite dans la couleur de base. Si le SSAO est activé un jour, surveiller le cumul.
- **Ambiance** : vérifier à l'image ce que `ambient_light_source = 3` donne réellement sans Sky avant de
  juger les matériaux.
- **Noirs métalliques** : cadres, lunettes, fond de grille et renfoncement de l'écran sont des noirs à
  `metallic = 1`. C'est voulu : un diélectrique renvoie 4 % et passait au gris sous éclairage.
- **Éclairage non peint** : aucun reflet n'est cuit dans les textures (une exception possible sur le
  boîtier d'alerte, en cours de reprise). Les reflets viennent de la rugosité, du métal et des normales,
  donc des lampes de `cockpit_practical_lighting.gd`.

L'environnement appartient à la couche `world`, pas au cockpit. Le modifier sort du périmètre de ce lot
sauf décision contraire.

## 7. Tests : ce qui casse, ce qui doit tenir

Un seul test touche le cockpit : `tests/integration/run_vertical_slice_foundation.gd`. Il asserte sur des
noms, des types et des comptes de nœuds. `AGENTS.md` interdit d'affaiblir un contrôle pour faire passer
un changement ; quand la structure change légitimement, le test est **réécrit pour exprimer le même
comportement sur la nouvelle structure**, dans le même commit, et le changement est justifié.

| Ligne | Assertion | Effet du remplacement |
|---|---|---|
| 93-97, 108 | un nœud existe à `Dashboard/AnalogGauges` | garder ce chemin pour le conteneur des jauges, ou adapter |
| 125-127 | `%SonarScreen` est un `MeshInstance3D` | le maillage importé doit porter ce nom unique |
| 130, 142-145, 330-343 | `SonarMonitor/Housing` est un `BoxMesh`, écran en avant du boîtier | **casse** : le boîtier importé est un `ArrayMesh`. Réécrire la mesure (bornes du maillage) |
| 134-137, 305-314 | `global_basis.z` de l'écran · direction caméra > 0,85 | l'écran doit rester tourné vers la caméra, +Z sortant |
| 152 | `abs(battery_needle_degrees()) > 100` au départ | tient avec la nouvelle formule (batterie pleine → −120°) |
| 153 | `textures_are_loaded()` : acier + quatre faces de cadran | **casse** si les PNG de faces sont retirés (décision 6) |
| 155 | `dashboard_control_count() >= 8` | le nouveau panneau porte 10 commandes |
| 158 | `sonar_control_count() >= 4` | le modèle a 3 boutons et 2 molettes : redéfinir ce que la méthode compte |
| 162-164 | 4 jauges, 3 indicateurs, exactement 1 actif | dépend de la décision 2 |
| 165-167 | textes des afficheurs cachés (kWh, kW, L/min, bar) | les `Label3D` cachés doivent continuer d'être mis à jour |
| 169-172 | texture sonar partagée | inchangé |
| 150-151, 156-157, 159-161 | couples, tuyaux, équipements latéraux, 2 lampes, cloison | ne pas y toucher |

`tests/run_load_checks.gd` instancie toute scène sous `game/` : `cockpit_interior.tscn` doit s'instancier
seule, modèles compris.

**La barrière échoue sur toute ligne `ERROR:`, `SCRIPT ERROR:` ou `WARNING:`** dans la sortie des tests.
Un glTF qui émet un avertissement au chargement (extension inconnue, texture manquante, tangentes) la
fait donc tomber. Contrôler les journaux d'import et de chargement des cinq fichiers **en premier**,
avant tout travail de scène. Le script d'export a signalé un avertissement connu côté Blender
(« More than one shader node tex image used for a texture ») ; savoir s'il a un équivalent côté Godot
n'est pas vérifié.

Tout comportement nouveau reçoit son test : angle des aiguilles aux ratios 0, 0,5 et 1 ; un seul voyant
allumé par niveau d'alerte ; écran tourné vers la caméra.

## 8. Architecture et conventions

- Tout ce lot vit dans `game/presentation/cockpit/`. Aucune dépendance vers `world`, `infrastructure` ni
  `composition` (`check_architecture.sh` L93-99). Rien dans `src/` ni `scenes/`.
- Suivre le patron existant : une classe par fichier, `class_name` en PascalCase préfixé `Cockpit`,
  fichier en snake_case préfixé `cockpit_`, dépendances redéclarées en `const X = preload(...)`, GDScript
  typé, membres privés en `_`, garde de nullité en tête de chaque `present`, petites méthodes de lecture
  pour les tests (`gauge_count()`, `indicator_count()`…).
- Une seule implémentation par concept : la conversion ratio → angle d'aiguille a **un** propriétaire.
  En remplaçant `CockpitAnalogGauges`, supprimer l'ancienne, ne pas laisser deux formules.
- Supprimer la géométrie procédurale remplacée, ne pas la cacher. Le dépôt cache déjà neuf nœuds
  d'afficheurs par `hide_obsolete_elements` ; ne pas allonger cette liste.
- Ce qui est remplacé : tout `AnalogGauges` (boîtier, quatre jauges, aiguilles, verre, `IndicatorBank`
  selon la décision 2) ; `SonarMonitor/Housing`, le quad `%SonarScreen`, tout `SonarConsoleDetailing` ;
  les deux bancs `SwitchPlate` / `ToggleSwitch` de `DashboardDetailing`.
- Ce qui reste : coque, hublot et cloison, `SideEquipment` en entier, tuyauterie, couples,
  `PracticalLighting`, consoles, leviers, cadre structurel du tableau (`TopRail`, `BottomRail`,
  `SideRail`, `PanelScrew`), `%ReturnLabel`, `%StatusLabel`, `EmergencyDial` (décision 7), HUD.
- Vérifier les collisions avec ce qui reste : le cadre structurel et le rail inférieur
  (`LowerSteelRail`, `LeftGrip`, `RightGrip`) occupent la zone de la barre du nouveau tableau, qui porte
  déjà ses propres manchons. Probable doublon à retirer ; à juger à l'image.
- Fichiers de plus de 350 lignes et fonctions de plus de 40 : seuils de revue du dépôt.

## 9. Import et dépôt

- **Emplacement** : `game/presentation/cockpit/assets/models/`, à côté du code qui les utilise, comme
  les textures actuelles. Noms en snake_case, déjà appliqués (section 3.1).
- **Les `.import` ne sont pas versionnés** dans ce dépôt ; la barrière les régénère par `--import`.
  Tout réglage d'import non par défaut serait donc perdu en CI. S'en tenir aux réglages par défaut et
  faire toute adaptation dans la scène ou le code, sauf décision de versionner les `.glb.import`.
- **60 Mo de binaires** dans un dépôt sans Git LFS ni `.gitattributes`, alors que le plan de jeu nomme
  LFS pour les gros assets. Décision 8 : pas de LFS, et pas de commit des `.glb` sans accord d'Olivier.
  Conséquence à signaler dans le compte rendu : tant que les `.glb` ne sont pas commités, la scène ne se
  charge que sur cette machine ; un clone neuf échouerait à la barrière.
- **Budget de textures** (`GAME_DESIGN_PLAN.md` L958-960) : atlas 1K pour les kits courants, 2K réservé
  au sous-marin et aux éléments héroïques. Le cockpit relève du 2K. Boîtier d'alerte et haut-parleur sont
  passés en 1024 (aucune différence visible à leur taille d'écran).
- **Provenance** : compléter `assets/README.md` dans sa forme actuelle. Les modèles sont générés par
  scripts Blender écrits pour le projet, d'après des planches de concept générées pour le projet ;
  aucune ressource tierce. Polices des cadrans et des étiquettes : Arial et Impact, rendues en texture.
  **Point de licence à vérifier** avant diffusion : ce sont des polices système de Windows.
- `project.godot` porte une **modification non commitée** qui supprime `[physics]` et `[rendering]`
  (ré-enregistrement par l'éditeur, selon toute apparence). Ne pas la commiter par accident avec ce lot.
- Ne jamais modifier `.godot/` à la main.

## 10. Décisions prises

Tranchées par Olivier le 2026-10-06. Elles priment sur toute formulation conditionnelle des sections
précédentes (« voir la décision N », « dépend de la décision N »).

1. **Cadran de profondeur : pourcentage de la profondeur certifiée.** Le cadran du modèle est regradué de
   0 à 100 % (texture régénérée par le script du modèle, livrée avec le `.glb`). L'aiguille trace
   `courante / certifiée`, comme aujourd'hui : aucun changement de domaine. Aucun seuil de jeu n'est
   imprimé sur le cadran au-delà du repère de fin de course.
2. **L'alerte SYS / ATTN / ALRM est portée par le boîtier d'alerte** : `Lamp_Alerte` (verte) = SYS,
   `Lamp_Attention` (ambre) = ATTN, `Lamp_Danger` (rouge) = ALRM, exactement une allumée. Les six voyants
   `Light_*` du tableau de jauges ne portent pas ce rôle ; faute de donnée par instrument dans le
   snapshot, ils restent dans un état fixe de repos (à proposer, pas à inventer une règle).
3. **Sonar : le `SubViewport` passe au rapport de la vitre** (1,59 ; 960 × 604). Vérifier que le rendu
   sonar ne suppose pas 16:9 ; adapter le test qui lit sa taille s'il y en a un.
4. **Interrupteurs décoratifs.** Posés au repos (rotations nulles). Aucune entrée, aucune commande.
5. **Glow activé, discret.** Réglage d'environnement traité en réglage de qualité selon l'ADR 0004. Seuil
   réglé pour que seuls voyants et écran sonar débordent, pas le papier des cadrans. Livrer une capture
   avec et sans.
6. **Faces de cadran : celles du modèle.** Les PNG `*_gauge_face_albedo*.png` sont retirés et
   `textures_are_loaded()` adapté à ce qui est réellement chargé.
7. **`EmergencyDial` / « ÉJECTION · X » est conservé.** Le levier d'alarme sous capot rouge reste
   décoratif, capot fermé.
8. **Dépôt : pas de Git LFS.** Git ordinaire, sans `.gitattributes`. Comme chaque version d'un `.glb`
   reste à jamais dans l'historique et que les textures bougent encore, **ne pas commiter les `.glb`
   sans l'accord explicite d'Olivier** : travailler avec les fichiers en place, non suivis, et commiter
   scène, code et tests à part. Fichiers sous `game/presentation/cockpit/assets/models/`
   (à côté des textures de cockpit existantes), noms en snake_case : `gauge_panel.glb`, `sonar.glb`,
   `switch_panel.glb`, `alert_box.glb`, `speaker.glb`. Les `.glb.import` ne sont pas versionnés, comme le
   reste de `.godot/` et des imports du dépôt.

## 11. Ce qui n'a jamais été vérifié

- Aucun des cinq `.glb` n'a été ouvert dans Godot. Import, orientation, échelle, matériaux, sens de
  rotation des aiguilles et des interrupteurs : tout est à constater.
- L'aspect sous l'éclairage réel du cockpit : les modèles n'ont été vus que dans Blender.
- La barrière qualité n'a pas été lancée pendant la rédaction de ce brief.
- Les numéros de ligne cités datent du 2026-10-06 ; les relire avant de s'y fier.

## 12. Ordre de travail conseillé

1. Copier les `.glb` (hors commit), lancer `--import`, lire les journaux : zéro avertissement, sinon
   s'arrêter et le signaler — le correctif est côté modèles.
2. Instancier les cinq modèles dans une scène d'essai, constater axes, échelle, hiérarchie et matériaux
   contre la section 3. Signaler tout écart avant d'aller plus loin.
3. Placer dans `cockpit_interior.tscn` (section 4), mesurer les angles de vue.
4. Brancher aiguilles, voyants, écran (section 5), avec leurs tests.
5. Supprimer la géométrie procédurale remplacée, adapter le test d'intégration (section 7).
6. Captures aux deux résolutions, à côté de l'image cible. Barrière verte.
7. Compte rendu : ce qui est fait, ce qui diffère de ce brief, ce qui reste, ce qui n'a pas pu être vérifié.

En cas de défaut d'un modèle (trou visible, mauvais axe, texture fausse, nœud manquant) : ne pas le
réparer dans Godot. Le décrire précisément, capture à l'appui ; il se corrige dans le script Blender qui
a produit le fichier.