Atlas: Live-View-Feature + Submit-Bug-Fixes + Admin-Styleguide

- 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>
2026-05-07 01:20:53 +02:00
parent e354a30a44
commit 33fb423967
56 changed files with 4869 additions and 226 deletions
@@ -0,0 +1,24 @@
+-- 2026-05-04: Tempo-Kontrolle + Live View
+-- Idempotent.
+
+-- 1) Pause-Schalter pro Klasse+Modul (Lehrer steuert das Tempo)
+SET @col_exists := (
+  SELECT COUNT(*) FROM information_schema.COLUMNS
+  WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'class_modules' AND COLUMN_NAME = 'paused'
+);
+SET @sql := IF(@col_exists = 0,
+  'ALTER TABLE class_modules ADD COLUMN paused TINYINT(1) NOT NULL DEFAULT 0 AFTER current_level',
+  'SELECT 1');
+PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
+
+-- 2) Live-Heartbeat-Tabelle für Live View
+CREATE TABLE IF NOT EXISTS live_sessions (
+  student_id  INT UNSIGNED PRIMARY KEY,
+  class_id    INT UNSIGNED NOT NULL,
+  module_id   VARCHAR(16) NOT NULL,
+  state_json  LONGTEXT,
+  started_at  TIMESTAMP NULL,
+  last_seen   TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  INDEX idx_class (class_id, last_seen),
+  INDEX idx_module (module_id, last_seen)
+) ENGINE=InnoDB;
@@ -0,0 +1,90 @@
+-- 2026-05-04: Lehrer Jakob + 3 Schüler in Klasse "Jakob 1" + je 1 Lizenz
+-- Idempotent: kann mehrfach ausgeführt werden, ohne Daten zu duplizieren.
+-- Passwörter als bcrypt-Hash (PHP_DEFAULT, $2y$10$).
+
+START TRANSACTION;
+
+-- 1) Lehrer Jakob (jakob@geograsim.at / hoppala3355!)
+INSERT INTO teachers (username, email, password, display_name, email_verified)
+VALUES ('jakob', 'jakob@geograsim.at',
+        '$2y$10$ofuRFIeNBm/UVZcATyI37eFmEph1vfC81SeP7lalIRNynxoLb77C6',
+        'Jakob', 1)
+ON DUPLICATE KEY UPDATE
+  email          = VALUES(email),
+  password       = VALUES(password),
+  display_name   = VALUES(display_name),
+  email_verified = VALUES(email_verified);
+
+SET @teacher_id := (SELECT id FROM teachers WHERE username='jakob' LIMIT 1);
+
+-- 2) Klasse "Jakob 1" mit Join-Code JAKOB1
+INSERT INTO classes (teacher_id, name, school_year, join_code)
+VALUES (@teacher_id, 'Jakob 1', '25/26', 'JAKOB1')
+ON DUPLICATE KEY UPDATE
+  teacher_id  = VALUES(teacher_id),
+  name        = VALUES(name),
+  school_year = VALUES(school_year);
+
+SET @class_id := (SELECT id FROM classes WHERE join_code='JAKOB1' LIMIT 1);
+
+-- 3) Schüler:innen (Pseudonyme, anonym=1)
+INSERT INTO students (class_id, username, password, password_plaintext, display_name, is_anonymous, emoji_avatar)
+VALUES
+  (@class_id, 'Alexom',   '$2y$10$FvNMeFn/ozKIZY0l2zbQEOx/UZefPQZIf2bbDcOA/igjNBWxj5H0a', '3322', 'Alexom',   1, '🧑‍🎓'),
+  (@class_id, 'Berturam', '$2y$10$uj6YrgOqTeI9nv9bV.5/XOEFYRLrlt5MdXBzxRX3dFREcw2Th9X1C', '7788', 'Berturam', 1, '🧑‍🎓'),
+  (@class_id, 'Sussama',  '$2y$10$nOS5jXAY.kuMQ1mhr/6Zwug/fHglF94K3D5gSg.1RWrSoq7GIr7y6', '9991', 'Sussama',  1, '🧑‍🎓')
+ON DUPLICATE KEY UPDATE
+  password           = VALUES(password),
+  password_plaintext = VALUES(password_plaintext),
+  display_name       = VALUES(display_name),
+  is_anonymous       = VALUES(is_anonymous),
+  emoji_avatar       = VALUES(emoji_avatar);
+
+SET @stud_alex := (SELECT id FROM students WHERE class_id=@class_id AND username='Alexom'   LIMIT 1);
+SET @stud_bert := (SELECT id FROM students WHERE class_id=@class_id AND username='Berturam' LIMIT 1);
+SET @stud_suss := (SELECT id FROM students WHERE class_id=@class_id AND username='Sussama'  LIMIT 1);
+
+-- 4) Lizenzen — pro Schüler eine Lizenz aus dem freien Pool nehmen, an Jakob redeemen, an Schüler zuweisen.
+--    Wenn der Schüler schon eine Lizenz hat → die behalten (idempotent).
+SET @lic_alex := IFNULL(
+  (SELECT id FROM licenses WHERE student_id=@stud_alex LIMIT 1),
+  (SELECT id FROM licenses WHERE student_id IS NULL AND teacher_id IS NULL ORDER BY id LIMIT 1)
+);
+UPDATE licenses
+   SET teacher_id  = @teacher_id,
+       redeemed_at = COALESCE(redeemed_at, NOW()),
+       student_id  = @stud_alex
+ WHERE id = @lic_alex;
+
+SET @lic_bert := IFNULL(
+  (SELECT id FROM licenses WHERE student_id=@stud_bert LIMIT 1),
+  (SELECT id FROM licenses WHERE student_id IS NULL AND teacher_id IS NULL ORDER BY id LIMIT 1)
+);
+UPDATE licenses
+   SET teacher_id  = @teacher_id,
+       redeemed_at = COALESCE(redeemed_at, NOW()),
+       student_id  = @stud_bert
+ WHERE id = @lic_bert;
+
+SET @lic_suss := IFNULL(
+  (SELECT id FROM licenses WHERE student_id=@stud_suss LIMIT 1),
+  (SELECT id FROM licenses WHERE student_id IS NULL AND teacher_id IS NULL ORDER BY id LIMIT 1)
+);
+UPDATE licenses
+   SET teacher_id  = @teacher_id,
+       redeemed_at = COALESCE(redeemed_at, NOW()),
+       student_id  = @stud_suss
+ WHERE id = @lic_suss;
+
+COMMIT;
+
+-- Bestätigung
+SELECT t.id AS teacher_id, t.username, t.email
+  FROM teachers t WHERE t.username='jakob';
+SELECT c.id AS class_id, c.name, c.school_year, c.join_code
+  FROM classes c WHERE c.teacher_id=(SELECT id FROM teachers WHERE username='jakob');
+SELECT s.id, s.username, s.display_name, s.password_plaintext, l.code AS license_code
+  FROM students s
+  LEFT JOIN licenses l ON l.student_id = s.id
+ WHERE s.class_id=(SELECT id FROM classes WHERE join_code='JAKOB1')
+ ORDER BY s.id;
@@ -0,0 +1,10 @@
+-- 2026-05-04: KI-Avatare für die 3 Test-Schüler in Klasse JAKOB1
+-- Idempotent — kann mehrfach ausgeführt werden.
+SET @class_id := (SELECT id FROM classes WHERE join_code='JAKOB1' LIMIT 1);
+
+UPDATE students SET emoji_avatar='avatar:fuchs-explorer' WHERE class_id=@class_id AND username='Alexom';
+UPDATE students SET emoji_avatar='avatar:adler-pilot'    WHERE class_id=@class_id AND username='Berturam';
+UPDATE students SET emoji_avatar='avatar:eule-prof'      WHERE class_id=@class_id AND username='Sussama';
+
+SELECT s.id, s.username, s.emoji_avatar
+  FROM students s WHERE s.class_id=@class_id ORDER BY s.id;
@@ -85,6 +85,7 @@
  <a href="heli" class="nav-btn" target="_blank">🗺️ Gesamtkarte</a>
  <a href="admin-modules.html" class="nav-btn">🧩 Module</a>
  <a href="admin-licenses.html" class="nav-btn">🔑 Lizenzen</a>
+  <a href="admin-styleguide.html" class="nav-btn">🎨 Styleguide</a>
  <a href="admin.html" class="nav-btn">Logout</a>
 </div>

@@ -42,6 +42,7 @@
  <h1><img src="assets/img/geograsim_t.svg" alt="GeoGraSim"> Lizenzverwaltung (Admin)</h1>
  <a href="admin-modules.html" class="btn-sm">🧩 Module</a>
  <a href="admin-levels.html" class="btn-sm">🎮 Level</a>
+  <a href="admin-styleguide.html" class="btn-sm">🎨 Styleguide</a>
  <a href="admin.html" class="btn-sm">Logout</a>
 </div>

@@ -76,6 +76,7 @@
  <h1><img src="assets/img/textlogo_geograsim.svg" alt="GeoGraSim"> Modul-Verwaltung (Admin)</h1>
  <a href="admin-licenses.html" class="btn-sm">🎟️ Lizenzen</a>
  <a href="admin-levels.html" class="btn-sm">🎮 Level</a>
+  <a href="admin-styleguide.html" class="btn-sm">🎨 Styleguide</a>
  <a href="admin.html" class="btn-sm">Logout</a>
 </div>

@@ -0,0 +1,331 @@
+<!DOCTYPE html>
+<html lang="de">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>GeoGraSim — Style-Guide (Admin)</title>
+  <link rel="icon" type="image/png" href="favicon-96x96.png" sizes="96x96">
+  <link rel="icon" type="image/svg+xml" href="favicon.svg">
+  <link rel="stylesheet" href="assets/fonts/inter.css">
+  <style>
+    *{margin:0;padding:0;box-sizing:border-box}
+    body{font-family:'Inter',sans-serif;background:#f7f6f3;min-height:100vh;color:#2a2a2a}
+    .topbar{background:#fff;padding:.6rem 1.2rem;display:flex;align-items:center;gap:.8rem;border-bottom:1px solid rgba(0,0,0,.06)}
+    .topbar h1{font-size:.95rem;font-weight:800;color:#4a7c8a;flex:1;display:flex;align-items:center;gap:.5rem}
+    .topbar h1 img{height:28px}
+    .btn-sm{padding:.3rem .6rem;border:1px solid rgba(0,0,0,.08);border-radius:6px;background:#fff;font-size:.68rem;font-weight:600;cursor:pointer;color:#4a4a4a;text-decoration:none}
+    .btn-sm:hover{background:#dae8ec;color:#4a7c8a}
+    .wrap{max-width:980px;margin:1rem auto;padding:0 1rem}
+    .card{background:#fff;border-radius:10px;padding:1.2rem 1.3rem;box-shadow:0 1px 4px rgba(0,0,0,.03);border:1px solid rgba(0,0,0,.04);margin-bottom:1rem}
+    .card-h{font-size:.65rem;font-weight:700;color:#4a7c8a;text-transform:uppercase;letter-spacing:.06em;margin-bottom:.65rem}
+    h2{font-size:1.15rem;font-weight:800;color:#1f4b37;margin-bottom:.4rem}
+    h3{font-size:.95rem;font-weight:700;color:#4a7c8a;margin:.9rem 0 .4rem}
+    p{font-size:.82rem;line-height:1.55;color:#4a4a4a;margin-bottom:.5rem}
+    p.lead{font-size:.78rem;color:#6a6a6a}
+    code{font-family:'JetBrains Mono','Fira Code',monospace;font-size:.78rem;background:#f0ede4;padding:.05rem .35rem;border-radius:4px;color:#1f4b37}
+    pre{font-family:'JetBrains Mono','Fira Code',monospace;font-size:.74rem;background:#f0ede4;padding:.7rem .9rem;border-radius:7px;color:#1f4b37;line-height:1.5;white-space:pre-wrap;word-break:break-word;margin:.4rem 0}
+    .copy-block{position:relative}
+    .copy-btn{position:absolute;top:.45rem;right:.5rem;font-size:.6rem;padding:.2rem .55rem;border:1.5px solid rgba(0,0,0,.1);border-radius:5px;background:#fff;cursor:pointer;font-weight:600;color:#4a7c8a}
+    .copy-btn:hover{background:#dae8ec}
+    .copy-btn.ok{background:#dceadd;color:#5a8a5e;border-color:#5a8a5e}
+    .swatches{display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:.7rem;margin:.5rem 0}
+    .sw{border:1px solid rgba(0,0,0,.06);border-radius:7px;overflow:hidden;cursor:pointer;background:#fff;transition:transform .12s}
+    .sw:hover{transform:translateY(-1px);border-color:#4a7c8a}
+    .sw-color{height:60px}
+    .sw-meta{padding:.45rem .55rem;font-size:.68rem}
+    .sw-meta strong{display:block;color:#1f4b37}
+    .sw-meta span{color:#8a8a8a;font-family:'JetBrains Mono',monospace;font-size:.66rem}
+    .pill{display:inline-block;padding:.18rem .55rem;border-radius:999px;font-size:.65rem;font-weight:600;background:#dae8ec;color:#1f4e5a;margin-right:.3rem}
+    .pill.warn{background:#fde8d0;color:#a05a2b}
+    .pill.bad{background:#f2ddd8;color:#a04a3a}
+    table{width:100%;border-collapse:collapse;font-size:.76rem;margin:.4rem 0}
+    th{text-align:left;background:#f7f6f3;padding:.4rem .55rem;font-weight:700;color:#4a4a4a;border-bottom:2px solid rgba(0,0,0,.06)}
+    td{padding:.4rem .55rem;border-bottom:1px solid rgba(0,0,0,.04);vertical-align:top}
+    ul{margin:.3rem 0 .6rem 1.3rem;font-size:.82rem;line-height:1.55;color:#4a4a4a}
+    ul li{margin-bottom:.2rem}
+    .toc{display:flex;flex-wrap:wrap;gap:.4rem;margin-bottom:1rem}
+    .toc a{padding:.3rem .65rem;background:#fff;border:1.5px solid rgba(0,0,0,.06);border-radius:6px;font-size:.7rem;color:#4a7c8a;text-decoration:none;font-weight:600}
+    .toc a:hover{background:#dae8ec;border-color:#4a7c8a}
+  </style>
+</head>
+<body>
+<div class="topbar">
+  <h1><img src="assets/img/geograsim_t.svg" alt="GeoGraSim"> Style-Guide (Admin)</h1>
+  <a href="admin-licenses.html" class="btn-sm">🔑 Lizenzen</a>
+  <a href="admin-modules.html" class="btn-sm">🧩 Module</a>
+  <a href="admin-levels.html" class="btn-sm">🎮 Level</a>
+  <a href="admin.html" class="btn-sm">Logout</a>
+</div>
+
+<div class="wrap">
+
+  <div class="toc">
+    <a href="#bildstil">🎨 Bildstil</a>
+    <a href="#farben-bild">🌿 Bild-Farbpalette</a>
+    <a href="#farben-ui">🧩 UI-Farbtokens</a>
+    <a href="#layout">📐 Layout &amp; Spacing</a>
+    <a href="#typo">🔤 Typografie</a>
+    <a href="#bilder">🖼️ Bildformate</a>
+    <a href="#ipad">📱 iPad-Patterns</a>
+    <a href="#sprache">🗣️ Sprache</a>
+  </div>
+
+  <div class="card">
+    <h2>Style-Guide</h2>
+    <p class="lead">Verbindliche Stil-Referenz für alle GeoGraSim-Module. Klick auf Farbfelder oder „Kopieren" überträgt den Wert in die Zwischenablage. Diese Seite ist die Single-Source-of-Truth — wenn du etwas änderst, musst du es hier auch aktualisieren.</p>
+  </div>
+
+  <!-- ============================================================== -->
+  <div class="card" id="bildstil">
+    <div class="card-h">DALL-E / Bildgenerierung</div>
+    <h3>Offizieller Prompt-Block</h3>
+    <p>Verbatim verwenden, NICHT umformulieren. Bei jedem Bild diesen Block voranstellen, danach nur den Szenen-Teil ergänzen.</p>
+    <div class="copy-block">
+      <button class="copy-btn" data-copy="prompt-base">Kopieren</button>
+      <pre id="prompt-base">Flat Scandinavian illustration, wide panoramic landscape filling the entire 16:9 frame edge-to-edge, painted style with clean vector shapes, dark forest green (#1f4b37) and sage green (#4a7c4e) tones, yellow-mustard (#e8c547) accents, beige (#e8e4d8) buildings and valleys, white highlights. No text, no watermark, no logos, no borders, no frame.</pre>
+    </div>
+
+    <h3>Eckdaten</h3>
+    <table>
+      <tr><th>Feld</th><th>Wert</th></tr>
+      <tr><td>Modell</td><td><code>dall-e-3</code></td></tr>
+      <tr><td>Splash-Auflösung</td><td>1792 × 1024 (16:9 panoramisch)</td></tr>
+      <tr><td>Glossar-Bilder</td><td>1792 × 1024, standard quality</td></tr>
+      <tr><td>Avatar-Bilder</td><td>1024 × 1024, kreisrund maskiert via CSS</td></tr>
+      <tr><td>Format</td><td>PNG</td></tr>
+      <tr><td>API-Key</td><td><code>OPENAI_API_KEY</code> in <code>App/.env.local</code> (nicht im Git)</td></tr>
+    </table>
+
+    <h3>Tabu</h3>
+    <p>
+      <span class="pill bad">keine Schrift im Bild</span>
+      <span class="pill bad">keine Logos</span>
+      <span class="pill bad">keine Wasserzeichen</span>
+      <span class="pill bad">keine Rahmen / Borders</span>
+    </p>
+
+    <h3>Single-Source-of-Truth</h3>
+    <p>Lauffähiger Referenz-Generator: <code>App/sims/logistik/scripts/generate-splash-images.sh</code> (Variable <code>PROMPT_BASE</code>). Bei Pipeline-Fragen dort als Vorlage abschauen.</p>
+
+    <h3>Why</h3>
+    <p>Konsistenz über alle Module. Die Sims stehen auf der Schülerseite nebeneinander; wenn ein Modul aus dem Stil ausbricht, fällt es sofort auf. Gilt nicht nur für Splashes, sondern auch für Spielfeld-Hintergründe, Sprites, Marker-Icons, Bewertungs-Visuals.</p>
+  </div>
+
+  <!-- ============================================================== -->
+  <div class="card" id="farben-bild">
+    <div class="card-h">Bild-Farbpalette (verbindlich für DALL-E + Sprites + SVGs)</div>
+    <p>Klick auf eine Karte kopiert den Hex-Wert.</p>
+    <div class="swatches">
+      <div class="sw" data-copy-text="#1f4b37"><div class="sw-color" style="background:#1f4b37"></div><div class="sw-meta"><strong>Forest green</strong><span>#1f4b37</span></div></div>
+      <div class="sw" data-copy-text="#4a7c4e"><div class="sw-color" style="background:#4a7c4e"></div><div class="sw-meta"><strong>Sage green</strong><span>#4a7c4e</span></div></div>
+      <div class="sw" data-copy-text="#e8c547"><div class="sw-color" style="background:#e8c547"></div><div class="sw-meta"><strong>Yellow-mustard</strong><span>#e8c547</span></div></div>
+      <div class="sw" data-copy-text="#e8e4d8"><div class="sw-color" style="background:#e8e4d8"></div><div class="sw-meta"><strong>Beige</strong><span>#e8e4d8</span></div></div>
+      <div class="sw" data-copy-text="#ffffff"><div class="sw-color" style="background:#ffffff;border:1px solid #ccc"></div><div class="sw-meta"><strong>Weiß-Highlights</strong><span>#ffffff</span></div></div>
+    </div>
+  </div>
+
+  <!-- ============================================================== -->
+  <div class="card" id="farben-ui">
+    <div class="card-h">UI-Farbtokens (CSS-Variablen aus design-system.css)</div>
+    <p>Diese Tokens nutzen alle Plattform-UIs (Cockpits, Admin, Wrapper, Modale). In Sims als <code>var(--ggs-fjord)</code> referenzieren.</p>
+
+    <h3>Akzent (Fjord)</h3>
+    <div class="swatches">
+      <div class="sw" data-copy-text="#4a7c8a"><div class="sw-color" style="background:#4a7c8a"></div><div class="sw-meta"><strong>--ggs-fjord</strong><span>#4a7c8a</span></div></div>
+      <div class="sw" data-copy-text="#1f4e5a"><div class="sw-color" style="background:#1f4e5a"></div><div class="sw-meta"><strong>--ggs-fjord-dark</strong><span>#1f4e5a</span></div></div>
+      <div class="sw" data-copy-text="#dae8ec"><div class="sw-color" style="background:#dae8ec"></div><div class="sw-meta"><strong>--ggs-fjord-light</strong><span>#dae8ec</span></div></div>
+    </div>
+
+    <h3>Erfolg (Moss)</h3>
+    <div class="swatches">
+      <div class="sw" data-copy-text="#5a8a5e"><div class="sw-color" style="background:#5a8a5e"></div><div class="sw-meta"><strong>--ggs-moss</strong><span>#5a8a5e</span></div></div>
+      <div class="sw" data-copy-text="#3a6b3e"><div class="sw-color" style="background:#3a6b3e"></div><div class="sw-meta"><strong>--ggs-moss-dark</strong><span>#3a6b3e</span></div></div>
+      <div class="sw" data-copy-text="#dcead0"><div class="sw-color" style="background:#dcead0"></div><div class="sw-meta"><strong>--ggs-moss-light</strong><span>#dcead0</span></div></div>
+    </div>
+
+    <h3>Warnung &amp; Fehler</h3>
+    <div class="swatches">
+      <div class="sw" data-copy-text="#e8833a"><div class="sw-color" style="background:#e8833a"></div><div class="sw-meta"><strong>--ggs-orange / warning</strong><span>#e8833a</span></div></div>
+      <div class="sw" data-copy-text="#c85c4a"><div class="sw-color" style="background:#c85c4a"></div><div class="sw-meta"><strong>--ggs-coral / danger</strong><span>#c85c4a</span></div></div>
+      <div class="sw" data-copy-text="#f0d0ca"><div class="sw-color" style="background:#f0d0ca"></div><div class="sw-meta"><strong>--ggs-coral-light</strong><span>#f0d0ca</span></div></div>
+    </div>
+
+    <h3>Neutral &amp; Sand</h3>
+    <div class="swatches">
+      <div class="sw" data-copy-text="#f5f2eb"><div class="sw-color" style="background:#f5f2eb;border:1px solid #ddd"></div><div class="sw-meta"><strong>--ggs-bg</strong><span>#f5f2eb</span></div></div>
+      <div class="sw" data-copy-text="#e8e4d8"><div class="sw-color" style="background:#e8e4d8;border:1px solid #ddd"></div><div class="sw-meta"><strong>--ggs-bg-dark</strong><span>#e8e4d8</span></div></div>
+      <div class="sw" data-copy-text="#e8d5b5"><div class="sw-color" style="background:#e8d5b5"></div><div class="sw-meta"><strong>--ggs-sand</strong><span>#e8d5b5</span></div></div>
+      <div class="sw" data-copy-text="#c4a97a"><div class="sw-color" style="background:#c4a97a"></div><div class="sw-meta"><strong>--ggs-sand-dark</strong><span>#c4a97a</span></div></div>
+      <div class="sw" data-copy-text="#e0ddd4"><div class="sw-color" style="background:#e0ddd4"></div><div class="sw-meta"><strong>--ggs-border</strong><span>#e0ddd4</span></div></div>
+    </div>
+
+    <h3>Text</h3>
+    <div class="swatches">
+      <div class="sw" data-copy-text="#2a2a2a"><div class="sw-color" style="background:#2a2a2a"></div><div class="sw-meta"><strong>--ggs-text</strong><span>#2a2a2a</span></div></div>
+      <div class="sw" data-copy-text="#8a8a8a"><div class="sw-color" style="background:#8a8a8a"></div><div class="sw-meta"><strong>--ggs-text-muted</strong><span>#8a8a8a</span></div></div>
+      <div class="sw" data-copy-text="#b0b0b0"><div class="sw-color" style="background:#b0b0b0"></div><div class="sw-meta"><strong>--ggs-text-light</strong><span>#b0b0b0</span></div></div>
+    </div>
+
+    <h3>Komplette CSS-Variable als Block</h3>
+    <div class="copy-block">
+      <button class="copy-btn" data-copy="css-tokens">Kopieren</button>
+      <pre id="css-tokens">--ggs-fjord:        #4a7c8a;
+--ggs-fjord-dark:   #1f4e5a;
+--ggs-fjord-light:  #dae8ec;
+--ggs-moss:         #5a8a5e;
+--ggs-moss-dark:    #3a6b3e;
+--ggs-moss-light:   #dcead0;
+--ggs-sand:         #e8d5b5;
+--ggs-sand-dark:    #c4a97a;
+--ggs-coral:        #c85c4a;
+--ggs-coral-light:  #f0d0ca;
+--ggs-orange:       #e8833a;
+--ggs-bg:           #f5f2eb;
+--ggs-bg-dark:      #e8e4d8;
+--ggs-white:        #ffffff;
+--ggs-text:         #2a2a2a;
+--ggs-text-muted:   #8a8a8a;
+--ggs-text-light:   #b0b0b0;
+--ggs-border:       #e0ddd4;
+--ggs-success:      #5a8a5e;
+--ggs-warning:      #e8833a;
+--ggs-danger:       #c85c4a;
+--ggs-info:         #4a7c8a;</pre>
+    </div>
+  </div>
+
+  <!-- ============================================================== -->
+  <div class="card" id="layout">
+    <div class="card-h">Layout &amp; Spacing</div>
+    <table>
+      <tr><th>Token</th><th>Wert</th><th>Verwendung</th></tr>
+      <tr><td><code>--ggs-gap-xs</code></td><td>4 px</td><td>Inline-Abstände, Pill-Padding</td></tr>
+      <tr><td><code>--ggs-gap-sm</code></td><td>8 px</td><td>Button-Innenabstand, Form-Felder</td></tr>
+      <tr><td><code>--ggs-gap-md</code></td><td>16 px</td><td>Card-Innenabstand, Standard-Layout</td></tr>
+      <tr><td><code>--ggs-gap-lg</code></td><td>24 px</td><td>Sektion-Abstand</td></tr>
+      <tr><td><code>--ggs-gap-xl</code></td><td>32 px</td><td>Hero-Bereiche</td></tr>
+      <tr><td><code>--ggs-radius-sm</code></td><td>6 px</td><td>Pills, kleine Buttons</td></tr>
+      <tr><td><code>--ggs-radius-md</code></td><td>12 px</td><td>Karten, Modale</td></tr>
+      <tr><td><code>--ggs-radius-lg</code></td><td>16 px</td><td>Hero-Cards, große Modale</td></tr>
+      <tr><td><code>--ggs-radius-pill</code></td><td>999 px</td><td>Pills, Avatar-Kreise</td></tr>
+      <tr><td><code>--ggs-shadow-sm</code></td><td><code>0 1px 3px rgba(0,0,0,.08)</code></td><td>Karten</td></tr>
+      <tr><td><code>--ggs-shadow-md</code></td><td><code>0 2px 8px rgba(0,0,0,.12)</code></td><td>Modale, schwebende Layers</td></tr>
+      <tr><td><code>--ggs-shadow-lg</code></td><td><code>0 4px 16px rgba(0,0,0,.16)</code></td><td>Tooltips, Spectator-Banner</td></tr>
+    </table>
+  </div>
+
+  <!-- ============================================================== -->
+  <div class="card" id="typo">
+    <div class="card-h">Typografie</div>
+    <table>
+      <tr><th>Token</th><th>Wert</th></tr>
+      <tr><td><code>--ggs-font</code></td><td><code>'Inter', system-ui, -apple-system, sans-serif</code></td></tr>
+      <tr><td><code>--ggs-font-mono</code></td><td><code>'JetBrains Mono', 'Fira Code', monospace</code></td></tr>
+    </table>
+
+    <h3>Größenrichtlinien</h3>
+    <ul>
+      <li><strong>0.62 rem</strong> — Card-Header (uppercase, letter-spacing .05em)</li>
+      <li><strong>0.7 rem</strong> — Hilfstexte, Subtitles</li>
+      <li><strong>0.78 rem</strong> — Body-Text in Karten</li>
+      <li><strong>0.85 rem</strong> — Modul-Namen, Tabs</li>
+      <li><strong>0.95 rem</strong> — H3 / Section-Titel</li>
+      <li><strong>1.15 rem</strong> — H2 / Page-Titel</li>
+    </ul>
+  </div>
+
+  <!-- ============================================================== -->
+  <div class="card" id="bilder">
+    <div class="card-h">Bildformate &amp; Pfade</div>
+    <table>
+      <tr><th>Typ</th><th>Maße</th><th>Pfad</th></tr>
+      <tr><td>Modul-Card-Image (Cockpit)</td><td>≈ 800 × 450 (16:9)</td><td><code>App/assets/img/sim-NN-&lt;slug&gt;.png</code></td></tr>
+      <tr><td>Glossar-Bild</td><td>1792 × 1024</td><td><code>App/assets/img/glossar/&lt;slug&gt;.png</code></td></tr>
+      <tr><td>Glossar-SVG (Schemata)</td><td>vektor</td><td><code>App/assets/img/glossar/&lt;slug&gt;-schema.svg</code></td></tr>
+      <tr><td>Splash (Sim-Intro)</td><td>1792 × 1024</td><td><code>App/sims/&lt;slug&gt;/assets/splash-*.png</code></td></tr>
+      <tr><td>Avatar (User)</td><td>1024 × 1024</td><td><code>App/assets/img/avatars/avatar-&lt;slug&gt;.png</code></td></tr>
+      <tr><td>Logo (SVG)</td><td>vektor</td><td><code>App/assets/img/geograsim_t.svg</code></td></tr>
+    </table>
+
+    <h3>Avatar-Slugs (30 Stück, 3 Gruppen)</h3>
+    <ul>
+      <li><strong>Geo-Welt:</strong> pilotin · pilot · kartografin · geologe · meteorologin · stadtplaner · forscherin · forscher · taucherin · astronaut</li>
+      <li><strong>Cool &amp; lustig:</strong> coole-girl · coole-boy · lustige-girl · lustige-boy · nerd-girl · sportlich-boy · kuenstlerin · musiker · gaertnerin · abenteurer</li>
+      <li><strong>Tier-Begleiter:</strong> fuchs-explorer · eule-prof · baer-foerster · pinguin-polar · affe-tropen · delfin-meer · adler-pilot · schildkroete-w · katze-stadt · biene-natur</li>
+    </ul>
+  </div>
+
+  <!-- ============================================================== -->
+  <div class="card" id="ipad">
+    <div class="card-h">iPad-Patterns (Hauptzielgerät: iPad Landscape 1180 × 820)</div>
+    <ul>
+      <li><strong>Touch-Ziele</strong> ≥ 36 px Höhe, idealerweise 44 px für primäre Aktionen</li>
+      <li><strong>Kein Hover-Kleber</strong> — alle Interaktionen müssen ohne Hover funktionieren</li>
+      <li><strong>Modale nutzen</strong> <code>height: 100dvh</code> + <code>safe-area-inset-bottom</code></li>
+      <li><strong>Sticky Aktions-Buttons</strong> unten im Modal — nicht außerhalb scrollen lassen</li>
+      <li><strong>Float-✕ oben rechts</strong> bei Modalen, damit „Schließen" immer erreichbar ist</li>
+      <li><strong>Layout breit statt hoch</strong> — Badges horizontal, 2-Spalten-Grids wo möglich</li>
+      <li><strong>viewport-fit=cover</strong> + <code>100dvh</code> für Vollbild-Sims</li>
+    </ul>
+  </div>
+
+  <!-- ============================================================== -->
+  <div class="card" id="sprache">
+    <div class="card-h">Sprache (Lernarbeit-Lexikon)</div>
+    <p>Niemals „spielen / Spiel / Spieler:in" verwenden. GeoGraSim ist Lernarbeit nach Wygotski, kein Spiel.</p>
+    <table>
+      <tr><th>Statt</th><th>Verwende</th></tr>
+      <tr><td>spielen</td><td>arbeiten mit · bearbeiten</td></tr>
+      <tr><td>Spiel</td><td>Simulation · Modul</td></tr>
+      <tr><td>Spieler:in</td><td>Bearbeiter:in · Schüler:in</td></tr>
+      <tr><td>Spielrunde</td><td>Durchgang</td></tr>
+      <tr><td>Game Over</td><td>Durchgang beendet</td></tr>
+    </table>
+    <p>Ausnahme: in Code-Variablen (<code>state.gameOver</code>, <code>player_progress</code>) ist „game/player" als technischer Begriff unkritisch — Hauptsache an der UI nicht sichtbar.</p>
+  </div>
+
+</div>
+
+<script>
+function copyText(text, el) {
+  navigator.clipboard.writeText(text).then(function() {
+    if (el) {
+      var orig = el.textContent;
+      el.textContent = '✓ kopiert';
+      el.classList.add('ok');
+      setTimeout(function() { el.textContent = orig; el.classList.remove('ok'); }, 1100);
+    }
+  });
+}
+// Copy-Buttons mit data-copy=ID
+document.querySelectorAll('.copy-btn[data-copy]').forEach(function(btn) {
+  btn.addEventListener('click', function() {
+    var src = document.getElementById(btn.getAttribute('data-copy'));
+    if (src) copyText(src.textContent, btn);
+  });
+});
+// Swatches mit data-copy-text
+document.querySelectorAll('.sw[data-copy-text]').forEach(function(sw) {
+  sw.addEventListener('click', function() {
+    var txt = sw.getAttribute('data-copy-text');
+    copyText(txt, null);
+    var meta = sw.querySelector('.sw-meta strong');
+    if (meta) {
+      var orig = meta.textContent;
+      meta.textContent = '✓ kopiert';
+      setTimeout(function() { meta.textContent = orig; }, 900);
+    }
+  });
+});
+
+// Auth-Check: nur eingeloggter Admin darf hier sein
+fetch('/api/admin', {
+  method:'POST', headers:{'Content-Type':'application/json'}, credentials:'same-origin',
+  body: JSON.stringify({action:'status'})
+}).then(function(r) { return r.json(); }).then(function(r) {
+  if (!r.authenticated) location.href = 'admin.html';
+}).catch(function() {});
+</script>
+<script src="assets/js/version-tag.js" defer></script>
+</body>
+</html>
@@ -0,0 +1,118 @@
+/**
+ * GeoGraSim Plattform: Live-Client
+ *
+ * Sendet Heartbeats an /api/live (Live-View für Lehrkräfte) und pollt das
+ * Pause-Flag aus /api/modules?student=1. Wird vom Sim-Wrapper als Plattform-
+ * Asset geladen — Sims selbst müssen nichts implementieren.
+ *
+ * Erwartet: window.__GGS__ = { sessionId, simId, baseUrl, basePath, apiUrl }.
+ *
+ * Sims können optional window.GGS_LIVE_STATE() zurückgeben, um einen kleinen
+ * State-Snapshot mitzusenden (max 50 KB). Ohne diese Funktion wird nur ein
+ * leerer State gemeldet — Lehrer sieht trotzdem WER online ist und WAS spielt.
+ */
+(function () {
+  'use strict';
+  if (window.__GGS_LIVE_INITIALIZED__) return;
+  window.__GGS_LIVE_INITIALIZED__ = true;
+
+  var ctx = window.__GGS__ || {};
+  // Ohne simId können wir nicht melden, welches Modul gespielt wird.
+  if (!ctx.simId) return;
+  // sessionId nicht vorab prüfen — der Browser sendet das ggs_session-Cookie
+  // automatisch mit den fetch-Calls (credentials:'same-origin'), und der
+  // Server entscheidet, ob es eine gültige Schüler-Session ist.
+  var apiBase = ctx.apiUrl || ((ctx.baseUrl || '') + '/php/api');
+  var simId   = ctx.simId;
+
+  // --- Heartbeat ---
+  var heartbeatTimer = null;
+  function snapshotState() {
+    try {
+      if (typeof window.GGS_LIVE_STATE === 'function') {
+        var s = window.GGS_LIVE_STATE();
+        if (s && typeof s === 'object') return s;
+      }
+    } catch (_) {}
+    return {};
+  }
+  function sendHeartbeat() {
+    fetch(apiBase + '/live.php', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      credentials: 'same-origin',
+      body: JSON.stringify({ action: 'heartbeat', module_id: simId, state: snapshotState() })
+    }).catch(function () {});
+  }
+
+  // --- Pause-Polling ---
+  var pauseTimer = null;
+  var pauseOverlay = null;
+  function ensureOverlay() {
+    if (pauseOverlay) return pauseOverlay;
+    var el = document.createElement('div');
+    el.id = 'ggs-pause-overlay';
+    el.style.cssText = 'position:fixed;inset:0;background:rgba(31,75,55,.78);color:#fff;z-index:99999;display:flex;flex-direction:column;align-items:center;justify-content:center;font-family:Inter,sans-serif;font-weight:700;text-align:center;padding:2rem;backdrop-filter:blur(3px)';
+    el.innerHTML = '<div style="font-size:4rem;margin-bottom:.6rem">⏸</div>'
+                 + '<div style="font-size:1.6rem;margin-bottom:.4rem">Auftrag pausiert</div>'
+                 + '<div style="font-size:.95rem;font-weight:500;opacity:.85;max-width:420px;line-height:1.4">Deine Lehrperson hat das Tempo angehalten. Sobald sie freigibt, kannst du weitermachen.</div>';
+    document.body.appendChild(el);
+    pauseOverlay = el;
+    return el;
+  }
+  function showPause() { ensureOverlay().style.display = 'flex'; }
+  function hidePause() { if (pauseOverlay) pauseOverlay.style.display = 'none'; }
+  function checkPause() {
+    fetch(apiBase + '/modules.php?student=1&module_id=' + encodeURIComponent(simId), {
+      credentials: 'same-origin'
+    }).then(function (r) { return r.json(); })
+      .then(function (m) {
+        if (m && m.paused && m.mode === 'teacher_started') showPause();
+        else hidePause();
+      })
+      .catch(function () {});
+  }
+
+  // --- Spectator-Mode für Lehrkräfte ---
+  // ?view=teacher schaltet Input ab und blendet ein dezentes Banner ein.
+  function isSpectator() {
+    try { return new URLSearchParams(location.search).get('view') === 'teacher'; }
+    catch (_) { return false; }
+  }
+  function applySpectator() {
+    if (!isSpectator()) return;
+    var s = document.createElement('style');
+    s.textContent = 'html,body{pointer-events:none!important}'
+                  + '#ggs-spectator-banner{pointer-events:auto!important;position:fixed;top:0;left:0;right:0;background:#4a7c8a;color:#fff;padding:.5rem;text-align:center;font-family:Inter,sans-serif;font-size:.78rem;font-weight:700;z-index:99998}'
+                  + '#ggs-spectator-banner button{pointer-events:auto;margin-left:.6rem;padding:.2rem .6rem;border:none;border-radius:5px;background:#fff;color:#4a7c8a;font-weight:700;cursor:pointer}';
+    document.head.appendChild(s);
+    var bar = document.createElement('div');
+    bar.id = 'ggs-spectator-banner';
+    bar.innerHTML = '👁 Live-Ansicht (Lehrkraft) — Eingaben sind deaktiviert. <button onclick="window.close()">Fenster schließen</button>';
+    document.body.appendChild(bar);
+  }
+
+  // --- Lifecycle ---
+  function start() {
+    if (isSpectator()) { applySpectator(); return; }   // Spectator nicht heartbeaten
+    sendHeartbeat();
+    heartbeatTimer = setInterval(sendHeartbeat, 4000);
+    checkPause();
+    pauseTimer = setInterval(checkPause, 5000);
+    // Bei Tab-Schließung sauberer „end"-Heartbeat (keepalive für unload)
+    window.addEventListener('beforeunload', function () {
+      try {
+        navigator.sendBeacon && navigator.sendBeacon(
+          apiBase + '/live.php',
+          new Blob([JSON.stringify({ action: 'end' })], { type: 'application/json' })
+        );
+      } catch (_) {}
+    });
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', start);
+  } else {
+    start();
+  }
+})();
@@ -0,0 +1,141 @@
+<?php
+/**
+ * Busfahrt — Wrapper
+ * Laedt sims/busfahrt/game.html und injiziert Base-Path + Session-Mode.
+ *
+ * Integrations-Vertrag §6.1: mode + forcedLevel + easy aus der
+ * Schueler-Session abgeleitet, an das Frontend uebergeben.
+ *
+ * Stand 2026-05-03: Modul ist 'geplant' — Phase 0 (Skelett) abgeschlossen.
+ * Phase 1 (Karte tippen + 3 Versuche + Info-Card) folgt durch die
+ * Busfahrt-Instanz.
+ */
+require_once __DIR__ . '/../php/config/app.php';
+require_once __DIR__ . '/../php/config/db.php';
+
+$db = getDB();
+
+// ---- Mode-Check (Integrations-Vertrag §6.1) ----
+$sessionId = $_COOKIE['ggs_session'] ?? null;
+$mode = 'free';
+$forcedLevel = null;
+$easy = false;
+
+if ($sessionId) {
+    $stmt = $db->prepare('SELECT class_id, display_name FROM student_sessions WHERE id = ?');
+    $stmt->execute([$sessionId]);
+    $sess = $stmt->fetch(PDO::FETCH_ASSOC);
+    if ($sess && !empty($sess['class_id'])) {
+        $classId = (int)$sess['class_id'];
+        $cm = $db->prepare('SELECT mode, current_level FROM class_modules WHERE class_id = ? AND module_id = ?');
+        $cm->execute([$classId, 'busfahrt']);
+        $cmRow = $cm->fetch(PDO::FETCH_ASSOC);
+        if ($cmRow) {
+            $mode = $cmRow['mode'];
+            if ($mode === 'teacher_started') $forcedLevel = (int)($cmRow['current_level'] ?? 1);
+        } else {
+            $mode = 'locked';
+        }
+        $so = $db->prepare(
+            'SELECT sm.mode FROM student_modules sm
+             JOIN students s ON s.id = sm.student_id
+             WHERE s.class_id = ? AND s.display_name = ? AND sm.module_id = ?'
+        );
+        $so->execute([$classId, $sess['display_name'], 'busfahrt']);
+        $soRow = $so->fetch(PDO::FETCH_ASSOC);
+        if ($soRow) $mode = $soRow['mode'];
+        $eq = $db->prepare(
+            'SELECT easy_language FROM students WHERE class_id = ? AND display_name = ?'
+        );
+        $eq->execute([$classId, $sess['display_name']]);
+        $eqRow = $eq->fetch(PDO::FETCH_ASSOC);
+        if ($eqRow) $easy = !empty($eqRow['easy_language']);
+    }
+}
+
+// Locked-Seite
+if ($mode === 'locked') {
+    http_response_code(403);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>Gesperrt · Busfahrt</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#404040}.lock-card{background:#f5f3ea;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="lock-card">
+<h1>🔒 Busfahrt ist gesperrt.</h1>
+<p>Deine Lehrkraft hat dieses Modul für eure Klasse noch nicht freigegeben.</p>
+<p>Im <a href="{$cockpit}">Cockpit</a> findest du die derzeit freigegebenen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+// ---- Sim-Datei laden (Fallback solange noch leer) ----
+$gamePath = __DIR__ . '/../sims/busfahrt/game.html';
+if (!is_file($gamePath)) {
+    http_response_code(503);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>In Vorbereitung · Busfahrt</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#404040}.wip-card{background:#f5f3ea;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="wip-card">
+<h1>🚌 Busfahrt wird gerade gebaut.</h1>
+<p>Diese Simulation ist in Vorbereitung. Schau im <a href="{$cockpit}">Cockpit</a>
+in die anderen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+$html = file_get_contents($gamePath);
+
+$modeJs        = json_encode($mode);
+$forcedLevelJs = json_encode($forcedLevel);
+$easyJs        = $easy ? 'true' : 'false';
+$sessionIdJs   = json_encode($sessionId);
+
+$base = BASE_PATH . '/sims/busfahrt/';
+$injection =
+    "window.BUSFAHRT_BASE = '$base';\n" .
+    "window.BUSFAHRT_SESSION_MODE = {$modeJs};\n" .
+    "window.BUSFAHRT_FORCED_LEVEL = {$forcedLevelJs};\n" .
+    "window.BUSFAHRT_SESSION_ID = {$sessionIdJs};\n" .
+    "window.STUDENT_EASY = {$easyJs};\n" .
+    "window.BUSFAHRT_API_BASE = '" . BASE_PATH . "/api';\n" .
+    "window.BUSFAHRT_TILE_PROXY = '" . BASE_PATH . "/php/tile-proxy.php';";
+
+if (strpos($html, '/*__BUSFAHRT_INJECTION__*/') !== false) {
+    $html = str_replace('/*__BUSFAHRT_INJECTION__*/', $injection, $html);
+} else {
+    $html = str_replace('</head>', "<script>$injection</script>\n</head>", $html);
+}
+
+// Asset-Pfade auf BASE_PATH umbiegen
+$baseSim = BASE_PATH . '/sims/busfahrt/';
+$html = preg_replace(
+    "/(['\"])assets\/(img|data|js|css)\//",
+    "$1{$baseSim}assets/$2/",
+    $html
+);
+
+// Engine.js relativ → absolut
+$html = str_replace('src="engine.js"', 'src="' . $baseSim . 'engine.js"', $html);
+
+// Cockpit-Link absolut
+$html = str_replace('href="/schueler"', 'href="' . cockpit_href() . '"', $html);
+
+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'busfahrt');
+echo $html;
@@ -0,0 +1,119 @@
+<?php
+/**
+ * Energiemanager — Wrapper
+ * Laedt sims/energiemanager/game.html und biegt Asset-Pfade auf BASE_PATH um.
+ *
+ * Integrations-Vertrag §6.1: mode + forcedLevel + easy aus der
+ * Schueler-Session abgeleitet, an das Frontend uebergeben.
+ */
+require_once __DIR__ . '/../php/config/app.php';
+require_once __DIR__ . '/../php/config/db.php';
+
+$db = getDB();
+$MODULE_ID = 'energiemanager';
+
+// ---- Mode-Check (Integrations-Vertrag §6.1) ----
+$sessionId = $_COOKIE['ggs_session'] ?? null;
+$mode = 'free';
+$forcedLevel = null;
+$easy = false;
+
+if ($sessionId) {
+    $stmt = $db->prepare('SELECT class_id, display_name FROM student_sessions WHERE id = ?');
+    $stmt->execute([$sessionId]);
+    $sess = $stmt->fetch(PDO::FETCH_ASSOC);
+    if ($sess && !empty($sess['class_id'])) {
+        $classId = (int)$sess['class_id'];
+        $cm = $db->prepare('SELECT mode, current_level FROM class_modules WHERE class_id = ? AND module_id = ?');
+        $cm->execute([$classId, $MODULE_ID]);
+        $cmRow = $cm->fetch(PDO::FETCH_ASSOC);
+        if ($cmRow) {
+            $mode = $cmRow['mode'];
+            if ($mode === 'teacher_started') $forcedLevel = (int)($cmRow['current_level'] ?? 1);
+        } else {
+            $mode = 'locked';
+        }
+        $so = $db->prepare(
+            'SELECT sm.mode FROM student_modules sm
+             JOIN students s ON s.id = sm.student_id
+             WHERE s.class_id = ? AND s.display_name = ? AND sm.module_id = ?'
+        );
+        $so->execute([$classId, $sess['display_name'], $MODULE_ID]);
+        $soRow = $so->fetch(PDO::FETCH_ASSOC);
+        if ($soRow) $mode = $soRow['mode'];
+        $eq = $db->prepare(
+            'SELECT easy_language FROM students WHERE class_id = ? AND display_name = ?'
+        );
+        $eq->execute([$classId, $sess['display_name']]);
+        $eqRow = $eq->fetch(PDO::FETCH_ASSOC);
+        if ($eqRow) $easy = !empty($eqRow['easy_language']);
+    }
+}
+
+// Locked-Seite
+if ($mode === 'locked') {
+    http_response_code(403);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>Gesperrt · Energiemanager</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#1f4b37}.lock-card{background:#f4f1e8;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="lock-card">
+<h1>🔒 Energiemanager ist gesperrt.</h1>
+<p>Deine Lehrkraft hat dieses Modul für eure Klasse noch nicht freigegeben.</p>
+<p>Im <a href="{$cockpit}">Cockpit</a> findest du die derzeit freigegebenen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+$gamePath = __DIR__ . '/../sims/energiemanager/game.html';
+if (!is_file($gamePath)) {
+    http_response_code(503);
+    echo '<h1>Energiemanager wird gerade gebaut.</h1>';
+    exit;
+}
+
+$html = file_get_contents($gamePath);
+
+$modeJs        = json_encode($mode);
+$forcedLevelJs = json_encode($forcedLevel);
+$easyJs        = $easy ? 'true' : 'false';
+$sessionIdJs   = json_encode($sessionId);
+
+$base = BASE_PATH . '/sims/energiemanager/';
+$injection =
+    "window.EM_BASE = '$base';\n" .
+    "window.EM_SESSION_MODE = {$modeJs};\n" .
+    "window.EM_FORCED_LEVEL = {$forcedLevelJs};\n" .
+    "window.EM_SESSION_ID = {$sessionIdJs};\n" .
+    "window.STUDENT_EASY = {$easyJs};\n" .
+    "window.EM_API_BASE = '" . BASE_PATH . "/api';";
+
+$html = str_replace('</head>', "<script>$injection</script>\n</head>", $html);
+
+// Asset-Pfade umbiegen: das game.html nutzt relative Pfade (../../assets/...,
+// ../../favicon..., ../../sim, ../../). Vom Wrapper-URL aus aufgelöst landen
+// die im falschen Verzeichnis. Wir biegen alle ../../-Refs auf BASE_PATH um.
+$rewrites = [
+    'href="../../"'                 => 'href="' . cockpit_href() . '"',
+    'href="../../sim"'              => 'href="' . cockpit_href() . '"',
+    'href="../../schueler"'         => 'href="' . cockpit_href() . '"',
+    'href="/schueler"'              => 'href="' . cockpit_href() . '"',
+    '"../../assets/'                => '"' . BASE_PATH . '/assets/',
+    "'../../assets/"                => "'" . BASE_PATH . "/assets/",
+    '"../../favicon'                => '"' . BASE_PATH . '/favicon',
+    "'../../favicon"                => "'" . BASE_PATH . "/favicon",
+];
+foreach ($rewrites as $from => $to) {
+    $html = str_replace($from, $to, $html);
+}
+
+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'energiemanager');
+echo $html;
@@ -0,0 +1,105 @@
+<?php
+/**
+ * EU-Werkstatt — Wrapper
+ * Laedt sims/eu-werkstatt/game.html und injiziert Base-Path + Session-Mode.
+ *
+ * Integrations-Vertrag §6.1: mode + forcedLevel + easy aus der
+ * Schueler-Session abgeleitet, an das Frontend uebergeben.
+ */
+require_once __DIR__ . '/../php/config/app.php';
+require_once __DIR__ . '/../php/config/db.php';
+
+$db = getDB();
+$MODULE_ID = 'eu-werkstatt';
+
+// ---- Mode-Check (Integrations-Vertrag §6.1) ----
+$sessionId = $_COOKIE['ggs_session'] ?? null;
+$mode = 'free';
+$forcedLevel = null;
+$easy = false;
+
+if ($sessionId) {
+    $stmt = $db->prepare('SELECT class_id, display_name FROM student_sessions WHERE id = ?');
+    $stmt->execute([$sessionId]);
+    $sess = $stmt->fetch(PDO::FETCH_ASSOC);
+    if ($sess && !empty($sess['class_id'])) {
+        $classId = (int)$sess['class_id'];
+        $cm = $db->prepare('SELECT mode, current_level FROM class_modules WHERE class_id = ? AND module_id = ?');
+        $cm->execute([$classId, $MODULE_ID]);
+        $cmRow = $cm->fetch(PDO::FETCH_ASSOC);
+        if ($cmRow) {
+            $mode = $cmRow['mode'];
+            if ($mode === 'teacher_started') $forcedLevel = (int)($cmRow['current_level'] ?? 1);
+        } else {
+            $mode = 'locked';
+        }
+        $so = $db->prepare(
+            'SELECT sm.mode FROM student_modules sm
+             JOIN students s ON s.id = sm.student_id
+             WHERE s.class_id = ? AND s.display_name = ? AND sm.module_id = ?'
+        );
+        $so->execute([$classId, $sess['display_name'], $MODULE_ID]);
+        $soRow = $so->fetch(PDO::FETCH_ASSOC);
+        if ($soRow) $mode = $soRow['mode'];
+        $eq = $db->prepare(
+            'SELECT easy_language FROM students WHERE class_id = ? AND display_name = ?'
+        );
+        $eq->execute([$classId, $sess['display_name']]);
+        $eqRow = $eq->fetch(PDO::FETCH_ASSOC);
+        if ($eqRow) $easy = !empty($eqRow['easy_language']);
+    }
+}
+
+// Locked-Seite
+if ($mode === 'locked') {
+    http_response_code(403);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>Gesperrt · EU-Werkstatt</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#1f4b37}.lock-card{background:#f4f1e8;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="lock-card">
+<h1>🔒 EU-Werkstatt ist gesperrt.</h1>
+<p>Deine Lehrkraft hat dieses Modul für eure Klasse noch nicht freigegeben.</p>
+<p>Im <a href="{$cockpit}">Cockpit</a> findest du die derzeit freigegebenen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+$gamePath = __DIR__ . '/../sims/eu-werkstatt/game.html';
+if (!is_file($gamePath)) {
+    http_response_code(503);
+    echo '<h1>EU-Werkstatt wird gerade gebaut.</h1>';
+    exit;
+}
+
+$html = file_get_contents($gamePath);
+
+$modeJs        = json_encode($mode);
+$forcedLevelJs = json_encode($forcedLevel);
+$easyJs        = $easy ? 'true' : 'false';
+$sessionIdJs   = json_encode($sessionId);
+
+$base = BASE_PATH . '/sims/eu-werkstatt/';
+$injection =
+    "window.EUW_BASE = '$base';\n" .
+    "window.EUW_SESSION_MODE = {$modeJs};\n" .
+    "window.EUW_FORCED_LEVEL = {$forcedLevelJs};\n" .
+    "window.EUW_SESSION_ID = {$sessionIdJs};\n" .
+    "window.STUDENT_EASY = {$easyJs};\n" .
+    "window.EUW_API_BASE = '" . BASE_PATH . "/api';";
+
+$html = str_replace('</head>', "<script>$injection</script>\n</head>", $html);
+
+// Cockpit-Link in der Topbar setzen
+$html = str_replace('id="backToCockpit" href="#"', 'id="backToCockpit" href="' . cockpit_href() . '"', $html);
+
+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'eu-werkstatt');
+echo $html;
@@ -0,0 +1,140 @@
+<?php
+/**
+ * Farmer / Landwirtschaft — Wrapper
+ * Laedt sims/farmer/game.html und injiziert Base-Path + Session-Mode.
+ *
+ * Integrations-Vertrag §6.1: mode + forcedLevel + easy aus der
+ * Schueler-Session abgeleitet, an das Frontend uebergeben.
+ *
+ * Stand 2026-05-03: Modul ist 'geplant' — Phase 0 (Skelett) abgeschlossen.
+ * Phase 1 (Welt-Karte + Köppen-Layer + 3 Pflanzen + Reveal-Logik) folgt.
+ */
+require_once __DIR__ . '/../php/config/app.php';
+require_once __DIR__ . '/../php/config/db.php';
+
+$db = getDB();
+
+// ---- Mode-Check (Integrations-Vertrag §6.1) ----
+$sessionId = $_COOKIE['ggs_session'] ?? null;
+$mode = 'free';
+$forcedLevel = null;
+$easy = false;
+
+if ($sessionId) {
+    $stmt = $db->prepare('SELECT class_id, display_name FROM student_sessions WHERE id = ?');
+    $stmt->execute([$sessionId]);
+    $sess = $stmt->fetch(PDO::FETCH_ASSOC);
+    if ($sess && !empty($sess['class_id'])) {
+        $classId = (int)$sess['class_id'];
+        $cm = $db->prepare('SELECT mode, current_level FROM class_modules WHERE class_id = ? AND module_id = ?');
+        $cm->execute([$classId, 'farmer']);
+        $cmRow = $cm->fetch(PDO::FETCH_ASSOC);
+        if ($cmRow) {
+            $mode = $cmRow['mode'];
+            if ($mode === 'teacher_started') $forcedLevel = (int)($cmRow['current_level'] ?? 1);
+        } else {
+            $mode = 'locked';
+        }
+        $so = $db->prepare(
+            'SELECT sm.mode FROM student_modules sm
+             JOIN students s ON s.id = sm.student_id
+             WHERE s.class_id = ? AND s.display_name = ? AND sm.module_id = ?'
+        );
+        $so->execute([$classId, $sess['display_name'], 'farmer']);
+        $soRow = $so->fetch(PDO::FETCH_ASSOC);
+        if ($soRow) $mode = $soRow['mode'];
+        $eq = $db->prepare(
+            'SELECT easy_language FROM students WHERE class_id = ? AND display_name = ?'
+        );
+        $eq->execute([$classId, $sess['display_name']]);
+        $eqRow = $eq->fetch(PDO::FETCH_ASSOC);
+        if ($eqRow) $easy = !empty($eqRow['easy_language']);
+    }
+}
+
+// Locked-Seite
+if ($mode === 'locked') {
+    http_response_code(403);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>Gesperrt · Landwirtschaft</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#8b5a2b}.lock-card{background:#f5f3ea;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="lock-card">
+<h1>🔒 Landwirtschaft ist gesperrt.</h1>
+<p>Deine Lehrkraft hat dieses Modul für eure Klasse noch nicht freigegeben.</p>
+<p>Im <a href="{$cockpit}">Cockpit</a> findest du die derzeit freigegebenen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+// ---- Sim-Datei laden (Fallback solange noch leer) ----
+$gamePath = __DIR__ . '/../sims/farmer/game.html';
+if (!is_file($gamePath)) {
+    http_response_code(503);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>In Vorbereitung · Landwirtschaft</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#8b5a2b}.wip-card{background:#f5f3ea;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="wip-card">
+<h1>🌾 Landwirtschaft wird gerade gebaut.</h1>
+<p>Diese Simulation ist in Vorbereitung. Schau im <a href="{$cockpit}">Cockpit</a>
+in die anderen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+$html = file_get_contents($gamePath);
+
+$modeJs        = json_encode($mode);
+$forcedLevelJs = json_encode($forcedLevel);
+$easyJs        = $easy ? 'true' : 'false';
+$sessionIdJs   = json_encode($sessionId);
+
+$base = BASE_PATH . '/sims/farmer/';
+$injection =
+    "window.FARMER_BASE = '$base';\n" .
+    "window.FARMER_SESSION_MODE = {$modeJs};\n" .
+    "window.FARMER_FORCED_LEVEL = {$forcedLevelJs};\n" .
+    "window.FARMER_SESSION_ID = {$sessionIdJs};\n" .
+    "window.STUDENT_EASY = {$easyJs};\n" .
+    "window.FARMER_API_BASE = '" . BASE_PATH . "/api';\n" .
+    "window.FARMER_TILE_PROXY = '" . BASE_PATH . "/php/tile-proxy.php';";
+
+if (strpos($html, '/*__FARMER_INJECTION__*/') !== false) {
+    $html = str_replace('/*__FARMER_INJECTION__*/', $injection, $html);
+} else {
+    $html = str_replace('</head>', "<script>$injection</script>\n</head>", $html);
+}
+
+// Asset-Pfade auf BASE_PATH umbiegen
+$baseSim = BASE_PATH . '/sims/farmer/';
+$html = preg_replace(
+    "/(['\"])assets\/(img|data|js|css)\//",
+    "$1{$baseSim}assets/$2/",
+    $html
+);
+
+// Engine.js relativ → absolut
+$html = str_replace('src="engine.js"', 'src="' . $baseSim . 'engine.js"', $html);
+
+// Cockpit-Link absolut
+$html = str_replace('href="/schueler"', 'href="' . cockpit_href() . '"', $html);
+
+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'farmer');
+echo $html;
@@ -113,6 +113,8 @@ if ($html === false) {
 $bp      = BASE_PATH;
 $baseTag = '<base href="' . htmlspecialchars($bp . '/sims/fluss/', ENT_QUOTES) . '">';
 $ctxJs   = '<script>window.__GGS__ = ' . json_encode($ctx, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . ';</script>';
+// Plattform-Live-Client: Heartbeat + Pause-Overlay + Spectator-Mode für ?view=teacher
+$liveJs  = '<script src="' . htmlspecialchars($bp . '/assets/js/live-client.js', ENT_QUOTES) . '" defer></script>';

 // <base>-Tag direkt nach <head>, damit relative Pfade aus /sims/fluss/ aufloesen
 $html = preg_replace('/<head>/i', '<head>' . "\n" . $baseTag, $html, 1);
@@ -122,7 +124,8 @@ $html = preg_replace('/<head>/i', '<head>' . "\n" . $baseTag, $html, 1);
 // das </script> darin wuerde den umgebenden Script-Block vorzeitig schliessen.
 $pos = strrpos($html, '</body>');
 if ($pos !== false) {
-    $html = substr($html, 0, $pos) . $ctxJs . "\n" . substr($html, $pos);
+    $html = substr($html, 0, $pos) . $ctxJs . "\n" . $liveJs . "\n" . substr($html, $pos);
 }
+$html = str_replace('href="/schueler"', 'href="' . cockpit_href() . '"', $html);

 echo $html;
@@ -58,7 +58,7 @@ if ($mode === 'locked') {
    http_response_code(403);
    header('Content-Type: text/html; charset=utf-8');
    $cssHref = BASE_PATH . '/assets/css/design-system.css';
-    $cockpit = BASE_PATH . '/sim';
+    $cockpit = BASE_PATH . '/schueler';
    echo <<<HTML
 <!DOCTYPE html><html lang="de"><head>
 <meta charset="utf-8"><title>Gesperrt · Heli-Navigation</title>
@@ -143,5 +143,7 @@ $html = strtr($html, [
    'https://unpkg.com/leaflet@1.9.4/dist/leaflet.js'  => $leafletJs,
    "'https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png'" => "'{$tileProxy}?z={z}&x={x}&y={y}&p=osm'",
 ]);
+$html = str_replace('href="/schueler"', 'href="' . cockpit_href() . '"', $html);

+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'heli');
 echo $html;
@@ -21,6 +21,7 @@ $classId    = null;
 $simName = 'Klimawächter 2D';
 $simIcon = '🌍';

+$skipResume = false;
 try {
    $db = Database::get();
    if ($sessionId) {
@@ -31,6 +32,23 @@ try {
        if ($row) {
            $studentName = $row['display_name'] ?: 'Schüler*in';
            $classId     = (int)$row['class_id'];
+            // Aktiver, noch nicht erledigter Lehrer-Auftrag? Dann frisch starten,
+            // damit der Schüler nicht aus alter Free-Play-Session resumed.
+            if ($classId) {
+                $cm = $db->fetchOne(
+                    'SELECT mode, started_at, current_level FROM class_modules WHERE class_id = ? AND module_id = ?',
+                    [$classId, 'klima']
+                );
+                if ($cm && $cm['mode'] === 'teacher_started' && $cm['started_at']) {
+                    $done = $db->fetchOne(
+                        'SELECT 1 FROM assessments WHERE session_id = ? AND sim_id = ? AND submitted_at > ? LIMIT 1',
+                        [$sessionId, 'klima', $cm['started_at']]
+                    );
+                    if (!$done) $skipResume = true;
+                    $level = (int)($cm['current_level'] ?? $level);
+                    if ($level < 1 || $level > 3) $level = 1;
+                }
+            }
        }
    }
    // Modul-Info aus DB (Atlas-verwaltet). Defaults greifen, wenn Tabelle
@@ -91,6 +109,7 @@ $ctx = [
    'simIcon'     => $simIcon,
    'level'       => $level,
    'levelConfig' => $levelConfigs[$level],
+    'skipResume'  => $skipResume,
    'baseUrl'     => BASE_URL,
    'basePath'    => BASE_PATH,
    'apiUrl'      => BASE_URL . '/php/api',
@@ -106,10 +125,13 @@ if ($html === false) {
 $bp = BASE_PATH;
 $baseTag = '<base href="' . htmlspecialchars($bp . '/sims/klima/', ENT_QUOTES) . '">';
 $ctxJs   = '<script>window.__GGS__ = ' . json_encode($ctx, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . ';</script>';
+// Plattform-Live-Client: Heartbeat + Pause-Overlay + Spectator-Mode für ?view=teacher
+$liveJs  = '<script src="' . htmlspecialchars($bp . '/assets/js/live-client.js', ENT_QUOTES) . '" defer></script>';

 // <base>-Tag direkt nach <head> einfügen, damit relative Pfade aus /sims/klima/ heraus auflösen
 $html = preg_replace('/<head>/i', '<head>' . "\n" . $baseTag, $html, 1);
-// Session-Kontext vor </body>
-$html = str_replace('</body>', $ctxJs . "\n</body>", $html);
+// Session-Kontext + Live-Client vor </body>
+$html = str_replace('</body>', $ctxJs . "\n" . $liveJs . "\n</body>", $html);
+$html = str_replace('href="/schueler"', 'href="' . cockpit_href() . '"', $html);

 echo $html;
@@ -62,7 +62,7 @@ if ($mode === 'locked') {
    http_response_code(403);
    header('Content-Type: text/html; charset=utf-8');
    $cssHref = BASE_PATH . '/assets/css/design-system.css';
-    $cockpit = BASE_PATH . '/sim';
+    $cockpit = BASE_PATH . '/schueler';
    echo <<<HTML
 <!DOCTYPE html><html lang="de"><head>
 <meta charset="utf-8"><title>Gesperrt · Logistik Europa</title>
@@ -143,14 +143,18 @@ $html = strtr($html, [
    'href="../../favicon-96x96.png"'            => 'href="' . BASE_PATH . '/favicon-96x96.png"',
    'src="../../assets/img/bildLogo.png"'       => 'src="' . BASE_PATH . '/assets/img/bildLogo.png"',
    'src="../../assets/img/textlogo_geograsim.svg"' => 'src="' . BASE_PATH . '/assets/img/textlogo_geograsim.svg"',
-    'href="../../sim"'                          => 'href="' . BASE_PATH . '/sim"',
+    'href="../../schueler"'                       => 'href="' . cockpit_href() . '"',
    'href="../../"'                             => 'href="' . BASE_PATH . '/"',
    'src="engine.js"'                           => 'src="' . $base . 'engine.js"',
    'src="headless-runner.js"'                  => 'src="' . $base . 'headless-runner.js"',
+    'src="assets/vendor/three/three.min.js"'    => 'src="' . $base . 'assets/vendor/three/three.min.js"',
+    'src="assets/vendor/autobahn-game/autobahn-game.js"' => 'src="' . $base . 'assets/vendor/autobahn-game/autobahn-game.js"',
    // Leaflet lokal + Tile-Proxy (DSGVO-sicher)
    'https://unpkg.com/leaflet@1.9.4/dist/leaflet.css' => BASE_PATH . '/assets/vendor/leaflet/leaflet.css',
    'https://unpkg.com/leaflet@1.9.4/dist/leaflet.js'  => BASE_PATH . '/assets/vendor/leaflet/leaflet.js',
    "'https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png'" => "'{$tileProxy}?z={z}&x={x}&y={y}&p=osm-de'",
 ]);
+$html = str_replace('href="/schueler"', 'href="' . cockpit_href() . '"', $html);

+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'logistik');
 echo $html;
@@ -0,0 +1,139 @@
+<?php
+/**
+ * Sonnensystem — Wrapper
+ * Laedt sims/sonnensystem/game.html und injiziert Base-Path + Session-Mode.
+ *
+ * Integrations-Vertrag §6.1: mode + forcedLevel + easy aus der
+ * Schueler-Session abgeleitet, an das Frontend uebergeben.
+ *
+ * Stand 2026-05-03: Modul ist 'beta' (Phase 1 — Plattform-Integration aktiv).
+ * Beobachtungs-Modus folgt in Phase 2.
+ */
+require_once __DIR__ . '/../php/config/app.php';
+require_once __DIR__ . '/../php/config/db.php';
+
+$db = getDB();
+
+// ---- Mode-Check (Integrations-Vertrag §6.1) ----
+$sessionId = $_COOKIE['ggs_session'] ?? null;
+$mode = 'free';
+$forcedLevel = null;
+$easy = false;
+
+if ($sessionId) {
+    $stmt = $db->prepare('SELECT class_id, display_name FROM student_sessions WHERE id = ?');
+    $stmt->execute([$sessionId]);
+    $sess = $stmt->fetch(PDO::FETCH_ASSOC);
+    if ($sess && !empty($sess['class_id'])) {
+        $classId = (int)$sess['class_id'];
+        $cm = $db->prepare('SELECT mode, current_level FROM class_modules WHERE class_id = ? AND module_id = ?');
+        $cm->execute([$classId, 'sonnensystem']);
+        $cmRow = $cm->fetch(PDO::FETCH_ASSOC);
+        if ($cmRow) {
+            $mode = $cmRow['mode'];
+            if ($mode === 'teacher_started') $forcedLevel = (int)($cmRow['current_level'] ?? 1);
+        } else {
+            $mode = 'locked';
+        }
+        $so = $db->prepare(
+            'SELECT sm.mode FROM student_modules sm
+             JOIN students s ON s.id = sm.student_id
+             WHERE s.class_id = ? AND s.display_name = ? AND sm.module_id = ?'
+        );
+        $so->execute([$classId, $sess['display_name'], 'sonnensystem']);
+        $soRow = $so->fetch(PDO::FETCH_ASSOC);
+        if ($soRow) $mode = $soRow['mode'];
+        $eq = $db->prepare(
+            'SELECT easy_language FROM students WHERE class_id = ? AND display_name = ?'
+        );
+        $eq->execute([$classId, $sess['display_name']]);
+        $eqRow = $eq->fetch(PDO::FETCH_ASSOC);
+        if ($eqRow) $easy = !empty($eqRow['easy_language']);
+    }
+}
+
+// Locked-Seite
+if ($mode === 'locked') {
+    http_response_code(403);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>Gesperrt · Sonnensystem</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#3d2c8d}.lock-card{background:#f5f3ea;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="lock-card">
+<h1>🔒 Sonnensystem ist gesperrt.</h1>
+<p>Deine Lehrkraft hat dieses Modul für eure Klasse noch nicht freigegeben.</p>
+<p>Im <a href="{$cockpit}">Cockpit</a> findest du die derzeit freigegebenen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+// ---- Sim-Datei laden ----
+$gamePath = __DIR__ . '/../sims/sonnensystem/game.html';
+if (!is_file($gamePath)) {
+    http_response_code(503);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>In Vorbereitung · Sonnensystem</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#3d2c8d}.wip-card{background:#f5f3ea;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="wip-card">
+<h1>🪐 Sonnensystem wird gerade gebaut.</h1>
+<p>Diese Simulation ist in Vorbereitung. Schau im <a href="{$cockpit}">Cockpit</a>
+in die anderen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+$html = file_get_contents($gamePath);
+
+$modeJs        = json_encode($mode);
+$forcedLevelJs = json_encode($forcedLevel);
+$easyJs        = $easy ? 'true' : 'false';
+$sessionIdJs   = json_encode($sessionId);
+
+$base = BASE_PATH . '/sims/sonnensystem/';
+$injection =
+    "window.SONNENSYSTEM_BASE = '$base';\n" .
+    "window.SONNENSYSTEM_SESSION_MODE = {$modeJs};\n" .
+    "window.SONNENSYSTEM_FORCED_LEVEL = {$forcedLevelJs};\n" .
+    "window.SONNENSYSTEM_SESSION_ID = {$sessionIdJs};\n" .
+    "window.STUDENT_EASY = {$easyJs};\n" .
+    "window.SONNENSYSTEM_API_BASE = '" . BASE_PATH . "/api';";
+
+// Injection wird via Marker eingesetzt (falls in Sim verlangt) — sonst hängen wir
+// die globalen Variablen direkt vor das schließende </head>.
+if (strpos($html, '/*__SONNENSYSTEM_INJECTION__*/') !== false) {
+    $html = str_replace('/*__SONNENSYSTEM_INJECTION__*/', $injection, $html);
+} else {
+    $html = str_replace('</head>', "<script>$injection</script>\n</head>", $html);
+}
+
+// Asset-Pfade auf BASE_PATH umbiegen (Sim liegt unter sims/sonnensystem/, vom
+// Wrapper aus serviert werden Asset-Pfade ohne Praefix sonst falsch aufgeloest).
+$baseSim = BASE_PATH . '/sims/sonnensystem/';
+$html = preg_replace(
+    "/(['\"])assets\/img\//",
+    "$1{$baseSim}assets/img/",
+    $html
+);
+
+// Cockpit-Link absolut machen
+$html = str_replace('href="/schueler"', 'href="' . cockpit_href() . '"', $html);
+
+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'sonnensystem');
+echo $html;
@@ -0,0 +1,128 @@
+<?php
+/**
+ * Staustufen — Wrapper
+ * Laedt sims/staustufen/game.html und injiziert Base-Path + Session-Mode.
+ *
+ * Integrations-Vertrag §6.1: mode + forcedLevel + easy aus der
+ * Schueler-Session abgeleitet, an das Frontend uebergeben.
+ *
+ * Stand 2026-04-26: Modul ist 'geplant'. Sobald die Staustufen-Instanz
+ * App/sims/staustufen/game.html angelegt hat, wird die Sim ausgeliefert.
+ */
+require_once __DIR__ . '/../php/config/app.php';
+require_once __DIR__ . '/../php/config/db.php';
+
+$db = getDB();
+
+// ---- Mode-Check (Integrations-Vertrag §6.1) ----
+$sessionId = $_COOKIE['ggs_session'] ?? null;
+$mode = 'free';
+$forcedLevel = null;
+$easy = false;
+
+if ($sessionId) {
+    $stmt = $db->prepare('SELECT class_id, display_name FROM student_sessions WHERE id = ?');
+    $stmt->execute([$sessionId]);
+    $sess = $stmt->fetch(PDO::FETCH_ASSOC);
+    if ($sess && !empty($sess['class_id'])) {
+        $classId = (int)$sess['class_id'];
+        $cm = $db->prepare('SELECT mode, current_level FROM class_modules WHERE class_id = ? AND module_id = ?');
+        $cm->execute([$classId, 'staustufen']);
+        $cmRow = $cm->fetch(PDO::FETCH_ASSOC);
+        if ($cmRow) {
+            $mode = $cmRow['mode'];
+            if ($mode === 'teacher_started') $forcedLevel = (int)($cmRow['current_level'] ?? 1);
+        } else {
+            $mode = 'locked';
+        }
+        $so = $db->prepare(
+            'SELECT sm.mode FROM student_modules sm
+             JOIN students s ON s.id = sm.student_id
+             WHERE s.class_id = ? AND s.display_name = ? AND sm.module_id = ?'
+        );
+        $so->execute([$classId, $sess['display_name'], 'staustufen']);
+        $soRow = $so->fetch(PDO::FETCH_ASSOC);
+        if ($soRow) $mode = $soRow['mode'];
+        $eq = $db->prepare(
+            'SELECT easy_language FROM students WHERE class_id = ? AND display_name = ?'
+        );
+        $eq->execute([$classId, $sess['display_name']]);
+        $eqRow = $eq->fetch(PDO::FETCH_ASSOC);
+        if ($eqRow) $easy = !empty($eqRow['easy_language']);
+    }
+}
+
+// Locked-Seite
+if ($mode === 'locked') {
+    http_response_code(403);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>Gesperrt · Staustufen</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#1f4b37}.lock-card{background:#f5f3ea;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="lock-card">
+<h1>🔒 Staustufen ist gesperrt.</h1>
+<p>Deine Lehrkraft hat dieses Modul für eure Klasse noch nicht freigegeben.</p>
+<p>Im <a href="{$cockpit}">Cockpit</a> findest du die derzeit freigegebenen Module.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+// ---- Sim-Datei laden (Fallback solange noch leer) ----
+$gamePath = __DIR__ . '/../sims/staustufen/game.html';
+if (!is_file($gamePath)) {
+    http_response_code(503);
+    header('Content-Type: text/html; charset=utf-8');
+    $cssHref = BASE_PATH . '/assets/css/design-system.css';
+    $cockpit = BASE_PATH . '/schueler';
+    echo <<<HTML
+<!DOCTYPE html><html lang="de"><head>
+<meta charset="utf-8"><title>In Vorbereitung · Staustufen</title>
+<link rel="stylesheet" href="{$cssHref}">
+<style>body{font-family:system-ui,sans-serif;padding:40px;max-width:640px;margin:auto;color:#333}
+h1{color:#1f4b37}.wip-card{background:#f5f3ea;border:1px solid #e2ddd1;padding:24px;border-radius:8px}</style>
+</head><body>
+<div class="wip-card">
+<h1>🏞️ Staustufen wird gerade gebaut.</h1>
+<p>Diese Simulation ist in Vorbereitung. Schau im <a href="{$cockpit}">Cockpit</a>
+in die anderen Module, oder öffne die Detailseite
+<a href="{$cockpit}">modul-staustufen</a> für Lernziele und Lehrplan-Bezug.</p>
+</div>
+</body></html>
+HTML;
+    exit;
+}
+
+$html = file_get_contents($gamePath);
+
+$modeJs        = json_encode($mode);
+$forcedLevelJs = json_encode($forcedLevel);
+$easyJs        = $easy ? 'true' : 'false';
+$sessionIdJs   = json_encode($sessionId);
+
+$base = BASE_PATH . '/sims/staustufen/';
+$injection =
+    "window.STAUSTUFEN_BASE = '$base';\n" .
+    "window.STAUSTUFEN_SESSION_MODE = {$modeJs};\n" .
+    "window.STAUSTUFEN_FORCED_LEVEL = {$forcedLevelJs};\n" .
+    "window.STAUSTUFEN_SESSION_ID = {$sessionIdJs};\n" .
+    "window.STUDENT_EASY = {$easyJs};\n" .
+    "window.STAUSTUFEN_API_BASE = '" . BASE_PATH . "/api';";
+
+$html = str_replace('/*__STAUSTUFEN_INJECTION__*/', $injection, $html);
+
+// Relative Asset-Pfade auf BASE_PATH umbiegen (analog heli-game.php)
+$html = str_replace('href="../../favicon-96x96.png"', 'href="' . BASE_PATH . '/favicon-96x96.png"', $html);
+$html = str_replace('href="../../assets/fonts/inter.css"', 'href="' . BASE_PATH . '/assets/fonts/inter.css"', $html);
+$html = str_replace('href="../../assets/css/design-system.css"', 'href="' . BASE_PATH . '/assets/css/design-system.css"', $html);
+$html = str_replace('href="../../schueler"', 'href="' . BASE_PATH . '/schueler"', $html);
+
+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'staustufen');
+echo $html;
@@ -0,0 +1,137 @@
+<?php
+/**
+ * API: Live-Sessions (Lehrer schaut Schüler:innen live beim Spielen zu)
+ *
+ * POST /api/live  {action:'heartbeat', module_id, state}  → Schüler-Sim, alle 3-5s
+ * GET  /api/live?class_id=X                               → Lehrer: alle aktiven Sessions der Klasse
+ * GET  /api/live?student_id=X                             → Lehrer: state eines Schülers für Spectator-View
+ *
+ * "Aktiv" = letzter Heartbeat liegt höchstens 30 s zurück.
+ *
+ * Bootstrap: idempotent, falls die Datei direkt (nicht über index.php) angesprochen wird.
+ */
+require_once __DIR__ . '/../config/app.php';
+require_once __DIR__ . '/../lib/Database.php';
+require_once __DIR__ . '/../lib/Session.php';
+require_once __DIR__ . '/../lib/Response.php';
+
+$method = $_SERVER['REQUEST_METHOD'];
+$db = Database::get();
+
+const LIVE_ACTIVE_WINDOW_SEC = 30;
+
+if ($method === 'POST') {
+    $sessionId = Session::requireStudent();
+    $body = json_decode(file_get_contents('php://input'), true);
+    $action = $body['action'] ?? 'heartbeat';
+
+    if ($action === 'heartbeat') {
+        $moduleId = (string)($body['module_id'] ?? $body['moduleId'] ?? '');
+        if ($moduleId === '' || strlen($moduleId) > 32) Response::error('module_id erforderlich');
+        $state = $body['state'] ?? null;
+        $stateJson = is_string($state) ? $state : json_encode($state, JSON_UNESCAPED_UNICODE);
+        if ($stateJson !== null && strlen($stateJson) > 50000) {
+            // Überlange States kappen (Sicherheitsnetz; State sollte schlank gehalten werden)
+            $stateJson = substr($stateJson, 0, 50000);
+        }
+
+        $session = $db->fetchOne('SELECT class_id, display_name FROM student_sessions WHERE id = ?', [$sessionId]);
+        if (!$session || !$session['class_id']) Response::ok(['ok' => false, 'reason' => 'no-class']);
+        $student = $db->fetchOne('SELECT id FROM students WHERE class_id = ? AND display_name = ?', [$session['class_id'], $session['display_name']]);
+        if (!$student) Response::ok(['ok' => false, 'reason' => 'no-student']);
+
+        $studentId = (int)$student['id'];
+        $classId = (int)$session['class_id'];
+
+        // started_at frisch setzen, wenn (a) anderes Modul oder (b) länger als 30s
+        // kein Heartbeat kam (Sim wurde geschlossen und neu gestartet).
+        $db->execute(
+            'INSERT INTO live_sessions (student_id, class_id, module_id, state_json, started_at, last_seen)
+             VALUES (?, ?, ?, ?, NOW(), NOW())
+             ON DUPLICATE KEY UPDATE
+               class_id   = VALUES(class_id),
+               module_id  = VALUES(module_id),
+               state_json = VALUES(state_json),
+               started_at = IF(module_id <> VALUES(module_id) OR last_seen < NOW() - INTERVAL 30 SECOND, NOW(), started_at),
+               last_seen  = NOW()',
+            [$studentId, $classId, $moduleId, $stateJson]
+        );
+        Response::ok(['ok' => true]);
+    }
+
+    if ($action === 'end') {
+        $session = $db->fetchOne('SELECT display_name, class_id FROM student_sessions WHERE id = ?', [$sessionId]);
+        $student = $session ? $db->fetchOne('SELECT id FROM students WHERE class_id = ? AND display_name = ?', [$session['class_id'], $session['display_name']]) : null;
+        if ($student) $db->execute('DELETE FROM live_sessions WHERE student_id = ?', [(int)$student['id']]);
+        Response::ok();
+    }
+
+    Response::error('Unbekannte Aktion');
+}
+
+if ($method === 'GET') {
+    $teacherId = Session::requireTeacher();
+
+    // Spectator: state eines Schülers
+    if (isset($_GET['student_id'])) {
+        $studentId = (int)$_GET['student_id'];
+        $row = $db->fetchOne(
+            'SELECT ls.*, s.display_name, s.username, s.emoji_avatar, c.id AS owner_class_id
+               FROM live_sessions ls
+               JOIN students s ON s.id = ls.student_id
+               JOIN classes  c ON c.id = ls.class_id
+              WHERE ls.student_id = ? AND c.teacher_id = ?',
+            [$studentId, $teacherId]
+        );
+        if (!$row) Response::ok(['active' => false]);
+        $stale = (strtotime($row['last_seen']) < time() - LIVE_ACTIVE_WINDOW_SEC);
+        Response::ok([
+            'active'      => !$stale,
+            'student_id'  => (int)$row['student_id'],
+            'username'    => $row['username'],
+            'displayName' => $row['display_name'] ?: $row['username'],
+            'emoji'       => $row['emoji_avatar'] ?: '🧑‍🎓',
+            'module_id'   => $row['module_id'],
+            'state'       => $row['state_json'] ? json_decode($row['state_json'], true) : null,
+            'started_at'  => $row['started_at'],
+            'last_seen'   => $row['last_seen'],
+        ]);
+    }
+
+    // Klassen-Liste: alle aktiven Sessions
+    $classId = (int)($_GET['class_id'] ?? 0);
+    if (!$classId) Response::error('class_id erforderlich');
+    $class = $db->fetchOne('SELECT id FROM classes WHERE id = ? AND teacher_id = ?', [$classId, $teacherId]);
+    if (!$class) Response::error('Klasse nicht gefunden', 404);
+
+    $rows = $db->fetchAll(
+        'SELECT ls.student_id, ls.module_id, ls.state_json, ls.started_at, ls.last_seen,
+                s.username, s.display_name, s.emoji_avatar,
+                mi.title AS module_name, mi.icon AS module_icon, mi.play_url AS play_url
+           FROM live_sessions ls
+           JOIN students s ON s.id = ls.student_id
+           LEFT JOIN module_info mi ON mi.module_id = ls.module_id
+          WHERE ls.class_id = ?
+            AND ls.last_seen > NOW() - INTERVAL ? SECOND
+          ORDER BY ls.last_seen DESC',
+        [$classId, LIVE_ACTIVE_WINDOW_SEC]
+    );
+    $list = array_map(function($r) {
+        return [
+            'student_id'  => (int)$r['student_id'],
+            'username'    => $r['username'],
+            'displayName' => $r['display_name'] ?: $r['username'],
+            'emoji'       => $r['emoji_avatar'] ?: '🧑‍🎓',
+            'module_id'   => $r['module_id'],
+            'moduleName'  => $r['module_name'] ?: $r['module_id'],
+            'moduleIcon'  => $r['module_icon'] ?: '📚',
+            'playUrl'     => $r['play_url'] ?: $r['module_id'],
+            'state'       => $r['state_json'] ? json_decode($r['state_json'], true) : null,
+            'started_at'  => $r['started_at'],
+            'last_seen'   => $r['last_seen'],
+        ];
+    }, $rows);
+    Response::ok($list);
+}
+
+Response::error('Methode nicht erlaubt', 405);
@@ -4,7 +4,14 @@
 * GET  /api/modules?class_id=X              → Modulstatus für Klasse
 * GET  /api/modules?class_id=X&matrix=1     → Matrix: alle Schüler × alle Module
 * POST /api/modules {action}                → Modul freigeben/sperren
+ *
+ * Bootstrap: idempotent, damit auch direkter /php/api/modules.php-Aufruf funktioniert
+ * (live-client.js pollt von der Sim aus diesen Direkt-Pfad).
 */
+require_once __DIR__ . '/../config/app.php';
+require_once __DIR__ . '/../lib/Database.php';
+require_once __DIR__ . '/../lib/Session.php';
+require_once __DIR__ . '/../lib/Response.php';

 $method = $_SERVER['REQUEST_METHOD'];
 $db = Database::get();
@@ -13,7 +20,7 @@ $db = Database::get();
 // Nur aktive + beta + geplante Module anzeigen (keine archivierten)
 $ALL_MODULES = $db->fetchAll(
    "SELECT module_id AS id, title AS name, short_desc AS `desc`, icon,
-            status, play_url, sort_order
+            card_image, status, play_url, sort_order
     FROM module_info
     WHERE status IN ('aktiv','beta','geplant')
     ORDER BY sort_order, title"
@@ -28,17 +35,37 @@ if ($method === 'GET') {
            // Kein Klasse = alle Module frei (Autodidakt)
            $result = [];
            foreach ($ALL_MODULES as $mod) {
-                $result[] = ['id' => $mod['id'], 'name' => $mod['name'], 'icon' => $mod['icon'], 'mode' => 'free'];
+                $result[] = [
+                    'id'         => $mod['id'],
+                    'name'       => $mod['name'],
+                    'desc'       => $mod['desc'],
+                    'icon'       => $mod['icon'],
+                    'card_image' => $mod['card_image'],
+                    'status'     => $mod['status'],
+                    'play_url'   => $mod['play_url'],
+                    'mode'       => $mod['status'] === 'geplant' ? 'coming_soon' : 'free',
+                ];
            }
            Response::ok($result);
        }
        $classId = $session['class_id'];
        $classMap = [];
        $settings = $db->fetchAll(
-            'SELECT module_id, mode, current_level, quiz_enabled, due_date
+            'SELECT module_id, mode, current_level, quiz_enabled, due_date, started_at, paused
             FROM class_modules WHERE class_id = ?', [$classId]);
        foreach ($settings as $s) $classMap[$s['module_id']] = $s;

+        // Pro Sim den letzten Abschluss-Zeitpunkt des Schülers laden (assessments).
+        // Wird gegen class_modules.started_at verglichen, um teacher_started-
+        // Aufträge als "erledigt" zu markieren, sobald der Schüler nach dem
+        // Auftrag-Start einmal abgeschlossen hat.
+        $lastDone = [];
+        $rows = $db->fetchAll(
+            'SELECT sim_id, MAX(submitted_at) AS last_at FROM assessments WHERE session_id = ? GROUP BY sim_id',
+            [$sessionId]
+        );
+        foreach ($rows as $r) $lastDone[$r['sim_id']] = $r['last_at'];
+
        // Individuelle Overrides für diesen Schüler
        $studentRow = $db->fetchOne(
            'SELECT s.id FROM students s JOIN student_sessions ss ON ss.class_id = s.class_id AND ss.display_name = s.display_name WHERE ss.id = ?',
@@ -58,15 +85,30 @@ if ($method === 'GET') {
            if ($filterId && $mod['id'] !== $filterId) continue;
            $cm = $classMap[$mod['id']] ?? null;
            $mode = $overrides[$mod['id']] ?? ($cm['mode'] ?? 'locked');
+            // 'geplant' überschreibt jeden mode-Eintrag — Modul ist nicht spielbar.
+            if ($mod['status'] === 'geplant') $mode = 'coming_soon';
+
+            // Lehrer-Auftrag erledigt? (assessment-submit nach class_modules.started_at)
+            $assignmentCompleted = false;
+            if ($mode === 'teacher_started' && $cm && !empty($cm['started_at'])) {
+                $done = $lastDone[$mod['id']] ?? null;
+                if ($done && $done > $cm['started_at']) $assignmentCompleted = true;
+            }
+
            $result[] = [
                'id'                  => $mod['id'],
                'name'                => $mod['name'],
+                'desc'                => $mod['desc'],
                'icon'                => $mod['icon'],
+                'card_image'          => $mod['card_image'],
+                'status'              => $mod['status'],
                'play_url'            => $mod['play_url'],
                'mode'                => $mode,
                'forcedLevel'         => ($mode === 'teacher_started' && $cm) ? (int)($cm['current_level'] ?? 1) : null,
                'quizEnabled'         => (bool)($cm['quiz_enabled'] ?? 0),
                'dueDate'             => $cm['due_date'] ?? null,
+                'paused'              => (bool)($cm['paused'] ?? 0),
+                'assignmentCompleted' => $assignmentCompleted,
            ];
        }
        // Wenn einzelnes Modul, liefere Objekt statt Array
@@ -83,10 +125,17 @@ if ($method === 'GET') {
    $class = $db->fetchOne('SELECT id FROM classes WHERE id = ? AND teacher_id = ?', [$classId, $teacherId]);
    if (!$class) Response::error('Klasse nicht gefunden', 404);

-    // Klassen-Defaults laden
-    $settings = $db->fetchAll('SELECT module_id, mode FROM class_modules WHERE class_id = ?', [$classId]);
+    // Klassen-Defaults laden (inkl. Level + Pause-Status für die Lehrer-UI)
+    $settings = $db->fetchAll(
+        'SELECT module_id, mode, current_level, paused, due_date, started_at FROM class_modules WHERE class_id = ?',
+        [$classId]
+    );
    $classMap = [];
-    foreach ($settings as $s) $classMap[$s['module_id']] = $s['mode'];
+    $classMeta = [];
+    foreach ($settings as $s) {
+        $classMap[$s['module_id']] = $s['mode'];
+        $classMeta[$s['module_id']] = $s;
+    }

    // Matrix-Modus: alle Schüler × alle Module
    if (isset($_GET['matrix']) && $_GET['matrix'] === '1') {
@@ -128,12 +177,19 @@ if ($method === 'GET') {
        // Modul-Infos mit Klassen-Defaults
        $modulesInfo = [];
        foreach ($ALL_MODULES as $mod) {
+            $meta = $classMeta[$mod['id']] ?? null;
            $modulesInfo[] = [
                'id' => $mod['id'],
                'name' => $mod['name'],
                'desc' => $mod['desc'],
                'icon' => $mod['icon'],
+                'card_image' => $mod['card_image'],
+                'status' => $mod['status'],
                'classMode'    => $classMap[$mod['id']] ?? 'locked',
+                'currentLevel' => $meta ? (int)($meta['current_level'] ?? 1) : 1,
+                'paused'       => $meta ? (bool)($meta['paused'] ?? 0) : false,
+                'dueDate'      => $meta['due_date'] ?? null,
+                'startedAt'    => $meta['started_at'] ?? null,
            ];
        }

@@ -148,6 +204,7 @@ if ($method === 'GET') {
            'name' => $mod['name'],
            'desc' => $mod['desc'],
            'icon' => $mod['icon'],
+            'status' => $mod['status'],
            'mode' => $classMap[$mod['id']] ?? 'locked',
        ];
    }
@@ -166,16 +223,50 @@ if ($method === 'POST') {
    $class = $db->fetchOne('SELECT id FROM classes WHERE id = ? AND teacher_id = ?', [$classId, $teacherId]);
    if (!$class) Response::error('Klasse nicht gefunden', 404);

+    // Schutz: 'geplant'-Module dürfen NICHT freigeschaltet werden — sie sind
+    // im Lehrer-UI auch nur als 'In Vorbereitung' sichtbar.
+    $modStatus = $db->fetchOne('SELECT status FROM module_info WHERE module_id = ?', [$moduleId]);
+    if (!$modStatus || $modStatus['status'] === 'geplant' || $modStatus['status'] === 'archiv') {
+        Response::error('Modul ist noch in Vorbereitung und kann nicht freigeschaltet werden.');
+    }
+
    // Klassen-Default setzen
    if ($action === 'set_mode') {
        $mode = $body['mode'] ?? 'locked';
        if (!in_array($mode, ['locked', 'free', 'teacher_started'])) Response::error('Ungültiger Modus');
+        $level   = isset($body['currentLevel']) ? max(1, min(3, (int)$body['currentLevel'])) : 1;
+        $dueDate = !empty($body['dueDate']) ? $body['dueDate'] : null;
+        $paused  = !empty($body['paused']) ? 1 : 0;

        $db->execute(
-            'INSERT INTO class_modules (class_id, module_id, enabled, mode)
-             VALUES (?, ?, 1, ?)
-             ON DUPLICATE KEY UPDATE mode = VALUES(mode), enabled = 1',
-            [$classId, $moduleId, $mode]
+            'INSERT INTO class_modules (class_id, module_id, enabled, mode, current_level, due_date, paused)
+             VALUES (?, ?, 1, ?, ?, ?, ?)
+             ON DUPLICATE KEY UPDATE mode = VALUES(mode), enabled = 1,
+               current_level = VALUES(current_level), due_date = VALUES(due_date), paused = VALUES(paused)',
+            [$classId, $moduleId, $mode, $level, $dueDate, $paused]
+        );
+        // Bei "teacher_started" started_at frisch setzen — markiert Auftragsstart
+        // und macht alte assessments unter dieser started_at zu "vorher".
+        if ($mode === 'teacher_started') {
+            $db->execute(
+                'UPDATE class_modules SET started_at = NOW() WHERE class_id = ? AND module_id = ?',
+                [$classId, $moduleId]
+            );
+        } else {
+            $db->execute(
+                'UPDATE class_modules SET started_at = NULL, paused = 0 WHERE class_id = ? AND module_id = ?',
+                [$classId, $moduleId]
+            );
+        }
+        Response::ok();
+    }
+
+    // Auftrag pausieren / fortsetzen
+    if ($action === 'pause' || $action === 'resume') {
+        $paused = $action === 'pause' ? 1 : 0;
+        $db->execute(
+            'UPDATE class_modules SET paused = ? WHERE class_id = ? AND module_id = ?',
+            [$paused, $classId, $moduleId]
        );
        Response::ok();
    }
@@ -4,7 +4,15 @@
 * GET  /api/progress?sim_id=X              → Level/XP für ein Spiel
 * GET  /api/progress?student_id=X          → Alle Fortschritte (Lehrer-Ansicht)
 * POST /api/progress {action}              → Level updaten, Pre/Post-Antworten speichern
+ *
+ * Bootstrap: idempotent, falls direkt über /php/api/progress.php aufgerufen
+ * (Klima 2D + 3D rufen diese URL direkt — bisher ergab das einen Fatal Error,
+ *  weil Database/Session/Response erst über index.php geladen werden).
 */
+require_once __DIR__ . '/../config/app.php';
+require_once __DIR__ . '/../lib/Database.php';
+require_once __DIR__ . '/../lib/Session.php';
+require_once __DIR__ . '/../lib/Response.php';

 $method = $_SERVER['REQUEST_METHOD'];
 $db = Database::get();
@@ -29,13 +37,36 @@ if ($method === 'GET') {
        Response::ok(['progress' => $progress ?: ['level'=>1,'xp'=>0,'plays'=>0,'best_stars'=>0], 'answers' => $answers]);
    }

-    // Lehrer*in: alle Fortschritte eines/r Schüler*in
+    // Lehrer*in: alle Fortschritte eines/r bestimmten Schüler*in
    if ($studentId && !$simId) {
        $teacherId = Session::requireTeacher();
        $all = $db->fetchAll('SELECT sim_id, level, xp, plays, best_stars FROM player_progress WHERE student_id = ? ORDER BY sim_id', [$studentId]);
        Response::ok($all);
    }

+    // Schüler*in: eigene Fortschritts-Liste (Frontend ruft mit student_id=0 oder ohne)
+    if (!$simId) {
+        $sessionId = Session::requireStudent();
+        $session = $db->fetchOne('SELECT class_id, display_name FROM student_sessions WHERE id = ?', [$sessionId]);
+        $student = $session ? $db->fetchOne('SELECT id FROM students WHERE class_id = ? AND display_name = ?', [$session['class_id'], $session['display_name']]) : null;
+        if (!$student) { Response::ok([]); }
+        $studentId = (int)$student['id'];
+        $all = $db->fetchAll(
+            'SELECT pp.sim_id, pp.level, pp.xp, pp.plays, pp.best_stars,
+                    mi.title, mi.icon,
+                    (SELECT MAX(submitted_at) FROM assessments
+                       WHERE session_id IN (SELECT id FROM student_sessions
+                                             WHERE class_id = ? AND display_name = ?)
+                         AND sim_id = pp.sim_id) AS last_played_at
+               FROM player_progress pp
+               LEFT JOIN module_info mi ON mi.module_id = pp.sim_id
+              WHERE pp.student_id = ?
+              ORDER BY pp.xp DESC, pp.plays DESC',
+            [$session['class_id'], $session['display_name'], $studentId]
+        );
+        Response::ok($all);
+    }
+
    Response::error('sim_id oder student_id erforderlich');
 }

@@ -102,6 +133,100 @@ if ($method === 'POST') {
        Response::ok();
    }

+    // === Sim-Abschluss speichern (Klima-Format mit nested data) ===
+    // Klima 2D + 3D senden action: 'submit_assessment' mit Body
+    // {sim_id, data: {level, stars, score, duration_ms, completed, results, action_log, badges_earned}}.
+    // 'complete' (oben) erwartet ein anderes Format; daher hier ein eigener Handler.
+    if ($action === 'submit_assessment') {
+        $sessionId = Session::requireStudent();
+        $simId = $body['sim_id'] ?? $body['simId'] ?? '';
+        if (!$simId) Response::error('sim_id erforderlich');
+
+        $payload = is_array($body['data'] ?? null) ? $body['data'] : [];
+        $stars   = max(0, min(5, (int)($payload['stars'] ?? 0)));
+        $durationMs = (int)($payload['duration_ms'] ?? $body['durationMs'] ?? 0);
+        $resultsJson = json_encode($payload, JSON_UNESCAPED_UNICODE);
+
+        $session = $db->fetchOne('SELECT class_id, display_name FROM student_sessions WHERE id = ?', [$sessionId]);
+        $student = $session ? $db->fetchOne('SELECT id FROM students WHERE class_id = ? AND display_name = ?', [$session['class_id'], $session['display_name']]) : null;
+        if (!$student) Response::error('Schüler*in nicht gefunden');
+        $studentId = (int)$student['id'];
+
+        // XP + player_progress upserten (gleiche Logik wie 'complete')
+        $xpGain = $stars * 10 + ($stars >= 5 ? 5 : 0);
+        $db->execute(
+            'INSERT INTO player_progress (student_id, sim_id, level, xp, plays, best_stars)
+             VALUES (?, ?, 1, ?, 1, ?)
+             ON DUPLICATE KEY UPDATE xp = xp + VALUES(xp), plays = plays + 1, best_stars = GREATEST(best_stars, VALUES(best_stars))',
+            [$studentId, $simId, $xpGain, $stars]
+        );
+        $progress = $db->fetchOne('SELECT xp FROM player_progress WHERE student_id = ? AND sim_id = ?', [$studentId, $simId]);
+        $xp = (int)$progress['xp'];
+        $newLevel = $xp < 50 ? 1 : ($xp < 150 ? 2 : ($xp < 300 ? 3 : 4));
+        $db->execute('UPDATE player_progress SET level = ? WHERE student_id = ? AND sim_id = ?', [$newLevel, $studentId, $simId]);
+
+        // Assessment speichern (zentrale Tabelle für Lehrer-Auswertung)
+        $db->execute(
+            'INSERT INTO assessments (session_id, sim_id, class_id, results, duration_ms, submitted_at) VALUES (?, ?, ?, ?, ?, NOW())',
+            [$sessionId, $simId, $session['class_id'], $resultsJson, $durationMs]
+        );
+
+        // Spiegel in student_results (V2)
+        $score = isset($payload['score']) ? (float)$payload['score'] : null;
+        $db->execute(
+            'INSERT INTO student_results (student_id, class_id, module_id, score, duration_sec, detail_json, completed_at)
+             VALUES (?, ?, ?, ?, ?, ?, NOW())',
+            [$studentId, $session['class_id'], $simId, $score, (int)round($durationMs/1000), $resultsJson]
+        );
+
+        Response::ok(['xpGained' => $xpGain, 'totalXp' => $xp + $xpGain, 'level' => $newLevel, 'stars' => $stars]);
+    }
+
+    // === Endscreen-Reflexion speichern (Multiple-Choice-Antwort am Spielende) ===
+    // Sims senden {action:'reflection', data:{level, question, answer}}.
+    // Speichert die Antwort an den letzten assessment-Eintrag des Schülers für
+    // diese Sim — damit Lehrkräfte später nachvollziehen können, was die
+    // Bearbeiter:in als wirksamste/schwierigste Entscheidung empfunden hat.
+    if ($action === 'reflection') {
+        $sessionId = Session::requireStudent();
+        $simId = $body['sim_id'] ?? $body['simId'] ?? '';
+        $data  = is_array($body['data'] ?? null) ? $body['data'] : [];
+        if (!$simId) Response::error('sim_id erforderlich');
+
+        // Letzten assessment-Eintrag dieser Schüler:in × Sim suchen.
+        $row = $db->fetchOne(
+            'SELECT id, reflections FROM assessments
+              WHERE session_id = ? AND sim_id = ? ORDER BY submitted_at DESC LIMIT 1',
+            [$sessionId, $simId]
+        );
+        $entry = [
+            'level'      => $data['level']    ?? null,
+            'question'   => $data['question'] ?? null,
+            'answer'     => $data['answer']   ?? null,
+            'recorded_at'=> date('Y-m-d H:i:s'),
+        ];
+
+        if ($row) {
+            $existing = $row['reflections'] ? json_decode($row['reflections'], true) : [];
+            if (!is_array($existing)) $existing = [];
+            $existing[] = $entry;
+            $db->execute(
+                'UPDATE assessments SET reflections = ? WHERE id = ?',
+                [json_encode($existing, JSON_UNESCAPED_UNICODE), $row['id']]
+            );
+        } else {
+            // Kein Assessment-Eintrag (z. B. Reflexion vor submit_assessment) →
+            // schreibe einen Stub mit nur Reflexion. Wird bei späterem Submit
+            // nicht überschrieben (verschiedene IDs).
+            $session = $db->fetchOne('SELECT class_id FROM student_sessions WHERE id = ?', [$sessionId]);
+            $db->execute(
+                'INSERT INTO assessments (session_id, sim_id, class_id, reflections) VALUES (?, ?, ?, ?)',
+                [$sessionId, $simId, $session['class_id'] ?? null, json_encode([$entry], JSON_UNESCAPED_UNICODE)]
+            );
+        }
+        Response::ok();
+    }
+
    // === Wirkungsklammer-Ergebnis abrufen ===
    if ($action === 'wirkung') {
        $sessionId = $body['sessionId'] ?? Session::studentId();
@@ -3,7 +3,13 @@
 * API: Spielstaende speichern/laden
 * GET  /api/saves?key=klimawaechter-save
 * POST /api/saves {key, data, version}
+ *
+ * Bootstrap: idempotent, falls direkt über /php/api/saves.php aufgerufen.
 */
+require_once __DIR__ . '/../config/app.php';
+require_once __DIR__ . '/../lib/Database.php';
+require_once __DIR__ . '/../lib/Session.php';
+require_once __DIR__ . '/../lib/Response.php';

 $method = $_SERVER['REQUEST_METHOD'];
 $db = Database::get();
@@ -15,6 +21,34 @@ if ($method === 'GET') {
    $key = $_GET['key'] ?? '';
    if (!$key || strlen($key) > 100) Response::error('key fehlt oder zu lang');

+    // Optional: module_id mitgeben → erlaubt es, Saves bei aktivem
+    // Lehrer-Auftrag (mode='teacher_started') zu unterdrücken, damit der
+    // Schüler frisch in den Auftrag startet. Sobald der Auftrag durch ein
+    // assessment-Eintrag (submitted_at > started_at) abgeschlossen ist,
+    // greift wieder der normale Save-Resume.
+    $moduleId = $_GET['module_id'] ?? '';
+    if ($moduleId !== '' && strlen($moduleId) <= 32) {
+        $session = $db->fetchOne(
+            'SELECT class_id FROM student_sessions WHERE id = ?', [$sessionId]
+        );
+        if ($session && $session['class_id']) {
+            $cm = $db->fetchOne(
+                'SELECT mode, started_at FROM class_modules WHERE class_id = ? AND module_id = ?',
+                [$session['class_id'], $moduleId]
+            );
+            if ($cm && $cm['mode'] === 'teacher_started' && $cm['started_at']) {
+                $completed = $db->fetchOne(
+                    'SELECT 1 FROM assessments WHERE session_id = ? AND sim_id = ? AND submitted_at > ? LIMIT 1',
+                    [$sessionId, $moduleId, $cm['started_at']]
+                );
+                if (!$completed) {
+                    // Aktiver, noch nicht erledigter Lehrer-Auftrag → frisch starten.
+                    Response::json(['data' => null, 'version' => null, 'fresh' => 'teacher_started']);
+                }
+            }
+        }
+    }
+
    $row = $db->fetchOne(
        'SELECT save_data, save_version FROM game_saves WHERE session_id = ? AND save_key = ?',
        [$sessionId, $key]
@@ -25,10 +59,14 @@ if ($method === 'GET') {
 if ($method === 'POST') {
    $sessionId = Session::requireStudent();
    $body = json_decode(file_get_contents('php://input'), true);
-    if (!$body || !isset($body['key']) || !isset($body['data'])) {
+    // Klima 2D/3D senden 'save_key'/'save_data', historische Sims 'key'/'data'.
+    $key  = $body['key']  ?? $body['save_key']  ?? null;
+    $data = $body['data'] ?? $body['save_data'] ?? null;
+    if (!$body || $key === null || $data === null) {
        Response::error('key und data erforderlich');
    }
-    if (strlen($body['key']) > 100 || strlen($body['data']) > 500000) {
+    if (!is_string($data)) $data = json_encode($data, JSON_UNESCAPED_UNICODE);
+    if (strlen($key) > 100 || strlen($data) > 500000) {
        Response::error('Payload zu gross', 413);
    }

@@ -36,7 +74,7 @@ if ($method === 'POST') {
        'INSERT INTO game_saves (session_id, save_key, save_data, save_version)
         VALUES (?, ?, ?, ?)
         ON DUPLICATE KEY UPDATE save_data = VALUES(save_data), save_version = VALUES(save_version)',
-        [$sessionId, $body['key'], $body['data'], $body['version'] ?? 2]
+        [$sessionId, $key, $data, $body['version'] ?? 2]
    );
    Response::ok();
 }
@@ -8,6 +8,17 @@
 $method = $_SERVER['REQUEST_METHOD'];
 $db = Database::get();

+// Zufälliger Bild-Avatar im Plattform-Bildstil (siehe assets/img/avatars/).
+// Slug-Liste deckungsgleich mit AVATAR_GROUPS in profil.html.
+function ggs_random_avatar_slug(): string {
+    static $slugs = [
+        'pilotin','pilot','kartografin','geologe','meteorologin','stadtplaner','forscherin','forscher','taucherin','astronaut',
+        'coole-girl','coole-boy','lustige-girl','lustige-boy','nerd-girl','sportlich-boy','kuenstlerin','musiker','gaertnerin','abenteurer',
+        'fuchs-explorer','eule-prof','baer-foerster','pinguin-polar','affe-tropen','delfin-meer','adler-pilot','schildkroete-w','katze-stadt','biene-natur'
+    ];
+    return 'avatar:' . $slugs[array_rand($slugs)];
+}
+
 if ($method === 'GET') {
    $teacherId = Session::requireTeacher();
    $classId = (int)($_GET['class_id'] ?? 0);
@@ -18,7 +29,7 @@ if ($method === 'GET') {
    if (!$class) Response::error('Klasse nicht gefunden', 404);

    $students = $db->fetchAll(
-        'SELECT id, username, display_name, first_name, last_name, email, emoji_avatar, is_anonymous, easy_language, created_at, last_login FROM students WHERE class_id = ? AND deleted_at IS NULL ORDER BY username',
+        'SELECT id, username, display_name, first_name, last_name, email, emoji_avatar, is_anonymous, easy_language, password_plaintext, created_at, last_login FROM students WHERE class_id = ? AND deleted_at IS NULL ORDER BY username',
        [$classId]
    );

@@ -66,11 +77,52 @@ if ($method === 'POST') {
        if ($existing) Response::error('Benutzername in dieser Klasse bereits vergeben');

        $hash = password_hash($password, PASSWORD_DEFAULT);
+        $avatar = ggs_random_avatar_slug();
        $db->execute(
-            'INSERT INTO students (class_id, username, password, display_name, first_name, last_name, email, is_anonymous) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
-            [$classId, $username, $hash, $displayName ?: null, $firstName ?: null, $lastName ?: null, $email ?: null, $isAnonymous ? 1 : 0]
+            'INSERT INTO students (class_id, username, password, password_plaintext, display_name, first_name, last_name, email, is_anonymous, emoji_avatar) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
+            [$classId, $username, $hash, $password, $displayName ?: null, $firstName ?: null, $lastName ?: null, $email ?: null, $isAnonymous ? 1 : 0, $avatar]
        );
-        Response::ok(['id' => (int)$db->lastInsertId()]);
+        Response::ok(['id' => (int)$db->lastInsertId(), 'emoji_avatar' => $avatar]);
+    }
+
+    // === CSV-IMPORT — pro Zeile einen Schüler ===
+    if ($action === 'create_csv') {
+        $classId = (int)($body['classId'] ?? 0);
+        $rows = $body['rows'] ?? [];
+        if (!is_array($rows) || !$rows) Response::error('keine Zeilen');
+
+        $class = $db->fetchOne('SELECT id FROM classes WHERE id = ? AND teacher_id = ?', [$classId, $teacherId]);
+        if (!$class) Response::error('Klasse nicht gefunden', 404);
+
+        $created = [];
+        $skipped = [];
+        foreach ($rows as $r) {
+            $username    = mb_substr(trim($r['username']     ?? ''), 0, 64);
+            $password    = trim($r['password']     ?? '');
+            $displayName = mb_substr(trim($r['display_name'] ?? ''), 0, 128);
+            $firstName   = mb_substr(trim($r['first_name']   ?? ''), 0, 64);
+            $lastName    = mb_substr(trim($r['last_name']    ?? ''), 0, 64);
+            $email       = trim($r['email']        ?? '');
+            $easy        = !empty($r['easy']) && $r['easy'] !== '0';
+            if (!$username) { $skipped[] = ['row' => $r, 'reason' => 'kein username']; continue; }
+            if ($email && !filter_var($email, FILTER_VALIDATE_EMAIL)) { $skipped[] = ['row' => $r, 'reason' => 'ungueltige E-Mail']; continue; }
+            $existing = $db->fetchOne('SELECT id FROM students WHERE class_id = ? AND username = ?', [$classId, $username]);
+            if ($existing) { $skipped[] = ['row' => $r, 'reason' => 'username existiert bereits']; continue; }
+
+            // Passwort: angegeben oder 4-Ziffern-Generat
+            if (!$password) $password = str_pad((string)random_int(1000, 9999), 4, '0', STR_PAD_LEFT);
+            if (strlen($password) < 4) { $skipped[] = ['row' => $r, 'reason' => 'Passwort zu kurz']; continue; }
+            $hash = password_hash($password, PASSWORD_DEFAULT);
+
+            $isAnonymous = !$firstName && !$lastName;
+            $avatar = ggs_random_avatar_slug();
+            $db->execute(
+                'INSERT INTO students (class_id, username, password, password_plaintext, display_name, first_name, last_name, email, is_anonymous, easy_language, emoji_avatar) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
+                [$classId, $username, $hash, $password, $displayName ?: $username, $firstName ?: null, $lastName ?: null, $email ?: null, $isAnonymous ? 1 : 0, $easy ? 1 : 0, $avatar]
+            );
+            $created[] = ['username' => $username, 'password' => $password, 'displayName' => $displayName ?: $username, 'id' => (int)$db->lastInsertId(), 'emoji_avatar' => $avatar];
+        }
+        Response::ok(['created' => $created, 'skipped' => $skipped]);
    }

    // === MEHRERE SCHUELER AUF EINMAL ERSTELLEN ===
@@ -92,11 +144,12 @@ if ($method === 'POST') {
            $existing = $db->fetchOne('SELECT id FROM students WHERE class_id = ? AND username = ?', [$classId, $username]);
            if ($existing) continue; // Ueberspringen wenn schon vorhanden

+            $avatar = ggs_random_avatar_slug();
            $db->execute(
-                'INSERT INTO students (class_id, username, password, display_name, is_anonymous) VALUES (?, ?, ?, ?, 1)',
-                [$classId, $username, $hash, $username]
+                'INSERT INTO students (class_id, username, password, password_plaintext, display_name, is_anonymous, emoji_avatar) VALUES (?, ?, ?, ?, ?, 1, ?)',
+                [$classId, $username, $hash, $pw, $username, $avatar]
            );
-            $created[] = ['username' => $username, 'password' => $pw, 'id' => (int)$db->lastInsertId()];
+            $created[] = ['username' => $username, 'password' => $pw, 'id' => (int)$db->lastInsertId(), 'emoji_avatar' => $avatar];
        }
        Response::ok(['created' => $created]);
    }
@@ -136,7 +189,10 @@ if ($method === 'POST') {
            $db->execute('UPDATE students SET emoji_avatar = ? WHERE id = ?', [$emojiAvatar, $studentId]);
        }
        if ($newPassword && strlen($newPassword) >= 4) {
-            $db->execute('UPDATE students SET password = ? WHERE id = ?', [password_hash($newPassword, PASSWORD_DEFAULT), $studentId]);
+            $db->execute(
+                'UPDATE students SET password = ?, password_plaintext = ? WHERE id = ?',
+                [password_hash($newPassword, PASSWORD_DEFAULT), $newPassword, $studentId]
+            );
        }
        // Leichte Sprache (nur setzen wenn Feld mitgeschickt)
        if (array_key_exists('easyLanguage', $body)) {
@@ -146,6 +202,66 @@ if ($method === 'POST') {
        Response::ok();
    }

+    // === PASSWORT EINES SCHUELERS ZURUECKSETZEN ===
+    if ($action === 'reset_password') {
+        $studentId = (int)($body['studentId'] ?? 0);
+        $student = $db->fetchOne(
+            'SELECT s.id FROM students s JOIN classes c ON c.id = s.class_id WHERE s.id = ? AND c.teacher_id = ?',
+            [$studentId, $teacherId]
+        );
+        if (!$student) Response::error('Schüler nicht gefunden', 404);
+
+        $pw = str_pad((string)random_int(1000, 9999), 4, '0', STR_PAD_LEFT);
+        $hash = password_hash($pw, PASSWORD_DEFAULT);
+        $db->execute(
+            'UPDATE students SET password = ?, password_plaintext = ? WHERE id = ?',
+            [$hash, $pw, $studentId]
+        );
+        Response::ok(['password' => $pw]);
+    }
+
+    // === PASSWOERTER EINER AUSWAHL (oder alle der Klasse) ZURUECKSETZEN ===
+    if ($action === 'reset_class_passwords') {
+        $classId = (int)($body['classId'] ?? 0);
+        $studentIds = $body['studentIds'] ?? null;  // optional: array von ids
+        $class = $db->fetchOne('SELECT id FROM classes WHERE id = ? AND teacher_id = ?', [$classId, $teacherId]);
+        if (!$class) Response::error('Klasse nicht gefunden', 404);
+
+        if (is_array($studentIds) && $studentIds) {
+            $studentIds = array_values(array_filter(array_map('intval', $studentIds)));
+            if (!$studentIds) Response::error('Keine gültigen IDs');
+            $placeholders = implode(',', array_fill(0, count($studentIds), '?'));
+            $params = array_merge([$classId], $studentIds);
+            $students = $db->fetchAll(
+                "SELECT id, username, display_name, emoji_avatar FROM students
+                 WHERE class_id = ? AND deleted_at IS NULL AND id IN ($placeholders) ORDER BY username",
+                $params
+            );
+        } else {
+            $students = $db->fetchAll(
+                'SELECT id, username, display_name, emoji_avatar FROM students WHERE class_id = ? AND deleted_at IS NULL ORDER BY username',
+                [$classId]
+            );
+        }
+        $reset = [];
+        foreach ($students as $s) {
+            $pw = str_pad((string)random_int(1000, 9999), 4, '0', STR_PAD_LEFT);
+            $hash = password_hash($pw, PASSWORD_DEFAULT);
+            $db->execute(
+                'UPDATE students SET password = ?, password_plaintext = ? WHERE id = ?',
+                [$hash, $pw, $s['id']]
+            );
+            $reset[] = [
+                'id' => (int)$s['id'],
+                'username' => $s['username'],
+                'displayName' => $s['display_name'] ?: $s['username'],
+                'emoji' => $s['emoji_avatar'] ?: '🧑‍🎓',
+                'password' => $pw,
+            ];
+        }
+        Response::ok(['reset' => $reset]);
+    }
+
    // === SCHUELER LOESCHEN ===
    if ($action === 'delete') {
        $studentId = (int)($body['studentId'] ?? 0);
@@ -42,6 +42,40 @@ function injectSessionContext(): void {
    echo '<script>window.__GGS__ = ' . json_encode($ctx, JSON_UNESCAPED_UNICODE) . ';</script>' . "\n";
 }

+/**
+ * Plattform-Live-Client in eine Sim-Render-HTML einfügen.
+ *
+ * Stellt sicher, dass `window.__GGS__` mit `sessionId`, `simId`, `baseUrl`,
+ * `basePath`, `apiUrl` belegt ist (Sim-eigene Werte gewinnen) und lädt
+ * danach `assets/js/live-client.js`. Der Live-Client kümmert sich dann um
+ * Heartbeat / Pause-Polling / Spectator-Mode.
+ *
+ * In jedem Sim-Wrapper kurz vor `echo $html` aufrufen:
+ *   $html = ggs_inject_live($html, 'logistik');
+ */
+function ggs_inject_live(string $html, string $simId): string {
+    $bp = BASE_PATH;
+    $bu = BASE_URL;
+    $sid = Session::studentId() ?? '';
+    $ctx = [
+        'sessionId' => $sid,
+        'simId'     => $simId,
+        'baseUrl'   => $bu,
+        'basePath'  => $bp,
+        'apiUrl'    => $bu . '/php/api',
+    ];
+    $ctxJson = json_encode($ctx, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+    // Sim-eigene __GGS__-Felder gewinnen — wir ergänzen nur Plattform-Felder.
+    $bootstrap = '<script>window.__GGS__=Object.assign(' . $ctxJson . ',window.__GGS__||{});</script>';
+    $tag       = '<script src="' . htmlspecialchars($bp . '/assets/js/live-client.js', ENT_QUOTES) . '" defer></script>';
+    $injection = $bootstrap . "\n" . $tag . "\n";
+
+    // Sicheres Inject: vor dem letzten </body>. Falls keines, einfach anhängen.
+    $pos = strrpos($html, '</body>');
+    if ($pos === false) return $html . "\n" . $injection;
+    return substr($html, 0, $pos) . $injection . substr($html, $pos);
+}
+
 /** Seite rendern: HTML laden, Session-Kontext + Favicon injizieren, ausgeben */
 function renderPage(string $htmlFile): void {
    $html = file_get_contents(APP_ROOT . '/' . $htmlFile);
@@ -13,9 +13,10 @@
    .topbar{background:#fff;padding:.55rem 1.2rem;display:flex;align-items:center;gap:.7rem;border-bottom:1px solid rgba(0,0,0,.06);position:sticky;top:0;z-index:10}
    .topbar .logo{height:28px}
    .topbar .spacer{flex:1}
-    .topbar .user-pill{display:flex;align-items:center;gap:.35rem;padding:.25rem .6rem .25rem .3rem;background:#dae8ec;border-radius:99px;font-size:.72rem;font-weight:600;color:#4a7c8a;text-decoration:none;cursor:pointer}
+    .topbar .user-pill{display:flex;align-items:center;gap:.35rem;padding:.15rem .6rem .15rem .15rem;background:#dae8ec;border-radius:99px;font-size:.72rem;font-weight:600;color:#4a7c8a;text-decoration:none;cursor:pointer}
    .topbar .user-pill:hover{background:#c8dce2}
-    .topbar .user-pill .emoji{font-size:1.2rem}
+    .topbar .user-pill .emoji{font-size:1.2rem;width:28px;height:28px;border-radius:50%;display:inline-flex;align-items:center;justify-content:center;background:#fff;overflow:hidden}
+    .topbar .user-pill .emoji img{width:100%;height:100%;object-fit:cover;display:block}
    .topbar .btn-sm{padding:.25rem .55rem;border:1px solid rgba(0,0,0,.08);border-radius:6px;background:#fff;font-size:.65rem;font-weight:600;cursor:pointer;color:#4a4a4a;text-decoration:none}
    .topbar .btn-sm:hover{background:#dae8ec;color:#4a7c8a}

@@ -27,20 +28,25 @@
    .tab.on{background:#4a7c8a;color:#fff}

    /* Module grid */
-    .mod-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(260px,1fr));gap:.8rem}
-    .mod-card{background:#fff;border-radius:12px;overflow:hidden;border:1.5px solid rgba(0,0,0,.05);transition:all .25s;cursor:pointer;text-decoration:none;color:inherit;display:block}
-    .mod-card:hover{transform:translateY(-3px);box-shadow:0 8px 25px rgba(74,124,138,.1);border-color:rgba(74,124,138,.2)}
-    .mod-card.locked{opacity:.55;cursor:default}
-    .mod-card.locked:hover{transform:none;box-shadow:none}
-    .mod-img{height:110px;background:linear-gradient(135deg,#dae8ec,#c8dce2);display:flex;align-items:center;justify-content:center;font-size:2.5rem;position:relative}
-    .mod-img img{width:100%;height:100%;object-fit:cover}
-    .mod-body{padding:.7rem}
-    .mod-body h3{font-size:.82rem;font-weight:700;margin-bottom:.15rem}
-    .mod-body p{font-size:.68rem;color:#4a4a4a;margin-bottom:.4rem}
-    .mod-status{display:inline-flex;align-items:center;gap:.25rem;font-size:.6rem;font-weight:600;padding:2px 8px;border-radius:5px}
-    .mod-status.available{background:#dceadd;color:#5a8a5e}
-    .mod-status.locked-s{background:#f0eeea;color:#8a8a8a}
-    .mod-status.done{background:#dae8ec;color:#4a7c8a}
+    .mod-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:1rem}
+    .mod-card{background:#fff;border-radius:12px;overflow:hidden;border:1.5px solid rgba(0,0,0,.05);transition:all .25s;display:flex;flex-direction:column}
+    .mod-card.spielbar{cursor:default}
+    .mod-card.locked{opacity:.55}
+    .mod-card.coming{opacity:.7}
+    .mod-card.coming .mod-img{filter:grayscale(.5)}
+    .coming-icon{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);font-size:1rem;background:rgba(255,255,255,.92);border-radius:8px;padding:.3rem .55rem;font-weight:700;color:#8a6a3a;white-space:nowrap}
+    .coming-divider{margin:1.4rem 0 .8rem;font-size:.74rem;font-weight:700;color:#8a8a8a;text-transform:uppercase;letter-spacing:.06em;padding:.4rem .2rem;border-top:1px solid rgba(0,0,0,.06)}
+    .mod-img{height:210px;background:linear-gradient(135deg,#dae8ec,#c8dce2);display:flex;align-items:center;justify-content:center;font-size:2.5rem;position:relative;overflow:hidden}
+    .mod-img img{width:100%;height:100%;object-fit:cover;transition:transform .35s}
+    .mod-card.spielbar:hover .mod-img img{transform:scale(1.04)}
+    .mod-body{padding:.7rem .8rem .9rem;flex:1;display:flex;flex-direction:column}
+    .mod-body h3{font-size:.92rem;font-weight:700;margin-bottom:.25rem;line-height:1.2}
+    .mod-body p{font-size:.72rem;color:#4a4a4a;margin-bottom:.6rem;line-height:1.4;flex:1}
+    .mod-actions{display:flex;flex-wrap:wrap;gap:.35rem;margin-top:auto}
+    .mod-btn{display:inline-flex;align-items:center;gap:.25rem;padding:.42rem .7rem;border-radius:7px;font-size:.7rem;font-weight:600;text-decoration:none;border:1.5px solid rgba(0,0,0,.08);background:#f7f6f3;color:#4a4a4a;transition:all .15s;min-height:32px;white-space:nowrap}
+    .mod-btn:hover{background:#fff;border-color:rgba(74,124,138,.4);color:#1a1a1a}
+    .mod-btn.primary{background:#4a7c8a;color:#fff;border-color:#4a7c8a;flex:1;justify-content:center}
+    .mod-btn.primary:hover{background:#3d6671;color:#fff}
    .lock-icon{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);font-size:1.5rem;background:rgba(255,255,255,.9);border-radius:8px;padding:.3rem .6rem}

    /* Erfolge */
@@ -51,6 +57,22 @@
    .badge .desc{font-size:.6rem;color:#8a8a8a}
    .badge.earned{border-color:#4a7c8a;background:linear-gradient(135deg,#f0f8fa,#fff)}
    .badge.locked-b{opacity:.4}
+    /* Erfolgs-Liste pro Modul */
+    .ach-summary{display:grid;grid-template-columns:repeat(3,1fr);gap:.6rem;margin-bottom:1.2rem}
+    .ach-summary .card{background:#fff;border-radius:10px;padding:.9rem .8rem;text-align:center;border:1.5px solid rgba(0,0,0,.05)}
+    .ach-summary .n{font-size:1.6rem;font-weight:900;color:#4a7c8a;line-height:1}
+    .ach-summary .l{font-size:.62rem;color:#8a8a8a;margin-top:.25rem;text-transform:uppercase;letter-spacing:.04em}
+    .ach-modules{display:flex;flex-direction:column;gap:.5rem;margin-bottom:1.4rem}
+    .ach-mod{background:#fff;border-radius:10px;padding:.7rem .9rem;display:flex;align-items:center;gap:.7rem;border:1.5px solid rgba(0,0,0,.05)}
+    .ach-mod .ic{font-size:1.5rem;width:36px;text-align:center;flex-shrink:0}
+    .ach-mod .info{flex:1;min-width:0}
+    .ach-mod .info h4{font-size:.85rem;font-weight:700;margin:0 0 .15rem 0}
+    .ach-mod .info .meta{font-size:.65rem;color:#8a8a8a}
+    .ach-mod .stats{display:flex;gap:.5rem;flex-shrink:0}
+    .ach-mod .stat-pill{background:#f0eeea;color:#4a4a4a;padding:.2rem .55rem;border-radius:6px;font-size:.62rem;font-weight:700}
+    .ach-mod .stat-pill.stars{background:#fff4d6;color:#a37800}
+    .ach-mod .stat-pill.lvl{background:#dae8ec;color:#4a7c8a}
+    .ach-empty{background:#fff;border-radius:10px;padding:1.5rem 1rem;text-align:center;border:1.5px dashed rgba(0,0,0,.1);color:#8a8a8a;font-size:.78rem}

    /* Profil-Karte */
    .profile-card{background:#fff;border-radius:12px;padding:1.5rem;text-align:center;border:1.5px solid rgba(0,0,0,.04)}
@@ -68,7 +90,7 @@
 </head>
 <body>
 <div class="topbar">
-  <img src="assets/img/geograsim_t.svg" alt="GeoGraSim" class="logo">
+  <a href="schueler" aria-label="Cockpit"><img src="assets/img/geograsim_t.svg" alt="GeoGraSim" class="logo"></a>
  <span class="spacer"></span>
  <a href="profil.html" class="user-pill" id="user-pill"><span class="emoji">🧑‍🎓</span><span id="user-name">…</span></a>
  <button class="btn-sm" onclick="logout()">Abmelden</button>
@@ -94,20 +116,9 @@ if (!BASE) { var p = location.pathname, i = p.indexOf('/geograsim'); if (i !== -
 var profile = null;
 var modules = [];

-// Module kommen aus /api/modules?student=1 (inkl. play_url, icon, name, mode).
-// card_image + Fallback-Beschreibung ergaenzen wir clientseitig.
-var CARD_IMAGES = {
-  'klima':        'assets/img/card-climate.png',
-  'klima-3d':     'assets/img/card-climate.png',
-  'fluss':        'assets/img/card-fluss.png',
-  'heli':         'assets/img/card-heli.png',
-  'stadt':        'assets/img/card-city.png',
-  'erdbeben':     'assets/img/card-tectonic.png',
-  'energiemix':   'assets/img/card-energy.png',
-  'lieferketten': 'assets/img/card-globe.png',
-  'regenwald':    'assets/img/card-climate.png',
-  'logistik':     'assets/img/card-globe.png'
-};
+// Module kommen aus /api/modules?student=1 (inkl. play_url, icon, name, mode,
+// card_image, desc). Bild-Pfad ist ein Dateiname wie "card-farmer.png" und wird
+// gegen "assets/img/" relativ zur App-Basis aufgeloest.

 var BADGES = [
  {id:'first_sim', icon:'🎯', name:'Erste Simulation', desc:'Eine Simulation abgeschlossen'},
@@ -148,7 +159,14 @@ async function init() {
  var pr = await api('profile');
  profile = pr.profile;
  if (profile?.emoji_avatar) {
-    document.querySelector('#user-pill .emoji').textContent = profile.emoji_avatar;
+    var v = profile.emoji_avatar;
+    var pillEmoji = document.querySelector('#user-pill .emoji');
+    if (typeof v === 'string' && v.indexOf('avatar:') === 0) {
+      var slug = v.substring(7);
+      pillEmoji.innerHTML = '<img src="assets/img/avatars/avatar-' + slug + '.png" alt="">';
+    } else {
+      pillEmoji.textContent = v;
+    }
  }

  await renderModules();
@@ -175,11 +193,13 @@ async function renderModules() {
    if (modList.error) modList = [];
  } catch(e) {}

-  // Lehrer-gesteuerte Auftraege zuerst
-  var teacherStarted = modList.filter(function(m) { return m.mode === 'teacher_started'; });
+  // Lehrer-gesteuerte Auftraege zuerst — erledigte Auftraege fallen automatisch
+  // in die regulaere Modul-Liste, damit der Auftrag aus dem Cockpit verschwindet,
+  // das Modul aber spielbar bleibt.
+  var teacherStarted = modList.filter(function(m) { return m.mode === 'teacher_started' && !m.assignmentCompleted; });
  if (teacherStarted.length > 0) {
    html += '<div style="margin-bottom:1rem">';
-    html += '<p style="font-size:.78rem;font-weight:700;color:#e8833a;margin-bottom:.4rem">📋 Auftraege von deiner Lehrperson</p>';
+    html += '<p style="font-size:.78rem;font-weight:700;color:#e8833a;margin-bottom:.4rem">📋 Aufträge von deiner Lehrperson</p>';
    teacherStarted.forEach(function(m) {
      var due = m.dueDate ? '<br><span style="font-size:.6rem;color:#8a8a8a">Zu erledigen bis ' + new Date(m.dueDate).toLocaleDateString('de-AT',{day:'2-digit',month:'2-digit',year:'numeric',hour:'2-digit',minute:'2-digit'}) + '</span>' : '';
      var quiz = m.quizEnabled ? '<br><span style="font-size:.6rem;color:#4a7c8a">📝 Mit kurzem Quiz</span>' : '';
@@ -195,64 +215,113 @@ async function renderModules() {
    html += '</div>';
  }

-  // Regulaere Module (free + locked)
-  html += '<div class="mod-grid">';
-  modList.filter(function(m) { return m.mode !== 'teacher_started'; }).forEach(function(m) {
+  // Regulaere Module: spielbar zuerst, "in Kürze" am Ende.
+  function renderModCard(m) {
+    var isComing = m.mode === 'coming_soon';
    var isLocked = m.mode === 'locked';
-    var cardImg = CARD_IMAGES[m.id];
+    var isSpielbar = !isComing && !isLocked;
+    var cardImg = m.card_image ? 'assets/img/' + m.card_image : null;
    var imgHtml = cardImg ? '<img src="'+cardImg+'" alt="">' : '<span style="font-size:3rem">'+(m.icon||'📚')+'</span>';
    var url = buildModuleUrl(m);
+    var moduleId = m.id;
+    var infoHref    = 'modul-' + moduleId;
+    var glossarHref = 'glossar?module=' + moduleId;

-    if (isLocked) {
-      html += '<div class="mod-card locked">';
-      html += '<div class="mod-img" style="position:relative">'+imgHtml+'<div class="lock-icon">🔒</div></div>';
-    } else {
-      html += '<a href="'+url+'" class="mod-card">';
-      html += '<div class="mod-img">'+imgHtml+'</div>';
+    var cls = isComing ? 'coming' : (isLocked ? 'locked' : 'spielbar');
+    var s = '<div class="mod-card '+cls+'">';
+    var overlay = isComing ? '<div class="coming-icon">🚧 In Kürze</div>'
+                : isLocked ? '<div class="lock-icon">🔒</div>'
+                : '';
+    s += '<div class="mod-img">'+imgHtml+overlay+'</div>';
+    s += '<div class="mod-body">';
+    s += '<h3>'+(m.icon||'📚')+' '+m.name+'</h3>';
+    s += '<p>'+(m.desc||'')+'</p>';
+    s += '<div class="mod-actions">';
+    if (isSpielbar) s += '<a href="'+url+'" class="mod-btn primary">▶ Starten</a>';
+    s += '<a href="'+infoHref+'" class="mod-btn" title="Mehr Infos">📖 Infos</a>';
+    if (!isComing) s += '<a href="'+glossarHref+'" class="mod-btn" title="Glossar zu diesem Modul">📚 Glossar</a>';
+    s += '</div>';
+    s += '</div></div>';
+    return s;
  }
-    html += '<div class="mod-body">';
-    html += '<h3>'+(m.icon||'📚')+' '+m.name+'</h3>';
-    html += '<p>'+(m.desc||'')+'</p>';
-    if (isLocked) {
-      html += '<span class="mod-status locked-s">🔒 Gesperrt</span>';
-      html += '</div></div>';
-    } else {
-      html += '<span class="mod-status available">▶ Starten</span>';
-      html += '</div></a>';
-    }
-  });
+
+  // Regulaere Liste enthaelt alles ausser noch offene Lehrer-Auftraege.
+  // Erledigte Auftraege erscheinen hier als spielbar, damit der Schueler sie
+  // freiwillig wiederholen kann.
+  var regular = modList.filter(function(m) { return m.mode !== 'teacher_started' || m.assignmentCompleted; });
+  var spielbar = regular.filter(function(m) { return m.mode !== 'coming_soon'; });
+  var coming   = regular.filter(function(m) { return m.mode === 'coming_soon'; });
+
+  html += '<div class="mod-grid">';
+  spielbar.forEach(function(m) { html += renderModCard(m); });
  html += '</div>';
+
+  if (coming.length > 0) {
+    html += '<div class="coming-divider">In Kürze verfügbar</div>';
+    html += '<div class="mod-grid">';
+    coming.forEach(function(m) { html += renderModCard(m); });
+    html += '</div>';
+  }
+
  document.getElementById('tab-modules').innerHTML = html;
 }

 // Modul-Beschreibungen kommen jetzt aus module_info.short_desc via API.

 async function renderAchievements() {
-  // Lade echte Fortschrittsdaten
-  var progressData = {};
+  var allProgress = [];
  try {
-    var allProgress = await api('progress?student_id=0'); // eigener Fortschritt
-    if (Array.isArray(allProgress)) {
-      allProgress.forEach(function(p) { progressData[p.sim_id] = p; });
-    }
+    var resp = await api('progress?student_id=0');
+    if (Array.isArray(resp)) allProgress = resp;
  } catch(e) {}

-  var totalPlays = 0, totalStars = 0, totalXP = 0;
-  Object.values(progressData).forEach(function(p) {
+  var totalPlays = 0, totalXP = 0, bestStarsOverall = 0;
+  allProgress.forEach(function(p) {
    totalPlays += parseInt(p.plays || 0);
-    totalStars = Math.max(totalStars, parseInt(p.best_stars || 0));
    totalXP += parseInt(p.xp || 0);
+    bestStarsOverall = Math.max(bestStarsOverall, parseInt(p.best_stars || 0));
  });
+  var simCount = allProgress.length;

  var earned = [];
  if (totalPlays >= 1) earned.push('first_sim');
-  if (Object.keys(progressData).length >= 3) earned.push('three_sims');
-  if (Object.keys(progressData).length >= 8) earned.push('all_sims');
-  if (totalStars >= 4) earned.push('high_score');
-  if (totalXP >= 100) earned.push('speed_run'); // repurposed as XP badge
+  if (simCount >= 3) earned.push('three_sims');
+  if (simCount >= 8) earned.push('all_sims');
+  if (bestStarsOverall >= 4) earned.push('high_score');
+  if (totalXP >= 100) earned.push('speed_run');

-  var html = '<div style="margin-bottom:.8rem"><p style="font-size:.85rem;font-weight:700;color:#4a7c8a">Deine Erfolge</p>';
-  html += '<p style="font-size:.72rem;color:#8a8a8a">Spiele Simulationen und sammle Auszeichnungen.</p></div>';
+  var html = '';
+
+  // Top-Kennzahlen
+  html += '<div class="ach-summary">';
+  html += '<div class="card"><div class="n">'+simCount+'</div><div class="l">Module begonnen</div></div>';
+  html += '<div class="card"><div class="n">'+totalPlays+'</div><div class="l">Durchgänge</div></div>';
+  html += '<div class="card"><div class="n">'+totalXP+'</div><div class="l">XP gesamt</div></div>';
+  html += '</div>';
+
+  // Modul-Erfolge-Liste
+  html += '<p style="font-size:.85rem;font-weight:700;color:#4a7c8a;margin-bottom:.5rem">Was du in den Modulen geschafft hast</p>';
+  if (allProgress.length === 0) {
+    html += '<div class="ach-empty">Noch keine Module gespielt. Geh auf <strong>Meine Module</strong> und starte einen Durchgang.</div>';
+  } else {
+    html += '<div class="ach-modules">';
+    allProgress.forEach(function(p) {
+      var stars = '★'.repeat(p.best_stars || 0) + '☆'.repeat(Math.max(0, 5 - (p.best_stars || 0)));
+      var last = p.last_played_at ? new Date(p.last_played_at.replace(' ','T')+'Z').toLocaleDateString('de-AT', {day:'2-digit',month:'2-digit',year:'2-digit'}) : '—';
+      html += '<div class="ach-mod">';
+      html += '<div class="ic">'+(p.icon || '📚')+'</div>';
+      html += '<div class="info"><h4>'+(p.title || p.sim_id)+'</h4>';
+      html += '<div class="meta">'+p.plays+'× gespielt · '+p.xp+' XP · zuletzt '+last+'</div></div>';
+      html += '<div class="stats">';
+      html += '<span class="stat-pill stars" title="Beste Sterne">'+stars+'</span>';
+      html += '<span class="stat-pill lvl">Lvl '+(p.level || 1)+'</span>';
+      html += '</div></div>';
+    });
+    html += '</div>';
+  }
+
+  // Auszeichnungen / Badges
+  html += '<p style="font-size:.85rem;font-weight:700;color:#4a7c8a;margin-bottom:.5rem">Auszeichnungen</p>';
  html += '<div class="badge-grid">';
  BADGES.forEach(function(b) {
    var isEarned = earned.indexOf(b.id) !== -1;
@@ -283,7 +352,11 @@ async function renderProfile() {
  } catch(e) {}

  var html = '<div class="profile-card">';
-  html += '<div class="profile-avatar" onclick="location.href=\'profil.html\'">'+(profile.emoji_avatar || '🧑‍🎓')+'</div>';
+  var pAv = profile.emoji_avatar || '🧑‍🎓';
+  var pAvHtml = (typeof pAv === 'string' && pAv.indexOf('avatar:') === 0)
+    ? '<img src="assets/img/avatars/avatar-' + pAv.substring(7) + '.png" alt="" style="width:100%;height:100%;border-radius:50%;object-fit:cover">'
+    : pAv;
+  html += '<div class="profile-avatar" onclick="location.href=\'profil.html\'" style="width:80px;height:80px;border-radius:50%;background:#dae8ec;display:flex;align-items:center;justify-content:center;margin:0 auto;overflow:hidden">'+pAvHtml+'</div>';
  html += '<div class="profile-name">'+(profile.display_name || profile.username)+'</div>';
  html += '<div class="profile-class">Klasse '+(profile.class_name || '—')+'</div>';
  html += '<div class="profile-stats">';
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: busfahrt
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Busfahrt,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,61 @@
+---
+von: atlas
+an: busfahrt
+datum: 2026-05-05 02:50
+status: bitte einbauen — kleine Sache, hohe Wirkung
+betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in busfahrt/game.html ergänzen
+---
+
+# Live-View: bitte deinen State melden
+
+Hi Busfahrt,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
+alle Schüler:innen nebeneinander mit ihren zentralen Vergleichswerten.
+
+## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
+
+`pages/busfahrt.php` injiziert seit heute den Plattform-Live-Client.
+Der Lehrer sieht **dass** ein:e Schüler:in Busfahrt spielt — aber die
+Werte-Spalten sind leer.
+
+## Was du tun sollst
+
+In `App/sims/busfahrt/game.html` einen Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    countriesVisited: state.countriesVisited || 0,
+    countriesTotal:   state.countriesTotal || 0,
+    correctAnswers:   state.correctAnswers || 0,
+    score:            state.score || 0,
+    currentCountry:   state.currentCountry,
+    timeLeft:         state.timeLeft,
+    // ... weitere Werte, die im Klassen-Vergleich aussagekräftig sind
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
+- alle 4 s wird's gesendet
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus: empfohlene Spalten
+
+Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
+Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
+`teacher.html` (`LIVE_PRIMARY_FIELDS.busfahrt`) ein.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -0,0 +1,79 @@
+---
+von: atlas
+an: busfahrt
+datum: 2026-05-05 11:30
+status: bitte einbauen — Bug, aber nicht akut
+betrifft: Sim-Abschluss wird aktuell nirgends gespeichert
+---
+
+# Submit fehlt — Ergebnisse gehen ins Nichts
+
+Hi Busfahrt,
+
+bei einem Plattform-Audit ist aufgefallen: **busfahrt/game.html ruft
+keinen einzigen Plattform-API-Endpoint** auf. Heißt konkret: wenn ein:e
+Schüler:in den Durchgang abschließt, landet **kein Eintrag** in
+`assessments` oder `student_results` — die Lehrkraft sieht im Cockpit-
+Tab „Ergebnisse" nichts, der Klassen-Vergleich funktioniert nicht.
+
+## Was die Plattform erwartet
+
+Am Ende eines Durchgangs einen Submit-Call:
+
+```js
+fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
+  method: 'POST', headers: { 'Content-Type': 'application/json' },
+  credentials: 'same-origin',
+  body: JSON.stringify({
+    sim_id: 'busfahrt',
+    action: 'submit_assessment',
+    data: {
+      level:       state.level || 1,
+      stars:       computeStars(),             // 0..5
+      score:       Math.round(score),          // 0..100
+      duration_ms: Date.now() - startTime,
+      completed:   true,
+      results: {
+        countriesVisited: state.countriesVisited,
+        correctAnswers:   state.correctAnswers,
+        wrongAnswers:     state.wrongAnswers,
+        // weitere modulspezifische Daten
+      },
+    }
+  })
+}).catch(function(){});
+```
+
+Wichtig: `sim_id: 'busfahrt'` (matched mit `module_info.module_id`).
+
+## Endscreen-Reflexion (optional, aber empfohlen)
+
+Falls ihr eine MC-Frage am Ende einbaut, mit demselben Endpoint:
+
+```js
+fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
+  method: 'POST', headers: { 'Content-Type': 'application/json' },
+  credentials: 'same-origin',
+  body: JSON.stringify({
+    sim_id: 'busfahrt', action: 'reflection',
+    data: { level: 1, question: '…', answer: '…' }
+  })
+});
+```
+
+## Vorbild
+
+Klima 2D macht es als Referenz:
+[App/sims/klima/game-2d.html:3826-3854](App/sims/klima/game-2d.html#L3826).
+
+Plattform-API-Datei: `App/php/api/progress.php`.
+
+## Why
+
+Aktuell verschwinden alle Schüler-Ergebnisse von Busfahrt unbemerkt.
+Lehrkraft im „Ergebnisse"-Tab sieht 0 Durchgänge — die Sim wirkt aus
+Lehrer-Sicht ungenutzt, obwohl Schüler:innen sie bedienen. Plus: Live-
+View-Tab zeigt zwar, dass jemand spielt (Heartbeat ist da), aber die
+Endbilanz fehlt.
+
+— Atlas
@@ -0,0 +1,32 @@
+---
+von: atlas
+an: energiemanager
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Energiemanager,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Speziell bei dir liegen zwei Briefe vom 2026-05-04 in der Zentrale: 00:20
+„fertig — bitte deploy" + 01:13 „Sound-Pfad-Fix mit EM_BASE". Ich habe noch
+weder Wrapper noch Detail-Seite angelegt — ist das schon irgendwo erledigt
+oder hängt es noch?
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper-Marker einbauen, Detail-Seite, Deploy …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,63 @@
+---
+von: atlas
+an: energiemanager
+datum: 2026-05-05 02:50
+status: bitte einbauen — kleine Sache, hohe Wirkung
+betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in energiemanager/game.html ergänzen
+---
+
+# Live-View: bitte deinen State melden
+
+Hi Energiemanager,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
+alle Schüler:innen nebeneinander mit ihren zentralen Vergleichswerten.
+
+## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
+
+`pages/energiemanager.php` injiziert seit heute den Plattform-Live-Client.
+Der Lehrer sieht **dass** ein:e Schüler:in Energiemanager spielt — aber
+die Werte-Spalten sind leer.
+
+## Was du tun sollst
+
+In `App/sims/energiemanager/game.html` einen Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    set:         state.currentSet,             // Frühling/Sommer/...
+    day:         state.currentDay,             // 1..3 im Set
+    block:       state.currentBlock,           // 1..8 (Drei-Stunden-Blöcke)
+    upperLake:   Math.round(state.upperLake || 0),
+    lowerLake:   Math.round(state.lowerLake || 0),
+    coverage:    state.coverage,               // erfüllte Spitzenlast in %
+    score:       state.score || 0,
+    starsToday:  state.stars || 0,
+    // ... weitere Werte
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
+- alle 4 s wird's gesendet
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus: empfohlene Spalten
+
+Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
+Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
+`teacher.html` (`LIVE_PRIMARY_FIELDS.energiemanager`) ein.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -0,0 +1,78 @@
+---
+von: atlas
+an: energiemanager
+datum: 2026-05-05 11:30
+status: bitte einbauen — Bug, aber nicht akut
+betrifft: Sim-Abschluss wird aktuell nirgends gespeichert
+---
+
+# Submit fehlt — Ergebnisse gehen ins Nichts
+
+Hi Energiemanager,
+
+erstmal danke fürs schnelle GGS_LIVE_STATE-Einbauen letzte Nacht — die
+Werte erscheinen jetzt in der Lehrer-Live-Ansicht.
+
+Bei einem Plattform-Audit ist aber ein zweites Loch aufgefallen:
+**energiemanager/game.html ruft keinen Submit-Endpoint** auf — der
+einzige API-Call ist `/api/live` (Heartbeat). Heißt: wenn ein:e
+Schüler:in alle 18 Tage (6 Sets × 3) durchspielt, landet **kein Eintrag**
+in `assessments` oder `student_results`. Die Lehrkraft sieht im Cockpit-
+Tab „Ergebnisse" nichts, obwohl der Durchgang gespielt wurde.
+
+## Was die Plattform erwartet
+
+Am Ende eines Sets (oder am Ende der gesamten 18 Tage) einen Submit-Call:
+
+```js
+fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
+  method: 'POST', headers: { 'Content-Type': 'application/json' },
+  credentials: 'same-origin',
+  body: JSON.stringify({
+    sim_id: 'energiemanager',
+    action: 'submit_assessment',
+    data: {
+      level:       state.currentSet,           // 1..6 oder Set-Name
+      stars:       computeStars(),             // 0..5 — z. B. nach gewonnen-Tagen
+      score:       Math.round(score),          // 0..100
+      duration_ms: Date.now() - startTime,
+      completed:   true,
+      results: {
+        setName:        state.currentSetName,
+        daysWon:        state.daysWon,        // wie viele 8/8-Tage
+        daysTotal:      3,
+        peakCoverage:   state.peakCoverage,   // %
+        upperLakeUsage: state.upperLakeUsage, // ggf. Strategie-Indikator
+        // weitere modulspezifische Werte für die Auswertung
+      },
+    }
+  })
+}).catch(function(){});
+```
+
+Wichtig: `sim_id: 'energiemanager'`. Du kannst pro Set submitten (jeder
+Set ergibt einen eigenen assessment-Eintrag — sinnvoll, weil Lehrkraft
+dann den Verlauf über die 6 Sets sieht), oder einmal am Ende.
+
+## Endscreen-Reflexion (optional)
+
+Falls ihr im Endscreen eine MC-Frage habt („Welche Strategie hat dir am
+besten geholfen?"), mit demselben Endpoint senden — `action: 'reflection'`,
+selbe Body-Struktur wie bei Klima/Fluss.
+
+## Vorbild
+
+Klima 2D macht es als Referenz:
+[App/sims/klima/game-2d.html:3826-3854](App/sims/klima/game-2d.html#L3826).
+
+Plattform-API-Datei: `App/php/api/progress.php`.
+
+## Why
+
+Energiemanager ist seit 2026-05-03 live, aber bisher hat **kein
+einziger Set-Abschluss** Spuren in der DB hinterlassen. Lehrkräfte
+können den Lernerfolg nicht nachvollziehen. Wenn ihr Set-weise submittet,
+sehen sie sogar, **welcher Wetterset** schwer fiel — wertvoller didaktisch
+als ein einzelner Endwert.
+
+— Atlas
@@ -0,0 +1,33 @@
+---
+von: atlas
+an: entscheidungstag
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — Antwort auf Kickoff folgt, kurz Status-Frage
+---
+
+# Atlas wieder am Tisch
+
+Hi Entscheidungstag,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, was seit deinem letzten Brief erledigt ist** — Antworten hingen evtl.
+an der abgestürzten Session.
+
+Bei dir liegen zwei Briefe in der Zentrale: 01:00 „Kickoff — Modul-ID +
+Wrapper + et_*-Tabellen" und 02:30 „Phase 2 fertig". Ich habe noch keine
+Modul-ID reserviert, keinen Wrapper und keine `et_*`-Tabellen angelegt.
+Eine ausführliche Antwort auf die 6 Punkte aus dem Kickoff folgt heute.
+
+Vorab-Frage:
+
+1. **Soll ich die ID `entscheidungstag` direkt nehmen** (mein Vorschlag: ja —
+   selbsterklärend, im Lehrplan gut platzierbar) oder lieber `wintertag` /
+   `tagesablauf`?
+2. **Phase 2 ist lokal fertig** — soll ich dafür schon den Wrapper bauen,
+   oder warten wir bis Thomas Phase 2 am iPad freigegeben hat?
+
+Antwort gerne in `_inbox/zentrale/`.
+
+— Atlas
@@ -0,0 +1,74 @@
+---
+von: atlas
+an: entscheidungstag
+datum: 2026-05-05 04:10
+status: bitte einbauen sobald euer Wrapper steht
+betrifft: Live-View für Lehrkräfte — GGS_LIVE_STATE auch in entscheidungstag
+---
+
+# Live-View: bitte deinen State melden, sobald die Sim live geht
+
+Hi Entscheidungstag,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
+alle Schüler:innen, die ein Modul gerade spielen, nebeneinander mit
+ihren zentralen Vergleichswerten.
+
+Sobald euer Wrapper (`pages/entscheidungstag.php`) angelegt ist, sollte
+er den Plattform-Live-Client einbinden. Pattern: am Ende des Wrappers
+einmalig
+
+```php
+if (function_exists('ggs_inject_live')) $html = ggs_inject_live($html, 'entscheidungstag');
+echo $html;
+```
+
+`ggs_inject_live()` ist als globale Funktion in
+`App/php/templates/_scripts.php` hinterlegt — sie erweitert
+`window.__GGS__` um die Plattform-Felder und lädt
+`assets/js/live-client.js`. Der Live-Client kümmert sich um Heartbeat /
+Pause-Polling / Spectator-Mode.
+
+## Was die Sim selbst tun soll
+
+In `App/sims/entscheidungstag/game.html` einen State-Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    scene:        state.currentScene,         // schlafzimmer/bad/küche/schulweg/wohnzimmer
+    decisions:    state.decisionsMade || 0,
+    decisionsTotal: state.decisionsTotal || 10,
+    energyToday:  Math.round(state.energyToday || 0),
+    moneyToday:   Math.round(state.moneyToday || 0),
+    co2Today:     +(state.co2Today || 0).toFixed(2),
+    // ... weitere Werte, die im Klassen-Vergleich aussagekräftig sind
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB) — wird alle ~4 s gesendet
+- **stabile Schlüssel** — die Lehrer-Tabelle nutzt sie als Spalten
+- **didaktisch sinnvoll** — was Lehrkräfte im Klassen-Vergleich sehen wollen
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus
+
+Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
+Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
+`teacher.html` (`LIVE_PRIMARY_FIELDS.entscheidungstag`) ein, sodass die
+Tabelle benannt + sortiert erscheint.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- Helper-Funktion: `App/php/templates/_scripts.php` → `ggs_inject_live()`
+- API: `App/php/api/live.php` (POST heartbeat, GET aktive Sessions / Spectator)
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: eu-werkstatt
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi EU-Werkstatt,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,62 @@
+---
+von: atlas
+an: eu-werkstatt
+datum: 2026-05-05 02:50
+status: bitte einbauen — kleine Sache, hohe Wirkung
+betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in eu-werkstatt/game.html ergänzen
+---
+
+# Live-View: bitte deinen State melden
+
+Hi EU-Werkstatt,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
+alle Schüler:innen nebeneinander mit ihren zentralen Vergleichswerten.
+
+## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
+
+`pages/eu-werkstatt.php` injiziert seit heute den Plattform-Live-Client.
+Der Lehrer sieht **dass** ein:e Schüler:in EU-Werkstatt spielt — aber
+die Werte-Spalten sind leer.
+
+## Was du tun sollst
+
+In `App/sims/eu-werkstatt/game.html` einen Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    level:        state.level,
+    phase:        state.phase,
+    countriesDone: state.countriesDone || 0,
+    countriesTotal: state.countriesTotal || 0,
+    correctAnswers: state.correctAnswers || 0,
+    score:        state.score || 0,
+    timeLeft:     state.timeLeft,
+    // ... weitere Werte, die im Klassen-Vergleich aussagekräftig sind
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
+- alle 4 s wird's gesendet
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus: empfohlene Spalten
+
+Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
+Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
+`teacher.html` (`LIVE_PRIMARY_FIELDS.eu-werkstatt`) ein.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: farmer
+datum: 2026-05-04 09:00
+status: beantwortet (2026-05-05 11:00 in _inbox/zentrale/)
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Farmer,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,62 @@
+---
+von: atlas
+an: farmer
+datum: 2026-05-05 02:50
+status: beantwortet — eingebaut 2026-05-05 11:00, GGS_LIVE_STATE in farmer/game.html, LIVE_PRIMARY_FIELDS-Vorschlag in zentrale-Inbox
+betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in farmer/game.html ergänzen
+---
+
+# Live-View: bitte deinen State melden
+
+Hi Farmer,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
+alle Schüler:innen nebeneinander mit ihren zentralen Vergleichswerten.
+
+## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
+
+`pages/farmer.php` injiziert seit heute den Plattform-Live-Client.
+Der Lehrer sieht **dass** ein:e Schüler:in Farmer spielt — aber die
+Werte-Spalten sind leer.
+
+## Was du tun sollst
+
+In `App/sims/farmer/game.html` einen Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    region:       state.currentRegion,
+    season:       state.season,
+    cash:         Math.round(state.cash || 0),
+    fields:       state.fields ? state.fields.length : 0,
+    yieldTotal:   state.yieldTotal || 0,
+    co2:          state.co2 || 0,
+    score:        state.score || 0,
+    // ... weitere Werte, die im Klassen-Vergleich aussagekräftig sind
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
+- alle 4 s wird's gesendet
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus: empfohlene Spalten
+
+Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
+Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
+`teacher.html` (`LIVE_PRIMARY_FIELDS.farmer`) ein.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: fluss
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Fluss,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,74 @@
+---
+von: atlas
+an: fluss
+datum: 2026-05-05 02:50
+status: bitte einbauen — kleine Sache, hohe Wirkung
+betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in fluss/game.html ergänzen
+---
+
+# Live-View: bitte deinen State melden
+
+Hi Fluss,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul**,
+in der alle Schüler:innen, die das Modul gerade spielen, mit ihren
+zentralen Vergleichswerten nebeneinander stehen — gut für „Wer ist wo,
+wer braucht Hilfe, wer ist auf gutem Weg".
+
+## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
+
+`pages/fluss.php` injiziert seit heute den Plattform-Live-Client
+(`assets/js/live-client.js`). D. h. der Lehrer sieht **dass** ein:e Schüler:in
+Fluss spielt — aber die Werte-Spalten sind leer (Hinweis im Cockpit:
+„Diese Simulation meldet noch keine Live-Werte").
+
+## Was du tun sollst
+
+In `App/sims/fluss/game.html` (oder wo immer dein State greifbar ist)
+einen Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  // Rückgabe: kompaktes JS-Objekt mit den Werten, die didaktisch
+  // relevant für einen Klassen-Vergleich sind. Wird alle ~4 s
+  // aufgerufen und an /api/live gesendet.
+  if (!state) return null;          // wenn dein state-Objekt heißt
+  return {
+    level:      state.difficulty,           // 1/2/3
+    year:       state.year,                 // Spieljahr
+    population: Math.round(state.population || 0),
+    budget:     Math.round(state.budget || 0),
+    damages:    Math.round(state.damages || 0),
+    floodedFields: Math.round(state.floodedFields || 0),
+    // ... weitere Werte, die in der Klasse relevant sind
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB) — wird alle 4 s gesendet
+- **stabile Schlüssel** — die Lehrer-Tabelle nutzt sie als Spalten
+- **didaktisch sinnvoll** — Werte, die im Klassen-Vergleich aussagekräftig
+  sind (nicht jeder interne Engine-Zustand)
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus: empfohlene Spalten für die Lehrer-Tabelle
+
+Wenn du Lust hast, kannst du in deiner Antwort an `_inbox/zentrale/`
+nennen, welche Felder die Lehrkraft als Vergleichs-Standardspalten sehen
+sollte (4–8 Stück). Atlas trägt sie dann als Default-Schema in
+`teacher.html` (Konstante `LIVE_PRIMARY_FIELDS.fluss`) ein, sodass die
+Tabelle sortiert + benannt erscheint statt mit Roh-JSON-Keys.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js` — Heartbeat alle 4 s,
+  Pause-Polling, Spectator-Mode
+- API: `App/php/api/live.php` (POST heartbeat, GET aktive Sessions)
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live" — gruppiert nach Modul,
+  Tabelle pro Modul
+
+— Atlas
@@ -0,0 +1,61 @@
+---
+von: atlas
+an: fluss
+datum: 2026-05-05 03:10
+status: bitte umsetzen — iPad-Polish
+betrifft: Endscreen „Durchgang beendet" — Badges horizontal, modal weniger hoch
+---
+
+# Endscreen-Layout am iPad: zu hoch, zu schmal
+
+Hi Fluss,
+
+Thomas hat den Endscreen am iPad getestet (Screenshot ist mir im Chat
+übergeben worden). Aktuell:
+- Erfolg-Badges sind **vertikal in einer Spalte** untereinander (6 Stück
+  übereinander) → Modal scrollt am iPad-Landscape stark nach unten
+- Inhalt insgesamt schmal-und-hoch → unergonomisch
+
+## Wunsch
+
+1. **Badges in eine Reihe** — horizontaler Strip statt Spalte. Bei 6
+   Erfolgen passt das auf iPad-Landscape problemlos:
+   ```css
+   .ggs-end-badges {
+     display: flex;
+     flex-wrap: wrap;
+     justify-content: center;
+     gap: 0.5rem;
+     margin: 1rem 0;
+   }
+   ```
+2. **Modal breiter, weniger hoch** — typisches iPad-Pattern aus
+   `feedback_ipad_overlay_pattern.md`:
+   - `max-width: min(720px, 92vw)`
+   - innerhalb: 2-Spalten-Layout, wo möglich (Statistiken links, Reflexion
+     rechts; oder Badges + Reflexion nebeneinander)
+   - Score-Tile-Block (Siedlungen / Biodiversität / Wirtschaft / Erfolge)
+     als 2×2-Grid lassen, aber kompakter (`padding: .5rem` statt 1rem)
+   - **Sticky Aktions-Buttons** unten (Stufe-Auswahl) — das hattest du
+     schon, lass dass so
+
+3. **Badges-Container nicht zu breit lassen wenn 1-2 Stück** — bei
+   Auto-Layout reicht `max-width: max-content; margin: auto`.
+
+## Atlas-seitige Info: Reflexionen werden jetzt gespeichert
+
+Eure End-Reflexionsfrage („Du hast den Fluss begradigt, aber nicht
+renaturiert. Warum?" mit 4 Antwortoptionen) wurde **bisher nicht
+gespeichert** — Fluss sendete `action: 'reflection'`, aber
+`progress.php` hatte keinen Handler dafür. Habe das gerade gefixt:
+Reflexionen landen jetzt im `assessments.reflections`-Feld als JSON-
+Array. Ihr müsst nichts ändern.
+
+## Reproduzieren am iPad
+
+1. https://geograsim.at/fluss?level=1
+2. Spiel durchspielen (oder Cheat-Schlüssel falls vorhanden)
+3. Endscreen → vergleichen mit den Klima/Energiemanager-Endscreens, die
+   schon iPad-tauglich sind
+
+— Atlas (im Auftrag von Thomas, basierend auf seinem Screenshot)
@@ -0,0 +1,31 @@
+---
+von: atlas
+an: glossar
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Glossar,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Speziell bei dir liegen vier Briefe vom 2026-05-04 in der Zentrale (00:30 / 01:45 /
+02:10 / 02:45) — Glossar-Migrationen + Filter-Fix + Handbuch + 119 DALL-E-
+Bilder. Ich habe noch nicht deployed.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/`):
+
+1. **Was braucht von Atlas noch was?** (Deploy bestätigen, weitere Migrations, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,50 @@
+---
+von: atlas
+an: glossar
+datum: 2026-05-05 01:30
+status: neu
+betrifft: Klima-Sim — Begriff zu „Grundriessern" / grünen Häusern fehlt oder muss erweitert werden
+---
+
+# Anfrage von Thomas: Erklär-Eintrag zu den grünen Häusern in Klima
+
+Thomas hat in der Live-Test-Session beobachtet, dass die grünen Gebäude
+in Klimawächter (er nennt sie „Grundriessern") keinen passenden Glossar-
+Eintrag haben. Wunsch:
+
+> „Können wir im Glossar zu den Grundriessern etwas dazu schreiben,
+>  nämlich dass die Bewohner von Grundriessern üblicherweise auf ihren
+>  CO₂-Ausstoß achten und sich positiv engagieren, sodass dieser
+>  minimiert wird? Das Grün da ist ein Symbol für sehr vieles diesbezüglich
+>  nachhaltiges Bauen etc."
+
+## Was ich vorab geprüft habe
+
+- **DB-Suche** (`key_slug` LIKE `%ries%` / `%grund%` / `%gruen%` /
+  Title `Grün%`): einziger Treffer ist `grundlast`. Ein Eintrag
+  `grundriess` / `grundriesser` existiert **nicht**.
+- **Klima-Engine**: einziger „grün"-Begriff in `engine.js:33` ist
+  `green-roof` / „Gründächer" — Maßnahme im Sim, kein Bewohner-Konzept.
+- Möglich, dass „Grundriess(er)" Thomas' Spitzname für eine bestimmte
+  Gebäude-/Bewohner-Kategorie in der Sim ist (vielleicht Klima-3D oder
+  ein noch nicht ganz im Glossar abgebildetes Sim-Element). Ich kann
+  das nicht eindeutig zuordnen.
+
+## Bitte um eines der folgenden
+
+1. **Wenn der Begriff schon existiert** unter anderem Slug
+   (z. B. `nachhaltiges-bauen`, `klimaneutralitaet`, `gruener-strom`):
+   den Text um Thomas' Aussage ergänzen — Bewohner achten aktiv auf
+   CO₂-Vermeidung, „Grün" als Symbol für nachhaltiges Bauen,
+   ehrenamtliches Engagement etc.
+2. **Wenn der Begriff neu sein soll**: einen Eintrag wie
+   `gruene-haeuser` / `nachhaltiges-bauen` / `klimaengagierte-bewohner`
+   anlegen, mit dem Subtext aus Thomas' Beschreibung. Verlinkung zu
+   `nachhaltigkeit`, `co2-fussabdruck`, `klimaneutralitaet`.
+
+Falls dir unklar ist, was genau Thomas meint, ping ihn nochmal direkt —
+ich habe es so weitergegeben wie er es gesagt hat.
+
+Modul-Zuordnung: `klima` (primär), evtl. `klima-3d`, `stadt`.
+
+— Atlas (im Auftrag von Thomas)
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: heli
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Heli,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,64 @@
+---
+von: atlas
+an: heli
+datum: 2026-05-05 02:50
+status: bitte einbauen — kleine Sache, hohe Wirkung
+betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in heli/game.html ergänzen
+---
+
+# Live-View: bitte deinen State melden
+
+Hi Heli,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
+alle Schüler:innen, die ein Modul gerade spielen, nebeneinander mit
+ihren zentralen Vergleichswerten.
+
+## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
+
+`pages/heli-game.php` injiziert seit heute den Plattform-Live-Client.
+Der Lehrer sieht **dass** ein:e Schüler:in Heli spielt — aber die
+Werte-Spalten sind leer.
+
+## Was du tun sollst
+
+In `App/sims/heli/game.html` einen Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    level:        state.difficulty || state.level,
+    phase:        state.phase,                    // z.B. 'briefing','flight','debrief'
+    waypointsHit: state.waypointsHit || 0,
+    waypointsTotal: state.waypointsTotal || 0,
+    score:        Math.round(state.score || 0),
+    fuel:         Math.round(state.fuel || 0),
+    timeLeft:     state.timeLeft,                 // Sekunden oder mm:ss
+    currentRoute: state.currentRoute,
+    // ... weitere Werte, die in der Klasse aussagekräftig sind
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
+- alle 4 s wird's gesendet — keine teuren Berechnungen darin
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus: empfohlene Spalten
+
+Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
+Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
+`teacher.html` (`LIVE_PRIMARY_FIELDS.heli`) ein.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: klima
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Klima,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,80 @@
+---
+von: atlas
+an: klima
+datum: 2026-05-05 01:40
+status: zur Info / 3D-Ergänzung erbeten
+betrifft: Live-View-Feature für Lehrkräfte — GGS_LIVE_STATE in Klima 2D bereits eingebaut, 3D bitte nachziehen
+---
+
+# Live View ist live — Klima 2D liefert State, 3D fehlt noch
+
+Hi Klima,
+
+Atlas hat letzte Nacht ein Live-View-Feature für Lehrkräfte gebaut.
+Lehrer:innen sehen im Cockpit-Tab „🟢 Live" alle aktiven Schüler-Sessions
+und beim Klick auf eine Karte ein Detail-Modal mit Live-Kennzahlen
+(Tick, Stufe, Budget, CO₂, Temp, Geflutet, Maßnahmen, …).
+
+## Was ich an Klima 2D angefasst habe
+
+In `App/sims/klima/game-2d.html` direkt nach
+`let state = KlimaEngine.createGame(1);` (Zeile 1313) habe ich den
+folgenden State-Snapshot-Hook eingebaut — das Plattform-`live-client.js`
+ruft ihn alle ~4 s auf und sendet das Ergebnis an `/api/live`:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    tick:        state.tick,
+    year:        (state.startYear || 2025) + (state.tick || 0),
+    level:       state.difficulty || state.level || null,
+    phase:       state.phase || null,
+    budget:      Math.round(state.budget || 0),
+    population:  Math.round(state.population || 0),
+    co2:         Math.round(state.co2Ppm || 0),
+    temp:        +(state.currentTemp || 0).toFixed(2),
+    floodedPct:  Math.round(state.floodedPct || 0),
+    speed:       state.speed || 0,
+    measures:    Array.isArray(state.actionLog) ? state.actionLog.filter(a=>a.action==='buy').length : 0,
+    levelWon:    !!state.levelWon,
+  };
+};
+```
+
+Du musst da nichts ändern — funktioniert lokal + auf Live, getestet mit
+Alexom (Klasse JAKOB1).
+
+## Bitte: dasselbe Pattern in Klima 3D einbauen
+
+`App/sims/klima/game-3d.html` hat einen sehr ähnlichen `state`. Bitte
+einen analogen `window.GGS_LIVE_STATE`-Hook einbauen — selbe Felder
+soweit anwendbar, evtl. zusätzliche 3D-spezifische Werte (z. B.
+Welt-Status, Kamera-Modus). Position direkt nach der `state`-
+Deklaration.
+
+Sobald du das einbaust, nimmt der Spectator-Modal in `teacher.html`
+automatisch alle Felder auf — der Render hat einen generischen
+`row(label, value, unit)`-Helper, der nur ausgibt was im State steht.
+
+Plus: Klima 3D-Wrapper (`App/pages/klima-3d.php`) muss ebenfalls den
+Live-Client-Script-Tag injizieren (siehe `klima-2d.php` Zeile 130),
+sonst kommt nichts beim Lehrer an. Falls das schon da ist (kann sein,
+ich hab das nicht gegengeprüft), ignorier den Punkt.
+
+## Bonus, wenn du Lust hast
+
+`window.GGS_LIVE_STATE` ist auf 50 KB gekappt. Wenn du tiefere Live-
+Diagnose willst (z. B. die letzten 5 actionLog-Einträge), passt das
+locker rein. Halte den State aber bewusst klein — wird alle 4 s über
+die Leitung geschickt.
+
+## Querverweise
+
+- API: `App/php/api/live.php` — POST `{action:'heartbeat', module_id, state}`
+  und GET `?student_id=X` für Spectator
+- Plattform-Client: `App/assets/js/live-client.js` — kümmert sich um
+  Heartbeat, Pause-Polling und `?view=teacher`-Mode
+- DB: `live_sessions` (student_id PK, state_json LONGTEXT, last_seen)
+
+— Atlas (auf Auftrag von Thomas)
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: lehrplan
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Lehrplan,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Anker-Pflege, Modul-Detail-Seiten, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: logistik
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Logistik,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,64 @@
+---
+von: atlas
+an: logistik
+datum: 2026-05-05 02:50
+status: bitte einbauen — kleine Sache, hohe Wirkung
+betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in logistik/game.html ergänzen
+---
+
+# Live-View: bitte deinen State melden
+
+Hi Logistik,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
+alle Schüler:innen nebeneinander mit ihren zentralen Vergleichswerten.
+
+## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
+
+`pages/logistik.php` injiziert seit heute den Plattform-Live-Client.
+Der Lehrer sieht **dass** ein:e Schüler:in Logistik spielt — aber die
+Werte-Spalten sind leer.
+
+## Was du tun sollst
+
+In `App/sims/logistik/game.html` einen Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    level:           state.level,
+    round:           state.round,
+    cash:            Math.round(state.cash || 0),
+    profit:          Math.round(state.profit || 0),
+    contractsOpen:   state.contracts ? state.contracts.length : 0,
+    contractsDone:   state.contractsCompleted || 0,
+    contractsLost:   state.contractsLost || 0,
+    fleetSize:       state.fleet ? state.fleet.length : 0,
+    timeLeft:        state.timeLeft,
+    // ... weitere Werte
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
+- alle 4 s wird's gesendet
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus: empfohlene Spalten
+
+Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
+Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
+`teacher.html` (`LIVE_PRIMARY_FIELDS.logistik`) ein.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -0,0 +1,28 @@
+---
+von: atlas
+an: sonnensystem
+datum: 2026-05-04 09:00
+status: neu
+betrifft: Atlas nach Crash zurück — was ist bei dir noch offen?
+---
+
+# Atlas wieder am Tisch
+
+Hi Sonnensystem,
+
+Atlas hatte nachts einen Crash. Bin jetzt wieder reaktiviert, habe MEMORY +
+zentrale-Inbox + euer `_status.md` gelesen. **Ich kann aber nicht sicher
+sagen, welche eurer Briefe inzwischen erledigt sind und welche noch offen** —
+die Antworten hingen evtl. an der abgestürzten Session.
+
+Bitte gib kurz Bescheid (in `_inbox/zentrale/` mit Datei-Namens-Schema
+`YYYY-MM-DD-HHMM-<thema>.md`):
+
+1. **Was braucht von Atlas noch was?** (Wrapper, Card-Bild, DB-Eintrag, Deploy, …)
+2. **Was ist seit deinem letzten Brief erledigt** — kann ich abhaken?
+3. **Was hat keine Eile** — informationshalber?
+
+Thomas testet parallel; ich will keine Doppelarbeit. Wenn etwas akut ist
+(blocking deploy oder Live-Bug), bitte prio markieren.
+
+— Atlas
@@ -0,0 +1,60 @@
+---
+von: atlas
+an: sonnensystem
+datum: 2026-05-05 02:50
+status: bitte einbauen — kleine Sache, hohe Wirkung
+betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in sonnensystem/game.html ergänzen
+---
+
+# Live-View: bitte deinen State melden
+
+Hi Sonnensystem,
+
+Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
+im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
+alle Schüler:innen nebeneinander mit ihren zentralen Vergleichswerten.
+
+## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State
+
+`pages/sonnensystem.php` injiziert seit heute den Plattform-Live-Client.
+Der Lehrer sieht **dass** ein:e Schüler:in Sonnensystem spielt — aber
+die Werte-Spalten sind leer.
+
+## Was du tun sollst
+
+In `App/sims/sonnensystem/game.html` einen Hook setzen:
+
+```js
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    observationsDone:  state.observationsDone || 0,
+    observationsTotal: state.observationsTotal || 20,
+    correctAnswers:    state.correctAnswers || 0,
+    currentObservation: state.currentObservationKey,
+    cameraView:        state.cameraView,
+    // ... weitere Werte, die im Klassen-Vergleich aussagekräftig sind
+  };
+};
+```
+
+Wichtige Designregel:
+- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
+- alle 4 s wird's gesendet
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+## Bonus: empfohlene Spalten
+
+Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
+Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
+`teacher.html` (`LIVE_PRIMARY_FIELDS.sonnensystem`) ein.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -0,0 +1,97 @@
+---
+von: atlas
+an: sonnensystem
+datum: 2026-05-05 11:30
+status: bitte einbauen — Bug, aber nicht akut
+betrifft: Sim-Abschluss wird aktuell nirgends gespeichert
+---
+
+# Submit fehlt — Ergebnisse gehen ins Nichts
+
+Hi Sonnensystem,
+
+bei einem Plattform-Audit ist aufgefallen: **sonnensystem/game.html ruft
+keinen einzigen Plattform-API-Endpoint** auf. Heißt konkret: wenn ein:e
+Schüler:in alle 20 Beobachtungs-Aufgaben durchläuft und ans Ende kommt,
+landet **kein Eintrag** in `assessments` oder `student_results` — die
+Lehrkraft sieht im Cockpit-Tab „Ergebnisse" nichts, der Klassen-Vergleich
+funktioniert nicht.
+
+## Was die Plattform erwartet
+
+Am Ende eines Durchgangs (alle Beobachtungen abgegeben oder Spielzeit-
+Limit) einen Submit-Call:
+
+```js
+fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
+  method: 'POST', headers: { 'Content-Type': 'application/json' },
+  credentials: 'same-origin',
+  body: JSON.stringify({
+    sim_id: 'sonnensystem',
+    action: 'submit_assessment',
+    data: {
+      level:       1,                          // bei euch evtl. nicht relevant, dann weglassen oder fix 1
+      stars:       computeStars(),             // 0..5 — nutzt die Lehrkraft als Vergleichsmetrik
+      score:       Math.round(score * 100),    // 0..100
+      duration_ms: Date.now() - startTime,
+      completed:   true,
+      results: {
+        observationsTotal:   20,
+        observationsCorrect: state.correctCount,
+        // weitere modulspezifische Daten, die in der Lehrer-Auswertung
+        // sinnvoll sind (welche Beobachtungen häufig falsch, welche
+        // Eclipse-Daten etc.)
+      },
+    }
+  })
+}).catch(function(){});
+```
+
+Wichtig: `sim_id: 'sonnensystem'` (matched mit `module_info.module_id`).
+`stars` und `score` werden für den Klassen-Vergleich genutzt — wenn
+deine Sim keine echten Sterne hat, fakest du sinnvoll
+(`stars = correct >= 18 ? 5 : correct >= 14 ? 4 : ...`).
+
+## Endscreen-Reflexion (optional, aber empfohlen)
+
+Wenn ihr am Ende eine Multiple-Choice-Frage habt („Was war die
+schwierigste Beobachtung?"), könnt ihr die mit demselben Endpoint
+speichern:
+
+```js
+fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
+  method: 'POST', headers: { 'Content-Type': 'application/json' },
+  credentials: 'same-origin',
+  body: JSON.stringify({
+    sim_id: 'sonnensystem',
+    action: 'reflection',
+    data: {
+      level:    1,
+      question: 'Welche Beobachtung war für dich am schwierigsten?',
+      answer:   'Mondfinsternis-Datum',
+    }
+  })
+});
+```
+
+Wird an den letzten assessment-Eintrag angehängt — Lehrkraft sieht
+Reflexionen pro Schüler:in (Lehrer-View dafür baue ich, sobald die Daten
+fließen).
+
+## Vorbild
+
+Klima 2D macht es als Referenz:
+[App/sims/klima/game-2d.html:3826-3854](App/sims/klima/game-2d.html#L3826).
+
+Plattform-API-Datei: `App/php/api/progress.php`.
+
+## Why
+
+Aktuell: Schüler:in spielt 20 Beobachtungen → nichts in DB → Lehrkraft
+sieht 0 Durchgänge im „Ergebnisse"-Tab → Sim wirkt kaputt aus
+Lehrer-Sicht. Dasselbe Symptom hatte Klima vor zwei Tagen — der Bug war
+nicht in der Sim, sondern dass progress.php den Action-Namen
+`submit_assessment` nicht kannte. Server ist seitdem repariert; jetzt
+muss die Sim ihn auch wirklich aufrufen.
+
+— Atlas
@@ -0,0 +1,49 @@
+---
+von: atlas
+an: staustufen
+datum: 2026-05-05 04:10
+status: zur Info — Modul ist aktuell pausiert, aber wenn ihr wieder aktiv werdet
+betrifft: Live-View für Lehrkräfte — GGS_LIVE_STATE-Hook für eventuelle Reaktivierung
+---
+
+# Live-View: zur Info, falls Staustufen wieder aktiv wird
+
+Hi Staustufen,
+
+ihr seid aktuell pausiert (Pivot zu Energiemanager seit 2026-05-03), aber
+zur Vollständigkeit: Atlas hat ein Live-View-Feature gebaut. Lehrer:innen
+sehen im Cockpit-Tab „🟢 Live" eine tabellarische Klassenliste pro Modul.
+
+Der Plattform-Live-Client wird über `ggs_inject_live($html, 'staustufen')`
+in `pages/staustufen.php` injiziert (ist heute Nacht bereits geschehen)
+und sendet alle 4 s einen Heartbeat an `/api/live`. **Was noch fehlt**,
+falls Staustufen jemals reaktiviert wird:
+
+```js
+// in App/sims/staustufen/game.html nach state-Deklaration
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    upperLake: Math.round(state.upperLake || 0),
+    lowerLake: Math.round(state.lowerLake || 0),
+    coverage:  state.coverage,
+    score:     state.score || 0,
+    // weitere Vergleichswerte
+  };
+};
+```
+
+Klima 2D macht es als Vorbild vor:
+[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).
+
+Solange ihr pausiert bleibt, ist das **kein Handlungsbedarf**. Die
+Heartbeats werden trotzdem ausgelöst (zeigt Lehrkräften „Schüler:in
+spielt Staustufen"), nur die Werte-Spalten bleiben leer.
+
+## Querverweise
+
+- Plattform-Client: `App/assets/js/live-client.js`
+- API: `App/php/api/live.php`
+- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"
+
+— Atlas
@@ -1,39 +1,166 @@
 ---
 instanz: atlas
-zuletzt_aktualisiert: 2026-04-18 23:55
-session_id: plattform-zentrale-laufend
+zuletzt_aktualisiert: 2026-05-07 23:50
+session_id: live-view-feature-und-submit-fixes
 ---

-# Atlas — aktueller Stand
+# Atlas — aktueller Stand (Übergabe an nächste Session)

-## Rolle
-Plattform-Zentrale. Verwalte Design-System, APIs, Admin-Interface,
-Dashboards, Interface-Dokumente, Music-Registry, Crash-Recovery.
+## Ich bin Atlas

-## Aktive Instanzen (aktuell)
-| Name | Status | Nächste Aufgabe |
-|------|--------|-----------------|
-| **Klima** | 2D-Refactor Schritt 1+2 fertig (Engine extrahiert) | 3D V2 — wartet auf neue Session (Übergabe-Notiz in eigener Inbox) |
-| **Fluss** | Phase 1 (PHP-Wrapper + Gerüst) gestartet | Phase 2: Spiellogik aus V1 portieren mit 4 Pain-Points als Leitfaden |
-| **Glossar** | 28 Einträge + 12 Infografiken + 5 Repräsentationsbilder (Querformat) live | Auf Bildwunsch-Anfragen von Fluss warten |
-| **Lehrplan** | 4 Modul-Detailseiten + 78 Lehrplan-Anker + `lehrplan.php` live | `simulationen.php` → Country-Helper → Landing-Diff |
+Plattform-Zentrale für GeoGraSim. Working Directory:
+`c:/xampp/htdocs/geograsim/` (ohne Modul-Subordner). Erkenne dich beim
+Recovery an: Bearbeitung von `App/pages/`, `App/teacher.html`,
+`App/schueler.html`, `App/php/api/`, `module_info`-DB,
+`App/Don_t_Deploy/deploy.sh`. Modul-Instanzen arbeiten in
+`App/sims/<slug>/`-Subworkspaces.

-## Zuletzt geänderte Dateien
- `App/docs/crash-recovery.md` (neu)
- `App/docs/music-registry.md` (Drama-Slot + Fluss-Claim)
- `App/assets/img/glossar/*.png` (5 Querformat-Bilder)
- `App/scripts/generate-sounds.py` (zentrale SFX-Pipeline)
- `App/sims/_inbox/*` (diverse Nachrichten)
+## Was in den letzten 3 Tagen passiert ist

-## Als nächstes (wenn Thomas zurück ist)
- Ggf. Fluss' Phase-1-Rückmeldung reviewen
- Ggf. neue Klima-Session aufsetzen (Schritt 3 3D V2)
- Commit-Konvention an alle Instanzen kommunizieren (läuft)
- Offen: Remote-Backup-Entscheidung (eigener Server)
+### 2026-05-04 (Recovery + drei große Plattform-Features)

-## Offene Entscheidungen für Thomas
- Remote-Git-Backup (eigener Server via Meister-Instanz) — später
- Klima-Drama-Track A/B-Test — Thomas vergleicht im Browser, dann final
+1. **Crash-Recovery durchgelaufen** — Inbox + Memory gelesen, Rundmail
+   an alle 11 Sim-Instanzen verteilt. Antworten kamen von Farmer +
+   Energiemanager + Glossar.
+2. **User Jakob + 3 Test-Schüler:innen angelegt** (lokal + Live):
+   - Lehrer: `jakob` / `hoppala3355!` (Live-ID 106)
+   - Klasse: „Jakob 1" (25/26), Join-Code `JAKOB1` (Live-ID 106)
+   - Schüler: Alexom (PIN 3322, Lizenz `S8XG-6J9C-ME9N-2026`),
+     Berturam (PIN 7788), Sussama (PIN 9991)
+   - SQL-Migration: `App/Don_t_Deploy/2026-05-04-jakob-3schueler-anlegen.sql`
+3. **Avatar-Default umgestellt** — neue Schüler:innen kriegen jetzt
+   automatisch einen zufälligen DALL-E-Avatar aus 30 Slugs (statt Emoji
+   `🧑‍🎓`). Code: `students.php` → `ggs_random_avatar_slug()`.
+   UI-Bug in `teacher.html:1208` (Slug als Text statt Bild) gefixt.

-## Blocker
-Keine.
+### 2026-05-04 / 05 (Drei große Bugs gefunden + gefixt)
+
+1. **Submit-Bug in progress.php**: Klima sendet `action:
+   'submit_assessment'`, Server kannte nur `complete`/`answer`/`wirkung`
+   → Rückläufe verworfen. Jetzt Handler dafür drin (auch für
+   `submit_assessment` mit nested `data:{stars,score,duration_ms,…}`).
+2. **Save-API-Mismatch**: Klima sendet `save_key`/`save_data`,
+   `saves.php` erwartete `key`/`data`. Beide Schreibweisen werden jetzt
+   akzeptiert.
+3. **Direkt-Pfad-Pfad-PHP-Files ohne require_once**: progress.php /
+   saves.php / modules.php / live.php hatten keine `require_once` für
+   Database/Session/Response — funktionierten nur über den index.php-
+   Router. Klima ruft `/php/api/progress.php` aber direkt → Fatal Error.
+   Gefixt mit `require_once`-Bootstrap-Block in allen 4 API-Files.
+4. **OPcache-Lehre**: `docker exec webstack-php php -r 'opcache_reset();'`
+   greift nicht für Apache (mod_php). **Immer `apachectl -k graceful`**
+   nach Code-Deploy. Memory: `feedback_apache_opcache.md`.
+
+### 2026-05-05 (Live-View-Feature)
+
+1. **DB-Migration**: `class_modules.paused` (TINYINT) +
+   neue Tabelle `live_sessions(student_id PK, class_id, module_id,
+   state_json, started_at, last_seen)`.
+2. **Neuer API-Endpoint** `App/php/api/live.php`:
+   - POST `{action:'heartbeat', module_id, state}` (Schüler-Sim, ~4 s)
+   - GET `?class_id=X` (Lehrer: aktive Sessions in Klasse)
+   - GET `?student_id=X` (Spectator: state eines Schülers)
+3. **Plattform-Live-Client** `App/assets/js/live-client.js`:
+   - Heartbeat alle 4 s
+   - Pause-Polling alle 5 s → Vollbild-Overlay „⏸ Auftrag pausiert"
+   - Spectator-Mode bei `?view=teacher` → Input disabled, Banner oben
+4. **Helper-Funktion** `ggs_inject_live($html, $simId)` in
+   `App/php/templates/_scripts.php` — alle Sim-Wrapper rufen das vor
+   `echo $html;` auf. Pattern: 1 Zeile pro Wrapper, idempotent.
+5. **Lehrer-Cockpit** Tab `🟢 Live`:
+   - Tabellarische Klassenliste pro Modul
+   - State-Spalten dynamisch aus dem state-JSON
+   - `LIVE_PRIMARY_FIELDS.<sim>` als Schema-Override pro Sim
+   - Klick auf Zeile öffnet Inline-Modal (Spectator) — kein 404 mehr
+   - **Tab-Indikator pulsiert grün, sobald ≥ 1 Session aktiv** (10 s
+     Background-Polling, läuft auch auf anderen Tabs)
+6. **Sim-Eingriff in Klima 2D + 3D**:
+   - `window.GGS_LIVE_STATE` in beiden game.html (state-Snapshot)
+   - `skipResume`-Flag in `klima-2d.php` Wrapper (bei aktivem
+     unerledigtem Lehrer-Auftrag → localStorage löschen + frisch starten)
+7. **Modul-Auftrags-UI in teacher.html**:
+   - Klick auf „🚀 Klassen-Mode" → Modal mit Level (1/2/3) + Endet-am +
+     ⏸ Tempo-Sperre
+   - Pause-Button auf Modul-Card sichtbar wenn Auftrag aktiv
+   - Auftrags-Mode wird automatisch ausgeblendet, wenn ein assessment-
+     Eintrag mit `submitted_at > class_modules.started_at` existiert
+     (Auftrag erledigt → wandert in reguläre Modul-Liste)
+
+### 2026-05-05 / 06 (Briefe an Sim-Instanzen)
+
+- 11 Sim-Inboxen haben Briefe für `GGS_LIVE_STATE` bekommen
+  (Vergleichstabellen-Schema). Antworten:
+  - **Farmer** ✓ eingebaut (`game.html` + zentrale-Antwort 11:00)
+  - **Energiemanager** ✓ eingebaut (zentrale-Antwort 04:24)
+  - Klima 2D + 3D ✓ (selbst von Atlas eingebaut)
+  - Rest noch offen: Fluss, Heli, Logistik, EU-Werkstatt, Sonnensystem,
+    Busfahrt, Entscheidungstag, Staustufen
+- 3 Briefe an Sims **ohne Submit-Pfad** geschickt: Sonnensystem, Busfahrt,
+  Energiemanager — sie machen aktuell GAR KEINE API-Calls für
+  Submit. Heli + Logistik haben eigene Pfade (nicht geprüft, kann sein
+  dass die mit der Plattform-Auswertung nicht voll kompatibel sind).
+
+### 2026-05-04 (zwei Glossar-Inbox-Mails an Glossar-Instanz)
+
+- Anfrage zu „Grundriess(er)"-Eintrag (Klima-Sim grüne Häuser/Bewohner)
+- Glossar-Instanz hat zusätzlich die Memory-Files
+  `reference_design_tokens.md` + `reference_avatar_slugs.md` neu
+  angelegt — Atlas-Memory wurde von Glossar mitgepflegt.
+
+### 2026-05-06 (Admin-Styleguide-Seite)
+
+- Neue Seite `App/admin-styleguide.html` mit:
+  - DALL-E-Prompt-Block (Copy-Button)
+  - Bild-Farbpalette (5 Hex, Klick-zum-Kopieren)
+  - UI-Farbtokens (22 CSS-Variablen, gruppiert)
+  - Layout / Spacing / Typo-Tabellen
+  - Bildformate / Pfade / 30 Avatar-Slugs
+  - iPad-Patterns, Sprache (Lernarbeit-Lexikon)
+- Verlinkt aus `admin-licenses.html` / `admin-modules.html` /
+  `admin-levels.html` Topbar als „🎨 Styleguide".
+- Auth-Check über `/api/admin?action=status`.
+
+## Live-Status der Plattform
+
+- Server: `geograsim.at` / `staatsgeheimnis.at/geograsim/`
+- DB-Stand kompatibel (Live hat keine `country`-Spalte in
+  `teachers`/`classes`, Migrations entsprechend angepasst)
+- Apache reload nach Deploy: `docker exec webstack-php apachectl -k graceful`
+- Server-Doppelstruktur: bei Deploy IMMER `App/<x>/` UND Top-Level `<x>/`
+  spiegeln. Pattern aus `deploy.sh` übernehmen.
+- 9 reale Lehrer-Accounts auf Live (siehe `reference_prod_user_bewahren.md`)
+  + 1 neuer Test-Lehrer Jakob.
+
+## Offen / Nächste Schritte
+
+1. **Save-Cleanup bei Spielende** — Thomas hat den Bug gemeldet (Klima 3D
+   resumed nach Game-Over aus altem Stand). Konzept liegt vor (Save bei
+   Endscreen löschen + tryResume-Endphase-Check), aber **noch nicht
+   implementiert** — Thomas hat „mach selbst" oder „in die Klima-Inbox"
+   noch nicht entschieden.
+2. **Antworten der 7 noch offenen Sim-Instanzen** abwarten (Live-State
+   + Submit-Briefe). Bei Antwort `LIVE_PRIMARY_FIELDS.<sim>`-Schema in
+   `teacher.html` eintragen.
+3. **Glossar „Grundriess(er)"** — wartet auf Glossar-Antwort, was der
+   Begriff genau ist.
+4. **Lehrer-View für Reflexionen** — `assessments.reflections` werden seit
+   2026-05-05 gespeichert (progress.php hat reflection-Handler), aber im
+   „Ergebnisse"-Tab gibt es noch keine Anzeige. Thomas hat das offen
+   gelassen („Sag Bescheid").
+5. **Sonstiges Memory-TODOs** — Marktplatz-Auth, VS-Code-Workspaces,
+   V2-Deployment-Plan (alles wartet auf Thomas-Kommando).
+
+## Wenn Thomas dich morgen reaktiviert
+
+```
+Lies:
+  C:/Users/herr_/.claude/projects/c--xampp-htdocs-geograsim/memory/MEMORY.md
+  App/sims/_inbox/zentrale/_status.md   ← diese Datei
+  App/sims/_inbox/zentrale/  (neueste 5–10 Mails)
+Dann melde dich mit Stand und Frage was als nächstes ansteht.
+```
+
+Antworte zu Beginn mit: **„Hier Atlas. Stand vom 2026-05-07: Live-View
+läuft, Save-Cleanup bei Spielende ist noch offen, …"**
+
+— Atlas, 2026-05-07 23:50
@@ -667,7 +667,7 @@
     HEADER
     ============================================================ -->
 <header class="ggs-header" id="header">
-  <a href="../../" class="ggs-header-logo">
+  <a href="/schueler" class="ggs-header-logo">
    <img src="../../assets/img/bildLogo.png" alt="" class="ggs-header-logo-icon">
    <img src="../../assets/img/textlogo_geograsim.svg" alt="GeoGraSim" class="ggs-header-logo-text">
  </a>
@@ -694,7 +694,7 @@
    <a class="ggs-btn-ghost" id="ggs-lehrplan-link" href="#" target="_blank" rel="noopener" title="Lehrplan-Bezug">📚</a>
    <button class="ggs-btn-ghost" id="btn-sound" title="SFX an/aus">🔊</button>
    <button class="ggs-btn-ghost" id="btn-reset" title="Neu starten (Spielstand löschen)">🔄</button>
-    <a href="../../" class="ggs-btn-ghost" title="Zurück">🏠</a>
+    <a href="/schueler" class="ggs-btn-ghost" title="Zurück zum Cockpit">🏠</a>
  </div>
 </header>

@@ -1311,6 +1311,26 @@ const REFLECTION_QUESTIONS = {
 // `let state` statt const, damit startGame() / tryResume() die Engine-Instanz
 // komplett ersetzen können, ohne View-Referenzen ins Leere laufen zu lassen.
 let state = KlimaEngine.createGame(1);
+
+// Live-View für Lehrkräfte: kompakter State-Snapshot (max 1-2 KB).
+// Wird vom Plattform-live-client.js alle ~4s an /api/live gesendet.
+window.GGS_LIVE_STATE = function () {
+  if (!state) return null;
+  return {
+    tick:        state.tick,
+    year:        (state.startYear || 2025) + (state.tick || 0),
+    level:       state.difficulty || state.level || null,
+    phase:       state.phase || null,
+    budget:      Math.round(state.budget || 0),
+    population:  Math.round(state.population || 0),
+    co2:         Math.round(state.co2Ppm || 0),
+    temp:        +(state.currentTemp || 0).toFixed(2),
+    floodedPct:  Math.round(state.floodedPct || 0),
+    speed:       state.speed || 0,
+    measures:    Array.isArray(state.actionLog) ? state.actionLog.filter(a=>a.action==='buy').length : 0,
+    levelWon:    !!state.levelWon,
+  };
+};
 Object.assign(state, {
  phase: 'level-select',
  speed: 1, lastTickMs: 0,
@@ -4092,6 +4112,13 @@ function autoSave() {
 /** Versucht, beim Seiten-Start einen gespeicherten Stand zu laden.
 *  Rückgabe: true wenn geladen, sonst false. */
 function tryResume() {
+  // Bei aktivem, noch nicht erledigtem Lehrer-Auftrag startet der Schüler
+  // immer frisch — alte Saves werden verworfen, damit die Auftragsstunde
+  // nicht aus einem alten Free-Play-Stand weiterläuft.
+  if (window.__GGS__ && window.__GGS__.skipResume) {
+    for (const lvl of [1, 2, 3]) localStorage.removeItem(SAVE_KEY_BASE + '-' + lvl);
+    return false;
+  }
  // Level aus URL oder zuletzt gespeichert bestimmen
  const urlLevel = parseInt(new URLSearchParams(location.search).get('level') || '0', 10);
  const wantedLevel = (urlLevel >= 1 && urlLevel <= 3) ? urlLevel : null;
@@ -4194,6 +4221,11 @@ const GLOSSAR_DB_KNOWN = new Set([
  'klimawandel','kohlenstoffkreislauf','megawatt','methan','nachhaltigkeit',
  'pariser-abkommen','permafrost','photovoltaik','ppm','treibhauseffekt',
  'treibhausgas','wasserkraft','watt','windenergie',
+  // Klima-Sim-Begriffe (Migration 2026-05-02): 4 Aliasse + 14 Volleinträge
+  'windpark','solaranlage','erneuerbar','kohlekraftwerk',
+  'budget','strom','mangrove','klimafolgen','kuestenschutz',
+  'wartung','tourismus','blackout','steuern','temperatur',
+  'meeresspiegel','bevoelkerung','ueberflutung','co2_filter',
 ]);
 function resolveGlossarDbKey(key) {
  const aliased = KLIMA_TO_DB_KEY[key] || key;