rinkplanner/docs/manual.md
torsten e1f543cb66 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
2026-10-31 11:43:34 +01:00

152 lines
5.6 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.

# 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)