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>
63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
# 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:
|
|
```html
|
|
<span class="ggs-g" data-glossar="meeresspiegel">Meeresspiegel</span>
|
|
```
|
|
oder
|
|
```html
|
|
<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)
|
|
|
|
### 2026-06-10 · Tote Glossar-Links — JETZT GEFIXT
|
|
|
|
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
|