# GeoGraSim · Projektkonventionen (Codex-Briefing)

## Sprachregeln (verbindlich)

| Statt | Verwende |
|---|---|
| spielen, Spiel, Spieler:in | arbeiten mit, Simulation, Bearbeiter:in |
| Lehrkraft | **Lehrperson** |
| Schüler/Schülerin | Schüler:innen, alternativ Schüler*innen |

**Hintergrund**: Bildungstheoretisch basiert das Projekt auf Wygotskis
Lerntätigkeit-Konzept. „Lernarbeit" ist explizite Wortwahl — Lernende sind
nicht Spieler:innen, sondern Bearbeiter:innen einer Aufgabe.

## Lehrplan-Anbindung

| Land | Bezeichnung | Quelle |
|---|---|---|
| 🇦🇹 AT | „Geografie und wirtschaftliche Bildung" | BGBl. II Nr. 1/2023 |
| 🇨🇭 CH | RZG / WAH / NMG / Medien und Informatik (MI) | LP21 (lehrplan.ch) |
| 🇩🇪 DE | Erdkunde/Geographie · Politik · Wirtschaft | KMK + NRW + Niedersachsen + Bayern + DGfG/VGDH |
| 🇱🇮 LI | wie CH | Lehrplan Liechtenstein |

**Kürzel**: GW = „Geografie und wirtschaftliche Bildung" (vorher
„Geographie und Wirtschaftskunde"). Im Volltext immer ausschreiben,
GW als Kürzel OK.

**Wichtig CH-Korrektur**: das Informatik-Fach in CH heißt **„Medien und
Informatik (MI)"** — NICHT „Informatische Bildung". Letzteres ist AT-Spezifikum.

## Bildstil

- **Flat Scandinavian** (skandinavische Flachgrafik)
- **Hauptfarben**: #1f4b37 (dunkelgrün) · #4a7c4e (mittelgrün) · #e8c547 (gold) · #e8e4d8 (creme)
- Generierung über DALL-E 3 / gpt-image-2 lokal (nicht im Produkt!)

## Keine KI im Produkt

Sehr wichtig für Codex-Bewertung: alle Auswertungen sind **parametrisch**.
- Klima-Score = Formel aus 4 Dimensionen, kein „LLM bewertet"
- Heli-Sterne = `planCorrect/planTotal × Faktor`
- Glossar-Erklärungen sind in DB redaktionell gepflegt, nicht LLM-generated

KI darf nur in der **Content-Erstellungs-Pipeline** ein
(Bildgenerierung, Glossar-Bilder, Text-to-Speech für Audio-Briefings,
Dispatcher-Stimme bei Heli).

Wenn dir auffällt, dass irgendwo eine LLM-Anbindung „live" zur Sim-Zeit
laufen sollte: das ist ein Showstopper, bitte als „Schwer" markieren.

## Zielgerät

iPad Landscape 1180 × 820 (Hauptzielgerät). Touch-Mindestziel 36px.
Hover-Effekte dürfen NIE essentiell sein. Keyboard funktioniert
natürlich auch, aber das ist nicht Hauptpfad.

## Live-Daten (Lehrer-Cockpit)

Jede aktive Sim exponiert `window.GGS_LIVE_STATE = function(){...}` —
eine Plattform-Lib (`live-client.js`) ruft das alle 4 s ab und sendet
den State an `/api/live` als Heartbeat. Die Lehrperson sieht im Cockpit
unter `/teacher` Live-Werte aller aktiven Schüler:innen.

Stand der Integration:
- 11 von 12 Sims liefern voll
- Entscheidungstag ist noch nicht in der Plattform registriert
  (kein `module_info`-Eintrag, kein Wrapper)