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.
152 lines
6.8 KiB
Markdown
152 lines
6.8 KiB
Markdown
# WhiteboardController zerlegen
|
||
|
||
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–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.
|
||
|
||
## Grundregeln
|
||
|
||
1. **Erst reine Logik, dann UI.** Textaufbau, Formatierung und Prüf-Logik
|
||
lassen sich ohne Szene testen und sind risikofrei zu verschieben. Dialoge
|
||
und Signale kommen zuletzt.
|
||
2. **Eine Etappe = ein Commit mit grüner Suite.** Keine Etappe ändert
|
||
Verhalten; die Tests bleiben unverändert, nur Aufrufstellen wandern.
|
||
3. **Kein Big Bang.** Der Controller bleibt Node und Scene-Einstiegspunkt.
|
||
Ausgelagert werden Aufgaben, nicht die Klasse.
|
||
4. **Zustand bleibt beim Controller.** `_routine`, `_current_path`, Auswahl
|
||
und Historie gehören weiter dorthin; ausgelagerte Bausteine bekommen die
|
||
Daten übergeben, statt sie zu besitzen.
|
||
|
||
## Zielbausteine
|
||
|
||
| Baustein | Inhalt | Zeilen (grob) | Kopplung | Etappe |
|
||
| :--- | :--- | ---: | :--- | :--- |
|
||
| `HelpContent` | Hilfetext für den ?-Dialog | 137 | keine | 1 ✅ |
|
||
| `SeasonComparisonText` | Zeilen für den Saisonvergleichs-Dialog | 175 | nur Daten | 2 ✅ |
|
||
| `ValidationReportView` | Zeilen für den Prüfdialog | 300 | nur Daten | 3 ✅ |
|
||
| `ExportService` | SVG/PDF schreiben, Pfade und Dateinamen | 90 | Dateisystem | 4 ✅ |
|
||
| `RulesContext` | Regelsatz: Bibliothek, Paket, drei Dokumente | 80 | keine | 5 ✅ |
|
||
| `SeasonPanelModel` | Inhalt der drei Dropdowns | 120 | keine | 6 ✅ |
|
||
| `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 |
|
||
| `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,
|
||
Auswahl, Werkzeuge, Abschnitte, Undo/Redo, Statuszeile.
|
||
|
||
## Etappen
|
||
|
||
### 1. `HelpContent` ✅
|
||
|
||
Der Hilfetext ist ein reiner String. Verschoben nach
|
||
`src/whiteboard/view/help_content.gd` (`HelpContent.build()`), der Controller
|
||
setzt ihn nur noch in den Dialog. Kein Verhalten geändert.
|
||
|
||
### 2. `SeasonComparisonText` ✅
|
||
|
||
Der Text des Saisonvergleichs (Kopf, Gruppen, Summe, Befunde) liegt jetzt in
|
||
`src/whiteboard/view/season_comparison_text.gd`. `build(routine, report)`
|
||
gibt die BBCode-Zeilen zurück; der Controller setzt sie nur noch in das
|
||
Label. Kein Verhalten geändert.
|
||
|
||
### 3. `ValidationReportView` ✅
|
||
|
||
Der komplette Text des Prüfdialogs (Kopf, Saisonhinweis, Kategorie,
|
||
Basiswert, Punktschätzung, Wertung, Prüfliste, Befunde) liegt in
|
||
`src/whiteboard/view/validation_report_view.gd`. Signatur:
|
||
`build(routine, report, category, context)` mit einem kleinen Kontext für die
|
||
Anzeige-Optionen (Saison-Label, Saisonhinweis, Vergleich-Link, aufgeklappte
|
||
Details). Der Controller baut nur noch den Report und setzt das Label.
|
||
|
||
Fertig: Dialog unverändert, Whiteboard-Test grün, eigener Test für den Text.
|
||
|
||
### 4. `ExportService` ✅
|
||
|
||
`src/whiteboard/io/export_service.gd` schreibt SVG und PDF, legt den
|
||
Exportordner an, bildet Pfade und bereinigt Dateinamen. Der Controller
|
||
delegiert nur noch; `export_svg_to_path`/`export_pdf_to_path` bleiben als
|
||
schmale Einstiegspunkte, weil Tests sie direkt aufrufen.
|
||
|
||
Bewusst im Controller geblieben: der Export-Dialog und der
|
||
Abschluss-Dialog (Szene), der PNG-Export (braucht ein SubViewport) und das
|
||
Öffnen im Dateimanager.
|
||
|
||
### 5. `RulesContext` ✅
|
||
|
||
Der Regelsatz selbst ist jetzt ein eigenes Objekt
|
||
(`src/core/rules/rules_context.gd`): Es lädt die Bibliothek, merkt sich die
|
||
Voreinstellung, wendet eine Saison an und hält die drei Dokumente
|
||
(`catalog`, `levels`, `adult`). Der Controller besitzt genau eine Instanz
|
||
(`_ruleset`) und greift nur noch über sie zu; `_load_default_rules` und
|
||
`_apply_rules_for_season` sind auf je ein paar Zeilen geschrumpft.
|
||
|
||
Damit ist die Regelauflösung testbar, ohne eine Szene zu bauen.
|
||
|
||
Was noch offen bleibt: die drei Statusleisten-Widgets (Saison, Programm,
|
||
Kategorie) und ihre Sync-Funktionen. Sie sind reine UI und kommen als
|
||
eigener Node-Schnitt.
|
||
|
||
### 6. `SeasonPanelModel` ✅
|
||
|
||
Der Inhalt der drei Dropdowns (Saison, Programm, Kategorie) liegt in
|
||
`src/whiteboard/view/season_panel_model.gd`: reine Funktionen, die
|
||
Beschriftungen und Werte bauen und die passende Auswahl zurückgeben
|
||
(`{"items": […], "selected": int}`). Der Controller füllt seine
|
||
OptionButtons nur noch über `_fill_option()` und behält die
|
||
Signalverdrahtung.
|
||
|
||
Damit sind Fälle testbar, die vorher nur über die Szene prüfbar waren:
|
||
„nicht festgelegt", unbekannte Saison, unbekannte Kategorie (bleibt als
|
||
„nicht verfügbar" sichtbar), Programmtyp.
|
||
|
||
Noch offen: die Widgets selbst als Node mit Signalen. Das ist reiner
|
||
Verdrahtungsumbau ohne Verhaltensänderung und lohnt erst, wenn Panels auch
|
||
Layout-Verantwortung übernehmen (Roadmap: „UI in logische Bereiche
|
||
gliedern").
|
||
|
||
### 7. `SyncSummaryText` ✅ (Textteil)
|
||
|
||
Der Text der Sync-Zusammenfassung liegt in
|
||
`src/whiteboard/view/sync_summary_text.gd`; der Controller setzt nur noch das
|
||
Label. Die Zusammenfassung ist damit ohne Szene prüfbar (der Sync-Test nutzt
|
||
sie direkt).
|
||
|
||
**Bewusst offen:** die Orchestrierung selbst — Thread starten und pollen,
|
||
OAuth, Konflikte aufräumen, Küren verwalten (zusammen ~700 Zeilen). Sie
|
||
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. `PlaybackPose` ✅
|
||
|
||
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`
|
||
|
||
Zuletzt: Element-Dialog, Feature-Auswahl, Fußzuordnung, Levelableitung. Der
|
||
größte UI-Block und der, an dem am meisten hängt.
|
||
|
||
## Was bewusst bleibt
|
||
|
||
- `_ready()` und die Signalverdrahtung der Szene.
|
||
- Undo/Redo und die Historie (arbeiten auf dem gesamten Kürzustand).
|
||
- Die Statuszeile als Zusammenfassung (`_update_status`), solange Panels sie
|
||
nicht selbst besitzen.
|