first

04_Tablet-Quiz/README.md

@@ -0,0 +1,101 @@
+# Tablet-Quiz — Begleit-App (Teilprojekt)
+
+**Status:** Konzept · **Typ:** eigenständiges Software-Teilprojekt des SLC-Workshops
+
+Das Tablet-Quiz ist der **digitale Begleiter** des Tabletops — kein Ersatz fürs
+Brett. Es ist der **erklärende Gegenpart** zu den Plättchen und **ersetzt deren
+Rückseite**: Die Plättchen tragen nur noch die Kurzbezeichnung, die ausführliche
+Erklärung liefert die App. Sie **führt die Stationsreihenfolge** (linearer
+Lifecycle), stellt pro Station ein **vermittelndes Quiz**, gibt danach die
+**ausführliche Auflösung** und protokolliert Verständnislücken fürs Debrief.
+
+---
+
+## 1. Ziel & Rolle im Spiel
+
+- **Stationsführung:** schaltet Station für Station automatisch weiter („Nächste Station") — die Plättchen brauchen keinen Code.
+- **Active Recall verstärken:** erst Diskussion am Board, dann vermittelndes Quiz, dann Auflösung — Gruppe rät, App bestätigt/korrigiert.
+- **Vollständige Erklärung:** liefert nach dem Quiz die ausführliche Auflösung (ersetzt die Plättchenrückseite) aus dem Blueprint (Single Source of Truth).
+- **Dokumentation:** erfasst automatisch, welche Aktivitäten unklar waren (→ `../05_Workshop-Dokumentation/`).
+
+Bewusst **nicht** das Ziel: das Spiel digital ersetzen, Echtzeit-Multiplayer,
+Accounts/Login, Cloud-Pflicht.
+
+## 2. Datengrundlage (keine Doppelpflege)
+
+Die App liest ausschließlich die bestehenden Blueprint-Dateien und leitet
+Fragen daraus ab:
+
+| Quelle | liefert |
+|--------|---------|
+| `service-lifecycle_*.yaml` | Aktivitäten, Beschreibungen, Reihenfolge, Gates |
+| `spm_rollen.yaml` | Rollen, RACI, Gate-Keeper |
+
+Ein Build-Schritt konvertiert die YAMLs in ein statisches `questions.json`.
+Damit bleibt der Blueprint die einzige Wahrheit; Inhalte werden nie im App-Code
+dupliziert.
+
+## 3. Fragetypen
+
+1. **Reihenfolge:** „Was kommt nach `tr_08`?"
+2. **Rolle / RACI:** „Wer ist *Accountable* für `op_06`?"
+3. **Artefakt:** „Welches Artefakt entsteht bei `tr_07`?"
+4. **Gate-Logik:** „Wer muss an Gate 1 zustimmen?" / „Welche Pfade gibt es?"
+5. **Zuordnung:** „In welcher Phase liegt `sp_09`?"
+
+Jede Frage: Gruppentipp → *Auflösen*-Button → Modellantwort. Im Anschluss an das
+Quiz folgt die **ausführliche Auflösung** der Station (vollständige Beschreibung +
+Rollen/RACI + Artefakt aus der YAML) — das ist der Inhalt, der früher auf der
+Plättchenrückseite stand.
+
+## 4. Ablauf (UI-Flow)
+
+```
+[Start] → Szenario wählen (= Action Card)
+   → App führt zur aktuellen Station (linearer Lifecycle, Fortschritt sichtbar)
+   → Station:
+       → Gruppe diskutiert am Board anhand der Kurzbezeichnung (App noch zu)
+       → Quiz (vermittelnd): Frage(n) → Gruppentipp → "Auflösen" → richtig/falsch
+       → ausführliche Auflösung der Station (Erklärung + RACI + Artefakt)
+       → Gruppe reflektiert; optional "war unklar" markieren
+       → "Nächste Station"
+   → an Gates: Gate-Frage + Rollen-Check
+   → [Ende] → Debrief-Export (unklare Aktivitäten, Quote, Pfad)
+```
+
+## 5. Funktionsumfang (MVP)
+
+- [ ] `questions.json` + Stations-Inhalte aus YAMLs generieren (Build-Skript).
+- [ ] Stationsführung: linearer Durchlauf mit „Nächste Station" + Fortschritt/Phasen-Farben.
+- [ ] Fragetypen 1–3 (vermittelndes Quiz).
+- [ ] „Auflösen"-Mechanik (Antwort erst auf Klick) **+ ausführliche Stationsauflösung** (Erklärung/RACI/Artefakt) nach dem Quiz.
+- [ ] „Unklar"-Markierung je Aktivität.
+- [ ] Debrief-Export (Markdown/JSON, lokal).
+
+### Später (Ausbau)
+- Gate-Fragen mit Rollen-Check (Typ 4–5).
+- Mehrere Szenarien mit unterschiedlichen Fragesets.
+- Punktestand / Team-Modus.
+- Mehrsprachigkeit.
+
+## 6. Technik-Empfehlung
+
+- **Single-Page-Web-App**, offline lauffähig (PWA), passt zum bestehenden
+  HTML-first-Stil im Repo (vgl. MB-Retro-HTMLs).
+- Kein Backend nötig: statisches `questions.json` + LocalStorage für das Logbuch.
+- Tablet im Kiosk-/Vollbildmodus; keine Konten, keine Cloud.
+- Stack-Vorschlag: Vanilla JS oder leichtes Framework, ein Build-Skript (Node/Python)
+  für die YAML→JSON-Konvertierung.
+
+## 7. Schnittstellen zum restlichen Spiel
+
+- **Eingang:** Szenarioauswahl = gezogene Action Card (`../03_Karten/`).
+- **Inhalt:** Aktivitäten/Gates/Rollen = Brett-Elemente (`../00_Konzept/`).
+- **Ausgang:** Debrief-Daten → Workshop-Dokumentation (`../05_Workshop-Dokumentation/`).
+
+## 8. Offene Punkte
+
+- [ ] Format `questions.json` spezifizieren.
+- [ ] Entscheidung Framework vs. Vanilla.
+- [ ] Wer pflegt/baut? (intern DIGIT vs. extern)
+- [ ] Datenschutz: rein lokal, keine personenbezogenen Daten — bestätigen.