rinkplanner/docs/findings-2026-10-31-level-aus-features.md
torsten 15f7eab9cf fix: Feature-Auswahl im Element-Dialog pending und live
- Feature-Button folgt dem pending Typ/Kuerzel statt dem gespeicherten
  Segment; nach der Kuerzelwahl wird er sofort aktiv
- Feature-Auswahl aktualisiert Level, Base Value und Hinweis live
- Erst Uebernehmen schreibt Typ, Kuerzel, Features, Level und Standzeit
  in einem Undo-Schritt; Abbrechen verwirft
- 259 Whiteboard-Assertions (918 gesamt)
- Doku und Findings aktualisiert
2026-10-31 10:49:03 +01:00

86 lines
3.8 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 | 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`.