feat: In-App-Hilfe und Anleitung

- ?-Button in der Statusleiste oeffnet 'Hilfe & Annahmen'
- Erklaert Base Value, Level aus Features, Adult-Kategorien, Pruefung,
  PCS-Annahme und Sturzabzug inklusive Grenzen
- docs/manual.md als ausfuehrliche Anleitung, README verlinkt
- Whiteboard-Tests auf 281 Assertions erweitert (1025 gesamt)
- Doku und Findings aktualisiert
This commit is contained in:
torsten 2026-10-31 11:43:34 +01:00
parent ef1a01d5b3
commit e1f543cb66
10 changed files with 360 additions and 6 deletions

View file

@ -219,6 +219,9 @@ Datenquellen.
Bronze, Silver, Gold, Masters oder Masters Elite. Die Auswahl liegt als
`Routine.adult_category` an der Kür, ist undo-fähig und wird mitgespeichert.
Der Prüfdialog nennt Kategorie und Dauer im Kopf.
- **Hilfe:** Der Button **?** in der Statusleiste öffnet den Dialog
„Hilfe & Annahmen“ mit Base Value, Level-Features, Kategorien, Prüfung und
PCS-/Sturzannahmen. Dieselben Inhalte stehen in `docs/manual.md`.
- **Prüfung:** Der Button „Prüfen“ in der Statusleiste validiert alle
Elementsegmente gegen Katalog und Level-Regeln. Der Dialog nennt Saison,
Element- und Abschnittszahl und zeigt eine Prüfliste (Kürzel, Elementtyp,
@ -393,7 +396,7 @@ Aktueller Stand:
- **Adult-Kategorien:** 67 Assertions für Metadaten, Gold/Silver/Bronze,
Sprungerlaubnis, Level-Caps, Pflichtelemente, Wiederholungen, Kombinationen,
Dauer und unbekannte Kategorien.
- **Whiteboard:** 279 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 281 Assertions für Controller-Verdrahtung, Segmenterzeugung,
Linien-/Bogenpfade, Klemmen an der Bande, Auswahl, Griff- und
Richtungs-/Kanten-Bearbeitung, Segmentlöschung, Element-Marker (Setzen,
Typwechsel, Inspector inkl. Kürzelauswahl, Standzeit, Base-Value- und

View file

@ -20,7 +20,7 @@ und Bronze.
| Wiederholungen | max. 2-mal pro gelistetem Sprung, inkl. Kombinations-Teile |
| Kombinationen | Anzahl, Folgen und max. Sprünge pro Kombination |
| Punktschätzung | Basiswert + PCS-Annahme + Sturzabzug |
| Tests | 1023 Assertions gesamt, `./tools/test.sh` grün |
| Tests | 1025 Assertions gesamt, `./tools/test.sh` grün |
## Datenupdate 2026/27
@ -130,6 +130,15 @@ Geschätzte Summe: 49,55
(PCS 0–10, Stürze 0–20); die Werte werden mit der Kür gespeichert.
- GOE bleibt unberücksichtigt; die Summe ist eine grobe Planungshilfe.
## Hilfe & Anleitung
- Neuer **?**-Button in der Statusleiste öffnet den Dialog **Hilfe &
Annahmen**.
- Er erklärt Base Value, Level aus Features, Adult-Kategorien, Prüfung,
PCS-Annahme und Sturzabzug sowie die Grenzen der Schätzung.
- Dieselben Inhalte stehen als Anleitung in `docs/manual.md`; das README
verlinkt sie.
## Tests
- **Katalog:** 166 Assertions (43 Familien, 2026/27-Werte, `ChSp`).
@ -138,9 +147,9 @@ Geschätzte Summe: 49,55
- **Adult:** 67 Assertions (Metadaten, Kategorien, Sprungerlaubnis,
Gold-Limits, gültige Gold-Kür, Wiederholungen, Kombinationen, Dauer und
unbekannte Kategorie).
- **Whiteboard:** 279 Assertions (Kategorie-Auswahl, Prüfdialog, Gold-Befunde,
Punktschätzung und inline änderbare Annahmen).
- **Gesamt:** 1023 Assertions.
- **Whiteboard:** 281 Assertions (Kategorie-Auswahl, Prüfdialog, Gold-Befunde,
Punktschätzung, inline änderbare Annahmen und Hilfe-Dialog).
- **Gesamt:** 1025 Assertions.
Visuell geprüft bei 1400 × 876 und 1024 × 768: Kategorie-Dropdown, Kopfzeile
`Kategorie: Gold · 2:50 ±10 s`, Basiswert und Gold-Befunde.

View file

@ -13,6 +13,8 @@ Quellen:
- ISU International Adult Figure Skating Competitions 2026/27 –
Technical Announcement (für Oberstdorf 2027)
Anleitung und Annahmen für die Bedienung: `docs/manual.md`.
## Zweck
Der Katalog liefert die Base Values (BV) zu Elementkürzeln und Leveln. Er ist

152
docs/manual.md Normal file
View file

@ -0,0 +1,152 @@
# Rinkplanner – Anleitung und Annahmen
Diese Anleitung erklärt die wichtigsten Begriffe und die Annahmen, die die
App für Prüfung und Punktschätzung verwendet. Dieselbe Erklärung ist in der
App über den Button **?** in der Statusleiste erreichbar.
## Schnellstart
1. Kür anlegen oder öffnen.
2. In der Statusleiste die **Adult-Kategorie** wählen (Gold, Silver, Bronze,
Masters, Masters Elite).
3. Elemente aufs Eis setzen: Linie, Bogen oder Element-Marker.
4. Im Element-Dialog **Kürzel**, **Features** und ggf. **Standzeit** festlegen.
5. **Prüfen** öffnen: Prüfliste, Befunde und Punktschätzung ansehen.
## Kürzel und Base Value
- Das **Kürzel** bezeichnet die Elementfamilie, z. B. `3Lz`, `CCoSp` oder
`StSq`.
- Der **Level** ist die Schwierigkeitsstufe. Bei Pirouetten und
Schrittsequenzen folgt er aus den Features.
- Der **Base Value** wird aus Kürzel und Level im Saisonkatalog 2026/27
nachgeschlagen (ISU Communication 2786).
- **Sprünge** haben keinen Level; ihr Base Value hängt von Rotation und
Sprungtyp ab.
- **`ChSq`** (Choreo-Sequenz) und **`ChSp`** (Choreographic Spin) sind fest
Level 1.
- Unbekannte Freitext-Codes haben keinen Katalogwert und werden in der
Schätzung nicht gewertet.
Der Katalog wird jährlich ersetzt. Die Daten liegen unter
`rinkplanner/src/core/rules/data/` und tragen Saison, Quelle und
Gültigkeitsdatum.
## Level aus Features
Für Pirouetten und Schrittsequenzen gilt:
| Anzahl Features | Level |
| :--- | :--- |
| 0 | Base |
| 1 | Level 1 |
| 2 | Level 2 |
| 3 | Level 3 |
| 4 oder mehr | Level 4 |
- **Pirouetten:** 15 Features (2026/27). Maximal zwei schwierige Variationen
zählen pro Pirouette. Für Level 4 ist zusätzlich eines dieser Features
nötig: schwieriger Ausgang, klare Kantenänderung, beide Richtungen, klare
Temposteigerung, schwieriger Flug-Eingang oder **Windmills**.
- **Schrittsequenzen:** 5 Features. Feature 1 (Vielfalt schwieriger Schritte
und Drehungen) ist Pflicht.
- Features beschreiben die **Ausführung**. Die App kann sie nicht aus der
gezeichneten Linie ableiten; sie werden im Element-Dialog ausgewählt.
- Bei Katalog-Elementen ist der Level-Regler read-only. Der Level folgt aus
den Features; Springe sind Base, `ChSq`/`ChSp` fest Level 1.
## Adult-Kategorien
Die Kategorie wird in der Statusleiste gewählt und mit der Kür gespeichert.
| | Gold | Silver | Bronze |
| :--- | :--- | :--- | :--- |
| Dauer | 2:50 ±10 s | 2:00 ±10 s | 1:40 ±10 s |
| Sprünge | max. 5 | max. 4 | max. 4 |
| Erlaubt | Einfach/Double, ohne 2F/2Lz/2A/Triple | nur Einfach inkl. 1A | nur Einfach ohne Axel |
| Pirouetten | max. 3, inkl. `ChSp` | max. 2 | max. 2 |
| Sequenz | 1 Schrittsequenz | 1 `ChSq` | 1 `ChSq` |
| Level-Cap | Spins 3 / Sequenz 2 | 2 / 2 | 1 / 1 |
| PCS-Faktor | 2,67 | 2,00 | 2,00 |
| Sturzabzug | 1,0 | 0,5 außerhalb Elemente | 0,5 außerhalb Elemente |
Masters und Masters Elite sind ebenfalls wählbar. Grundlage ist das IAFSC
Technical Announcement 2026/27; es hat bei Konflikten Vorrang vor allgemeinen
ISU-Regeln.
## Prüfung
Der Button **Prüfen** zeigt:
- Kürzel im Katalog, Elementtyp und Level
- Feature-Auswahl, Pflichtfeatures und Level aus Features
- Einmal-pro-Programm-Features
- bei Kategorie: Sprunganzahl, erlaubte Sprünge, Pirouetten, Sequenzen,
Level-Grenzen, Pflichtelemente, Dauer, Wiederholungen und Kombinationen
- Basiswert, PCS-Annahme, Sturzabzug und geschätzte Summe
Nicht anwendbare Prüfungen nennen den Grund, z. B. „nicht anwendbar (keine
Features gesetzt)“. Warnungen blockieren Speichern und Export nicht.
## Punktschätzung und Annahmen
Die Schätzung besteht aus drei Teilen:
```text
Basiswert = Summe der Base Values
PCS-Annahme = Durchschnitt × 3 Komponenten × Kategorie-Faktor
Sturzabzug = Anzahl Stürze × Kategorie-Abzug
Geschätzte Summe = Basiswert + PCS-Annahme - Sturzabzug
```
### PCS-Annahme
PCS steht für **Program Component Score**. Im ISU-System bewerten die Judges
drei Komponenten:
- **Composition** – Aufbau, Muster, Musikbezug
- **Presentation** – Ausdruck, Energie, Musikalität
- **Skating Skills** – Kanten, Schritte, Kontrolle, Flow
Jede Komponente wird mit 0,25 bis 10,00 bewertet. Die drei Werte werden
summiert und mit dem Kategorie-Faktor multipliziert.
Die App kennt keine echten Judge-Werte und arbeitet deshalb mit **einem
Durchschnitt pro Komponente** (Startwert **5,00**). Das ist eine
Planungsannahme, kein Regelwert. Über **ⓘ Annahmen ändern** im Prüfdialog
lassen sich Durchschnitt und Sturzzahl anpassen; beides wird mit der Kür
gespeichert.
Beispiel Gold:
```text
5,00 × 3 × 2,67 = 40,05 PCS
Basiswert 9,50
Geschätzte Summe 49,55
```
### Was nicht enthalten ist
- **GOE** (Ausführungsqualität der Judges)
- **1,1-Faktor** für die zweite Programmhälfte
- nicht katalogisierte Kombinationen/Varianten
- die offizielle Wettkampfwertung
Die Schätzung ist eine Planungshilfe, keine vorhergesagte Punktzahl. Für eine
realistische PCS-Annahme helfen Protokolle früherer Wettkämpfe; der
Durchschnitt sollte zum aktuellen Leistungsstand passen, nicht zum Wunschziel.
## Grenzen
- Features und PCS sind Eingaben, keine Messungen aus der Zeichnung.
- Kombinationen werden für Prüfungen aus Freitext wie `3Lz+2T` geparst, noch
nicht strukturell modelliert.
- Max. zwei Features pro Fuß und Feature-Positionsregeln sind offen.
- Adult-spezifische Sonderfälle außerhalb des Announcements 2026/27 sind
nicht abgebildet.
## Quellen
- ISU Communication No. 2786 – Scale of Values 2026/27
- ISU Communication No. 2788 – Levels of Difficulty / GOE 2026/27
- IAFSC Technical Announcement 2026/27 (Adult-Wettbewerbe, Oberstdorf 2027)

View file

@ -136,6 +136,7 @@ Voraussetzung für Phase 1.
- [ ] Strukturierte Sprungkombinationen/-folgen statt Freitext-Parsing
- [x] Dauerprüfung gegen die Kategorie-Zeit
- [x] PCS und Sturzabzüge in der Punktschätzung (mit Annahmen)
- [x] In-App-Hilfe „Hilfe & Annahmen“ und `docs/manual.md`
- [ ] Optional: Suchfeld/Autovervollständigung aus `suggest()`
- [ ] Optional: GOE-Tabellen sowie `V`-/Unterrotationsvarianten