3.3 KiB
3.3 KiB
Relevante Infos für Lehrpersonen — Zusammenfassung
Stand 2026-08-19. Konsolidiert, was wir zum Lehrer-Cockpit festgehalten und gebaut haben.
Die Kernfrage der Lehrperson
„Wer ist gerade engagiert und macht es gut — und wer blödelt herum oder hängt fest?"
Alles im Cockpit dient dieser Frage. Kein Zahlen-Dump, sondern wenige aussagekräftige Signale.
Die 6 relevanten Signale
| Signal | Was es beantwortet | Woher |
|---|---|---|
| Fortschritt | Wie weit durch die Sim? (%) | progressPct / abgeleitet je Sim |
| Qualität | Blödeln vs. gut — Verhältnis richtige ↔ falsche Klicks (grafischer Balken) | correctClicks/wrongClicks (bisher Weltküche; andere ziehen nach) |
| Fleiß | Wie viel im gewählten Zeitraum geschafft? (z. B. Gerichte, gelieferte Aufträge) | assessments im Intervall |
| Lage | Klartext: Stark / Solide / Viele Fehler (kein „Kritisch"-Jargon) | _liveMood je Sim |
| Aktivität | aktiv / idle / pausiert — war das Kind die ganze Stunde dabei? | Heartbeat __activeMs/__idleMs/__paused |
| Hilfe-Bedarf | „🆘 braucht evtl. Hilfe" | _liveNeedsHelp je Sim (z. B. Budget < 0, viele Fehlversuche) |
Die Ansichten (Menü „Ergebnisse")
- 📅 Tag — Zeitstrahl aller Sessions des Tages je Kind, eingefärbt nach Erfolg. Balken tragen Sim-Kürzel/Wort (LOG, Logistik …), Klick öffnet Detail.
- 🔴 Aktuell — Live-Tabelle je Sim mit kuratierten Spalten (LIVE_PRIMARY_FIELDS), Qualitäts-Balken, Fortschritt, Lage. Aktualisiert alle 4 s.
- 📊 Vergleich — aktive Kinder EINER Sim nebeneinander (Fortschritt + Qualität) → direkter „wer gut / wer nicht".
- 📚 Gesamt — Aggregat (Fleiß-Zeit, Modul-Karten, Matrix) über den gewählten Zeitraum.
Design-Prinzipien (verbindlich)
- Kuratierte Spalten je Sim — nie Roh-State dumpen, nie interne
__-Heartbeat-Keys zeigen. Fehlt ein Schema → gefilterter Fallback (ohne Rausch-Felder). - Klartext statt Jargon — „Stark/Solide/Viele Fehler" statt „Kritisch/OK"; „Gerade dabei" statt „Phase".
- Ehrliche Zeit — Aktivzeit zählt nicht bei Spiel-Pause und nicht bei Tab-weg/idle (>5 min). Sonst wirkt ein pausiertes Kind fälschlich „fleißig".
- Ein Wort + 3-Buchstaben-Kürzel je Sim (SIM_LABELS) — enge Balken nutzen das Kürzel, breite das Wort.
- Datenschutz — nur was die Lehrperson pädagogisch braucht; verdeckte Antworten (z. B. Kofferdetektiv-Ziel) bleiben verdeckt, solange das Kind sucht.
Was jede Sim liefern sollte (GGS_LIVE_STATE)
progressPct(0–100), ein Fortschritts-Zähler (z. B.completed/total),correctClicks/wrongClicks(für die Qualitäts-Kennzahl — Ziel: alle Sims),- optional
health(good/ok/struggling) für die Lage, - Heartbeat-Felder (
__activeMsetc.) kommen automatisch aus live-client.js; bei Pausewindow.__GGS_LIVE__.setPaused(true)rufen.
Offen (siehe project_backlog_2026-08-18 / project_lehrer_observability_overhaul)
- Aktivitäts-/Qualitätsstreifen pro Kind über die Stunde (grün→rot, aktiv→inaktiv & bullshit→ernsthaft) — braucht Zeitreihen-Aktivitätsdaten.
- Weltküche-Gesamt-Kachel (Gerichte · Ø Punkte · Fehlquote).
- Andere Sims mit
correctClicks/wrongClicksnachrüsten (bisher nur Weltküche).