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:
parent
ef1a01d5b3
commit
e1f543cb66
10 changed files with 360 additions and 6 deletions
152
docs/manual.md
Normal file
152
docs/manual.md
Normal 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)
|
||||
Loading…
Add table
Add a link
Reference in a new issue