refactor: Wiedergabe-Geometrie als eigenes Objekt (PlaybackPose)

Etappe 8 der Controller-Zerlegung. `PlaybackPose.compute(entries, time,
previous_heading, delta, force_heading)` liefert Segment, Position,
Blickrichtung und Markergröße — inklusive der Markenlogik: Pirouetten drehen
mit der Standzeit, Sprünge drehen pro Umdrehung und wandern entlang des
Sprungvektors, Laufwege folgen der Kurve, Rückwärtsfahrt dreht die Richtung.

- Der Controller setzt das Ergebnis nur noch auf Canvas, 3D-Vorschau und
  Oberfläche; `_entry_arrival_heading` ist mit umgezogen.
- Die Umdrehungsrate für Altdaten ohne geplante Umdrehungen steht einmal in
  `PlaybackPose`; der Controller verweist darauf.
- Abgesichert durch die bestehenden Wiedergabetests (121 Assertions), die
  Positionen und Blickrichtungen über die ganze Kür prüfen.

Controller: 8.412 -> 8.304 Zeilen. Kein Verhalten geändert, Suite grün.

Offen: Steuerung, Musik, Timeline-Labels und die 3D-Anbindung.
This commit is contained in:
torsten 2026-11-13 14:25:03 +01:00
parent 5bec745825
commit 3e0c6e109d
5 changed files with 203 additions and 139 deletions

View file

@ -4,7 +4,7 @@ Stand: 2026-11-13
Ziel: Der Controller war mit **9.092 Zeilen und 465 Funktionen** der größte
Baustein im Projekt; die Roadmap nennt < 1.500 Zeilen pro Datei. Nach den
Etappen 1–7 sind es 8.412 Zeilen. Diese Notiz
Etappen 1–8 sind es 8.304 Zeilen. Diese Notiz
hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite
passiert und nicht als Big Bang.
@ -34,7 +34,8 @@ passiert und nicht als Big Bang.
| `SyncSummaryText` | Text der Sync-Zusammenfassung | 60 | keine | 7 ✅ |
| Sync-Orchestrierung | Threads, OAuth, Konflikte, Küren verwalten | ~700 | Dialoge, Threads | offen |
| `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 8 |
| `PlaybackPanel` | Wiedergabe, Musik, Timeline-Labels | ~600 | Canvas, Audio | 9 |
| `PlaybackPose` | Position und Blickrichtung zur Zeit | 130 | keine | 8 ✅ |
| Playback-Rest | Steuerung, Musik, Timeline, 3D-Anbindung | ~470 | Canvas, Audio | offen |
| `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 |
Danach bleibt ein Controller von grob 2.000–2.500 Zeilen: Verdrahtung,
@ -123,10 +124,20 @@ braucht einen Node mit Signalen, weil Fortschritt, Dialoge und Threads
zusammenhängen, und sie ändert die Aufrufstellen in `run_sync_tests`. Das ist
ein eigener Durchgang, kein Nachtrag.
### 8–9. Hub, Playback
### 8. `PlaybackPose` ✅
Dieselbe Bauart: Dialoge und Threads als Node mit Signalen, reine Text- und
Rechenanteile vorher herausziehen.
Die Wiedergabe-Geometrie liegt in `src/whiteboard/view/playback_pose.gd`:
`compute(entries, time, previous_heading, delta, force_heading)` liefert
Segment, Position, Blickrichtung und Markergröße. Die Markenlogik (Pirouette
dreht mit der Standzeit, Sprung dreht pro Umdrehung und wandert entlang des
Sprungvektors, Laufwege folgen der Kurve) steckt vollständig dort.
Der Controller wendet das Ergebnis nur noch auf Canvas, 3D-Vorschau und
Oberfläche an. Abgesichert durch die bestehenden Wiedergabetests (121
Assertions).
**Offen:** Steuerung (Start/Pause/Reset, Geschwindigkeit), Musik und
Timeline-Labels sowie die 3D-Anbindung.
### 10. `ElementInspector`

View file

@ -270,9 +270,9 @@ Schritte.
- [ ] `WhiteboardController` in Services/Panels zerlegen: Datei-I/O, Sync,
Playback, Validierung, Element-Inspector, Section-Liste. Ziel: < 1.500
Zeilen pro Datei, keine 100 `%`-Lookups in einem Skript. In Etappen nach
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.412 Zeilen; `HelpContent`, `SeasonComparisonText`,
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.304 Zeilen; `HelpContent`, `SeasonComparisonText`,
`ValidationReportView`, `ExportService`, `RulesContext`,
`SeasonPanelModel` und `SyncSummaryText` ausgelagert.
`SeasonPanelModel`, `SyncSummaryText` und `PlaybackPose` ausgelagert.
- [ ] Gemeinsamer Test-Harness (oder gdUnit4), Timeout pro Testlauf,
Coverage; CI auf dem Gitea-/Forgejo-Remote mit `tools/test.sh` und
`tools/check_export.sh`.