rinkplanner/docs/refactor-whiteboard-controller.md
torsten 1b6e6d8ede fix: PDF-Exporte folgen der Sprache der Oberfläche
`RoutinePdfExporter._text()` hat den Text übersetzt und dann das Original
geschrieben. Seit dem Englisch-Umschalten waren PDFs damit faktisch
durchgehend deutsch, obwohl die Release-Notizen übersetzte Blätter nennen.

- `_text()` schreibt jetzt die Übersetzung.
- Zusammengesetzte Texte übersetzen zuerst die Vorlage und setzen dann ein
  (Untertitel, Notiz im Rink, "+ %d weitere", Saisonvergleich).
- `_draw_note()` übersetzt vor dem Umbruch, sonst passt kein Satz mehr auf
  einen Katalogschlüssel.
- Fehlende Schlüssel ergänzt (u. a. "Kategorie: %s", "%d Abschnitte",
  "Musik: %s", Tabellenköpfe).

Test: `run_export_tests` baut ein PDF auf Englisch und prüft, dass
Tabellenköpfe und der Saisonvergleich übersetzt sind.
2026-11-13 13:17:09 +01:00

86 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.