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:
parent
9cb880fca0
commit
1f5834752e
7 changed files with 256 additions and 55 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
69
docs/findings-2026-10-31-level-aus-features.md
Normal file
69
docs/findings-2026-10-31-level-aus-features.md
Normal 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`.
|
||||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue