71 lines
3.1 KiB
Markdown
71 lines
3.1 KiB
Markdown
|
|
# Findings – Session: Kürzelauswahl im Element-Inspector (2026-10-31)
|
|||
|
|
|
|||
|
|
Ergänzung zu `docs/findings-2026-10-31-validierung.md`.
|
|||
|
|
Das Kürzel war bisher ein reines Freitextfeld. Für Standardelemente gibt es
|
|||
|
|
jetzt eine Auswahlbox aus dem Saisonkatalog; Freitext bleibt als bewusster
|
|||
|
|
Fallback für Kombinationen und Varianten.
|
|||
|
|
|
|||
|
|
## Ergebnis
|
|||
|
|
|
|||
|
|
| Ziel | Ergebnis |
|
|||
|
|
| :--- | :--- |
|
|||
|
|
| Kürzelwahl | `OptionButton` mit Familien des gewählten Elementtyps |
|
|||
|
|
| Anzeige | Code plus Name, z. B. `CCoSp — Change foot combination spin` |
|
|||
|
|
| Fallback | „Freitext / Kombination …“ blendet das bisherige Textfeld ein |
|
|||
|
|
| Leerzustand | „— Kürzel wählen —“ |
|
|||
|
|
| Level | Suffix und feste Level werden beim Öffnen übernommen |
|
|||
|
|
| Tests | 900 Assertions gesamt, `./tools/test.sh` grün |
|
|||
|
|
|
|||
|
|
## Entscheidungen
|
|||
|
|
|
|||
|
|
- **Auswahl statt reinem Freitext.** Tippfehler wie `ChStSq` entstehen bei
|
|||
|
|
der Auswahl nicht mehr; der Katalog liefert die zulässigen Familien bereits
|
|||
|
|
typgefiltert.
|
|||
|
|
- **Freitext bleibt.** Sprungkombinationen (`3Lz+2T`), Folgen, Varianten
|
|||
|
|
(`3Lzq`, `CCoSpV`) und künftige Elemente sind noch nicht strukturiert
|
|||
|
|
modelliert. Ein striktes Dropdown würde sie blockieren.
|
|||
|
|
- **Freitext ist ein expliziter Modus.** Das Textfeld ist standardmäßig
|
|||
|
|
ausgeblendet und erscheint erst nach Auswahl von
|
|||
|
|
„Freitext / Kombination …“. Der Platzhalter nennt Beispiele.
|
|||
|
|
- **Bestehende Codes werden tolerant gelesen.** Beim Öffnen wird ein
|
|||
|
|
Katalogcode ausgewählt; ein gespeicherter Suffix-Code wie `CCoSp4` wählt
|
|||
|
|
`CCoSp` und setzt Level 4. Unbekannte Codes landen im Freitextmodus, ohne
|
|||
|
|
verloren zu gehen.
|
|||
|
|
- **Typwechsel erhält Eingaben.** Wechselt der Elementtyp, wird die Liste neu
|
|||
|
|
aufgebaut. Ein Code, der im neuen Typ nicht vorkommt, bleibt als Freitext
|
|||
|
|
erhalten; die Validierung meldet den Typ-Mismatch.
|
|||
|
|
- **Feste Level werden gesetzt.** `ChSq` wählt beim Öffnen bzw. bei der
|
|||
|
|
Auswahl automatisch Level 1.
|
|||
|
|
|
|||
|
|
## Bedienung
|
|||
|
|
|
|||
|
|
- Kürzel-Feld im Element-Dialog ist jetzt eine Auswahlbox:
|
|||
|
|
- „— Kürzel wählen —“
|
|||
|
|
- alle Familien des Typs mit Anzeigename
|
|||
|
|
- „Freitext / Kombination …“
|
|||
|
|
- Auswahl einer Familie blendet das Textfeld aus; Auswahl von „Freitext“
|
|||
|
|
zeigt und fokussiert es.
|
|||
|
|
- Base-Value- und Feature-Hinweis reagieren auf die Auswahl wie bisher.
|
|||
|
|
- Beim Übernehmen wird der Code aus der Auswahl bzw. aus dem Freitextfeld
|
|||
|
|
gelesen; die bestehende Suffix-Normalisierung bleibt aktiv.
|
|||
|
|
|
|||
|
|
## Tests
|
|||
|
|
|
|||
|
|
Erweitert: `tests/run_whiteboard_tests.gd` (238 → 241 Assertions)
|
|||
|
|
|
|||
|
|
- Dropdown ist mit der Familie vorbefüllt, Freitextfeld verborgen
|
|||
|
|
- Katalogauswahl setzt Code und Base-Value-Hinweis
|
|||
|
|
- „Freitext“ zeigt das Textfeld
|
|||
|
|
- Suffix-Code und unbekannter Code funktionieren weiterhin über den Fallback
|
|||
|
|
|
|||
|
|
Visuell geprüft über `tests/manual/capture_elements.gd ... features` bei
|
|||
|
|
1400 × 876.
|
|||
|
|
|
|||
|
|
## Offene Punkte
|
|||
|
|
|
|||
|
|
1. **Autovervollständigung:** `ElementCatalog.suggest()` ist weiterhin nicht
|
|||
|
|
an ein Suchfeld angebunden; die Auswahlbox listet alle Familien.
|
|||
|
|
2. **Kombinationen:** `3Lz+2T` bleibt Freitext und wird vom Validator als
|
|||
|
|
unbekanntes Kürzel gemeldet, bis Kombinationen modelliert sind.
|
|||
|
|
3. **Varianten:** `q`, `<`, `e`, `!`, `V` sind nicht Teil des Katalogs.
|