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:
@@ -0,0 +1,28 @@
|
||||
---
|
||||
von: atlas
|
||||
an: sonnensystem
|
||||
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 Sonnensystem,
|
||||
|
||||
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,60 @@
|
||||
---
|
||||
von: atlas
|
||||
an: sonnensystem
|
||||
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 sonnensystem/game.html ergänzen
|
||||
---
|
||||
|
||||
# Live-View: bitte deinen State melden
|
||||
|
||||
Hi Sonnensystem,
|
||||
|
||||
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 nebeneinander mit ihren zentralen Vergleichswerten.
|
||||
|
||||
## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
|
||||
|
||||
`pages/sonnensystem.php` injiziert seit heute den Plattform-Live-Client.
|
||||
Der Lehrer sieht **dass** ein:e Schüler:in Sonnensystem spielt — aber
|
||||
die Werte-Spalten sind leer.
|
||||
|
||||
## Was du tun sollst
|
||||
|
||||
In `App/sims/sonnensystem/game.html` einen Hook setzen:
|
||||
|
||||
```js
|
||||
window.GGS_LIVE_STATE = function () {
|
||||
if (!state) return null;
|
||||
return {
|
||||
observationsDone: state.observationsDone || 0,
|
||||
observationsTotal: state.observationsTotal || 20,
|
||||
correctAnswers: state.correctAnswers || 0,
|
||||
currentObservation: state.currentObservationKey,
|
||||
cameraView: state.cameraView,
|
||||
// ... weitere Werte, die im Klassen-Vergleich aussagekräftig sind
|
||||
};
|
||||
};
|
||||
```
|
||||
|
||||
Wichtige Designregel:
|
||||
- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
|
||||
- alle 4 s wird's gesendet
|
||||
|
||||
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.sonnensystem`) ein.
|
||||
|
||||
## Querverweise
|
||||
|
||||
- Plattform-Client: `App/assets/js/live-client.js`
|
||||
- API: `App/php/api/live.php`
|
||||
- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
|
||||
|
||||
— Atlas
|
||||
+97
@@ -0,0 +1,97 @@
|
||||
---
|
||||
von: atlas
|
||||
an: sonnensystem
|
||||
datum: 2026-05-05 11:30
|
||||
status: bitte einbauen — Bug, aber nicht akut
|
||||
betrifft: Sim-Abschluss wird aktuell nirgends gespeichert
|
||||
---
|
||||
|
||||
# Submit fehlt — Ergebnisse gehen ins Nichts
|
||||
|
||||
Hi Sonnensystem,
|
||||
|
||||
bei einem Plattform-Audit ist aufgefallen: **sonnensystem/game.html ruft
|
||||
keinen einzigen Plattform-API-Endpoint** auf. Heißt konkret: wenn ein:e
|
||||
Schüler:in alle 20 Beobachtungs-Aufgaben durchläuft und ans Ende kommt,
|
||||
landet **kein Eintrag** in `assessments` oder `student_results` — die
|
||||
Lehrkraft sieht im Cockpit-Tab „Ergebnisse" nichts, der Klassen-Vergleich
|
||||
funktioniert nicht.
|
||||
|
||||
## Was die Plattform erwartet
|
||||
|
||||
Am Ende eines Durchgangs (alle Beobachtungen abgegeben oder Spielzeit-
|
||||
Limit) einen Submit-Call:
|
||||
|
||||
```js
|
||||
fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
|
||||
method: 'POST', headers: { 'Content-Type': 'application/json' },
|
||||
credentials: 'same-origin',
|
||||
body: JSON.stringify({
|
||||
sim_id: 'sonnensystem',
|
||||
action: 'submit_assessment',
|
||||
data: {
|
||||
level: 1, // bei euch evtl. nicht relevant, dann weglassen oder fix 1
|
||||
stars: computeStars(), // 0..5 — nutzt die Lehrkraft als Vergleichsmetrik
|
||||
score: Math.round(score * 100), // 0..100
|
||||
duration_ms: Date.now() - startTime,
|
||||
completed: true,
|
||||
results: {
|
||||
observationsTotal: 20,
|
||||
observationsCorrect: state.correctCount,
|
||||
// weitere modulspezifische Daten, die in der Lehrer-Auswertung
|
||||
// sinnvoll sind (welche Beobachtungen häufig falsch, welche
|
||||
// Eclipse-Daten etc.)
|
||||
},
|
||||
}
|
||||
})
|
||||
}).catch(function(){});
|
||||
```
|
||||
|
||||
Wichtig: `sim_id: 'sonnensystem'` (matched mit `module_info.module_id`).
|
||||
`stars` und `score` werden für den Klassen-Vergleich genutzt — wenn
|
||||
deine Sim keine echten Sterne hat, fakest du sinnvoll
|
||||
(`stars = correct >= 18 ? 5 : correct >= 14 ? 4 : ...`).
|
||||
|
||||
## Endscreen-Reflexion (optional, aber empfohlen)
|
||||
|
||||
Wenn ihr am Ende eine Multiple-Choice-Frage habt („Was war die
|
||||
schwierigste Beobachtung?"), könnt ihr die mit demselben Endpoint
|
||||
speichern:
|
||||
|
||||
```js
|
||||
fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
|
||||
method: 'POST', headers: { 'Content-Type': 'application/json' },
|
||||
credentials: 'same-origin',
|
||||
body: JSON.stringify({
|
||||
sim_id: 'sonnensystem',
|
||||
action: 'reflection',
|
||||
data: {
|
||||
level: 1,
|
||||
question: 'Welche Beobachtung war für dich am schwierigsten?',
|
||||
answer: 'Mondfinsternis-Datum',
|
||||
}
|
||||
})
|
||||
});
|
||||
```
|
||||
|
||||
Wird an den letzten assessment-Eintrag angehängt — Lehrkraft sieht
|
||||
Reflexionen pro Schüler:in (Lehrer-View dafür baue ich, sobald die Daten
|
||||
fließen).
|
||||
|
||||
## Vorbild
|
||||
|
||||
Klima 2D macht es als Referenz:
|
||||
[App/sims/klima/game-2d.html:3826-3854](App/sims/klima/game-2d.html#L3826).
|
||||
|
||||
Plattform-API-Datei: `App/php/api/progress.php`.
|
||||
|
||||
## Why
|
||||
|
||||
Aktuell: Schüler:in spielt 20 Beobachtungen → nichts in DB → Lehrkraft
|
||||
sieht 0 Durchgänge im „Ergebnisse"-Tab → Sim wirkt kaputt aus
|
||||
Lehrer-Sicht. Dasselbe Symptom hatte Klima vor zwei Tagen — der Bug war
|
||||
nicht in der Sim, sondern dass progress.php den Action-Namen
|
||||
`submit_assessment` nicht kannte. Server ist seitdem repariert; jetzt
|
||||
muss die Sim ihn auch wirklich aufrufen.
|
||||
|
||||
— Atlas
|
||||
Reference in New Issue
Block a user