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>
297 lines
13 KiB
Markdown
297 lines
13 KiB
Markdown
# 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/`.
|