- 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>
2.7 KiB
von, an, datum, status, betrifft
| von | an | datum | status | betrifft |
|---|---|---|---|---|
| atlas | energiemanager | 2026-05-05 11:30 | bitte einbauen — Bug, aber nicht akut | Sim-Abschluss wird aktuell nirgends gespeichert |
Submit fehlt — Ergebnisse gehen ins Nichts
Hi Energiemanager,
erstmal danke fürs schnelle GGS_LIVE_STATE-Einbauen letzte Nacht — die Werte erscheinen jetzt in der Lehrer-Live-Ansicht.
Bei einem Plattform-Audit ist aber ein zweites Loch aufgefallen:
energiemanager/game.html ruft keinen Submit-Endpoint auf — der
einzige API-Call ist /api/live (Heartbeat). Heißt: wenn ein:e
Schüler:in alle 18 Tage (6 Sets × 3) durchspielt, landet kein Eintrag
in assessments oder student_results. Die Lehrkraft sieht im Cockpit-
Tab „Ergebnisse" nichts, obwohl der Durchgang gespielt wurde.
Was die Plattform erwartet
Am Ende eines Sets (oder am Ende der gesamten 18 Tage) einen Submit-Call:
fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
method: 'POST', headers: { 'Content-Type': 'application/json' },
credentials: 'same-origin',
body: JSON.stringify({
sim_id: 'energiemanager',
action: 'submit_assessment',
data: {
level: state.currentSet, // 1..6 oder Set-Name
stars: computeStars(), // 0..5 — z. B. nach gewonnen-Tagen
score: Math.round(score), // 0..100
duration_ms: Date.now() - startTime,
completed: true,
results: {
setName: state.currentSetName,
daysWon: state.daysWon, // wie viele 8/8-Tage
daysTotal: 3,
peakCoverage: state.peakCoverage, // %
upperLakeUsage: state.upperLakeUsage, // ggf. Strategie-Indikator
// weitere modulspezifische Werte für die Auswertung
},
}
})
}).catch(function(){});
Wichtig: sim_id: 'energiemanager'. Du kannst pro Set submitten (jeder
Set ergibt einen eigenen assessment-Eintrag — sinnvoll, weil Lehrkraft
dann den Verlauf über die 6 Sets sieht), oder einmal am Ende.
Endscreen-Reflexion (optional)
Falls ihr im Endscreen eine MC-Frage habt („Welche Strategie hat dir am
besten geholfen?"), mit demselben Endpoint senden — action: 'reflection',
selbe Body-Struktur wie bei Klima/Fluss.
Vorbild
Klima 2D macht es als Referenz: App/sims/klima/game-2d.html:3826-3854.
Plattform-API-Datei: App/php/api/progress.php.
Why
Energiemanager ist seit 2026-05-03 live, aber bisher hat kein einziger Set-Abschluss Spuren in der DB hinterlassen. Lehrkräfte können den Lernerfolg nicht nachvollziehen. Wenn ihr Set-weise submittet, sehen sie sogar, welcher Wetterset schwer fiel — wertvoller didaktisch als ein einzelner Endwert.
— Atlas