feat: Level automatisch aus Features

- Katalog-Pirouetten und -Sequenzen setzen element_level aus dem
  Feature-Ergebnis
- Spruenge fest Base, ChSq fest Level 1
- Level-Regler bei Katalog-Elementen read-only
- Unbekannte Freitext-Codes behalten den manuellen Level
- Undo umfasst Feature- und Levelaenderung gemeinsam
- Whiteboard-Tests auf 253 Assertions erweitert (912 gesamt)
- Doku und Findings aktualisiert
This commit is contained in:
torsten 2026-10-31 10:42:55 +01:00
parent 9cb880fca0
commit 1f5834752e
7 changed files with 256 additions and 55 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-kuerzelauswahl.md`
(Session davor: `docs/findings-2026-10-31-validierung.md`)
Letzte Session: `docs/findings-2026-10-31-level-aus-features.md`
(Session davor: `docs/findings-2026-10-31-kuerzelauswahl.md`)
## 1. Leitentscheidung
@ -123,14 +123,15 @@ ins Level-Feld normalisiert. Unbekannte Kürzel oder Level liefern `-1` statt
einen stillen Standardwert. Das JSON wird über `include_filter="*.json"` in die
Exporte aufgenommen.
**D9 – Level-Features sind Daten, das Level bleibt eine Autorengröße.**
**D9 – Level-Features sind Daten, der Level folgt aus ihnen.**
`ElementLevelRules` liest eine eigene saisonale JSON-Datei mit Feature-Sätzen
und Schwellen. Ausgewählte Features liegen als Codes am Segment
(`element_features`); Duplikate sind erlaubt, damit z. B. zwei schwierige
Variationen zwei Features zählen. Der Inspector berechnet daraus ein Level
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.
Variationen zwei Features zählen. Für Katalog-Elemente setzt der Controller
`element_level` automatisch aus dem Feature-Ergebnis; der Level-Regler ist
dann read-only. Sprünge sind fest Base, `ChSq` fest Level 1. Unbekannte
Freitext-Codes behalten einen manuellen Level als Fallback; die Validierung
meldet dort weiterhin Abweichungen.
**D10 – Validierung liefert Befunde statt eines Ja/Nein.**
`RoutineValidator` prüft Elementdaten gegen Katalog und Level-Regeln und
@ -191,9 +192,10 @@ Begrenzung auf zwei Features pro Fuß.
außerdem den **Base Value** des eingegebenen Kürzels und Levels aus dem
Saisonkatalog; unbekannte Kürzel werden als „nicht im Katalog“ markiert.
Der Button **Features (n)** öffnet die Checkbox-Liste der Level-Features
(Pirouetten, Schrittsequenzen) und übernimmt die Auswahl undo-fähig. Ein
Hinweis zeigt Feature-Anzahl, abgeleitetes Level und eine Abweichung zum
gewählten Level; das gewählte Level bleibt autoritativ.
(Pirouetten, Schrittsequenzen) und übernimmt die Auswahl undo-fähig. Der
Level wird daraus automatisch gesetzt und der Level-Regler ist bei
Katalog-Elementen read-only; Sprünge sind fest Base, `ChSq` fest Level 1.
Ein Hinweis zeigt Feature-Anzahl und abgeleitetes Level.
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
@ -364,7 +366,7 @@ Aktueller Stand:
Prüfstatistik je Kategorie.
- **Canvas:** 90 Assertions für Meter→Pixel-Mapping, Fit/Zoom/Pan,
Rink-Kontur und die reine Bogen-Geometrie.
- **Whiteboard:** 241 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 253 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. Kürzelauswahl, Standzeit, Base-Value- und

View file

@ -41,10 +41,11 @@ Element-Inspector.
Variationen als zwei Features zählen. Die Reihenfolge bleibt erhalten.
- **Typwechsel leert die Auswahl.** Features sind typabhängig; `set_element`
verwirft sie beim Wechsel des Elementtyps und beim Entfernen des Elements.
- **Das Level bleibt eine Autorengröße.** Die Berechnung erzeugt nur einen
Hinweis (`Features: 2 · Level 2 · gewählt: Level 4`). Der Inspector ändert
das gewählte Level nicht stillschweigend. So bleiben Altdaten und bewusste
Overrides sichtbar; die Validierung kann später Abweichungen melden.
- **Der Level folgt aus den Features.** Die Feature-Auswahl setzt
`element_level` für Katalog-Elemente automatisch; der Level-Regler ist dann
read-only. Sprünge sind fest Base, `ChSq` fest Level 1. Unbekannte
Freitext-Codes behalten einen manuellen Level als Fallback. (Ursprünglich
war der Level rein manuell; die Automatik kam im Folgeschritt.)
- **Eigene JSON-Datei.** Level-Features stammen aus einer anderen
Communication als die Base Values und ändern sich unabhängig. Beide Dateien
tragen Saison, Quelle und Gültigkeitsdatum.

View file

@ -0,0 +1,69 @@
# Findings – Session: Level aus Features (2026-10-31)
Ergänzung zu `docs/findings-2026-10-31-kuerzelauswahl.md`.
Der Level war bisher eine freie Auswahl, während die Features nur einen
Hinweis erzeugten. Jetzt folgt der Level bei Katalog-Elementen automatisch aus
der Feature-Auswahl.
## Ergebnis
| Ziel | Ergebnis |
| :--- | :--- |
| Pirouetten/Sequenzen | Level = berechnetes Feature-Ergebnis |
| Sprünge | Level fest Base (0) |
| `ChSq` | Level fest 1 |
| Unbekannte Freitext-Codes | Level bleibt manuell |
| Oberfläche | Level-Regler bei Katalog-Elementen read-only |
| Undo | Feature- und Leveländerung in einem Schritt |
| Tests | 912 Assertions gesamt, `./tools/test.sh` grün |
## Verhalten
- `set_selected_element_features()` berechnet das Level neu und schreibt es
zusammen mit den Features in einem Undo-Schritt.
- Der Element-Dialog setzt den Level-Regler auf das berechnete Level und
deaktiviert ihn, sobald Kürzel und Typ im Katalog bekannt sind.
- Ohne Features ist ein Katalog-Element Base. Die gewünschte Stufe entsteht
durch Auswahl der Features, nicht durch manuelles Setzen des Levels.
- `ChSq` wird unabhängig von Features auf Level 1 gesetzt; Sprünge immer auf
Base.
- Unbekannte Freitext-Codes (`3Lz+2T`, `CCoSpV`, …) haben keine
Katalog-/Feature-Basis. Dort bleibt der Level-Regler aktiv, damit Varianten
weiterhin planbar sind.
- Der Base-Value-Hinweis und die Statusleiste folgen dem neuen Level sofort.
- Der Feature-Hinweis zeigt nur noch `Features: n · Level m`; die frühere
Mismatch-Anzeige entfällt bei automatisch abgeleiteten Elementen.
## Auswirkungen auf Altdaten
- Ein gespeicherter manueller Level ohne Features wird beim nächsten Öffnen
und Übernehmen auf Base normalisiert. Das ist beabsichtigt: Der Level soll
aus der dokumentierten Feature-Auswahl folgen.
- Die Validierung meldet bei alten Daten weiterhin eine Abweichung zwischen
Feature-Ergebnis und gespeichertem Level.
## Grenzen
1. **Features sind Eingaben, keine Messungen.** Die App kann nicht aus der
Zeichnung ableiten, ob eine schwierige Variation, ein schwieriger Ausgang
oder eine Kantenänderung tatsächlich ausgeführt wurde.
2. **Max. zwei Features pro Fuß** und Feature-Positionsregeln sind noch nicht
modelliert.
3. **Programmweite Einmal-Features** werden als Warnung geprüft, aber nicht in
die Level-Berechnung eingerechnet.
4. **Adult-Abweichungen** und GOE bleiben offen.
## Tests
Erweitert: `tests/run_whiteboard_tests.gd` (241 → 253 Assertions)
- Katalog-Spin ohne Features ist Base
- vier Features ergeben Level 4, drei Level 3, zwei Level 2
- Löschen der Features setzt den Level auf Base zurück
- Undo/Redo stellen Features und Level gemeinsam wieder her
- Level-Regler ist bei Katalog-Spin deaktiviert
- Suffix-Code und unbekannter Freitext-Code funktionieren weiterhin
- Sequenzbereich erhält Level 2 aus zwei Features
Visuell geprüft über `tests/manual/capture_elements.gd ... features` bei
1400 × 876: `Level 2` ausgegraut, `Base Value: 2,50`, Status `CCoSp L2`.

View file

@ -138,10 +138,13 @@ var result := rules.calculate_level(
Das Segment speichert die Auswahl als `element_features`
(`PackedStringArray`). Duplikate sind erlaubt, damit zwei schwierige
Variationen als zwei Features zählen. Die Daten enthalten außerdem
`once_per_program` (Feature zählt nur beim ersten Versuch im Programm) und
`max_per_element`. Die Programmprüfung und die Begrenzung „max. zwei Features
pro Fuß“ sind noch nicht umgesetzt.
Variationen als zwei Features zählen. Für Katalog-Elemente setzt der
Controller den Level automatisch aus dem Feature-Ergebnis. Sprünge sind fest
Base, `ChSq` fest Level 1. Unbekannte Freitext-Codes behalten einen manuellen
Level als Fallback. Die Daten enthalten außerdem `once_per_program` (Feature
zählt nur beim ersten Versuch im Programm) und `max_per_element`. Die
Programmprüfung und die Begrenzung „max. zwei Features pro Fuß“ sind noch
nicht umgesetzt.
## Bedienung
@ -154,15 +157,14 @@ weiterhin ins Level-Feld normalisiert.
Der Inspector zeigt unter der Level-Auswahl `Base Value: 3,50`.
Unbekannte Kürzel erscheinen als „Kürzel nicht im Katalog 2025/26“. Der
Hinweis aktualisiert sich bei Änderungen an Typ, Kürzel und Level; der Tooltip
nennt Saison und Quelle.
Hinweis aktualisiert sich bei Änderungen an Typ, Kürzel und Features; der
Tooltip nennt Saison und Quelle.
Darunter liegt der Button **Features (n)**. Er öffnet eine Checkbox-Liste mit
den Features des Elementtyps; die Auswahl wird beim Schließen übernommen und
ist undo-fähig. Ein Hinweis zeigt die gezählten Features, das daraus
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.
ist undo-fähig. Der Level-Regler ist bei Katalog-Elementen read-only und folgt
der Feature-Auswahl: 0 Features → Base, 1 → Level 1 … 4 → Level 4. Der Hinweis
zeigt z. B. `Features: 2 · Level 2`.
## Prüfung

View file

@ -119,6 +119,8 @@ 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`
- [x] Level automatisch aus Features (Pirouetten/Sequenzen), Sprünge Base,
`ChSq` Level 1; manueller Level nur für Freitext-Codes
- [x] Validierung von Elementen (Katalog, Level, Features, Level-Abgleich)
mit Prüfdialog in der Statusleiste
- [x] Programmweite Einmal-Features (`once_per_program`) als Warnung