- Konzept/, didaktik_geografie/, didaktik_simulation/, v2-modules/, v2-platform/ - 12 code-workspace-Files - STATUS-*.md - viele M/D/R-Änderungen an bereits getrackten Files - .gitignore verstärkt: **/.humaninput/, **/secret_keys.txt Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2.7 KiB
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)