fix: Release-Härtung, JSON-Dateiformat und Quality-Meilenstein

- Export: Runtime-Bridge-Autoload und Skater-GLB samt Texturen einschließen, Editor-Addons ausschließen
- tools/check_export.sh als headless Smoke-Test; ./tools/test.sh --export
- RoutineFile: JSON-Format, atomare Saves, Whitelist für Legacy-.tres
- Überschreibschutz für Speichern unter/Export, Session- und Autosave-Restore
- Globaler Delete-Shortcut blockiert bei offenen Dialogen
- Sync akzeptiert .json und Legacy-.tres, Konfliktnamen behalten die Endung
- Tests für Dateiformat, Überschreiben, Session und Legacy-Schutz
- Quality-Meilenstein mit 'Als Nächstes' und 'Danach' in der Roadmap
This commit is contained in:
torsten 2026-11-03 23:48:01 +01:00
parent edf12a11c2
commit 7bbd8c9c1d
21 changed files with 1711 additions and 158 deletions

View file

@ -28,6 +28,7 @@ wird nicht weiterentwickelt. Phase 2 konsumiert später dasselbe Datenmodell
├── project.godot
├── src/
│ ├── core/model/ # reine Daten-Resources
│ ├── core/io/ # JSON-Dateiformat, Legacy-Import
│ ├── core/rules/ # ISU-Katalog (JSON + Lookup)
│ ├── presentation3d/ # 3D-Vorschau, lazy geladen
│ └── whiteboard/ # Phase 1: view / ctrl / io
@ -60,6 +61,7 @@ Implementiert in `rinkplanner/src/core/model/`:
| `RoutineSection` | chronologischer Block, Ghosting-Einheit, Segmentliste |
| `PathSegment` | Pfad mit Richtung, Kante, Dauer, Element-Marker, Sprungkombination und Label |
| `RinkDimensions` | Maße, Koordinaten, Punkte-/Kurvenprüfung |
| `RoutineFile` | JSON-Serialisierung, atomare Saves, Legacy-`.tres`-Import |
Implementiert in `rinkplanner/src/core/rules/`:
@ -423,31 +425,47 @@ ggf. eines nach `touchend` (300-ms-Guard).
`user://exports/`.
- **PDF** ist nicht nativ in Godot. Erste Stufe: Browser-Druck aus SVG;
eine echte PDF-Ausgabe ist ein separates Arbeitspaket.
- **Persistenz** erfolgt lokal als `.tres`-Ressourcen unter
`user://routines/`. `Routine.schema_version` (aktuell 2) schützt vor
inkompatiblen neueren Dateien; Schema-1-Dateien werden beim Laden migriert
und behalten ihre bisherige Dauer. Die Elementfelder kamen additiv mit
Defaults hinzu, deshalb bleibt das Schema bei 2. Benannte Kürläufe werden über das Datei-Menü gespeichert
und geladen; der Öffnen-Dialog nutzt 48-px-Buttons statt einer kleinen
Dateiliste.
- **Autosave** schreibt nach 1,5 s Inaktivität nach `user://autosave.tres`
und wird beim Start automatisch wiederhergestellt. Der Dirty-State wird im
Fenstertitel als `*` angezeigt. Beim Verlassen wird zusätzlich gespeichert.
- **Persistenz** erfolgt lokal als JSON unter `user://routines/`
(`RoutineFile`, Format `rinkplanner.routine`). Die Datei enthält
`schema_version` (aktuell 2); neuere Schemata werden abgelehnt,
Schema-1-Dateien beim Laden migriert. Die Elementfelder kamen additiv mit
Defaults hinzu, deshalb bleibt das Schema bei 2. Legacy-`.tres`-Dateien
bleiben lesbar: Vor `ResourceLoader.load` prüft `RoutineFile` eine
Whitelist (nur die vier Modellskripte, kein eingebettetes GDScript, keine
Szenen). Neue Speicherungen schreiben immer `.json`; eine geöffnete
`.tres` wird beim nächsten Speichern zur `.json`-Datei migriert.
Speichern läuft atomar über eine Temp-Datei mit `.bak`-Sicherung. Benannte
Kürläufe werden über das Datei-Menü gespeichert und geladen; der
Öffnen-Dialog zeigt `.json` und Legacy-`.tres`, wobei eine vorhandene
`.json` die gleichnamige `.tres` verdeckt.
- **Autosave** schreibt nach 1,5 s Inaktivität nur bei ungespeicherten
Änderungen nach `user://autosave.json`; beim Speichern oder Öffnen einer
Datei wird der Autosave entfernt. Der letzte Dateipfad liegt in
`user://session.cfg`. Beim Start wird der Autosave nur übernommen, wenn er
neuer als die zugehörige Datei ist; dann bleibt der Dateipfad erhalten und
die Kür ist als geändert markiert. Der Dirty-State wird im Fenstertitel als
`*` angezeigt. Beim Verlassen wird bei Änderungen zusätzlich gespeichert.
- **Überschreibschutz:** „Speichern unter“ und Export fragen nach, bevor eine
vorhandene Datei ersetzt wird.
- **Builds:** Linux, Windows, macOS und Android über
`tools/export_*.sh`; Presets in `rinkplanner/export_presets.cfg`.
Android nutzt das Template-Export-Verfahren ohne Gradle-Projekt,
`arm64-v8a`, `minSdk 24`, `targetSdk 36`, Landscape und Immersive Mode.
Details in `docs/builds.md`.
Der Export enthält die Skater-GLB (`assets/external/characters/*.glb`) und
den Runtime-Bridge-Autoload, aber keine Test-, Prototyp- oder
Editor-Addon-Skripte. `tools/check_export.sh` exportiert und startet den
Linux-Build headless als Smoke-Test. Details in `docs/builds.md`.
- **Lokale Daten:** `user://` liegt pro Plattform getrennt (Linux
`~/.local/share/godot/app_userdata/Rinkplanner/`, Android im
app-internen Speicher).
- **Kontosync:** manueller FTP-/FTPS-Abgleich der `.tres`-Dateien über
`FtpClient`, `SyncPlan` und `RoutineSync`; Details in `docs/sync.md`.
Zugangsdaten liegen in `user://sync.cfg`, der letzte gemeinsame Stand in
`user://sync_state.cfg`. Beim ersten Abgleich einer beidseitig vorhandenen
Datei übernimmt die Serverfassung den Namen, die lokale bleibt als
`(Lokal …)`-Kopie; bei einem echten Konflikt bleibt die lokale Fassung
Hauptdatei und die Serverfassung kommt als `(Server …)`-Kopie dazu.
- **Kontosync:** manueller FTP-/FTPS-Abgleich der `.json`- und
Legacy-`.tres`-Dateien über `FtpClient`, `SyncPlan` und `RoutineSync`;
Details in `docs/sync.md`. Zugangsdaten liegen in `user://sync.cfg`, der
letzte gemeinsame Stand in `user://sync_state.cfg`. Beim ersten Abgleich
einer beidseitig vorhandenen Datei übernimmt die Serverfassung den Namen,
die lokale bleibt als `(Lokal …)`-Kopie; bei einem echten Konflikt bleibt
die lokale Fassung Hauptdatei und die Serverfassung kommt als
`(Server …)`-Kopie dazu. Konfliktnamen behalten die jeweilige Endung.
## 7. Tests
@ -455,6 +473,8 @@ Headless, ohne Editor und ohne Display:
```bash
./tools/test.sh
# inklusive Export-Smoke-Test:
./tools/test.sh --export
```
Aktueller Stand:
@ -462,6 +482,10 @@ Aktueller Stand:
- **Model:** 100 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
Timing-Modi, Template-Metadaten, Element-Marker samt Kürzel-/Level-/Dauer-Grenzen,
Schema-Version, Section-Aggregation und Routine-Validierung.
- **Dateiformat:** 54 Assertions für JSON-Roundtrip (inkl. Kurven-Handles,
Elemente, Features, Kombinationen), Schema-/Enum-Fehler, atomare Saves und
die Legacy-`.tres`-Whitelist (eingebettetes GDScript und fremde Skripte
werden vor dem Laden abgelehnt).
- **Regelwerk:** 169 Assertions für Katalog-Metadaten, Saison/Quelle,
Sprung-/Pirouetten-/Sequenz-Base-Values, Level-Auflösung, Kürzel-Suffixe,
Case-Insensitivität, Vorschläge, Segment-Integration und fehlerhafte Kataloge.
@ -478,14 +502,16 @@ Aktueller Stand:
- **Adult-Kategorien:** 70 Assertions für Metadaten, Gold/Silver/Bronze,
Sprungerlaubnis, Level-Caps, Pflichtelemente, Wiederholungen, Kombinationen,
Dauer und unbekannte Kategorien.
- **Whiteboard:** 297 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 314 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
Feature-Hinweis, Feature-Menü, strukturierte Sprungkombinationen,
Verschieben, Löschen), Section-Verwaltung,
Ghosting-Zustand, Segment-Labels inklusive Dialog und Sichtbarkeits-Schalter,
Speichern/Laden, Schema-Prüfung, Dirty-State, Prüfdialog mit
Speichern/Laden, Schema-Prüfung, Dirty-State,
Überschreibschutz, Autosave-/Session-Wiederherstellung und den
Dialog-sicheren Delete-Shortcut, Prüfdialog mit
Punktschätzung und inline änderbaren Annahmen,
Navigationsmodus und den Maus-Drag-Pfad.
- **History:** 53 Assertions für Undo/Redo von Segmenten, Kanten, Labels, Sections,
@ -507,8 +533,9 @@ Aktueller Stand:
Leistenlayout bei 1024 und 1400 px.
- **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere
Redraw-Zeit muss unter 120 ms bleiben (aktuell ca. 7–10 ms).
- **Sync:** 32 Assertions für Vergleichsregeln, Konfliktnamen, Zeitstempel,
PASV/EPSV/MDTM-Parsing, Sync-Stand und die Einstellungs-Verdrahtung.
- **Sync:** 34 Assertions für Vergleichsregeln, Konfliktnamen (JSON und
Legacy-`.tres`), Zeitstempel, PASV/EPSV/MDTM-Parsing, Sync-Stand und die
Einstellungs-Verdrahtung.
Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft
(Upload, Download, Übernahme, Konflikt, Aufräumen).
- **3D-Assets:** 57 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
@ -523,8 +550,13 @@ Aktueller Stand:
--dry-run`), nicht in `./tools/test.sh`, weil Blender und ffmpeg
Host-Abhängigkeiten sind.
`tools/check_export.sh` baut zusätzlich den Linux-Release, startet ihn
headless und prüft auf Autoload-/Startfehler, ausgeschlossene Tests und die
Skater-GLB im Build.
Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
end-to-end geprüft.
end-to-end geprüft (neuer Autosave hängt am letzten Dateipfad, sauberes
Speichern entfernt ihn).
Visuelle Smoke-Tests laufen zusätzlich über `xvfb-run` und einen
Viewport-Screenshot; sie ersetzen die headless Tests nicht.