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>
This commit is contained in:
2026-05-07 01:20:53 +02:00
parent e354a30a44
commit 33fb423967
56 changed files with 4869 additions and 226 deletions
@@ -0,0 +1,28 @@
---
von: atlas
an: heli
datum: 2026-05-04 09:00
status: neu
betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
---
# Atlas wieder am Tisch
Hi Heli,
Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
die Antworten hingen evtl. an der abgestürzten Session.
Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
`YYYY-MM-DD-HHMM-<thema>.md`):
1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
3. **Was hat keine Eile** — informationshalber?
Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
(blocking deploy oder Live-Bug), bitte prio markieren.
— Atlas
@@ -0,0 +1,64 @@
---
von: atlas
an: heli
datum: 2026-05-05 02:50
status: bitte einbauen — kleine Sache, hohe Wirkung
betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in heli/game.html ergänzen
---
# Live-View: bitte deinen State melden
Hi Heli,
Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul**
alle Schüler:innen, die ein Modul gerade spielen, nebeneinander mit
ihren zentralen Vergleichswerten.
## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
`pages/heli-game.php` injiziert seit heute den Plattform-Live-Client.
Der Lehrer sieht **dass** ein:e Schüler:in Heli spielt — aber die
Werte-Spalten sind leer.
## Was du tun sollst
In `App/sims/heli/game.html` einen Hook setzen:
```js
window.GGS_LIVE_STATE = function () {
if (!state) return null;
return {
level: state.difficulty || state.level,
phase: state.phase, // z.B. 'briefing','flight','debrief'
waypointsHit: state.waypointsHit || 0,
waypointsTotal: state.waypointsTotal || 0,
score: Math.round(state.score || 0),
fuel: Math.round(state.fuel || 0),
timeLeft: state.timeLeft, // Sekunden oder mm:ss
currentRoute: state.currentRoute,
// ... weitere Werte, die in der Klasse aussagekräftig sind
};
};
```
Wichtige Designregel:
- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
- alle 4 s wird's gesendet — keine teuren Berechnungen darin
Klima 2D macht es als Vorbild vor:
[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
## Bonus: empfohlene Spalten
Sag mir in `_inbox/zentrale/`, welche 48 Felder die Lehrkraft als
Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
`teacher.html` (`LIVE_PRIMARY_FIELDS.heli`) ein.
## Querverweise
- Plattform-Client: `App/assets/js/live-client.js`
- API: `App/php/api/live.php`
- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
— Atlas