Geprüft: Die Dialoge hängen direkt an der Wurzel, nutzen aber unique_name_in_owner — ein Umhängen unter Panel-Knoten bricht keine Lookups. Der Aufwand liegt bei den Test-Zugriffen und bei der geteilten Überschreib-Bestätigung des Exports.
8.1 KiB
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
- 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.
- Eine Etappe = ein Commit mit grüner Suite. Keine Etappe ändert Verhalten; die Tests bleiben unverändert, nur Aufrufstellen wandern.
- Kein Big Bang. Der Controller bleibt Node und Scene-Einstiegspunkt. Ausgelagert werden Aufgaben, nicht die Klasse.
- 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.
Nächster Durchgang: Node-Schnitt
Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, Element-Inspector) lassen sich nicht mehr als reine Funktionen herausziehen; sie brauchen eigene Nodes mit Signalen. Geprüft am 2026-11-13:
- Die Dialoge hängen direkt an der Wurzel der Szene (31 Knoten mit
parent="."). Ein Panel braucht sie als Kinder, alsoparent="ExportPanel"stattparent=".". - Das ist harmlos: Alle Dialoge nutzen
unique_name_in_owner,%Namelöst szenenweit auf. Ein Umhängen bricht weder den Controller noch die Skripte, nur den Zugriff über Pfade (den gibt es hier nicht). - Der Aufwand liegt bei den Tests:
run_export_testsundrun_sync_testsgreifen direkt auf Controller-Felder zu (controller.export_dialog,controller.export_done_label,controller.routine_manager_dialog,controller.cleanup_conflicts_dialog). Diese Zugriffe wandern aufcontroller.<panel>.<feld>. - Eine geteilte Abhängigkeit: Der Export nutzt
_confirm_overwrite(), das auch „Speichern unter" verwendet. Entweder bekommt das Panel einen eigenen Bestätigungsdialog oder der Controller reicht einen Callback durch. Diese Entscheidung sollte vor dem Umbau fallen.
Reihenfolge: erst Export (kleinster Block, ~150 Zeilen), dann Playback-Rest, dann Sync, zuletzt Hub und Element-Inspector.
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.