- 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>
GeoGraSim — Inbox Protokoll
Asynchroner Nachrichten-Austausch zwischen der Zentrale (Plattform-Instanz) und den einzelnen Modul-Instanzen. Der Nutzer (Thomas) muss Nachrichten nicht mehr manuell hin- und herkopieren.
Ordnerstruktur
App/sims/_inbox/
├── README.md ← Dieses Protokoll
├── zentrale/ ← Eingang für die Zentrale (Fragen/Feedback von Modulen)
│ └── YYYY-MM-DD-HHMM-<absender>-<stichwort>.md
├── klima/ ← Eingang für die Klima-Instanz
├── fluss/ ← Eingang für die Fluss-Instanz (spaeter)
├── heli/ ← Eingang für die Heli-Instanz (spaeter)
└── stadt/ ← Eingang für die Stadt-Instanz (spaeter)
Dateiname-Konvention
YYYY-MM-DD-HHMM-<stichwort>.md
Beispiele:
2026-04-16-1830-spiellogik-aus-3d.md2026-04-16-1900-frage-zu-glossar.md
Die alphabetische Sortierung ergibt automatisch die chronologische Reihenfolge.
Nachrichten-Format
Jede Nachricht beginnt mit YAML-Frontmatter:
---
von: zentrale | klima | fluss | heli | stadt
an: zentrale | klima | fluss | heli | stadt
datum: 2026-04-16 18:30
status: neu | gelesen | beantwortet
betrifft: kurze Themenbeschreibung
---
# Betreff
Nachrichtentext mit Details...
Workflow
Für Modul-Instanzen (z.B. Klima)
-
Vor jedem groesseren Arbeitsschritt den eigenen Eingang pruefen:
ls App/sims/_inbox/klima/ -
Neue Nachrichten (status: neu) lesen, beruecksichtigen, dann Status auf
gelesensetzen (Frontmatter editieren). -
Eigene Fragen oder Feedback an die Zentrale als neue Datei in
App/sims/_inbox/zentrale/anlegen:App/sims/_inbox/zentrale/2026-04-16-1845-klima-frage-glossar.md
Für die Zentrale
-
Vor jedem Turn mit dem Nutzer den Eingang pruefen:
ls App/sims/_inbox/zentrale/ -
Neue Nachrichten lesen, dem Nutzer erwaehnen, Status aktualisieren.
-
Anweisungen oder Antworten an Module in deren Eingangsordner ablegen.
Wichtig
- Keine Nachrichten loeschen — sie bleiben als Audit-Trail.
- Status ehrlich setzen — so sieht die andere Seite sofort, was neu ist.
- Kurze Nachrichten bevorzugen — lieber mehrere kleine als eine riesige.
- Bei dringenden Themen den Nutzer explizit erwaehnen ("Bitte an Thomas weiterleiten: ...")