geograsim/App/docs/content-architecture.md

# GeoGraSim — Informationsarchitektur & Content-Spezifikation

Dieses Dokument beschreibt die öffentlichen und didaktischen Inhalte von
GeoGraSim (Landing Page, Modul-Detailseiten, Lehrplan-Bezug, Glossar). Es
richtet sich an die Content-Instanz, die diese Seiten erstellt.

---

## 1. Drei Benutzer-Pfade

```
ANONYM                         SCHÜLER:IN                   LEHRPERSON
──────                         ──────────                   ──────────
Landing Page (index.html)      Mein Dashboard               Klassen-Dashboard
  ↓ Überblick                    (schueler.html)              (teacher.html)
  ↓ "Sofort ausprobieren"         ↓ Meine Module               ↓ Modulfreigabe
  ↓ Für Lehrpersonen              ↓ Badges, Fortschritt        ↓ Ergebnisse
  ↓ Für Schüler:innen
                               Profil                       Lehrplan-Matching
Simulationen-Übersicht                                        (neu, pro Modul)
  ↓ Cards je Modul             Glossar (mit Markierung
                                 "schon gelernt")
Modul-Detailseite (NEU)        
  ↓ Was lerne ich?             
  ↓ Welche Begriffe?           
  ↓ Lehrplan-Bezug             
  ↓ Jetzt probieren            

Glossar (wird parallel gebaut)

Lehrplan-Seite (NEU)
  ↓ AT / DE / CH / LI Filter
  ↓ Kompetenz-Mapping
  ↓ Welches Modul passt wohin
```

---

## 2. Kern-Prinzip: Kompetenz-Brücke

**Problem:** DACH+LI haben zusammen ~40 verschiedene Lehrpläne (Bundesländer,
Kantone, Schultypen). Alle einzeln zu pflegen ist nicht leistbar.

**Lösung:** Module werden auf **didaktische Kompetenzbereiche** gemappt, nicht
auf einzelne Lehrpläne. Jeder Lehrplan referenziert ähnliche Kompetenzen — die
Lehrperson erkennt den Bezug selbst.

Beispiel:
```
Kompetenzbereich: "Klimawandel verstehen"
  ├── Modul: Klimawächter 2D (Level 1–3)
  ├── Modul: Klimawächter 3D (Level 1–3)
  │
  └── Lehrplan-Anker:
      ├── 🇦🇹 AT Mittelschule GW, Kl. 8 — "Anthropogener Klimawandel"
      ├── 🇩🇪 DE Berlin GL, Kl. 9 — "Klimawandel als globale Herausforderung"
      ├── 🇨🇭 CH Lehrplan 21, NMG.3.2 — "Klima und Wetter"
      └── 🇱🇮 LI 7. Schulstufe GW — "Naturphänomene und Klimasystem"
```

Die Lehrperson sieht: "Ja, passt zu meinem Lehrplan-Punkt" und weiß, dass das
Modul didaktisch fundiert zugeordnet ist.

---

## 3. Datenbank-Schema (Vorschlag — abstimmen mit Zentrale)

```sql
-- Didaktische Kompetenzbereiche (zentrale Brücke)
CREATE TABLE kompetenzen (
  id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  key_slug VARCHAR(64) NOT NULL UNIQUE,    -- 'klimawandel', 'raumplanung'
  title VARCHAR(128) NOT NULL,              -- 'Klimawandel verstehen'
  description TEXT,                         -- Didaktisch ausformuliert (3-5 Sätze)
  category VARCHAR(32),                     -- 'klima', 'raum', 'gesellschaft'
  age_min TINYINT UNSIGNED,                 -- 10 (Klasse 5)
  age_max TINYINT UNSIGNED,                 -- 16 (Klasse 10)
  sort_order INT DEFAULT 0
);

-- Modul ↔ Kompetenz (N:M)
CREATE TABLE kompetenz_modules (
  kompetenz_id INT UNSIGNED NOT NULL,
  module_id VARCHAR(16) NOT NULL,           -- 'klima', 'heli', 'fluss', 'stadt'
  level TINYINT UNSIGNED,                   -- 1, 2, 3 (optional)
  strength ENUM('primär', 'sekundär') DEFAULT 'primär',
  PRIMARY KEY (kompetenz_id, module_id, level),
  FOREIGN KEY (kompetenz_id) REFERENCES kompetenzen(id) ON DELETE CASCADE
);

-- Lehrplan-Anker pro Kompetenz
CREATE TABLE lehrplan_anchors (
  id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  kompetenz_id INT UNSIGNED NOT NULL,
  country CHAR(2) NOT NULL,                 -- 'AT', 'DE', 'CH', 'LI'
  region VARCHAR(32),                       -- Bundesland/Kanton (optional)
  school_type VARCHAR(32),                  -- 'MS', 'AHS', 'Gym', ...
  grade VARCHAR(16),                        -- 'Kl. 8', '7.-8. Stufe'
  title VARCHAR(255),                       -- 'Anthropogener Klimawandel'
  reference VARCHAR(255),                   -- Offizielle Lehrplan-Referenz/URL
  quote TEXT,                               -- Exaktes Zitat aus dem Lehrplan
  FOREIGN KEY (kompetenz_id) REFERENCES kompetenzen(id) ON DELETE CASCADE,
  INDEX (country, school_type, grade)
);

-- Modul-Metadaten (für Detailseiten)
CREATE TABLE module_info (
  module_id VARCHAR(16) NOT NULL PRIMARY KEY,
  title VARCHAR(128) NOT NULL,              -- 'Klimawächter'
  subtitle VARCHAR(255),                    -- 'Klima retten, Küste schützen'
  short_desc TEXT,                          -- 1-2 Sätze für Card
  long_desc TEXT,                           -- Ausführlich für Detailseite
  learning_goals TEXT,                      -- JSON-Array oder Markdown
  duration_min INT UNSIGNED,                -- Geschätzte Spieldauer in Minuten
  age_min TINYINT UNSIGNED,
  age_max TINYINT UNSIGNED,
  icon VARCHAR(16),                         -- Emoji
  card_image VARCHAR(255),                  -- card-climate.png etc.
  status ENUM('aktiv', 'beta', 'archiv') DEFAULT 'beta',
  sort_order INT DEFAULT 0
);
```

---

## 4. Arbeitsbereich Content-Instanz

### SCHREIBEN
- `App/pages/modul-klima.php` — Detailseite Klimawächter
- `App/pages/modul-heli.php` — Detailseite Heli
- `App/pages/modul-fluss.php` — Detailseite Fluss
- `App/pages/modul-stadt.php` — Detailseite Stadt
- `App/pages/lehrplan.php` — Lehrplan-Übersicht mit Filtern
- `App/pages/simulationen.php` — Übersichtsseite aller Module (ersetzt evtl. eine Section auf der Landing)
- DB-Tabellen: `kompetenzen`, `kompetenz_modules`, `lehrplan_anchors`,
  `module_info` (über PHP/PDO, nicht via mysql.exe — Umlaute!)

### LESEN
- Gesamtes Projekt
- `App/docs/module-interface.md`
- `App/docs/content-architecture.md` (dieses Dokument)
- Bestehende Module zum Verstehen des Inhalts

### NICHT ANFASSEN
- Module selbst (`App/sims/...`)
- Glossar (macht die Glossar-Instanz) — aber du darfst Glossar-Einträge per
  Inbox an Glossar-Instanz anfragen, wenn sie für Modul-Detailseiten nützlich
  sind
- Landing Page (`index.html`, `index.php`) — du darfst Änderungs-Vorschläge
  per Zentrale-Inbox schicken, aber nicht selbst editieren
- Design-System, Admin, APIs

---

## 5. Recherche-Quellen für Lehrpläne

### Österreich
- Lehrplan Mittelschule (BMBWF): https://www.bmbwf.gv.at → Unterricht → Lehrpläne
- Lehrplan AHS Unterstufe
- GW (Geographie und Wirtschaftsbildung) steht seit 2023 neu strukturiert

### Deutschland
- Konzentration auf große Bundesländer + neutrale Lehrplan-Kernelemente
- Bildungsstandards KMK (Kultusministerkonferenz) als Dach
- Pro Bundesland evtl. nur 1–2 Referenzen

### Schweiz
- Lehrplan 21 (21 Kantone, gemeinsame Struktur)
- NMG (Natur, Mensch, Gesellschaft) in Sek I, RZG (Räume, Zeiten, Gesellschaften)

### Liechtenstein
- Eigener Lehrplan, lehnt sich stark an CH an
- Lehrplan FL ab 2012 (LiLe)

### Prinzip der Recherche
**Weniger Tiefe, mehr Breite.** Für jede Kompetenz **3–5 Anker** aus
verschiedenen Ländern. Nicht alle 16 Bundesländer + 26 Kantone einzeln. Die
Lehrperson muss das Modul als lehrplankonform erkennen, nicht den exakten
Paragrafen finden.

---

## 6. Modul-Detailseiten: Struktur

Jede Modul-Detailseite (z.B. `modul-klima.php`) hat:

```
┌────────────────────────────────────────────────┐
│ HEADER (bildLogo + textlogo + Navi)            │
├────────────────────────────────────────────────┤
│                                                │
│ HERO-BEREICH                                   │
│ ┌──────────┐  🌍 KLIMAWÄCHTER                 │
│ │ Card-Bild│  Klima retten, Küste schützen.   │
│ │ (DALL-E) │  [Sofort probieren]              │
│ └──────────┘  [Für Lehrpersonen: Lehrplan-     │
│                Bezug]                           │
│                                                │
│ META-ANGABEN                                   │
│ Dauer: 30-45 Min · Alter: 12-16 · 3 Levels    │
│                                                │
├────────────────────────────────────────────────┤
│ WAS LERNST DU?                                 │
│ [Lernziel 1] [Lernziel 2] [Lernziel 3]        │
│ (Aus learning_goals, als Bullet-Liste)         │
│                                                │
├────────────────────────────────────────────────┤
│ WIE FUNKTIONIERT'S?                            │
│ Ausführliche Beschreibung der Spielmechanik,  │
│ evtl. mit Screenshots / GIFs                   │
│                                                │
├────────────────────────────────────────────────┤
│ BEGRIFFE DIE DU KENNENLERNST                   │
│ (Aus glossar-Tabelle: alle Einträge           │
│ mit module='klima')                            │
│ [CO₂] [ppm] [Watt] [Megawatt] [Windpark] ...   │
│ → Kleine Chips mit Hover-Definition            │
│                                                │
├────────────────────────────────────────────────┤
│ LEHRPLAN-BEZUG                                 │
│ [🇦🇹] [🇩🇪] [🇨🇭] [🇱🇮]                        │
│                                                │
│ Kompetenzbereich: Klimawandel verstehen        │
│   → AT MS GW Kl. 8: "Anthropogener Klimawandel"│
│   → DE Berlin GL Kl. 9: "Klimawandel global"   │
│   → CH NMG.3.2: "Klima und Wetter"             │
│                                                │
├────────────────────────────────────────────────┤
│ FOOTER (wie alle Seiten)                       │
└────────────────────────────────────────────────┘
```

---

## 7. Lehrplan-Übersichtsseite (`lehrplan.php`)

```
┌────────────────────────────────────────────────┐
│ HEADER                                         │
├────────────────────────────────────────────────┤
│ LEHRPLAN-BEZUG                                 │
│                                                │
│ Land: [Alle] [🇦🇹 AT] [🇩🇪 DE] [🇨🇭 CH] [🇱🇮 LI]│
│ Stufe: [Alle] [Sek I] [Sek II]                 │
│ Thema: [Alle] [Klima] [Raum] [Gesellschaft]    │
│                                                │
├────────────────────────────────────────────────┤
│ GRUPPIERT NACH KOMPETENZBEREICH               │
│                                                │
│ ▸ Klimawandel verstehen                        │
│   🌍 Klimawächter 2D · 🌍 Klimawächter 3D      │
│   🇦🇹 AT MS GW Kl. 8 — "Anthropogener..."       │
│   🇩🇪 DE Berlin GL Kl. 9 — "Globale..."         │
│   🇨🇭 CH Lehrplan 21 NMG.3.2                    │
│                                                │
│ ▸ Naturgefahren und Hochwasser                 │
│   🏞️ Flussmanagement                            │
│   🇦🇹 ... 🇩🇪 ... 🇨🇭 ... 🇱🇮 ...              │
│                                                │
│ ▸ Alpine Geografie                             │
│   🚁 Heli-Navigation                            │
│                                                │
│ ▸ Stadtplanung und Raumordnung                 │
│   🏙️ Stadt & Raumplanung                        │
│                                                │
└────────────────────────────────────────────────┘
```

---

## 8. Landing-Page-Ergänzungen (Vorschlag an Zentrale)

Die Landing Page (`index.html`) sollte minimal ergänzt werden:

- Link zum Glossar im Footer oder als eigene Section
- Link zur Lehrplan-Seite im Lehrpersonen-Bereich
- Simulations-Cards sollen auf die neuen Modul-Detailseiten verlinken
  (nicht direkt ins Spiel) — ausser der Gast probiert direkt

**Du änderst die Landing NICHT selbst** — du schickst einen konkreten
Änderungs-Vorschlag (mit Code-Diff) per Nachricht an `zentrale/`, die
Zentrale integriert das.

---

## 9. Erste Schritte

1. Dieses Dokument lesen
2. DB-Schema vorschlagen / mit Zentrale abstimmen (Inbox-Nachricht)
3. `kompetenzen`, `module_info` etc. per PHP-Script anlegen
4. Ersten Modul-Detailseite (`modul-klima.php`) als Template bauen
5. Die anderen Modul-Seiten nachziehen
6. Lehrplan-Recherche für AT + Lehrplan 21 (CH/LI) starten
7. `lehrplan.php` mit echten Ankern befüllen

Bei Fragen oder DB-Änderungen: Nachricht in `App/sims/_inbox/zentrale/`.