From ad9f60b8aa9ae120b75d1333068b671f0e7fc394 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 12:43:02 +0100 Subject: [PATCH 01/28] docs: erledigte Saison-Auswahl abhaken und Findings-Zahl aktualisieren --- docs/roadmap.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/roadmap.md b/docs/roadmap.md index dc7010b..d289286 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -273,8 +273,8 @@ Schritte. - [ ] Gemeinsamer Test-Harness (oder gdUnit4), Timeout pro Testlauf, Coverage; CI auf dem Gitea-/Forgejo-Remote mit `tools/test.sh` und `tools/check_export.sh`. -- [ ] Saison datengetrieben: Saison-Auswahl/Default aus `data/`, 2025/26 - auswählbar machen oder entfernen; Regelstand im UI anzeigen. +- [x] Saison datengetrieben: Saison-Auswahl aus `data/`, Voreinstellung nach + `valid_from`, Regelstand in Statusleiste und Prüfdialog. - [ ] Android-Export teilen: Share-Intent/SAF statt nur `user://exports/`. - [ ] `Ctrl+S`/`Ctrl+O`/`Ctrl+N` und sichtbarer Speicherstatus (auch ohne Fenstertitel auf Android). @@ -290,7 +290,7 @@ Schritte. Schriftgrößen; kompakte Labels nicht mehr im Controller. - [ ] Canvas: Culling/Dirty-Regions, Kurven-Cache auch für Pan/Zoom; Perf-Test mit realistischem Budget (< 16 ms bei 480 Segmenten). -- [ ] Doku konsolidieren: 18 `findings-*.md` nach `docs/notes/` oder ins +- [ ] Doku konsolidieren: 25 `findings-*.md` nach `docs/notes/` oder ins Archiv; Architektur/Manual als aktuelle Quellen; Docstrings und Assertion-Zahlen pflegen. - [ ] Altlasten entfernen: `Flieger.obj` (nur Prototyp), alte From 4bc00d2bf9ffb1ca5c9ddfc3ce94da76fe6518d6 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 12:47:50 +0100 Subject: [PATCH 02/28] feat: Saison-Vergleich als PDF ausgeben MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Der Vergleichsdialog hat jetzt "Als PDF". Der Bericht schreibt dieselben Gruppen wie der Dialog in eine Textseite im Exportordner (_saisonvergleich_.pdf) und zeigt danach den bekannten Abschluss-Dialog mit Öffnen, Ordner zeigen und Pfad kopieren. - RoutinePdfExporter.build_season_comparison() nutzt die vorhandenen PDF-Bausteine (Seitenkopf, Fußzeile, WinAnsi-Text) und bricht lange Meldungen auf die Seitenbreite um. - Inhalt: fehlende Elemente, Base Values, Elementtyp, Features, Level, Kategorie-Grenzen, Summe und die Befunde gegen die Ziel-Saison. - ExportDoneDialog ist nicht mehr exklusiv, damit er sich über den offenen Prüfdialog legen kann. Bewusst nicht geändert: PDFs bleiben einheitlich deutsch. _text() berechnet zwar I18n.t(text), schreibt aber das Original; eine konsequente Übersetzung müsste vor der Interpolation ansetzen. Als offener Punkt dokumentiert. --- docs/isu-rules-structure.md | 14 +- docs/manual.md | 5 + rinkplanner/assets/i18n/strings.csv | 1 + rinkplanner/scenes/whiteboard/whiteboard.tscn | 9 + .../whiteboard/ctrl/whiteboard_controller.gd | 36 +++ .../src/whiteboard/io/routine_pdf_exporter.gd | 234 ++++++++++++++++++ rinkplanner/tests/run_export_tests.gd | 58 +++++ rinkplanner/tests/run_whiteboard_tests.gd | 14 ++ 8 files changed, 366 insertions(+), 5 deletions(-) diff --git a/docs/isu-rules-structure.md b/docs/isu-rules-structure.md index 0c564f6..d57936f 100644 --- a/docs/isu-rules-structure.md +++ b/docs/isu-rules-structure.md @@ -369,10 +369,10 @@ außer „Kür öffnen und hoffen". **Nutzen:** Das ist der eigentliche Grund, warum sich die Mehrsaison-Struktur für den Anwender auszahlt – nicht das Archiv, sondern der Vergleich. -**Stand:** umgesetzt (`SeasonUpgradeCheck`). Der Validator ist eine reine +**Stand:** umgesetzt (`SeasonUpgradeCheck`) inklusive PDF-Ausgabe +(`RoutinePdfExporter.build_season_comparison`). Der Validator ist eine reine Funktion über (Kür, Regelpaket); der Bericht ist die Differenz zweier Pakete -für diese eine Kür. Bis auf den PDF-Export (siehe offene Punkte) entspricht -die Umsetzung dieser Planung. +für diese eine Kür. ### Bedienung @@ -531,8 +531,12 @@ Schritte 1 und 3 sind der Hebel; alles andere baut darauf auf. - Ob die Anwender-Doku (`docs/isu-rules.md`) vollständig generiert wird oder nur die Tabellen und Zahlen. -- Ob der Upgrade-Bericht als PDF ausgegeben wird (für die Weitergabe an - Trainer und Eltern) – naheliegend, aber eigenes Feature. +- **PDF-/SVG-Sprache:** Die Exporte sind derzeit durchgehend deutsch. + `RoutinePdfExporter._text()` berechnet `I18n.t(text)`, schreibt aber den + Originaltext; viele Aufrufstellen interpolieren außerdem vorher. Eine + konsequente Übersetzung müsste die Vorlagen vor dem Einsetzen übersetzen. + Bewusst zurückgestellt, weil gemischtsprachige Blätter schlechter sind als + einheitlich deutsche. - Ob `2025/26` auch im Inspector vollständig bedienbar bleibt (Elemente anlegen) oder nur lesend geprüft wird. Die Entscheidung „alte Küren bleiben gültig" verlangt Prüfbarkeit, nicht zwingend Bearbeitbarkeit. diff --git a/docs/manual.md b/docs/manual.md index a224b8f..115c6f2 100644 --- a/docs/manual.md +++ b/docs/manual.md @@ -318,6 +318,11 @@ Der Vergleich **ändert nichts**. Erst „Auf Saison umstellen" übernimmt die Saison; die Elemente bleiben unangetastet, auch wenn einzelne davon in der neuen Saison nicht mehr existieren. +**„Als PDF"** schreibt denselben Bericht in den Exportordner +(`_saisonvergleich_.pdf`) — zum Weitergeben an Trainer, Eltern +oder die Läuferin. Danach erscheint wie bei den anderen Exporten der Dialog +mit „Öffnen", „Ordner zeigen" und „Pfad kopieren". + ## Sprungkombinationen Sprungkombinationen und -folgen sind strukturiert: diff --git a/rinkplanner/assets/i18n/strings.csv b/rinkplanner/assets/i18n/strings.csv index 1ccd983..31531ad 100644 --- a/rinkplanner/assets/i18n/strings.csv +++ b/rinkplanner/assets/i18n/strings.csv @@ -798,3 +798,4 @@ "Fuß nicht angegeben für „%s“; max. zwei Features pro Fuß sind nicht prüfbar.","Fuß nicht angegeben für „%s“; max. zwei Features pro Fuß sind nicht prüfbar.","Foot missing for “%s”; the limit of two features per foot cannot be checked." "„%s“: %d Features auf einem Fuß, es zählen höchstens %d.","„%s“: %d Features auf einem Fuß, es zählen höchstens %d.","“%s”: %d features on one foot, at most %d count." "Bei „%s“ zählen höchstens %d Features der Gruppe „%s“.","Bei „%s“ zählen höchstens %d Features der Gruppe „%s“.","In “%s” at most %d features of the group “%s” count." +"Als PDF","Als PDF","As PDF" diff --git a/rinkplanner/scenes/whiteboard/whiteboard.tscn b/rinkplanner/scenes/whiteboard/whiteboard.tscn index 3f332fe..0ed4740 100644 --- a/rinkplanner/scenes/whiteboard/whiteboard.tscn +++ b/rinkplanner/scenes/whiteboard/whiteboard.tscn @@ -1723,6 +1723,7 @@ unique_name_in_owner = true title = "Export abgeschlossen" size = Vector2i(660, 320) wrap_controls = false +exclusive = false ok_button_text = "Schließen" [node name="ExportDoneBox" type="VBoxContainer" parent="ExportDoneDialog"] @@ -1912,6 +1913,14 @@ theme_override_font_sizes/font_size = 15 disabled = true text = "Auf Saison umstellen" +[node name="UpgradePdfButton" type="Button" parent="UpgradeDialog/UpgradeBox/UpgradeActions"] +unique_name_in_owner = true +custom_minimum_size = Vector2(120, 48) +layout_mode = 2 +theme_override_font_sizes/font_size = 15 +disabled = true +text = "Als PDF" + [node name="UpgradeHint" type="Label" parent="UpgradeDialog/UpgradeBox/UpgradeActions"] unique_name_in_owner = true layout_mode = 2 diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 2414d99..c5c97d8 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -234,6 +234,7 @@ const UPDATE_FILE_NAMES := { @onready var upgrade_season_option: OptionButton = %UpgradeSeasonOption @onready var upgrade_run_button: Button = %UpgradeRunButton @onready var upgrade_apply_button: Button = %UpgradeApplyButton +@onready var upgrade_pdf_button: Button = %UpgradePdfButton @onready var validation_text: RichTextLabel = %ValidationText @onready var score_assumptions_panel: VBoxContainer = %ScoreAssumptionsPanel @onready var pcs_average_spin: SpinBox = %PcsAverageSpin @@ -1111,10 +1112,12 @@ func _run_upgrade_check() -> void: if target == null: upgrade_text.text = I18n.t("Ziel-Saison nicht verfügbar.") upgrade_apply_button.disabled = true + upgrade_pdf_button.disabled = true return _upgrade_report = SeasonUpgradeCheck.run(_routine, _rules_package, target) upgrade_text.text = I18n.join_lines(_upgrade_report_lines(_upgrade_report)) upgrade_apply_button.disabled = false + upgrade_pdf_button.disabled = false func _upgrade_report_lines(report: SeasonUpgradeCheck.Report) -> PackedStringArray: @@ -1276,6 +1279,37 @@ func _on_upgrade_apply_pressed() -> void: upgrade_dialog.hide() +## Writes the comparison as a PDF into the export folder and shows the usual +## "open / show folder / copy path" dialog. +func _on_upgrade_pdf_pressed() -> void: + if _routine == null or _upgrade_report == null: + return + var pdf := RoutinePdfExporter.build_season_comparison( + _routine, + _upgrade_report + ) + if pdf.is_empty(): + _show_message(I18n.t("Export fehlgeschlagen.")) + return + _ensure_exports_dir() + var stem := _normalize_file_stem(_routine.title) + if stem.is_empty(): + stem = "kuer" + var season := _upgrade_target_season.replace("/", "-") + var path := EXPORTS_DIR.path_join( + "%s_saisonvergleich_%s.pdf" % [stem, season] + ) + var file := FileAccess.open(path, FileAccess.WRITE) + if file == null: + _show_message(I18n.t("Export fehlgeschlagen.")) + return + file.store_buffer(pdf) + file.close() + _last_export_path = ProjectSettings.globalize_path(path) + upgrade_dialog.hide() + _show_export_done() + + func _score_info_lines() -> PackedStringArray: var lines := PackedStringArray() lines.append("[b]Enthalten[/b]") @@ -3147,6 +3181,8 @@ func _setup_upgrade_controls() -> void: upgrade_run_button.pressed.connect(_run_upgrade_check) if upgrade_apply_button != null: upgrade_apply_button.pressed.connect(_on_upgrade_apply_pressed) + if upgrade_pdf_button != null: + upgrade_pdf_button.pressed.connect(_on_upgrade_pdf_pressed) if upgrade_season_option != null: upgrade_season_option.item_selected.connect(_on_upgrade_season_selected) diff --git a/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd b/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd index 9f5468f..e897fef 100644 --- a/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd +++ b/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd @@ -27,6 +27,10 @@ const ROW_HEIGHT := 18.0 const TABLE_HEADER_HEIGHT := 18.0 const SECTION_ROWS_PER_PAGE := 23 const OVERVIEW_ROWS_PER_PAGE := 24 +## Text-only pages of the season comparison: line height and the last usable +## baseline above the footer rule. +const REPORT_LINE := 13.0 +const REPORT_BOTTOM := 546.0 const ICE_COLOR := Color(0.933, 0.965, 0.984) const BOARDS_COLOR := Color(0.118, 0.161, 0.220) @@ -73,6 +77,236 @@ static func build(routine: Routine, section_id: String = "") -> PackedByteArray: return _assemble_pdf(pages) +## --- Season comparison ---------------------------------------------------- + + +## Builds a one- or two-page report for the season comparison: what changes +## between two seasons for this routine. The layout is text only, so it can be +## handed to a coach or a parent without further explanation. +static func build_season_comparison( + routine: Routine, + report: SeasonUpgradeCheck.Report +) -> PackedByteArray: + if routine == null or report == null: + return PackedByteArray() + + var title := "Saison-Vergleich" + var subtitle := "%s · %s → %s" % [ + _routine_title(routine), + report.source_season, + report.target_season, + ] + var blocks := _report_blocks(routine, report) + + var pages: Array[String] = [] + var lines := _begin_page(title, subtitle) + var y := CONTENT_TOP + for block: Dictionary in blocks: + var size := float(block.get("size", 10.0)) + var indent := float(block.get("indent", 0.0)) + var bold := bool(block.get("bold", false)) + var color: Color = block.get("color", TEXT_COLOR) + var wrapped := _report_lines( + str(block.get("text", "")), + size, + PAGE_WIDTH - 2.0 * MARGIN - indent + ) + for part: String in wrapped: + if y + REPORT_LINE > REPORT_BOTTOM: + pages.append("\n".join(lines)) + lines = _begin_page(title, subtitle) + y = CONTENT_TOP + _text(lines, part, MARGIN + indent, y, size, bold, color) + y += REPORT_LINE + y += float(block.get("gap", 0.0)) + + pages.append("\n".join(lines)) + for index: int in range(pages.size()): + pages[index] += "\n" + _build_footer(index + 1, pages.size(), title) + return _assemble_pdf(pages) + + +static func _report_blocks( + routine: Routine, + report: SeasonUpgradeCheck.Report +) -> Array[Dictionary]: + var blocks: Array[Dictionary] = [] + + if not report.has_changes(): + blocks.append(_report_block("Keine Unterschiede: Die Kür passt in beide Saisons.")) + blocks.append(_report_block("")) + + _add_report_group( + blocks, + routine, + "Elemente", + report.changes_of(SeasonUpgradeCheck.KIND_MISSING_CODE) + ) + _add_report_group( + blocks, + routine, + "Base Values", + report.changes_of(SeasonUpgradeCheck.KIND_VALUE_CHANGE) + ) + _add_report_group( + blocks, + routine, + "Elementtyp", + report.changes_of(SeasonUpgradeCheck.KIND_TYPE_CHANGE) + ) + _add_report_group( + blocks, + routine, + "Features", + report.changes_of(SeasonUpgradeCheck.KIND_UNKNOWN_FEATURE) + ) + _add_report_group( + blocks, + routine, + "Level", + report.changes_of(SeasonUpgradeCheck.KIND_LEVEL_CHANGE) + ) + _add_report_group( + blocks, + routine, + "Kategorie", + report.changes_of(SeasonUpgradeCheck.KIND_CATEGORY_CHANGE) + ) + var missing_category := report.changes_of( + SeasonUpgradeCheck.KIND_CATEGORY_MISSING + ) + if not missing_category.is_empty(): + blocks.append(_report_block("Kategorie", 12.0, true, TEXT_COLOR, 0.0, 6.0)) + for change: SeasonUpgradeCheck.Change in missing_category: + blocks.append( + _report_block( + "• %s — in der Ziel-Saison nicht vorhanden" % change.label, + 10.0, + false, + TEXT_COLOR, + 8.0 + ) + ) + + blocks.append(_report_block("Summe", 12.0, true, TEXT_COLOR, 0.0, 6.0)) + if report.base_value_before > 0.0 or report.base_value_after > 0.0: + var sign := "+" if report.value_delta() >= 0.0 else "−" + blocks.append( + _report_block( + "Basiswert %s → %s (%s%s)" + % [ + _number(report.base_value_before), + _number(report.base_value_after), + sign, + _number(absf(report.value_delta())), + ], + 10.0, + false, + TEXT_COLOR, + 8.0 + ) + ) + else: + blocks.append(_report_block("Keine Elemente mit Base Value.", 10.0, false, TEXT_COLOR, 8.0)) + + if not report.issues.is_empty(): + blocks.append( + _report_block( + "Befunde bei Prüfung gegen %s" % report.target_season, + 12.0, + true, + TEXT_COLOR, + 0.0, + 8.0 + ) + ) + for issue: ValidationIssue in report.issues: + blocks.append( + _report_block( + "• %s: %s" % [issue.severity_label(), issue.message], + 9.5, + false, + MUTED_COLOR, + 4.0 + ) + ) + return blocks + + +static func _add_report_group( + blocks: Array[Dictionary], + routine: Routine, + title: String, + changes: Array +) -> void: + if changes.is_empty(): + return + blocks.append(_report_block(title, 12.0, true, TEXT_COLOR, 0.0, 6.0)) + for change: SeasonUpgradeCheck.Change in changes: + var text := _report_change_text(change) + var location := _report_location(routine, change.section_id) + if not location.is_empty(): + text += " (%s)" % location + blocks.append(_report_block("• " + text, 10.0, false, TEXT_COLOR, 8.0)) + + +static func _report_change_text(change: SeasonUpgradeCheck.Change) -> String: + match change.kind: + SeasonUpgradeCheck.KIND_MISSING_CODE: + return "%s — nicht im Katalog" % change.label + SeasonUpgradeCheck.KIND_UNKNOWN_FEATURE: + return "%s — Feature „%s“ in der Ziel-Saison unbekannt" % [ + change.label, + change.before, + ] + SeasonUpgradeCheck.KIND_CATEGORY_CHANGE: + return "%s: %s → %s" % [change.label, change.before, change.after] + if change.after.is_empty(): + return "%s: %s" % [change.label, change.before] + return "%s: %s → %s" % [change.label, change.before, change.after] + + +static func _report_location(routine: Routine, section_id: String) -> String: + if section_id.is_empty() or routine.sections.size() < 2: + return "" + var section := routine.get_section_by_id(section_id) + if section == null: + return "" + return I18n.section_title(section.title) + + +static func _report_block( + text: String, + size: float = 10.0, + bold: bool = false, + color: Color = TEXT_COLOR, + indent: float = 0.0, + gap: float = 0.0 +) -> Dictionary: + return { + "text": text, + "size": size, + "bold": bold, + "color": color, + "indent": indent, + "gap": gap, + } + + +## Breaks a sentence into lines that fit the page. Uses the same rough width +## estimate as the rest of this exporter. +static func _report_lines( + text: String, + size: float, + max_width: float +) -> PackedStringArray: + return _wrap_text(text, size, max_width, 200) + + +static func _number(value: float) -> String: + return String.num(value, 2).replace(".", ",") + + ## --- Page structure ------------------------------------------------------- diff --git a/rinkplanner/tests/run_export_tests.gd b/rinkplanner/tests/run_export_tests.gd index 4360e91..f27a6b0 100644 --- a/rinkplanner/tests/run_export_tests.gd +++ b/rinkplanner/tests/run_export_tests.gd @@ -134,6 +134,64 @@ func _run() -> void: pdf_text.contains("Test & "), "PDF export encodes umlauts as WinAnsi escapes" ) + + # Saison-Vergleich als PDF: eigener Bericht, gleiche PDF-Bausteine. + var library := RulesLibrary.scan() + var current := library.get_package("2026/27") + var older := library.get_package("2025/26") + if current != null and older != null: + var comparison_routine := Routine.new() + comparison_routine.routine_id = "upgrade-pdf" + comparison_routine.title = "Vergleich" + comparison_routine.rink = RinkDimensions.new() + comparison_routine.season = "2026/27" + comparison_routine.adult_category = "gold" + var comparison_section := RoutineSection.new() + comparison_section.section_id = "section-upgrade" + comparison_section.title = "Abschnitt 1" + comparison_section.sequence_order = 0 + var marker := _make_segment( + "seg-upgrade", + Vector2(0.0, 0.0), + Vector2(0.0, 0.0), + PathSegment.Direction.FORWARD, + PathSegment.Edge.INSIDE + ) + marker.set_element(PathSegment.ElementType.SPIN, "ChSp", 1) + comparison_section.segments.append(marker) + comparison_routine.sections.append(comparison_section) + + var report := SeasonUpgradeCheck.run( + comparison_routine, + current, + older + ) + var comparison_pdf := RoutinePdfExporter.build_season_comparison( + comparison_routine, + report + ) + var comparison_text := comparison_pdf.get_string_from_ascii() + _check(comparison_pdf.size() > 1000, "the comparison PDF produces data") + _check( + comparison_text.begins_with("%PDF-1.4"), + "the comparison PDF has a PDF header" + ) + _check( + comparison_text.contains("Saison-Vergleich"), + "the comparison PDF has its own title" + ) + _check( + comparison_text.contains("nicht im Katalog"), + "the comparison PDF names the missing element" + ) + _check( + comparison_text.contains("2026/27") and comparison_text.contains("2025/26"), + "the comparison PDF names both seasons" + ) + _check( + comparison_text.contains("Basiswert"), + "the comparison PDF sums the base values" + ) _check( pdf_text.contains(" c") or pdf_text.contains(" l"), "PDF export contains vector path operators" diff --git a/rinkplanner/tests/run_whiteboard_tests.gd b/rinkplanner/tests/run_whiteboard_tests.gd index 5d4909e..123bd49 100644 --- a/rinkplanner/tests/run_whiteboard_tests.gd +++ b/rinkplanner/tests/run_whiteboard_tests.gd @@ -1790,6 +1790,20 @@ func _run() -> void: controller.get_season() == "2026/27", "checking alone does not change the season" ) + _check( + not controller.upgrade_pdf_button.disabled, + "the comparison can be written as a PDF" + ) + controller._on_upgrade_pdf_pressed() + _check( + controller._last_export_path.ends_with(".pdf"), + "the comparison PDF lands in the export folder" + ) + _check( + FileAccess.file_exists(controller._last_export_path), + "the comparison PDF was written" + ) + controller.export_done_dialog.hide() controller._on_upgrade_apply_pressed() _check( controller.get_season() == "2025/26", From bbf91542217d2eac365cf85feddda8e469704ba0 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 13:11:55 +0100 Subject: [PATCH 03/28] =?UTF-8?q?chore:=200.3.0=20auch=20f=C3=BCr=20macOS?= =?UTF-8?q?=20ver=C3=B6ffentlichen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Das Mac-DMG ist hochgeladen und im Endpunkt; damit stehen beide Plattformen in version.json. - Website: Release-Block 0.3.0 nennt macOS und Windows, der Hinweis auf das folgende DMG entfällt, Download-Datum vereinheitlicht. - docs/updates.md: Stand und Größen (EXE 30,3 MB, DMG 68,1 MB). - docs/roadmap.md: Android-Export mangels Testgerät zurückgestellt. --- docs/roadmap.md | 1 + docs/updates.md | 13 ++++++------- web/i18n.php | 10 ++++------ 3 files changed, 11 insertions(+), 13 deletions(-) diff --git a/docs/roadmap.md b/docs/roadmap.md index d289286..896fc6e 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -276,6 +276,7 @@ Schritte. - [x] Saison datengetrieben: Saison-Auswahl aus `data/`, Voreinstellung nach `valid_from`, Regelstand in Statusleiste und Prüfdialog. - [ ] Android-Export teilen: Share-Intent/SAF statt nur `user://exports/`. + Zurückgestellt am 2026-11-13: kein Testgerät verfügbar. - [ ] `Ctrl+S`/`Ctrl+O`/`Ctrl+N` und sichtbarer Speicherstatus (auch ohne Fenstertitel auf Android). diff --git a/docs/updates.md b/docs/updates.md index 1d94e41..2276681 100644 --- a/docs/updates.md +++ b/docs/updates.md @@ -1,6 +1,6 @@ # Updates und Versions-Endpunkt -Stand: 2026-11-13, veröffentlichte Version **0.3.0** (Windows; macOS folgt). +Stand: 2026-11-13, veröffentlichte Version **0.3.0** (macOS und Windows). Die App prüft beim Start und über `Datei → Nach Updates suchen…`, ob eine neuere Version veröffentlicht ist. Der Endpunkt ist ein statisches JSON auf @@ -203,12 +203,11 @@ kein Netzwerkzugriff statt. ## Aktueller Stand und Übergang -- **0.3.0** ist seit 2026-11-13 für Windows veröffentlicht: Mehrere Saisons - (Regelwerk als Saisonordner mit Invariantenprüfung), Saison an der Kür, - Saison-Vergleich, Artistic als eigener Programmtyp (ohne Punktschätzung) - und die Feature-Grenzen aus ISU 2788. Das macOS-DMG folgt; bis dahin bleibt - die Mac-Version bei 0.2.3 und bekommt keinen Update-Hinweis, weil - `downloads.macos` im Endpunkt fehlt. +- **0.3.0** ist seit 2026-11-13 für macOS und Windows veröffentlicht: + Mehrere Saisons (Regelwerk als Saisonordner mit Invariantenprüfung), Saison + an der Kür, Saison-Vergleich inklusive PDF-Bericht, Artistic als eigener + Programmtyp (ohne Punktschätzung) und die Feature-Grenzen aus ISU 2788. + Windows-Installer 30,3 MB, macOS-DMG 68,1 MB. - **0.2.3** ist seit 2026-11-12 für macOS und Windows veröffentlicht: Beim Schließen werden laufende Hintergrund-Verbindungen (Update-Check, Sync) eingesammelt; ein früher Ausstieg führt nicht mehr zu einem Absturz. Das diff --git a/web/i18n.php b/web/i18n.php index 6f12a07..22fb5c4 100644 --- a/web/i18n.php +++ b/web/i18n.php @@ -43,7 +43,7 @@ return [ 'downloads.kicker' => 'Test-Build', 'downloads.title' => 'Rinkplanner herunterladen', - 'downloads.lede' => 'Windows-Installer vom 13.11.2026, macOS-Installer vom 12.11.2026. Wähle deine Plattform – die Downloads sind direkt einsatzbereit.', + 'downloads.lede' => 'macOS- und Windows-Installer vom 13.11.2026. Wähle deine Plattform – die Downloads sind direkt einsatzbereit.', 'downloads.mac.title' => 'Für den Mac', 'downloads.mac.body' => 'Universal Binary für Apple Silicon (macOS 13+) und Intel (macOS 11+).', 'downloads.mac.cta' => 'Installer herunterladen', @@ -59,12 +59,11 @@ return [ 'news.lede' => 'Die Test-Builds wachsen in kleinen Schritten. Hier steht, was zuletzt dazugekommen ist.', 'release.0.version' => '0.3.0', - 'release.0.date' => '13.11.2026 · Windows – macOS folgt', + 'release.0.date' => '13.11.2026 · macOS und Windows', 'release.0.badge' => 'Aktuell', 'release.0.item.0' => 'Küren behalten ihre Saison: Katalog, Level-Regeln und Adult-Kategorien werden pro Saison gepflegt, alte Küren prüfen weiter gegen ihr eigenes Regelwerk.', 'release.0.item.1' => 'Artistic-Programme als eigener Programmtyp: Dauer und Grenzen werden geprüft, die Punktwertung bleibt bewusst aus.', 'release.0.item.2' => 'Saison-Vergleich zeigt, was ein Wechsel ändert; die Level-Prüfung berücksichtigt Variationen je Grundposition und höchstens zwei Features pro Fuß.', - 'release.0.item.3' => 'Der macOS-Installer folgt in Kürze; die Mac-Version bleibt bis dahin bei 0.2.3.', 'release.1.version' => '0.2.3', 'release.1.date' => '12.11.2026 · macOS und Windows', 'release.1.item.0' => 'Laufende Hintergrund-Verbindungen (Update-Check, Sync) werden beim Schließen eingesammelt.', @@ -143,7 +142,7 @@ return [ 'downloads.kicker' => 'Test build', 'downloads.title' => 'Download Rinkplanner', - 'downloads.lede' => 'Windows installer from 13 Nov 2026, macOS installer from 12 Nov 2026. Pick your platform – the downloads are ready to use.', + 'downloads.lede' => 'macOS and Windows installers from 13 Nov 2026. Pick your platform – the downloads are ready to use.', 'downloads.mac.title' => 'For your Mac', 'downloads.mac.body' => 'Universal binary for Apple Silicon (macOS 13+) and Intel (macOS 11+).', 'downloads.mac.cta' => 'Download installer', @@ -159,12 +158,11 @@ return [ 'news.lede' => 'The test builds grow in small steps. Here is what was added most recently.', 'release.0.version' => '0.3.0', - 'release.0.date' => '13 Nov 2026 · Windows – macOS to follow', + 'release.0.date' => '13 Nov 2026 · macOS and Windows', 'release.0.badge' => 'Current', 'release.0.item.0' => 'Programmes keep their season: catalog, level rules and adult categories are maintained per season, and old programmes still check against their own rulebook.', 'release.0.item.1' => 'Artistic programmes as their own programme type: duration and limits are checked, the score is deliberately left out.', 'release.0.item.2' => 'The season comparison shows what a switch changes; the level check now accounts for variation categories and at most two features per foot.', - 'release.0.item.3' => 'The macOS installer follows shortly; the Mac version stays on 0.2.3 until then.', 'release.1.version' => '0.2.3', 'release.1.date' => '12 Nov 2026 · macOS and Windows', 'release.1.item.0' => 'Running background connections (update check, sync) are joined when the app closes.', From 1b6e6d8ede264eef3df65edfa0be69f1e2b1b14d Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 13:17:09 +0100 Subject: [PATCH 04/28] =?UTF-8?q?fix:=20PDF-Exporte=20folgen=20der=20Sprac?= =?UTF-8?q?he=20der=20Oberfl=C3=A4che?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `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. --- docs/refactor-whiteboard-controller.md | 86 +++++++++++++++++++ rinkplanner/assets/i18n/strings.csv | 13 +++ .../src/whiteboard/io/routine_pdf_exporter.gd | 24 +++--- rinkplanner/tests/run_export_tests.gd | 19 ++++ 4 files changed, 130 insertions(+), 12 deletions(-) create mode 100644 docs/refactor-whiteboard-controller.md diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md new file mode 100644 index 0000000..73e35b6 --- /dev/null +++ b/docs/refactor-whiteboard-controller.md @@ -0,0 +1,86 @@ +# 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. diff --git a/rinkplanner/assets/i18n/strings.csv b/rinkplanner/assets/i18n/strings.csv index 31531ad..4005aa7 100644 --- a/rinkplanner/assets/i18n/strings.csv +++ b/rinkplanner/assets/i18n/strings.csv @@ -799,3 +799,16 @@ "„%s“: %d Features auf einem Fuß, es zählen höchstens %d.","„%s“: %d Features auf einem Fuß, es zählen höchstens %d.","“%s”: %d features on one foot, at most %d count." "Bei „%s“ zählen höchstens %d Features der Gruppe „%s“.","Bei „%s“ zählen höchstens %d Features der Gruppe „%s“.","In “%s” at most %d features of the group “%s” count." "Als PDF","Als PDF","As PDF" +"Kategorie: %s","Kategorie: %s","Category: %s" +"%d Abschnitte","%d Abschnitte","%d sections" +"Musik: %s","Musik: %s","Music: %s" +"+ %d weitere","+ %d weitere","+ %d more" +"Abschnitt","Abschnitt","Section" +"Abschnitte","Abschnitte","Sections" +"#","#","#" +"Fehler","Fehler","Error" +"Warnung","Warnung","Warning" +"Hinweis","Hinweis","Note" +"%s — nicht im Katalog","%s — nicht im Katalog","%s — not in the catalog" +"%s — Feature „%s“ in der Ziel-Saison unbekannt","%s — Feature „%s“ in der Ziel-Saison unbekannt","%s — feature “%s” unknown in the target season" +"• %s — in der Ziel-Saison nicht vorhanden","• %s — in der Ziel-Saison nicht vorhanden","• %s — not available in the target season" diff --git a/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd b/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd index e897fef..0e2dcf9 100644 --- a/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd +++ b/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd @@ -180,7 +180,7 @@ static func _report_blocks( for change: SeasonUpgradeCheck.Change in missing_category: blocks.append( _report_block( - "• %s — in der Ziel-Saison nicht vorhanden" % change.label, + I18n.t("• %s — in der Ziel-Saison nicht vorhanden") % change.label, 10.0, false, TEXT_COLOR, @@ -193,7 +193,7 @@ static func _report_blocks( var sign := "+" if report.value_delta() >= 0.0 else "−" blocks.append( _report_block( - "Basiswert %s → %s (%s%s)" + I18n.t("Basiswert %s → %s (%s%s)") % [ _number(report.base_value_before), _number(report.base_value_after), @@ -212,7 +212,7 @@ static func _report_blocks( if not report.issues.is_empty(): blocks.append( _report_block( - "Befunde bei Prüfung gegen %s" % report.target_season, + I18n.t("Befunde bei Prüfung gegen %s") % report.target_season, 12.0, true, TEXT_COLOR, @@ -223,7 +223,7 @@ static func _report_blocks( for issue: ValidationIssue in report.issues: blocks.append( _report_block( - "• %s: %s" % [issue.severity_label(), issue.message], + "• %s: %s" % [I18n.t(issue.severity_label()), issue.message], 9.5, false, MUTED_COLOR, @@ -253,9 +253,9 @@ static func _add_report_group( static func _report_change_text(change: SeasonUpgradeCheck.Change) -> String: match change.kind: SeasonUpgradeCheck.KIND_MISSING_CODE: - return "%s — nicht im Katalog" % change.label + return I18n.t("%s — nicht im Katalog") % change.label SeasonUpgradeCheck.KIND_UNKNOWN_FEATURE: - return "%s — Feature „%s“ in der Ziel-Saison unbekannt" % [ + return I18n.t("%s — Feature „%s“ in der Ziel-Saison unbekannt") % [ change.label, change.before, ] @@ -574,14 +574,14 @@ static func _routine_subtitle(routine: Routine, section_count: int) -> String: parts.append(I18n.t("Artistic")) var category := routine.adult_category.strip_edges() if not category.is_empty(): - parts.append("Kategorie: %s" % category.capitalize()) + parts.append(I18n.t("Kategorie: %s") % category.capitalize()) var season := routine.season.strip_edges() if not season.is_empty(): parts.append(I18n.t("Saison %s") % season) - parts.append("%d Abschnitte" % section_count) + parts.append(I18n.t("%d Abschnitte") % section_count) parts.append(I18n.t("Gesamt %s") % _fmt_clock(routine.get_duration_seconds())) if routine.has_music(): - parts.append("Musik: %s" % routine.music_file) + parts.append(I18n.t("Musik: %s") % routine.music_file) return " · ".join(parts) @@ -696,7 +696,7 @@ static func _text( _n(color.b), _n(x), _n(_y(top)), - _pdf_literal(text), + _pdf_literal(caption), ] ) @@ -1554,7 +1554,7 @@ static func _draw_timeline_notes( if entries.size() > visible: _text( lines, - "+ %d weitere" % (entries.size() - visible), + I18n.t("+ %d weitere") % (entries.size() - visible), x, top + 16.0 + float(visible) * 13.0, 8.5, @@ -1656,7 +1656,7 @@ static func _draw_note( text: String ) -> void: _rect(lines, x, top, width, 36.0, ROW_COLOR, RULE_COLOR, 0.5) - var wrapped := _wrap_text(text, 8.0, width - 16.0, 2) + var wrapped := _wrap_text(I18n.t(text), 8.0, width - 16.0, 2) for index: int in range(wrapped.size()): _text( lines, diff --git a/rinkplanner/tests/run_export_tests.gd b/rinkplanner/tests/run_export_tests.gd index f27a6b0..8dfe7bd 100644 --- a/rinkplanner/tests/run_export_tests.gd +++ b/rinkplanner/tests/run_export_tests.gd @@ -192,6 +192,25 @@ func _run() -> void: comparison_text.contains("Basiswert"), "the comparison PDF sums the base values" ) + + # Die PDF-Texte folgen der Sprache der Oberfläche. + AppSettings.apply_locale("en") + var english_pdf := ( + RoutinePdfExporter.build(routine).get_string_from_ascii() + ) + var english_comparison := ( + RoutinePdfExporter.build_season_comparison(comparison_routine, report) + .get_string_from_ascii() + ) + AppSettings.apply_locale("de") + _check( + english_pdf.contains("Duration") and english_pdf.contains("Section"), + "PDF table labels follow the interface language" + ) + _check( + english_comparison.contains("not in the catalog"), + "the comparison PDF follows the interface language" + ) _check( pdf_text.contains(" c") or pdf_text.contains(" l"), "PDF export contains vector path operators" From 1245f438f11ceb1c7f632f7082b66cfbf177c8eb Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 13:18:35 +0100 Subject: [PATCH 05/28] =?UTF-8?q?refactor:=20Hilfetext=20und=20Saisonvergl?= =?UTF-8?q?eich=20aus=20dem=20Controller=20l=C3=B6sen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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). --- docs/refactor-whiteboard-controller.md | 48 +-- docs/roadmap.md | 4 +- .../whiteboard/ctrl/whiteboard_controller.gd | 297 +----------------- .../src/whiteboard/view/help_content.gd | 145 +++++++++ .../src/whiteboard/view/help_content.gd.uid | 1 + .../whiteboard/view/season_comparison_text.gd | 174 ++++++++++ .../view/season_comparison_text.gd.uid | 1 + rinkplanner/tests/run_rules_audit_tests.gd | 27 ++ 8 files changed, 383 insertions(+), 314 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/help_content.gd create mode 100644 rinkplanner/src/whiteboard/view/help_content.gd.uid create mode 100644 rinkplanner/src/whiteboard/view/season_comparison_text.gd create mode 100644 rinkplanner/src/whiteboard/view/season_comparison_text.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 73e35b6..cb8df00 100644 --- a/docs/refactor-whiteboard-controller.md +++ b/docs/refactor-whiteboard-controller.md @@ -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. diff --git a/docs/roadmap.md b/docs/roadmap.md index 896fc6e..bd77e9d 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -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`. diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index c5c97d8..98cdc85 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -1115,163 +1115,13 @@ func _run_upgrade_check() -> void: upgrade_pdf_button.disabled = true return _upgrade_report = SeasonUpgradeCheck.run(_routine, _rules_package, target) - upgrade_text.text = I18n.join_lines(_upgrade_report_lines(_upgrade_report)) + upgrade_text.text = I18n.join_lines( + SeasonComparisonText.build(_routine, _upgrade_report) + ) upgrade_apply_button.disabled = false upgrade_pdf_button.disabled = false -func _upgrade_report_lines(report: SeasonUpgradeCheck.Report) -> PackedStringArray: - var lines := PackedStringArray() - var title := _routine.title.strip_edges() - if title.is_empty(): - title = I18n.t("Unbenannte Kür") - lines.append( - "[b]%s — %s → %s[/b]" - % [ - _escape_bbcode(title), - report.source_season, - report.target_season, - ] - ) - - if not report.has_changes(): - lines.append("") - lines.append( - I18n.t("Keine Unterschiede: Die Kür passt in beide Saisons.") - ) - - _append_upgrade_group( - lines, - I18n.t("Elemente"), - report.changes_of(SeasonUpgradeCheck.KIND_MISSING_CODE), - I18n.t("nicht im Katalog") - ) - _append_upgrade_group( - lines, - I18n.t("Base Values"), - report.changes_of(SeasonUpgradeCheck.KIND_VALUE_CHANGE) - ) - _append_upgrade_group( - lines, - I18n.t("Elementtyp"), - report.changes_of(SeasonUpgradeCheck.KIND_TYPE_CHANGE) - ) - _append_upgrade_group( - lines, - I18n.t("Features"), - report.changes_of(SeasonUpgradeCheck.KIND_UNKNOWN_FEATURE), - I18n.t("in der Ziel-Saison unbekannt") - ) - _append_upgrade_group( - lines, - I18n.t("Level"), - report.changes_of(SeasonUpgradeCheck.KIND_LEVEL_CHANGE) - ) - _append_upgrade_group( - lines, - I18n.t("Kategorie"), - report.changes_of(SeasonUpgradeCheck.KIND_CATEGORY_CHANGE) - ) - var missing_category := report.changes_of( - SeasonUpgradeCheck.KIND_CATEGORY_MISSING - ) - if not missing_category.is_empty(): - lines.append("") - lines.append("[b]%s[/b]" % I18n.t("Kategorie")) - lines.append( - "● %s: %s" - % [ - _escape_bbcode(missing_category[0].label), - I18n.t("in der Ziel-Saison nicht vorhanden"), - ] - ) - - lines.append("") - lines.append("[b]%s[/b]" % I18n.t("Summe")) - if report.base_value_before > 0.0 or report.base_value_after > 0.0: - lines.append( - I18n.t("Basiswert %s → %s (%s%s)") - % [ - _format_base_value(report.base_value_before), - _format_base_value(report.base_value_after), - "+" if report.value_delta() >= 0.0 else "−", - _format_base_value(absf(report.value_delta())), - ] - ) - else: - lines.append(I18n.t("Keine Elemente mit Base Value.")) - - if not report.issues.is_empty(): - lines.append("") - lines.append( - "[b]%s[/b]" % I18n.t("Befunde bei Prüfung gegen %s") % report.target_season - ) - for issue: ValidationIssue in report.issues: - var color := ( - "#ef4444" - if issue.severity == ValidationIssue.Severity.ERROR - else "#f59e0b" - ) - lines.append( - "[color=%s]●[/color] %s%s" - % [ - color, - _escape_bbcode(issue.message), - _upgrade_location(issue.section_id), - ] - ) - return lines - - -func _append_upgrade_group( - lines: PackedStringArray, - title: String, - changes: Array, - suffix: String = "" -) -> void: - if changes.is_empty(): - return - lines.append("") - lines.append("[b]%s[/b]" % title) - for change: SeasonUpgradeCheck.Change in changes: - var text := _escape_bbcode(change.label) - if change.kind == SeasonUpgradeCheck.KIND_MISSING_CODE: - text += ": " + I18n.t("nicht im Katalog") - elif change.kind == SeasonUpgradeCheck.KIND_UNKNOWN_FEATURE: - text += ": %s — %s" % [ - I18n.t("Feature"), - _escape_bbcode(change.before), - ] - if not suffix.is_empty(): - text += " " + suffix - elif change.kind == SeasonUpgradeCheck.KIND_CATEGORY_CHANGE: - text = "%s: %s → %s" % [ - _escape_bbcode(change.label), - _escape_bbcode(change.before), - _escape_bbcode(change.after), - ] - elif change.after.is_empty(): - text += ": " + _escape_bbcode(change.before) - else: - text += ": %s → %s" % [ - _escape_bbcode(change.before), - _escape_bbcode(change.after), - ] - text += _upgrade_location(change.section_id) - lines.append("● %s" % text) - - -func _upgrade_location(section_id: String) -> String: - if section_id.is_empty() or _routine == null: - return "" - if _routine.sections.size() < 2: - return "" - var section := _routine.get_section_by_id(section_id) - if section == null: - return "" - return " (%s)" % I18n.section_title(section.title) - - func _on_upgrade_apply_pressed() -> void: if _upgrade_target_season.is_empty(): return @@ -1445,7 +1295,7 @@ static func _format_duration(seconds: int) -> String: func open_help_dialog() -> void: - help_text.text = _help_content() + help_text.text = HelpContent.build() var target := Vector2i(820, 680) var viewport_size := Vector2i(get_viewport_rect().size) if viewport_size.x > 0: @@ -1455,145 +1305,6 @@ func open_help_dialog() -> void: help_dialog.popup_centered(target) -func _help_content() -> String: - var lines := PackedStringArray() - lines.append("[b][font_size=22]Hilfe & Annahmen[/font_size][/b]") - lines.append( - "Diese Hilfe erklärt die Annahmen und Prüfungen der App. Sie ist " - + "keine offizielle ISU-Auslegung." - ) - lines.append("") - lines.append("[b][font_size=18]1. Kürzel und Base Value[/font_size][/b]") - lines.append( - "- Das Kürzel bezeichnet die Elementfamilie, z. B. 3Lz, CCoSp oder StSq." - ) - lines.append( - "- Der Level ist die Schwierigkeitsstufe. Bei Pirouetten und " - + "Schrittsequenzen folgt er aus den Features." - ) - lines.append( - "- Der Base Value wird aus Kürzel und Level im Saisonkatalog 2026/27 " - + "nachgeschlagen (ISU Communication 2786)." - ) - lines.append( - "- Sprünge haben keinen Level; ihr Base Value hängt von Rotation und " - + "Sprungtyp ab." - ) - lines.append( - "- Sprungkombinationen werden strukturiert gewählt: erster Sprung plus " - + "bis zu zwei weitere, als Kombination oder Folge. Die Base Values " - + "werden summiert." - ) - lines.append( - "- Eine Folge braucht einen Axel (1A/2A/3A) als 2. oder 3. Sprung." - ) - lines.append( - "- Alte Freitext-Kombinationen werden beim Laden oder Übernehmen " - + "automatisch in die strukturierte Form überführt." - ) - lines.append( - "- ChSq (Choreo-Sequenz) und ChSp (Choreographic Spin) sind fest " - + "Level 1." - ) - lines.append( - "- Unbekannte Freitext-Codes haben keinen Katalogwert und werden in " - + "der Schätzung nicht gewertet." - ) - lines.append("") - lines.append("[b][font_size=18]2. Level aus Features[/font_size][/b]") - lines.append( - "- Pirouetten haben 15 Features, Schrittsequenzen 5 " - + "(ISU Communication 2788)." - ) - lines.append( - "- 0 Features = Base, 1 = Level 1, 2 = Level 2, 3 = Level 3, " - + "4 oder mehr = Level 4." - ) - lines.append( - "- Level 4 bei Pirouetten verlangt zusätzlich eines von: schwieriger " - + "Ausgang, Kantenänderung, beide Richtungen, Temposteigerung, " - + "schwieriger Flug-Eingang oder Windmills." - ) - lines.append( - "- Bei Schrittsequenzen ist Feature 1 (Vielfalt) Pflicht." - ) - lines.append( - "- Features beschreiben die Ausführung. Die App kann sie nicht aus " - + "der gezeichneten Linie ableiten; sie werden im Element-Dialog " - + "ausgewählt." - ) - lines.append("") - lines.append("[b][font_size=18]3. Adult-Kategorie[/font_size][/b]") - lines.append( - "- Die Kategorie wird in der Statusleiste gewählt und mit der Kür " - + "gespeichert." - ) - lines.append( - "- Gold: max. 5 Sprünge, keine 2F/2Lz/2A/Triple, 3 Pirouetten inkl. " - + "ChSp, 1 Schrittsequenz, 2:50 ±10 s, Spins bis Level 3, Sequenz bis " - + "Level 2." - ) - lines.append( - "- Silver: max. 4 Einfachsprünge inkl. 1A, 2 Pirouetten, 1 ChSq, " - + "2:00 ±10 s, Level bis 2." - ) - lines.append( - "- Bronze: max. 4 Einfachsprünge ohne Axel, 1 Sprungkombination, " - + "2 Pirouetten, 1 ChSq, 1:40 ±10 s, Level bis 1." - ) - lines.append( - "- PCS-Faktor und Sturzabzug stehen in den Kategorie-Daten " - + "(Gold 2,67 und 1,0; Silver/Bronze 2,00 und 0,5)." - ) - lines.append("") - lines.append("[b][font_size=18]4. Punktschätzung[/font_size][/b]") - lines.append( - "- Basiswert: Summe der Base Values aller Elemente mit gültigem " - + "Katalogwert." - ) - lines.append( - "- PCS-Annahme: Durchschnitt pro Komponente × 3 Komponenten × " - + "Kategorie-Faktor." - ) - lines.append( - "- Der PCS-Durchschnitt ist eine Planungsannahme, kein Judge-Wert. " - + "Startwert 5,00; er kann über „Annahmen ändern“ angepasst werden." - ) - lines.append( - "- Sturzabzug: Anzahl Stürze × Kategorie-Abzug." - ) - lines.append( - "- Nicht enthalten: GOE, 1,1-Faktor, nicht katalogisierte " - + "Kombinationen und die offizielle Wettkampfwertung." - ) - lines.append( - "- Beispiel Gold: 5,00 × 3 × 2,67 = 40,05 PCS; Basiswert 9,50; " - + "geschätzte Summe 49,55." - ) - lines.append("") - lines.append("[b][font_size=18]5. Prüfung[/font_size][/b]") - lines.append( - "- Der Button „Prüfen“ zeigt Kürzel-, Level-, Feature- und " - + "Kategorie-Prüfungen sowie die Punktschätzung." - ) - lines.append( - "- Warnungen blockieren Speichern und Export nicht. Sie sind " - + "Planungshinweise." - ) - lines.append( - "- Wiederholungen: max. 2-mal pro gelistetem Sprung; " - + "Kombinationsbestandteile zählen mit." - ) - lines.append("") - lines.append("[b]Tipp:[/b] Für eine realistische PCS-Annahme helfen " - + "Protokolle früherer Wettkämpfe. Der Durchschnitt sollte zu deinem " - + "aktuellen Leistungsstand passen, nicht zum Wunschziel.") - lines.append("") - lines.append("[b]Quellen:[/b] ISU Communication 2786 (SoV 2026/27), " - + "2788 (Levels/GOE 2026/27), IAFSC Technical Announcement 2026/27.") - return I18n.join_lines(lines) - - func _on_validation_meta_clicked(meta: Variant) -> void: var key := str(meta) if key == "score_info": diff --git a/rinkplanner/src/whiteboard/view/help_content.gd b/rinkplanner/src/whiteboard/view/help_content.gd new file mode 100644 index 0000000..56718fb --- /dev/null +++ b/rinkplanner/src/whiteboard/view/help_content.gd @@ -0,0 +1,145 @@ +class_name HelpContent +extends RefCounted + +## Text of the in-app help dialog ("Hilfe & Annahmen"). +## +## Kept out of the controller so the scene wiring stays readable. The strings +## are German keys of the i18n catalog; `I18n.join_lines()` translates them. + +static func build() -> String: + var lines := PackedStringArray() + lines.append("[b][font_size=22]Hilfe & Annahmen[/font_size][/b]") + lines.append( + "Diese Hilfe erklärt die Annahmen und Prüfungen der App. Sie ist " + + "keine offizielle ISU-Auslegung." + ) + lines.append("") + lines.append("[b][font_size=18]1. Kürzel und Base Value[/font_size][/b]") + lines.append( + "- Das Kürzel bezeichnet die Elementfamilie, z. B. 3Lz, CCoSp oder StSq." + ) + lines.append( + "- Der Level ist die Schwierigkeitsstufe. Bei Pirouetten und " + + "Schrittsequenzen folgt er aus den Features." + ) + lines.append( + "- Der Base Value wird aus Kürzel und Level im Saisonkatalog 2026/27 " + + "nachgeschlagen (ISU Communication 2786)." + ) + lines.append( + "- Sprünge haben keinen Level; ihr Base Value hängt von Rotation und " + + "Sprungtyp ab." + ) + lines.append( + "- Sprungkombinationen werden strukturiert gewählt: erster Sprung plus " + + "bis zu zwei weitere, als Kombination oder Folge. Die Base Values " + + "werden summiert." + ) + lines.append( + "- Eine Folge braucht einen Axel (1A/2A/3A) als 2. oder 3. Sprung." + ) + lines.append( + "- Alte Freitext-Kombinationen werden beim Laden oder Übernehmen " + + "automatisch in die strukturierte Form überführt." + ) + lines.append( + "- ChSq (Choreo-Sequenz) und ChSp (Choreographic Spin) sind fest " + + "Level 1." + ) + lines.append( + "- Unbekannte Freitext-Codes haben keinen Katalogwert und werden in " + + "der Schätzung nicht gewertet." + ) + lines.append("") + lines.append("[b][font_size=18]2. Level aus Features[/font_size][/b]") + lines.append( + "- Pirouetten haben 15 Features, Schrittsequenzen 5 " + + "(ISU Communication 2788)." + ) + lines.append( + "- 0 Features = Base, 1 = Level 1, 2 = Level 2, 3 = Level 3, " + + "4 oder mehr = Level 4." + ) + lines.append( + "- Level 4 bei Pirouetten verlangt zusätzlich eines von: schwieriger " + + "Ausgang, Kantenänderung, beide Richtungen, Temposteigerung, " + + "schwieriger Flug-Eingang oder Windmills." + ) + lines.append( + "- Bei Schrittsequenzen ist Feature 1 (Vielfalt) Pflicht." + ) + lines.append( + "- Features beschreiben die Ausführung. Die App kann sie nicht aus " + + "der gezeichneten Linie ableiten; sie werden im Element-Dialog " + + "ausgewählt." + ) + lines.append("") + lines.append("[b][font_size=18]3. Adult-Kategorie[/font_size][/b]") + lines.append( + "- Die Kategorie wird in der Statusleiste gewählt und mit der Kür " + + "gespeichert." + ) + lines.append( + "- Gold: max. 5 Sprünge, keine 2F/2Lz/2A/Triple, 3 Pirouetten inkl. " + + "ChSp, 1 Schrittsequenz, 2:50 ±10 s, Spins bis Level 3, Sequenz bis " + + "Level 2." + ) + lines.append( + "- Silver: max. 4 Einfachsprünge inkl. 1A, 2 Pirouetten, 1 ChSq, " + + "2:00 ±10 s, Level bis 2." + ) + lines.append( + "- Bronze: max. 4 Einfachsprünge ohne Axel, 1 Sprungkombination, " + + "2 Pirouetten, 1 ChSq, 1:40 ±10 s, Level bis 1." + ) + lines.append( + "- PCS-Faktor und Sturzabzug stehen in den Kategorie-Daten " + + "(Gold 2,67 und 1,0; Silver/Bronze 2,00 und 0,5)." + ) + lines.append("") + lines.append("[b][font_size=18]4. Punktschätzung[/font_size][/b]") + lines.append( + "- Basiswert: Summe der Base Values aller Elemente mit gültigem " + + "Katalogwert." + ) + lines.append( + "- PCS-Annahme: Durchschnitt pro Komponente × 3 Komponenten × " + + "Kategorie-Faktor." + ) + lines.append( + "- Der PCS-Durchschnitt ist eine Planungsannahme, kein Judge-Wert. " + + "Startwert 5,00; er kann über „Annahmen ändern“ angepasst werden." + ) + lines.append( + "- Sturzabzug: Anzahl Stürze × Kategorie-Abzug." + ) + lines.append( + "- Nicht enthalten: GOE, 1,1-Faktor, nicht katalogisierte " + + "Kombinationen und die offizielle Wettkampfwertung." + ) + lines.append( + "- Beispiel Gold: 5,00 × 3 × 2,67 = 40,05 PCS; Basiswert 9,50; " + + "geschätzte Summe 49,55." + ) + lines.append("") + lines.append("[b][font_size=18]5. Prüfung[/font_size][/b]") + lines.append( + "- Der Button „Prüfen“ zeigt Kürzel-, Level-, Feature- und " + + "Kategorie-Prüfungen sowie die Punktschätzung." + ) + lines.append( + "- Warnungen blockieren Speichern und Export nicht. Sie sind " + + "Planungshinweise." + ) + lines.append( + "- Wiederholungen: max. 2-mal pro gelistetem Sprung; " + + "Kombinationsbestandteile zählen mit." + ) + lines.append("") + lines.append("[b]Tipp:[/b] Für eine realistische PCS-Annahme helfen " + + "Protokolle früherer Wettkämpfe. Der Durchschnitt sollte zu deinem " + + "aktuellen Leistungsstand passen, nicht zum Wunschziel.") + lines.append("") + lines.append("[b]Quellen:[/b] ISU Communication 2786 (SoV 2026/27), " + + "2788 (Levels/GOE 2026/27), IAFSC Technical Announcement 2026/27.") + return I18n.join_lines(lines) diff --git a/rinkplanner/src/whiteboard/view/help_content.gd.uid b/rinkplanner/src/whiteboard/view/help_content.gd.uid new file mode 100644 index 0000000..0f4329e --- /dev/null +++ b/rinkplanner/src/whiteboard/view/help_content.gd.uid @@ -0,0 +1 @@ +uid://bpmg0ef1gpgbu diff --git a/rinkplanner/src/whiteboard/view/season_comparison_text.gd b/rinkplanner/src/whiteboard/view/season_comparison_text.gd new file mode 100644 index 0000000..5441be0 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/season_comparison_text.gd @@ -0,0 +1,174 @@ +class_name SeasonComparisonText +extends RefCounted + +## Text of the season comparison dialog. +## +## Pure formatting: the routine and the comparison report go in, the BBCode +## lines for the RichTextLabel come out. Kept out of the controller so the +## dialog wiring stays readable and the text is testable on its own. + +static func build(routine: Routine, report: SeasonUpgradeCheck.Report) -> PackedStringArray: + var lines := PackedStringArray() + var title := routine.title.strip_edges() + if title.is_empty(): + title = I18n.t("Unbenannte Kür") + lines.append( + "[b]%s — %s → %s[/b]" + % [ + _escape(title), + report.source_season, + report.target_season, + ] + ) + + if not report.has_changes(): + lines.append("") + lines.append( + I18n.t("Keine Unterschiede: Die Kür passt in beide Saisons.") + ) + + _append_group( + routine, + lines, + I18n.t("Elemente"), + report.changes_of(SeasonUpgradeCheck.KIND_MISSING_CODE), + I18n.t("nicht im Katalog") + ) + _append_group( + routine, + lines, + I18n.t("Base Values"), + report.changes_of(SeasonUpgradeCheck.KIND_VALUE_CHANGE) + ) + _append_group( + routine, + lines, + I18n.t("Elementtyp"), + report.changes_of(SeasonUpgradeCheck.KIND_TYPE_CHANGE) + ) + _append_group( + routine, + lines, + I18n.t("Features"), + report.changes_of(SeasonUpgradeCheck.KIND_UNKNOWN_FEATURE), + I18n.t("in der Ziel-Saison unbekannt") + ) + _append_group( + routine, + lines, + I18n.t("Level"), + report.changes_of(SeasonUpgradeCheck.KIND_LEVEL_CHANGE) + ) + _append_group( + routine, + lines, + I18n.t("Kategorie"), + report.changes_of(SeasonUpgradeCheck.KIND_CATEGORY_CHANGE) + ) + var missing_category := report.changes_of( + SeasonUpgradeCheck.KIND_CATEGORY_MISSING + ) + if not missing_category.is_empty(): + lines.append("") + lines.append("[b]%s[/b]" % I18n.t("Kategorie")) + lines.append( + "● %s: %s" + % [ + _escape(missing_category[0].label), + I18n.t("in der Ziel-Saison nicht vorhanden"), + ] + ) + + lines.append("") + lines.append("[b]%s[/b]" % I18n.t("Summe")) + if report.base_value_before > 0.0 or report.base_value_after > 0.0: + lines.append( + I18n.t("Basiswert %s → %s (%s%s)") + % [ + _base_value(report.base_value_before), + _base_value(report.base_value_after), + "+" if report.value_delta() >= 0.0 else "−", + _base_value(absf(report.value_delta())), + ] + ) + else: + lines.append(I18n.t("Keine Elemente mit Base Value.")) + + if not report.issues.is_empty(): + lines.append("") + lines.append( + "[b]%s[/b]" % I18n.t("Befunde bei Prüfung gegen %s") % report.target_season + ) + for issue: ValidationIssue in report.issues: + var color := ( + "#ef4444" + if issue.severity == ValidationIssue.Severity.ERROR + else "#f59e0b" + ) + lines.append( + "[color=%s]●[/color] %s%s" + % [ + color, + _escape(issue.message), + _location(routine, issue.section_id), + ] + ) + return lines + + +static func _append_group( + routine: Routine, + lines: PackedStringArray, + title: String, + changes: Array, + suffix: String = "" +) -> void: + if changes.is_empty(): + return + lines.append("") + lines.append("[b]%s[/b]" % title) + for change: SeasonUpgradeCheck.Change in changes: + var text := _escape(change.label) + if change.kind == SeasonUpgradeCheck.KIND_MISSING_CODE: + text += ": " + I18n.t("nicht im Katalog") + elif change.kind == SeasonUpgradeCheck.KIND_UNKNOWN_FEATURE: + text += ": %s — %s" % [ + I18n.t("Feature"), + _escape(change.before), + ] + if not suffix.is_empty(): + text += " " + suffix + elif change.kind == SeasonUpgradeCheck.KIND_CATEGORY_CHANGE: + text = "%s: %s → %s" % [ + _escape(change.label), + _escape(change.before), + _escape(change.after), + ] + elif change.after.is_empty(): + text += ": " + _escape(change.before) + else: + text += ": %s → %s" % [ + _escape(change.before), + _escape(change.after), + ] + text += _location(routine, change.section_id) + lines.append("● %s" % text) + + +static func _location(routine: Routine, section_id: String) -> String: + if section_id.is_empty() or routine == null: + return "" + if routine.sections.size() < 2: + return "" + var section := routine.get_section_by_id(section_id) + if section == null: + return "" + return " (%s)" % I18n.section_title(section.title) + + +static func _escape(text: String) -> String: + return text.replace("[", "[lb]") + + +static func _base_value(value: float) -> String: + return ("%.2f" % value).replace(".", ",") diff --git a/rinkplanner/src/whiteboard/view/season_comparison_text.gd.uid b/rinkplanner/src/whiteboard/view/season_comparison_text.gd.uid new file mode 100644 index 0000000..e304526 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/season_comparison_text.gd.uid @@ -0,0 +1 @@ +uid://boq3jg287aydi diff --git a/rinkplanner/tests/run_rules_audit_tests.gd b/rinkplanner/tests/run_rules_audit_tests.gd index 33f4514..bd41066 100644 --- a/rinkplanner/tests/run_rules_audit_tests.gd +++ b/rinkplanner/tests/run_rules_audit_tests.gd @@ -19,6 +19,7 @@ func _init() -> void: _test_broken_fixture_is_reported() _test_season_pair_difference() _test_upgrade_check() + _test_season_comparison_text() _cleanup() _finish() @@ -264,6 +265,32 @@ func _test_upgrade_check() -> void: ) + +## Der Text des Saisonvergleichs ist reine Formatierung und damit testbar. +func _test_season_comparison_text() -> void: + var library := RulesLibrary.scan() + var current := library.get_package("2026/27") + var older := library.get_package("2025/26") + if current == null or older == null: + _check(false, "both seasons load for the comparison text") + return + var routine := _make_pair_routine() + routine.adult_category = "gold" + var report := SeasonUpgradeCheck.run(routine, current, older) + var text := "\n".join(SeasonComparisonText.build(routine, report)) + _check( + text.contains("2026/27") and text.contains("2025/26"), + "the comparison text names both seasons" + ) + _check(text.contains("[b]Elemente[/b]"), "the text has the element group") + _check(text.contains("ChSp"), "the text names the missing element") + _check(text.contains("[b]Summe[/b]"), "the text sums the base values") + _check( + text.contains("Befunde bei Prüfung gegen 2025/26"), + "the text adds the findings of the target season" + ) + + func _make_pair_routine() -> Routine: var routine := Routine.new() routine.routine_id = "season-pair" From a3d35076dc81fdf3152b8b445554052a9a1081c3 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 13:25:50 +0100 Subject: [PATCH 06/28] =?UTF-8?q?refactor:=20Pr=C3=BCfdialog-Text=20aus=20?= =?UTF-8?q?dem=20Controller=20l=C3=B6sen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Etappe 3 der Controller-Zerlegung. Der komplette Text des Prüfdialogs (Kopf, Saisonhinweis, Kategorie, Basiswert, Punktschätzung, Wertung, Prüfliste, Befunde) liegt jetzt in `src/whiteboard/view/validation_report_view.gd`. - `ValidationReportView.build(routine, report, category, context)` bekommt einen kleinen Kontext für die Anzeige-Optionen und gibt die BBCode-Zeilen zurück; der Controller baut nur noch den Report und setzt das Label. - Mit dem Text wandern die Hilfsfunktionen (Prüfliste-Zeile, Skip-Gründe, Fundstelle, Zähl-Labels) in die View. Sie waren nur hier im Einsatz. - Eigener Test für den Aufbau des Textes (Kopf, Saison, Vergleichslink, Kategorie, Basiswert, Prüfliste, Befunde). Controller: 8.839 -> 8.566 Zeilen. Kein Verhalten geändert, Suite grün. Nächste Etappe laut Notiz: ExportService. --- docs/refactor-whiteboard-controller.md | 20 +- docs/roadmap.md | 4 +- .../whiteboard/ctrl/whiteboard_controller.gd | 295 +---------------- .../whiteboard/view/validation_report_view.gd | 313 ++++++++++++++++++ .../view/validation_report_view.gd.uid | 1 + rinkplanner/tests/run_validation_tests.gd | 37 +++ 6 files changed, 374 insertions(+), 296 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/validation_report_view.gd create mode 100644 rinkplanner/src/whiteboard/view/validation_report_view.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index cb8df00..944e26a 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 und 2 sind es 8.839 Zeilen. Diese Notiz +Etappen 1–3 sind es 8.566 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -27,7 +27,7 @@ passiert und nicht als Big Bang. | :--- | :--- | ---: | :--- | :--- | | `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 | +| `ValidationReportView` | Zeilen für den Prüfdialog | 300 | 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 | @@ -53,16 +53,16 @@ Der Text des Saisonvergleichs (Kopf, Gruppen, Summe, Befunde) liegt jetzt in gibt die BBCode-Zeilen zurück; der Controller setzt sie nur noch in das Label. Kein Verhalten geändert. -### 3. `ValidationReportView` +### 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. +Der komplette Text des Prüfdialogs (Kopf, Saisonhinweis, Kategorie, +Basiswert, Punktschätzung, Wertung, Prüfliste, Befunde) liegt in +`src/whiteboard/view/validation_report_view.gd`. Signatur: +`build(routine, report, category, context)` mit einem kleinen Kontext für die +Anzeige-Optionen (Saison-Label, Saisonhinweis, Vergleich-Link, aufgeklappte +Details). Der Controller baut nur noch den Report und setzt das Label. -Fertig, wenn der Controller nur noch `validation_text.text = ...` setzt und -der Dialog unverändert aussieht (Whiteboard-Test grün, keine neuen -Typfehler). +Fertig: Dialog unverändert, Whiteboard-Test grün, eigener Test für den Text. ### 4. `ExportService` diff --git a/docs/roadmap.md b/docs/roadmap.md index bd77e9d..b8c1454 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -270,8 +270,8 @@ 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.839 Zeilen, - `HelpContent` und `SeasonComparisonText` ausgelagert. + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.566 Zeilen, + `HelpContent`, `SeasonComparisonText` und `ValidationReportView` 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 98cdc85..e4a747c 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -892,33 +892,6 @@ func _render_validation_dialog() -> void: _adult_rules ) var report := validator.validate_report(_routine) - var errors := RoutineValidator.count_severity( - report.issues, - ValidationIssue.Severity.ERROR - ) - var warnings := RoutineValidator.count_severity( - report.issues, - ValidationIssue.Severity.WARNING - ) - var season := _catalog_season_label() - - var lines := PackedStringArray() - lines.append( - "[b]Geprüft: %s in %s (Saison %s)[/b]" - % [ - _element_count_label(report.element_count), - _section_count_label(report.section_count), - season, - ] - ) - var season_note := _season_note() - if not season_note.is_empty(): - lines.append("[color=#e0b050]%s[/color]" % season_note) - if _can_compare_seasons(): - lines.append( - "[url=upgrade][color=#60a5fa]%s[/color][/url]" - % I18n.t("ⓘ Gegen andere Saison prüfen …") - ) var category: AdultCategoryRules.Category = null if ( _routine != null @@ -929,129 +902,18 @@ func _render_validation_dialog() -> void: _routine.adult_category, _routine.program_type ) - var category_name := "Ohne Kategorie" - if category != null: - category_name = "%s · %s · %s ±%d s" % [ - category.name, - _program_label(category.program_type), - _format_duration(category.duration_seconds), - category.duration_tolerance_seconds, - ] - lines.append("[b]Kategorie: %s[/b]" % category_name) - lines.append("") - lines.append( - "[b]Basiswert: %s[/b]" % _format_base_value(report.base_value_total) + var lines := ValidationReportView.build( + _routine, + report, + category, + { + "season": _catalog_season_label(), + "season_note": _season_note(), + "can_compare": _can_compare_seasons(), + "show_info": _show_score_info, + "show_assumptions": _show_score_assumptions, + } ) - var scored_text := ( - "%d von %d Elementen gewertet" - % [report.scored_elements, report.element_count] - ) - if report.unscored_elements > 0: - scored_text += " · %d ohne Base Value" % report.unscored_elements - lines.append(scored_text) - var info_label := ( - "ⓘ Details ausblenden" if _show_score_info else "ⓘ Was ist enthalten?" - ) - lines.append( - "[color=#94a3b8]Nur Base Values · [/color][url=score_info][color=#60a5fa]%s[/color][/url]" - % info_label - ) - if _show_score_info: - lines.append("") - lines.append_array(_score_info_lines()) - if category != null and category.scored: - var pcs_total := ( - _routine.assumed_pcs_average * 3.0 * category.pcs_factor - ) - var deduction := float(_routine.assumed_falls) * category.fall_deduction - var estimated := report.base_value_total + pcs_total - deduction - lines.append("") - lines.append("[b]Punktschätzung[/b]") - lines.append( - "PCS-Annahme: %s × 3 × %s = %s" - % [ - _format_base_value(_routine.assumed_pcs_average), - _format_base_value(category.pcs_factor), - _format_base_value(pcs_total), - ] - ) - lines.append( - "Sturzabzug: %d × %s = -%s" - % [ - _routine.assumed_falls, - _format_base_value(category.fall_deduction), - _format_base_value(deduction), - ] - ) - lines.append( - I18n.t("[b]Geschätzte Summe: %s[/b]") % _format_base_value(estimated) - ) - var assumptions_label := ( - "ⓘ Annahmen ausblenden" - if _show_score_assumptions - else "ⓘ Annahmen ändern" - ) - lines.append( - "[url=score_assumptions][color=#60a5fa]%s[/color][/url]" - % assumptions_label - ) - elif category != null: - lines.append("") - lines.append("[b]Punktschätzung[/b]") - lines.append( - "[color=#94a3b8]%s[/color]" - % I18n.t( - "Artistic wird nur über die Programmkomponenten bewertet; keine Punktschätzung." - ) - ) - else: - lines.append( - "[color=#94a3b8]PCS und Abzüge: Kategorie wählen.[/color]" - ) - if not report.element_values.is_empty(): - lines.append("") - lines.append("[b]Wertung[/b]") - for entry: Dictionary in report.element_values: - var value: float = entry["value"] - var value_text := ( - "—" if value < 0.0 else _format_base_value(value) - ) - lines.append( - "%s — %s" - % [_escape_bbcode(str(entry["label"])), value_text] - ) - lines.append("") - lines.append("[b]Prüfungen[/b]") - for check: ValidationCheck in report.checks: - lines.append(_validation_check_line(check)) - lines.append("") - lines.append("[b]Befunde[/b]") - - if report.issues.is_empty(): - if report.element_count == 0: - lines.append("Keine Elemente vorhanden.") - else: - lines.append("Keine Befunde.") - else: - lines.append( - "[b]%d Fehler, %d Warnungen[/b]" % [errors, warnings] - ) - for issue: ValidationIssue in report.issues: - var color := ( - "#ef4444" - if issue.severity == ValidationIssue.Severity.ERROR - else "#f59e0b" - ) - lines.append( - "[color=%s]●[/color] [b]%s[/b]%s: %s" - % [ - color, - issue.severity_label(), - _validation_location(issue), - _escape_bbcode(issue.message), - ] - ) - validation_text.text = I18n.join_lines(lines) if validation_dialog.visible: return @@ -1064,9 +926,6 @@ func _render_validation_dialog() -> void: target.y = mini(target.y, viewport_size.y) validation_dialog.popup_centered(target) - -## Opens the season comparison for the current routine. It only reports; the -## routine changes season when the user confirms it. func open_upgrade_dialog() -> void: if _routine == null or _rules_package == null or _rules_library == null: return @@ -1160,128 +1019,6 @@ func _on_upgrade_pdf_pressed() -> void: _show_export_done() -func _score_info_lines() -> PackedStringArray: - var lines := PackedStringArray() - lines.append("[b]Enthalten[/b]") - lines.append("- Base Value jedes Elements aus Katalog und gewähltem Level") - lines.append("- ChSq und ChSp mit festem Level 1") - lines.append("- strukturierte Sprungkombinationen als Summe ihrer Sprünge") - lines.append("- nur Elemente mit gültigem Katalogwert") - lines.append("") - lines.append("[b]Nicht im Basiswert enthalten[/b]") - lines.append("- GOE / Ausführungsqualität") - lines.append("- 1,1-Faktor für Sprünge in der zweiten Programmhälfte") - lines.append("- Programmkomponenten (PCS)") - lines.append("- Abzüge (Stürze, Zeitüberschreitungen usw.)") - lines.append("- nicht katalogisierte Kombinationen und Freitext-Codes") - lines.append("- Programmtyp und Adult-spezifische Sonderregeln") - lines.append("") - lines.append( - "[b]Punktschätzung[/b]\nPCS und Sturzabzug werden separat in der " - + "Punktschätzung angesetzt." - ) - lines.append("") - lines.append( - "[b]Ergebnis[/b]\nDer Basiswert ist ein technischer Wert, keine " - + "vorhergesagte Gesamtpunktzahl." - ) - return lines - - -func _validation_check_line(check: ValidationCheck) -> String: - var color := "#22c55e" - var icon := "✓" - var detail := check.summary() - if check.is_skipped(): - color = "#64748b" - icon = "–" - detail = I18n.t("nicht anwendbar (%s)") % _validation_skip_reason(check.code) - elif check.findings > 0: - color = "#ef4444" if check.errors > 0 else "#f59e0b" - icon = "✗" - - var findings := PackedStringArray() - if check.errors > 0: - findings.append("%d Fehler" % check.errors) - if check.warnings > 0: - findings.append( - "%d Warnung%s" - % [check.warnings, "" if check.warnings == 1 else "en"] - ) - if not findings.is_empty(): - detail += " · " + " · ".join(findings) - - return "[color=%s]%s[/color] %s — %s" % [ - color, - icon, - _escape_bbcode(check.label), - detail, - ] - - -func _validation_skip_reason(check_code: String) -> String: - if check_code.begins_with("category"): - return "keine Kategorie oder keine passenden Elemente" - match check_code: - "code": - return "keine Elemente" - "type": - return "kein Kürzel im Katalog" - "level": - return "kein passendes Kürzel" - "fixed_level": - return "kein ChSq" - "features", "required", "level_features": - return "keine Features gesetzt" - "once": - return "keine Einmal-Features gesetzt" - "jump_sequence": - return "keine Sprungfolge" - return "keine passenden Daten" - - -func _element_count_label(count: int) -> String: - return "1 Element" if count == 1 else "%d Elemente" % count - - -func _section_count_label(count: int) -> String: - return "1 Abschnitt" if count == 1 else "%d Abschnitten" % count - - -func _validation_location(issue: ValidationIssue) -> String: - var parts := PackedStringArray() - if not issue.section_id.is_empty(): - var section := _routine.get_section_by_id(issue.section_id) - parts.append( - "Abschnitt „%s“" - % (I18n.section_title(section.title) if section != null else issue.section_id) - ) - if not issue.segment_id.is_empty(): - var segment := _find_routine_segment(issue.segment_id) - if segment != null and segment.is_element(): - var label := segment.element_code.strip_edges() - if label.is_empty(): - label = PathSegment.element_type_name(segment.element_type) - parts.append("Element „%s“" % label) - else: - parts.append(issue.segment_id) - if parts.is_empty(): - return "" - return " (%s)" % " · ".join(parts) - - -func _find_routine_segment(segment_id: String) -> PathSegment: - if _routine == null or segment_id.is_empty(): - return null - for section: RoutineSection in _routine.sections: - if section == null: - continue - var segment := section.get_segment_by_id(segment_id) - if segment != null: - return segment - return null - - static func _escape_bbcode(text: String) -> String: return text.replace("[", "[lb]") @@ -1290,10 +1027,6 @@ static func _format_base_value(value: float) -> String: return ("%.2f" % value).replace(".", ",") -static func _format_duration(seconds: int) -> String: - return "%d:%02d" % [seconds / 60, seconds % 60] - - func open_help_dialog() -> void: help_text.text = HelpContent.build() var target := Vector2i(820, 680) @@ -2822,12 +2555,6 @@ func get_program_type() -> String: return _program_type() -func _program_label(program_type: String) -> String: - if program_type == AdultCategoryRules.PROGRAM_ARTISTIC: - return I18n.t("Artistic") - return I18n.t("Kür") - - func _on_adult_category_selected(index: int) -> void: set_adult_category(str(adult_category_option.get_item_metadata(index))) diff --git a/rinkplanner/src/whiteboard/view/validation_report_view.gd b/rinkplanner/src/whiteboard/view/validation_report_view.gd new file mode 100644 index 0000000..cd557d9 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/validation_report_view.gd @@ -0,0 +1,313 @@ +class_name ValidationReportView +extends RefCounted + +## Text of the validation dialog ("Kür prüfen"). +## +## Pure formatting: routine, report and the resolved category go in, the +## BBCode lines for the RichTextLabel come out. The controller owns the dialog +## and the view options (what is expanded); the text itself lives here so it +## can be reasoned about and tested without a scene. + +static func build( + routine: Routine, + report: ValidationReport, + category: AdultCategoryRules.Category, + context: Dictionary +) -> PackedStringArray: + var show_info := bool(context.get("show_info", false)) + var show_assumptions := bool(context.get("show_assumptions", false)) + var errors := RoutineValidator.count_severity( + report.issues, + ValidationIssue.Severity.ERROR + ) + var warnings := RoutineValidator.count_severity( + report.issues, + ValidationIssue.Severity.WARNING + ) + + var lines := PackedStringArray() + lines.append( + "[b]Geprüft: %s in %s (Saison %s)[/b]" + % [ + _element_count_label(report.element_count), + _section_count_label(report.section_count), + str(context.get("season", "")), + ] + ) + var season_note := str(context.get("season_note", "")) + if not season_note.is_empty(): + lines.append("[color=#e0b050]%s[/color]" % season_note) + if bool(context.get("can_compare", false)): + lines.append( + "[url=upgrade][color=#60a5fa]%s[/color][/url]" + % I18n.t("ⓘ Gegen andere Saison prüfen …") + ) + + var category_name := "Ohne Kategorie" + if category != null: + category_name = "%s · %s · %s ±%d s" % [ + category.name, + _program_label(category.program_type), + _clock(category.duration_seconds), + category.duration_tolerance_seconds, + ] + lines.append("[b]Kategorie: %s[/b]" % category_name) + lines.append("") + lines.append( + "[b]Basiswert: %s[/b]" % _base_value(report.base_value_total) + ) + var scored_text := ( + "%d von %d Elementen gewertet" + % [report.scored_elements, report.element_count] + ) + if report.unscored_elements > 0: + scored_text += " · %d ohne Base Value" % report.unscored_elements + lines.append(scored_text) + var info_label := ( + "ⓘ Details ausblenden" if show_info else "ⓘ Was ist enthalten?" + ) + lines.append( + "[color=#94a3b8]Nur Base Values · [/color][url=score_info][color=#60a5fa]%s[/color][/url]" + % info_label + ) + if show_info: + lines.append("") + lines.append_array(_score_info_lines()) + + if category != null and category.scored: + var pcs_total := ( + routine.assumed_pcs_average * 3.0 * category.pcs_factor + ) + var deduction := float(routine.assumed_falls) * category.fall_deduction + var estimated := report.base_value_total + pcs_total - deduction + lines.append("") + lines.append("[b]Punktschätzung[/b]") + lines.append( + "PCS-Annahme: %s × 3 × %s = %s" + % [ + _base_value(routine.assumed_pcs_average), + _base_value(category.pcs_factor), + _base_value(pcs_total), + ] + ) + lines.append( + "Sturzabzug: %d × %s = -%s" + % [ + routine.assumed_falls, + _base_value(category.fall_deduction), + _base_value(deduction), + ] + ) + lines.append( + I18n.t("[b]Geschätzte Summe: %s[/b]") % _base_value(estimated) + ) + var assumptions_label := ( + "ⓘ Annahmen ausblenden" + if show_assumptions + else "ⓘ Annahmen ändern" + ) + lines.append( + "[url=score_assumptions][color=#60a5fa]%s[/color][/url]" + % assumptions_label + ) + elif category != null: + lines.append("") + lines.append("[b]Punktschätzung[/b]") + lines.append( + "[color=#94a3b8]%s[/color]" + % I18n.t( + "Artistic wird nur über die Programmkomponenten bewertet; keine Punktschätzung." + ) + ) + else: + lines.append( + "[color=#94a3b8]PCS und Abzüge: Kategorie wählen.[/color]" + ) + + if not report.element_values.is_empty(): + lines.append("") + lines.append("[b]Wertung[/b]") + for entry: Dictionary in report.element_values: + var value: float = entry["value"] + var value_text := ( + "—" if value < 0.0 else _base_value(value) + ) + lines.append( + "%s — %s" + % [_escape(str(entry["label"])), value_text] + ) + + lines.append("") + lines.append("[b]Prüfungen[/b]") + for check: ValidationCheck in report.checks: + lines.append(_check_line(check)) + lines.append("") + lines.append("[b]Befunde[/b]") + + if report.issues.is_empty(): + if report.element_count == 0: + lines.append("Keine Elemente vorhanden.") + else: + lines.append("Keine Befunde.") + else: + lines.append( + "[b]%d Fehler, %d Warnungen[/b]" % [errors, warnings] + ) + for issue: ValidationIssue in report.issues: + var color := ( + "#ef4444" + if issue.severity == ValidationIssue.Severity.ERROR + else "#f59e0b" + ) + lines.append( + "[color=%s]●[/color] [b]%s[/b]%s: %s" + % [ + color, + issue.severity_label(), + _location(routine, issue), + _escape(issue.message), + ] + ) + return lines + + +static func _score_info_lines() -> PackedStringArray: + var lines := PackedStringArray() + lines.append("[b]Enthalten[/b]") + lines.append("- Base Value jedes Elements aus Katalog und gewähltem Level") + lines.append("- ChSq und ChSp mit festem Level 1") + lines.append("- strukturierte Sprungkombinationen als Summe ihrer Sprünge") + lines.append("- nur Elemente mit gültigem Katalogwert") + lines.append("") + lines.append("[b]Nicht im Basiswert enthalten[/b]") + lines.append("- GOE / Ausführungsqualität") + lines.append("- 1,1-Faktor für Sprünge in der zweiten Programmhälfte") + lines.append("- Programmkomponenten (PCS)") + lines.append("- Abzüge (Stürze, Zeitüberschreitungen usw.)") + lines.append("- nicht katalogisierte Kombinationen und Freitext-Codes") + lines.append("- Programmtyp und Adult-spezifische Sonderregeln") + lines.append("") + lines.append( + "[b]Punktschätzung[/b]\nPCS und Sturzabzug werden separat in der " + + "Punktschätzung angesetzt." + ) + lines.append("") + lines.append( + "[b]Ergebnis[/b]\nDer Basiswert ist ein technischer Wert, keine " + + "vorhergesagte Gesamtpunktzahl." + ) + return lines + + +static func _check_line(check: ValidationCheck) -> String: + var color := "#22c55e" + var icon := "✓" + var detail := check.summary() + if check.is_skipped(): + color = "#64748b" + icon = "–" + detail = I18n.t("nicht anwendbar (%s)") % _skip_reason(check.code) + elif check.findings > 0: + color = "#ef4444" if check.errors > 0 else "#f59e0b" + icon = "✗" + + var findings := PackedStringArray() + if check.errors > 0: + findings.append("%d Fehler" % check.errors) + if check.warnings > 0: + findings.append( + "%d Warnung%s" + % [check.warnings, "" if check.warnings == 1 else "en"] + ) + if not findings.is_empty(): + detail += " · " + " · ".join(findings) + + return "[color=%s]%s[/color] %s — %s" % [ + color, + icon, + _escape(check.label), + detail, + ] + + +static func _skip_reason(check_code: String) -> String: + if check_code.begins_with("category"): + return "keine Kategorie oder keine passenden Elemente" + match check_code: + "code": + return "keine Elemente" + "type": + return "kein Kürzel im Katalog" + "level": + return "kein passendes Kürzel" + "fixed_level": + return "kein ChSq" + "features", "required", "level_features": + return "keine Features gesetzt" + "once": + return "keine Einmal-Features gesetzt" + "jump_sequence": + return "keine Sprungfolge" + return "keine passenden Daten" + + +static func _location(routine: Routine, issue: ValidationIssue) -> String: + var parts := PackedStringArray() + if not issue.section_id.is_empty(): + var section := ( + routine.get_section_by_id(issue.section_id) if routine != null else null + ) + parts.append( + "Abschnitt „%s“" + % (I18n.section_title(section.title) if section != null else issue.section_id) + ) + if not issue.segment_id.is_empty(): + var segment := _find_segment(routine, issue.segment_id) + if segment != null and segment.is_element(): + var label := segment.element_code.strip_edges() + if label.is_empty(): + label = PathSegment.element_type_name(segment.element_type) + parts.append("Element „%s“" % label) + else: + parts.append(issue.segment_id) + if parts.is_empty(): + return "" + return " (%s)" % " · ".join(parts) + + +static func _find_segment(routine: Routine, segment_id: String) -> PathSegment: + if routine == null or segment_id.is_empty(): + return null + for section: RoutineSection in routine.sections: + if section == null: + continue + var segment := section.get_segment_by_id(segment_id) + if segment != null: + return segment + return null + + +static func _element_count_label(count: int) -> String: + return "1 Element" if count == 1 else "%d Elemente" % count + + +static func _section_count_label(count: int) -> String: + return "1 Abschnitt" if count == 1 else "%d Abschnitten" % count + + +static func _program_label(program_type: String) -> String: + if program_type == AdultCategoryRules.PROGRAM_ARTISTIC: + return I18n.t("Artistic") + return I18n.t("Kür") + + +static func _clock(seconds: int) -> String: + return "%d:%02d" % [seconds / 60, seconds % 60] + + +static func _base_value(value: float) -> String: + return ("%.2f" % value).replace(".", ",") + + +static func _escape(text: String) -> String: + return text.replace("[", "[lb]") diff --git a/rinkplanner/src/whiteboard/view/validation_report_view.gd.uid b/rinkplanner/src/whiteboard/view/validation_report_view.gd.uid new file mode 100644 index 0000000..51961de --- /dev/null +++ b/rinkplanner/src/whiteboard/view/validation_report_view.gd.uid @@ -0,0 +1 @@ +uid://4shkok0ey0x3 diff --git a/rinkplanner/tests/run_validation_tests.gd b/rinkplanner/tests/run_validation_tests.gd index f45a837..29b1e8a 100644 --- a/rinkplanner/tests/run_validation_tests.gd +++ b/rinkplanner/tests/run_validation_tests.gd @@ -43,6 +43,7 @@ func _init() -> void: _test_jump_sequence() _test_program_once_features() _test_missing_rules() + _test_report_view() _finish() @@ -562,6 +563,42 @@ func _messages(issues: Array[ValidationIssue]) -> String: return "; ".join(parts) + +## Der Dialogtext ist reine Formatierung und damit ohne Szene testbar. +func _test_report_view() -> void: + var routine := _make_routine() + _add_marker( + routine.sections[0], + "spin", + PathSegment.ElementType.SPIN, + "CCoSp", + 4, + PackedStringArray(["difficult_variation_sit", "difficult_exit"]) + ) + var report := _validator.validate_report(routine) + var text := "\n".join( + ValidationReportView.build( + routine, + report, + null, + { + "season": "2026/27", + "season_note": "", + "can_compare": true, + "show_info": false, + "show_assumptions": false, + } + ) + ) + _check(text.contains("Geprüft:"), "the view has the header line") + _check(text.contains("Saison 2026/27"), "the view names the season") + _check(text.contains("[url=upgrade]"), "the view offers the season comparison") + _check(text.contains("Kategorie: Ohne Kategorie"), "the view reports no category") + _check(text.contains("[b]Basiswert:"), "the view shows the base value") + _check(text.contains("[b]Prüfungen[/b]"), "the view lists the checks") + _check(text.contains("[b]Befunde[/b]"), "the view lists the findings") + + func _check(condition: bool, message: String) -> void: _assertions += 1 if not condition: From 7ee5e36af415ab2b05001d5efd7f744ce079f01e Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 13:28:03 +0100 Subject: [PATCH 07/28] =?UTF-8?q?refactor:=20Export-Schreibpfad=20aus=20de?= =?UTF-8?q?m=20Controller=20l=C3=B6sen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Etappe 4 der Controller-Zerlegung. `ExportService` (src/whiteboard/io/export_service.gd) schreibt SVG und PDF, legt den Exportordner an, bildet Pfade und bereinigt Dateinamen. - `export_svg_to_path`/`export_pdf_to_path` delegieren nur noch; sie bleiben als Einstiegspunkte, weil Tests sie direkt aufrufen. - Der Saisonvergleich nutzt denselben Pfadbau statt eigener Zeilen. - Test: Pfadbildung, Namensbereinigung und ein tatsächlich geschriebenes PDF. Bewusst im Controller: Export- und Abschluss-Dialog (Szene), PNG-Export (SubViewport) und "im Dateimanager öffnen". Controller: 8.566 -> 8.529 Zeilen. Kein Verhalten geändert, Suite grün. Nächste Etappe laut Notiz: SeasonPanel. --- docs/refactor-whiteboard-controller.md | 16 +++-- docs/roadmap.md | 4 +- .../whiteboard/ctrl/whiteboard_controller.gd | 67 ++++------------- .../src/whiteboard/io/export_service.gd | 71 +++++++++++++++++++ .../src/whiteboard/io/export_service.gd.uid | 1 + rinkplanner/tests/run_export_tests.gd | 17 +++++ 6 files changed, 117 insertions(+), 59 deletions(-) create mode 100644 rinkplanner/src/whiteboard/io/export_service.gd create mode 100644 rinkplanner/src/whiteboard/io/export_service.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 944e26a..6a5e909 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–3 sind es 8.566 Zeilen. Diese Notiz +Etappen 1–4 sind es 8.529 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -28,7 +28,7 @@ passiert und nicht als Big Bang. | `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 | 300 | nur Daten | 3 ✅ | -| `ExportService` | PDF/SVG/PNG schreiben, Abschlussdialog-Daten | ~250 | Dateisystem | 4 | +| `ExportService` | SVG/PDF schreiben, Pfade und Dateinamen | 90 | 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 | @@ -64,10 +64,16 @@ Details). Der Controller baut nur noch den Report und setzt das Label. Fertig: Dialog unverändert, Whiteboard-Test grün, eigener Test für den Text. -### 4. `ExportService` +### 4. `ExportService` ✅ -Schreiben der Dateien, Pfadbildung und der Abschluss-Dialog bekommen einen -eigenen Baustein; der Controller reicht Kür, Format und Abschnitt durch. +`src/whiteboard/io/export_service.gd` schreibt SVG und PDF, legt den +Exportordner an, bildet Pfade und bereinigt Dateinamen. Der Controller +delegiert nur noch; `export_svg_to_path`/`export_pdf_to_path` bleiben als +schmale Einstiegspunkte, weil Tests sie direkt aufrufen. + +Bewusst im Controller geblieben: der Export-Dialog und der +Abschluss-Dialog (Szene), der PNG-Export (braucht ein SubViewport) und das +Öffnen im Dateimanager. ### 5. `SeasonPanel` diff --git a/docs/roadmap.md b/docs/roadmap.md index b8c1454..dc576bc 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -270,8 +270,8 @@ 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.566 Zeilen, - `HelpContent`, `SeasonComparisonText` und `ValidationReportView` ausgelagert. + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.529 Zeilen; `HelpContent`, `SeasonComparisonText`, + `ValidationReportView` und `ExportService` 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 e4a747c..a67bb82 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -95,7 +95,7 @@ const TOOL_ELEMENT_TYPES := [ PathSegment.ElementType.SPIN, ] const ROUTINES_DIR := "user://routines" -const EXPORTS_DIR := "user://exports" +const EXPORTS_DIR := ExportService.EXPORTS_DIR const EXPORT_SHEET_SCENE := preload("res://scenes/export/export_sheet.tscn") const PRESENTATION_3D_SCENE_PATH := "res://scenes/presentation3d/presentation_3d.tscn" const PLAYBACK_PLAY_ICON := preload("res://assets/icons/playback/play.svg") @@ -1000,20 +1000,16 @@ func _on_upgrade_pdf_pressed() -> void: if pdf.is_empty(): _show_message(I18n.t("Export fehlgeschlagen.")) return - _ensure_exports_dir() - var stem := _normalize_file_stem(_routine.title) - if stem.is_empty(): - stem = "kuer" + ExportService.ensure_dir() var season := _upgrade_target_season.replace("/", "-") - var path := EXPORTS_DIR.path_join( - "%s_saisonvergleich_%s.pdf" % [stem, season] + var path := ExportService.build_path( + ExportService.normalize_stem(_routine.title), + "_saisonvergleich_" + season, + "pdf" ) - var file := FileAccess.open(path, FileAccess.WRITE) - if file == null: + if not ExportService.write_bytes(path, pdf): _show_message(I18n.t("Export fehlgeschlagen.")) return - file.store_buffer(pdf) - file.close() _last_export_path = ProjectSettings.globalize_path(path) upgrade_dialog.hide() _show_export_done() @@ -5810,7 +5806,7 @@ func _on_save_as_confirmed() -> void: _show_message("Bitte einen Namen für die Kür eingeben.") return - var stem := _normalize_file_stem(name) + var stem := ExportService.normalize_stem(name) var path := ROUTINES_DIR.path_join(stem + ROUTINE_EXTENSION) var apply := func() -> void: _routine.title = name @@ -7327,7 +7323,7 @@ func _on_export_confirmed() -> void: _show_message("Bitte einen Dateinamen eingeben.") return - var stem := _normalize_file_stem(name) + var stem := ExportService.normalize_stem(name) var scope_section_id := "" var scope_suffix := "" if export_scope_option.selected == 1: @@ -7335,7 +7331,7 @@ func _on_export_confirmed() -> void: _show_message("Kein aktiver Abschnitt vorhanden.") return scope_section_id = _active_section.section_id - scope_suffix = "_" + _normalize_file_stem(_active_section.title) + scope_suffix = "_" + ExportService.normalize_stem(_active_section.title) var format := export_format_option.get_item_id( export_format_option.selected @@ -7360,7 +7356,7 @@ func _perform_export( format: int, scope_section_id: String ) -> void: - _ensure_exports_dir() + ExportService.ensure_dir() var success := false match format: @@ -7432,33 +7428,11 @@ func _on_export_copy_path_pressed() -> void: func export_svg_to_path(path: String, section_id: String = "") -> bool: - if _routine == null: - return false - var svg := RoutineSvgExporter.build(_routine, section_id) - if svg.is_empty(): - return false - - var file := FileAccess.open(path, FileAccess.WRITE) - if file == null: - return false - file.store_string(svg) - file.close() - return true + return ExportService.write_svg(_routine, path, section_id) func export_pdf_to_path(path: String, section_id: String = "") -> bool: - if _routine == null: - return false - var pdf := RoutinePdfExporter.build(_routine, section_id) - if pdf.is_empty(): - return false - - var file := FileAccess.open(path, FileAccess.WRITE) - if file == null: - return false - file.store_buffer(pdf) - file.close() - return true + return ExportService.write_pdf(_routine, path, section_id) func export_png_to_path(path: String, section_id: String = "") -> bool: @@ -7488,13 +7462,10 @@ func export_png_to_path(path: String, section_id: String = "") -> bool: return image.save_png(path) == OK -func _ensure_exports_dir() -> void: - if not DirAccess.dir_exists_absolute(EXPORTS_DIR): - DirAccess.make_dir_recursive_absolute(EXPORTS_DIR) func _open_exports_folder() -> void: - _ensure_exports_dir() + ExportService.ensure_dir() var folder := ProjectSettings.globalize_path(EXPORTS_DIR) var error := OS.shell_show_in_file_manager(folder) if error != OK: @@ -7693,7 +7664,7 @@ func _on_rename_routine_confirmed() -> void: if new_title.is_empty(): _show_message("Bitte einen Namen für die Kür eingeben.") return - var new_stem := _normalize_file_stem(new_title) + var new_stem := ExportService.normalize_stem(new_title) var old_stem := old_file.get_basename() if new_stem != old_stem: for extension: String in [ @@ -7946,14 +7917,6 @@ func _on_confirm_discard_canceled() -> void: _pending_action = Callable() -func _normalize_file_stem(name: String) -> String: - var stem := name.strip_edges().to_lower() - for character: String in ["/", "\\", ":", "*", "?", "\"", "<", ">", "|"]: - stem = stem.replace(character, "") - stem = stem.replace(" ", "_") - if stem.is_empty(): - stem = "kuer" - return stem func _show_message(text: String) -> void: diff --git a/rinkplanner/src/whiteboard/io/export_service.gd b/rinkplanner/src/whiteboard/io/export_service.gd new file mode 100644 index 0000000..5c7855f --- /dev/null +++ b/rinkplanner/src/whiteboard/io/export_service.gd @@ -0,0 +1,71 @@ +class_name ExportService +extends RefCounted + +## Writes exported documents and builds their paths. +## +## The dialogs ("Export", "Export abgeschlossen") stay in the controller; this +## service only knows the export folder, the file naming and how to serialise +## SVG and PDF. PNG needs a viewport and therefore stays in the controller. + +const EXPORTS_DIR := "user://exports" + + +static func ensure_dir() -> void: + if not DirAccess.dir_exists_absolute(EXPORTS_DIR): + DirAccess.make_dir_recursive_absolute(EXPORTS_DIR) + + +## Lower-case, space-free file stem. Falls back to "kuer" for empty titles. +static func normalize_stem(name: String) -> String: + var stem := name.strip_edges().to_lower() + for character: String in ["/", "\\", ":", "*", "?", "\"", "<", ">", "|"]: + stem = stem.replace(character, "") + stem = stem.replace(" ", "_") + if stem.is_empty(): + stem = "kuer" + return stem + + +## Full path inside the export folder, e.g. "user://exports/kuer_gold.pdf". +static func build_path(stem: String, suffix: String, extension: String) -> String: + return EXPORTS_DIR.path_join(stem + suffix + "." + extension) + + +static func write_bytes(path: String, bytes: PackedByteArray) -> bool: + if bytes.is_empty(): + return false + var file := FileAccess.open(path, FileAccess.WRITE) + if file == null: + return false + file.store_buffer(bytes) + file.close() + return true + + +static func write_svg( + routine: Routine, + path: String, + section_id: String = "" +) -> bool: + if routine == null: + return false + var svg := RoutineSvgExporter.build(routine, section_id) + if svg.is_empty(): + return false + var file := FileAccess.open(path, FileAccess.WRITE) + if file == null: + return false + file.store_string(svg) + file.close() + return true + + +static func write_pdf( + routine: Routine, + path: String, + section_id: String = "" +) -> bool: + if routine == null: + return false + var pdf := RoutinePdfExporter.build(routine, section_id) + return write_bytes(path, pdf) diff --git a/rinkplanner/src/whiteboard/io/export_service.gd.uid b/rinkplanner/src/whiteboard/io/export_service.gd.uid new file mode 100644 index 0000000..e865120 --- /dev/null +++ b/rinkplanner/src/whiteboard/io/export_service.gd.uid @@ -0,0 +1 @@ +uid://cl02cld4fbckd diff --git a/rinkplanner/tests/run_export_tests.gd b/rinkplanner/tests/run_export_tests.gd index 8dfe7bd..dda00a9 100644 --- a/rinkplanner/tests/run_export_tests.gd +++ b/rinkplanner/tests/run_export_tests.gd @@ -106,6 +106,23 @@ func _run() -> void: "the second section excludes the spin of section one" ) + # ExportService: Pfadbildung, Namensbereinigung und Schreiben. + _check( + ExportService.build_path("kuer", "_gold", "pdf").ends_with("kuer_gold.pdf"), + "the export path carries stem, suffix and extension" + ) + _check( + ExportService.normalize_stem("Kür 2026/27: Gold?").begins_with("kür_2026"), + "the file stem drops forbidden characters" + ) + var service_path := ExportService.build_path("service_test", "", "pdf") + _check(ExportService.write_pdf(routine, service_path), "the service writes a PDF") + _check( + FileAccess.file_exists(service_path), + "the written PDF exists" + ) + DirAccess.remove_absolute(service_path) + var pdf := RoutinePdfExporter.build(routine) var pdf_text := pdf.get_string_from_ascii() _check(pdf.size() > 1000, "PDF export produces data") From ef25c380c911462cbe1b8b2768c5a116a24a3278 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 13:30:36 +0100 Subject: [PATCH 08/28] refactor: Regelsatz als eigenes Objekt (RulesContext) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Etappe 5 der Controller-Zerlegung. Der Regelsatz liegt jetzt in `src/core/rules/rules_context.gd`: Er lädt die Bibliothek, merkt sich die Voreinstellung, wendet eine Saison an und hält die drei Dokumente (catalog, levels, adult). - Der Controller besitzt genau eine Instanz (`_ruleset`) statt sechs Feldern; alle Zugriffe laufen über sie. - `_load_default_rules` und `_apply_rules_for_season` delegieren nur noch. - `RulesContext` ist ohne Szene testbar (Saison laden, wechseln, leeren); eigener Test mit 10 Assertions. Bewusst offen: die drei Statusleisten-Widgets (Saison, Programm, Kategorie) und ihre Sync-Funktionen. Sie sind reine UI und bekommen einen eigenen Node-Schnitt (Etappe 6). Controller: 8.529 -> 8.513 Zeilen (überwiegend Struktur, nicht Zeilen). Suite grün. --- docs/refactor-whiteboard-controller.md | 39 ++-- docs/roadmap.md | 4 +- rinkplanner/src/core/rules/rules_context.gd | 71 +++++++ .../src/core/rules/rules_context.gd.uid | 1 + .../whiteboard/ctrl/whiteboard_controller.gd | 188 ++++++++---------- rinkplanner/tests/run_rules_audit_tests.gd | 25 +++ 6 files changed, 212 insertions(+), 116 deletions(-) create mode 100644 rinkplanner/src/core/rules/rules_context.gd create mode 100644 rinkplanner/src/core/rules/rules_context.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 6a5e909..a94832c 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–4 sind es 8.529 Zeilen. Diese Notiz +Etappen 1–5 sind es 8.513 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -29,11 +29,12 @@ passiert und nicht als Big Bang. | `SeasonComparisonText` | Zeilen für den Saisonvergleichs-Dialog | 175 | nur Daten | 2 ✅ | | `ValidationReportView` | Zeilen für den Prüfdialog | 300 | nur Daten | 3 ✅ | | `ExportService` | SVG/PDF schreiben, Pfade und Dateinamen | 90 | 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 | +| `RulesContext` | Regelsatz: Bibliothek, Paket, drei Dokumente | 80 | keine | 5 ✅ | +| `SeasonPanel` | Saison-/Programm-/Kategorieauswahl (Widgets) | ~180 | Statusleiste | 6 | +| `SyncPanel` | Dropbox-Sync, Konflikte, Küren verwalten | ~900 | Dialoge, Threads | 7 | +| `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 | Danach bleibt ein Controller von grob 2.000–2.500 Zeilen: Verdrahtung, Auswahl, Werkzeuge, Abschnitte, Undo/Redo, Statuszeile. @@ -75,19 +76,33 @@ Bewusst im Controller geblieben: der Export-Dialog und der Abschluss-Dialog (Szene), der PNG-Export (braucht ein SubViewport) und das Öffnen im Dateimanager. -### 5. `SeasonPanel` +### 5. `RulesContext` ✅ -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`. +Der Regelsatz selbst ist jetzt ein eigenes Objekt +(`src/core/rules/rules_context.gd`): Es lädt die Bibliothek, merkt sich die +Voreinstellung, wendet eine Saison an und hält die drei Dokumente +(`catalog`, `levels`, `adult`). Der Controller besitzt genau eine Instanz +(`_ruleset`) und greift nur noch über sie zu; `_load_default_rules` und +`_apply_rules_for_season` sind auf je ein paar Zeilen geschrumpft. -### 6–8. Sync, Hub, Playback +Damit ist die Regelauflösung testbar, ohne eine Szene zu bauen. + +Was noch offen bleibt: die drei Statusleisten-Widgets (Saison, Programm, +Kategorie) und ihre Sync-Funktionen. Sie sind reine UI und kommen als +eigener Node-Schnitt. + +### 6. `SeasonPanel` + +Saison-, Programm- und Kategorieauswahl als Widgets samt Sync-Funktionen +(`_sync_season_option`, `_setup_program_controls`, `set_season`, …). + +### 7–9. 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. -### 9. `ElementInspector` +### 10. `ElementInspector` Zuletzt: Element-Dialog, Feature-Auswahl, Fußzuordnung, Levelableitung. Der größte UI-Block und der, an dem am meisten hängt. diff --git a/docs/roadmap.md b/docs/roadmap.md index dc576bc..a7d4a53 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -270,8 +270,8 @@ 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.529 Zeilen; `HelpContent`, `SeasonComparisonText`, - `ValidationReportView` und `ExportService` ausgelagert. + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.513 Zeilen; `HelpContent`, `SeasonComparisonText`, + `ValidationReportView`, `ExportService` und `RulesContext` 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/core/rules/rules_context.gd b/rinkplanner/src/core/rules/rules_context.gd new file mode 100644 index 0000000..d17ed5b --- /dev/null +++ b/rinkplanner/src/core/rules/rules_context.gd @@ -0,0 +1,71 @@ +class_name RulesContext +extends RefCounted + +## Owns the season rulebooks of the whiteboard. +## +## The context discovers the season packages, keeps the one that is currently +## applied and exposes its three documents (`catalog`, `levels`, `adult`). The +## controller holds one instance and asks it to switch seasons; nothing else +## needs to know about [RulesLibrary] or [RulesPackage]. + +var library: RulesLibrary +var package: RulesPackage +## Season new routines start with (newest complete season by `valid_from`). +var default_season: String = "" + +var catalog: ElementCatalog +var levels: ElementLevelRules +var adult: AdultCategoryRules + + +## Scans the season folders and applies the default season. Returns the +## package, or null when no usable season was found. +func load_default() -> RulesPackage: + library = RulesLibrary.scan() + default_season = library.get_default_season() if library != null else "" + return apply(default_season) + + +## Applies one season. An empty or unknown season clears the documents on +## purpose: the app then says that it cannot check instead of silently using +## the wrong rulebook. Returns the applied package or null. +func apply(season: String) -> RulesPackage: + package = null + catalog = null + levels = null + adult = null + if library == null: + return null + var cleaned := season.strip_edges() + if cleaned.is_empty(): + return null + package = library.get_package(cleaned) + if package == null: + return null + catalog = package.catalog + levels = package.levels + adult = package.adult + return package + + +func has_season() -> bool: + return package != null + + +func is_complete() -> bool: + return package != null and package.is_complete() + + +func season_label() -> String: + if package != null and not package.season.is_empty(): + return package.season + return "" + + +func get_errors() -> PackedStringArray: + var errors := PackedStringArray() + if library != null: + errors.append_array(library.get_errors()) + if package != null: + errors.append_array(package.get_errors()) + return errors diff --git a/rinkplanner/src/core/rules/rules_context.gd.uid b/rinkplanner/src/core/rules/rules_context.gd.uid new file mode 100644 index 0000000..26d740f --- /dev/null +++ b/rinkplanner/src/core/rules/rules_context.gd.uid @@ -0,0 +1 @@ +uid://vppy828isg22 diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index a67bb82..af0b12e 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -337,12 +337,7 @@ var _direction: PathSegment.Direction = PathSegment.Direction.FORWARD var _edge: PathSegment.Edge = PathSegment.Edge.OUTSIDE var _element_type: PathSegment.ElementType = PathSegment.ElementType.JUMP var _element_level: int = 0 -var _element_catalog: ElementCatalog -var _level_rules: ElementLevelRules -var _adult_rules: AdultCategoryRules -var _rules_library: RulesLibrary -var _rules_package: RulesPackage -var _default_season: String = "" +var _ruleset: RulesContext = RulesContext.new() var _dialog_features: PackedStringArray = PackedStringArray() var _dialog_feature_feet: Dictionary[String, String] = {} var _dialog_jump_kind: PathSegment.JumpKind = PathSegment.JumpKind.SOLO @@ -604,7 +599,7 @@ func new_routine() -> void: var routine := Routine.new() routine.routine_id = "draft-routine" routine.title = "Neue Kür" - routine.season = _default_season + routine.season = _ruleset.default_season routine.rink = RinkDimensions.new() var section := RoutineSection.new() @@ -805,31 +800,32 @@ func get_element_level() -> int: func get_element_catalog() -> ElementCatalog: - return _element_catalog + return _ruleset.catalog func get_level_rules() -> ElementLevelRules: - return _level_rules + return _ruleset.levels func get_rules_package() -> RulesPackage: - return _rules_package + return _ruleset.package func get_rules_library() -> RulesLibrary: - return _rules_library + return _ruleset.library ## Loads the season package new routines start with. Seasons are discovered on ## disk; there is no hardcoded file name here. func _load_default_rules() -> void: - _rules_library = RulesLibrary.scan() - if not _rules_library.get_errors().is_empty(): - push_warning("Rules: %s" % ", ".join(_rules_library.get_errors())) - _default_season = _rules_library.get_default_season() - if _default_season.is_empty(): + var package := _ruleset.load_default() + if _ruleset.library != null and not _ruleset.library.get_errors().is_empty(): + push_warning("Rules: %s" % ", ".join(_ruleset.library.get_errors())) + if package == null: push_warning("Rules: keine nutzbare Saison gefunden") - _apply_rules_for_season(_default_season) + return + for error: String in package.get_errors(): + push_warning("Rules (%s): %s" % [package.season, error]) ## Resolves the rule package of one season and points the inspector, the @@ -837,28 +833,16 @@ func _load_default_rules() -> void: ## rules unset on purpose: the app then says that it cannot check instead of ## silently validating against the wrong rulebook. func _apply_rules_for_season(season: String) -> void: - _rules_package = null - _element_catalog = null - _level_rules = null - _adult_rules = null - if _rules_library == null: + var package := _ruleset.apply(season) + if package == null: return - var cleaned := season.strip_edges() - if cleaned.is_empty(): - return - _rules_package = _rules_library.get_package(cleaned) - if _rules_package == null: - return - for error: String in _rules_package.get_errors(): - push_warning("Rules (%s): %s" % [_rules_package.season, error]) - _element_catalog = _rules_package.catalog - _level_rules = _rules_package.levels - _adult_rules = _rules_package.adult + for error: String in package.get_errors(): + push_warning("Rules (%s): %s" % [package.season, error]) func _catalog_season_label() -> String: - if _rules_package != null and not _rules_package.season.is_empty(): - return _rules_package.season + if _ruleset.package != null and not _ruleset.package.season.is_empty(): + return _ruleset.package.season if _routine != null and not _routine.season.is_empty(): return _routine.season return I18n.t("nicht festgelegt") @@ -868,9 +852,9 @@ func _catalog_season_label() -> String: ## Paths and section bookkeeping are validated by the model itself. func validate_routine() -> Array[ValidationIssue]: var validator: RoutineValidator = ROUTINE_VALIDATOR_SCRIPT.new( - _element_catalog, - _level_rules, - _adult_rules + _ruleset.catalog, + _ruleset.levels, + _ruleset.adult ) return validator.validate(_routine) @@ -887,18 +871,18 @@ func open_validation_dialog() -> void: func _render_validation_dialog() -> void: var validator: RoutineValidator = ROUTINE_VALIDATOR_SCRIPT.new( - _element_catalog, - _level_rules, - _adult_rules + _ruleset.catalog, + _ruleset.levels, + _ruleset.adult ) var report := validator.validate_report(_routine) var category: AdultCategoryRules.Category = null if ( _routine != null and not _routine.adult_category.is_empty() - and _adult_rules != null + and _ruleset.adult != null ): - category = _adult_rules.get_category( + category = _ruleset.adult.get_category( _routine.adult_category, _routine.program_type ) @@ -927,9 +911,9 @@ func _render_validation_dialog() -> void: validation_dialog.popup_centered(target) func open_upgrade_dialog() -> void: - if _routine == null or _rules_package == null or _rules_library == null: + if _routine == null or _ruleset.package == null or _ruleset.library == null: return - if _rules_library.get_seasons().size() < 2: + if _ruleset.library.get_seasons().size() < 2: return _fill_upgrade_seasons() _run_upgrade_check() @@ -945,7 +929,7 @@ func open_upgrade_dialog() -> void: func _fill_upgrade_seasons() -> void: upgrade_season_option.clear() var current := _routine.season.strip_edges() - for season: String in _rules_library.get_seasons(): + for season: String in _ruleset.library.get_seasons(): if season == current: continue var index := upgrade_season_option.item_count @@ -963,17 +947,17 @@ func _selected_upgrade_season() -> String: func _run_upgrade_check() -> void: - if _routine == null or _rules_package == null or _rules_library == null: + if _routine == null or _ruleset.package == null or _ruleset.library == null: return var season := _selected_upgrade_season() _upgrade_target_season = season - var target := _rules_library.get_package(season) + var target := _ruleset.library.get_package(season) if target == null: upgrade_text.text = I18n.t("Ziel-Saison nicht verfügbar.") upgrade_apply_button.disabled = true upgrade_pdf_button.disabled = true return - _upgrade_report = SeasonUpgradeCheck.run(_routine, _rules_package, target) + _upgrade_report = SeasonUpgradeCheck.run(_routine, _ruleset.package, target) upgrade_text.text = I18n.join_lines( SeasonComparisonText.build(_routine, _upgrade_report) ) @@ -1049,9 +1033,9 @@ func _on_validation_meta_clicked(meta: Variant) -> void: func _can_compare_seasons() -> bool: return ( - _rules_package != null - and _rules_library != null - and _rules_library.get_seasons().size() > 1 + _ruleset.package != null + and _ruleset.library != null + and _ruleset.library.get_seasons().size() > 1 ) @@ -1168,17 +1152,17 @@ func update_element_feature_hint() -> void: if type == PathSegment.ElementType.JUMP: element_feature_hint.text = "Sprünge haben keine Level-Features." return - if _level_rules == null: + if _ruleset.levels == null: element_feature_hint.text = "" return if code.is_empty(): element_feature_hint.text = "Kürzel wählen, um Level-Features zu erfassen." return - if _element_catalog == null or not _element_catalog.has_code(code): + if _ruleset.catalog == null or not _ruleset.catalog.has_code(code): element_feature_hint.text = "Kürzel nicht im Katalog." return - var result := _level_rules.calculate_level( + var result := _ruleset.levels.calculate_level( type, code, features, @@ -1244,10 +1228,10 @@ func _open_feature_menu() -> void: ## Fills the feature menu from the pending dialog state. Split from the popup ## call so tests can inspect the items without opening a window. func _populate_feature_menu() -> bool: - if _level_rules == null or not element_dialog.visible: + if _ruleset.levels == null or not element_dialog.visible: return false var type := _dialog_element_type() - var features := _level_rules.get_features(type) + var features := _ruleset.levels.get_features(type) if features.is_empty(): return false @@ -1322,22 +1306,22 @@ func _update_feature_foot_panel() -> void: child.free() var per_foot: Array[ElementFeature] = [] - if _level_rules != null and _element_catalog != null: - var definition := _element_catalog.find(_dialog_element_code()) + if _ruleset.levels != null and _ruleset.catalog != null: + var definition := _ruleset.catalog.find(_dialog_element_code()) if ( definition != null and definition.element_type == PathSegment.ElementType.SPIN and definition.change_of_foot ): - for feature: ElementFeature in _level_rules.get_features( + for feature: ElementFeature in _ruleset.levels.get_features( PathSegment.ElementType.SPIN ): if feature.per_foot and _dialog_features.has(feature.code): per_foot.append(feature) var maximum := 0 - if _level_rules != null: - maximum = _level_rules.get_max_features_per_foot( + if _ruleset.levels != null: + maximum = _ruleset.levels.get_max_features_per_foot( PathSegment.ElementType.SPIN ) var needed := maximum > 0 and per_foot.size() > maximum @@ -1407,7 +1391,7 @@ func _refresh_foot_buttons() -> void: func update_element_value_hint() -> void: if element_value_label == null: return - if _element_catalog == null: + if _ruleset.catalog == null: element_value_label.text = "" return @@ -1419,7 +1403,7 @@ func update_element_value_hint() -> void: if element_level_option.selected >= 0: level = element_level_option.get_item_id(element_level_option.selected) var code := _dialog_element_code() - var source := "%s · %s" % [_element_catalog.season, _element_catalog.source] + var source := "%s · %s" % [_ruleset.catalog.season, _ruleset.catalog.source] element_value_label.tooltip_text = source if type == PathSegment.ElementType.NONE or code.is_empty(): @@ -1441,7 +1425,7 @@ func update_element_value_hint() -> void: if not parts.is_empty(): value = 0.0 for part: String in parts: - var part_value := _element_catalog.get_base_value( + var part_value := _ruleset.catalog.get_base_value( part, 0, PathSegment.ElementType.JUMP @@ -1451,10 +1435,10 @@ func update_element_value_hint() -> void: break value += part_value else: - value = _element_catalog.get_base_value(code, level, type) + value = _ruleset.catalog.get_base_value(code, level, type) if value < 0.0: element_value_label.text = ( - I18n.t("Base Value: – (Kürzel nicht im Katalog %s)") % _element_catalog.season + I18n.t("Base Value: – (Kürzel nicht im Katalog %s)") % _ruleset.catalog.season ) return element_value_label.text = ( @@ -1503,16 +1487,16 @@ func _is_derived_level( return true if ( type == PathSegment.ElementType.NONE - or _element_catalog == null - or _level_rules == null + or _ruleset.catalog == null + or _ruleset.levels == null ): return false - var definition := _element_catalog.find(code) + var definition := _ruleset.catalog.find(code) if definition == null or definition.element_type != type: return false - if _level_rules.get_fixed_level(type, code) >= 0: + if _ruleset.levels.get_fixed_level(type, code) >= 0: return true - return not _level_rules.get_features(type).is_empty() + return not _ruleset.levels.get_features(type).is_empty() func _derived_level( @@ -1523,9 +1507,9 @@ func _derived_level( ) -> int: if type == PathSegment.ElementType.JUMP: return 0 - if _level_rules == null: + if _ruleset.levels == null: return 0 - return _level_rules.calculate_level(type, code, features, feet).level + return _ruleset.levels.calculate_level(type, code, features, feet).level ## Keeps only the feet of selected features and normalises them to L/R. @@ -1570,9 +1554,9 @@ func _populate_code_options(type: PathSegment.ElementType) -> void: "— Kürzel wählen —", CODE_OPTION_PLACEHOLDER_ID ) - if _element_catalog != null and type != PathSegment.ElementType.NONE: - for family: String in _element_catalog.get_codes(type): - var definition := _element_catalog.find(family) + if _ruleset.catalog != null and type != PathSegment.ElementType.NONE: + for family: String in _ruleset.catalog.get_codes(type): + var definition := _ruleset.catalog.find(family) var label := family if definition != null and not definition.display_name.is_empty(): label = "%s — %s" % [family, definition.display_name] @@ -1604,8 +1588,8 @@ func _select_code_in_option( return var definition: ElementDefinition = null - if _element_catalog != null: - definition = _element_catalog.find(cleaned) + if _ruleset.catalog != null: + definition = _ruleset.catalog.find(cleaned) if definition != null and definition.element_type == type: var family := definition.code var index := _find_code_option_index(family) @@ -1613,11 +1597,11 @@ func _select_code_in_option( element_code_option.select(index) element_code_edit.text = family _set_code_free_text(false) - var suffix := _element_catalog.get_level_suffix(cleaned) + var suffix := _ruleset.catalog.get_level_suffix(cleaned) if suffix >= 0: _select_level_option(suffix) - elif _level_rules != null: - var fixed := _level_rules.get_fixed_level(type, family) + elif _ruleset.levels != null: + var fixed := _ruleset.levels.get_fixed_level(type, family) if fixed >= 0: _select_level_option(fixed) return @@ -1667,8 +1651,8 @@ func _on_element_code_option_selected(index: int) -> void: var type: PathSegment.ElementType = element_dialog_type_option.get_item_id( element_dialog_type_option.selected ) - if _level_rules != null: - var fixed := _level_rules.get_fixed_level(type, family) + if _ruleset.levels != null: + var fixed := _ruleset.levels.get_fixed_level(type, family) if fixed >= 0: _select_level_option(fixed) _update_level_control_state() @@ -1681,12 +1665,12 @@ func _populate_jump_extra_options() -> void: option.clear() option.add_item("— kein weiterer Sprung —", 0) option.set_item_metadata(0, "") - if _element_catalog == null: + if _ruleset.catalog == null: continue - for family: String in _element_catalog.get_codes( + for family: String in _ruleset.catalog.get_codes( PathSegment.ElementType.JUMP ): - var definition := _element_catalog.find(family) + var definition := _ruleset.catalog.find(family) var label := family if definition != null and not definition.display_name.is_empty(): label = "%s — %s" % [family, definition.display_name] @@ -1827,18 +1811,18 @@ func _normalize_element_input( var cleaned := code.strip_edges().left(PathSegment.ELEMENT_CODE_MAX_LENGTH) var clamped := clampi(level, 0, PathSegment.ELEMENT_MAX_LEVEL) if ( - _element_catalog == null + _ruleset.catalog == null or type == PathSegment.ElementType.NONE or cleaned.length() < 2 ): return {"code": cleaned, "level": clamped} - var suffix := _element_catalog.get_level_suffix(cleaned) + var suffix := _ruleset.catalog.get_level_suffix(cleaned) if suffix < 0: return {"code": cleaned, "level": clamped} var family := cleaned.left(cleaned.length() - 1) - var definition := _element_catalog.find(family) + var definition := _ruleset.catalog.find(family) if definition == null or definition.element_type != type: return {"code": cleaned, "level": clamped} if not definition.has_level(suffix): @@ -2477,8 +2461,8 @@ func _setup_adult_category_controls() -> void: adult_category_option.clear() adult_category_option.add_item("Ohne Kategorie", 0) adult_category_option.set_item_metadata(0, "") - if _adult_rules != null: - for category: AdultCategoryRules.Category in _adult_rules.get_categories( + if _ruleset.adult != null: + for category: AdultCategoryRules.Category in _ruleset.adult.get_categories( _program_type() ): var index := adult_category_option.item_count @@ -2562,8 +2546,8 @@ func set_adult_category(code: String) -> bool: if ( not cleaned.is_empty() and ( - _adult_rules == null - or not _adult_rules.has_category(cleaned, _program_type()) + _ruleset.adult == null + or not _ruleset.adult.has_category(cleaned, _program_type()) ) ): return false @@ -2582,7 +2566,7 @@ func get_adult_category() -> String: func get_adult_rules() -> AdultCategoryRules: - return _adult_rules + return _ruleset.adult func _sync_adult_category_option() -> void: @@ -2645,12 +2629,12 @@ func _sync_season_option() -> void: season_option.set_item_metadata(0, "") selected = 0 - if _rules_library != null: - for season: String in _rules_library.get_seasons(): + if _ruleset.library != null: + for season: String in _ruleset.library.get_seasons(): var index := season_option.item_count var label := I18n.t("Saison %s") % season var status := str( - _rules_library.get_manifest(season).get("status", "complete") + _ruleset.library.get_manifest(season).get("status", "complete") ).strip_edges() if status != "complete": label += " " + I18n.t("(unvollständig)") @@ -2686,7 +2670,7 @@ func _season_tooltip(current: String) -> String: ## Best guess for a routine that predates the season field: the season that was ## valid when its file was last written. Only used as a hint, never applied. func _infer_season_from_current_path() -> String: - if _current_path.is_empty() or _rules_library == null: + if _current_path.is_empty() or _ruleset.library == null: return "" if not FileAccess.file_exists(_current_path): return "" @@ -2694,7 +2678,7 @@ func _infer_season_from_current_path() -> String: if unix <= 0: return "" var date := Time.get_date_string_from_unix_time(unix) - return _rules_library.get_default_season(date) + return _ruleset.library.get_default_season(date) func _on_season_selected(index: int) -> void: @@ -2712,7 +2696,7 @@ func set_season(season: String) -> bool: return false if ( not cleaned.is_empty() - and (_rules_library == null or not _rules_library.has_season(cleaned)) + and (_ruleset.library == null or not _ruleset.library.has_season(cleaned)) ): return false _record_undo() @@ -2735,7 +2719,7 @@ func get_season() -> String: ## One line that explains why the check cannot use a rule package, if that is ## the case. Empty when the season resolved normally. func _season_note() -> String: - if _rules_package != null: + if _ruleset.package != null: return "" var raw := _routine.season.strip_edges() if _routine != null else "" if raw.is_empty(): diff --git a/rinkplanner/tests/run_rules_audit_tests.gd b/rinkplanner/tests/run_rules_audit_tests.gd index bd41066..91bde63 100644 --- a/rinkplanner/tests/run_rules_audit_tests.gd +++ b/rinkplanner/tests/run_rules_audit_tests.gd @@ -20,6 +20,7 @@ func _init() -> void: _test_season_pair_difference() _test_upgrade_check() _test_season_comparison_text() + _test_rules_context() _cleanup() _finish() @@ -291,6 +292,30 @@ func _test_season_comparison_text() -> void: ) + +## Der Regelsatz als eigenes Objekt: Saison laden, wechseln, leeren. +func _test_rules_context() -> void: + var context := RulesContext.new() + var package := context.load_default() + _check(package != null, "the rules context loads the default season") + _check( + context.catalog != null and context.levels != null and context.adult != null, + "the context exposes the three documents" + ) + _check( + context.season_label() == context.library.get_default_season(), + "the context reports the default season" + ) + var older := context.apply("2025/26") + _check(older != null, "the context switches to an older season") + _check(context.season_label() == "2025/26", "the applied season is reported") + _check(context.adult != null, "2025/26 has adult rules") + _check(context.apply("") == null, "an empty season applies nothing") + _check(context.catalog == null, "an empty season clears the documents") + context.apply("2030/31") + _check(context.package == null, "an unknown season clears the documents") + + func _make_pair_routine() -> Routine: var routine := Routine.new() routine.routine_id = "season-pair" From dbc7e1e4845c1c62c3a92a818f0babdf801b790f Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 13:32:30 +0100 Subject: [PATCH 09/28] =?UTF-8?q?refactor:=20Inhalt=20der=20Statusleisten-?= =?UTF-8?q?Auswahl=20aus=20dem=20Controller=20l=C3=B6sen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Etappe 6 der Controller-Zerlegung. `SeasonPanelModel` (src/whiteboard/view/season_panel_model.gd) baut den Inhalt der drei Dropdowns: Beschriftungen, Werte und die passende Auswahl, zurückgegeben als `{"items": [...], "selected": int}`. - Der Controller füllt seine OptionButtons nur noch über `_fill_option()`; Signalverdrahtung und Zustand bleiben bei ihm. - `_season_tooltip()` entfällt, die Tooltip-Texte kommen ebenfalls aus dem Modell. - Test für die Fälle, die vorher nur über die Szene prüfbar waren: "nicht festgelegt", unbekannte Saison, unbekannte Kategorie (bleibt als "nicht verfügbar" sichtbar), Programmtyp. Controller: 8.513 -> 8.459 Zeilen. Kein Verhalten geändert, Suite grün. Offen bleibt der Node-Schnitt der Widgets; er ändert nur die Verdrahtung und lohnt erst mit der UI-Gliederung. --- docs/refactor-whiteboard-controller.md | 23 +++- docs/roadmap.md | 5 +- .../whiteboard/ctrl/whiteboard_controller.gd | 118 +++++------------- .../src/whiteboard/view/season_panel_model.gd | 93 ++++++++++++++ .../whiteboard/view/season_panel_model.gd.uid | 1 + rinkplanner/tests/run_rules_audit_tests.gd | 48 +++++++ 6 files changed, 195 insertions(+), 93 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/season_panel_model.gd create mode 100644 rinkplanner/src/whiteboard/view/season_panel_model.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index a94832c..4e6f7df 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–5 sind es 8.513 Zeilen. Diese Notiz +Etappen 1–6 sind es 8.459 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -30,7 +30,7 @@ passiert und nicht als Big Bang. | `ValidationReportView` | Zeilen für den Prüfdialog | 300 | nur Daten | 3 ✅ | | `ExportService` | SVG/PDF schreiben, Pfade und Dateinamen | 90 | Dateisystem | 4 ✅ | | `RulesContext` | Regelsatz: Bibliothek, Paket, drei Dokumente | 80 | keine | 5 ✅ | -| `SeasonPanel` | Saison-/Programm-/Kategorieauswahl (Widgets) | ~180 | Statusleiste | 6 | +| `SeasonPanelModel` | Inhalt der drei Dropdowns | 120 | keine | 6 ✅ | | `SyncPanel` | Dropbox-Sync, Konflikte, Küren verwalten | ~900 | Dialoge, Threads | 7 | | `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 8 | | `PlaybackPanel` | Wiedergabe, Musik, Timeline-Labels | ~600 | Canvas, Audio | 9 | @@ -91,10 +91,23 @@ Was noch offen bleibt: die drei Statusleisten-Widgets (Saison, Programm, Kategorie) und ihre Sync-Funktionen. Sie sind reine UI und kommen als eigener Node-Schnitt. -### 6. `SeasonPanel` +### 6. `SeasonPanelModel` ✅ -Saison-, Programm- und Kategorieauswahl als Widgets samt Sync-Funktionen -(`_sync_season_option`, `_setup_program_controls`, `set_season`, …). +Der Inhalt der drei Dropdowns (Saison, Programm, Kategorie) liegt in +`src/whiteboard/view/season_panel_model.gd`: reine Funktionen, die +Beschriftungen und Werte bauen und die passende Auswahl zurückgeben +(`{"items": […], "selected": int}`). Der Controller füllt seine +OptionButtons nur noch über `_fill_option()` und behält die +Signalverdrahtung. + +Damit sind Fälle testbar, die vorher nur über die Szene prüfbar waren: +„nicht festgelegt", unbekannte Saison, unbekannte Kategorie (bleibt als +„nicht verfügbar" sichtbar), Programmtyp. + +Noch offen: die Widgets selbst als Node mit Signalen. Das ist reiner +Verdrahtungsumbau ohne Verhaltensänderung und lohnt erst, wenn Panels auch +Layout-Verantwortung übernehmen (Roadmap: „UI in logische Bereiche +gliedern"). ### 7–9. Sync, Hub, Playback diff --git a/docs/roadmap.md b/docs/roadmap.md index a7d4a53..c70ad87 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -270,8 +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.513 Zeilen; `HelpContent`, `SeasonComparisonText`, - `ValidationReportView`, `ExportService` und `RulesContext` ausgelagert. + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.459 Zeilen; `HelpContent`, `SeasonComparisonText`, + `ValidationReportView`, `ExportService`, `RulesContext` und + `SeasonPanelModel` 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 af0b12e..4b54bf2 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -2458,16 +2458,8 @@ func _setup_element_controls() -> void: func _setup_adult_category_controls() -> void: - adult_category_option.clear() - adult_category_option.add_item("Ohne Kategorie", 0) - adult_category_option.set_item_metadata(0, "") - if _ruleset.adult != null: - for category: AdultCategoryRules.Category in _ruleset.adult.get_categories( - _program_type() - ): - var index := adult_category_option.item_count - adult_category_option.add_item(category.name, index) - adult_category_option.set_item_metadata(index, category.code) + if adult_category_option == null: + return if not adult_category_option.item_selected.is_connected( _on_adult_category_selected ): @@ -2475,7 +2467,6 @@ func _setup_adult_category_controls() -> void: _sync_adult_category_option() -## Programme type of the current routine: "free" (Kür) or "artistic". func _program_type() -> String: if _routine == null: return AdultCategoryRules.PROGRAM_FREE @@ -2485,11 +2476,6 @@ func _program_type() -> String: func _setup_program_controls() -> void: if program_option == null: return - program_option.clear() - program_option.add_item(I18n.t("Kür"), 0) - program_option.set_item_metadata(0, AdultCategoryRules.PROGRAM_FREE) - program_option.add_item(I18n.t("Artistic"), 1) - program_option.set_item_metadata(1, AdultCategoryRules.PROGRAM_ARTISTIC) if not program_option.item_selected.is_connected(_on_program_selected): program_option.item_selected.connect(_on_program_selected) _sync_program_option() @@ -2498,12 +2484,7 @@ func _setup_program_controls() -> void: func _sync_program_option() -> void: if program_option == null: return - var program := _program_type() - for index: int in range(program_option.item_count): - if str(program_option.get_item_metadata(index)) == program: - program_option.select(index) - return - program_option.select(0) + _fill_option(program_option, SeasonPanelModel.program_items(_program_type())) func _on_program_selected(index: int) -> void: @@ -2572,28 +2553,31 @@ func get_adult_rules() -> AdultCategoryRules: func _sync_adult_category_option() -> void: if adult_category_option == null: return - var code := _routine.adult_category if _routine != null else "" - for index: int in range(adult_category_option.item_count): - if str(adult_category_option.get_item_metadata(index)) == code: - adult_category_option.select(index) - return - # The stored category is not part of this season. Show it instead of - # pretending the routine has no category. - if not code.is_empty(): - var index := adult_category_option.item_count - adult_category_option.add_item( - I18n.t("Kategorie „%s“ nicht verfügbar") % code.capitalize(), - index + var categories: Array = [] + if _ruleset.adult != null: + categories.assign(_ruleset.adult.get_categories(_program_type())) + _fill_option( + adult_category_option, + SeasonPanelModel.category_items( + _routine.adult_category if _routine != null else "", + categories ) - adult_category_option.set_item_metadata(index, code) - adult_category_option.select(index) - return - if adult_category_option.item_count > 0: - adult_category_option.select(0) + ) + + +## Fills an OptionButton from a SeasonPanelModel result. +func _fill_option(option: OptionButton, content: Dictionary) -> void: + option.clear() + var items: Array = content.get("items", []) + for index: int in range(items.size()): + var item: Dictionary = items[index] + option.add_item(str(item.get("label", "")), index) + option.set_item_metadata(index, str(item.get("value", ""))) + var selected := int(content.get("selected", -1)) + if selected >= 0: + option.select(selected) -## Fills the season dropdown. The list comes from the rules library, so a new -## season folder appears without touching this code. func _setup_upgrade_controls() -> void: if upgrade_run_button != null: upgrade_run_button.pressed.connect(_run_upgrade_check) @@ -2621,54 +2605,16 @@ func _sync_season_option() -> void: if season_option == null: return var current := _routine.season.strip_edges() if _routine != null else "" - season_option.clear() - - var selected := -1 - if current.is_empty(): - season_option.add_item(I18n.t("Saison nicht festgelegt"), 0) - season_option.set_item_metadata(0, "") - selected = 0 - - if _ruleset.library != null: - for season: String in _ruleset.library.get_seasons(): - var index := season_option.item_count - var label := I18n.t("Saison %s") % season - var status := str( - _ruleset.library.get_manifest(season).get("status", "complete") - ).strip_edges() - if status != "complete": - label += " " + I18n.t("(unvollständig)") - season_option.add_item(label, index) - season_option.set_item_metadata(index, season) - if season == current: - selected = index - - if not current.is_empty() and selected < 0: - var index := season_option.item_count - season_option.add_item(I18n.t("Saison %s (unbekannt)") % current, index) - season_option.set_item_metadata(index, current) - selected = index - - if selected >= 0: - season_option.select(selected) - season_option.tooltip_text = _season_tooltip(current) - - -func _season_tooltip(current: String) -> String: - if not current.is_empty(): - return I18n.t("Regelwerk, gegen das diese Kür geprüft wird") - var inferred := _infer_season_from_current_path() - if inferred.is_empty(): - return I18n.t("Ohne Saison kann die Kür nicht geprüft werden") - return ( - I18n.t("Ohne Saison kann die Kür nicht geprüft werden") - + " " - + I18n.t("Vermutlich Saison %s (Dateidatum).") % inferred + _fill_option( + season_option, + SeasonPanelModel.season_items(current, _ruleset.library) + ) + season_option.tooltip_text = SeasonPanelModel.season_tooltip( + current, + _infer_season_from_current_path() ) -## Best guess for a routine that predates the season field: the season that was -## valid when its file was last written. Only used as a hint, never applied. func _infer_season_from_current_path() -> String: if _current_path.is_empty() or _ruleset.library == null: return "" diff --git a/rinkplanner/src/whiteboard/view/season_panel_model.gd b/rinkplanner/src/whiteboard/view/season_panel_model.gd new file mode 100644 index 0000000..c2e08d0 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/season_panel_model.gd @@ -0,0 +1,93 @@ +class_name SeasonPanelModel +extends RefCounted + +## Content of the three status bar dropdowns: season, programme type and adult +## category. +## +## Pure functions: they build labels and metadata, but never touch a node. The +## controller fills its OptionButtons from the result and keeps the signal +## wiring. Returns `{"items": [{"label": String, "value": String}], "selected": int}`. + +const NO_CATEGORY := "Ohne Kategorie" + + +static func season_items(current: String, library: RulesLibrary) -> Dictionary: + var items: Array[Dictionary] = [] + var selected := -1 + var cleaned := current.strip_edges() + + if cleaned.is_empty(): + items.append({"label": I18n.t("Saison nicht festgelegt"), "value": ""}) + selected = 0 + + if library != null: + for season: String in library.get_seasons(): + var label := I18n.t("Saison %s") % season + var status := str( + library.get_manifest(season).get("status", "complete") + ).strip_edges() + if status != "complete": + label += " " + I18n.t("(unvollständig)") + items.append({"label": label, "value": season}) + if season == cleaned: + selected = items.size() - 1 + + if not cleaned.is_empty() and selected < 0: + items.append( + { + "label": I18n.t("Saison %s (unbekannt)") % cleaned, + "value": cleaned, + } + ) + selected = items.size() - 1 + + return {"items": items, "selected": selected} + + +static func program_items(current: String) -> Dictionary: + var items: Array[Dictionary] = [ + {"label": I18n.t("Kür"), "value": AdultCategoryRules.PROGRAM_FREE}, + {"label": I18n.t("Artistic"), "value": AdultCategoryRules.PROGRAM_ARTISTIC}, + ] + var selected := 0 + for index: int in range(items.size()): + if str(items[index]["value"]) == current: + selected = index + return {"items": items, "selected": selected} + + +## Categories of one programme type plus "no category". A stored code that the +## season does not know stays visible as "nicht verfügbar" instead of silently +## selecting "no category". +static func category_items( + current: String, + categories: Array +) -> Dictionary: + var items: Array[Dictionary] = [{"label": NO_CATEGORY, "value": ""}] + var cleaned := current.strip_edges() + for category: AdultCategoryRules.Category in categories: + items.append({"label": category.name, "value": category.code}) + + for index: int in range(items.size()): + if str(items[index]["value"]) == cleaned: + return {"items": items, "selected": index} + + if not cleaned.is_empty(): + items.append( + { + "label": I18n.t("Kategorie „%s“ nicht verfügbar") % cleaned.capitalize(), + "value": cleaned, + } + ) + return {"items": items, "selected": items.size() - 1} + + return {"items": items, "selected": 0} + + +static func season_tooltip(current: String, inferred: String) -> String: + if not current.strip_edges().is_empty(): + return I18n.t("Regelwerk, gegen das diese Kür geprüft wird") + var base := I18n.t("Ohne Saison kann die Kür nicht geprüft werden") + if inferred.is_empty(): + return base + return base + " " + I18n.t("Vermutlich Saison %s (Dateidatum).") % inferred diff --git a/rinkplanner/src/whiteboard/view/season_panel_model.gd.uid b/rinkplanner/src/whiteboard/view/season_panel_model.gd.uid new file mode 100644 index 0000000..d601a60 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/season_panel_model.gd.uid @@ -0,0 +1 @@ +uid://cpd3460lrabou diff --git a/rinkplanner/tests/run_rules_audit_tests.gd b/rinkplanner/tests/run_rules_audit_tests.gd index 91bde63..c4e9858 100644 --- a/rinkplanner/tests/run_rules_audit_tests.gd +++ b/rinkplanner/tests/run_rules_audit_tests.gd @@ -21,6 +21,7 @@ func _init() -> void: _test_upgrade_check() _test_season_comparison_text() _test_rules_context() + _test_season_panel_model() _cleanup() _finish() @@ -316,6 +317,53 @@ func _test_rules_context() -> void: _check(context.package == null, "an unknown season clears the documents") + +## Inhalt der Statusleisten-Auswahl: Beschriftung, Zuordnung, Auswahl. +func _test_season_panel_model() -> void: + var library := RulesLibrary.scan() + + var empty := SeasonPanelModel.season_items("", library) + _check(int(empty["selected"]) == 0, "without a season the first entry is selected") + _check(str(empty["items"][0]["value"]) == "", "the first entry has no value") + + var current := SeasonPanelModel.season_items("2026/27", library) + _check( + str(current["items"][int(current["selected"])]["value"]) == "2026/27", + "the current season is selected" + ) + var unknown := SeasonPanelModel.season_items("2030/31", library) + _check( + str(unknown["items"][int(unknown["selected"])]["value"]) == "2030/31", + "an unknown season stays visible" + ) + + var categories: Array = [] + var package := library.get_package("2026/27") + if package != null and package.adult != null: + categories.assign(package.adult.get_categories("free")) + _check(categories.size() == 5, "the free-skating categories are offered") + var known := SeasonPanelModel.category_items("gold", categories) + _check( + str(known["items"][int(known["selected"])]["value"]) == "gold", + "a known category is selected" + ) + var missing := SeasonPanelModel.category_items("legacy", categories) + _check( + str(missing["items"][int(missing["selected"])]["value"]) == "legacy", + "an unknown category stays visible" + ) + _check( + str(missing["items"][int(missing["selected"])]["label"]).contains( + "nicht verfügbar" + ), + "an unknown category is labelled" + ) + _check( + SeasonPanelModel.program_items("artistic")["selected"] == 1, + "the artistic programme is selected" + ) + + func _make_pair_routine() -> Routine: var routine := Routine.new() routine.routine_id = "season-pair" From 5bec745825856e317d3b0248a15da0d950949d2f Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 13:42:31 +0100 Subject: [PATCH 10/28] refactor: Sync-Zusammenfassung als eigener Text-Baustein MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- docs/refactor-whiteboard-controller.md | 25 ++++++-- docs/roadmap.md | 6 +- .../whiteboard/ctrl/whiteboard_controller.gd | 49 +--------------- .../src/whiteboard/view/sync_summary_text.gd | 58 +++++++++++++++++++ .../whiteboard/view/sync_summary_text.gd.uid | 1 + rinkplanner/tests/run_sync_tests.gd | 2 +- 6 files changed, 83 insertions(+), 58 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/sync_summary_text.gd create mode 100644 rinkplanner/src/whiteboard/view/sync_summary_text.gd.uid 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": [], From 3e0c6e109d5a3689d0c83bafe0bfbba1c87bb7bb Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 14:25:03 +0100 Subject: [PATCH 11/28] refactor: Wiedergabe-Geometrie als eigenes Objekt (PlaybackPose) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Etappe 8 der Controller-Zerlegung. `PlaybackPose.compute(entries, time, previous_heading, delta, force_heading)` liefert Segment, Position, Blickrichtung und Markergröße — inklusive der Markenlogik: Pirouetten drehen mit der Standzeit, Sprünge drehen pro Umdrehung und wandern entlang des Sprungvektors, Laufwege folgen der Kurve, Rückwärtsfahrt dreht die Richtung. - Der Controller setzt das Ergebnis nur noch auf Canvas, 3D-Vorschau und Oberfläche; `_entry_arrival_heading` ist mit umgezogen. - Die Umdrehungsrate für Altdaten ohne geplante Umdrehungen steht einmal in `PlaybackPose`; der Controller verweist darauf. - Abgesichert durch die bestehenden Wiedergabetests (121 Assertions), die Positionen und Blickrichtungen über die ganze Kür prüfen. Controller: 8.412 -> 8.304 Zeilen. Kein Verhalten geändert, Suite grün. Offen: Steuerung, Musik, Timeline-Labels und die 3D-Anbindung. --- docs/refactor-whiteboard-controller.md | 21 ++- docs/roadmap.md | 4 +- .../whiteboard/ctrl/whiteboard_controller.gd | 156 +++-------------- .../src/whiteboard/view/playback_pose.gd | 160 ++++++++++++++++++ .../src/whiteboard/view/playback_pose.gd.uid | 1 + 5 files changed, 203 insertions(+), 139 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/playback_pose.gd create mode 100644 rinkplanner/src/whiteboard/view/playback_pose.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 4c7d96a..743eeee 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–7 sind es 8.412 Zeilen. Diese Notiz +Etappen 1–8 sind es 8.304 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -34,7 +34,8 @@ passiert und nicht als Big Bang. | `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 | +| `PlaybackPose` | Position und Blickrichtung zur Zeit | 130 | keine | 8 ✅ | +| Playback-Rest | Steuerung, Musik, Timeline, 3D-Anbindung | ~470 | Canvas, Audio | offen | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 | Danach bleibt ein Controller von grob 2.000–2.500 Zeilen: Verdrahtung, @@ -123,10 +124,20 @@ 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 +### 8. `PlaybackPose` ✅ -Dieselbe Bauart: Dialoge und Threads als Node mit Signalen, reine Text- und -Rechenanteile vorher herausziehen. +Die Wiedergabe-Geometrie liegt in `src/whiteboard/view/playback_pose.gd`: +`compute(entries, time, previous_heading, delta, force_heading)` liefert +Segment, Position, Blickrichtung und Markergröße. Die Markenlogik (Pirouette +dreht mit der Standzeit, Sprung dreht pro Umdrehung und wandert entlang des +Sprungvektors, Laufwege folgen der Kurve) steckt vollständig dort. + +Der Controller wendet das Ergebnis nur noch auf Canvas, 3D-Vorschau und +Oberfläche an. Abgesichert durch die bestehenden Wiedergabetests (121 +Assertions). + +**Offen:** Steuerung (Start/Pause/Reset, Geschwindigkeit), Musik und +Timeline-Labels sowie die 3D-Anbindung. ### 10. `ElementInspector` diff --git a/docs/roadmap.md b/docs/roadmap.md index b5b50fe..3308cf5 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.412 Zeilen; `HelpContent`, `SeasonComparisonText`, + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.304 Zeilen; `HelpContent`, `SeasonComparisonText`, `ValidationReportView`, `ExportService`, `RulesContext`, - `SeasonPanelModel` und `SyncSummaryText` ausgelagert. + `SeasonPanelModel`, `SyncSummaryText` und `PlaybackPose` 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 a7c8e5c..2d8ec2a 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -57,7 +57,7 @@ const DEFAULT_PROFILE_INDEX := 2 ## spin marker. Modern spins rotate around 2-3 rev/s (elite upright/scratch ## spins up to 5); 1.5 rev/s looked too sluggish. See ## docs/speed-assumptions.md, section 8. -const SPIN_REVOLUTIONS_PER_SECOND := 2.5 +const SPIN_REVOLUTIONS_PER_SECOND := PlaybackPose.SPIN_REVOLUTIONS_PER_SECOND const ELEMENT_DEFAULT_DURATIONS := { PathSegment.ElementType.JUMP: 0.7, PathSegment.ElementType.SPIN: 4.0, @@ -4056,7 +4056,14 @@ func _update_playback_state( delta: float, force_heading: bool = false ) -> void: - if _playback_entries.is_empty() or _routine == null: + var pose := PlaybackPose.compute( + _playback_entries, + _playback_time, + _playback_heading, + delta, + force_heading + ) + if not pose.found or _routine == null: _playback_section_id = "" rink_canvas.clear_playback_state() _update_section_buttons() @@ -4064,151 +4071,36 @@ func _update_playback_state( _presentation_3d.clear_pose() return - var entry: Dictionary = _playback_entries[_playback_entries.size() - 1] - var entry_index := _playback_entries.size() - 1 - for index: int in range(_playback_entries.size()): - var candidate: Dictionary = _playback_entries[index] - var candidate_start: float = candidate["start"] - var candidate_duration: float = candidate["duration"] - if _playback_time < candidate_start + candidate_duration - 0.0001: - entry = candidate - entry_index = index - break - - var segment: PathSegment = entry["segment"] - var section_id: String = entry["section_id"] - var start: float = entry["start"] - var duration: float = entry["duration"] - var local_time := clampf(_playback_time - start, 0.0, duration) - var fraction := 0.0 if duration <= 0.0 else local_time / duration - - var curve := segment.curve - var length := segment.get_length_m() - var position := Vector2.ZERO - var tangent := Vector2.RIGHT - - if curve != null and length > 0.0: - var offset := clampf(fraction, 0.0, 1.0) * length - position = curve.sample_baked(offset) - var epsilon := maxf(0.01, length * 0.01) - var before := curve.sample_baked(maxf(0.0, offset - epsilon)) - var after := curve.sample_baked(minf(length, offset + epsilon)) - var direction_vector := after - before - if direction_vector.length_squared() > 0.0: - tangent = direction_vector.normalized() - elif curve != null and curve.point_count > 0: - position = curve.get_point_position(0) - - var facing := tangent - if segment.direction == PathSegment.Direction.BACKWARD: - facing = -facing - - var marker_scale := 1.0 - if segment.is_element_marker(): - # Markers have no tangent: keep facing the way the skater arrived. Spins - # and jumps rotate in place, so the heading follows the elapsed stand - # time. - facing = _entry_arrival_heading(entry_index) - var progress := 0.0 - if duration > 0.0: - progress = clampf(local_time / duration, 0.0, 1.0) - if segment.element_type == PathSegment.ElementType.SPIN: - var spin_rate := segment.get_spin_revolutions_per_second() - if spin_rate <= 0.0: - # Legacy files without a planned revolution count. - spin_rate = SPIN_REVOLUTIONS_PER_SECOND - facing = facing.rotated( - segment.get_rotation_sign() - * TAU - * spin_rate - * local_time - ) - _playback_heading = facing - elif segment.element_type == PathSegment.ElementType.JUMP: - # Jumps turn once per revolution in the air; the count is taken from - # the jump code (3Lz = 3, 2A = 2.5). The marker grows towards the - # middle of the air time and travels along the jump vector to the - # landing point. - var jump_vector := segment.element_jump_vector - if jump_vector.length_squared() <= 0.000001: - jump_vector = facing * segment.get_jump_distance_m() - var travel_heading := facing - if jump_vector.length_squared() > 0.000001: - travel_heading = jump_vector.normalized() - facing = travel_heading.rotated( - segment.get_rotation_sign() - * TAU - * segment.get_jump_revolutions() - * progress - ) - _playback_heading = facing - position += jump_vector * progress - marker_scale = 1.0 + 0.85 * sin(PI * progress) - elif force_heading or _playback_heading.length_squared() <= 0.0: - _playback_heading = facing - elif force_heading or delta <= 0.0 or _playback_heading.length_squared() <= 0.0: - _playback_heading = facing - else: - var turn := clampf(delta * 12.0, 0.0, 1.0) - _playback_heading = Vector2.from_angle( - lerp_angle(_playback_heading.angle(), facing.angle(), turn) - ) - - _playback_position = position - var section_changed := _playback_section_id != section_id - _playback_section_id = section_id - _playback_segment_id = segment.segment_id + _playback_position = pose.position + _playback_heading = pose.heading + var section_changed := _playback_section_id != pose.section_id + _playback_section_id = pose.section_id + _playback_segment_id = pose.segment_id if section_changed: - var section := _routine.get_section_by_id(section_id) + var section := _routine.get_section_by_id(pose.section_id) if section != null: rink_canvas.show_section_banner(I18n.section_title(section.title)) _update_section_buttons() rink_canvas.set_playback_state( - position, - _playback_heading, - section_id, - segment.edge, - segment.direction, - marker_scale + pose.position, + pose.heading, + pose.section_id, + pose.segment.edge, + pose.segment.direction, + pose.marker_scale ) if _view_3d_active and _presentation_3d != null: _presentation_3d.update_pose( - position, - _playback_heading, - segment, + pose.position, + pose.heading, + pose.segment, _playback_time ) _update_playback_ui() -## Heading with which the skater arrives at the timed entry [param entry_index]. -## Walks back to the last entry with a real path so a marker keeps facing the -## direction of travel. -func _entry_arrival_heading(entry_index: int) -> Vector2: - var index := entry_index - 1 - while index >= 0: - var previous: Dictionary = _playback_entries[index] - var previous_segment: PathSegment = previous["segment"] - if previous_segment != null: - var length := previous_segment.get_length_m() - if length > 0.0 and previous_segment.curve != null: - var epsilon := maxf(0.01, length * 0.01) - var before := previous_segment.curve.sample_baked( - maxf(0.0, length - epsilon) - ) - var end := previous_segment.curve.sample_baked(length) - var direction := end - before - if direction.length_squared() > 0.0: - direction = direction.normalized() - if previous_segment.direction == PathSegment.Direction.BACKWARD: - direction = -direction - return direction - index -= 1 - return Vector2.RIGHT - - func _update_playback_ui() -> void: _updating_timeline = true playback_timeline.max_value = maxf(_playback_total_duration, 0.0) diff --git a/rinkplanner/src/whiteboard/view/playback_pose.gd b/rinkplanner/src/whiteboard/view/playback_pose.gd new file mode 100644 index 0000000..bf68ed6 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/playback_pose.gd @@ -0,0 +1,160 @@ +class_name PlaybackPose +extends RefCounted + +## Where the skater is and which way it faces at a given playback time. +## +## Pure: the timed entries and the previous heading go in, position, heading +## and marker scale come out. The controller applies the result to the canvas, +## the 3D preview and the UI, so the timing and geometry logic can be reasoned +## about without a scene. + +## Fallback rotation rate for legacy files without a planned revolution count. +const SPIN_REVOLUTIONS_PER_SECOND := 2.5 + + +class Result extends RefCounted: + var found: bool = false + var segment: PathSegment + var position: Vector2 = Vector2.ZERO + var heading: Vector2 = Vector2.RIGHT + var marker_scale: float = 1.0 + var section_id: String = "" + var segment_id: String = "" + + +static func compute( + entries: Array, + time: float, + previous_heading: Vector2, + delta: float, + force_heading: bool = false +) -> Result: + var result := Result.new() + if entries.is_empty(): + return result + + var entry: Dictionary = entries[entries.size() - 1] + var entry_index := entries.size() - 1 + for index: int in range(entries.size()): + var candidate: Dictionary = entries[index] + var candidate_start: float = candidate["start"] + var candidate_duration: float = candidate["duration"] + if time < candidate_start + candidate_duration - 0.0001: + entry = candidate + entry_index = index + break + + var segment: PathSegment = entry["segment"] + if segment == null: + return result + + var start: float = entry["start"] + var duration: float = entry["duration"] + var local_time := clampf(time - start, 0.0, duration) + var fraction := 0.0 if duration <= 0.0 else local_time / duration + + var curve := segment.curve + var length := segment.get_length_m() + var position := Vector2.ZERO + var tangent := Vector2.RIGHT + + if curve != null and length > 0.0: + var offset := clampf(fraction, 0.0, 1.0) * length + position = curve.sample_baked(offset) + var epsilon := maxf(0.01, length * 0.01) + var before := curve.sample_baked(maxf(0.0, offset - epsilon)) + var after := curve.sample_baked(minf(length, offset + epsilon)) + var direction_vector := after - before + if direction_vector.length_squared() > 0.0: + tangent = direction_vector.normalized() + elif curve != null and curve.point_count > 0: + position = curve.get_point_position(0) + + var facing := tangent + if segment.direction == PathSegment.Direction.BACKWARD: + facing = -facing + + var heading := previous_heading + var marker_scale := 1.0 + if segment.is_element_marker(): + # Markers have no tangent: keep facing the way the skater arrived. Spins + # and jumps rotate in place, so the heading follows the elapsed stand + # time. + facing = _arrival_heading(entries, entry_index) + var progress := 0.0 + if duration > 0.0: + progress = clampf(local_time / duration, 0.0, 1.0) + if segment.element_type == PathSegment.ElementType.SPIN: + var spin_rate := segment.get_spin_revolutions_per_second() + if spin_rate <= 0.0: + # Legacy files without a planned revolution count. + spin_rate = SPIN_REVOLUTIONS_PER_SECOND + heading = facing.rotated( + segment.get_rotation_sign() + * TAU + * spin_rate + * local_time + ) + elif segment.element_type == PathSegment.ElementType.JUMP: + # Jumps turn once per revolution in the air; the count is taken from + # the jump code (3Lz = 3, 2A = 2.5). The marker grows towards the + # middle of the air time and travels along the jump vector to the + # landing point. + var jump_vector := segment.element_jump_vector + if jump_vector.length_squared() <= 0.000001: + jump_vector = facing * segment.get_jump_distance_m() + var travel_heading := facing + if jump_vector.length_squared() > 0.000001: + travel_heading = jump_vector.normalized() + heading = travel_heading.rotated( + segment.get_rotation_sign() + * TAU + * segment.get_jump_revolutions() + * progress + ) + position += jump_vector * progress + marker_scale = 1.0 + 0.85 * sin(PI * progress) + elif force_heading or heading.length_squared() <= 0.0: + heading = facing + elif force_heading or delta <= 0.0 or heading.length_squared() <= 0.0: + heading = facing + else: + var turn := clampf(delta * 12.0, 0.0, 1.0) + heading = Vector2.from_angle( + lerp_angle(heading.angle(), facing.angle(), turn) + ) + + result.found = true + result.segment = segment + result.position = position + result.heading = heading + result.marker_scale = marker_scale + result.section_id = str(entry["section_id"]) + result.segment_id = segment.segment_id + return result + + +## Heading with which the skater arrives at the timed entry [param entry_index]. +## Walks back to the last entry with a real path so a marker keeps facing the +## direction of travel. +static func _arrival_heading(entries: Array, entry_index: int) -> Vector2: + var index := entry_index - 1 + while index >= 0: + var previous: Dictionary = entries[index] + var previous_segment: PathSegment = previous["segment"] + if previous_segment != null: + var length := previous_segment.get_length_m() + if length > 0.0 and previous_segment.curve != null: + var epsilon := maxf(0.01, length * 0.01) + var before := previous_segment.curve.sample_baked( + maxf(0.0, length - epsilon) + ) + var end := previous_segment.curve.sample_baked(length) + var direction := end - before + if direction.length_squared() > 0.0: + direction = direction.normalized() + if previous_segment.direction == PathSegment.Direction.BACKWARD: + direction = -direction + return direction + index -= 1 + return Vector2.RIGHT diff --git a/rinkplanner/src/whiteboard/view/playback_pose.gd.uid b/rinkplanner/src/whiteboard/view/playback_pose.gd.uid new file mode 100644 index 0000000..324d3ab --- /dev/null +++ b/rinkplanner/src/whiteboard/view/playback_pose.gd.uid @@ -0,0 +1 @@ +uid://chf1qjwr1ajff From c9fb6ebed6001322127211c6251a223f8202027d Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 14:26:20 +0100 Subject: [PATCH 12/28] =?UTF-8?q?docs:=20Node-Schnitt=20der=20verbleibende?= =?UTF-8?q?n=20Bl=C3=B6cke=20vorbereiten?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Geprüft: Die Dialoge hängen direkt an der Wurzel, nutzen aber unique_name_in_owner — ein Umhängen unter Panel-Knoten bricht keine Lookups. Der Aufwand liegt bei den Test-Zugriffen und bei der geteilten Überschreib-Bestätigung des Exports. --- docs/refactor-whiteboard-controller.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 743eeee..8d91459 100644 --- a/docs/refactor-whiteboard-controller.md +++ b/docs/refactor-whiteboard-controller.md @@ -144,6 +144,31 @@ Timeline-Labels sowie die 3D-Anbindung. Zuletzt: Element-Dialog, Feature-Auswahl, Fußzuordnung, Levelableitung. Der größte UI-Block und der, an dem am meisten hängt. +## Nächster Durchgang: Node-Schnitt + +Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, +Element-Inspector) lassen sich nicht mehr als reine Funktionen herausziehen; +sie brauchen eigene Nodes mit Signalen. Geprüft am 2026-11-13: + +- **Die Dialoge hängen direkt an der Wurzel** der Szene (31 Knoten mit + `parent="."`). Ein Panel braucht sie als Kinder, also `parent="ExportPanel"` + statt `parent="."`. +- **Das ist harmlos:** Alle Dialoge nutzen `unique_name_in_owner`, `%Name` + löst szenenweit auf. Ein Umhängen bricht weder den Controller noch die + Skripte, nur den Zugriff über Pfade (den gibt es hier nicht). +- **Der Aufwand liegt bei den Tests:** `run_export_tests` und + `run_sync_tests` greifen direkt auf Controller-Felder zu + (`controller.export_dialog`, `controller.export_done_label`, + `controller.routine_manager_dialog`, `controller.cleanup_conflicts_dialog`). + Diese Zugriffe wandern auf `controller..`. +- **Eine geteilte Abhängigkeit:** Der Export nutzt `_confirm_overwrite()`, + das auch „Speichern unter" verwendet. Entweder bekommt das Panel einen + eigenen Bestätigungsdialog oder der Controller reicht einen Callback durch. + Diese Entscheidung sollte vor dem Umbau fallen. + +Reihenfolge: erst Export (kleinster Block, ~150 Zeilen), dann Playback-Rest, +dann Sync, zuletzt Hub und Element-Inspector. + ## Was bewusst bleibt - `_ready()` und die Signalverdrahtung der Szene. From 27b7fd0907c2225f66b6b20a891e7df924108b61 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 14:39:13 +0100 Subject: [PATCH 13/28] refactor: Export-Dialoge als eigenes Panel (erster Node-Schnitt) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Neunter Schritt der Controller-Zerlegung und der erste mit Signalen statt reiner Funktionen. `ExportPanel` (src/whiteboard/view/export_panel.gd) besitzt die Dialoge "Kür exportieren" und "Export abgeschlossen" und meldet nur die Auswahl: export_requested(pfad, format, abschnitt, danach öffnen) Der Controller prüft, ob die Datei existiert, fragt über den bestehenden `confirm_dialog` nach dem Überschreiben, schreibt über `ExportService` und ruft `panel.show_done()`. Das Panel fasst kein Dateisystem an — so bleibt die Überschreib-Bestätigung an einer Stelle statt in zwei Dialogen. - Szene: neuer Knoten `ExportPanel` mit Skript, beide Dialoge und ihre Kindknoten darunter umgehängt (parent-Pfade sind absolut). - Tests greifen jetzt über `controller.export_panel.*` zu. Controller: 8.304 -> 8.245 Zeilen. Suite grün. --- docs/refactor-whiteboard-controller.md | 32 ++++- docs/roadmap.md | 5 +- rinkplanner/scenes/whiteboard/whiteboard.tscn | 43 ++++--- .../whiteboard/ctrl/whiteboard_controller.gd | 113 ++++------------- .../src/whiteboard/view/export_panel.gd | 120 ++++++++++++++++++ .../src/whiteboard/view/export_panel.gd.uid | 1 + rinkplanner/tests/run_export_tests.gd | 18 +-- rinkplanner/tests/run_whiteboard_tests.gd | 2 +- 8 files changed, 213 insertions(+), 121 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/export_panel.gd create mode 100644 rinkplanner/src/whiteboard/view/export_panel.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 8d91459..23d3ed1 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–8 sind es 8.304 Zeilen. Diese Notiz +Etappen 1–9 sind es 8.245 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -29,6 +29,7 @@ passiert und nicht als Big Bang. | `SeasonComparisonText` | Zeilen für den Saisonvergleichs-Dialog | 175 | nur Daten | 2 ✅ | | `ValidationReportView` | Zeilen für den Prüfdialog | 300 | nur Daten | 3 ✅ | | `ExportService` | SVG/PDF schreiben, Pfade und Dateinamen | 90 | Dateisystem | 4 ✅ | +| `ExportPanel` | Export- und Abschlussdialog (Node mit Signalen) | 130 | Szene | 9 ✅ | | `RulesContext` | Regelsatz: Bibliothek, Paket, drei Dokumente | 80 | keine | 5 ✅ | | `SeasonPanelModel` | Inhalt der drei Dropdowns | 120 | keine | 6 ✅ | | `SyncSummaryText` | Text der Sync-Zusammenfassung | 60 | keine | 7 ✅ | @@ -144,7 +145,31 @@ Timeline-Labels sowie die 3D-Anbindung. Zuletzt: Element-Dialog, Feature-Auswahl, Fußzuordnung, Levelableitung. Der größte UI-Block und der, an dem am meisten hängt. -## Nächster Durchgang: Node-Schnitt +## Erster Node-Schnitt (2026-11-13) + +`ExportPanel` (`src/whiteboard/view/export_panel.gd`) besitzt jetzt die +beiden Exportdialoge und meldet nur die Auswahl: + +``` +Panel ──export_requested(pfad, format, abschnitt, danach öffnen)──▶ Controller +``` + +Der Controller prüft, ob die Datei existiert (`_confirm_overwrite` bleibt die +einzige Stelle dafür), schreibt über `ExportService` und ruft +`panel.show_done()`. Das Panel fasst kein Dateisystem an. + +Was beim Umhängen der Szene zu beachten war: + +- `parent=` in `.tscn` ist **absolut** ab Wurzel, nicht relativ zum vorigen + Knoten. Nach dem Umhängen müssen auch alle Kindknoten ihren Pfad ändern + (`ExportDialog/…` → `ExportPanel/ExportDialog/…`), sonst verschwinden sie + beim Instanziieren mit „Parent path … has vanished". +- Der neue Knoten braucht `script = ExtResource(...)` **und** eine + `ext_resource`-Zeile; ohne Skript bleibt eine typisierte `@onready`-Zuweisung + still null. +- `load_steps` in der Kopfzeile muss mitwachsen. + +## Nächster Durchgang: weitere Node-Schnitte Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, Element-Inspector) lassen sich nicht mehr als reine Funktionen herausziehen; @@ -156,8 +181,7 @@ sie brauchen eigene Nodes mit Signalen. Geprüft am 2026-11-13: - **Das ist harmlos:** Alle Dialoge nutzen `unique_name_in_owner`, `%Name` löst szenenweit auf. Ein Umhängen bricht weder den Controller noch die Skripte, nur den Zugriff über Pfade (den gibt es hier nicht). -- **Der Aufwand liegt bei den Tests:** `run_export_tests` und - `run_sync_tests` greifen direkt auf Controller-Felder zu +- **Der Aufwand liegt bei den Tests:** `run_sync_tests` greift direkt auf Controller-Felder zu (`controller.export_dialog`, `controller.export_done_label`, `controller.routine_manager_dialog`, `controller.cleanup_conflicts_dialog`). Diese Zugriffe wandern auf `controller..`. diff --git a/docs/roadmap.md b/docs/roadmap.md index 3308cf5..61dd5c1 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -270,9 +270,10 @@ 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.304 Zeilen; `HelpContent`, `SeasonComparisonText`, + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.245 Zeilen; `HelpContent`, `SeasonComparisonText`, `ValidationReportView`, `ExportService`, `RulesContext`, - `SeasonPanelModel`, `SyncSummaryText` und `PlaybackPose` ausgelagert. + `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose` und `ExportPanel` + (erster Node-Schnitt) 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/scenes/whiteboard/whiteboard.tscn b/rinkplanner/scenes/whiteboard/whiteboard.tscn index 0ed4740..3773b8f 100644 --- a/rinkplanner/scenes/whiteboard/whiteboard.tscn +++ b/rinkplanner/scenes/whiteboard/whiteboard.tscn @@ -1,8 +1,9 @@ -[gd_scene load_steps=22 format=3] +[gd_scene load_steps=23 format=3] [ext_resource type="Script" path="res://src/whiteboard/ctrl/whiteboard_controller.gd" id="1_controller"] [ext_resource type="Script" path="res://src/whiteboard/view/rink_canvas.gd" id="2_canvas"] [ext_resource type="Script" path="res://src/whiteboard/view/timeline_label_lane.gd" id="3_label_lane"] +[ext_resource type="Script" path="res://src/whiteboard/view/export_panel.gd" id="3_export_panel"] [ext_resource type="Texture2D" path="res://assets/icons/tools/select.svg" id="4_tool_select"] [ext_resource type="Texture2D" path="res://assets/icons/tools/line.svg" id="5_tool_line"] [ext_resource type="Texture2D" path="res://assets/icons/tools/arc_left.svg" id="6_tool_arc_left"] @@ -1648,7 +1649,11 @@ theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) theme_override_font_sizes/font_size = 12 text = "Geschwindigkeit = Strecke / Zeit" -[node name="ExportDialog" type="ConfirmationDialog" parent="."] +[node name="ExportPanel" type="Node" parent="."] +unique_name_in_owner = true +script = ExtResource("3_export_panel") + +[node name="ExportDialog" type="ConfirmationDialog" parent="ExportPanel"] unique_name_in_owner = true title = "Kür exportieren" size = Vector2i(480, 520) @@ -1656,7 +1661,7 @@ wrap_controls = false ok_button_text = "Exportieren" cancel_button_text = "Abbrechen" -[node name="ExportScroll" type="ScrollContainer" parent="ExportDialog"] +[node name="ExportScroll" type="ScrollContainer" parent="ExportPanel/ExportDialog"] layout_mode = 1 anchors_preset = 15 anchor_right = 1.0 @@ -1670,39 +1675,39 @@ grow_vertical = 2 horizontal_scroll_mode = 0 follow_focus = true -[node name="ExportBox" type="VBoxContainer" parent="ExportDialog/ExportScroll"] +[node name="ExportBox" type="VBoxContainer" parent="ExportPanel/ExportDialog/ExportScroll"] layout_mode = 2 size_flags_horizontal = 3 theme_override_constants/separation = 4 -[node name="ExportNameLabel" type="Label" parent="ExportDialog/ExportScroll/ExportBox"] +[node name="ExportNameLabel" type="Label" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] layout_mode = 2 text = "Dateiname" -[node name="ExportNameEdit" type="LineEdit" parent="ExportDialog/ExportScroll/ExportBox"] +[node name="ExportNameEdit" type="LineEdit" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] unique_name_in_owner = true custom_minimum_size = Vector2(0, 48) layout_mode = 2 -[node name="ExportFormatLabel" type="Label" parent="ExportDialog/ExportScroll/ExportBox"] +[node name="ExportFormatLabel" type="Label" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] layout_mode = 2 text = "Format" -[node name="ExportFormatOption" type="OptionButton" parent="ExportDialog/ExportScroll/ExportBox"] +[node name="ExportFormatOption" type="OptionButton" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] unique_name_in_owner = true custom_minimum_size = Vector2(0, 48) layout_mode = 2 -[node name="ExportScopeLabel" type="Label" parent="ExportDialog/ExportScroll/ExportBox"] +[node name="ExportScopeLabel" type="Label" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] layout_mode = 2 text = "Umfang" -[node name="ExportScopeOption" type="OptionButton" parent="ExportDialog/ExportScroll/ExportBox"] +[node name="ExportScopeOption" type="OptionButton" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] unique_name_in_owner = true custom_minimum_size = Vector2(0, 48) layout_mode = 2 -[node name="ExportHint" type="Label" parent="ExportDialog/ExportScroll/ExportBox"] +[node name="ExportHint" type="Label" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] custom_minimum_size = Vector2(0, 34) layout_mode = 2 theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) @@ -1710,7 +1715,7 @@ theme_override_font_sizes/font_size = 12 text = "Ziel: export-Ordner im App-Datenverzeichnis · der absolute Pfad erscheint nach dem Export" autowrap_mode = 3 -[node name="ExportOpenAfterCheck" type="CheckBox" parent="ExportDialog/ExportScroll/ExportBox"] +[node name="ExportOpenAfterCheck" type="CheckBox" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] unique_name_in_owner = true custom_minimum_size = Vector2(0, 44) layout_mode = 2 @@ -1718,7 +1723,7 @@ button_pressed = true text = "Nach dem Export öffnen" tooltip_text = "Ergebnis nach dem Export mit dem Standardprogramm öffnen" -[node name="ExportDoneDialog" type="AcceptDialog" parent="."] +[node name="ExportDoneDialog" type="AcceptDialog" parent="ExportPanel"] unique_name_in_owner = true title = "Export abgeschlossen" size = Vector2i(660, 320) @@ -1726,7 +1731,7 @@ wrap_controls = false exclusive = false ok_button_text = "Schließen" -[node name="ExportDoneBox" type="VBoxContainer" parent="ExportDoneDialog"] +[node name="ExportDoneBox" type="VBoxContainer" parent="ExportPanel/ExportDoneDialog"] layout_mode = 1 anchors_preset = 15 anchor_right = 1.0 @@ -1739,7 +1744,7 @@ grow_horizontal = 2 grow_vertical = 2 theme_override_constants/separation = 4 -[node name="ExportDoneLabel" type="RichTextLabel" parent="ExportDoneDialog/ExportDoneBox"] +[node name="ExportDoneLabel" type="RichTextLabel" parent="ExportPanel/ExportDoneDialog/ExportDoneBox"] unique_name_in_owner = true custom_minimum_size = Vector2(0, 96) layout_mode = 2 @@ -1749,26 +1754,26 @@ scroll_active = false selection_enabled = true autowrap_mode = 3 -[node name="ExportDoneButtons" type="HFlowContainer" parent="ExportDoneDialog/ExportDoneBox"] +[node name="ExportDoneButtons" type="HFlowContainer" parent="ExportPanel/ExportDoneDialog/ExportDoneBox"] layout_mode = 2 theme_override_constants/h_separation = 6 theme_override_constants/v_separation = 8 -[node name="ExportOpenButton" type="Button" parent="ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] +[node name="ExportOpenButton" type="Button" parent="ExportPanel/ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(140, 48) layout_mode = 2 text = "Öffnen" tooltip_text = "Datei mit dem Standardprogramm öffnen" -[node name="ExportFolderButton" type="Button" parent="ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] +[node name="ExportFolderButton" type="Button" parent="ExportPanel/ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(180, 48) layout_mode = 2 text = "Ordner anzeigen" tooltip_text = "Exportordner im Dateimanager öffnen" -[node name="ExportCopyPathButton" type="Button" parent="ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] +[node name="ExportCopyPathButton" type="Button" parent="ExportPanel/ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(170, 48) layout_mode = 2 diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 2d8ec2a..988d8c2 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -311,16 +311,7 @@ const UPDATE_FILE_NAMES := { @onready var cloud_auth_user_code: Label = %CloudAuthUserCode @onready var cloud_auth_code_edit: LineEdit = %CloudAuthCodeEdit @onready var cloud_auth_code_hint: Label = %CloudAuthCodeHint -@onready var export_dialog: ConfirmationDialog = %ExportDialog -@onready var export_name_edit: LineEdit = %ExportNameEdit -@onready var export_format_option: OptionButton = %ExportFormatOption -@onready var export_scope_option: OptionButton = %ExportScopeOption -@onready var export_open_after_check: CheckBox = %ExportOpenAfterCheck -@onready var export_done_dialog: AcceptDialog = %ExportDoneDialog -@onready var export_done_label: RichTextLabel = %ExportDoneLabel -@onready var export_open_button: Button = %ExportOpenButton -@onready var export_folder_button: Button = %ExportFolderButton -@onready var export_copy_path_button: Button = %ExportCopyPathButton +@onready var export_panel: ExportPanel = %ExportPanel var _routine: Routine var _active_section: RoutineSection @@ -456,7 +447,6 @@ func _ready() -> void: _setup_program_controls() _setup_upgrade_controls() _setup_adult_category_controls() - _setup_export_controls() labels_toggle.set_pressed_no_signal(rink_canvas.labels_visible) _update_child_translations(self) @@ -521,10 +511,11 @@ func _ready() -> void: calibrate_button.pressed.connect(_open_calibration_dialog) reset_timing_button.pressed.connect(_reset_selected_timing) calibration_dialog.confirmed.connect(_on_calibration_confirmed) - export_dialog.confirmed.connect(_on_export_confirmed) - export_open_button.pressed.connect(_on_export_open_pressed) - export_folder_button.pressed.connect(_on_export_folder_pressed) - export_copy_path_button.pressed.connect(_on_export_copy_path_pressed) + export_panel.export_requested.connect(_on_export_requested) + export_panel.open_requested.connect(_on_export_open_pressed) + export_panel.folder_requested.connect(_on_export_folder_pressed) + export_panel.copy_requested.connect(_on_export_copy_path_pressed) + export_panel.message_requested.connect(_show_message) sync_settings_dialog.confirmed.connect(_on_sync_settings_confirmed) sync_provider_option.item_selected.connect(_on_sync_provider_selected) sync_connect_button.pressed.connect(_on_sync_connect_pressed) @@ -5652,18 +5643,6 @@ func _confirm_overwrite(path: String, action: Callable) -> void: confirm_dialog.popup_centered(Vector2i(480, 180)) -func _setup_export_controls() -> void: - export_format_option.clear() - export_format_option.add_item("SVG (Vektor)", 0) - export_format_option.add_item("PNG (hochauflösend)", 1) - export_format_option.add_item("PDF (Laufwege mit Zeit)", 2) - export_scope_option.clear() - export_scope_option.add_item("Gesamte Kür", 0) - export_scope_option.add_item("Aktiver Abschnitt", 1) - export_format_option.select(0) - export_scope_option.select(0) - - func _maximize_window_on_desktop() -> void: # Desktop builds start maximized. Mobile and web keep the window shape the # OS or browser provides, and headless test runs have no real window. @@ -7063,22 +7042,11 @@ func _exit_tree() -> void: func _open_export_dialog() -> void: - if _routine == null: - return - - export_name_edit.text = _routine.title - if export_name_edit.text.strip_edges().is_empty(): - export_name_edit.text = "kuer" - export_format_option.select(0) - export_scope_option.select(0) - var dialog_size := _fit_dialog_size(Vector2i(480, 520)) - export_dialog.popup_centered(dialog_size) - # AcceptDialog shrinks to its content minimum on popup; restore the target - # size so the scroll area has room. popup_centered already centered it for - # the requested size. - export_dialog.size = dialog_size - export_name_edit.grab_focus() - export_name_edit.select_all() + export_panel.open_for( + _routine, + _active_section, + _fit_dialog_size(Vector2i(480, 520)) + ) ## Keeps dialogs inside the visible viewport (important on Android portrait). @@ -7092,44 +7060,23 @@ func _fit_dialog_size(preferred: Vector2i) -> Vector2i: ) -func _on_export_confirmed() -> void: - var name := export_name_edit.text.strip_edges() - if name.is_empty(): - _show_message("Bitte einen Dateinamen eingeben.") - return - - var stem := ExportService.normalize_stem(name) - var scope_section_id := "" - var scope_suffix := "" - if export_scope_option.selected == 1: - if _active_section == null: - _show_message("Kein aktiver Abschnitt vorhanden.") - return - scope_section_id = _active_section.section_id - scope_suffix = "_" + ExportService.normalize_stem(_active_section.title) - - var format := export_format_option.get_item_id( - export_format_option.selected - ) - var extension := "svg" - if format == 1: - extension = "png" - elif format == 2: - extension = "pdf" - var path := EXPORTS_DIR.path_join(stem + scope_suffix + "." + extension) +func _on_export_requested( + path: String, + format: int, + section_id: String, + open_after: bool +) -> void: if FileAccess.file_exists(path): - _confirm_overwrite( - path, - _perform_export.bind(path, format, scope_section_id) - ) + _confirm_overwrite(path, _perform_export.bind(path, format, section_id, open_after)) return - await _perform_export(path, format, scope_section_id) + await _perform_export(path, format, section_id, open_after) func _perform_export( path: String, format: int, - scope_section_id: String + scope_section_id: String, + open_after: bool = false ) -> void: ExportService.ensure_dir() @@ -7145,23 +7092,17 @@ func _perform_export( if success: _last_export_path = ProjectSettings.globalize_path(path) _show_export_done() - if export_open_after_check.button_pressed: + if open_after: _open_path_externally(_last_export_path) else: _show_message("Export fehlgeschlagen.") func _show_export_done() -> void: - export_done_label.text = ( - "Exportiert nach:\n%s\n\n" - + "Du kannst die Datei direkt öffnen oder den Ordner anzeigen." - ) % _last_export_path - export_open_button.disabled = not FileAccess.file_exists(_last_export_path) - export_folder_button.disabled = _last_export_path.is_empty() - export_copy_path_button.text = "Pfad kopieren" - var dialog_size := _fit_dialog_size(Vector2i(660, 320)) - export_done_dialog.popup_centered(dialog_size) - export_done_dialog.size = dialog_size + export_panel.show_done( + _last_export_path, + _fit_dialog_size(Vector2i(660, 320)) + ) func _open_path_externally(path: String) -> Error: @@ -7199,7 +7140,7 @@ func _on_export_copy_path_pressed() -> void: if _last_export_path.is_empty(): return DisplayServer.clipboard_set(_last_export_path) - export_copy_path_button.text = "Kopiert" + export_panel.set_copy_label("Kopiert") func export_svg_to_path(path: String, section_id: String = "") -> bool: diff --git a/rinkplanner/src/whiteboard/view/export_panel.gd b/rinkplanner/src/whiteboard/view/export_panel.gd new file mode 100644 index 0000000..15cf49b --- /dev/null +++ b/rinkplanner/src/whiteboard/view/export_panel.gd @@ -0,0 +1,120 @@ +class_name ExportPanel +extends Node + +## The export dialogs: file name, format and scope, plus the "done" dialog. +## +## The panel only collects choices and reports them — it never touches the +## file system. The controller decides about existing files, writes the +## document and opens it, so the overwrite confirmation stays in one place. + +signal export_requested( + path: String, + format: int, + section_id: String, + open_after: bool +) +signal open_requested +signal folder_requested +signal copy_requested +signal message_requested(text: String) + +const FORMAT_EXTENSIONS := ["svg", "png", "pdf"] + +@onready var dialog: ConfirmationDialog = %ExportDialog +@onready var name_edit: LineEdit = %ExportNameEdit +@onready var format_option: OptionButton = %ExportFormatOption +@onready var scope_option: OptionButton = %ExportScopeOption +@onready var open_after_check: CheckBox = %ExportOpenAfterCheck +@onready var done_dialog: AcceptDialog = %ExportDoneDialog +@onready var done_label: RichTextLabel = %ExportDoneLabel +@onready var open_button: Button = %ExportOpenButton +@onready var folder_button: Button = %ExportFolderButton +@onready var copy_button: Button = %ExportCopyPathButton + +var _active_section: RoutineSection + + +func _ready() -> void: + format_option.clear() + format_option.add_item("SVG (Vektor)", 0) + format_option.add_item("PNG (hochauflösend)", 1) + format_option.add_item("PDF (Laufwege mit Zeit)", 2) + scope_option.clear() + scope_option.add_item("Gesamte Kür", 0) + scope_option.add_item("Aktiver Abschnitt", 1) + format_option.select(0) + scope_option.select(0) + + dialog.confirmed.connect(_on_confirmed) + open_button.pressed.connect(func() -> void: open_requested.emit()) + folder_button.pressed.connect(func() -> void: folder_requested.emit()) + copy_button.pressed.connect(func() -> void: copy_requested.emit()) + + +## Fills and shows the export dialog. [param size] is the pre-fitted dialog +## size the controller computed for the current viewport. +func open_for( + routine: Routine, + active_section: RoutineSection, + size: Vector2i +) -> void: + if routine == null: + return + _active_section = active_section + name_edit.text = routine.title + if name_edit.text.strip_edges().is_empty(): + name_edit.text = "kuer" + format_option.select(0) + scope_option.select(0) + dialog.popup_centered(size) + # AcceptDialog shrinks to its content minimum on popup; restore the target + # size so the scroll area has room. + dialog.size = size + name_edit.grab_focus() + name_edit.select_all() + + +func _on_confirmed() -> void: + var name := name_edit.text.strip_edges() + if name.is_empty(): + message_requested.emit("Bitte einen Dateinamen eingeben.") + return + + var suffix := "" + var section_id := "" + if scope_option.selected == 1: + if _active_section == null: + message_requested.emit("Kein aktiver Abschnitt vorhanden.") + return + section_id = _active_section.section_id + suffix = "_" + ExportService.normalize_stem(_active_section.title) + + var format := format_option.get_item_id(format_option.selected) + var extension: String = FORMAT_EXTENSIONS[clampi(format, 0, 2)] + export_requested.emit( + ExportService.build_path( + ExportService.normalize_stem(name), + suffix, + extension + ), + format, + section_id, + open_after_check.button_pressed + ) + + +## Shows the "export done" dialog for [param path]. +func show_done(path: String, size: Vector2i) -> void: + done_label.text = ( + "Exportiert nach:\n%s\n\n" + + "Du kannst die Datei direkt öffnen oder den Ordner anzeigen." + ) % path + open_button.disabled = path.is_empty() or not FileAccess.file_exists(path) + folder_button.disabled = path.is_empty() + copy_button.text = "Pfad kopieren" + done_dialog.popup_centered(size) + done_dialog.size = size + + +func set_copy_label(text: String) -> void: + copy_button.text = text diff --git a/rinkplanner/src/whiteboard/view/export_panel.gd.uid b/rinkplanner/src/whiteboard/view/export_panel.gd.uid new file mode 100644 index 0000000..8f0e8c3 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/export_panel.gd.uid @@ -0,0 +1 @@ +uid://hld4jpokdv6s diff --git a/rinkplanner/tests/run_export_tests.gd b/rinkplanner/tests/run_export_tests.gd index dda00a9..cd83203 100644 --- a/rinkplanner/tests/run_export_tests.gd +++ b/rinkplanner/tests/run_export_tests.gd @@ -295,12 +295,12 @@ func _run() -> void: return _check( - controller.export_format_option.item_count == 3 - and controller.export_format_option.get_item_text(2).contains("PDF"), + controller.export_panel.format_option.item_count == 3 + and controller.export_panel.format_option.get_item_text(2).contains("PDF"), "export dialog offers the PDF format" ) _check( - controller.export_open_after_check.button_pressed, + controller.export_panel.open_after_check.button_pressed, "export dialog opens the result by default" ) @@ -310,7 +310,7 @@ func _run() -> void: await process_frame controller._open_export_dialog() await process_frame - var export_dialog := controller.export_dialog + var export_dialog := controller.export_panel.dialog var scroll := export_dialog.get_node("ExportScroll") as ScrollContainer var ok_button := export_dialog.get_ok_button() _check( @@ -373,21 +373,21 @@ func _run() -> void: controller._last_export_path = ProjectSettings.globalize_path(pdf_path) controller._show_export_done() _check( - controller.export_done_dialog.visible, + controller.export_panel.done_dialog.visible, "export completion dialog opens" ) _check( - controller.export_done_label.text.contains( + controller.export_panel.done_label.text.contains( ProjectSettings.globalize_path(pdf_path) ), "export completion dialog shows the absolute path" ) _check( - not controller.export_open_button.disabled - and not controller.export_folder_button.disabled, + not controller.export_panel.open_button.disabled + and not controller.export_panel.folder_button.disabled, "export completion dialog enables open and folder buttons" ) - controller.export_done_dialog.hide() + controller.export_panel.done_dialog.hide() DirAccess.remove_absolute(pdf_path) _check( diff --git a/rinkplanner/tests/run_whiteboard_tests.gd b/rinkplanner/tests/run_whiteboard_tests.gd index 123bd49..0adaaa1 100644 --- a/rinkplanner/tests/run_whiteboard_tests.gd +++ b/rinkplanner/tests/run_whiteboard_tests.gd @@ -1803,7 +1803,7 @@ func _run() -> void: FileAccess.file_exists(controller._last_export_path), "the comparison PDF was written" ) - controller.export_done_dialog.hide() + controller.export_panel.done_dialog.hide() controller._on_upgrade_apply_pressed() _check( controller.get_season() == "2025/26", From a403270643afc7b7375157bd6104913d57beace7 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 14:43:21 +0100 Subject: [PATCH 14/28] refactor: Transportleiste als eigenes Panel (zweiter Node-Schnitt) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `PlaybackPanel` (src/whiteboard/view/playback_panel.gd) besitzt Play/Pause, Reset, Zeitschieber, Zeitanzeige und Tempoauswahl und meldet nur Absichten: `toggle_requested`, `reset_requested`, `seek_requested`, `speed_requested`. Der Controller behält Uhr, Tempo und Audio und ruft `set_state(time, duration, playing)`. Anders als beim Export war kein Umhängen nötig: Die Widgets bleiben in der Layout-Leiste, das Panel findet sie über unique_name_in_owner — ein Node ohne Control-Basis kann in einem HBox keine Kinder sinnvoll aufnehmen. - `_update_playback_ui` und `_update_play_button` sind zu `_sync_playback_ui()` verschmolzen. - `_on_speed_selected`/`_on_timeline_changed` entfallen; das Tempo kommt als Wert aus dem Panel. - Tests greifen über `controller.playback_panel.*` zu. Controller: 8.245 -> 8.194 Zeilen. Suite grün. --- docs/refactor-whiteboard-controller.md | 20 +++- docs/roadmap.md | 6 +- rinkplanner/scenes/whiteboard/whiteboard.tscn | 7 +- .../whiteboard/ctrl/whiteboard_controller.gd | 93 ++++------------- .../src/whiteboard/view/playback_panel.gd | 99 +++++++++++++++++++ .../src/whiteboard/view/playback_panel.gd.uid | 1 + rinkplanner/tests/run_playback_tests.gd | 34 +++---- rinkplanner/tests/run_presentation3d_tests.gd | 2 +- 8 files changed, 166 insertions(+), 96 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/playback_panel.gd create mode 100644 rinkplanner/src/whiteboard/view/playback_panel.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 23d3ed1..5227bb1 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–9 sind es 8.245 Zeilen. Diese Notiz +Etappen 1–10 sind es 8.194 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -36,7 +36,8 @@ passiert und nicht als Big Bang. | Sync-Orchestrierung | Threads, OAuth, Konflikte, Küren verwalten | ~700 | Dialoge, Threads | offen | | `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 8 | | `PlaybackPose` | Position und Blickrichtung zur Zeit | 130 | keine | 8 ✅ | -| Playback-Rest | Steuerung, Musik, Timeline, 3D-Anbindung | ~470 | Canvas, Audio | offen | +| `PlaybackPanel` | Transportleiste: Play/Pause, Reset, Slider, Tempo | 110 | Szene | 10 ✅ | +| Playback-Rest | Musik, Timeline-Labels, 3D-Anbindung | ~360 | Canvas, Audio | offen | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 | Danach bleibt ein Controller von grob 2.000–2.500 Zeilen: Verdrahtung, @@ -169,6 +170,21 @@ Was beim Umhängen der Szene zu beachten war: still null. - `load_steps` in der Kopfzeile muss mitwachsen. +### 10. `PlaybackPanel` ✅ + +Die Transportleiste (Play/Pause, Reset, Zeitschieber, Zeitanzeige, Tempo) ist +ein Node mit Signalen: `toggle_requested`, `reset_requested`, +`seek_requested(seconds)`, `speed_requested(speed)`. Der Controller besitzt +weiter Uhr, Tempo und Audio und ruft `set_state(time, duration, playing)`. + +Anders als beim Export brauchte es **kein Umhängen**: Die Widgets bleiben in +der Layout-Leiste, das Panel findet sie über `unique_name_in_owner`. Ein Node +ohne Control-Basis kann in einem HBox nicht sinnvoll Kindknoten aufnehmen. + +`_update_playback_ui` und `_update_play_button` sind zu `_sync_playback_ui()` +verschmolzen; die Zeitachse (`timeline_label_lane`) bleibt beim Controller, +weil sie zu den Timeline-Labels gehört. + ## Nächster Durchgang: weitere Node-Schnitte Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, diff --git a/docs/roadmap.md b/docs/roadmap.md index 61dd5c1..3801ef9 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -270,10 +270,10 @@ 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.245 Zeilen; `HelpContent`, `SeasonComparisonText`, + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.194 Zeilen; `HelpContent`, `SeasonComparisonText`, `ValidationReportView`, `ExportService`, `RulesContext`, - `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose` und `ExportPanel` - (erster Node-Schnitt) ausgelagert. + `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel` und + `PlaybackPanel` (Node-Schnitte) 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/scenes/whiteboard/whiteboard.tscn b/rinkplanner/scenes/whiteboard/whiteboard.tscn index 3773b8f..f38d460 100644 --- a/rinkplanner/scenes/whiteboard/whiteboard.tscn +++ b/rinkplanner/scenes/whiteboard/whiteboard.tscn @@ -1,9 +1,10 @@ -[gd_scene load_steps=23 format=3] +[gd_scene load_steps=24 format=3] [ext_resource type="Script" path="res://src/whiteboard/ctrl/whiteboard_controller.gd" id="1_controller"] [ext_resource type="Script" path="res://src/whiteboard/view/rink_canvas.gd" id="2_canvas"] [ext_resource type="Script" path="res://src/whiteboard/view/timeline_label_lane.gd" id="3_label_lane"] [ext_resource type="Script" path="res://src/whiteboard/view/export_panel.gd" id="3_export_panel"] +[ext_resource type="Script" path="res://src/whiteboard/view/playback_panel.gd" id="3_playback_panel"] [ext_resource type="Texture2D" path="res://assets/icons/tools/select.svg" id="4_tool_select"] [ext_resource type="Texture2D" path="res://assets/icons/tools/line.svg" id="5_tool_line"] [ext_resource type="Texture2D" path="res://assets/icons/tools/arc_left.svg" id="6_tool_arc_left"] @@ -1649,6 +1650,10 @@ theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) theme_override_font_sizes/font_size = 12 text = "Geschwindigkeit = Strecke / Zeit" +[node name="PlaybackPanel" type="Node" parent="."] +unique_name_in_owner = true +script = ExtResource("3_playback_panel") + [node name="ExportPanel" type="Node" parent="."] unique_name_in_owner = true script = ExtResource("3_export_panel") diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 988d8c2..895c189 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -185,11 +185,7 @@ const UPDATE_FILE_NAMES := { @onready var open_list: VBoxContainer = %OpenList @onready var confirm_dialog: ConfirmationDialog = %ConfirmDialog @onready var message_dialog: AcceptDialog = %MessageDialog -@onready var play_button: Button = %PlayButton -@onready var reset_playback_button: Button = %ResetPlaybackButton -@onready var playback_time_label: Label = %PlaybackTimeLabel -@onready var playback_timeline: HSlider = %PlaybackTimeline -@onready var speed_option: OptionButton = %SpeedOption +@onready var playback_panel: PlaybackPanel = %PlaybackPanel @onready var music_button: Button = %MusicButton @onready var music_label: Label = %MusicLabel @onready var music_clear_button: Button = %MusicClearButton @@ -486,10 +482,10 @@ func _ready() -> void: save_as_dialog.confirmed.connect(_on_save_as_confirmed) confirm_dialog.confirmed.connect(_on_confirm_discard_confirmed) confirm_dialog.canceled.connect(_on_confirm_discard_canceled) - play_button.pressed.connect(_toggle_playback) - reset_playback_button.pressed.connect(reset_playback) - playback_timeline.value_changed.connect(_on_timeline_changed) - speed_option.item_selected.connect(_on_speed_selected) + playback_panel.toggle_requested.connect(_toggle_playback) + playback_panel.reset_requested.connect(reset_playback) + playback_panel.seek_requested.connect(seek_playback) + playback_panel.speed_requested.connect(_on_speed_requested) music_button.pressed.connect(_open_music_dialog) music_clear_button.pressed.connect(_clear_music) music_file_dialog.file_selected.connect(_on_music_file_selected) @@ -3863,8 +3859,7 @@ func play() -> void: _playing = true _update_playback_state(0.0, true) _start_music() - _update_play_button() - _update_playback_ui() + _sync_playback_ui() _update_status() _sync_trail_fade() @@ -3874,8 +3869,7 @@ func pause() -> void: return _playing = false _stop_music() - _update_play_button() - _update_playback_ui() + _sync_playback_ui() _sync_trail_fade() @@ -3885,12 +3879,11 @@ func reset_playback() -> void: _playback_section_id = "" _playback_segment_id = "" _stop_music() - _update_play_button() rink_canvas.clear_playback_state() _update_section_buttons() if _view_3d_active and _presentation_3d != null: _presentation_3d.clear_pose() - _update_playback_ui() + _sync_playback_ui() _sync_trail_fade() @@ -3905,7 +3898,7 @@ func seek_playback(time: float) -> void: _update_playback_state(0.0, true) if _playing: _seek_music(_playback_time) - _update_playback_ui() + _sync_playback_ui() _sync_trail_fade() @@ -3923,8 +3916,7 @@ func advance_playback(delta: float) -> void: _update_playback_state(0.0, true) _playing = false _stop_music() - _update_play_button() - _update_playback_ui() + _sync_playback_ui() _sync_trail_fade() return @@ -3944,21 +3936,8 @@ func _process(delta: float) -> void: func _setup_playback_controls() -> void: - speed_option.clear() - speed_option.add_item("0,25×", 25) - speed_option.add_item("0,5×", 50) - speed_option.add_item("1×", 100) - speed_option.add_item("1,5×", 150) - speed_option.add_item("2×", 200) - speed_option.select(speed_option.get_item_index(100)) - _playback_speed = 1.0 - - playback_timeline.min_value = 0.0 - playback_timeline.max_value = 0.0 - playback_timeline.step = 0.01 - playback_timeline.editable = false - play_button.disabled = true - reset_playback_button.disabled = true + playback_panel.setup() + playback_panel.set_speed(_playback_speed) music_file_dialog.filters = PackedStringArray([ "*.mp3, *.m4a, *.aac ; MP3 / M4A / AAC", "*.ogg ; OGG-Musik", @@ -3967,7 +3946,7 @@ func _setup_playback_controls() -> void: music_player.pitch_scale = 1.0 timeline_label_edit.max_length = RoutineFile.MAX_TIMELINE_LABEL_LENGTH _update_music_ui() - _update_play_button() + _sync_playback_ui() func _toggle_playback() -> void: @@ -3977,8 +3956,8 @@ func _toggle_playback() -> void: play() -func _on_speed_selected(index: int) -> void: - _playback_speed = float(speed_option.get_item_id(index)) / 100.0 +func _on_speed_requested(speed: float) -> void: + _playback_speed = speed # The audio follows the routine clock. Changing the pitch also changes the # playback rate, so the music stays aligned at every speed. music_player.pitch_scale = _playback_speed @@ -3986,12 +3965,6 @@ func _on_speed_selected(index: int) -> void: _seek_music(_playback_time) -func _on_timeline_changed(value: float) -> void: - if _updating_timeline: - return - seek_playback(value) - - func _refresh_playback_timeline() -> void: var entries: Array[Dictionary] = [] var total := 0.0 @@ -4036,8 +4009,7 @@ func _refresh_playback_timeline() -> void: _playing = false _stop_music() - _update_play_button() - _update_playback_ui() + _sync_playback_ui() if total > 0.0 and (_playing or _playback_time > 0.0): _update_playback_state(0.0, true) @@ -4089,40 +4061,17 @@ func _update_playback_state( pose.segment, _playback_time ) - _update_playback_ui() + _sync_playback_ui() -func _update_playback_ui() -> void: - _updating_timeline = true - playback_timeline.max_value = maxf(_playback_total_duration, 0.0) - playback_timeline.value = clampf( +func _sync_playback_ui() -> void: + playback_panel.set_state( _playback_time, - 0.0, - _playback_total_duration + _playback_total_duration, + _playing ) - _updating_timeline = false - timeline_label_lane.set_playhead(_playback_time) - playback_time_label.text = "%s / %s s" % [ - _format_seconds(_playback_time), - _format_seconds(_playback_total_duration), - ] - - var has_playback := _playback_total_duration > 0.0 - play_button.disabled = not has_playback - reset_playback_button.disabled = not has_playback - playback_timeline.editable = has_playback - - -func _update_play_button() -> void: - play_button.text = "" - play_button.icon = PLAYBACK_PAUSE_ICON if _playing else PLAYBACK_PLAY_ICON - play_button.tooltip_text = "Pause" if _playing else "Abspielen" - - -## --- Timeline-Labels ------------------------------------------------------ - func get_timeline_labels() -> Array[Dictionary]: var result: Array[Dictionary] = [] diff --git a/rinkplanner/src/whiteboard/view/playback_panel.gd b/rinkplanner/src/whiteboard/view/playback_panel.gd new file mode 100644 index 0000000..aa601ab --- /dev/null +++ b/rinkplanner/src/whiteboard/view/playback_panel.gd @@ -0,0 +1,99 @@ +class_name PlaybackPanel +extends Node + +## Transport controls of the playback bar: play/pause, reset, the timeline +## slider, the time label and the speed choice. +## +## The panel only shows state and reports intents. The controller owns the +## routine clock, the speed value and the audio, and calls [method set_state] +## whenever time or duration change. + +signal toggle_requested +signal reset_requested +signal seek_requested(seconds: float) +signal speed_requested(speed: float) + +const PLAY_ICON := preload("res://assets/icons/playback/play.svg") +const PAUSE_ICON := preload("res://assets/icons/playback/pause.svg") +const SPEEDS := [25, 50, 100, 150, 200] + +@onready var play_button: Button = %PlayButton +@onready var reset_button: Button = %ResetPlaybackButton +@onready var time_label: Label = %PlaybackTimeLabel +@onready var timeline: HSlider = %PlaybackTimeline +@onready var speed_option: OptionButton = %SpeedOption + +var _updating_timeline := false + + +func setup() -> void: + speed_option.clear() + for percent: int in SPEEDS: + speed_option.add_item(_speed_label(percent), percent) + speed_option.select(speed_option.get_item_index(100)) + + timeline.min_value = 0.0 + timeline.max_value = 0.0 + timeline.step = 0.01 + timeline.editable = false + play_button.disabled = true + reset_button.disabled = true + + play_button.pressed.connect(func() -> void: toggle_requested.emit()) + reset_button.pressed.connect(func() -> void: reset_requested.emit()) + timeline.value_changed.connect(_on_timeline_changed) + speed_option.item_selected.connect(_on_speed_selected) + + +## Updates slider, time label and button states for [param time] seconds of a +## [param duration] seconds long routine. +func set_state(time: float, duration: float, playing: bool) -> void: + _updating_timeline = true + timeline.max_value = maxf(duration, 0.0) + timeline.value = clampf(time, 0.0, maxf(duration, 0.0)) + _updating_timeline = false + + time_label.text = "%s / %s s" % [_seconds(time), _seconds(duration)] + + var has_playback := duration > 0.0 + play_button.disabled = not has_playback + reset_button.disabled = not has_playback + timeline.editable = has_playback + + play_button.text = "" + play_button.icon = PAUSE_ICON if playing else PLAY_ICON + play_button.tooltip_text = "Pause" if playing else "Abspielen" + + +func set_speed(speed: float) -> void: + var percent := int(roundf(speed * 100.0)) + var index := speed_option.get_item_index(percent) + if index >= 0: + speed_option.select(index) + + +func _on_timeline_changed(value: float) -> void: + if _updating_timeline: + return + seek_requested.emit(value) + + +func _on_speed_selected(index: int) -> void: + speed_requested.emit(float(speed_option.get_item_id(index)) / 100.0) + + +static func _speed_label(percent: int) -> String: + match percent: + 25: + return "0,25×" + 50: + return "0,5×" + 150: + return "1,5×" + 200: + return "2×" + return "1×" if percent == 100 else "%d×" % (percent / 100) + + +static func _seconds(value: float) -> String: + return ("%.1f" % value).replace(".", ",") diff --git a/rinkplanner/src/whiteboard/view/playback_panel.gd.uid b/rinkplanner/src/whiteboard/view/playback_panel.gd.uid new file mode 100644 index 0000000..788ee8c --- /dev/null +++ b/rinkplanner/src/whiteboard/view/playback_panel.gd.uid @@ -0,0 +1 @@ +uid://s8khec6xpwjv diff --git a/rinkplanner/tests/run_playback_tests.gd b/rinkplanner/tests/run_playback_tests.gd index a0ed223..a59ef74 100644 --- a/rinkplanner/tests/run_playback_tests.gd +++ b/rinkplanner/tests/run_playback_tests.gd @@ -32,8 +32,8 @@ func _run() -> void: return _check_approx(controller.get_playback_duration(), 0.0, "empty routine has no duration") - _check(controller.play_button.disabled, "play is disabled without segments") - _check(controller.playback_timeline.editable == false, "timeline is disabled without segments") + _check(controller.playback_panel.play_button.disabled, "play is disabled without segments") + _check(controller.playback_panel.timeline.editable == false, "timeline is disabled without segments") var section_one := controller.get_active_section() var forward := controller.add_segment( @@ -62,10 +62,10 @@ func _run() -> void: controller._update_status() _check_approx(controller.get_playback_duration(), 6.0, "duration sums all sections") - _check(not controller.play_button.disabled, "play is enabled with segments") - _check(controller.playback_timeline.editable, "timeline is enabled with segments") + _check(not controller.playback_panel.play_button.disabled, "play is enabled with segments") + _check(controller.playback_panel.timeline.editable, "timeline is enabled with segments") _check_approx( - controller.playback_timeline.max_value, + controller.playback_panel.timeline.max_value, 6.0, "timeline covers the whole routine" ) @@ -80,7 +80,7 @@ func _run() -> void: "selecting a section moves the playback to its start" ) _check_approx( - controller.playback_timeline.value, + controller.playback_panel.timeline.value, 4.0, "timeline slider jumps to the section start" ) @@ -101,7 +101,7 @@ func _run() -> void: "switching back moves the playback to the first section" ) _check_approx( - controller.playback_timeline.value, + controller.playback_panel.timeline.value, 0.0, "timeline slider returns to the first section" ) @@ -199,20 +199,20 @@ func _run() -> void: "faded section banner has no alpha" ) - controller.play_button.pressed.emit() + controller.playback_panel.play_button.pressed.emit() _check(controller.is_playing(), "play button starts playback") - controller.play_button.pressed.emit() + controller.playback_panel.play_button.pressed.emit() _check(not controller.is_playing(), "play button pauses playback") controller.play() _check(controller.is_playing(), "play starts playback") - _check(controller.play_button.icon == PAUSE_ICON, "play button switches to pause") + _check(controller.playback_panel.play_button.icon == PAUSE_ICON, "play button switches to pause") controller.advance_playback(0.5) _check_approx(controller.get_playback_time(), 5.5, "playback advances by delta") controller.advance_playback(1.0) _check(not controller.is_playing(), "playback stops at the end") _check_approx(controller.get_playback_time(), 6.0, "playback ends at the total duration") - _check(controller.play_button.icon == PLAY_ICON, "play button switches back after the end") + _check(controller.playback_panel.play_button.icon == PLAY_ICON, "play button switches back after the end") controller.play() _check_approx( @@ -223,21 +223,21 @@ func _run() -> void: _check(controller.is_playing(), "restarted playback is running") controller.pause() _check(not controller.is_playing(), "pause stops playback") - controller.reset_playback_button.pressed.emit() + controller.playback_panel.reset_button.pressed.emit() _check_approx(controller.get_playback_time(), 0.0, "reset returns to the start") _check( controller.rink_canvas.get_playback_section_id().is_empty(), "reset clears the playback highlight" ) - controller.playback_timeline.value = 2.5 + controller.playback_panel.timeline.value = 2.5 _check_approx( controller.get_playback_time(), 2.5, "timeline scrubbing seeks the playback" ) - controller.speed_option.item_selected.emit(4) + controller.playback_panel.speed_option.item_selected.emit(4) _check_approx(controller.get_playback_speed(), 2.0, "speed option selects 2x") controller.reset_playback() controller.play() @@ -248,7 +248,7 @@ func _run() -> void: "2x speed doubles the elapsed routine time" ) controller.pause() - controller.speed_option.item_selected.emit(2) + controller.playback_panel.speed_option.item_selected.emit(2) _check_approx(controller.get_playback_speed(), 1.0, "speed option returns to 1x") # Element markers take their stand time from the element, not the geometry, @@ -656,13 +656,13 @@ func _run() -> void: 3.0, "scrubbing moves the routine clock" ) - controller.speed_option.item_selected.emit(4) + controller.playback_panel.speed_option.item_selected.emit(4) _check_approx( controller.music_player.pitch_scale, 2.0, "music follows the selected playback speed" ) - controller.speed_option.item_selected.emit(2) + controller.playback_panel.speed_option.item_selected.emit(2) controller.reset_playback() _check(not controller.music_player.playing, "reset stops the music") _check_approx( diff --git a/rinkplanner/tests/run_presentation3d_tests.gd b/rinkplanner/tests/run_presentation3d_tests.gd index a1ce86d..ad969c4 100644 --- a/rinkplanner/tests/run_presentation3d_tests.gd +++ b/rinkplanner/tests/run_presentation3d_tests.gd @@ -303,7 +303,7 @@ func _test_controller() -> void: _check(not controller.sections_panel.visible, "section panel is hidden in 3D") _check(not controller.timing_bar.visible, "timing bar is hidden in 3D") _check(not controller.delete_segment_button.visible, "delete button is hidden in 3D") - _check(controller.play_button.visible, "playback bar stays visible in 3D") + _check(controller.playback_panel.play_button.visible, "playback bar stays visible in 3D") var presentation := controller.get_presentation_3d() _check(presentation != null, "controller owns a presentation") From e47b8e0a9af5d90fdac1f8cdd510cd9fcaafe52b Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 14:44:45 +0100 Subject: [PATCH 15/28] refactor: Timeline-Labels als eigenes Modell MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Das Einsammeln der Labels für die Zeitachse liegt in `src/whiteboard/view/timeline_label_model.gd`. Die Logik ist subtiler, als sie aussieht: Sie läuft über die Abschnitte statt über die Wiedergabe-Einträge, damit Marken ohne Standzeit sichtbar bleiben, und ein Segment ohne eigenes Label erbt die Beschriftung seiner Elementgruppe. - `collect(routine)` liefert Element- und Kür-Labels plus Gesamtdauer. - `_refresh_timeline_labels` ist auf drei Zeilen geschrumpft und setzt nur noch die Zeitachse. - Abgesichert durch die Wiedergabetests, die die Labels der Zeitachse prüfen. Controller: 8.194 -> 8.154 Zeilen. Suite grün. --- docs/refactor-whiteboard-controller.md | 18 ++++++- docs/roadmap.md | 6 +-- .../whiteboard/ctrl/whiteboard_controller.gd | 46 ++-------------- .../whiteboard/view/timeline_label_model.gd | 53 +++++++++++++++++++ .../view/timeline_label_model.gd.uid | 1 + 5 files changed, 76 insertions(+), 48 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/timeline_label_model.gd create mode 100644 rinkplanner/src/whiteboard/view/timeline_label_model.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 5227bb1..c550485 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–10 sind es 8.194 Zeilen. Diese Notiz +Etappen 1–11 sind es 8.154 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -37,7 +37,8 @@ passiert und nicht als Big Bang. | `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 8 | | `PlaybackPose` | Position und Blickrichtung zur Zeit | 130 | keine | 8 ✅ | | `PlaybackPanel` | Transportleiste: Play/Pause, Reset, Slider, Tempo | 110 | Szene | 10 ✅ | -| Playback-Rest | Musik, Timeline-Labels, 3D-Anbindung | ~360 | Canvas, Audio | offen | +| `TimelineLabelModel` | Labels der Zeitachse einsammeln | 55 | keine | 11 ✅ | +| Playback-Rest | Musik, Label-Dialog, 3D-Anbindung | ~300 | Canvas, Audio | offen | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 | Danach bleibt ein Controller von grob 2.000–2.500 Zeilen: Verdrahtung, @@ -185,6 +186,19 @@ ohne Control-Basis kann in einem HBox nicht sinnvoll Kindknoten aufnehmen. verschmolzen; die Zeitachse (`timeline_label_lane`) bleibt beim Controller, weil sie zu den Timeline-Labels gehört. +### 11. `TimelineLabelModel` ✅ + +Das Einsammeln der Timeline-Labels liegt in +`src/whiteboard/view/timeline_label_model.gd`. Es ist subtiler, als es aussieht: +Es läuft über die Abschnitte (nicht über die Wiedergabe-Einträge), damit +Marken ohne Standzeit sichtbar bleiben, und ein Segment ohne eigenes Label +erbt die Beschriftung seiner Elementgruppe — so wird eine Sequenz einmal +benannt. Abgesichert durch die Wiedergabetests, die die Labels der Zeitachse +prüfen. + +**Offen:** der Label-Dialog (Anlegen/Bearbeiten/Löschen) und die Musik +(Laden, Konvertierung, Synchronisation). + ## Nächster Durchgang: weitere Node-Schnitte Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, diff --git a/docs/roadmap.md b/docs/roadmap.md index 3801ef9..4be3efd 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -270,10 +270,10 @@ 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.194 Zeilen; `HelpContent`, `SeasonComparisonText`, + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.154 Zeilen; `HelpContent`, `SeasonComparisonText`, `ValidationReportView`, `ExportService`, `RulesContext`, - `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel` und - `PlaybackPanel` (Node-Schnitte) ausgelagert. + `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel`, + `PlaybackPanel` und `TimelineLabelModel` 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 895c189..59556c2 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -4148,50 +4148,10 @@ func _sort_timeline_labels() -> void: func _refresh_timeline_labels() -> void: if timeline_label_lane == null: return - - # Walk the authored routine like the playback timeline does. Using the - # segments directly (instead of only the timed playback entries) also - # keeps element markers with zero stand time visible. - var element_labels: Array[Dictionary] = [] - var total := 0.0 - if _routine != null: - for section: RoutineSection in _routine.sections: - if section == null: - continue - var group_starts: Dictionary[String, ResolvedElement] = {} - for element: ResolvedElement in section.get_elements(): - if not element.segments.is_empty(): - group_starts[element.segments[0].segment_id] = element - for segment: PathSegment in section.segments: - if segment == null: - continue - var text := segment.label.strip_edges() - if text.is_empty() and group_starts.has(segment.segment_id): - text = group_starts[segment.segment_id].get_caption().strip_edges() - if not text.is_empty(): - element_labels.append({ - "time_seconds": total, - "text": text, - }) - total += maxf( - segment.get_effective_duration_seconds(), - 0.0 - ) - - var custom_labels: Array[Dictionary] = [] - if _routine != null: - for entry: Dictionary in _routine.timeline_labels: - var text := str(entry.get("text", "")).strip_edges() - if text.is_empty(): - continue - custom_labels.append({ - "time_seconds": float(entry.get("time_seconds", 0.0)), - "text": text, - }) - + var labels := TimelineLabelModel.collect(_routine) timeline_label_lane.set_timeline( - element_labels, - custom_labels, + labels["elements"], + labels["custom"], _playback_total_duration ) diff --git a/rinkplanner/src/whiteboard/view/timeline_label_model.gd b/rinkplanner/src/whiteboard/view/timeline_label_model.gd new file mode 100644 index 0000000..efd8d31 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/timeline_label_model.gd @@ -0,0 +1,53 @@ +class_name TimelineLabelModel +extends RefCounted + +## Collects the labels shown on the playback timeline. +## +## Pure: the routine goes in, the two label lists and the total duration come +## out. Walks the authored sections (not the timed playback entries), so +## element markers with zero stand time stay visible. A segment without its own +## label falls back to the caption of its element group, so a sequence group is +## named once. + +## Returns `{"elements": Array, "custom": Array, "duration": float}`. Each +## entry is `{"time_seconds": float, "text": String}`. +static func collect(routine: Routine) -> Dictionary: + var element_labels: Array[Dictionary] = [] + var total := 0.0 + if routine != null: + for section: RoutineSection in routine.sections: + if section == null: + continue + var group_starts: Dictionary[String, ResolvedElement] = {} + for element: ResolvedElement in section.get_elements(): + if not element.segments.is_empty(): + group_starts[element.segments[0].segment_id] = element + for segment: PathSegment in section.segments: + if segment == null: + continue + var text := segment.label.strip_edges() + if text.is_empty() and group_starts.has(segment.segment_id): + text = group_starts[segment.segment_id].get_caption().strip_edges() + if not text.is_empty(): + element_labels.append({ + "time_seconds": total, + "text": text, + }) + total += maxf(segment.get_effective_duration_seconds(), 0.0) + + var custom_labels: Array[Dictionary] = [] + if routine != null: + for entry: Dictionary in routine.timeline_labels: + var text := str(entry.get("text", "")).strip_edges() + if text.is_empty(): + continue + custom_labels.append({ + "time_seconds": float(entry.get("time_seconds", 0.0)), + "text": text, + }) + + return { + "elements": element_labels, + "custom": custom_labels, + "duration": total, + } diff --git a/rinkplanner/src/whiteboard/view/timeline_label_model.gd.uid b/rinkplanner/src/whiteboard/view/timeline_label_model.gd.uid new file mode 100644 index 0000000..6d36ec8 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/timeline_label_model.gd.uid @@ -0,0 +1 @@ +uid://bi7a47b46qnej From 94ec11ad871163fc887ed7c8bfe406fc3ed1de3c Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:03:07 +0100 Subject: [PATCH 16/28] =?UTF-8?q?test:=20ExportPanel=20als=20eigenst=C3=A4?= =?UTF-8?q?ndige=20Szene=20mit=20eigenem=20Test?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Die Probe aufs Exempel für die Modularisierung: `ExportPanel` liegt jetzt in `scenes/export/export_panel.tscn`, die Whiteboard-Szene instanziiert sie nur noch. Der neue `run_export_panel_tests.gd` lädt ausschließlich diese Szene und prüft die Signale — 15 Assertions ohne WhiteboardController. Damit ist zum ersten Mal ein Baustein nicht nur im Code, sondern auch in der Prüfbarkeit getrennt. Die übrigen Suiten starten weiter die volle Szene. Stolpersteine, beide dokumentiert: Kindknoten eines Szenen-Roots brauchen `parent="."`, und ein eigener Test braucht `root.size` vor `popup_centered`, sonst landen Fenster headless auf negativen Koordinaten. --- docs/refactor-whiteboard-controller.md | 16 +++ docs/roadmap.md | 3 +- rinkplanner/scenes/export/export_panel.tscn | 134 ++++++++++++++++++ rinkplanner/scenes/whiteboard/whiteboard.tscn | 133 +---------------- rinkplanner/tests/run_export_panel_tests.gd | 131 +++++++++++++++++ .../tests/run_export_panel_tests.gd.uid | 1 + tools/test.sh | 3 + 7 files changed, 290 insertions(+), 131 deletions(-) create mode 100644 rinkplanner/scenes/export/export_panel.tscn create mode 100644 rinkplanner/tests/run_export_panel_tests.gd create mode 100644 rinkplanner/tests/run_export_panel_tests.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index c550485..fe78601 100644 --- a/docs/refactor-whiteboard-controller.md +++ b/docs/refactor-whiteboard-controller.md @@ -199,6 +199,22 @@ prüfen. **Offen:** der Label-Dialog (Anlegen/Bearbeiten/Löschen) und die Musik (Laden, Konvertierung, Synchronisation). +### 12. `ExportPanel` als eigene Szene ✅ + +`scenes/export/export_panel.tscn` enthält die beiden Dialoge und das Skript; +die Whiteboard-Szene instanziiert sie nur noch. Dazu gibt es +`tests/run_export_panel_tests.gd`: Es lädt **nur** diese Szene, hängt sie an +den Root und prüft die Signale — kein WhiteboardController, keine Kür-Szene. + +Das ist die Messung, um die es ging: 15 Assertions laufen ohne die 8.154 +Zeilen Controller. Der Baustein ist damit nicht nur im Code getrennt. + +Zwei Stolpersteine beim Auslagern einer Szene: + +- Kindknoten eines Szenen-Roots nutzen `parent="."`, nicht den Root-Namen. +- Ein eigener Test braucht `root.size` vor `popup_centered`, sonst platziert + Godot die Fenster bei headless-Läufen auf negative Koordinaten. + ## Nächster Durchgang: weitere Node-Schnitte Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, diff --git a/docs/roadmap.md b/docs/roadmap.md index 4be3efd..7f873f0 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -273,7 +273,8 @@ Schritte. `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.154 Zeilen; `HelpContent`, `SeasonComparisonText`, `ValidationReportView`, `ExportService`, `RulesContext`, `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel`, - `PlaybackPanel` und `TimelineLabelModel` ausgelagert. + `PlaybackPanel`, `TimelineLabelModel` und dem ersten eigenständigen + Panel-Test 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/scenes/export/export_panel.tscn b/rinkplanner/scenes/export/export_panel.tscn new file mode 100644 index 0000000..ac43ee1 --- /dev/null +++ b/rinkplanner/scenes/export/export_panel.tscn @@ -0,0 +1,134 @@ +[gd_scene load_steps=2 format=3] + +[ext_resource type="Script" path="res://src/whiteboard/view/export_panel.gd" id="1_export_panel"] + +[node name="ExportPanel" type="Node"] +unique_name_in_owner = true +script = ExtResource("1_export_panel") + +[node name="ExportDialog" type="ConfirmationDialog" parent="."] +unique_name_in_owner = true +title = "Kür exportieren" +size = Vector2i(480, 520) +wrap_controls = false +ok_button_text = "Exportieren" +cancel_button_text = "Abbrechen" + +[node name="ExportScroll" type="ScrollContainer" parent="ExportDialog"] +layout_mode = 1 +anchors_preset = 15 +anchor_right = 1.0 +anchor_bottom = 1.0 +offset_left = 8.0 +offset_top = 8.0 +offset_right = -8.0 +offset_bottom = -64.0 +grow_horizontal = 2 +grow_vertical = 2 +horizontal_scroll_mode = 0 +follow_focus = true + +[node name="ExportBox" type="VBoxContainer" parent="ExportDialog/ExportScroll"] +layout_mode = 2 +size_flags_horizontal = 3 +theme_override_constants/separation = 4 + +[node name="ExportNameLabel" type="Label" parent="ExportDialog/ExportScroll/ExportBox"] +layout_mode = 2 +text = "Dateiname" + +[node name="ExportNameEdit" type="LineEdit" parent="ExportDialog/ExportScroll/ExportBox"] +unique_name_in_owner = true +custom_minimum_size = Vector2(0, 48) +layout_mode = 2 + +[node name="ExportFormatLabel" type="Label" parent="ExportDialog/ExportScroll/ExportBox"] +layout_mode = 2 +text = "Format" + +[node name="ExportFormatOption" type="OptionButton" parent="ExportDialog/ExportScroll/ExportBox"] +unique_name_in_owner = true +custom_minimum_size = Vector2(0, 48) +layout_mode = 2 + +[node name="ExportScopeLabel" type="Label" parent="ExportDialog/ExportScroll/ExportBox"] +layout_mode = 2 +text = "Umfang" + +[node name="ExportScopeOption" type="OptionButton" parent="ExportDialog/ExportScroll/ExportBox"] +unique_name_in_owner = true +custom_minimum_size = Vector2(0, 48) +layout_mode = 2 + +[node name="ExportHint" type="Label" parent="ExportDialog/ExportScroll/ExportBox"] +custom_minimum_size = Vector2(0, 34) +layout_mode = 2 +theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) +theme_override_font_sizes/font_size = 12 +text = "Ziel: export-Ordner im App-Datenverzeichnis · der absolute Pfad erscheint nach dem Export" +autowrap_mode = 3 + +[node name="ExportOpenAfterCheck" type="CheckBox" parent="ExportDialog/ExportScroll/ExportBox"] +unique_name_in_owner = true +custom_minimum_size = Vector2(0, 44) +layout_mode = 2 +button_pressed = true +text = "Nach dem Export öffnen" +tooltip_text = "Ergebnis nach dem Export mit dem Standardprogramm öffnen" + +[node name="ExportDoneDialog" type="AcceptDialog" parent="."] +unique_name_in_owner = true +title = "Export abgeschlossen" +size = Vector2i(660, 320) +wrap_controls = false +exclusive = false +ok_button_text = "Schließen" + +[node name="ExportDoneBox" type="VBoxContainer" parent="ExportDoneDialog"] +layout_mode = 1 +anchors_preset = 15 +anchor_right = 1.0 +anchor_bottom = 1.0 +offset_left = 12.0 +offset_top = 12.0 +offset_right = -12.0 +offset_bottom = -64.0 +grow_horizontal = 2 +grow_vertical = 2 +theme_override_constants/separation = 4 + +[node name="ExportDoneLabel" type="RichTextLabel" parent="ExportDoneDialog/ExportDoneBox"] +unique_name_in_owner = true +custom_minimum_size = Vector2(0, 96) +layout_mode = 2 +size_flags_vertical = 3 +bbcode_enabled = false +scroll_active = false +selection_enabled = true +autowrap_mode = 3 + +[node name="ExportDoneButtons" type="HFlowContainer" parent="ExportDoneDialog/ExportDoneBox"] +layout_mode = 2 +theme_override_constants/h_separation = 6 +theme_override_constants/v_separation = 8 + +[node name="ExportOpenButton" type="Button" parent="ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] +unique_name_in_owner = true +custom_minimum_size = Vector2(140, 48) +layout_mode = 2 +text = "Öffnen" +tooltip_text = "Datei mit dem Standardprogramm öffnen" + +[node name="ExportFolderButton" type="Button" parent="ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] +unique_name_in_owner = true +custom_minimum_size = Vector2(180, 48) +layout_mode = 2 +text = "Ordner anzeigen" +tooltip_text = "Exportordner im Dateimanager öffnen" + +[node name="ExportCopyPathButton" type="Button" parent="ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] +unique_name_in_owner = true +custom_minimum_size = Vector2(170, 48) +layout_mode = 2 +text = "Pfad kopieren" +tooltip_text = "Absoluten Dateipfad in die Zwischenablage kopieren" diff --git a/rinkplanner/scenes/whiteboard/whiteboard.tscn b/rinkplanner/scenes/whiteboard/whiteboard.tscn index f38d460..8407845 100644 --- a/rinkplanner/scenes/whiteboard/whiteboard.tscn +++ b/rinkplanner/scenes/whiteboard/whiteboard.tscn @@ -1,10 +1,11 @@ -[gd_scene load_steps=24 format=3] +[gd_scene load_steps=25 format=3] [ext_resource type="Script" path="res://src/whiteboard/ctrl/whiteboard_controller.gd" id="1_controller"] [ext_resource type="Script" path="res://src/whiteboard/view/rink_canvas.gd" id="2_canvas"] [ext_resource type="Script" path="res://src/whiteboard/view/timeline_label_lane.gd" id="3_label_lane"] [ext_resource type="Script" path="res://src/whiteboard/view/export_panel.gd" id="3_export_panel"] [ext_resource type="Script" path="res://src/whiteboard/view/playback_panel.gd" id="3_playback_panel"] +[ext_resource type="PackedScene" path="res://scenes/export/export_panel.tscn" id="14_export_panel_scene"] [ext_resource type="Texture2D" path="res://assets/icons/tools/select.svg" id="4_tool_select"] [ext_resource type="Texture2D" path="res://assets/icons/tools/line.svg" id="5_tool_line"] [ext_resource type="Texture2D" path="res://assets/icons/tools/arc_left.svg" id="6_tool_arc_left"] @@ -1654,136 +1655,8 @@ text = "Geschwindigkeit = Strecke / Zeit" unique_name_in_owner = true script = ExtResource("3_playback_panel") -[node name="ExportPanel" type="Node" parent="."] +[node name="ExportPanel" parent="." instance=ExtResource("14_export_panel_scene")] unique_name_in_owner = true -script = ExtResource("3_export_panel") - -[node name="ExportDialog" type="ConfirmationDialog" parent="ExportPanel"] -unique_name_in_owner = true -title = "Kür exportieren" -size = Vector2i(480, 520) -wrap_controls = false -ok_button_text = "Exportieren" -cancel_button_text = "Abbrechen" - -[node name="ExportScroll" type="ScrollContainer" parent="ExportPanel/ExportDialog"] -layout_mode = 1 -anchors_preset = 15 -anchor_right = 1.0 -anchor_bottom = 1.0 -offset_left = 8.0 -offset_top = 8.0 -offset_right = -8.0 -offset_bottom = -64.0 -grow_horizontal = 2 -grow_vertical = 2 -horizontal_scroll_mode = 0 -follow_focus = true - -[node name="ExportBox" type="VBoxContainer" parent="ExportPanel/ExportDialog/ExportScroll"] -layout_mode = 2 -size_flags_horizontal = 3 -theme_override_constants/separation = 4 - -[node name="ExportNameLabel" type="Label" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] -layout_mode = 2 -text = "Dateiname" - -[node name="ExportNameEdit" type="LineEdit" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] -unique_name_in_owner = true -custom_minimum_size = Vector2(0, 48) -layout_mode = 2 - -[node name="ExportFormatLabel" type="Label" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] -layout_mode = 2 -text = "Format" - -[node name="ExportFormatOption" type="OptionButton" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] -unique_name_in_owner = true -custom_minimum_size = Vector2(0, 48) -layout_mode = 2 - -[node name="ExportScopeLabel" type="Label" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] -layout_mode = 2 -text = "Umfang" - -[node name="ExportScopeOption" type="OptionButton" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] -unique_name_in_owner = true -custom_minimum_size = Vector2(0, 48) -layout_mode = 2 - -[node name="ExportHint" type="Label" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] -custom_minimum_size = Vector2(0, 34) -layout_mode = 2 -theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) -theme_override_font_sizes/font_size = 12 -text = "Ziel: export-Ordner im App-Datenverzeichnis · der absolute Pfad erscheint nach dem Export" -autowrap_mode = 3 - -[node name="ExportOpenAfterCheck" type="CheckBox" parent="ExportPanel/ExportDialog/ExportScroll/ExportBox"] -unique_name_in_owner = true -custom_minimum_size = Vector2(0, 44) -layout_mode = 2 -button_pressed = true -text = "Nach dem Export öffnen" -tooltip_text = "Ergebnis nach dem Export mit dem Standardprogramm öffnen" - -[node name="ExportDoneDialog" type="AcceptDialog" parent="ExportPanel"] -unique_name_in_owner = true -title = "Export abgeschlossen" -size = Vector2i(660, 320) -wrap_controls = false -exclusive = false -ok_button_text = "Schließen" - -[node name="ExportDoneBox" type="VBoxContainer" parent="ExportPanel/ExportDoneDialog"] -layout_mode = 1 -anchors_preset = 15 -anchor_right = 1.0 -anchor_bottom = 1.0 -offset_left = 12.0 -offset_top = 12.0 -offset_right = -12.0 -offset_bottom = -64.0 -grow_horizontal = 2 -grow_vertical = 2 -theme_override_constants/separation = 4 - -[node name="ExportDoneLabel" type="RichTextLabel" parent="ExportPanel/ExportDoneDialog/ExportDoneBox"] -unique_name_in_owner = true -custom_minimum_size = Vector2(0, 96) -layout_mode = 2 -size_flags_vertical = 3 -bbcode_enabled = false -scroll_active = false -selection_enabled = true -autowrap_mode = 3 - -[node name="ExportDoneButtons" type="HFlowContainer" parent="ExportPanel/ExportDoneDialog/ExportDoneBox"] -layout_mode = 2 -theme_override_constants/h_separation = 6 -theme_override_constants/v_separation = 8 - -[node name="ExportOpenButton" type="Button" parent="ExportPanel/ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] -unique_name_in_owner = true -custom_minimum_size = Vector2(140, 48) -layout_mode = 2 -text = "Öffnen" -tooltip_text = "Datei mit dem Standardprogramm öffnen" - -[node name="ExportFolderButton" type="Button" parent="ExportPanel/ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] -unique_name_in_owner = true -custom_minimum_size = Vector2(180, 48) -layout_mode = 2 -text = "Ordner anzeigen" -tooltip_text = "Exportordner im Dateimanager öffnen" - -[node name="ExportCopyPathButton" type="Button" parent="ExportPanel/ExportDoneDialog/ExportDoneBox/ExportDoneButtons"] -unique_name_in_owner = true -custom_minimum_size = Vector2(170, 48) -layout_mode = 2 -text = "Pfad kopieren" -tooltip_text = "Absoluten Dateipfad in die Zwischenablage kopieren" [node name="ElementFeatureMenu" type="PopupMenu" parent="."] unique_name_in_owner = true diff --git a/rinkplanner/tests/run_export_panel_tests.gd b/rinkplanner/tests/run_export_panel_tests.gd new file mode 100644 index 0000000..e332361 --- /dev/null +++ b/rinkplanner/tests/run_export_panel_tests.gd @@ -0,0 +1,131 @@ +extends SceneTree + +## Headless test for `ExportPanel` on its own. +## +## No WhiteboardController, no routine scene: the panel is instantiated from +## `scenes/export/export_panel.tscn` and reports its choices through signals. +## This is the measure of whether the module is really separate. +## +## Run with: +## godot --headless --path rinkplanner --script res://tests/run_export_panel_tests.gd + +const PanelScene := preload("res://scenes/export/export_panel.tscn") + +var _assertions: int = 0 +var _failures: PackedStringArray = PackedStringArray() + + +func _init() -> void: + _run.call_deferred() + + +func _run() -> void: + var panel := PanelScene.instantiate() as ExportPanel + _check(panel != null, "the panel scene carries its script") + if panel == null: + _finish() + return + # Without a window size, popup_centered places dialogs at negative offsets + # in headless runs; give the root window a sane size. + root.size = Vector2i(1280, 800) + root.add_child(panel) + await process_frame + + _check( + panel.dialog != null and panel.done_dialog != null, + "both dialogs are wired" + ) + _check( + panel.format_option.item_count == 3, + "three export formats are offered" + ) + + var routine := Routine.new() + routine.routine_id = "panel-test" + routine.title = "Kür am See" + routine.rink = RinkDimensions.new() + var section := RoutineSection.new() + section.section_id = "s1" + section.title = "Abschnitt 1" + + # Lambdas capture by value: mutate the dictionary instead of rebinding it. + var captured: Dictionary = {} + panel.export_requested.connect( + func( + path: String, + format: int, + section_id: String, + open_after: bool + ) -> void: + captured["path"] = path + captured["format"] = format + captured["section_id"] = section_id + captured["open_after"] = open_after + ) + + panel.open_for(routine, section, Vector2i(480, 520)) + _check(panel.dialog.visible, "the dialog opens") + _check(panel.name_edit.text == "Kür am See", "the routine title fills the name") + + panel.dialog.confirmed.emit() + _check( + str(captured.get("path", "")).ends_with("kür_am_see.svg"), + "the default format is SVG with a clean file stem (%s)" + % captured.get("path", "") + ) + _check(int(captured.get("format", -1)) == 0, "the format id is passed") + _check( + str(captured.get("section_id", "x")).is_empty(), + "the whole routine is the default scope" + ) + + panel.scope_option.select(1) + panel.format_option.select(2) + captured.clear() + panel.dialog.confirmed.emit() + _check(int(captured.get("format", -1)) == 2, "the PDF format is passed") + _check( + str(captured.get("path", "")).ends_with("_abschnitt_1.pdf"), + "the section suffix is added (%s)" % captured.get("path", "") + ) + _check( + str(captured.get("section_id", "")) == "s1", + "the section id is passed" + ) + + var messages: Array = [] + panel.message_requested.connect( + func(text: String) -> void: + messages.append(text) + ) + panel.name_edit.text = " " + captured.clear() + panel.dialog.confirmed.emit() + _check(captured.is_empty(), "an empty name does not export") + _check(not messages.is_empty(), "an empty name asks for input") + + # The done dialog only enables "open" for an existing file. + panel.show_done("/tmp/does-not-exist.pdf", Vector2i(660, 320)) + _check(panel.open_button.disabled, "missing files cannot be opened") + _check(panel.done_dialog.visible, "the done dialog opens") + + panel.queue_free() + await process_frame + _finish() + + +func _check(condition: bool, message: String) -> void: + _assertions += 1 + if not condition: + _failures.append(message) + + +func _finish() -> void: + if _failures.is_empty(): + print("PASS: %d assertions" % _assertions) + quit(0) + return + for failure: String in _failures: + printerr("FAIL: %s" % failure) + printerr("%d of %d assertions failed" % [_failures.size(), _assertions]) + quit(1) diff --git a/rinkplanner/tests/run_export_panel_tests.gd.uid b/rinkplanner/tests/run_export_panel_tests.gd.uid new file mode 100644 index 0000000..14dcb04 --- /dev/null +++ b/rinkplanner/tests/run_export_panel_tests.gd.uid @@ -0,0 +1 @@ +uid://b6r15yds80ibm diff --git a/tools/test.sh b/tools/test.sh index 26346bb..422cde7 100755 --- a/tools/test.sh +++ b/tools/test.sh @@ -66,6 +66,9 @@ fi "$GODOT" --headless --path "$PROJECT_DIR" \ --script res://tests/run_timing_tests.gd +"$GODOT" --headless --path "$PROJECT_DIR" \ + --script res://tests/run_export_panel_tests.gd + "$GODOT" --headless --path "$PROJECT_DIR" \ --script res://tests/run_export_tests.gd From 5161869ec2f061e4b9396752ea083e0caaf7eafa Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:06:44 +0100 Subject: [PATCH 17/28] refactor: Anbieterliste der Sync-Einstellungen als Modell MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `SyncSettingsModel` (src/whiteboard/view/sync_settings_model.gd) baut die Anbieterliste aus der Build-Konfiguration: Google Drive nur mit OAuth-Zugangsdaten, Dropbox immer (damit ein Entwickler-Build die fehlende Konfiguration zeigt statt einer leeren Liste). Der Controller füllt sein Dropdown nur noch daraus. Test für die drei Fälle (nur Dropbox, mit Google, ohne Zugangsdaten) und die Suche per Id. Controller: 8.154 -> 8.142 Zeilen. Suite grün. Kein eigener Dialog-Schnitt an dieser Stelle: Der Sync-Dialog enthält Sync und Hub zusammen und hängt an Threads; eine Szene ohne verschobenes Verhalten wäre nur eine Existenzprüfung. --- docs/refactor-whiteboard-controller.md | 16 ++++++++- docs/roadmap.md | 4 +-- .../whiteboard/ctrl/whiteboard_controller.gd | 26 ++++----------- .../whiteboard/view/sync_settings_model.gd | 33 +++++++++++++++++++ .../view/sync_settings_model.gd.uid | 1 + rinkplanner/tests/run_sync_tests.gd | 24 ++++++++++++++ 6 files changed, 82 insertions(+), 22 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/sync_settings_model.gd create mode 100644 rinkplanner/src/whiteboard/view/sync_settings_model.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index fe78601..25c6087 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–11 sind es 8.154 Zeilen. Diese Notiz +Nach Etappe 13 sind es 8.142 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -38,6 +38,7 @@ passiert und nicht als Big Bang. | `PlaybackPose` | Position und Blickrichtung zur Zeit | 130 | keine | 8 ✅ | | `PlaybackPanel` | Transportleiste: Play/Pause, Reset, Slider, Tempo | 110 | Szene | 10 ✅ | | `TimelineLabelModel` | Labels der Zeitachse einsammeln | 55 | keine | 11 ✅ | +| `SyncSettingsModel` | Anbieterliste der Sync-Einstellungen | 40 | keine | 13 ✅ | | Playback-Rest | Musik, Label-Dialog, 3D-Anbindung | ~300 | Canvas, Audio | offen | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 | @@ -215,6 +216,19 @@ Zwei Stolpersteine beim Auslagern einer Szene: - Ein eigener Test braucht `root.size` vor `popup_centered`, sonst platziert Godot die Fenster bei headless-Läufen auf negative Koordinaten. +### 13. `SyncSettingsModel` ✅ + +Die Anbieterliste der Sync-Einstellungen liegt in +`src/whiteboard/view/sync_settings_model.gd`: Das Build-Konfigurationsobjekt +geht rein, die auswählbaren Anbieter kommen raus. Google Drive erscheint nur +mit OAuth-Zugangsdaten; Dropbox bleibt auch ohne sichtbar, damit ein +Entwickler-Build die fehlende Konfiguration zeigt statt einer leeren Liste. + +**Warum hier kein eigener Dialog-Schnitt folgt:** Der Sync-Dialog enthält +Sync *und* Hub (rund 30 Widgets) und hängt an Threads und OAuth-Zustand. Eine +eigene Szene ohne verschobenes Verhalten ergäbe einen Test, der nur prüft, +dass Widgets existieren — das ist keine Aussage über Modularität. + ## Nächster Durchgang: weitere Node-Schnitte Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, diff --git a/docs/roadmap.md b/docs/roadmap.md index 7f873f0..fb7c86a 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -273,8 +273,8 @@ Schritte. `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.154 Zeilen; `HelpContent`, `SeasonComparisonText`, `ValidationReportView`, `ExportService`, `RulesContext`, `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel`, - `PlaybackPanel`, `TimelineLabelModel` und dem ersten eigenständigen - Panel-Test ausgelagert. + `PlaybackPanel`, `TimelineLabelModel`, `SyncSettingsModel` und dem ersten + eigenständigen Panel-Test 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 59556c2..fae1b71 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -5690,25 +5690,13 @@ func _open_sync_settings_dialog() -> void: func _ensure_sync_provider_items() -> void: if sync_provider_option.item_count > 0: return - var app := SyncAppConfig.load_config() - var has_dropbox := SyncAppConfig.is_configured("dropbox", app) - var has_google := SyncAppConfig.is_configured("google_drive", app) - if not has_dropbox: - # Developer build without app credentials: show Dropbox so the - # missing configuration is visible instead of an empty dropdown. - has_dropbox = true - if has_dropbox: - sync_provider_option.add_item("Dropbox", 0) - sync_provider_option.set_item_metadata( - sync_provider_option.item_count - 1, - "dropbox" - ) - if has_google: - sync_provider_option.add_item("Google Drive", 1) - sync_provider_option.set_item_metadata( - sync_provider_option.item_count - 1, - "google_drive" - ) + var items := SyncSettingsModel.provider_items( + SyncAppConfig.load_config() + ) + for index: int in range(items.size()): + var item: Dictionary = items[index] + sync_provider_option.add_item(str(item["label"]), index) + sync_provider_option.set_item_metadata(index, str(item["value"])) func _apply_sync_provider_to_ui(provider: String) -> void: diff --git a/rinkplanner/src/whiteboard/view/sync_settings_model.gd b/rinkplanner/src/whiteboard/view/sync_settings_model.gd new file mode 100644 index 0000000..0a77cba --- /dev/null +++ b/rinkplanner/src/whiteboard/view/sync_settings_model.gd @@ -0,0 +1,33 @@ +class_name SyncSettingsModel +extends RefCounted + +## Content of the sync provider dropdown. +## +## Pure: the app configuration goes in, the list of selectable providers comes +## out. Google Drive only appears when the build carries OAuth credentials; +## Dropbox always appears, even without credentials, so a developer build shows +## the missing configuration instead of an empty dropdown. + +const PROVIDERS := [ + {"id": "dropbox", "label": "Dropbox", "always": true}, + {"id": "google_drive", "label": "Google Drive", "always": false}, +] + + +## Returns `[{"label": String, "value": String}]`. +static func provider_items(app: Dictionary) -> Array[Dictionary]: + var items: Array[Dictionary] = [] + for provider: Dictionary in PROVIDERS: + var id := str(provider["id"]) + if not bool(provider["always"]) and not SyncAppConfig.is_configured(id, app): + continue + items.append({"label": str(provider["label"]), "value": id}) + return items + + +## Index of [param provider] in a list built by [method provider_items], or -1. +static func index_of(items: Array, provider: String) -> int: + for index: int in range(items.size()): + if str((items[index] as Dictionary).get("value", "")) == provider: + return index + return -1 diff --git a/rinkplanner/src/whiteboard/view/sync_settings_model.gd.uid b/rinkplanner/src/whiteboard/view/sync_settings_model.gd.uid new file mode 100644 index 0000000..2a5261d --- /dev/null +++ b/rinkplanner/src/whiteboard/view/sync_settings_model.gd.uid @@ -0,0 +1 @@ +uid://dycuog2mepmfp diff --git a/rinkplanner/tests/run_sync_tests.gd b/rinkplanner/tests/run_sync_tests.gd index d6fc285..bb969e7 100644 --- a/rinkplanner/tests/run_sync_tests.gd +++ b/rinkplanner/tests/run_sync_tests.gd @@ -813,6 +813,30 @@ func _test_controller_wiring() -> void: "die Sync-Zusammenfassung nennt Gewinner und Konfliktarchiv" ) + # SyncSettingsModel: Anbieterliste hängt an der Build-Konfiguration. + var only_dropbox := SyncSettingsModel.provider_items({"dropbox_app_key": "key"}) + _check( + only_dropbox.size() == 1 + and str(only_dropbox[0]["value"]) == "dropbox", + "without Google credentials only Dropbox is offered" + ) + var with_google := SyncSettingsModel.provider_items( + { + "dropbox_app_key": "key", + "google_client_id": "id", + "google_client_secret": "secret", + } + ) + _check(with_google.size() == 2, "Google Drive appears when configured") + _check( + SyncSettingsModel.index_of(with_google, "google_drive") == 1, + "the provider list is searchable by id" + ) + _check( + SyncSettingsModel.provider_items({}).size() == 1, + "Dropbox stays visible without credentials" + ) + # "Küren verwalten": rows expose open/delete, the music stay-check works. controller.sync_settings_dialog.hide() DirAccess.make_dir_recursive_absolute( From a83583120156e35009859b0c29ba75d649723c78 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:08:34 +0100 Subject: [PATCH 18/28] =?UTF-8?q?refactor:=20Verhaltenskern=20der=20K?= =?UTF-8?q?=C3=BCrenverwaltung=20als=20Modell?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `RoutineManagerModel` (src/whiteboard/view/routine_manager_model.gd) bündelt, was die Kürenverwaltung über Dateien wissen muss: - `list_routines(dir)` — eine Zeile pro Kür, JSON vor Legacy, nach Namen sortiert, Fremddateien ignoriert. - `variants(dir, name)` — alle vorhandenen Dateien einer Kür (JSON und/oder `.tres`), mit Rückfall auf den übergebenen Namen. Der Controller ruft nur noch die beiden Funktionen auf. Test mit temporärem Ordner: Dubletten, Sortierung, Fremddateien, fehlende Kür. Controller: 8.142 -> 8.116 Zeilen. Suite grün. Der Dialog selbst bleibt offen: Seine Zeilenknöpfe hängen an Controller-Handlern, und Öffnen/Umbenennen/Löschen brauchen Sync und den aktuellen Pfad. --- docs/refactor-whiteboard-controller.md | 18 +++++++- docs/roadmap.md | 4 +- .../whiteboard/ctrl/whiteboard_controller.gd | 30 +------------ .../whiteboard/view/routine_manager_model.gd | 45 +++++++++++++++++++ .../view/routine_manager_model.gd.uid | 1 + rinkplanner/tests/run_sync_tests.gd | 25 +++++++++++ 6 files changed, 92 insertions(+), 31 deletions(-) create mode 100644 rinkplanner/src/whiteboard/view/routine_manager_model.gd create mode 100644 rinkplanner/src/whiteboard/view/routine_manager_model.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 25c6087..fabd510 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 -Nach Etappe 13 sind es 8.142 Zeilen. Diese Notiz +Nach Etappe 14 sind es 8.116 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -39,6 +39,7 @@ passiert und nicht als Big Bang. | `PlaybackPanel` | Transportleiste: Play/Pause, Reset, Slider, Tempo | 110 | Szene | 10 ✅ | | `TimelineLabelModel` | Labels der Zeitachse einsammeln | 55 | keine | 11 ✅ | | `SyncSettingsModel` | Anbieterliste der Sync-Einstellungen | 40 | keine | 13 ✅ | +| `RoutineManagerModel` | Küren listen, Varianten finden | 55 | Dateisystem | 14 ✅ | | Playback-Rest | Musik, Label-Dialog, 3D-Anbindung | ~300 | Canvas, Audio | offen | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 | @@ -229,6 +230,21 @@ Sync *und* Hub (rund 30 Widgets) und hängt an Threads und OAuth-Zustand. Eine eigene Szene ohne verschobenes Verhalten ergäbe einen Test, der nur prüft, dass Widgets existieren — das ist keine Aussage über Modularität. +### 14. `RoutineManagerModel` ✅ + +Die Kürenverwaltung bekommt ihren Verhaltenskern: `list_routines(dir)` liefert +eine Zeile pro Kür (JSON vor Legacy, nach Namen sortiert, Fremddateien +ignoriert), `variants(dir, name)` alle vorhandenen Dateien einer Kür. + +Damit ist die Grundlage für den späteren Panel-Schnitt gelegt — und der +Dateizugriff ist ohne Szene prüfbar (Test mit einem temporären Ordner: +Dubletten, Sortierung, Fremddateien, fehlende Kür). + +**Noch offen:** der Dialog selbst. Seine Zeilenknöpfe sind an +Controller-Handler gebunden (`open`, `rename`, `delete`, Konflikte), und die +Abläufe brauchen Sync und den aktuellen Dateipfad. Der nächste Schritt wäre, +diese Abläufe als `RoutineManagerActions` zu bündeln, dann das Panel. + ## Nächster Durchgang: weitere Node-Schnitte Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, diff --git a/docs/roadmap.md b/docs/roadmap.md index fb7c86a..48a5805 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -273,8 +273,8 @@ Schritte. `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.154 Zeilen; `HelpContent`, `SeasonComparisonText`, `ValidationReportView`, `ExportService`, `RulesContext`, `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel`, - `PlaybackPanel`, `TimelineLabelModel`, `SyncSettingsModel` und dem ersten - eigenständigen Panel-Test ausgelagert. + `PlaybackPanel`, `TimelineLabelModel`, `SyncSettingsModel`, + `RoutineManagerModel` und dem ersten eigenständigen Panel-Test 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 fae1b71..298e40b 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -7225,18 +7225,7 @@ func _on_delete_routine_confirmed() -> void: ## A routine can exist as JSON and as a legacy `.tres` twin. Deleting the ## visible entry removes both so the old file does not reappear. func _routine_variants(file_name: String) -> PackedStringArray: - var stem := file_name.get_basename() - var result := PackedStringArray() - for extension: String in [ - RoutineFile.JSON_EXTENSION, - RoutineFile.LEGACY_EXTENSION, - ]: - var candidate := stem + extension - if FileAccess.file_exists(ROUTINES_DIR.path_join(candidate)): - result.append(candidate) - if result.is_empty(): - result.append(file_name) - return result + return RoutineManagerModel.variants(ROUTINES_DIR, file_name) func _open_rename_routine_dialog(file_name: String) -> void: @@ -7483,22 +7472,7 @@ func _refresh_open_list() -> void: ## Saved routine files, one per title (JSON wins over a legacy `.tres` twin). func _routine_entries() -> Array[String]: _ensure_routines_dir() - var by_stem: Dictionary[String, String] = {} - for file: String in DirAccess.get_files_at(ROUTINES_DIR): - if not RoutineFile.is_routine_path(file): - continue - var stem := file.get_basename() - var is_json := file.to_lower().ends_with(RoutineFile.JSON_EXTENSION) - if not by_stem.has(stem) or is_json: - by_stem[stem] = file - var entries: Array[String] = [] - for file: String in by_stem.values(): - entries.append(file) - entries.sort_custom( - func(a: String, b: String) -> bool: - return a.get_basename().naturalnocasecmp_to(b.get_basename()) < 0 - ) - return entries + return RoutineManagerModel.list_routines(ROUTINES_DIR) func _on_open_file_pressed(path: String) -> void: diff --git a/rinkplanner/src/whiteboard/view/routine_manager_model.gd b/rinkplanner/src/whiteboard/view/routine_manager_model.gd new file mode 100644 index 0000000..844b5ab --- /dev/null +++ b/rinkplanner/src/whiteboard/view/routine_manager_model.gd @@ -0,0 +1,45 @@ +class_name RoutineManagerModel +extends RefCounted + +## What the routine manager lists and deletes. +## +## Pure over a directory: no scene, no sync. A routine may exist as JSON and as +## the legacy `.tres`; the manager shows it once and works on all its variants. + + +## Routine files of [param dir], one entry per routine, sorted by name. +## JSON wins over the legacy format for the same stem. +static func list_routines(dir: String) -> Array[String]: + var by_stem: Dictionary[String, String] = {} + for file: String in DirAccess.get_files_at(dir): + if not RoutineFile.is_routine_path(file): + continue + var stem := file.get_basename() + var is_json := file.to_lower().ends_with(RoutineFile.JSON_EXTENSION) + if not by_stem.has(stem) or is_json: + by_stem[stem] = file + var entries: Array[String] = [] + for file: String in by_stem.values(): + entries.append(file) + entries.sort_custom( + func(a: String, b: String) -> bool: + return a.get_basename().naturalnocasecmp_to(b.get_basename()) < 0 + ) + return entries + + +## All existing file names of one routine: JSON and/or the legacy `.tres`. +## Falls back to [param file_name] when no variant is on disk. +static func variants(dir: String, file_name: String) -> PackedStringArray: + var stem := file_name.get_basename() + var result := PackedStringArray() + for extension: String in [ + RoutineFile.JSON_EXTENSION, + RoutineFile.LEGACY_EXTENSION, + ]: + var candidate := stem + extension + if FileAccess.file_exists(dir.path_join(candidate)): + result.append(candidate) + if result.is_empty(): + result.append(file_name) + return result diff --git a/rinkplanner/src/whiteboard/view/routine_manager_model.gd.uid b/rinkplanner/src/whiteboard/view/routine_manager_model.gd.uid new file mode 100644 index 0000000..7ff4b13 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/routine_manager_model.gd.uid @@ -0,0 +1 @@ +uid://5q62oxkubssd diff --git a/rinkplanner/tests/run_sync_tests.gd b/rinkplanner/tests/run_sync_tests.gd index bb969e7..e87ab71 100644 --- a/rinkplanner/tests/run_sync_tests.gd +++ b/rinkplanner/tests/run_sync_tests.gd @@ -837,6 +837,31 @@ func _test_controller_wiring() -> void: "Dropbox stays visible without credentials" ) + # RoutineManagerModel: eine Zeile pro Kür, JSON vor Legacy, sortiert. + var model_dir := "user://routine-manager-model" + DirAccess.make_dir_recursive_absolute(ProjectSettings.globalize_path(model_dir)) + for name: String in ["b.tres", "a.json", "c.json", "c.tres", "notes.txt"]: + var file := FileAccess.open(model_dir.path_join(name), FileAccess.WRITE) + if file != null: + file.store_string("{}") + file.close() + var listed := RoutineManagerModel.list_routines(model_dir) + _check(listed.size() == 3, "one row per routine, ignoring other files (%d)" % listed.size()) + _check(str(listed[0]) == "a.json", "routines are sorted by name") + _check(listed.has("c.json") and not listed.has("c.tres"), "JSON wins over the legacy format") + var variants := RoutineManagerModel.variants(model_dir, "c.json") + _check( + variants.size() == 2 and variants.has("c.json") and variants.has("c.tres"), + "both variants of a routine are found" + ) + _check( + RoutineManagerModel.variants(model_dir, "missing.json") == PackedStringArray(["missing.json"]), + "a missing routine falls back to its name" + ) + for name: String in ["b.tres", "a.json", "c.json", "c.tres", "notes.txt"]: + DirAccess.remove_absolute(model_dir.path_join(name)) + DirAccess.remove_absolute(model_dir) + # "Küren verwalten": rows expose open/delete, the music stay-check works. controller.sync_settings_dialog.hide() DirAccess.make_dir_recursive_absolute( From 7c83128d28e47de532eb7f2eb8cef9ee8453e6b9 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:10:51 +0100 Subject: [PATCH 19/28] =?UTF-8?q?refactor:=20Dialog=20"K=C3=BCren=20verwal?= =?UTF-8?q?ten"=20als=20eigene=20Szene?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `scenes/routine/routine_manager_panel.tscn` mit `RoutineManagerPanel`: Das Panel baut die Zeilen (Öffnen/Umbenennen/Löschen) und meldet die Auswahl über Signale. Die Abläufe bleiben beim Controller, weil sie Dateien, den aktuellen Pfad und den Sync brauchen. - Der Controller füllt das Panel nur noch (`open_for`, `refresh`), prüft `is_open()` und schließt es über `close()`. - `manager_tabs` ist aus dem Controller entfernt: `%Name` gilt nur innerhalb der Szene, die den Knoten besitzt. - Neuer eigener Test `run_routine_manager_panel_tests.gd` (13 Assertions): Zeilen, Signalnutzlast, Neuaufbau, Leerzustand, Öffnen/Schließen. Controller: 8.116 -> 8.082 Zeilen. Suite grün (23 Suiten). --- docs/refactor-whiteboard-controller.md | 18 +++- docs/roadmap.md | 3 +- .../scenes/routine/routine_manager_panel.tscn | 77 +++++++++++++++++ rinkplanner/scenes/whiteboard/whiteboard.tscn | 72 +--------------- .../whiteboard/ctrl/whiteboard_controller.gd | 60 +++---------- .../whiteboard/view/routine_manager_panel.gd | 82 ++++++++++++++++++ .../view/routine_manager_panel.gd.uid | 1 + .../tests/run_routine_manager_panel_tests.gd | 86 +++++++++++++++++++ .../run_routine_manager_panel_tests.gd.uid | 1 + rinkplanner/tests/run_sync_tests.gd | 10 +-- tools/test.sh | 3 + 11 files changed, 290 insertions(+), 123 deletions(-) create mode 100644 rinkplanner/scenes/routine/routine_manager_panel.tscn create mode 100644 rinkplanner/src/whiteboard/view/routine_manager_panel.gd create mode 100644 rinkplanner/src/whiteboard/view/routine_manager_panel.gd.uid create mode 100644 rinkplanner/tests/run_routine_manager_panel_tests.gd create mode 100644 rinkplanner/tests/run_routine_manager_panel_tests.gd.uid diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index fabd510..de9eb82 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 -Nach Etappe 14 sind es 8.116 Zeilen. Diese Notiz +Nach Etappe 15 sind es 8.082 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -40,6 +40,7 @@ passiert und nicht als Big Bang. | `TimelineLabelModel` | Labels der Zeitachse einsammeln | 55 | keine | 11 ✅ | | `SyncSettingsModel` | Anbieterliste der Sync-Einstellungen | 40 | keine | 13 ✅ | | `RoutineManagerModel` | Küren listen, Varianten finden | 55 | Dateisystem | 14 ✅ | +| `RoutineManagerPanel` | Dialog "Küren verwalten" (eigene Szene) | 95 | Szene | 15 ✅ | | Playback-Rest | Musik, Label-Dialog, 3D-Anbindung | ~300 | Canvas, Audio | offen | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 | @@ -245,6 +246,21 @@ Controller-Handler gebunden (`open`, `rename`, `delete`, Konflikte), und die Abläufe brauchen Sync und den aktuellen Dateipfad. Der nächste Schritt wäre, diese Abläufe als `RoutineManagerActions` zu bündeln, dann das Panel. +### 15. `RoutineManagerPanel` ✅ + +Der Dialog „Küren verwalten" liegt in `scenes/routine/routine_manager_panel.tscn` +mit eigenem Skript. Das Panel baut die Zeilen (Öffnen / Umbenennen / Löschen) +und meldet die Auswahl; die Abläufe — Datei öffnen, umbenennen, löschen, +Konflikte suchen — bleiben beim Controller, weil sie Dateien, den aktuellen +Pfad und den Sync brauchen. + +`tests/run_routine_manager_panel_tests.gd` prüft das Panel allein: Zeilen, +Signalnutzlast, Neuaufbau, Leerzustand, Öffnen/Schließen (13 Assertions). + +Merke: `%Name` gilt nur innerhalb der Szene, die den Knoten besitzt. Der +Controller musste deshalb auf `manager_tabs` verzichten — die Tabs liegen +jetzt im Panel. + ## Nächster Durchgang: weitere Node-Schnitte Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, diff --git a/docs/roadmap.md b/docs/roadmap.md index 48a5805..46fa4ea 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -274,7 +274,8 @@ Schritte. `ValidationReportView`, `ExportService`, `RulesContext`, `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel`, `PlaybackPanel`, `TimelineLabelModel`, `SyncSettingsModel`, - `RoutineManagerModel` und dem ersten eigenständigen Panel-Test ausgelagert. + `RoutineManagerModel`, `RoutineManagerPanel` und zwei eigenständigen + Panel-Tests 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/scenes/routine/routine_manager_panel.tscn b/rinkplanner/scenes/routine/routine_manager_panel.tscn new file mode 100644 index 0000000..222d171 --- /dev/null +++ b/rinkplanner/scenes/routine/routine_manager_panel.tscn @@ -0,0 +1,77 @@ +[gd_scene load_steps=2 format=3] + +[ext_resource type="Script" path="res://src/whiteboard/view/routine_manager_panel.gd" id="1_manager_panel"] + +[node name="RoutineManagerPanel" type="Node"] +unique_name_in_owner = true +script = ExtResource("1_manager_panel") + +[node name="RoutineManagerDialog" type="AcceptDialog" parent="."] +unique_name_in_owner = true +title = "Küren verwalten" +size = Vector2i(800, 600) +exclusive = false +ok_button_text = "Schließen" + +[node name="ManagerBox" type="VBoxContainer" parent="RoutineManagerDialog"] +offset_left = 12.0 +offset_top = 12.0 +offset_right = 788.0 +offset_bottom = 530.0 +theme_override_constants/separation = 4 + +[node name="ManagerHint" type="Label" parent="RoutineManagerDialog/ManagerBox"] +layout_mode = 2 +theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) +theme_override_font_sizes/font_size = 14 +text = "Lokale Küren löschen oder alte Konfliktkopien aufräumen. Echte Sync-Konflikte löst die App automatisch nach dem neuesten Speicherstand auf." +autowrap_mode = 2 + +[node name="ManagerTabs" type="TabContainer" parent="RoutineManagerDialog/ManagerBox"] +unique_name_in_owner = true +layout_mode = 2 +size_flags_vertical = 3 + +[node name="RoutinesTab" type="VBoxContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs"] +layout_mode = 2 +theme_override_constants/separation = 4 + +[node name="RoutineManagerScroll" type="ScrollContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/RoutinesTab"] +layout_mode = 2 +size_flags_vertical = 3 +horizontal_scroll_mode = 0 + +[node name="RoutineManagerList" type="VBoxContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/RoutinesTab/RoutineManagerScroll"] +unique_name_in_owner = true +layout_mode = 2 +size_flags_horizontal = 3 +theme_override_constants/separation = 4 + +[node name="ConflictsTab" type="VBoxContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs"] +layout_mode = 2 +theme_override_constants/separation = 4 + +[node name="ConflictManagerHint" type="Label" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/ConflictsTab"] +layout_mode = 2 +theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) +theme_override_font_sizes/font_size = 14 +text = "Alte sichtbare Kopien wie „Kür (Server …).json“ werden gesucht und nach Bestätigung ins Konfliktarchiv verschoben. Kopien ohne Hauptdatei bleiben als mögliche letzte Fassung erhalten." +autowrap_mode = 2 + +[node name="ManagerConflictActions" type="HBoxContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/ConflictsTab"] +layout_mode = 2 +theme_override_constants/separation = 4 + +[node name="ManagerScanConflictsButton" type="Button" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/ConflictsTab/ManagerConflictActions"] +unique_name_in_owner = true +custom_minimum_size = Vector2(0, 48) +layout_mode = 2 +size_flags_horizontal = 3 +text = "Konfliktkopien suchen…" + +[node name="ManagerOpenArchiveButton" type="Button" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/ConflictsTab/ManagerConflictActions"] +unique_name_in_owner = true +custom_minimum_size = Vector2(0, 48) +layout_mode = 2 +size_flags_horizontal = 3 +text = "Konfliktarchiv öffnen" diff --git a/rinkplanner/scenes/whiteboard/whiteboard.tscn b/rinkplanner/scenes/whiteboard/whiteboard.tscn index 8407845..130ee74 100644 --- a/rinkplanner/scenes/whiteboard/whiteboard.tscn +++ b/rinkplanner/scenes/whiteboard/whiteboard.tscn @@ -1,4 +1,4 @@ -[gd_scene load_steps=25 format=3] +[gd_scene load_steps=26 format=3] [ext_resource type="Script" path="res://src/whiteboard/ctrl/whiteboard_controller.gd" id="1_controller"] [ext_resource type="Script" path="res://src/whiteboard/view/rink_canvas.gd" id="2_canvas"] @@ -6,6 +6,7 @@ [ext_resource type="Script" path="res://src/whiteboard/view/export_panel.gd" id="3_export_panel"] [ext_resource type="Script" path="res://src/whiteboard/view/playback_panel.gd" id="3_playback_panel"] [ext_resource type="PackedScene" path="res://scenes/export/export_panel.tscn" id="14_export_panel_scene"] +[ext_resource type="PackedScene" path="res://scenes/routine/routine_manager_panel.tscn" id="15_manager_panel_scene"] [ext_resource type="Texture2D" path="res://assets/icons/tools/select.svg" id="4_tool_select"] [ext_resource type="Texture2D" path="res://assets/icons/tools/line.svg" id="5_tool_line"] [ext_resource type="Texture2D" path="res://assets/icons/tools/arc_left.svg" id="6_tool_arc_left"] @@ -1296,75 +1297,8 @@ layout_mode = 2 size_flags_horizontal = 3 theme_override_constants/separation = 4 -[node name="RoutineManagerDialog" type="AcceptDialog" parent="."] +[node name="RoutineManagerPanel" parent="." instance=ExtResource("15_manager_panel_scene")] unique_name_in_owner = true -title = "Küren verwalten" -size = Vector2i(800, 600) -exclusive = false -ok_button_text = "Schließen" - -[node name="ManagerBox" type="VBoxContainer" parent="RoutineManagerDialog"] -offset_left = 12.0 -offset_top = 12.0 -offset_right = 788.0 -offset_bottom = 530.0 -theme_override_constants/separation = 4 - -[node name="ManagerHint" type="Label" parent="RoutineManagerDialog/ManagerBox"] -layout_mode = 2 -theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) -theme_override_font_sizes/font_size = 14 -text = "Lokale Küren löschen oder alte Konfliktkopien aufräumen. Echte Sync-Konflikte löst die App automatisch nach dem neuesten Speicherstand auf." -autowrap_mode = 2 - -[node name="ManagerTabs" type="TabContainer" parent="RoutineManagerDialog/ManagerBox"] -unique_name_in_owner = true -layout_mode = 2 -size_flags_vertical = 3 - -[node name="RoutinesTab" type="VBoxContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs"] -layout_mode = 2 -theme_override_constants/separation = 4 - -[node name="RoutineManagerScroll" type="ScrollContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/RoutinesTab"] -layout_mode = 2 -size_flags_vertical = 3 -horizontal_scroll_mode = 0 - -[node name="RoutineManagerList" type="VBoxContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/RoutinesTab/RoutineManagerScroll"] -unique_name_in_owner = true -layout_mode = 2 -size_flags_horizontal = 3 -theme_override_constants/separation = 4 - -[node name="ConflictsTab" type="VBoxContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs"] -layout_mode = 2 -theme_override_constants/separation = 4 - -[node name="ConflictManagerHint" type="Label" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/ConflictsTab"] -layout_mode = 2 -theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) -theme_override_font_sizes/font_size = 14 -text = "Alte sichtbare Kopien wie „Kür (Server …).json“ werden gesucht und nach Bestätigung ins Konfliktarchiv verschoben. Kopien ohne Hauptdatei bleiben als mögliche letzte Fassung erhalten." -autowrap_mode = 2 - -[node name="ManagerConflictActions" type="HBoxContainer" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/ConflictsTab"] -layout_mode = 2 -theme_override_constants/separation = 4 - -[node name="ManagerScanConflictsButton" type="Button" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/ConflictsTab/ManagerConflictActions"] -unique_name_in_owner = true -custom_minimum_size = Vector2(0, 48) -layout_mode = 2 -size_flags_horizontal = 3 -text = "Konfliktkopien suchen…" - -[node name="ManagerOpenArchiveButton" type="Button" parent="RoutineManagerDialog/ManagerBox/ManagerTabs/ConflictsTab/ManagerConflictActions"] -unique_name_in_owner = true -custom_minimum_size = Vector2(0, 48) -layout_mode = 2 -size_flags_horizontal = 3 -text = "Konfliktarchiv öffnen" [node name="DeleteRoutineDialog" type="ConfirmationDialog" parent="."] unique_name_in_owner = true diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 298e40b..0f11611 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -287,11 +287,7 @@ const UPDATE_FILE_NAMES := { @onready var cleanup_conflicts_dialog: ConfirmationDialog = %CleanupConflictsDialog @onready var cleanup_conflicts_intro: Label = %CleanupConflictsIntro @onready var cleanup_conflicts_list: VBoxContainer = %CleanupConflictsList -@onready var routine_manager_dialog: AcceptDialog = %RoutineManagerDialog -@onready var manager_tabs: TabContainer = %ManagerTabs -@onready var routine_manager_list: VBoxContainer = %RoutineManagerList -@onready var manager_scan_conflicts_button: Button = %ManagerScanConflictsButton -@onready var manager_open_archive_button: Button = %ManagerOpenArchiveButton +@onready var routine_manager_panel: RoutineManagerPanel = %RoutineManagerPanel @onready var delete_routine_dialog: ConfirmationDialog = %DeleteRoutineDialog @onready var delete_routine_text: Label = %DeleteRoutineText @onready var delete_routine_cloud_check: CheckBox = %DeleteRoutineCloudCheck @@ -516,8 +512,11 @@ func _ready() -> void: sync_provider_option.item_selected.connect(_on_sync_provider_selected) sync_connect_button.pressed.connect(_on_sync_connect_pressed) cleanup_conflicts_dialog.confirmed.connect(_on_cleanup_conflicts_confirmed) - manager_scan_conflicts_button.pressed.connect(_start_conflict_scan) - manager_open_archive_button.pressed.connect(_open_conflicts_folder) + routine_manager_panel.open_requested.connect(_on_manager_open_pressed) + routine_manager_panel.rename_requested.connect(_open_rename_routine_dialog) + routine_manager_panel.delete_requested.connect(_open_delete_routine_dialog) + routine_manager_panel.scan_conflicts_requested.connect(_start_conflict_scan) + routine_manager_panel.open_archive_requested.connect(_open_conflicts_folder) delete_routine_dialog.confirmed.connect(_on_delete_routine_confirmed) delete_routine_dialog.canceled.connect(_on_delete_routine_canceled) rename_routine_dialog.confirmed.connect(_on_rename_routine_confirmed) @@ -6368,7 +6367,7 @@ func _apply_hub_download(overwrite: bool) -> void: _discard_hub_download(pending) hub_status_label.text = "Vom Hub geladen: " + target_routine _refresh_open_list() - if routine_manager_dialog.visible: + if routine_manager_panel.is_open(): _refresh_routine_manager() _show_message( "Kür vom Hub geladen:\n\n%s\n\n" @@ -7111,51 +7110,18 @@ func _open_open_dialog() -> void: func _open_routine_manager() -> void: - manager_tabs.set_tab_title(0, "Küren") - manager_tabs.set_tab_title(1, "Konfliktkopien") - _refresh_routine_manager() - routine_manager_dialog.popup_centered(Vector2i(800, 600)) + routine_manager_panel.open_for( + _routine_entries(), + Vector2i(800, 600) + ) func _refresh_routine_manager() -> void: - for child: Node in routine_manager_list.get_children(): - child.free() - var entries := _routine_entries() - for file: String in entries: - var row := HBoxContainer.new() - row.add_theme_constant_override("separation", 8) - var open_button := Button.new() - open_button.text = file.get_basename() - open_button.custom_minimum_size = Vector2(0.0, 48.0) - open_button.size_flags_horizontal = Control.SIZE_EXPAND_FILL - open_button.alignment = HORIZONTAL_ALIGNMENT_LEFT - open_button.clip_text = true - open_button.pressed.connect( - _on_manager_open_pressed.bind(ROUTINES_DIR.path_join(file)) - ) - row.add_child(open_button) - var rename_button := Button.new() - rename_button.text = "Umbenennen" - rename_button.custom_minimum_size = Vector2(132.0, 48.0) - rename_button.pressed.connect( - _open_rename_routine_dialog.bind(file) - ) - row.add_child(rename_button) - var delete_button := Button.new() - delete_button.text = "Löschen" - delete_button.custom_minimum_size = Vector2(110.0, 48.0) - delete_button.pressed.connect(_open_delete_routine_dialog.bind(file)) - row.add_child(delete_button) - routine_manager_list.add_child(row) - - if entries.is_empty(): - var label := Label.new() - label.text = "Keine gespeicherten Kürläufe" - routine_manager_list.add_child(label) + routine_manager_panel.refresh(_routine_entries()) func _on_manager_open_pressed(path: String) -> void: - routine_manager_dialog.hide() + routine_manager_panel.close() _on_open_file_pressed(path) diff --git a/rinkplanner/src/whiteboard/view/routine_manager_panel.gd b/rinkplanner/src/whiteboard/view/routine_manager_panel.gd new file mode 100644 index 0000000..970b487 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/routine_manager_panel.gd @@ -0,0 +1,82 @@ +class_name RoutineManagerPanel +extends Node + +## The "Küren verwalten" dialog: one row per routine plus the conflict tools. +## +## The panel renders rows and reports what the user picked. Opening, renaming, +## deleting and the conflict scan stay with the controller, because they touch +## files, the current routine and the sync state. + +signal open_requested(file_name: String) +signal rename_requested(file_name: String) +signal delete_requested(file_name: String) +signal scan_conflicts_requested +signal open_archive_requested + +@onready var dialog: AcceptDialog = %RoutineManagerDialog +@onready var list: VBoxContainer = %RoutineManagerList +@onready var scan_button: Button = %ManagerScanConflictsButton +@onready var archive_button: Button = %ManagerOpenArchiveButton + + +func _ready() -> void: + scan_button.pressed.connect(func() -> void: scan_conflicts_requested.emit()) + archive_button.pressed.connect(func() -> void: open_archive_requested.emit()) + + +## Shows the dialog for [param entries] (file names, one per routine). +func open_for(entries: Array[String], size: Vector2i) -> void: + refresh(entries) + dialog.popup_centered(size) + dialog.size = size + + +## Rebuilds the row list. Safe to call while the dialog is open. +func refresh(entries: Array[String]) -> void: + for child: Node in list.get_children(): + list.remove_child(child) + child.free() + + for file: String in entries: + list.add_child(_build_row(file)) + + if entries.is_empty(): + var label := Label.new() + label.text = "Keine gespeicherten Kürläufe" + list.add_child(label) + + +func is_open() -> bool: + return dialog.visible + + +func close() -> void: + dialog.hide() + + +func _build_row(file: String) -> HBoxContainer: + var row := HBoxContainer.new() + row.add_theme_constant_override("separation", 8) + + var open_button := Button.new() + open_button.text = file.get_basename() + open_button.custom_minimum_size = Vector2(0.0, 48.0) + open_button.size_flags_horizontal = Control.SIZE_EXPAND_FILL + open_button.alignment = HORIZONTAL_ALIGNMENT_LEFT + open_button.clip_text = true + open_button.pressed.connect(func() -> void: open_requested.emit(file)) + row.add_child(open_button) + + var rename_button := Button.new() + rename_button.text = "Umbenennen" + rename_button.custom_minimum_size = Vector2(132.0, 48.0) + rename_button.pressed.connect(func() -> void: rename_requested.emit(file)) + row.add_child(rename_button) + + var delete_button := Button.new() + delete_button.text = "Löschen" + delete_button.custom_minimum_size = Vector2(110.0, 48.0) + delete_button.pressed.connect(func() -> void: delete_requested.emit(file)) + row.add_child(delete_button) + + return row diff --git a/rinkplanner/src/whiteboard/view/routine_manager_panel.gd.uid b/rinkplanner/src/whiteboard/view/routine_manager_panel.gd.uid new file mode 100644 index 0000000..2dd11d5 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/routine_manager_panel.gd.uid @@ -0,0 +1 @@ +uid://bu40o821wuiet diff --git a/rinkplanner/tests/run_routine_manager_panel_tests.gd b/rinkplanner/tests/run_routine_manager_panel_tests.gd new file mode 100644 index 0000000..cf427bc --- /dev/null +++ b/rinkplanner/tests/run_routine_manager_panel_tests.gd @@ -0,0 +1,86 @@ +extends SceneTree + +## Headless test for `RoutineManagerPanel` on its own: rows and signals, no +## WhiteboardController and no routine files. +## +## Run with: +## godot --headless --path rinkplanner --script res://tests/run_routine_manager_panel_tests.gd + +const PanelScene := preload("res://scenes/routine/routine_manager_panel.tscn") + +var _assertions: int = 0 +var _failures: PackedStringArray = PackedStringArray() + + +func _init() -> void: + _run.call_deferred() + + +func _run() -> void: + var panel := PanelScene.instantiate() as RoutineManagerPanel + _check(panel != null, "the panel scene carries its script") + if panel == null: + _finish() + return + root.size = Vector2i(1280, 800) + root.add_child(panel) + await process_frame + + _check(not panel.is_open(), "the dialog starts closed") + + var opened: Array = [] + var renamed: Array = [] + var deleted: Array = [] + panel.open_requested.connect(func(name: String) -> void: opened.append(name)) + panel.rename_requested.connect(func(name: String) -> void: renamed.append(name)) + panel.delete_requested.connect(func(name: String) -> void: deleted.append(name)) + + panel.open_for(["b.json", "a.json"], Vector2i(800, 600)) + _check(panel.is_open(), "the dialog opens") + _check(panel.list.get_child_count() == 2, "one row per routine") + + var first_row := panel.list.get_child(0) as HBoxContainer + _check(first_row != null and first_row.get_child_count() == 3, "a row has open, rename and delete") + if first_row != null and first_row.get_child_count() == 3: + var open_button := first_row.get_child(0) as Button + _check(open_button.text == "b", "the row shows the name without extension") + open_button.pressed.emit() + (first_row.get_child(1) as Button).pressed.emit() + (first_row.get_child(2) as Button).pressed.emit() + _check(opened == ["b.json"], "the open signal carries the file") + _check(renamed == ["b.json"], "the rename signal carries the file") + _check(deleted == ["b.json"], "the delete signal carries the file") + + panel.refresh(["c.json"]) + _check(panel.list.get_child_count() == 1, "refreshing replaces the rows") + + panel.refresh([]) + _check(panel.list.get_child_count() == 1, "an empty list shows one hint") + _check( + (panel.list.get_child(0) as Label).text.contains("Keine"), + "the hint says that no routines are stored" + ) + + panel.close() + _check(not panel.is_open(), "the dialog closes") + + panel.queue_free() + await process_frame + _finish() + + +func _check(condition: bool, message: String) -> void: + _assertions += 1 + if not condition: + _failures.append(message) + + +func _finish() -> void: + if _failures.is_empty(): + print("PASS: %d assertions" % _assertions) + quit(0) + return + for failure: String in _failures: + printerr("FAIL: %s" % failure) + printerr("%d of %d assertions failed" % [_failures.size(), _assertions]) + quit(1) diff --git a/rinkplanner/tests/run_routine_manager_panel_tests.gd.uid b/rinkplanner/tests/run_routine_manager_panel_tests.gd.uid new file mode 100644 index 0000000..b88876a --- /dev/null +++ b/rinkplanner/tests/run_routine_manager_panel_tests.gd.uid @@ -0,0 +1 @@ +uid://bkwa2hkn4gob7 diff --git a/rinkplanner/tests/run_sync_tests.gd b/rinkplanner/tests/run_sync_tests.gd index e87ab71..81636d7 100644 --- a/rinkplanner/tests/run_sync_tests.gd +++ b/rinkplanner/tests/run_sync_tests.gd @@ -784,7 +784,7 @@ func _test_controller_wiring() -> void: manager_item = index _check(manager_item >= 0, "das Dateimenü bietet die Kürenverwaltung an") _check( - controller.routine_manager_dialog != null + controller.routine_manager_panel.dialog != null and controller.delete_routine_dialog != null, "Verwaltungs- und Löschdialog sind in der Szene verdrahtet" ) @@ -892,13 +892,13 @@ func _test_controller_wiring() -> void: ) ) controller._refresh_routine_manager() - controller.routine_manager_dialog.show() + controller.routine_manager_panel.dialog.show() _check( - controller.routine_manager_dialog.visible, + controller.routine_manager_panel.dialog.visible, "der Verwaltungsdialog lässt sich öffnen" ) var manager_row: HBoxContainer = null - for child: Node in controller.routine_manager_list.get_children(): + for child: Node in controller.routine_manager_panel.list.get_children(): if child is HBoxContainer: var open_button := child.get_child(0) as Button if open_button != null and open_button.text == "sync-test-manager": @@ -995,7 +995,7 @@ func _test_controller_wiring() -> void: ) ) controller._refresh_routine_manager() - controller.routine_manager_dialog.hide() + controller.routine_manager_panel.dialog.hide() controller.sync_settings_dialog.hide() # Ohne Refresh-Token öffnet "Jetzt synchronisieren" die Einstellungen. diff --git a/tools/test.sh b/tools/test.sh index 422cde7..f279d7e 100755 --- a/tools/test.sh +++ b/tools/test.sh @@ -69,6 +69,9 @@ fi "$GODOT" --headless --path "$PROJECT_DIR" \ --script res://tests/run_export_panel_tests.gd +"$GODOT" --headless --path "$PROJECT_DIR" \ + --script res://tests/run_routine_manager_panel_tests.gd + "$GODOT" --headless --path "$PROJECT_DIR" \ --script res://tests/run_export_tests.gd From 23543a00185d473eaa8b952d54d9f3edbb9edc16 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:19:15 +0100 Subject: [PATCH 20/28] =?UTF-8?q?docs:=20GOE=20bewusst=20ausschlie=C3=9Fen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GOE vergibt der Richter nach der Ausführung (−5 bis +5, Kriterien wie Höhe, Fluss, Landung). Es ist aus einem Plan nicht ableitbar; eine berechnete Zahl würde eine Genauigkeit vortäuschen, die die App nicht hat. - Roadmap: GOE von "Optional" nach "Bewusst nicht" mit Begründung. - `docs/isu-rules.md`: gleiche Einordnung bei den nächsten Ausbaustufen. - Die `V`-/Unterrotationsvarianten bleiben optional, jetzt ausdrücklich als Was-wäre-wenn — ihr Basiswert-Effekt ist deterministisch, die Eingabe bleibt eine Annahme. --- docs/isu-rules.md | 8 ++++++-- docs/roadmap.md | 13 ++++++++++--- 2 files changed, 16 insertions(+), 5 deletions(-) diff --git a/docs/isu-rules.md b/docs/isu-rules.md index 2be46e7..a180e54 100644 --- a/docs/isu-rules.md +++ b/docs/isu-rules.md @@ -310,6 +310,10 @@ Export-Presets mit ausgeliefert. ## Nächste Ausbaustufen -- Max. zwei Features pro Fuß und Feature-Positionsregeln -- GOE-Tabellen und `V`-/Unterrotations-Varianten +- `V`-/Unterrotations-Varianten als Was-wäre-wenn (der Basiswert-Effekt ist + deterministisch, die Eingabe bleibt eine Annahme) - Vorschlagsliste im Inspector direkt aus `suggest()` + +**Bewusst nicht:** GOE-Tabellen. GOE ist Richterermessen über die Ausführung +(−5 bis +5) und aus dem Plan nicht ableitbar; die Punktschätzung nennt die +Lücke statt sie zu füllen. diff --git a/docs/roadmap.md b/docs/roadmap.md index 46fa4ea..b486215 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -193,8 +193,8 @@ OAuth-App ist nicht veröffentlicht. Google Drive und OneDrive stehen unter - [x] PCS und Sturzabzüge in der Punktschätzung (mit Annahmen) - [x] In-App-Hilfe „Hilfe & Annahmen“ und `docs/manual.md` - [ ] Optional: Suchfeld/Autovervollständigung aus `suggest()` -- [ ] Optional: GOE-Tabellen sowie `V`-/Unterrotationsvarianten - (2026-11-01 vorerst zurückgestellt) +- [ ] Optional: `V`-/Unterrotationsvarianten als Was-wäre-wenn + (Basiswert-Effekt ist deterministisch; Eingabe bleibt eine Annahme) ### Danach: Weitere fachliche Erweiterungen @@ -222,7 +222,8 @@ Level-Features, Elementvalidierung, Adult-Kategorien, Dauer und Wiederholungs-/Kombinationsgrenzen stehen; als Nächstes folgt die Mehrsaison-Struktur (Regelpaket pro Saison, alte Küren bleiben gegen ihre eigene Saison prüfbar) samt Saison-Upgrade-Prüfung, danach Feature-Grenzen pro -Fuß. GOE und Varianten sind vorerst zurückgestellt. Sync-Komfort und +Fuß. GOE ist bewusst ausgeschlossen (Richterermessen), die `V`-Varianten sind +zurückgestellt. Sync-Komfort und UI-Refactoring sind zurückgestellt, weil der bestehende Stand für Tests genügt und die endgültige Sync-Architektur (PHP-Webserver) sowie das UI-Feedback der Tester ohnehin noch ausstehen. @@ -350,6 +351,12 @@ Schritte. - Google Drive und OneDrive (aktuell reicht Dropbox; siehe „Später: Weitere Cloud-Anbieter“) - 3D-Produktionsreife +- **GOE-Tabellen.** GOE vergibt der Richter nach der Ausführung (−5 bis +5, + Kriterien wie Höhe, Fluss, Landung). Es ist aus einem Plan nicht ableitbar; + die App würde eine Zahl vortäuschen, die sie nicht kennt. Die + Punktschätzung bleibt deshalb bei Basiswert + PCS-Annahme − Sturzabzug und + benennt die Lücke (`docs/manual.md`). Auch die Maximalwerte je Elementtyp + als Bandbreite wären faktisch korrekt, aber für die Planung nutzlos. ### Weitere Disziplinen From d2207bd83ef3044ed8c1d61493e22ff659bc4698 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:19:21 +0100 Subject: [PATCH 21/28] docs: Reihenfolge-Absatz auf den aktuellen Stand bringen --- docs/roadmap.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/docs/roadmap.md b/docs/roadmap.md index b486215..36b560f 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -217,16 +217,15 @@ fachlichen Validierung angefasst. Übernahme des Feedbacks der Tester Die Reihenfolge ist bewusst: native Builds, Datenaustausch und Element-Marker -sind erledigt. Im PoC läuft jetzt das ISU-Regelwerk – Katalog 2026/27, +sind erledigt. Im PoC läuft das ISU-Regelwerk – Katalog 2026/27, Level-Features, Elementvalidierung, Adult-Kategorien, Dauer und -Wiederholungs-/Kombinationsgrenzen stehen; als Nächstes folgt die -Mehrsaison-Struktur (Regelpaket pro Saison, alte Küren bleiben gegen ihre -eigene Saison prüfbar) samt Saison-Upgrade-Prüfung, danach Feature-Grenzen pro -Fuß. GOE ist bewusst ausgeschlossen (Richterermessen), die `V`-Varianten sind -zurückgestellt. Sync-Komfort und -UI-Refactoring sind zurückgestellt, weil der bestehende Stand für Tests -genügt und die endgültige Sync-Architektur (PHP-Webserver) sowie das -UI-Feedback der Tester ohnehin noch ausstehen. +Wiederholungs-/Kombinationsgrenzen stehen, ebenso die Mehrsaison-Struktur +(Regelpaket pro Saison, alte Küren bleiben gegen ihre eigene Saison prüfbar) +mit Saison-Upgrade-Prüfung und die Feature-Grenzen pro Fuß. GOE ist bewusst +ausgeschlossen (Richterermessen), die `V`-Varianten sind zurückgestellt. +Sync-Komfort und UI-Refactoring sind zurückgestellt, weil der bestehende +Stand für Tests genügt und die endgültige Sync-Architektur (PHP-Webserver) +sowie das UI-Feedback der Tester ohnehin noch ausstehen. ### Später: Weitere Cloud-Anbieter From 588cc6ca853bed631adecb9d0243791dc54d1d3a Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:25:48 +0100 Subject: [PATCH 22/28] chore: Version 0.4.0 vorbereiten (Android-Testbuild) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Version an allen Stellen auf 0.4.0 erhöht, Android-versionCode auf 6. Damit unterscheidet sich der Testbuild auf dem Tablet eindeutig von der veröffentlichten 0.3.0, die noch ohne Saisons, Artistic und Feature-Grenzen ist. Veröffentlicht ist weiterhin 0.3.0. --- rinkplanner/export_presets.cfg | 12 ++++++------ rinkplanner/project.godot | 2 +- tools/export_windows_installer.sh | 2 +- tools/windows_installer.nsi | 2 +- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/rinkplanner/export_presets.cfg b/rinkplanner/export_presets.cfg index f09f2bd..59d0b2d 100644 --- a/rinkplanner/export_presets.cfg +++ b/rinkplanner/export_presets.cfg @@ -66,8 +66,8 @@ application/modify_resources=true application/icon="res://assets/icons/app_icon.png" application/console_wrapper_icon="" application/icon_interpolation=4 -application/file_version="0.3.0.0" -application/product_version="0.3.0.0" +application/file_version="0.4.0.0" +application/product_version="0.4.0.0" application/company_name="" application/product_name="Rinkplanner" application/file_description="2D-Whiteboard für Eiskunstlauf" @@ -118,8 +118,8 @@ application/icon_interpolation=4 application/bundle_identifier="de.rinkplanner.app" application/signature="" application/app_category="Education" -application/short_version="0.3.0" -application/version="0.3.0" +application/short_version="0.4.0" +application/version="0.4.0" application/copyright="" application/copyright_localized={} application/min_macos_version_x86_64="11.00" @@ -243,8 +243,8 @@ keystore/debug_password="" keystore/release="" keystore/release_user="" keystore/release_password="" -version/code=5 -version/name="0.3.0" +version/code=6 +version/name="0.4.0" package/unique_name="de.rinkplanner.app" package/name="Rinkplanner" package/signed=true diff --git a/rinkplanner/project.godot b/rinkplanner/project.godot index 7520cf5..ae82ee1 100644 --- a/rinkplanner/project.godot +++ b/rinkplanner/project.godot @@ -15,7 +15,7 @@ compatibility/default_parent_skeleton_in_mesh_instance_3d=true [application] config/name="Rinkplanner" -config/version="0.3.0" +config/version="0.4.0" run/main_scene="res://scenes/whiteboard/whiteboard.tscn" config/features=PackedStringArray("4.7", "Forward Plus") config/icon="res://assets/icons/app_icon.png" diff --git a/tools/export_windows_installer.sh b/tools/export_windows_installer.sh index caed987..ce84087 100755 --- a/tools/export_windows_installer.sh +++ b/tools/export_windows_installer.sh @@ -43,7 +43,7 @@ VERSION="$( sed -n 's/^[[:space:]]*application\/product_version="\([^"]*\)"/\1/p' \ "$PROJECT_DIR/export_presets.cfg" | head -1 )" -VERSION="${VERSION:-0.3.0.0}" +VERSION="${VERSION:-0.4.0.0}" if [[ "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then VERSION="$VERSION.0" fi diff --git a/tools/windows_installer.nsi b/tools/windows_installer.nsi index 293e965..fd0ffcc 100644 --- a/tools/windows_installer.nsi +++ b/tools/windows_installer.nsi @@ -7,7 +7,7 @@ ; -DICON_FILE=/pfad/zu/rinkplanner.ico !ifndef APP_VERSION - !define APP_VERSION "0.3.0.0" + !define APP_VERSION "0.4.0.0" !endif !ifndef SOURCE_EXE !error "SOURCE_EXE fehlt (Pfad zur rinkplanner.exe)." From cb080cb6fb3421d3bd9efcaa76f242e8e3cdb7a8 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:28:32 +0100 Subject: [PATCH 23/28] feat: Rinkplanner-Splash statt Godot-Logo MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Der Startbildschirm zeigt statt des Godot-Logos die Läufer-Silhouette auf dem Hintergrund der App (#0b1220). - `assets/icons/boot_splash.png` (1024×1024) neu erzeugt aus dem App-Icon: Figur weiß, Hintergrund wie die Oberfläche, dadurch nahtlos auf jedem Bildschirm. - `project.godot`: `boot_splash/image`, `bg_color`, `show_image`, `fullsize=false`, `minimum_display_time=0`. Gilt für alle Exporte; Android neu gebaut und auf dem Tablet geprüft. --- rinkplanner/assets/icons/boot_splash.png | Bin 0 -> 34419 bytes .../assets/icons/boot_splash.png.import | 40 ++++++++++++++++++ rinkplanner/project.godot | 5 +++ 3 files changed, 45 insertions(+) create mode 100644 rinkplanner/assets/icons/boot_splash.png create mode 100644 rinkplanner/assets/icons/boot_splash.png.import diff --git a/rinkplanner/assets/icons/boot_splash.png b/rinkplanner/assets/icons/boot_splash.png new file mode 100644 index 0000000000000000000000000000000000000000..8424a34d7abeb0c947c5ef8d6ea346276e8885e0 GIT binary patch literal 34419 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
Uv!exh2$C+ACCDibCs5g_k^;kqMK0% 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 literal 0 HcmV?d00001 diff --git a/rinkplanner/assets/icons/boot_splash.png.import b/rinkplanner/assets/icons/boot_splash.png.import new file mode 100644 index 0000000..5301610 --- /dev/null +++ b/rinkplanner/assets/icons/boot_splash.png.import @@ -0,0 +1,40 @@ +[remap] + +importer="texture" +type="CompressedTexture2D" +uid="uid://f72ldr1lvtq3" +path="res://.godot/imported/boot_splash.png-c2760ae15293ca9a9d17190592935c1e.ctex" +metadata={ +"vram_texture": false +} + +[deps] + +source_file="res://assets/icons/boot_splash.png" +dest_files=["res://.godot/imported/boot_splash.png-c2760ae15293ca9a9d17190592935c1e.ctex"] + +[params] + +compress/mode=0 +compress/high_quality=false +compress/lossy_quality=0.7 +compress/uastc_level=0 +compress/rdo_quality_loss=0.0 +compress/hdr_compression=1 +compress/normal_map=0 +compress/channel_pack=0 +mipmaps/generate=false +mipmaps/limit=-1 +roughness/mode=0 +roughness/src_normal="" +process/channel_remap/red=0 +process/channel_remap/green=1 +process/channel_remap/blue=2 +process/channel_remap/alpha=3 +process/fix_alpha_border=true +process/premult_alpha=false +process/normal_map_invert_y=false +process/hdr_as_srgb=false +process/hdr_clamp_exposure=false +process/size_limit=0 +detect_3d/compress_to=1 diff --git a/rinkplanner/project.godot b/rinkplanner/project.godot index ae82ee1..ea490dd 100644 --- a/rinkplanner/project.godot +++ b/rinkplanner/project.godot @@ -19,6 +19,11 @@ config/version="0.4.0" run/main_scene="res://scenes/whiteboard/whiteboard.tscn" config/features=PackedStringArray("4.7", "Forward Plus") config/icon="res://assets/icons/app_icon.png" +boot_splash/image="res://assets/icons/boot_splash.png" +boot_splash/bg_color=Color(0.043137, 0.070588, 0.12549, 1) +boot_splash/show_image=true +boot_splash/fullsize=false +boot_splash/minimum_display_time=0 [autoload] From 72048aa8f04e447cb893e6cc253c2843ed3230f1 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:33:25 +0100 Subject: [PATCH 24/28] fix: Statusleiste passt auf schmale Tablet-Breiten MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Auf dem Galaxy Tab S9+ (2800x1752 px, DPR 2) ist die logische Breite 1400 Punkte. Die Statusleiste verlangte 1573 Punkte Minimum: Der Text des Status-Labels konnte nicht schrumpfen, also wuchs die gesamte Leiste über den Bildschirm und wurde links und rechts abgeschnitten. - `StatusLabel` darf jetzt kürzen (`clip_text`), statt die Breite vorzugeben; die Leiste kommt damit auf 836 Punkte. - Feste Breiten der drei Auswahlfelder und des Prüf-Knopfs leicht reduziert (Saison 158, Programm 104, Kategorie 146, Prüfen 104). - `_apply_display_scale` stößt nach dem Setzen des Skalierungsfaktors einen verzögerten Layoutdurchlauf an: Die Viewport-Größe ändert sich erst im nächsten Frame, sonst entscheidet das kompakte Layout über die Pixelbreite. Geprüft auf dem Tablet: obere Leiste und Statusleiste vollständig sichtbar (obere Leiste 1391 von 1400 Punkten). Hochformat bleibt offen: Bei 876 Punkten Breite reicht die obere Leiste weiterhin nicht — das ist der Roadmap-Punkt "obere Leiste umbruchfähig". --- rinkplanner/scenes/whiteboard/whiteboard.tscn | 9 +++++---- rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd | 4 ++++ 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/rinkplanner/scenes/whiteboard/whiteboard.tscn b/rinkplanner/scenes/whiteboard/whiteboard.tscn index 130ee74..2aa0d66 100644 --- a/rinkplanner/scenes/whiteboard/whiteboard.tscn +++ b/rinkplanner/scenes/whiteboard/whiteboard.tscn @@ -769,6 +769,7 @@ theme_override_constants/separation = 6 unique_name_in_owner = true layout_mode = 2 size_flags_horizontal = 3 +clip_text = true theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1) theme_override_font_sizes/font_size = 15 text = "Abschnitt 1 · 0 Segmente" @@ -784,25 +785,25 @@ tooltip_text = "Hilfe und Annahmen" [node name="SeasonOption" type="OptionButton" parent="Layout/StatusBar/StatusBarContent"] unique_name_in_owner = true -custom_minimum_size = Vector2(190, 48) +custom_minimum_size = Vector2(158, 48) layout_mode = 2 theme_override_font_sizes/font_size = 15 [node name="ProgramOption" type="OptionButton" parent="Layout/StatusBar/StatusBarContent"] unique_name_in_owner = true -custom_minimum_size = Vector2(120, 48) +custom_minimum_size = Vector2(104, 48) layout_mode = 2 theme_override_font_sizes/font_size = 15 [node name="AdultCategoryOption" type="OptionButton" parent="Layout/StatusBar/StatusBarContent"] unique_name_in_owner = true -custom_minimum_size = Vector2(170, 48) +custom_minimum_size = Vector2(146, 48) layout_mode = 2 theme_override_font_sizes/font_size = 15 [node name="ValidationButton" type="Button" parent="Layout/StatusBar/StatusBarContent"] unique_name_in_owner = true -custom_minimum_size = Vector2(120, 48) +custom_minimum_size = Vector2(104, 48) layout_mode = 2 theme_override_font_sizes/font_size = 15 text = "Prüfen" diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 0f11611..0253195 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -5574,6 +5574,10 @@ func _apply_display_scale() -> void: var factor := maxf(1.0, DisplayServer.screen_get_scale()) if not is_equal_approx(window.content_scale_factor, factor): window.content_scale_factor = factor + # The viewport size changes with the scale factor, but only after the + # next frame. Without the deferred pass the compact layout would be + # decided from the pixel width and the bars would overflow on tablets. + _apply_responsive_layout.call_deferred() func _apply_responsive_layout() -> void: From f667633d07b93e934208f3c52adc525683de6029 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:36:37 +0100 Subject: [PATCH 25/28] =?UTF-8?q?docs:=20Hochformat=20bewusst=20ausschlie?= =?UTF-8?q?=C3=9Fen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Die Eisfläche ist Querformat, und das Tablet wird intuitiv so gehalten. Eine Hochformat-Fassung würde Leisten umbrechen oder Werkzeuge verstecken, ohne dem Planen zu helfen. - Roadmap: Hochformat/DeX von "geplant" nach "Bewusst nicht jetzt", mit Begründung und Datum. - `project.godot`: `window/handheld/orientation=0` explizit gesetzt, damit die Absicht im Repo sichtbar ist (bisher war es nur der Standard). Der Querformat-Fall auf schmalen Tablet-Breiten bleibt der Maßstab; die Leisten passen dort seit 72048aa. --- docs/roadmap.md | 8 ++++++-- rinkplanner/project.godot | 3 +++ 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/roadmap.md b/docs/roadmap.md index 36b560f..1c3c2e6 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -87,7 +87,6 @@ Voraussetzung für Phase 1. - [x] Windows-EXE mit Icon und Versionsinformationen (rcedit über portables Wine, `tools/setup_windows_export.sh`) - [ ] Release-Keystore für ein verteilbares APK -- [ ] Hochformat-, Multi-Window- und DeX-Layout (obere Leiste umbruchfähig) ### Erledigt: Touch-/Tablet-Härtung @@ -212,7 +211,6 @@ fachlichen Validierung angefasst. - [ ] Manuelles Zusammenführen mit der archivierten Fassung - [x] Löschweitergabe für einzelne Küren mit Bestätigung (Küren verwalten) - [ ] Optional: Sync-Ordner pro Anbieter getrennt konfigurieren -- [ ] Hochformat-, Multi-Window- und DeX-Layout (obere Leiste umbruchfähig) - [ ] Visuelles UI-Refactoring (z. B. Buttons statt Comboboxen) inklusive Übernahme des Feedbacks der Tester @@ -343,6 +341,12 @@ Schritte. ## Bewusst nicht jetzt +- **Hochformat und DeX-Layout.** Die Eisfläche ist Querformat, und das Tablet + wird intuitiv so gehalten. Eine Hochformat-Fassung würde die Leisten + umbrechen oder Werkzeuge verstecken, ohne dem Planen zu helfen. Entschieden + am 2026-11-13; die Querformat-Leisten müssen nur auf schmalen + Querformat-Breiten passen (erledigt für 1400 logische Punkte). + - Native PDF-Ausgabe mit Bildern/Screenshots (die aktuelle PDF-Ausgabe ist vektorbasiert und enthält keine Fotos) - Vollständiges ISU-Regelwerk vor dem stabilen Planungs-Workflow diff --git a/rinkplanner/project.godot b/rinkplanner/project.godot index ea490dd..049698d 100644 --- a/rinkplanner/project.godot +++ b/rinkplanner/project.godot @@ -31,6 +31,9 @@ GodotAIBridgeRuntime="*res://addons/godot_ai_bridge/runtime_bridge.gd" [display] +; Querformat ist gesetzt: Die Eisfläche ist breiter als hoch, und das Tablet +; wird so gehalten. Eine Hochformat-Fassung ist bewusst nicht geplant. +window/handheld/orientation=0 window/size/viewport_width=1440 window/size/viewport_height=900 window/stretch/aspect="expand" From ed1228190f9abc7a1829441d3fe8dd7cc173341a Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 15:40:30 +0100 Subject: [PATCH 26/28] fix: Werkzeugleiste bricht auf schmalen Tablets um MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Die obere Leiste war 1391 Punkte breit und passte damit nur knapp in die 1400 Punkte des Galaxy Tab S9+. Jetzt liegt die Werkzeuggruppe (Werkzeuge, Vorwärts/Rückwärts, Innen/Außen) in einem HFlowContainer, der bei zu wenig Platz in eine zweite Reihe umbricht. - Minimum der oberen Leiste: 1391 -> 728 Punkte (gemessen headless). - Der bisherige Spacer entfällt; der Flow-Container übernimmt seine Aufgabe und schiebt Rückgängig/Wiederholen/Einpassen/3D weiterhin nach rechts. - Auf dem Tablet unverändert: eine Reihe, gleiche Anordnung (geprüft). Damit sind auch Tablets mit 1000-1300 logischen Punkten bedient. --- rinkplanner/scenes/whiteboard/whiteboard.tscn | 40 ++++++++++--------- 1 file changed, 21 insertions(+), 19 deletions(-) diff --git a/rinkplanner/scenes/whiteboard/whiteboard.tscn b/rinkplanner/scenes/whiteboard/whiteboard.tscn index 2aa0d66..18b0150 100644 --- a/rinkplanner/scenes/whiteboard/whiteboard.tscn +++ b/rinkplanner/scenes/whiteboard/whiteboard.tscn @@ -120,12 +120,18 @@ tooltip_text = "Datei" [node name="TitleSeparator" type="VSeparator" parent="Layout/TopBar/Tools"] layout_mode = 2 -[node name="ToolButtons" type="HBoxContainer" parent="Layout/TopBar/Tools"] +[node name="ToolFlow" type="HFlowContainer" parent="Layout/TopBar/Tools"] +layout_mode = 2 +size_flags_horizontal = 3 +theme_override_constants/h_separation = 6 +theme_override_constants/v_separation = 6 + +[node name="ToolButtons" type="HBoxContainer" parent="Layout/TopBar/Tools/ToolFlow"] unique_name_in_owner = true layout_mode = 2 theme_override_constants/separation = 4 -[node name="SelectToolButton" type="Button" parent="Layout/TopBar/Tools/ToolButtons"] +[node name="SelectToolButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow/ToolButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(44, 48) icon_alignment = 1 @@ -144,7 +150,7 @@ theme_override_styles/pressed = SubResource("StyleBoxFlat_tool_active") theme_override_styles/hover_pressed = SubResource("StyleBoxFlat_tool_active") icon = ExtResource("4_tool_select") -[node name="LineToolButton" type="Button" parent="Layout/TopBar/Tools/ToolButtons"] +[node name="LineToolButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow/ToolButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(44, 48) icon_alignment = 1 @@ -162,7 +168,7 @@ theme_override_styles/pressed = SubResource("StyleBoxFlat_tool_active") theme_override_styles/hover_pressed = SubResource("StyleBoxFlat_tool_active") icon = ExtResource("5_tool_line") -[node name="ArcLeftToolButton" type="Button" parent="Layout/TopBar/Tools/ToolButtons"] +[node name="ArcLeftToolButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow/ToolButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(44, 48) icon_alignment = 1 @@ -180,7 +186,7 @@ theme_override_styles/pressed = SubResource("StyleBoxFlat_tool_active") theme_override_styles/hover_pressed = SubResource("StyleBoxFlat_tool_active") icon = ExtResource("6_tool_arc_left") -[node name="ArcRightToolButton" type="Button" parent="Layout/TopBar/Tools/ToolButtons"] +[node name="ArcRightToolButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow/ToolButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(44, 48) icon_alignment = 1 @@ -198,7 +204,7 @@ theme_override_styles/pressed = SubResource("StyleBoxFlat_tool_active") theme_override_styles/hover_pressed = SubResource("StyleBoxFlat_tool_active") icon = ExtResource("7_tool_arc_right") -[node name="FreeLineToolButton" type="Button" parent="Layout/TopBar/Tools/ToolButtons"] +[node name="FreeLineToolButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow/ToolButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(44, 48) icon_alignment = 1 @@ -216,7 +222,7 @@ theme_override_styles/pressed = SubResource("StyleBoxFlat_tool_active") theme_override_styles/hover_pressed = SubResource("StyleBoxFlat_tool_active") icon = ExtResource("11_tool_freeline") -[node name="JumpToolButton" type="Button" parent="Layout/TopBar/Tools/ToolButtons"] +[node name="JumpToolButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow/ToolButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(44, 48) icon_alignment = 1 @@ -234,7 +240,7 @@ theme_override_styles/pressed = SubResource("StyleBoxFlat_tool_active") theme_override_styles/hover_pressed = SubResource("StyleBoxFlat_tool_active") icon = ExtResource("8_tool_jump") -[node name="SpinToolButton" type="Button" parent="Layout/TopBar/Tools/ToolButtons"] +[node name="SpinToolButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow/ToolButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(44, 48) icon_alignment = 1 @@ -252,7 +258,7 @@ theme_override_styles/pressed = SubResource("StyleBoxFlat_tool_active") theme_override_styles/hover_pressed = SubResource("StyleBoxFlat_tool_active") icon = ExtResource("9_tool_spin") -[node name="GroupSequenceButton" type="Button" parent="Layout/TopBar/Tools/ToolButtons"] +[node name="GroupSequenceButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow/ToolButtons"] unique_name_in_owner = true custom_minimum_size = Vector2(44, 48) icon_alignment = 1 @@ -267,10 +273,10 @@ theme_override_colors/icon_disabled_color = Color(0.337255, 0.380392, 0.443137, theme_override_constants/icon_max_width = 28 icon = ExtResource("10_tool_group_sequence") -[node name="ToolSeparator" type="VSeparator" parent="Layout/TopBar/Tools"] +[node name="ToolSeparator" type="VSeparator" parent="Layout/TopBar/Tools/ToolFlow"] layout_mode = 2 -[node name="ForwardButton" type="Button" parent="Layout/TopBar/Tools"] +[node name="ForwardButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow"] unique_name_in_owner = true custom_minimum_size = Vector2(88, 48) layout_mode = 2 @@ -281,7 +287,7 @@ button_group = SubResource("ButtonGroup_direction") text = "Vorwärts" tooltip_text = "Vorwärts" -[node name="BackwardButton" type="Button" parent="Layout/TopBar/Tools"] +[node name="BackwardButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow"] unique_name_in_owner = true custom_minimum_size = Vector2(92, 48) layout_mode = 2 @@ -291,10 +297,10 @@ button_group = SubResource("ButtonGroup_direction") text = "Rückwärts" tooltip_text = "Rückwärts" -[node name="EdgeSeparator" type="VSeparator" parent="Layout/TopBar/Tools"] +[node name="EdgeSeparator" type="VSeparator" parent="Layout/TopBar/Tools/ToolFlow"] layout_mode = 2 -[node name="InsideButton" type="Button" parent="Layout/TopBar/Tools"] +[node name="InsideButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow"] unique_name_in_owner = true custom_minimum_size = Vector2(64, 48) layout_mode = 2 @@ -303,7 +309,7 @@ toggle_mode = true button_group = SubResource("ButtonGroup_edge") text = "Innen" -[node name="OutsideButton" type="Button" parent="Layout/TopBar/Tools"] +[node name="OutsideButton" type="Button" parent="Layout/TopBar/Tools/ToolFlow"] unique_name_in_owner = true custom_minimum_size = Vector2(64, 48) layout_mode = 2 @@ -313,10 +319,6 @@ button_pressed = true button_group = SubResource("ButtonGroup_edge") text = "Außen" -[node name="Spacer" type="Control" parent="Layout/TopBar/Tools"] -layout_mode = 2 -size_flags_horizontal = 3 - [node name="UndoButton" type="Button" parent="Layout/TopBar/Tools"] unique_name_in_owner = true custom_minimum_size = Vector2(96, 48) From f7c5fe2e1f5149eda7bbc0051a87f42773af75cc Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 16:00:39 +0100 Subject: [PATCH 27/28] docs: Tester-Feedback zu Sync und Hub festhalten MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Sync wurde von den Fachtestern nicht genutzt: Sie planen am PC und drucken aus. Sync bleibt als Funktion für andere Käufer, wird aber nicht ausgebaut; der Ausdruck ist der Weg, den die PDF-Ausgabe tragen muss. - Der Kür-Hub ist ebenfalls ungenutzt, hat aber anderes Potential: Die Tester wohnen weit auseinander, und der Hub ist der einzige Weg, sich gegenseitig Küren zu zeigen. Abwarten, bevor investiert wird. - `tests/manual/render_print_sample.gd` erzeugt ein Beispiel-PDF zum Prüfen des Ausdrucks (nicht Teil der Testsuite). --- docs/roadmap.md | 10 ++ .../tests/manual/render_print_sample.gd | 95 +++++++++++++++++++ 2 files changed, 105 insertions(+) create mode 100644 rinkplanner/tests/manual/render_print_sample.gd diff --git a/docs/roadmap.md b/docs/roadmap.md index 1c3c2e6..b027743 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -119,6 +119,16 @@ Webseite). Das Google-Drive-Backend ist im Code vorhanden, aber die OAuth-App ist nicht veröffentlicht. Google Drive und OneDrive stehen unter „Später: Weitere Cloud-Anbieter“. +**Rückmeldung der Fachtester (2026-11-13):** Sync wurde nicht genutzt – die +Tester arbeiten zuhause am PC und drucken die Abläufe aus. Sync bleibt als +Funktion (für andere Käufer und mehrere Geräte), wird aber nicht ausgebaut. +Der Ausdruck ist damit der Weg, den die PDF-Ausgabe tragen muss. + +**Kür-Hub:** ebenfalls noch ungenutzt, aber mit anderem Potential: Die +Tester wohnen weit auseinander, und der Hub ist der einzige Weg, sich +gegenseitig Küren zu zeigen. Abzuwarten, ob dieser Effekt greift, bevor hier +investiert wird. + ### Erledigt: Element-Marker - [x] Sprungpunkte, Pirouettenzentren und Sequenzbereiche platzieren diff --git a/rinkplanner/tests/manual/render_print_sample.gd b/rinkplanner/tests/manual/render_print_sample.gd new file mode 100644 index 0000000..a0c4e72 --- /dev/null +++ b/rinkplanner/tests/manual/render_print_sample.gd @@ -0,0 +1,95 @@ +extends SceneTree + +## Erzeugt eine Beispieldatei zum Prüfen des Ausdrucks. Nicht Teil der Tests. + +const PathSegmentModel := preload("res://src/core/model/path_segment.gd") + + +func _init() -> void: + _run.call_deferred() + + +func _run() -> void: + var routine := Routine.new() + routine.routine_id = "print-sample" + routine.title = "Kür Testdruck" + routine.skater_name = "Erika Mustermann" + routine.adult_category = "gold" + routine.season = "2026/27" + routine.rink = RinkDimensions.new() + + _add_section(routine, "Start", 0, [ + {"from": Vector2(-18.0, -6.0), "to": Vector2(-6.0, 2.0), "kind": "jump", "code": "1A", "label": "Auftakt"}, + {"from": Vector2(-6.0, 2.0), "to": Vector2(6.0, 6.0), "kind": "spin", "code": "CCoSp", "label": "Pirouette"}, + {"from": Vector2(6.0, 6.0), "to": Vector2(14.0, 0.0), "kind": "plain", "code": "", "label": ""}, + ], 26.0) + _add_section(routine, "Abschnitt 2", 1, [ + {"from": Vector2(14.0, 0.0), "to": Vector2(0.0, -8.0), "kind": "jump", "code": "3Lz", "label": "Kombination"}, + {"from": Vector2(0.0, -8.0), "to": Vector2(-12.0, -4.0), "kind": "plain", "code": "", "label": "Übergang"}, + ], 24.0) + _add_section(routine, "Step Seq Absch.", 2, [ + {"from": Vector2(-12.0, -4.0), "to": Vector2(-2.0, 4.0), "kind": "sequence", "code": "StSq", "label": ""}, + {"from": Vector2(-2.0, 4.0), "to": Vector2(10.0, 2.0), "kind": "plain", "code": "", "label": ""}, + ], 22.0) + _add_section(routine, "Abschnitt 4", 3, [ + {"from": Vector2(10.0, 2.0), "to": Vector2(2.0, 8.0), "kind": "jump", "code": "2T", "label": "Finale"}, + {"from": Vector2(2.0, 8.0), "to": Vector2(-14.0, 2.0), "kind": "plain", "code": "", "label": ""}, + ], 22.7) + + routine.timeline_labels = [ + {"time_seconds": 5.0, "text": "Musikstart"}, + {"time_seconds": 60.0, "text": "Höhepunkt"}, + ] + + var pdf := RoutinePdfExporter.build(routine) + if pdf.is_empty(): + printerr("PDF leer") + quit(1) + return + var path := "user://print-sample.pdf" + var file := FileAccess.open(path, FileAccess.WRITE) + file.store_buffer(pdf) + file.close() + print("PDF: ", ProjectSettings.globalize_path(path)) + quit(0) + + +func _add_section( + routine: Routine, + title: String, + order: int, + entries: Array, + seconds: float +) -> void: + var section := RoutineSection.new() + section.section_id = "section-%03d" % (order + 1) + section.title = title + section.sequence_order = order + var share := seconds / maxf(float(entries.size()), 1.0) + for entry: Dictionary in entries: + var segment := PathSegment.new() + segment.segment_id = "seg-%s-%d" % [section.section_id, section.segments.size()] + var curve := Curve2D.new() + curve.add_point(entry["from"]) + curve.add_point((entry["from"] + entry["to"]) * 0.5 + Vector2(0.0, -3.0)) + curve.add_point(entry["to"]) + segment.curve = curve + segment.direction = PathSegment.Direction.FORWARD + segment.edge = PathSegment.Edge.OUTSIDE + segment.label = entry["label"] + if not str(entry["code"]).is_empty(): + match str(entry["kind"]): + "jump": + segment.set_element(PathSegment.ElementType.JUMP, entry["code"], 0) + "spin": + segment.set_element(PathSegment.ElementType.SPIN, entry["code"], 3) + segment.set_element_features( + PackedStringArray(["difficult_variation_sit", "difficult_exit"]) + ) + "sequence": + segment.set_element(PathSegment.ElementType.SEQUENCE, entry["code"], 2) + segment.apply_geometry_length(segment.get_length_m()) + segment.duration_seconds = share + segment.timing_mode = PathSegment.TimingMode.DURATION + section.segments.append(segment) + routine.sections.append(section) From f280d619eaf32a2aa6120a2f3614cd407d96d0e1 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 13 Nov 2026 16:07:34 +0100 Subject: [PATCH 28/28] =?UTF-8?q?docs:=20freie=20Fl=C3=A4che=20im=20PDF=20?= =?UTF-8?q?als=20Schreibplatz=20festhalten?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Die untere Blatthälfte der Abschnittsseiten bleibt bewusst leer — dort schreibt der Trainer mit der Hand mit. Ohne diesen Hinweis sieht die Fläche wie ungenutzter Platz aus, und der nächste Layout-Vorschlag würde sie füllen. Vermerkt in `docs/manual.md` und als Kommentar an den Layout- Konstanten im PDF-Exporter. --- docs/manual.md | 3 +++ rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd | 5 +++++ 2 files changed, 8 insertions(+) diff --git a/docs/manual.md b/docs/manual.md index 115c6f2..b2ecfed 100644 --- a/docs/manual.md +++ b/docs/manual.md @@ -253,6 +253,9 @@ Sport-TV-Bauchbinde bündig am oberen Rand der Eisfläche und gleitet nach zusätzlich ihre Teilstrecken-Anzahl. Reine Laufwege ohne Element stehen nur im Rink. Lange Abschnitte werden auf weiteren Seiten fortgesetzt. Bei „Aktiver Abschnitt“ entsteht nur die Seite dieses Abschnitts. + Die untere Blatthälfte bleibt bewusst frei: Dort schreibt man mit der Hand + mit — Korrekturen, Ansagen, Zeiten. Bitte nicht mit Inhalt füllen, nur um + Platz zu nutzen. Nach dem Export erscheint der **absolute Dateipfad** mit den Buttons **Öffnen**, **Ordner anzeigen** und **Pfad kopieren**. Die Option diff --git a/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd b/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd index 0e2dcf9..8091092 100644 --- a/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd +++ b/rinkplanner/src/whiteboard/io/routine_pdf_exporter.gd @@ -15,6 +15,11 @@ const MARGIN := 36.0 const CONTENT_TOP := 104.0 const FOOTER_RULE_Y := 566.0 +## Das Rink ist 2:1 und nimmt die volle Seitenbreite neben der Tabelle ein. +## Der Freiraum unter dem Diagramm ist Absicht: Auf dem ausgedruckten Blatt +## schreibt der Trainer mit der Hand mit. Nicht "optimieren", indem das Rink +## größer oder die Tabelle darunter gezogen wird — das wurde 2026-11-13 +## geprüft und verworfen. const OVERVIEW_DIAGRAM_WIDTH := 500.0 const OVERVIEW_DIAGRAM_HEIGHT := 268.0 const SECTION_DIAGRAM_WIDTH := 470.0