# 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, A–E |
| 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.