feat: Regelwerk als Saisonordner mit Invariantenprüfung
Das ISU-Regelwerk liegt jetzt je Saison in einem eigenen Ordner mit Manifest. Der Code fragt nach Dokumentarten (sov, levels, adult) statt nach Dateinamen; eine neue Saison braucht kein GDScript. - Manifest je Saison mit Quellen, valid_from und deklarativen Policies. Fehlt eine Policy, gilt sie in dieser Saison nicht – alte Saisons erben keine später erfundenen Regeln. - RulesLibrary findet die Saisons per Verzeichnis-Scan, löst Vererbung für zeitversetzt erscheinende Papiere auf und wählt als Voreinstellung die neueste vollständige Saison ab valid_from. - RulesAudit prüft den Invariantenkatalog A–F (Sprungreihenfolge, Level- Schwellen, Adult-Grenzen, Policies) und läuft über tools/check_rules.sh sowie in ./tools/test.sh. - Saison an der Kür (Schema 7): alte Küren werden gegen das Regelwerk ihrer eigenen Saison geprüft. Die Statusleiste zeigt und wechselt die Saison; ohne Zuordnung prüft die App nichts, statt still gegen die falsche Saison zu rechnen. - Validator läuft pro Regelpaket; ein Saison-Paar-Test sichert die dokumentierte Differenz zwischen 2025/26 und 2026/27 ab. - PDF-Kopf nennt die Saison, docs/manual.md erklärt die Zuordnung, docs/isu-rules-structure.md beschreibt Struktur und Migrationsplan. 2025/26 hat noch keine Adult-Regeln; das Manifest markiert das Dokument als missing, die Prüfung meldet die Kategorie als nicht anwendbar.
This commit is contained in:
parent
e31e78d464
commit
386105aa71
40 changed files with 2716 additions and 77 deletions
|
|
@ -15,6 +15,10 @@ Quellen:
|
|||
|
||||
Anleitung und Annahmen für die Bedienung: `docs/manual.md`.
|
||||
|
||||
Die **geplante** Mehrsaison-Struktur (Saisonordner, Manifest, deklarative
|
||||
Policies, Saison-Upgrade-Prüfung) steht in `docs/isu-rules-structure.md`.
|
||||
Sie ist noch nicht umgesetzt; bis zur Migration gilt dieses Dokument.
|
||||
|
||||
## Zweck
|
||||
|
||||
Der Katalog liefert die Base Values (BV) zu Elementkürzeln und Leveln. Er ist
|
||||
|
|
@ -263,24 +267,23 @@ ein zweiter Klick blendet sie wieder aus.
|
|||
|
||||
## Neue Saison einpflegen
|
||||
|
||||
1. Neue ISU-Communication (Scale of Values) beschaffen und als JSON nach dem
|
||||
obigen Schema anlegen, z. B. `isu_sov_2027_28.json`.
|
||||
2. `season`, `valid_from` und `source` aktualisieren.
|
||||
3. `ElementCatalog.DEFAULT_PATH` auf die neue Datei zeigen lassen.
|
||||
4. Stichproben in `tests/run_rules_tests.gd` auf die neuen Werte anpassen
|
||||
(mindestens ein Sprung, eine Pirouette, eine Sequenz).
|
||||
5. Neue Level-Communication (Levels of Difficulty) als
|
||||
`isu_levels_2027_28.json` anlegen, `ElementLevelRules.DEFAULT_PATH`
|
||||
umstellen und `tests/run_level_tests.gd` anpassen.
|
||||
6. Adult-Announcement der Saison als `isu_adult_2027_28.json` anlegen,
|
||||
`AdultCategoryRules.DEFAULT_PATH` umstellen und
|
||||
`tests/run_adult_tests.gd` anpassen.
|
||||
7. `./tools/test.sh` ausführen.
|
||||
8. Die alte Datei kann für Nachvollziehbarkeit im Repo bleiben; aktiv ist
|
||||
immer genau eine Datei pro Regelart.
|
||||
Die Saison ist ein Ordner unter `rinkplanner/src/core/rules/data/`. Die
|
||||
verbindliche Struktur, das Manifest-Schema und der Invariantenkatalog stehen in
|
||||
`docs/isu-rules-structure.md`. Kurzfassung:
|
||||
|
||||
Die JSON-Dateien werden über `include_filter="*.json"` in allen Export-Presets
|
||||
mit ausgeliefert.
|
||||
1. Ordner `2027-28/` anlegen und `manifest.json` schreiben (`season`,
|
||||
`valid_from`, `replaces`, Dokumente mit Quelle). Fehlende Papiere als
|
||||
`inherit_from` eintragen, `status` bleibt dann `partial`.
|
||||
2. `sov.json`, `levels.json` und `adult.json` nach dem obigen Schema anlegen.
|
||||
Die drei Dateien dürfen zu verschiedenen Terminen entstehen.
|
||||
3. `notes.md` mit den Änderungen gegenüber der Vorsaison füllen.
|
||||
4. `./tools/test.sh` (enthält `./tools/check_rules.sh`).
|
||||
5. Sobald alle Papiere da sind: `inherit_from` durch `file` ersetzen,
|
||||
`status: complete`.
|
||||
|
||||
GDScript muss dafür nicht angefasst werden; die App findet die Saison über das
|
||||
Manifest. Die JSON-Dateien werden über `include_filter="*.json"` in allen
|
||||
Export-Presets mit ausgeliefert.
|
||||
|
||||
## Nächste Ausbaustufen
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue