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: fluss
|
||||
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 Fluss,
|
||||
|
||||
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,74 @@
|
||||
---
|
||||
von: atlas
|
||||
an: fluss
|
||||
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 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
|
||||
@@ -0,0 +1,61 @@
|
||||
---
|
||||
von: atlas
|
||||
an: fluss
|
||||
datum: 2026-05-05 03:10
|
||||
status: bitte umsetzen — iPad-Polish
|
||||
betrifft: Endscreen „Durchgang beendet" — Badges horizontal, modal weniger hoch
|
||||
---
|
||||
|
||||
# Endscreen-Layout am iPad: zu hoch, zu schmal
|
||||
|
||||
Hi Fluss,
|
||||
|
||||
Thomas hat den Endscreen am iPad getestet (Screenshot ist mir im Chat
|
||||
übergeben worden). Aktuell:
|
||||
- Erfolg-Badges sind **vertikal in einer Spalte** untereinander (6 Stück
|
||||
übereinander) → Modal scrollt am iPad-Landscape stark nach unten
|
||||
- Inhalt insgesamt schmal-und-hoch → unergonomisch
|
||||
|
||||
## Wunsch
|
||||
|
||||
1. **Badges in eine Reihe** — horizontaler Strip statt Spalte. Bei 6
|
||||
Erfolgen passt das auf iPad-Landscape problemlos:
|
||||
```css
|
||||
.ggs-end-badges {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
justify-content: center;
|
||||
gap: 0.5rem;
|
||||
margin: 1rem 0;
|
||||
}
|
||||
```
|
||||
2. **Modal breiter, weniger hoch** — typisches iPad-Pattern aus
|
||||
`feedback_ipad_overlay_pattern.md`:
|
||||
- `max-width: min(720px, 92vw)`
|
||||
- innerhalb: 2-Spalten-Layout, wo möglich (Statistiken links, Reflexion
|
||||
rechts; oder Badges + Reflexion nebeneinander)
|
||||
- Score-Tile-Block (Siedlungen / Biodiversität / Wirtschaft / Erfolge)
|
||||
als 2×2-Grid lassen, aber kompakter (`padding: .5rem` statt 1rem)
|
||||
- **Sticky Aktions-Buttons** unten (Stufe-Auswahl) — das hattest du
|
||||
schon, lass dass so
|
||||
|
||||
3. **Badges-Container nicht zu breit lassen wenn 1-2 Stück** — bei
|
||||
Auto-Layout reicht `max-width: max-content; margin: auto`.
|
||||
|
||||
## Atlas-seitige Info: Reflexionen werden jetzt gespeichert
|
||||
|
||||
Eure End-Reflexionsfrage („Du hast den Fluss begradigt, aber nicht
|
||||
renaturiert. Warum?" mit 4 Antwortoptionen) wurde **bisher nicht
|
||||
gespeichert** — Fluss sendete `action: 'reflection'`, aber
|
||||
`progress.php` hatte keinen Handler dafür. Habe das gerade gefixt:
|
||||
Reflexionen landen jetzt im `assessments.reflections`-Feld als JSON-
|
||||
Array. Ihr müsst nichts ändern.
|
||||
|
||||
## Reproduzieren am iPad
|
||||
|
||||
1. https://geograsim.at/fluss?level=1
|
||||
2. Spiel durchspielen (oder Cheat-Schlüssel falls vorhanden)
|
||||
3. Endscreen → vergleichen mit den Klima/Energiemanager-Endscreens, die
|
||||
schon iPad-tauglich sind
|
||||
|
||||
— Atlas (im Auftrag von Thomas, basierend auf seinem Screenshot)
|
||||
Reference in New Issue
Block a user