# 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