Files
Adminator 1e51ef7def Nachtrag: alle bisher untracked Ordner + hängende Änderungen mit-committen
- 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>
2026-07-08 02:27:02 +02:00

2.3 KiB

GeoGraSim · Glossar-Pattern (Codex-Briefing)

Was ist das Glossar?

Eine zentrale Begriffsdatenbank (Stand 2026-06-11: 266 Slugs). Jeder Eintrag hat:

  • Standardsprache (Sek-I-Niveau, 2-3 Sätze)
  • Leichte Sprache (A1-A2, kurze Sätze, einfache Wörter)
  • Modul-Verknüpfungen: in welchen Sims kommt der Begriff vor
  • Bild oder SVG (wo passend)
  • Wikipedia-Link zum Weiterlesen

Tooltip-Pattern (überall in der Plattform)

In jeder Sim und auf jeder Inhalts-Seite werden Fachbegriffe als:

<span class="ggs-g" data-glossar="meeresspiegel">Meeresspiegel</span>

oder

<span data-glossar="meeresspiegel">Meeresspiegel</span>

markiert. Beim Klick öffnet sich ein Tooltip-Popup mit:

  • Begriff-Titel
  • Kurze Definition
  • Link „Voller Glossar-Eintrag →" auf /glossar?term=<slug>

Bug-Historie (wichtig für Review)

Zwei Bugs auf Prod sichtbar:

  1. Tooltip-Lib (App/assets/js/glossar-tooltip.js): Der Regex apiBase.replace(/\/api$/, '') schnitt aus /php/api nur das letzte /api ab → resultierender Link /php/glossar?term=… → 404. Fix: erst /php/api strippen, dann /api.

  2. Klima 2D/3D (App/sims/klima/game-2d.html und game-3d.html): __GGS__.basePath ist auf Prod ein leerer String "". Truthy-Check (__GGS__.basePath ? basePath : fallback) fiel deshalb fälschlich auf den Fallback /geograsim/App zurück. Fix: typeof basePath === 'string' statt Truthy-Check.

Diese beiden Bugs werden im Playwright-Smoke-Test glossar-tooltip-regression.spec.js abgefragt. Wenn die Tests grün sind, ist der Bug zumindest mechanisch nicht zurück.

Was Codex prüfen kann (semantisch)

  • Sind Begriffe verständlich auf Sek-I-Niveau erklärt?
  • Funktioniert die Leichte-Sprache-Variante wirklich auf A1-A2-Niveau?
  • Sind die Modul-Verknüpfungen sinnvoll? (Ein Begriff der nur in Heli vorkommt, sollte auch nur dort verknüpft sein. Ein übergreifender Begriff wie „CO₂" sollte in vielen Sims verknüpft sein.)
  • Gibt es Begriffs-Dopplungen (gleicher Begriff in zwei Slugs)?
  • Stimmt der Bildstil mit der Flat-Scandinavian-Linie überein?

Was Codex NICHT prüfen kann (außerhalb deines Scope)

  • Datenbank-Performance, Indizes
  • SQL-Injection-Hardening (das macht Atlas)
  • Cache-Strategie