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:
torsten 2026-11-13 10:39:49 +01:00
parent e31e78d464
commit 386105aa71
40 changed files with 2716 additions and 77 deletions

View file

@ -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