---
instanz: heli
stand: 2026-04-23 13:00
phase: Integrations-Umbau Schritte 1+2 fertig (Mode + Assessment), wartet auf End-Screen-Komponente
---

# Heli-Instanz — Status

## Rolle

Heli-Rettungs-Modul: Code, TTS, Spielablauf, Waypoints, Routen, Landing.
Plattform-Themen bei Atlas.

## Heute 2026-04-23 — Integrations-Umbau

### Schritt 1: Mode-Check im Wrapper (Integrations-Vertrag §6.1)
- `App/pages/heli-game.php` prueft Cookie `ggs_session`, liest
  `class_modules` + `student_modules`, setzt `mode`, `forcedLevel`, `easy`.
- `locked` → Sperrseite mit Cockpit-Link.
- Frontend-Variablen injiziert: `HELI_SESSION_MODE`, `HELI_FORCED_LEVEL`,
  `HELI_SESSION_ID`, `STUDENT_EASY`, `HELI_API_BASE`.
- Pattern 1:1 vom Logistik-Wrapper uebernommen.

### Schritt 2: Forced-Level-Start (Frontend)
- Level-Mapping: 1=easy, 2=medium, 3=hard.
- `initMissionPhase()` waehlt bei `teacher_started` zufaellig eine Mission
  aus dem Pool, zeigt Info-Screen 1,8 s, dann automatisch `setPhase('plan')`.
- Auftragswahl mit 3 Karten nur noch im `free`-Modus.

### Schritt 3: Assessment-Calls (Integrations-Vertrag §6.3 / §6.4)
- `assessmentStart()` in `selectMission()` → `phase:"started"`.
- `assessmentPhaseEntered()` in `setPhase()` fuer jede Phase ausser
  mission/results + 30-s-Ping mit `phase:"running"`.
- `assessmentComplete()` in `initResultsPhase()` → `phase:"completed"`
  mit Sternen, planPct, dauerMin, failed-Flag.
- Demo-Modus ohne Session-Cookie blockiert gutmuetig: kein Request.

### Heute schon erledigt (voriger Tag + Vormittag):
- **105 OpenAI-TTS-Audios** (Nova, Speed 1.12, Funk-Filter, warmer Ton)
- **25 Mission-Bilder** via DALL-E (auf 1008x576 verkleinert)
- **Zielanflug-Funkprotokoll** (ICAO: Pilot-Call + Tower-Geo-Antwort)
- **16-teilige Windrose** mit fixer Kompassnadel + Live-Kurspfeil
- **Proximity-Voegel** (Geraeusch nur bei Naehe, mehr sichtbare Schwaerme)
- **Audio-Stop** bei Rueckkehr zur Einsatzzentrale (stopAllGameAudio)

## Offene Aufgaben

- [ ] **End-Screen** (`bewertung.html`) auf `.ggs-endscreen`-Komponente
      umstellen — wartet auf Atlas-Build.
- [ ] **Pre/Post-Quiz**-Integration wenn `quizEnabled` aus Mode-API true ist
      (in HELI_SESSION als Feld bereits verfuegbar).
- [ ] **`game_saves`-Autosave** — aktuell nicht noetig (Einzel-Einsatz ist
      kurz), erst relevant wenn Missions-Ketten eingefuehrt werden.
- [ ] **Sea-Audios** fuer c6/c9/c10/c11/c16 — Fallback auf universelles
      approach/extract aktiv, kein Ausfall. Koennten via OpenAI nachgezogen werden.
- [ ] **Lehrplan-Anker** fuer Heli (Atlas-Konzept §7.4) — wartet auf
      Lehrplan-Instanz.
- [ ] **captiainSpeaking.mp3**-Tippfehler stehen lassen, keine neuen
      Tippfehler einfuehren (Atlas-Note).

## Blocker

**Keine.**

## Arbeitsmodus gerade

Wartet auf Atlas-End-Screen-Komponente, sonst bereit fuer Durchspielrunde
mit neuer Stimme und Tower-Geografie-Funk.