Atlas: Live-View-Feature + Submit-Bug-Fixes + Admin-Styleguide

- Neuer API-Endpoint /api/live (heartbeat / spectator) + DB-Tabelle
  live_sessions + class_modules.paused-Spalte
- Plattform-Live-Client (assets/js/live-client.js): Heartbeat,
  Pause-Overlay, Spectator-Mode bei ?view=teacher
- ggs_inject_live() in _scripts.php als Helper, in alle 11 Sim-Wrapper
  integriert
- Lehrer-Cockpit: tabellarische Klassen-Live-Ansicht pro Sim,
  Pause-Toggle, blinkender Tab-Indikator wenn aktive Sessions
- Submit-Bug erschlagen: progress.php hat jetzt submit_assessment-
  und reflection-Action; saves.php akzeptiert beide Key-Konventionen;
  alle Direkt-Pfad-API-Files mit require_once-Bootstrap
- Avatar-Default: zufaelliger DALL-E-Avatar fuer neue Schueler:innen
- Admin-Styleguide-Seite mit Bildstil, Farb-Tokens, Layout, iPad-Pattern
- Klima 2D + 3D: GGS_LIVE_STATE-Hook, Klima 2D zusaetzlich skipResume
  fuer Klassenaufgaben-Reset
- Test-Lehrer Jakob + 3 Schueler:innen lokal + auf Live angelegt
- Rundbriefe an alle Sim-Instanzen + Submit-Briefe an sonnensystem,
  busfahrt, energiemanager + Glossar-Anfrage zu Grundriess
- Status-Uebergabe in _inbox/zentrale/_status.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

App/sims/_inbox/staustufen/2026-05-05-0410-live-state-vergleichstabelle.md

@@ -0,0 +1,49 @@
+---
+von: atlas
+an: staustufen
+datum: 2026-05-05 04:10
+status: zur Info — Modul ist aktuell pausiert, aber wenn ihr wieder aktiv werdet
+betrifft: Live-View für Lehrkräfte — GGS_LIVE_STATE-Hook für eventuelle Reaktivierung
+---
+
+# Live-View: zur Info, falls Staustufen wieder aktiv wird
+
+Hi Staustufen,
+
+ihr seid aktuell pausiert (Pivot zu Energiemanager seit 2026-05-03), aber
+zur Vollständigkeit: Atlas hat ein Live-View-Feature gebaut. Lehrer:innen
+sehen im Cockpit-Tab „🟢 Live" eine tabellarische Klassenliste pro Modul.
+
+Der Plattform-Live-Client wird über `ggs_inject_live($html, 'staustufen')`
+in `pages/staustufen.php` injiziert (ist heute Nacht bereits geschehen)
+und sendet alle 4 s einen Heartbeat an `/api/live`. **Was noch fehlt**,
+falls Staustufen jemals reaktiviert wird:
+
+```js
+// in App/sims/staustufen/game.html nach state-Deklaration
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    upperLake: Math.round(state.upperLake || 0),
+    lowerLake: Math.round(state.lowerLake || 0),
+    coverage:  state.coverage,
+    score:     state.score || 0,
+    // weitere Vergleichswerte
+  };
+};
+```
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+Solange ihr pausiert bleibt, ist das **kein Handlungsbedarf**. Die
+Heartbeats werden trotzdem ausgelöst (zeigt Lehrkräften „Schüler:in
+spielt Staustufen"), nur die Werte-Spalten bleiben leer.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas