# WhiteboardController zerlegen Stand: 2026-11-13 Ziel: Der Controller ist mit **9.092 Zeilen und 465 Funktionen** der größte Baustein im Projekt; die Roadmap nennt < 1.500 Zeilen pro Datei. 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 | ~140 | keine | 1 ✅ | | `ValidationReportView` | Zeilen für Prüf- und Saisonvergleichs-Dialog | ~400 | nur Daten | 2 | | `ExportService` | PDF/SVG/PNG schreiben, Abschlussdialog-Daten | ~250 | Dateisystem | 3 | | `SeasonPanel` | Saison-/Programm-/Kategorieauswahl und Regelnachführung | ~250 | Statusleiste | 4 | | `SyncPanel` | Dropbox-Sync, Konflikte, Küren verwalten | ~900 | Dialoge, Threads | 5 | | `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 6 | | `PlaybackPanel` | Wiedergabe, Musik, Timeline-Labels | ~600 | Canvas, Audio | 7 | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 8 | 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. `ValidationReportView` Der komplette Textaufbau für den Prüfdialog (Kopf, Saisonhinweis, Kategorie, Basiswert, Punktschätzung, Prüfliste, Befunde) und für den Saisonvergleich wandert in eine Klasse, die `Routine`, `ValidationReport`, `RulesPackage` und die Anzeige-Optionen bekommt und `PackedStringArray` zurückgibt. Fertig, wenn der Controller nur noch `validation_text.text = ...` setzt und der Dialog unverändert aussieht (Whiteboard-Test grün, keine neuen Typfehler). ### 3. `ExportService` Schreiben der Dateien, Pfadbildung und der Abschluss-Dialog bekommen einen eigenen Baustein; der Controller reicht Kür, Format und Abschnitt durch. ### 4. `SeasonPanel` Saison-, Programm- und Kategorieauswahl samt Regelnachführung (`_apply_rules_for_season`, `_sync_season_option`, `set_season`, …). Danach kennt nur noch dieser Baustein `RulesLibrary` und `RulesPackage`. ### 5–7. Sync, Hub, Playback Die drei Thread-/Dialog-Cluster. Sie hängen an Signalen und Fenstern; hier lohnt es, die Bausteine als eigene Nodes mit Signalen zu schneiden, statt als RefCounted mit Rückruf. ### 8. `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.