From 665b43e06905b75bdd241f968a584d110652b4ff Mon Sep 17 00:00:00 2001 From: Thomas Date: Wed, 19 Aug 2026 15:16:08 +0200 Subject: [PATCH] =?UTF-8?q?Doku:=20Relevante=20Infos=20f=C3=BCr=20Lehrpers?= =?UTF-8?q?onen=20(Zusammenfassung=20Lehrer-Cockpit)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 --- .../lehrer-relevante-infos-2026-08-19.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 .dontDeploy/notes/lehrer-relevante-infos-2026-08-19.md diff --git a/.dontDeploy/notes/lehrer-relevante-infos-2026-08-19.md b/.dontDeploy/notes/lehrer-relevante-infos-2026-08-19.md new file mode 100644 index 0000000..39c965c --- /dev/null +++ b/.dontDeploy/notes/lehrer-relevante-infos-2026-08-19.md @@ -0,0 +1,42 @@ +# 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) +1. **Kuratierte Spalten je Sim** — nie Roh-State dumpen, nie interne `__`-Heartbeat-Keys zeigen. Fehlt ein Schema → gefilterter Fallback (ohne Rausch-Felder). +2. **Klartext statt Jargon** — „Stark/Solide/Viele Fehler" statt „Kritisch/OK"; „Gerade dabei" statt „Phase". +3. **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". +4. **Ein Wort + 3-Buchstaben-Kürzel je Sim** (SIM_LABELS) — enge Balken nutzen das Kürzel, breite das Wort. +5. **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 (`__activeMs` etc.) kommen automatisch aus live-client.js; bei Pause `window.__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`/`wrongClicks` nachrüsten (bisher nur Weltküche).