rinkplanner/docs/findings-2026-10-31-kuerzelauswahl.md
torsten 9cb880fca0 feat: Kuerzelauswahl im Element-Inspector
- Katalog-Dropdown mit Anzeigenamen je Elementtyp
- Freitext-Fallback fuer Kombinationen und Varianten
- Suffix-Codes und feste Level werden beim Oeffnen uebernommen
- Typwechsel erhaelt nicht passende Codes als Freitext
- Whiteboard-Tests auf 241 Assertions erweitert (900 gesamt)
- Doku, Findings und Roadmap aktualisiert
2026-10-31 10:30:47 +01:00

70 lines
3.1 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: 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.