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:
parent
edf12a11c2
commit
7bbd8c9c1d
21 changed files with 1711 additions and 158 deletions
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue