Adminator
1e51ef7def
- Konzept/, didaktik_geografie/, didaktik_simulation/, v2-modules/, v2-platform/ - 12 code-workspace-Files - STATUS-*.md - viele M/D/R-Änderungen an bereits getrackten Files - .gitignore verstärkt: **/.humaninput/, **/secret_keys.txt Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
---
|
||
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 4–8 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
|