feat: Elementvalidierung mit Pruefdialog

- RoutineValidator und ValidationIssue gegen Katalog und Level-Regeln
- Prueft Kuerzel/Typ/Level, Feature-Auswahl, Level-Abgleich sowie
  ChSq- und Sprung-Sonderfaelle
- Programmweite once_per_program-Features als Warnung
- Pruefen-Button und Dialog in der Statusleiste, nicht blockierend
- 28 Validierungs-Assertions, Whiteboard-Tests auf 233 erweitert (866 gesamt)
- Doku: isu-rules, Findings, Architektur und Roadmap aktualisiert
This commit is contained in:
torsten 2026-10-31 09:56:05 +01:00
parent 0613ffca3e
commit 223a072f5d
17 changed files with 1017 additions and 15 deletions

View file

@ -3,8 +3,8 @@
Stand: 2026-10-31
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
Übergeordnete Reihenfolge: `docs/roadmap.md`
Letzte Session: `docs/findings-2026-10-31-isu-levels.md`
(Session davor: `docs/findings-2026-10-31-isu-katalog.md`)
Letzte Session: `docs/findings-2026-10-31-validierung.md`
(Session davor: `docs/findings-2026-10-31-isu-levels.md`)
## 1. Leitentscheidung
@ -64,6 +64,8 @@ Implementiert in `rinkplanner/src/core/rules/`:
| `ElementCatalog` | saisonaler JSON-Katalog, Lookup nach Kürzel/Level, Vorschläge, Prüfung |
| `ElementFeature` | Level-Feature mit Zählgrenze und Programm-Flag |
| `ElementLevelRules` | saisonale Feature-Sätze, Pflichtfeatures und Level-Berechnung |
| `RoutineValidator` | prüft Elementdaten gegen Katalog und Level-Regeln |
| `ValidationIssue` | Befund mit Schweregrad, Meldung und Abschnitts-/Segmentbezug |
### Entscheidungen
@ -128,6 +130,16 @@ und zeigt es an, ersetzt aber das manuell gewählte `element_level` nicht
stillschweigend. So bleiben Altdaten und bewusste Overrides sichtbar, und die
spätere Validierung kann Abweichungen melden.
**D10 – Validierung liefert Befunde statt eines Ja/Nein.**
`RoutineValidator` prüft Elementdaten gegen Katalog und Level-Regeln und
liefert `ValidationIssue`-Objekte mit Schweregrad (Fehler/Warnung), Meldung
und Abschnitts-/Segmentbezug. Die Prüfung ist bewusst getrennt von
`Routine.validate()`: Das Modell prüft Struktur und Pfade, der Validator
prüft fachliche Elementdaten. Die Oberfläche zeigt die Befunde in einem
Dialog; sie blockiert Speichern oder Export nicht. Noch nicht abgedeckt sind
Programmtypen, Elementanzahl, Wiederholungs-/Kombinationsregeln und die
Begrenzung auf zwei Features pro Fuß.
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -178,6 +190,10 @@ spätere Validierung kann Abweichungen melden.
gewählten Level; das gewählte Level bleibt autoritativ.
Die Timing-Details (Dauer/Tempo/Profil) werden beim Setzen und für
Punktmarker ausgeblendet, damit die Leiste auch im Landscape kompakt bleibt.
- **Prüfung:** Der Button „Prüfen“ in der Statusleiste validiert alle
Elementsegmente gegen Katalog und Level-Regeln. Der Dialog listet Fehler
und Warnungen mit Abschnitt und Element; ein leeres Ergebnis wird positiv
bestätigt. Speichern und Export bleiben möglich.
- **Section-Verwaltung:** Ein Panel rechts zeigt die chronologische
Abschnittsliste. Neue Sections werden angelegt, umbenannt, gelöscht und
hoch-/runtergeschoben; `sequence_order` wird nach jeder Änderung
@ -332,15 +348,18 @@ Aktueller Stand:
schwierige Variationen, Level-4-Voraussetzungen, Pflichtfeatures bei
Schrittsequenzen, feste Level (`ChSq`), Feature-Validierung und die
Speicherung am Segment.
- **Validierung:** 28 Assertions für unbekannte Kürzel, Typ-Mismatches,
nicht verfügbare Level, Sprung-/ChSq-Sonderfälle, Feature-Fehler,
Pflichtfeatures, Level-Abweichungen und programmweite Einmal-Features.
- **Canvas:** 90 Assertions für Meter→Pixel-Mapping, Fit/Zoom/Pan,
Rink-Kontur und die reine Bogen-Geometrie.
- **Whiteboard:** 228 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 233 Assertions für Controller-Verdrahtung, Segmenterzeugung,
Linien-/Bogenpfade, Klemmen an der Bande, Auswahl, Griff- und
Richtungs-/Kanten-Bearbeitung, Segmentlöschung, Element-Marker (Setzen,
Typwechsel, Inspector inkl. Standzeit, Base-Value- und Feature-Hinweis,
Feature-Menü, Verschieben, Löschen), Section-Verwaltung,
Ghosting-Zustand, Segment-Labels inklusive Dialog und Sichtbarkeits-Schalter,
Speichern/Laden, Schema-Prüfung, Dirty-State,
Speichern/Laden, Schema-Prüfung, Dirty-State, Prüfdialog,
Navigationsmodus und den Maus-Drag-Pfad.
- **History:** 53 Assertions für Undo/Redo von Segmenten, Kanten, Labels, Sections,
Zeichengesten und Griff-Bearbeitung, Toolbar-Buttons, Erhalt der Ansicht

View file

@ -0,0 +1,94 @@
# Findings – Session: Elementvalidierung (2026-10-31)
Ergänzung zu `docs/findings-2026-10-31-isu-levels.md`.
Nach Katalog und Level-Features folgt die dritte ISU-Ausbaustufe: eine
strukturierte Prüfung der Elementdaten gegen das geladene Regelwerk.
## Ergebnis
| Ziel | Ergebnis |
| :--- | :--- |
| Prüfmodell | `RoutineValidator` + `ValidationIssue` in `src/core/rules/` |
| Prüfumfang | Kürzel, Typ, Level, Feature-Auswahl, Level-Abgleich, Einmal-Features |
| Befunde | Schweregrad, deutsche Meldung, Abschnitts- und Segmentbezug |
| Oberfläche | Button „Prüfen“ in der Statusleiste, Dialog mit Fehlern/Warnungen |
| Verhalten | Prüfung ist nicht blockierend; Speichern und Export bleiben möglich |
| Tests | 866 Assertions gesamt, `./tools/test.sh` grün (neu: 28 Validierung) |
## Entscheidungen
- **Getrennt von `Routine.validate()`.** Das Modell prüft weiterhin Struktur,
Pfade und Rink-Grenzen. `RoutineValidator` prüft fachliche Elementdaten
gegen Katalog und Level-Regeln. So bleibt das Modell unabhängig von
saisonalen Daten.
- **Befunde statt Ja/Nein.** Jeder Befund trägt `severity`, `message`,
`section_id` und `segment_id`. Die UI kann Fehler und Warnungen
unterscheiden und auf die Quelle zeigen.
- **Deutsche, Nutzer-nahe Meldungen.** Die Meldungen nennen Kürzel, Level
und ggf. das erste Segment, z. B. „Kürzel „ChStSq“ ist nicht im Katalog
2025/26.“
- **Nicht blockierend.** Die Prüfung ist ein Hinweis, keine Speichersperre.
Unvollständige Kür während der Arbeit bleiben speicherbar.
- **Einmal-Features als Warnung.** `once_per_program` aus den Level-Daten
wird programmweit ausgewertet: Das erste Vorkommen merkt sich das Segment,
weitere Vorkommen erzeugen eine Warnung mit Verweis auf das erste Segment.
- **`ChSq` und Sprünge als Sonderfälle.** `ChSq` muss das feste Level 1
tragen; Sprünge mit Level ungleich 0 und mit Features werden gewarnt.
## Geprüfte Fälle
- Kürzel nicht im Katalog
- Kürzel gehört zu einem anderen Elementtyp
- Level ist für die Elementfamilie nicht verfügbar
- `ChSq` mit falschem Level
- Sprung mit Level ungleich 0
- Sprung mit Level-Features
- Element ohne Kürzel (Warnung)
- unbekanntes Feature
- Feature zu oft gewählt (z. B. drei schwierige Variationen)
- Pflichtfeature einer Schrittsequenz fehlt
- Feature-Ergebnis weicht vom gewählten Level ab
- Feature mit `once_per_program` in mehreren Elementen
## Oberfläche
- Der Button **Prüfen** sitzt links neben „Segment löschen“ in der
Statusleiste.
- Der Dialog `Kür prüfen` zeigt eine Zusammenfassung (`n Fehler, m Warnungen`)
und darunter die Befunde mit farbigem Punkt, Schweregrad, Abschnitt, Element
und Meldung.
- Ein leeres Ergebnis wird positiv bestätigt: „Keine Befunde. Alle Elemente
passen zu Katalog und Level-Regeln.“
- Die Dialoggröße wird auf die Viewport-Größe begrenzt, damit sie auch in
kleinen Fenstern und im Headless-Test positionierbar bleibt.
## Grenzen
1. **Programmtyp und Elementanzahl:** Es gibt noch kein Modell für
Kurzprogramm/Kür, Adult-Level oder erlaubte Elementanzahl.
2. **Wiederholungen und Kombinationen:** Sprungkombinationen und -folgen sind
Freitext; Wiederholungsregeln werden nicht geprüft.
3. **Max. zwei Features pro Fuß:** Das Modell kennt keine Füße, die
Begrenzung bleibt offen.
4. **Feature-Positionsregeln:** „Feature nicht zusammen mit einer bereits
verwendeten Variationsposition“ ist nicht modelliert.
5. **Adult-Abweichungen:** Geprüft wird das reguläre ISU-Regelwerk 2025/26.
## Tests
Neu: `tests/run_validation_tests.gd` (28 Assertions)
- saubere Kür ohne Befunde
- unbekanntes Kürzel, Typ-Mismatch, nicht verfügbares Level
- Sprung-Level/-Features, festes `ChSq`-Level
- fehlendes Kürzel
- unbekanntes/überzähliges Feature, fehlendes Pflichtfeature
- Level-Abweichung
- programmweites Einmal-Feature mit Verweis auf das erste Segment
- fehlendes Regelwerk
Erweitert: `tests/run_whiteboard_tests.gd` (228 → 233 Assertions) prüft
`validate_routine()`, den Prüfdialog mit Fehlertext und eine saubere Kür.
Visuell geprüft über `tests/manual/capture_elements.gd ... validate` bei
1400 × 876.

View file

@ -157,6 +157,23 @@ abgeleitete Level und – bei Abweichung – das manuell gewählte Level, z. B.
`Features: 2 · Level 2 · gewählt: Level 4`. Das gewählte Level bleibt
autoritativ; die Feature-Prüfung ersetzt es nicht stillschweigend.
## Prüfung
`RoutineValidator` prüft alle Elementsegmente gegen Katalog und Level-Regeln
und liefert `ValidationIssue`-Befunde mit Schweregrad, Meldung und Bezug zu
Abschnitt und Segment. Geprüft werden:
- unbekannte Kürzel und Kürzel mit falschem Elementtyp
- nicht verfügbare Level, Sprung-Level ungleich 0 und das feste Level von `ChSq`
- unbekannte Features, zu häufige Features und fehlende Pflichtfeatures
- Abweichungen zwischen Feature-Ergebnis und gewähltem Level
- Features, die laut Daten nur einmal pro Programm zählen
Der Button **Prüfen** in der Statusleiste öffnet die Befunde in einem Dialog.
Die Prüfung blockiert Speichern und Export nicht. Noch nicht geprüft werden
Programmtyp, erlaubte Elementanzahl, Wiederholungs- und Kombinationsregeln
sowie die Begrenzung auf zwei Features pro Fuß.
## Neue Saison einpflegen
1. Neue ISU-Communication (Scale of Values) beschaffen und als JSON nach dem
@ -177,9 +194,10 @@ mit ausgeliefert.
## Nächste Ausbaustufen
- Programmweite Feature-Grenzen (`once_per_program`, max. 2 Features pro Fuß)
- Abgleich zwischen gewähltem Level und Feature-Ergebnis in der Validierung
- Max. zwei Features pro Fuß und Feature-Positionsregeln
- Programmtypen, erlaubte Elementanzahl sowie Wiederholungs- und
Kombinationsregeln
- GOE-Tabellen und `V`-/Unterrotations-Varianten
- Sprungkombinationen und -folgen als zusammengesetzte Elemente
- Programmvalidierung (erlaubte Elementanzahl, Wiederholungen, Adult-Regeln)
- Adult-spezifische Programmregeln
- Vorschlagsliste im Inspector direkt aus `suggest()`

View file

@ -1,6 +1,6 @@
# Rinkplanner – Roadmap
Stand: 2026-10-31 (ISU-Katalog und Level-Features; Sync-Komfort und UI-Refactoring zurückgestellt)
Stand: 2026-10-31 (ISU-Katalog, Level-Features und Elementvalidierung; Sync-Komfort und UI-Refactoring zurückgestellt)
Diese Reihenfolge ist die verbindliche Arbeitsgrundlage für Phase 1. Änderungen
nur bewusst und nach Rücksprache. Erkenntnisse der letzten Session:
`docs/findings-2026-10-30-element-marker.md`.
@ -119,8 +119,11 @@ Voraussetzung für Phase 1.
- [x] Features und Kriterien für die Level-Vergabe
– Pirouetten (14 Features) und Schrittsequenzen (4 Features),
Level-Berechnung und Auswahl im Inspector; Details in `docs/isu-rules.md`
- [ ] Validierung von Elementen und Kombinationen
- [ ] Programmweite Feature-Grenzen (`once_per_program`, max. 2 pro Fuß)
- [x] Validierung von Elementen (Katalog, Level, Features, Level-Abgleich)
mit Prüfdialog in der Statusleiste
- [x] Programmweite Einmal-Features (`once_per_program`) als Warnung
- [ ] Max. zwei Features pro Fuß und Feature-Positionsregeln
- [ ] Kombinations-, Wiederholungs- und Programmtyp-Regeln
- [ ] Optional: Kürzelvorschläge im Inspector aus `suggest()`
- [ ] Optional: GOE-Tabellen sowie `V`-/Unterrotationsvarianten
@ -146,11 +149,11 @@ 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 und
Level-Features stehen, als Nächstes folgt die Validierung. 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.
sind erledigt. Im PoC läuft jetzt das ISU-Regelwerk – Katalog, Level-Features
und Elementvalidierung stehen; als Nächstes folgen Programmregeln und
Kombinationen. 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.
## Querschnittsaufgaben

View file

@ -502,6 +502,14 @@ theme_override_font_sizes/font_size = 15
text = "Abschnitt 1 · 0 Segmente"
vertical_alignment = 1
[node name="ValidationButton" type="Button" parent="Layout/StatusBar/StatusBarContent"]
unique_name_in_owner = true
custom_minimum_size = Vector2(120, 56)
layout_mode = 2
theme_override_font_sizes/font_size = 15
text = "Prüfen"
tooltip_text = "Elemente gegen Katalog und Level-Regeln prüfen"
[node name="DeleteSegmentButton" type="Button" parent="Layout/StatusBar/StatusBarContent"]
unique_name_in_owner = true
custom_minimum_size = Vector2(160, 56)
@ -932,3 +940,19 @@ text = "Ziel: user://exports"
unique_name_in_owner = true
hide_on_item_selection = false
hide_on_checkable_item_selection = false
[node name="ValidationDialog" type="AcceptDialog" parent="."]
unique_name_in_owner = true
title = "Kür prüfen"
size = Vector2i(720, 520)
ok_button_text = "Schließen"
[node name="ValidationText" type="RichTextLabel" parent="ValidationDialog"]
unique_name_in_owner = true
offset_left = 12.0
offset_top = 12.0
offset_right = 708.0
offset_bottom = 456.0
bbcode_enabled = true
scroll_active = true
selection_enabled = true

View file

@ -86,6 +86,16 @@ func get_level4_features(type: PathSegment.ElementType) -> PackedStringArray:
return _level4_by_type[type].duplicate()
## Fixed level for elements that are not feature-based (ChSq), or -1.
func get_fixed_level(type: PathSegment.ElementType, code: String) -> int:
if type != PathSegment.ElementType.SEQUENCE:
return -1
var key := _normalize(code)
if not _fixed_levels.has(key):
return -1
return _fixed_levels[key]
func get_thresholds() -> Array[Dictionary]:
var copy: Array[Dictionary] = []
copy.assign(_thresholds)

View file

@ -0,0 +1,296 @@
class_name RoutineValidator
extends RefCounted
## Validates the element data of a routine against the season's catalog and
## level rules. It does not validate paths or section bookkeeping (the model
## does that) and it does not know program types, element counts, jump
## combinations or repetition limits yet.
var _catalog: ElementCatalog
var _rules: ElementLevelRules
func _init(catalog: ElementCatalog, rules: ElementLevelRules) -> void:
_catalog = catalog
_rules = rules
## Returns all findings in section order. An empty array means the element
## data is consistent with the loaded rule set.
func validate(routine: Routine) -> Array[ValidationIssue]:
var issues: Array[ValidationIssue] = []
if routine == null:
issues.append(_issue(ValidationIssue.Severity.ERROR, "Keine Kür geladen."))
return issues
if _catalog == null or _rules == null:
issues.append(
_issue(
ValidationIssue.Severity.ERROR,
"Regelwerk ist nicht geladen; Prüfung nicht möglich."
)
)
return issues
var seen_once: Dictionary[String, String] = {}
for section: RoutineSection in routine.sections:
if section == null:
continue
for segment: PathSegment in section.segments:
if segment == null or not segment.is_element():
continue
_validate_segment(segment, section.section_id, issues)
_collect_program_features(
segment,
section.section_id,
seen_once,
issues
)
return issues
func _validate_segment(
segment: PathSegment,
section_id: String,
issues: Array[ValidationIssue]
) -> void:
var code := segment.element_code.strip_edges()
if code.is_empty():
issues.append(
_issue(
ValidationIssue.Severity.WARNING,
"Element ohne Kürzel; Base Value und Level sind nicht prüfbar.",
section_id,
segment.segment_id
)
)
return
var definition := _catalog.find(code)
if definition == null:
issues.append(
_issue(
ValidationIssue.Severity.ERROR,
"Kürzel „%s“ ist nicht im Katalog %s."
% [code, _catalog.season],
section_id,
segment.segment_id
)
)
elif definition.element_type != segment.element_type:
issues.append(
_issue(
ValidationIssue.Severity.ERROR,
"Kürzel „%s“ gehört zu %s, nicht zu %s."
% [
code,
PathSegment.element_type_name(definition.element_type),
PathSegment.element_type_name(segment.element_type),
],
section_id,
segment.segment_id
)
)
var fixed_level := _rules.get_fixed_level(segment.element_type, code)
if fixed_level >= 0:
if segment.element_level != fixed_level:
issues.append(
_issue(
ValidationIssue.Severity.ERROR,
"„%s“ ist fest %s (gewählt: %s)."
% [
code,
ElementDefinition.level_label(fixed_level),
ElementDefinition.level_label(segment.element_level),
],
section_id,
segment.segment_id
)
)
elif (
definition != null
and definition.element_type == segment.element_type
):
if definition.is_leveled():
if not definition.has_level(segment.element_level):
issues.append(
_issue(
ValidationIssue.Severity.ERROR,
"%s ist für „%s“ nicht verfügbar."
% [
ElementDefinition.level_label(segment.element_level),
code,
],
section_id,
segment.segment_id
)
)
elif segment.element_level != 0:
issues.append(
_issue(
ValidationIssue.Severity.WARNING,
"„%s“ hat Level %d; Sprünge sind nicht levelbar."
% [code, segment.element_level],
section_id,
segment.segment_id
)
)
_validate_features(segment, code, section_id, issues)
func _validate_features(
segment: PathSegment,
code: String,
section_id: String,
issues: Array[ValidationIssue]
) -> void:
if segment.element_type == PathSegment.ElementType.JUMP:
if not segment.element_features.is_empty():
issues.append(
_issue(
ValidationIssue.Severity.WARNING,
"„%s“ hat %d Level-Features; Sprünge sind nicht levelbar."
% [code, segment.element_features.size()],
section_id,
segment.segment_id
)
)
return
var counts: Dictionary[String, int] = {}
for raw: String in segment.element_features:
var feature_code := raw.strip_edges()
if feature_code.is_empty():
issues.append(
_issue(
ValidationIssue.Severity.ERROR,
"Leerer Feature-Code bei „%s“." % code,
section_id,
segment.segment_id
)
)
continue
var feature := _rules.get_feature(segment.element_type, feature_code)
if feature == null:
issues.append(
_issue(
ValidationIssue.Severity.ERROR,
"Unbekanntes Feature „%s“ für „%s“." % [raw, code],
section_id,
segment.segment_id
)
)
continue
var used: int = counts.get(feature_code, 0)
if used >= feature.max_per_element:
issues.append(
_issue(
ValidationIssue.Severity.ERROR,
"Feature „%s“ ist bei „%s“ zu oft gewählt (max. %d)."
% [feature.display_name, code, feature.max_per_element],
section_id,
segment.segment_id
)
)
continue
counts[feature_code] = used + 1
if segment.element_features.is_empty():
return
for required: String in _rules.get_required_features(segment.element_type):
if counts.has(required):
continue
var required_feature := _rules.get_feature(
segment.element_type,
required
)
var required_name := (
required_feature.display_name if required_feature != null else required
)
issues.append(
_issue(
ValidationIssue.Severity.WARNING,
"Pflichtfeature fehlt bei „%s“: %s."
% [code, required_name],
section_id,
segment.segment_id
)
)
var result := _rules.calculate_level(
segment.element_type,
code,
segment.element_features
)
if not result.missing_required.is_empty():
return
if not result.ignored_features.is_empty():
return
if result.level != segment.element_level:
issues.append(
_issue(
ValidationIssue.Severity.WARNING,
"Features ergeben bei „%s“ %s, gewählt ist %s."
% [
code,
ElementDefinition.level_label(result.level),
ElementDefinition.level_label(segment.element_level),
],
section_id,
segment.segment_id
)
)
## Features marked as once-per-program may only count in the first element
## that uses them. The technical rule additionally depends on categories and
## positions; the data flag is the simplified part that can be checked today.
func _collect_program_features(
segment: PathSegment,
section_id: String,
seen_once: Dictionary[String, String],
issues: Array[ValidationIssue]
) -> void:
for raw: String in segment.element_features:
var feature := _rules.get_feature(
segment.element_type,
raw.strip_edges()
)
if feature == null or not feature.once_per_program:
continue
var key := feature.code.to_lower()
if seen_once.has(key):
issues.append(
_issue(
ValidationIssue.Severity.WARNING,
"Feature „%s“ zählt nur einmal pro Programm (zuerst in Segment „%s“)."
% [feature.display_name, seen_once[key]],
section_id,
segment.segment_id
)
)
continue
seen_once[key] = segment.segment_id
static func count_severity(
issues: Array[ValidationIssue],
severity: int
) -> int:
var count := 0
for issue: ValidationIssue in issues:
if issue.severity == severity:
count += 1
return count
func _issue(
severity: ValidationIssue.Severity,
message: String,
section_id: String = "",
segment_id: String = ""
) -> ValidationIssue:
return ValidationIssue.new(severity, message, section_id, segment_id)

View file

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

View file

@ -0,0 +1,37 @@
class_name ValidationIssue
extends RefCounted
## One finding from [RoutineValidator]. Messages are user-facing German; the
## section and segment IDs allow the UI to point at the source.
enum Severity {
INFO,
WARNING,
ERROR,
}
var severity: Severity = Severity.INFO
var message: String = ""
var section_id: String = ""
var segment_id: String = ""
func _init(
p_severity: Severity = Severity.INFO,
p_message: String = "",
p_section_id: String = "",
p_segment_id: String = ""
) -> void:
severity = p_severity
message = p_message
section_id = p_section_id
segment_id = p_segment_id
func severity_label() -> String:
match severity:
Severity.ERROR:
return "Fehler"
Severity.WARNING:
return "Warnung"
return "Hinweis"

View file

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

View file

@ -51,6 +51,7 @@ const EXPORTS_DIR := "user://exports"
const EXPORT_SHEET_SCENE := preload("res://scenes/export/export_sheet.tscn")
const ELEMENT_CATALOG_SCRIPT := preload("res://src/core/rules/element_catalog.gd")
const ELEMENT_LEVEL_RULES_SCRIPT := preload("res://src/core/rules/element_level_rules.gd")
const ROUTINE_VALIDATOR_SCRIPT := preload("res://src/core/rules/routine_validator.gd")
const FEATURE_MENU_RESET_ID := 1000000
const EXPORT_IMAGE_SIZE := Vector2i(2560, 1600)
const AUTOSAVE_PATH := "user://autosave.tres"
@ -116,6 +117,9 @@ const COMPACT_LAYOUT_WIDTH := 1280.0
@onready var element_features_button: Button = %ElementFeaturesButton
@onready var element_feature_hint: Label = %ElementFeatureHint
@onready var element_feature_menu: PopupMenu = %ElementFeatureMenu
@onready var validation_button: Button = %ValidationButton
@onready var validation_dialog: AcceptDialog = %ValidationDialog
@onready var validation_text: RichTextLabel = %ValidationText
@onready var element_duration_spin: SpinBox = %ElementDurationSpin
@onready var segment_label_dialog: ConfirmationDialog = %SegmentLabelDialog
@onready var segment_label_edit: LineEdit = %SegmentLabelEdit
@ -257,6 +261,7 @@ func _ready() -> void:
segment_label_edit.text_submitted.connect(_on_label_submitted)
element_button.pressed.connect(_open_element_dialog)
element_dialog.confirmed.connect(_on_element_confirmed)
validation_button.pressed.connect(open_validation_dialog)
element_type_option.item_selected.connect(_on_element_type_selected)
resized.connect(_apply_responsive_layout)
@ -423,6 +428,98 @@ func get_level_rules() -> ElementLevelRules:
return _level_rules
## Cross-checks all element segments against the catalog and level rules.
## 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
)
return validator.validate(_routine)
## Opens the validation dialog with the current findings.
func open_validation_dialog() -> void:
var issues := validate_routine()
var errors := RoutineValidator.count_severity(
issues,
ValidationIssue.Severity.ERROR
)
var warnings := RoutineValidator.count_severity(
issues,
ValidationIssue.Severity.WARNING
)
var lines := PackedStringArray()
if issues.is_empty():
lines.append(
"[b]Keine Befunde.[/b] Alle Elemente passen zu Katalog und Level-Regeln."
)
else:
lines.append(
"[b]%d Fehler, %d Warnungen[/b]" % [errors, warnings]
)
lines.append("")
for issue: ValidationIssue in 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 = "\n".join(lines)
var target := Vector2i(720, 520)
var viewport_size := Vector2i(get_viewport_rect().size)
if viewport_size.x > 0:
target.x = mini(target.x, viewport_size.x)
if viewport_size.y > 0:
target.y = mini(target.y, viewport_size.y)
validation_dialog.popup_centered(target)
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“"
% (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]")
func get_selected_element_features() -> PackedStringArray:
var segment := get_selected_segment()
if segment == null:

View file

@ -27,6 +27,9 @@ $GODOT --headless --path rinkplanner --script res://tests/run_rules_tests.gd
# Run ISU level-feature tests
$GODOT --headless --path rinkplanner --script res://tests/run_level_tests.gd
# Run routine element-validation tests
$GODOT --headless --path rinkplanner --script res://tests/run_validation_tests.gd
# Run canvas transform/geometry tests
$GODOT --headless --path rinkplanner --script res://tests/run_canvas_tests.gd

View file

@ -89,6 +89,8 @@ func _capture() -> void:
PackedStringArray(["difficult_variation", "difficult_exit"])
)
controller.element_button.pressed.emit()
elif args.size() > 3 and args[3] == "validate":
controller.open_validation_dialog()
elif args.size() > 3 and args[3] == "spin":
var elapsed := 0.0
for segment: PathSegment in controller.get_active_section().segments:

View file

@ -0,0 +1,356 @@
extends SceneTree
## Headless tests for routine element validation.
##
## Run with:
## godot --headless --path rinkplanner --script res://tests/run_validation_tests.gd
const ElementCatalogScript := preload("res://src/core/rules/element_catalog.gd")
const ElementLevelRulesScript := preload("res://src/core/rules/element_level_rules.gd")
const RoutineValidatorScript := preload("res://src/core/rules/routine_validator.gd")
const ValidationIssueScript := preload("res://src/core/rules/validation_issue.gd")
const RoutineModel := preload("res://src/core/model/routine.gd")
const RoutineSectionModel := preload("res://src/core/model/routine_section.gd")
const PathSegmentModel := preload("res://src/core/model/path_segment.gd")
var _assertions: int = 0
var _failures: PackedStringArray = PackedStringArray()
var _catalog: ElementCatalog
var _rules: ElementLevelRules
var _validator: RoutineValidator
func _init() -> void:
_catalog = ElementCatalogScript.load_default()
_rules = ElementLevelRulesScript.load_default()
_validator = RoutineValidatorScript.new(_catalog, _rules)
_test_clean_routine()
_test_unknown_code()
_test_type_mismatch()
_test_unavailable_level()
_test_jump_level_and_features()
_test_fixed_level()
_test_missing_code()
_test_feature_selection()
_test_level_mismatch()
_test_program_once_features()
_test_missing_rules()
_finish()
func _test_clean_routine() -> void:
var routine := _make_routine()
var section := routine.sections[0]
_add_marker(
section,
"spin",
PathSegment.ElementType.SPIN,
"CCoSp",
4,
PackedStringArray(
[
"difficult_variation",
"difficult_variation",
"difficult_exit",
"change_of_edge",
]
)
)
_add_marker(
section,
"sequence",
PathSegment.ElementType.SEQUENCE,
"StSq",
4,
PackedStringArray(
[
"variety_of_turns",
"both_rotations",
"body_movements",
"turn_combinations",
]
)
)
var issues := _validator.validate(routine)
_check(issues.is_empty(), "a consistent routine has no findings (%s)" % _messages(issues))
func _test_unknown_code() -> void:
var issues := _validate_one(
PathSegment.ElementType.SPIN,
"3X",
0,
PackedStringArray()
)
_check(_count(issues, ValidationIssueScript.Severity.ERROR) == 1, "unknown code is an error")
_check(_has_message(issues, "nicht im Katalog"), "unknown code message")
func _test_type_mismatch() -> void:
var issues := _validate_one(
PathSegment.ElementType.SPIN,
"3Lz",
0,
PackedStringArray()
)
_check(_count(issues, ValidationIssueScript.Severity.ERROR) == 1, "type mismatch is an error")
_check(_has_message(issues, "gehört zu Sprung"), "type mismatch message")
func _test_unavailable_level() -> void:
var routine := _make_routine()
var segment := _add_marker(
routine.sections[0],
"spin",
PathSegment.ElementType.SPIN,
"CCoSp",
0,
PackedStringArray()
)
segment.element_level = 7
var issues := _validator.validate(routine)
_check(
_count(issues, ValidationIssueScript.Severity.ERROR) == 1,
"an unavailable level is an error"
)
_check(_has_message(issues, "nicht verfügbar"), "unavailable level message")
func _test_jump_level_and_features() -> void:
var routine := _make_routine()
var segment := _add_marker(
routine.sections[0],
"jump",
PathSegment.ElementType.JUMP,
"3Lz",
2,
PackedStringArray(["difficult_exit"])
)
var issues := _validator.validate(routine)
_check(
_count(issues, ValidationIssueScript.Severity.WARNING) == 2,
"jump level and features are two warnings"
)
_check(_has_message(issues, "nicht levelbar"), "jump level warning")
_check(_has_message(issues, "Level-Features"), "jump feature warning")
_check(segment.element_level == 2, "the validator does not mutate the segment")
func _test_fixed_level() -> void:
var issues := _validate_one(
PathSegment.ElementType.SEQUENCE,
"ChSq",
2,
PackedStringArray()
)
_check(
_count(issues, ValidationIssueScript.Severity.ERROR) == 1,
"a wrong fixed level is an error"
)
_check(_has_message(issues, "fest"), "fixed level message")
var valid := _validate_one(
PathSegment.ElementType.SEQUENCE,
"ChSq",
1,
PackedStringArray()
)
_check(valid.is_empty(), "ChSq at Level 1 is valid")
func _test_missing_code() -> void:
var issues := _validate_one(
PathSegment.ElementType.SPIN,
"",
0,
PackedStringArray()
)
_check(
_count(issues, ValidationIssueScript.Severity.WARNING) == 1,
"a missing code is a warning"
)
_check(_has_message(issues, "ohne Kürzel"), "missing code message")
func _test_feature_selection() -> void:
var unknown := _validate_one(
PathSegment.ElementType.SPIN,
"CCoSp",
0,
PackedStringArray(["nope"])
)
_check(
_count(unknown, ValidationIssueScript.Severity.ERROR) == 1,
"an unknown feature is an error"
)
_check(_has_message(unknown, "Unbekanntes Feature"), "unknown feature message")
var too_many := _validate_one(
PathSegment.ElementType.SPIN,
"CCoSp",
0,
PackedStringArray(
["difficult_variation", "difficult_variation", "difficult_variation"]
)
)
_check(
_count(too_many, ValidationIssueScript.Severity.ERROR) == 1,
"too many difficult variations is an error"
)
_check(_has_message(too_many, "zu oft"), "over-limit feature message")
var missing := _validate_one(
PathSegment.ElementType.SEQUENCE,
"StSq",
1,
PackedStringArray(["body_movements"])
)
_check(
_count(missing, ValidationIssueScript.Severity.WARNING) == 1,
"a missing compulsory sequence feature is a warning"
)
_check(_has_message(missing, "Pflichtfeature fehlt"), "compulsory feature message")
func _test_level_mismatch() -> void:
var issues := _validate_one(
PathSegment.ElementType.SPIN,
"CCoSp",
4,
PackedStringArray(["difficult_variation", "difficult_exit"])
)
_check(
_count(issues, ValidationIssueScript.Severity.WARNING) == 1,
"a feature/level mismatch is a warning"
)
_check(_has_message(issues, "Features ergeben"), "level mismatch message")
func _test_program_once_features() -> void:
var routine := _make_routine()
var section := routine.sections[0]
_add_marker(
section,
"spin-a",
PathSegment.ElementType.SPIN,
"CCoSp",
1,
PackedStringArray(["difficult_exit"])
)
_add_marker(
section,
"spin-b",
PathSegment.ElementType.SPIN,
"CCoSp",
1,
PackedStringArray(["difficult_exit"])
)
var issues := _validator.validate(routine)
_check(
_count(issues, ValidationIssueScript.Severity.WARNING) == 1,
"repeated once-per-program features warn once per repeated occurrence"
)
_check(_has_message(issues, "nur einmal pro Programm"), "once-per-program message")
_check(
_has_message(issues, "zuerst in Segment „spin-a“"),
"once-per-program message names the first segment"
)
func _test_missing_rules() -> void:
var broken := RoutineValidatorScript.new(null, null)
var routine := _make_routine()
_add_marker(
routine.sections[0],
"spin",
PathSegment.ElementType.SPIN,
"CCoSp",
0,
PackedStringArray()
)
var issues := broken.validate(routine)
_check(
_count(issues, ValidationIssueScript.Severity.ERROR) == 1,
"a missing rule set is an error"
)
func _validate_one(
type: PathSegment.ElementType,
code: String,
level: int,
features: PackedStringArray
) -> Array[ValidationIssue]:
var routine := _make_routine()
_add_marker(routine.sections[0], "segment", type, code, level, features)
return _validator.validate(routine)
func _make_routine() -> Routine:
var routine: Routine = RoutineModel.new()
routine.routine_id = "validation-test"
routine.title = "Validation"
var section: RoutineSection = RoutineSectionModel.new()
section.section_id = "section-001"
section.title = "Abschnitt 1"
section.sequence_order = 0
var sections: Array[RoutineSection] = [section]
routine.sections = sections
return routine
func _add_marker(
section: RoutineSection,
segment_id: String,
type: PathSegment.ElementType,
code: String,
level: int,
features: PackedStringArray
) -> PathSegment:
var segment: PathSegment = PathSegmentModel.new()
segment.segment_id = segment_id
var curve := Curve2D.new()
curve.add_point(Vector2.ZERO)
segment.curve = curve
segment.set_element(type, code, level)
segment.set_element_features(features)
section.segments.append(segment)
return segment
func _count(issues: Array[ValidationIssue], severity: int) -> int:
return RoutineValidatorScript.count_severity(issues, severity)
func _has_message(issues: Array[ValidationIssue], fragment: String) -> bool:
for issue: ValidationIssue in issues:
if issue.message.contains(fragment):
return true
return false
func _messages(issues: Array[ValidationIssue]) -> String:
var parts := PackedStringArray()
for issue: ValidationIssue in issues:
parts.append(issue.message)
return "; ".join(parts)
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)

View file

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

View file

@ -1103,6 +1103,43 @@ func _run() -> void:
)
DirAccess.remove_absolute(save_as_path)
# Validation dialog.
controller.new_routine()
controller.add_element_marker(
Vector2(0.0, 0.0),
PathSegment.ElementType.SPIN,
"3X",
0
)
var issues := controller.validate_routine()
_check(issues.size() == 1, "validation reports one finding")
_check(
issues.size() > 0
and issues[0].severity == ValidationIssue.Severity.ERROR,
"an unknown element code is reported as an error"
)
controller.message_dialog.hide()
controller.open_validation_dialog()
_check(controller.validation_dialog.visible, "validation button opens the dialog")
_check(
controller.validation_text.text.contains("nicht im Katalog"),
"validation dialog shows the catalog finding"
)
controller.validation_dialog.hide()
controller.new_routine()
controller.add_element_marker(
Vector2(0.0, 0.0),
PathSegment.ElementType.SPIN,
"CCoSp",
4
)
var clean_issues := controller.validate_routine()
_check(
clean_issues.is_empty(),
"a consistent routine has no validation findings"
)
scene.queue_free()
await process_frame
_finish()

View file

@ -28,6 +28,9 @@ fi
"$GODOT" --headless --path "$PROJECT_DIR" \
--script res://tests/run_level_tests.gd
"$GODOT" --headless --path "$PROJECT_DIR" \
--script res://tests/run_validation_tests.gd
"$GODOT" --headless --path "$PROJECT_DIR" \
--script res://tests/run_canvas_tests.gd