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
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
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 ✅ |
| `RulesContext` | Regelsatz: Bibliothek, Paket, drei Dokumente | 80 | keine | 5 ✅ |
| `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 |
| `PlaybackPanel` | Wiedergabe, Musik, Timeline-Labels | ~600 | Canvas, Audio | 9 |
| `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
gliedern").
### 7–9. Sync, Hub, Playback
### 7. `SyncSummaryText` ✅ (Textteil)
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.
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–9. Hub, Playback
Dieselbe Bauart: Dialoge und Threads als Node mit Signalen, reine Text- und
Rechenanteile vorher herausziehen.
### 10. `ElementInspector`

View file

@ -270,9 +270,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. In Etappen nach
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.459 Zeilen; `HelpContent`, `SeasonComparisonText`,
`ValidationReportView`, `ExportService`, `RulesContext` und
`SeasonPanelModel` ausgelagert.
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.412 Zeilen; `HelpContent`, `SeasonComparisonText`,
`ValidationReportView`, `ExportService`, `RulesContext`,
`SeasonPanelModel` und `SyncSummaryText` 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`.

View file

@ -6980,59 +6980,12 @@ func _poll_sync_thread() -> void:
_update_status()
return
var summary := _format_sync_summary(job.result)
var summary := SyncSummaryText.format(job.result)
_reload_after_sync(job.result)
_update_status()
_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:
if _sync_running:
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,
"der Aufräumdialog ist in der Szene verdrahtet"
)
var summary := controller._format_sync_summary({
var summary := SyncSummaryText.format({
"uploaded": [],
"downloaded": [],
"skipped": [],