rinkplanner/docs/findings-2026-10-31-level-aus-features.md

87 lines
3.8 KiB
Markdown
Raw Normal View History

# 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 | 918 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.
## Feature-Auswahl im Dialog
Die Feature-Auswahl ist eine **Pending-Auswahl**:
1. Typ und Kürzel im Dialog wählen.
2. Der Button **Features (n)** wird aktiv, sobald das Kürzel im Katalog steht.
3. Features anhaken; Level, Base Value und Hinweis aktualisieren sich sofort.
4. Erst **Übernehmen** schreibt Typ, Kürzel, Features, Level und Standzeit in
einem Undo-Schritt ins Segment. **Abbrechen** verwirft die Auswahl.
Damit ist die Feature-Prüfung nicht mehr an das bereits gespeicherte Segment
gebunden. Vorher blieb der Button nach einem Typ-/Kürzelwechsel stumm, weil er
noch die alten Segmentdaten las; das war der gemeldete „Level bleibt Base“-
Effekt.
## 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 → 259 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
- kompletter Dialogfluss von leeren Marker über Typ-/Kürzelwahl und
Feature-Auswahl bis zum bestätigten Level 2
Visuell geprüft über `tests/manual/capture_elements.gd ... features` bei
1400 × 876: `Level 2` ausgegraut, `Base Value: 2,50`, Status `CCoSp L2`.