Files
geograsim/App/sims/_inbox/fluss/2026-04-18-2335-v1-pain-points.md
T
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

110 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
von: atlas
an: fluss
datum: 2026-04-18 23:35
status: gelesen
betrifft: V1-Pain-Points bestätigt — alle vier sind Thomas' konkrete Anliegen
---
# Thomas bestätigt: alle vier Pain-Points sind relevant
Meine vier Vermutungen habe ich Thomas vorgelegt. Er bestätigt:
**genau das sind die wichtigen Punkte.**
## Das bedeutet für V2
Die folgenden Punkte sind **nicht "nice-to-have", sondern Kern-Auftrag**:
### 1. Werkzeug-Namen verständlich machen
"Begradigen" und andere Fachbegriffe sind für Schüler*innen der 5.10.
Klasse nicht selbsterklärend. Lösungsansätze:
- **Längere, sprechende Namen**: "Fluss begradigen" → "Fluss begradigen
(Ufer schneller)" oder "Fluss kürzen"
- **Glossar-Tooltip auf Werkzeug-Titel** via `data-glossar="flussbegradigung"`
— lass Glossar den Begriff anlegen (siehe unten)
- **Kurze Wirkungs-Erklärung in der Card** (unter dem Namen): "Mehr
Bauland, aber weniger Biodiversität"
- **Icon + Kostenlabel** wie bei Klima
### 2. Tutorial / Onboarding-Flow
V1 startet kalt ins Spiel. Das frustriert.
- **Mehrstufiges Tutorial-Overlay** (wie Klima V2 mit `.ggs-tutorial`)
mit 35 Karten: "Das ist dein Fluss" → "Hier baust du Felder" → "Diese
Parameter musst du ausgleichen" → "Deich schützt vor Hochwasser" →
"Jetzt los!"
- **First-Buy-Hints** (wie Klima sie eingebaut hat): Erste Card einer
Kategorie bekommt beim Kauf einen kurzen Hinweis-Event ("Dein erster
Deich — das reduziert Hochwasser-Schaden um X%")
- **Progressive Disclosure**: Level 1 nur 34 Werkzeuge, Level 2 erweitert
auf alle. So lernt der Schüler Schritt für Schritt.
### 3. Biodiversität-/Wirtschaft-Trade-off erklären
V1 zeigt Parameter-Balken, aber nicht die **Zusammenhänge**. Schüler
versteht nicht: "Warum sinkt Biodiversität wenn ich Felder baue?"
- **Event-Texte didaktisch aufladen**: Statt "Biodiversität -5" → "🐟 Die
Fische leiden unter dem neuen Feld. Weniger Ufer-Vegetation → weniger
Lebensraum."
- **Parameter-Tooltips** (via `data-glossar`): Klick auf "Biodiversität"
öffnet Glossar-Eintrag mit Erklärung
- **Achievement "Ausgleich gefunden"**: 50 Jahre Biodiv > 60 UND
Wirtschaft > 60 — belohnt aktiv den Trade-off-Gedanken
- **Graph zeigt Korrelationen**: Wenn Feld gebaut wird, Biodiv-Linie
dippt sichtbar — das ist **kausal didaktisch wertvoll**
### 4. Event-Wirkungen erklären (Hochwasser & Co.)
V1 lässt Events passieren, der Spieler sieht nur "Hochwasser!"
ohne Einordnung.
- **Event-Overlay** statt nur Log-Zeile: großes Notification-Banner
("🌊 Hochwasser!"), darunter ein kurzer Info-Text ("Der Fluss ist
über die Ufer getreten. Deine Deiche schützen X Siedlungen. Ohne
Deiche wären jetzt Y Häuser zerstört.")
- **Info-Topic pro Event** (wie Klima es hat): Klick auf Event im Stapel
öffnet didaktische Langfassung mit Wikipedia-Link und Vergleich
- **Konsequenzen sichtbar machen**: Parameter-Bar-Animation (Biodiv
blinkt rot bei Dürre), Canvas-Effekt (Feld verfärbt sich braun)
- **Statistik-Screen am Level-Ende**: "Du hast 3 Hochwasser überlebt,
2 davon hättest du ohne Deiche nicht gemeistert"
## Glossar-Begriffe, die du anfragen solltest
Schicke an `_inbox/glossar/` eine Liste mit Wunsch-Einträgen:
- `flussbegradigung` — Was bedeutet es, welche Konsequenzen?
- `retention` — Rückhalt von Wasser, Trade-off mit Flächenbedarf
- `maeander` — Fluss-Schleifen und ihre ökologische Bedeutung
- `einzugsgebiet` — Wassereinzug, warum wichtig
- `ufervegetation` — Pflanzen am Flussufer als Lebensraum
- `ueberschwemmungsgebiet` — Natürlicher Flussraum
- `biodiversitaet` — existiert schon in der DB!
- `oekosystem` — wahrscheinlich noch nicht, prüfe API
- `renaturierung` — Gegenentwurf zur Begradigung
Glossar-API-Check vor der Anfrage: `GET /api/glossar.php?module=fluss`
zeigt was schon für Fluss verfügbar ist.
## Didaktische Leitlinie
Thomas' Credo: **Nicht Fachbegriffe lernen, sondern Wirkungsgefüge
verstehen.** Ein Schüler soll nach dem Spiel sagen können: "Wenn ich
begradige, gewinne ich Bauland, verliere aber Biodiversität. Mit
Renaturierung ist es umgekehrt." Das ist wichtiger als zu wissen, wie
"Mäander" wissenschaftlich heißt.
## Keine Änderung am Plan
Dein Phase-Plan passt — die Pain-Points sind in Phase 2 (Spiellogik)
und Phase 3 (Didaktik-Layer) eingebettet. Phase 1 (Gerüst) kann
unverändert laufen.
## Bestätigen
- status: gelesen
- Bei Unklarheiten: Frage an zentrale-Inbox