diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 4e6f7df..4c7d96a 100644 --- a/docs/refactor-whiteboard-controller.md +++ b/docs/refactor-whiteboard-controller.md @@ -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` diff --git a/docs/roadmap.md b/docs/roadmap.md index c70ad87..b5b50fe 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -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`. diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 4b54bf2..a7c8e5c 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -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 diff --git a/rinkplanner/src/whiteboard/view/sync_summary_text.gd b/rinkplanner/src/whiteboard/view/sync_summary_text.gd new file mode 100644 index 0000000..38c27c2 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/sync_summary_text.gd @@ -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, + ] diff --git a/rinkplanner/src/whiteboard/view/sync_summary_text.gd.uid b/rinkplanner/src/whiteboard/view/sync_summary_text.gd.uid new file mode 100644 index 0000000..4d49127 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/sync_summary_text.gd.uid @@ -0,0 +1 @@ +uid://b8j6xkdhtcai diff --git a/rinkplanner/tests/run_sync_tests.gd b/rinkplanner/tests/run_sync_tests.gd index e93ac3a..d6fc285 100644 --- a/rinkplanner/tests/run_sync_tests.gd +++ b/rinkplanner/tests/run_sync_tests.gd @@ -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": [],