refactor: Sync-Zusammenfassung als eigener Text-Baustein

Etappe 7 (Textteil). Der Text der Sync-Zusammenfassung liegt in
`src/whiteboard/view/sync_summary_text.gd`; der Controller setzt nur noch das
Label. Der Sync-Test nutzt die Klasse direkt statt einer Controller-Methode.

Bewusst offen bleibt die Orchestrierung: Thread starten/pollen, OAuth,
Konflikte aufräumen, Küren verwalten (~700 Zeilen). Das braucht einen Node
mit Signalen, weil Fortschritt, Dialoge und Threads zusammenhängen.

Controller: 8.459 -> 8.412 Zeilen. Suite grün.
This commit is contained in:
torsten 2026-11-13 13:42:31 +01:00
parent dbc7e1e484
commit 5bec745825
6 changed files with 83 additions and 58 deletions

View file

@ -4,7 +4,7 @@ Stand: 2026-11-13
Ziel: Der Controller war mit **9.092 Zeilen und 465 Funktionen** der größte 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 Baustein im Projekt; die Roadmap nennt < 1.500 Zeilen pro Datei. Nach den
Etappen 1–6 sind es 8.459 Zeilen. Diese Notiz Etappen 1–7 sind es 8.412 Zeilen. Diese Notiz
hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite
passiert und nicht als Big Bang. passiert und nicht als Big Bang.
@ -31,7 +31,8 @@ passiert und nicht als Big Bang.
| `ExportService` | SVG/PDF schreiben, Pfade und Dateinamen | 90 | Dateisystem | 4 ✅ | | `ExportService` | SVG/PDF schreiben, Pfade und Dateinamen | 90 | Dateisystem | 4 ✅ |
| `RulesContext` | Regelsatz: Bibliothek, Paket, drei Dokumente | 80 | keine | 5 ✅ | | `RulesContext` | Regelsatz: Bibliothek, Paket, drei Dokumente | 80 | keine | 5 ✅ |
| `SeasonPanelModel` | Inhalt der drei Dropdowns | 120 | keine | 6 ✅ | | `SeasonPanelModel` | Inhalt der drei Dropdowns | 120 | keine | 6 ✅ |
| `SyncPanel` | Dropbox-Sync, Konflikte, Küren verwalten | ~900 | Dialoge, Threads | 7 | | `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 | | `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 8 |
| `PlaybackPanel` | Wiedergabe, Musik, Timeline-Labels | ~600 | Canvas, Audio | 9 | | `PlaybackPanel` | Wiedergabe, Musik, Timeline-Labels | ~600 | Canvas, Audio | 9 |
| `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 |
@ -109,11 +110,23 @@ Verdrahtungsumbau ohne Verhaltensänderung und lohnt erst, wenn Panels auch
Layout-Verantwortung übernehmen (Roadmap: „UI in logische Bereiche Layout-Verantwortung übernehmen (Roadmap: „UI in logische Bereiche
gliedern"). gliedern").
### 7–9. Sync, Hub, Playback ### 7. `SyncSummaryText` ✅ (Textteil)
Die drei Thread-/Dialog-Cluster. Sie hängen an Signalen und Fenstern; hier Der Text der Sync-Zusammenfassung liegt in
lohnt es, die Bausteine als eigene Nodes mit Signalen zu schneiden, statt als `src/whiteboard/view/sync_summary_text.gd`; der Controller setzt nur noch das
RefCounted mit Rückruf. 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–9. Hub, Playback
Dieselbe Bauart: Dialoge und Threads als Node mit Signalen, reine Text- und
Rechenanteile vorher herausziehen.
### 10. `ElementInspector` ### 10. `ElementInspector`

View file

@ -270,9 +270,9 @@ Schritte.
- [ ] `WhiteboardController` in Services/Panels zerlegen: Datei-I/O, Sync, - [ ] `WhiteboardController` in Services/Panels zerlegen: Datei-I/O, Sync,
Playback, Validierung, Element-Inspector, Section-Liste. Ziel: < 1.500 Playback, Validierung, Element-Inspector, Section-Liste. Ziel: < 1.500
Zeilen pro Datei, keine 100 `%`-Lookups in einem Skript. In Etappen nach Zeilen pro Datei, keine 100 `%`-Lookups in einem Skript. In Etappen nach
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.459 Zeilen; `HelpContent`, `SeasonComparisonText`, `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.412 Zeilen; `HelpContent`, `SeasonComparisonText`,
`ValidationReportView`, `ExportService`, `RulesContext` und `ValidationReportView`, `ExportService`, `RulesContext`,
`SeasonPanelModel` ausgelagert. `SeasonPanelModel` und `SyncSummaryText` ausgelagert.
- [ ] Gemeinsamer Test-Harness (oder gdUnit4), Timeout pro Testlauf, - [ ] Gemeinsamer Test-Harness (oder gdUnit4), Timeout pro Testlauf,
Coverage; CI auf dem Gitea-/Forgejo-Remote mit `tools/test.sh` und Coverage; CI auf dem Gitea-/Forgejo-Remote mit `tools/test.sh` und
`tools/check_export.sh`. `tools/check_export.sh`.

View file

@ -6980,59 +6980,12 @@ func _poll_sync_thread() -> void:
_update_status() _update_status()
return return
var summary := _format_sync_summary(job.result) var summary := SyncSummaryText.format(job.result)
_reload_after_sync(job.result) _reload_after_sync(job.result)
_update_status() _update_status()
_show_message("Sync abgeschlossen\n\n" + summary) _show_message("Sync abgeschlossen\n\n" + summary)
func _format_sync_summary(result: Dictionary) -> String:
var uploaded: Array = result.get("uploaded", [])
var downloaded: Array = result.get("downloaded", [])
var resolved: Array = result.get("resolved", [])
var skipped: Array = result.get("skipped", [])
var errors: Array = result.get("errors", [])
var lines := PackedStringArray()
lines.append("Hochgeladen: %d" % uploaded.size())
if not uploaded.is_empty():
lines.append(" " + ", ".join(uploaded))
lines.append("Heruntergeladen: %d" % downloaded.size())
if not downloaded.is_empty():
lines.append(" " + ", ".join(downloaded))
lines.append(I18n.t("Automatisch aufgelöste Konflikte: %d") % resolved.size())
for entry: Dictionary in resolved:
var winner := (
"Cloud-Fassung"
if str(entry.get("winner", "")) == "cloud"
else "lokale Fassung"
)
var moment := int(entry.get("timestamp", 0))
var when := (
SyncPlan.timestamp_label(moment)
if moment > 0
else "Zeit unbekannt"
)
lines.append(" %s – %s vom %s übernommen" % [
str(entry.get("name", "")),
winner,
when,
])
if not resolved.is_empty():
lines.append(
" Ältere Fassungen liegen im Konfliktarchiv "
+ "(Datei → Konfliktarchiv öffnen)."
)
if not skipped.is_empty():
lines.append(I18n.t("Unverändert: %d") % skipped.size())
if not errors.is_empty():
lines.append("")
lines.append("Fehler:")
for message: String in errors:
lines.append(" " + message)
return "\n".join(lines)
func _start_conflict_scan() -> void: func _start_conflict_scan() -> void:
if _sync_running: if _sync_running:
return return

View file

@ -0,0 +1,58 @@
class_name SyncSummaryText
extends RefCounted
## Text of the sync result dialog ("Synchronisierung").
##
## Pure: the result dictionary of a sync job goes in, the lines come out. The
## controller only sets the label, which keeps this formatting testable without
## a scene.
static func format(result: Dictionary) -> String:
var uploaded: Array = result.get("uploaded", [])
var downloaded: Array = result.get("downloaded", [])
var resolved: Array = result.get("resolved", [])
var skipped: Array = result.get("skipped", [])
var errors: Array = result.get("errors", [])
var lines := PackedStringArray()
lines.append("Hochgeladen: %d" % uploaded.size())
if not uploaded.is_empty():
lines.append(" " + ", ".join(uploaded))
lines.append("Heruntergeladen: %d" % downloaded.size())
if not downloaded.is_empty():
lines.append(" " + ", ".join(downloaded))
lines.append(I18n.t("Automatisch aufgelöste Konflikte: %d") % resolved.size())
for entry: Dictionary in resolved:
lines.append(" " + _resolved_line(entry))
if not resolved.is_empty():
lines.append(
" Ältere Fassungen liegen im Konfliktarchiv "
+ "(Datei → Konfliktarchiv öffnen)."
)
if not skipped.is_empty():
lines.append(I18n.t("Unverändert: %d") % skipped.size())
if not errors.is_empty():
lines.append("")
lines.append("Fehler:")
for message: String in errors:
lines.append(" " + message)
return "\n".join(lines)
static func _resolved_line(entry: Dictionary) -> String:
var winner := (
"Cloud-Fassung"
if str(entry.get("winner", "")) == "cloud"
else "lokale Fassung"
)
var moment := int(entry.get("timestamp", 0))
var when := (
SyncPlan.timestamp_label(moment)
if moment > 0
else "Zeit unbekannt"
)
return "%s – %s vom %s übernommen" % [
str(entry.get("name", "")),
winner,
when,
]

View file

@ -0,0 +1 @@
uid://b8j6xkdhtcai

View file

@ -792,7 +792,7 @@ func _test_controller_wiring() -> void:
controller.cleanup_conflicts_dialog != null, controller.cleanup_conflicts_dialog != null,
"der Aufräumdialog ist in der Szene verdrahtet" "der Aufräumdialog ist in der Szene verdrahtet"
) )
var summary := controller._format_sync_summary({ var summary := SyncSummaryText.format({
"uploaded": [], "uploaded": [],
"downloaded": [], "downloaded": [],
"skipped": [], "skipped": [],