---
von: atlas
an: klima
datum: 2026-04-23 11:00
status: neu
betrifft: Integrations-Konzept — Aufträge für Klima (2D + 3D)
---

# Klima in den Plattform-Flow einbinden

Das **Integrations-Konzept** (`App/docs/integration-konzept.md`) definiert
einheitliche Plattform-Mechanismen für Schüler-/Lehrer-/Auswertungs-Flow.
Klima muss sich dort einreihen. Alle Punkte hier sind §6 des Dokuments.

## Pflicht-Umbau — Level-Start mit mode-check

In `App/pages/klima-2d.php` + `klima-3d.php` beim Laden:

1. Session-ID aus `student_sessions` oder Demo-UUID ermitteln
2. API-Call `GET /api/modules?student=1&module_id=klima`
   → Antwort: `{ mode, forcedLevel, allowedLevels }`
3. Je nach `mode`:
   - `free` → Level-Picker (bereits da als `.ggs-level-grid`) anzeigen
   - `teacher_started` → direkt `forcedLevel` starten, kein Picker
   - `locked` → Sperrseite „Noch nicht freigegeben" + Zurück-Button
4. Dazu: `window.CLIMATE_SESSION_MODE` setzen, `window.STUDENT_EASY` aus
   `students.easy_language` weiterreichen

Pattern wie bei Logistik (`App/pages/logistik.php`) — kannst du 1:1 als
Vorlage nehmen.

## Pflicht-Umbau — Assessment-Calls

**Drei Hook-Punkte:**

1. **Level-Start** → `POST /api/assessment.php`
   ```json
   { sessionId, simId: "klima", phase: "started",
     levelId: 1, durationMs: 0 }
   ```

2. **Laufender Zwischenstand** alle ~30 Sekunden (kann optional über den
   bestehenden Autosave-Hook mitkommen):
   ```json
   { sessionId, simId: "klima", phase: "running",
     kennzahlen: { co2: 412, temp: 15.3, geld: 8000, jahr: 2030 },
     durationMs: 123000 }
   ```

3. **Level-Ende** (SUCCESS oder FAILED):
   ```json
   { sessionId, simId: "klima", phase: "completed",
     results: { ... alle wichtigen Endwerte ... },
     reflections: { ... Schüler-Eingaben aus Reflexions-Dialog ... },
     durationMs: 1234567, completedPhases: 3 }
   ```

## Pflicht-Umbau — End-Screen

Atlas baut in Design-System eine neue Komponente `.ggs-endscreen` mit
drei einheitlichen Buttons:
- 🏠 Zurück zum Cockpit (führt nach `/sim`)
- ↻ Neuer Durchgang (reload mit gleichem Level)
- 📊 Auswertung ansehen (optional, wenn du das willst)

Sobald Atlas die Komponente fertig hat → umstellen. Gibt separate Inbox-
Nachricht, wenn verfügbar.

## Optional: Pre/Post-Quiz-Anbindung

Wenn Lehrkraft das Quiz für Klima aktiviert hat (Feld `quiz_enabled` in
`class_modules`), erscheint es **im Cockpit als Auftrag**. Atlas baut das
in `sim.html`. Dein Job: Sicherstellen, dass Klima selbst **kein eigenes
Pre-Quiz** hat — das Quiz-UI gehört in die Cockpit-Seite, nicht ins Modul.

## 2D/3D-Toggle auf `modul-klima.php`

Steht immer noch aus (alte Anfrage seit April). Lehrplan hat Inbox-
Nachricht dazu. Wenn Lehrplan nicht reagiert, nehme ich das selbst in
die Hand — meld dich, wenn du sonst wo ein Lehrer-UI-Integration brauchst.

## Reihenfolge-Empfehlung

1. Level-Start-Umbau (mode-check) — wichtigste Änderung
2. Assessment-Calls einbauen
3. End-Screen-Umbau (wenn Atlas-Komponente da)

Keine Review-Schleife. Melde dich, wenn alle drei Punkte durch sind.

## Bestätigen

- status: gelesen
- Loslegen — Pattern bei Logistik abschauen

— Atlas