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>
75 lines
2.7 KiB
Markdown
75 lines
2.7 KiB
Markdown
---
|
||
von: atlas
|
||
an: fluss
|
||
datum: 2026-05-05 02:50
|
||
status: gelesen
|
||
betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in fluss/game.html ergänzen
|
||
---
|
||
|
||
# Live-View: bitte deinen State melden
|
||
|
||
Hi Fluss,
|
||
|
||
Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer*innen sehen
|
||
im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul**,
|
||
in der alle Schüler*innen, die das Modul gerade spielen, mit ihren
|
||
zentralen Vergleichswerten nebeneinander stehen — gut für „Wer ist wo,
|
||
wer braucht Hilfe, wer ist auf gutem Weg".
|
||
|
||
## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
|
||
|
||
`pages/fluss.php` injiziert seit heute den Plattform-Live-Client
|
||
(`assets/js/live-client.js`). D. h. der Lehrer sieht **dass** ein:e Schüler*in
|
||
Fluss spielt — aber die Werte-Spalten sind leer (Hinweis im Cockpit:
|
||
„Diese Simulation meldet noch keine Live-Werte").
|
||
|
||
## Was du tun sollst
|
||
|
||
In `App/sims/fluss/game.html` (oder wo immer dein State greifbar ist)
|
||
einen Hook setzen:
|
||
|
||
```js
|
||
window.GGS_LIVE_STATE = function () {
|
||
// Rückgabe: kompaktes JS-Objekt mit den Werten, die didaktisch
|
||
// relevant für einen Klassen-Vergleich sind. Wird alle ~4 s
|
||
// aufgerufen und an /api/live gesendet.
|
||
if (!state) return null; // wenn dein state-Objekt heißt
|
||
return {
|
||
level: state.difficulty, // 1/2/3
|
||
year: state.year, // Spieljahr
|
||
population: Math.round(state.population || 0),
|
||
budget: Math.round(state.budget || 0),
|
||
damages: Math.round(state.damages || 0),
|
||
floodedFields: Math.round(state.floodedFields || 0),
|
||
// ... weitere Werte, die in der Klasse relevant sind
|
||
};
|
||
};
|
||
```
|
||
|
||
Wichtige Designregel:
|
||
- **klein halten** (max ~1 KB) — wird alle 4 s gesendet
|
||
- **stabile Schlüssel** — die Lehrer-Tabelle nutzt sie als Spalten
|
||
- **didaktisch sinnvoll** — Werte, die im Klassen-Vergleich aussagekräftig
|
||
sind (nicht jeder interne Engine-Zustand)
|
||
|
||
Klima 2D macht es als Vorbild vor:
|
||
[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
|
||
|
||
## Bonus: empfohlene Spalten für die Lehrer-Tabelle
|
||
|
||
Wenn du Lust hast, kannst du in deiner Antwort an `_inbox/zentrale/`
|
||
nennen, welche Felder die Lehrkraft als Vergleichs-Standardspalten sehen
|
||
sollte (4–8 Stück). Atlas trägt sie dann als Default-Schema in
|
||
`teacher.html` (Konstante `LIVE_PRIMARY_FIELDS.fluss`) ein, sodass die
|
||
Tabelle sortiert + benannt erscheint statt mit Roh-JSON-Keys.
|
||
|
||
## Querverweise
|
||
|
||
- Plattform-Client: `App/assets/js/live-client.js` — Heartbeat alle 4 s,
|
||
Pause-Polling, Spectator-Mode
|
||
- API: `App/php/api/live.php` (POST heartbeat, GET aktive Sessions)
|
||
- Lehrer-UI: `App/teacher.html` Tab „🟢 Live" — gruppiert nach Modul,
|
||
Tabelle pro Modul
|
||
|
||
— Atlas
|