# Schulbuch-Konzept (Auftrag Thomas, 2026-07-12)

Hinter jeder Sim entsteht ein Schulbuch-Kapitel: Sachinhalte lehrplankonform,
mit Links (Glossar-Tooltips, Sim, Quellen), präsentierbar vor/zwischen/nach dem
Arbeiten mit der Simulation. Zwei Versionen aus EINER Quelle.

## Architektur

- **Routen:** `/buch` (Übersicht aller Kapitel) · `/buch-<sim>` (Kapitel).
  Lehrer-Version über `?lehrer=1` (Toggle-Link auf der Seite).
  TODO später: Lehrer-Version hinter Teacher-Session (wie Marktplatz-Plan).
- **Dateien:** `App/pages/buch.php` + `App/pages/buch-<sim>.php`.
  Erste Iteration self-contained (eigenes CSS im File, Schulbuch-Look),
  bei Kapitel 3+ ggf. gemeinsames Partial extrahieren.
- **Fotos (echte Bilder von Thomas):** Slots via PHP-Helper `buchBild($slug,
  $vorschlag)`. Sucht `App/assets/img/buch/<sim>/<slug>.{jpg,webp,png}` —
  Datei da → Bild erscheint automatisch; sonst Platzhalter-Kasten
  „📷 FOTO GESUCHT: <konkreter Vorschlag>". Thomas legt Dateien einfach ab.
- **Glossar:** `data-glossar`-Spans + plattformweite glossar-tooltip.js.
- **Druck:** @media print → A4, Seitenumbrüche an Kapitel-Seiten, Nav/Toggle raus.
- **Quellen:** Jede Daten-Box nummeriert [1]…, Quellenverzeichnis am Ende
  (aus QUELLEN.md der Sim übernommen).

## Baukasten (Inhaltselemente)

- Kapitel-Opener: großes Bild, Leitfrage, Lernziele-Box, Lehrplan-Chips (D-A-CH)
- „Seite"-Sektionen: Sachtext (~250–400 Wörter), Merke-Kasten, Daten-Kasten,
  Begriffs-Chips (Glossar), Foto
- 🎮 Sim-Kasten: „So ist es in der Simulation" — erklärt die Mechanik & ihren
  Realitätsbezug (Schülerversion = vollständige Mechanik-Referenz)
- ✏️ Aufgaben-Kasten: vor / während / nach dem Arbeiten, gestuft
- 💡 Lehrer-Kästen (nur ?lehrer=1): Verlaufsvorschlag (Doppelstunde),
  didaktischer Kommentar je Seite, Stolpersteine (z. B. „Panzer-Rush endet in
  Bank-Liquidation — bewusst so"), Differenzierung, Erwartungshorizont,
  Cockpit-Tipps (welche Live-Spalten/Ergebnisse ansehen)

## Kapitel-Fahrplan

1. **Tourismustal** (gebaut 2026-07-12, beide Versionen) — Pilot
2. Tourismusregion (Besucherlenkung/Mobilität)
3. danach je Bestands-Sim (Busfahrt, Heli, Klima, …) nach Priorität Thomas

## Foto-Workflow

Kapitel nennt pro Slot einen konkreten Vorschlag. Thomas fotografiert real
(Vorarlberg/Arlberg-Umfeld vorhanden), legt ab unter
`App/assets/img/buch/<sim>/<slug>.jpg` → erscheint automatisch. Credits-Zeile
optional via Dateiname egal; Bildunterschrift steht im Kapitel.