Adminator
1e51ef7def
- 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>
68 lines
2.7 KiB
Markdown
68 lines
2.7 KiB
Markdown
# 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)
|