# GeoGraSim · Quick-Overview für Codex

## Tech-Stack

- **Backend**: PHP 8.x + MariaDB (via XAMPP lokal / Docker auf Prod)
- **Frontend**: Vanilla JS + HTML + CSS (kein Build-Step, keine Framework-Abhängigkeit)
- **Karten**: Leaflet 1.9.4
- **3D** (Klima 3D, Sonnensystem): Three.js
- **Audio**: ElevenLabs für Sprach + SFX (Pipeline, nicht zur Laufzeit)
- **Tests**: Playwright (neu 2026-06-11)

Bewusst **kein React/Vue/TypeScript** — Begründung: Lehrpersonen sollen
ggf. selbst kleine Anpassungen machen können, ohne Build-Toolchain. Plus:
Hosting auf Standard-Apache, keine Node-Pipeline auf Prod.

## URL-Struktur (Auswahl)

| URL | Was |
|---|---|
| `/` | Landing |
| `/teacher` | Lehrer-Cockpit (SPA-ähnlich) |
| `/schueler` | Schüler:innen-Dashboard |
| `/login` | Login |
| `/lehrplan` | Lehrplan-Übersicht (261 Anker, filterbar nach Land + Modul) |
| `/glossar` | Glossar-Index |
| `/glossar?term=<slug>` | einzelner Begriff (Detail-Modal) |
| `/handbuch.html` | Lehrer-Handbuch (12 Sims dokumentiert) |
| `/modul-<sim>` | Modul-Info-Seite (eine pro Sim) |
| `/<simname>` | Sim selbst (z. B. `/klima-2d`, `/weltkueche`) |
| `/api/<endpoint>.php` | JSON-APIs |

## Wichtige Stand-Notizen

- **Live-Cockpit** (`/teacher` → Tab „Live" → „🎯 Cockpit") ist NEU
  (2026-06-11): Status-Tiles, Top-3/Bottom-3, Klassen-Säulen, Schülerliste
- **Fleiß-Säulen-Matrix** (`/teacher` → Tab „Ergebnisse" → oberste Sektion):
  pro Schüler:in eine Zeile, Säulen pro Zeitbucket, gestapelt nach Modul
- **Weltküche** ist seit 2026-06-08 die neuste Sim, mit NEU-Pill markiert
- **Fluggesellschaft** ist `status='geplant'` — taucht im normalen
  Schüler-Flow nicht auf, aber Wrapper existiert
- **Entscheidungstag** existiert auf Disk, ist aber NICHT in `module_info`
  registriert — wird nicht geheartbeated und nicht als Sim ausgespielt

## Was Codex testen kann

- Browser-Sicht jeder Sim (alle ohne Login als „Gast" zugänglich)
- Lehrer-Cockpit (Login nötig — frag Thomas)
- Glossar + Lehrplan + Handbuch + Mindmap
- Performance auf iPad-Größe simuliert (Playwright-Devtools)

## Was Codex NICHT testen kann

- Reale Klassen-Sessions mit echten Schüler:innen
- Lehrer-Dashboard mit „vielen aktiven Sessions" — wir haben heute
  unter Test nicht so viele aktive User
- E-Mail-Versand (Ticketing-System ist nicht öffentlich)

## Was Codex bei Atlas anfragen kann (über Thomas)

- Memory-Auszüge zu spezifischen Themen
- Code-Auszüge wenn das Review-Material nicht ausreicht
- Klärung von Konventionen, die nicht im Briefing stehen

— Atlas