refactor: Hilfetext und Saisonvergleich aus dem Controller lösen
Erste Etappen der Controller-Zerlegung, Reihenfolge und Regeln in `docs/refactor-whiteboard-controller.md`. - `HelpContent` (src/whiteboard/view/help_content.gd): der Text des ?-Dialogs als reine Funktion, 137 Zeilen ohne Kopplung. - `SeasonComparisonText` (src/whiteboard/view/season_comparison_text.gd): `build(routine, report)` liefert die BBCode-Zeilen des Saisonvergleichs; der Controller setzt sie nur noch ins Label. - Eigener Test für den Vergleichstext (Gruppen, fehlendes Element, Summe, Befunde). Controller: 9.092 -> 8.839 Zeilen. Kein Verhalten geändert, Suite grün. Nächste Etappe laut Notiz: der Prüfdialog (ValidationReportView).
This commit is contained in:
parent
1b6e6d8ede
commit
1245f438f1
8 changed files with 383 additions and 314 deletions
|
|
@ -2,8 +2,9 @@
|
|||
|
||||
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
|
||||
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 und 2 sind es 8.839 Zeilen. Diese Notiz
|
||||
hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite
|
||||
passiert und nicht als Big Bang.
|
||||
|
||||
|
|
@ -24,14 +25,15 @@ passiert und nicht als Big Bang.
|
|||
|
||||
| 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 |
|
||||
| `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 | ~350 | nur Daten | 3 |
|
||||
| `ExportService` | PDF/SVG/PNG schreiben, Abschlussdialog-Daten | ~250 | Dateisystem | 4 |
|
||||
| `SeasonPanel` | Saison-/Programm-/Kategorieauswahl und Regelnachführung | ~250 | Statusleiste | 5 |
|
||||
| `SyncPanel` | Dropbox-Sync, Konflikte, Küren verwalten | ~900 | Dialoge, Threads | 6 |
|
||||
| `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 7 |
|
||||
| `PlaybackPanel` | Wiedergabe, Musik, Timeline-Labels | ~600 | Canvas, Audio | 8 |
|
||||
| `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 9 |
|
||||
|
||||
Danach bleibt ein Controller von grob 2.000–2.500 Zeilen: Verdrahtung,
|
||||
Auswahl, Werkzeuge, Abschnitte, Undo/Redo, Statuszeile.
|
||||
|
|
@ -44,36 +46,42 @@ 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`
|
||||
### 2. `SeasonComparisonText` ✅
|
||||
|
||||
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.
|
||||
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`
|
||||
|
||||
Derselbe Schnitt für den Prüfdialog: Kopf, Saisonhinweis, Kategorie,
|
||||
Basiswert, Punktschätzung, Prüfliste und Befunde. Weil dort Anzeige-Optionen
|
||||
(„Was ist enthalten?", „Annahmen ändern") mit hineinspielen, bekommt die
|
||||
Klasse einen kleinen Kontext (Dictionary) statt vieler Einzelparameter.
|
||||
|
||||
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`
|
||||
### 4. `ExportService`
|
||||
|
||||
Schreiben der Dateien, Pfadbildung und der Abschluss-Dialog bekommen einen
|
||||
eigenen Baustein; der Controller reicht Kür, Format und Abschnitt durch.
|
||||
|
||||
### 4. `SeasonPanel`
|
||||
### 5. `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
|
||||
### 6–8. 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`
|
||||
### 9. `ElementInspector`
|
||||
|
||||
Zuletzt: Element-Dialog, Feature-Auswahl, Fußzuordnung, Levelableitung. Der
|
||||
größte UI-Block und der, an dem am meisten hängt.
|
||||
|
|
|
|||
|
|
@ -269,7 +269,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.
|
||||
Zeilen pro Datei, keine 100 `%`-Lookups in einem Skript. In Etappen nach
|
||||
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.839 Zeilen,
|
||||
`HelpContent` und `SeasonComparisonText` 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`.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue