rinkplanner/docs/findings-2026-10-31-level-aus-features.md
torsten 1f5834752e 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
2026-10-31 10:42:55 +01:00

69 lines
3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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`.