Files
geograsim/App/sims/_archive/staustufen-v2-2026-05-03/README.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

65 lines
2.9 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.
# Staustufen V2 — Snapshot 2026-05-03
Eingefroren am 3. Mai 2026. Thomas hat festgestellt, dass die Live-Echtzeit-Mechanik
für L1 zu schwer zu verstehen und nicht spielbar ist. Wir machen einen
Konzept-Pivot zum neuen Modul **„Energiemanager"** und sichern hier den
kompletten Stand zur möglichen späteren Wiederaufnahme.
## Was steht in diesem Snapshot
- `game.html` — Querschnitt-SVG (Vorlage von Thomas, `stausvg.html`-Stil),
Status-Spalte mit Bipolar-Live-Meter, Bedarfsgraph mit drei Wellenformen
(Bedarf rot, Solar gelb, Versorgung blau), bidirektionaler Slider als
HTML-Footer (kein foreignObject — iPad-tauglich).
- `engine.js` — RAF-getriebene Tick-Loop, stufenloser `state.control`
(-1..+1), Korridor-Bewertung ±15 %, Bedarfs- und Solar-Wellenform mit
Smoothstep-Stützpunkten, History-Aufzeichnung, Assessment-Dispatch,
InfoCard-System, TTS-Ausgabe via OpenAI mp3.
- `scripts/voice-lines.json` — TTS-Texte für 5 InfoCards.
- `sounds/*.mp3` — generierte Sprachausgaben.
## Stand der Funktionen
| Element | Stand |
|---------|-------|
| Querschnitt-SVG | sehr gut, Vorlage 1:1 übernommen |
| Wasser-/Pipe-Animation | funktioniert |
| Bipolar-Slider | stufenlos (step="any"), 36 px Touch |
| Tempo | 1× = 5 s/Tick (5 min Durchgang) |
| Live-Meter | Plus/Minus von Mitte, korrekte Skala |
| Bedarfsgraph | Wellenform + Korridor + 3 Linien |
| Bewertung | Korridor-basiert, AE |
| InfoCards + TTS | 5 Stück |
## Warum gepausiert
Thomas: „Die Simulation funktioniert so nicht. Ich kann dem überhaupt nicht
folgen. Wir müssen uns das neu ausdenken."
Diagnose: Die Mechanik zwingt zur Live-Reaktion auf zwei schwankende
Wellenformen, während Bilanz, Korridor, Speicher- und Wirkungsgrad gleichzeitig
zu beachten sind. Lerneffekt geht im Tempo verloren — der Bearbeiter wird zum
Reaktions-Bot, nicht zum Strategen.
## Wenn jemand das wieder aufnimmt
- Wrapper `App/pages/staustufen.php` zeigt weiterhin auf
`App/sims/staustufen/game.html` (Live-Pfad, NICHT dieses Archiv).
- Module_info-Eintrag in der DB existiert (status `geplant`, sort_order 16,
card_image `sim-16-staustufen.png`).
- Ein Wiederaufnehmen heißt: dieses Archiv zurück nach `App/sims/staustufen/`
kopieren und weiterentwickeln. Oder: die Konzept-Erkenntnisse für das
neue Energiemanager-Modul nutzen.
## Lessons learned (für das neue Konzept)
1. **Live-Echtzeit ist das Problem** — nicht die Inhalte. Plan-und-Auflösung
ist verständlicher.
2. **Querschnitt-Visualisierung ist gut** — Wasser, Becken, Maschinenhaus,
Druckrohre als Schulbuch-Infografik. Diesen Ansatz weiterführen.
3. **Korridor-Bewertung war zu abstrakt** — „±15 %" überfordert visuell,
wenn man gleichzeitig den Slider bedienen muss.
4. **Stufenloser Slider war OK** technisch, aber didaktisch zu fein —
diskrete Schritte sind oft klarer.
5. **TTS + InfoCards** funktionieren als Onboarding gut.