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.
|
||||
|
|
|
|||
|
|
@ -179,10 +179,12 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
|||
|
||||
- `assets/external/` ist gitignored und wird nach dem Sync importiert.
|
||||
- `asset_manifest.json` wird über `include_filter="*.json"` mit exportiert.
|
||||
- Die aktuellen Phase-1-Export-Presets schließen `assets/external/*` aus.
|
||||
Für einen 3D-Build muss bewusst ein eigenes Preset die Dateien einschließen.
|
||||
Desktop kann die GLB einbetten; für Android sind 1K-Texturen oder ein
|
||||
separater Asset-Pack vorgesehen.
|
||||
- Die Export-Presets schließen Test- und Gewichts-Assets
|
||||
(`weights_rings*`) sowie `assets/models/*` aus, nehmen aber die
|
||||
Skater-GLB samt ihren Quelltexturen
|
||||
(`assets/external/characters/skater_figure_glide_v006*`) mit. Fehlt die
|
||||
GLB auf einem frischen Checkout, baut `Skater3D` weiterhin den Platzhalter;
|
||||
`tools/check_export.sh` weist darauf hin und prüft die Texturen im Build.
|
||||
- Phase 1 bleibt unberührt: Der 2D-Code lädt keine 3D-Ressourcen.
|
||||
|
||||
## Aktueller Bestand
|
||||
|
|
|
|||
|
|
@ -9,17 +9,22 @@ nicht von Browser-Speicherlimits abhängt.
|
|||
|
||||
| Ziel | Preset | Ausgabe | Größe (ca.) |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| Linux x86_64 | `Linux` | `build/linux/rinkplanner.x86_64` | 77 MB |
|
||||
| Windows x86_64 | `Windows` | `build/windows/rinkplanner.exe` | 113 MB |
|
||||
| macOS universal | `macOS` | `build/macos/rinkplanner.zip` | 64 MB |
|
||||
| Android arm64 | `Android` | `build/android/rinkplanner-debug.apk` | 28 MB |
|
||||
| Linux x86_64 | `Linux` | `build/linux/rinkplanner.x86_64` | 80 MB |
|
||||
| Windows x86_64 | `Windows` | `build/windows/rinkplanner.exe` | 116 MB |
|
||||
| macOS universal | `macOS` | `build/macos/rinkplanner.zip` | 67 MB |
|
||||
| Android arm64 | `Android` | `build/android/rinkplanner-debug.apk` | 31 MB |
|
||||
|
||||
Die PCK ist bei Linux und Windows **eingebettet** (eine Datei zum
|
||||
Weitergeben). `build/` ist nicht versioniert.
|
||||
Weitergeben). `build/` ist nicht versioniert. Seit die Skater-GLB samt
|
||||
Texturen in den Exporten liegt (`docs/assets.md`), sind die Builds etwa
|
||||
6 MB größer; die Werte sind Richtwerte.
|
||||
|
||||
## Voraussetzungen
|
||||
|
||||
- Godot **4.7.2** (oder `GODOT=/pfad/zu/godot` setzen)
|
||||
- Für die 3D-Vorschau im Build: `tools/sync_assets.sh --sync` (GLB plus
|
||||
Texturen unter `assets/external/characters/`); ohne diese Dateien baut der
|
||||
Export den Platzhalter.
|
||||
- Export-Templates derselben Version unter
|
||||
`~/.local/share/godot/export_templates/4.7.2.stable/`
|
||||
- Für Android zusätzlich JDK 17 + Android SDK (siehe unten)
|
||||
|
|
@ -148,16 +153,34 @@ Godot schreibt `user://` pro Plattform getrennt:
|
|||
| macOS | `~/Library/Application Support/Godot/app_userdata/Rinkplanner/` |
|
||||
| Android | App-interner Speicher (`/data/data/de.rinkplanner.app/files/`) |
|
||||
|
||||
Dort liegen `routines/`, `autosave.tres` und `exports/`. Die Android-Daten
|
||||
Dort liegen `routines/`, `autosave.json` und `exports/`. Die Android-Daten
|
||||
sind ohne Root nicht direkt sichtbar – der Export-Dialog der App schreibt
|
||||
nach `user://exports/`, von dort kann man Dateien über einen Dateimanager
|
||||
mit App-Zugriff oder `adb pull` holen:
|
||||
|
||||
```bash
|
||||
adb shell run-as de.rinkplanner.app ls files/
|
||||
adb exec-out run-as de.rinkplanner.app cat files/routines/kuer.tres > kuer.tres
|
||||
adb exec-out run-as de.rinkplanner.app cat files/routines/kuer.json > kuer.json
|
||||
```
|
||||
|
||||
## Export-Smoke-Test
|
||||
|
||||
`tools/check_export.sh` baut den Linux-Release in ein temporäres Verzeichnis,
|
||||
startet ihn headless und bricht bei Start-/Autoload-Fehlern ab. Zusätzlich
|
||||
prüft es, dass keine Testskripte im Build landen und die Skater-Szene samt
|
||||
Texturen enthalten ist, sofern die GLB lokal unter
|
||||
`assets/external/characters/` liegt.
|
||||
|
||||
```bash
|
||||
./tools/check_export.sh
|
||||
# oder zusammen mit den Headless-Tests:
|
||||
./tools/test.sh --export
|
||||
```
|
||||
|
||||
Fehlt die GLB auf einem frischen Checkout, bricht der Test mit einem Hinweis
|
||||
auf `tools/sync_assets.sh --sync` ab. Für einen reinen Starttest ohne
|
||||
3D-Asset: `./tools/check_export.sh --allow-placeholder`.
|
||||
|
||||
## Bekannte Grenzen
|
||||
|
||||
- Die obere Werkzeugleiste hat eine Mindestbreite von ca. 994 logischen
|
||||
|
|
@ -175,9 +198,9 @@ adb exec-out run-as de.rinkplanner.app cat files/routines/kuer.tres > kuer.tres
|
|||
Der Debug-Keystore ist nur zum Testen.
|
||||
- **Windows/macOS:** siehe Hinweise oben (rcedit, Codesign/Notarization).
|
||||
|
||||
## Nächster Schritt: Kontosync
|
||||
## Kontosync
|
||||
|
||||
Geplant ist ein manueller Sync über FTP: Ein Button lädt die neuesten
|
||||
`.tres`-Dateien je Kür hoch bzw. herunter, Konflikte bleiben als Kopien mit
|
||||
Zeitstempel erhalten. Zugangsdaten liegen in den App-Einstellungen
|
||||
(`user://`), nicht im Repository.
|
||||
Der manuelle Sync über FTP lädt die neuesten `.json`-Dateien
|
||||
(Legacy-`.tres` weiterhin) je Kür hoch bzw. herunter, Konflikte bleiben als
|
||||
Kopien mit Zeitstempel erhalten. Zugangsdaten liegen in den
|
||||
App-Einstellungen (`user://`), nicht im Repository.
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# Rinkplanner – Roadmap
|
||||
|
||||
Stand: 2026-11-01 (ISU 2026/27, Adult-Kategorien Gold/Silver/Bronze; Sync-Komfort und UI-Refactoring zurückgestellt)
|
||||
Stand: 2026-11-03 (ISU 2026/27, Adult-Kategorien Gold/Silver/Bronze; JSON-Dateiformat, Export-Smoke-Test und Quality-Meilenstein ergänzt)
|
||||
Diese Reihenfolge ist die verbindliche Arbeitsgrundlage für Phase 1. Änderungen
|
||||
nur bewusst und nach Rücksprache. Letzte Erkenntnisse:
|
||||
`docs/findings-2026-10-31-arm-gewichte.md`.
|
||||
|
|
@ -25,7 +25,8 @@ Voraussetzung für Phase 1.
|
|||
- [x] Segment löschen, Undo/Redo mit Snapshot-Historie
|
||||
- [x] Sections anlegen, umbenennen, löschen, sortieren
|
||||
- [x] Ghosting inaktiver Sections mit 20 % Deckkraft
|
||||
- [x] Speichern/Laden als `.tres`, Schema-Prüfung, Autosave und Restore
|
||||
- [x] Speichern/Laden als JSON, Schema-Prüfung, atomare Saves, Autosave und
|
||||
Session-Restore (Legacy-`.tres` lesbar)
|
||||
- [x] Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und
|
||||
Geschwindigkeit 0,25×–2,0×
|
||||
- [x] Geschwindigkeits-Arbeitsannahmen in `docs/speed-assumptions.md`
|
||||
|
|
@ -86,7 +87,8 @@ Voraussetzung für Phase 1.
|
|||
|
||||
- [x] Sync-Einstellungen in der App (FTP-Host, Port, Benutzer, Passwort,
|
||||
Verzeichnis, FTPS, Zertifikatsprüfung), Zugangsdaten unter `user://`
|
||||
- [x] Manueller Sync: `.tres` je Kür laden/hochladen, Sync-Stand lokal
|
||||
- [x] Manueller Sync: `.json` je Kür laden/hochladen (Legacy-`.tres` weiterhin),
|
||||
Sync-Stand lokal
|
||||
- [x] Konflikte als Kopien mit Server-Zeitstempel behalten
|
||||
- [x] Fortschritt und Zusammenfassung in der Oberfläche
|
||||
- [x] FTP/FTPS-Client ohne externe Bibliothek
|
||||
|
|
@ -174,12 +176,66 @@ UI-Refactoring sind zurückgestellt, weil der bestehende Stand für Tests
|
|||
genügt und die endgültige Sync-Architektur (PHP-Webserver) sowie das
|
||||
UI-Feedback der Tester ohnehin noch ausstehen.
|
||||
|
||||
## Quality-Meilenstein
|
||||
|
||||
Stand: 2026-11-03. Ziel: den PoC release- und wartbar machen, ohne die
|
||||
fachliche Roadmap zu blockieren. Die Sofortmaßnahmen aus der
|
||||
Projekt-Durchsicht sind umgesetzt; die folgenden Punkte sind die nächsten
|
||||
Schritte.
|
||||
|
||||
### Erledigt: Sofortmaßnahmen (2026-11-03)
|
||||
|
||||
- [x] Export startet ohne Autoload-/Startfehler; der Runtime-Bridge-Autoload
|
||||
ist im Export enthalten, Editor-Addons bleiben draußen.
|
||||
- [x] 3D-Skater in Desktop-/Android-Exporten: GLB plus Quelltexturen sind
|
||||
eingeschlossen; `tools/check_export.sh` prüft den headless Start, das
|
||||
Fehlen von Testskripten und die Texturen.
|
||||
- [x] Kürdateien als JSON (`RoutineFile`, `rinkplanner.routine`, Limits,
|
||||
Schema-Prüfung). Legacy-`.tres` bleibt lesbar, wird aber vor
|
||||
`ResourceLoader.load` per Whitelist geprüft (kein eingebettetes GDScript,
|
||||
nur Modellskripte).
|
||||
- [x] Atomare Saves über Temp + `.bak`, Überschreibschutz für
|
||||
„Speichern unter“ und Export, letzter Pfad in `user://session.cfg`;
|
||||
Autosave wird beim Start nur bei neueren Änderungen übernommen und bleibt
|
||||
am letzten Dateipfad.
|
||||
- [x] Entf/Backspace löscht nicht mehr durch offene Dialoge (modal guard).
|
||||
|
||||
### Als Nächstes
|
||||
|
||||
- [ ] `WhiteboardController` in Services/Panels zerlegen: Datei-I/O, Sync,
|
||||
Playback, Validierung, Element-Inspector, Section-Liste. Ziel: < 1.500
|
||||
Zeilen pro Datei, keine 100 `%`-Lookups in einem Skript.
|
||||
- [ ] Gemeinsamer Test-Harness (oder gdUnit4), Timeout pro Testlauf,
|
||||
Coverage; CI auf dem Gitea-/Forgejo-Remote mit `tools/test.sh` und
|
||||
`tools/check_export.sh`.
|
||||
- [ ] Saison datengetrieben: Saison-Auswahl/Default aus `data/`, 2025/26
|
||||
auswählbar machen oder entfernen; Regelstand im UI anzeigen.
|
||||
- [ ] Android-Export teilen: Share-Intent/SAF statt nur `user://exports/`.
|
||||
- [ ] `Ctrl+S`/`Ctrl+O`/`Ctrl+N` und sichtbarer Speicherstatus (auch ohne
|
||||
Fenstertitel auf Android).
|
||||
|
||||
### Danach
|
||||
|
||||
- [ ] Theme-Ressource + zentrale UI-Texte (`tr()`/CSV), kompakte Labels nicht
|
||||
mehr im Controller; Dark/Light und skalierbare Schriftgrößen.
|
||||
- [ ] Canvas: Culling/Dirty-Regions, Kurven-Cache auch für Pan/Zoom;
|
||||
Perf-Test mit realistischem Budget (< 16 ms bei 480 Segmenten).
|
||||
- [ ] Doku konsolidieren: 18 `findings-*.md` nach `docs/notes/` oder ins
|
||||
Archiv; Architektur/Manual als aktuelle Quellen; Docstrings und
|
||||
Assertion-Zahlen pflegen.
|
||||
- [ ] Altlasten entfernen: `Flieger.obj` (nur Prototyp), alte
|
||||
`.godot`-Importe, eingefrorenen Prototyp; `.gitattributes` um Binärregeln
|
||||
ergänzen.
|
||||
- [ ] Release: Lizenz, Changelog, Version aus einer Quelle, signierte
|
||||
macOS-/Android-Builds.
|
||||
|
||||
## Querschnittsaufgaben
|
||||
|
||||
- [ ] Tests bei jedem Feature erweitern; `./tools/test.sh` bleibt grün
|
||||
- [ ] MCP gezielt für Editor-/Runtime-Verifikation nutzen, sobald der Editor
|
||||
mit dem richtigen Projektpfad läuft
|
||||
- [ ] Persistenz-Backups und Dateiverwaltung prüfen
|
||||
- [x] Persistenz-Backups und Dateiverwaltung prüfen (atomare Saves,
|
||||
`.bak`-Sicherung, Autosave-/Session-Regeln)
|
||||
- [ ] Architektur- und Geschwindigkeitsdokumentation aktuell halten
|
||||
|
||||
## Phase 2 – 3D-Präsentation
|
||||
|
|
|
|||
21
docs/sync.md
21
docs/sync.md
|
|
@ -23,8 +23,12 @@ Danach **Datei → Jetzt synchronisieren**.
|
|||
|
||||
## Was passiert
|
||||
|
||||
- Jede Kür liegt als `.tres` unter `user://routines/` und wird 1:1 in das
|
||||
FTP-Verzeichnis gespiegelt (flach, keine Unterordner).
|
||||
- Jede Kür liegt als `.json` unter `user://routines/` und wird 1:1 in das
|
||||
FTP-Verzeichnis gespiegelt (flach, keine Unterordner). Legacy-`.tres`-
|
||||
Dateien werden weiterhin mit synchronisiert, damit bestehende Installationen
|
||||
ihre Serverkopien nicht verlieren; neue Speicherungen schreiben `.json`.
|
||||
Beim Laden wird eine `.tres` vor dem `ResourceLoader` gegen eine Whitelist
|
||||
geprüft (nur Modellskripte, kein eingebettetes GDScript).
|
||||
- Der Sync vergleicht pro Datei den letzten gemeinsamen Stand
|
||||
(`user://sync_state.cfg`) mit den aktuellen Zeitstempeln:
|
||||
|
||||
|
|
@ -50,17 +54,19 @@ kein „Update“, sondern eine Kollision:
|
|||
|
||||
- **Erster Sync einer Datei auf beiden Seiten** (kein gemeinsamer Stand):
|
||||
Die **Serverfassung übernimmt den Namen**, die lokale Fassung bleibt als
|
||||
`name (Lokal JJJJ-MM-TT HHMM).tres` daneben. So bekommt ein neues Gerät die
|
||||
`name (Lokal JJJJ-MM-TT HHMM).json` daneben. So bekommt ein neues Gerät die
|
||||
gemeinsame Version, ohne die lokale Arbeit zu verlieren.
|
||||
- **Beide Seiten seit dem letzten Sync geändert**: Die lokale Fassung bleibt
|
||||
Hauptdatei, die Serverfassung kommt als
|
||||
`name (Server JJJJ-MM-TT HHMM).tres` dazu. Beim nächsten Sync wird diese
|
||||
`name (Server JJJJ-MM-TT HHMM).json` dazu. Beim nächsten Sync wird diese
|
||||
Kopie als neue Kür hochgeladen. Zusammenführen musst du selbst.
|
||||
Die Kopien behalten die Endung der Ausgangsdatei; bei Legacy-`.tres`
|
||||
entstehen also weiterhin `.tres`-Kopien.
|
||||
|
||||
Wenn du auf dem Tablet also eine leere „Testkür1“ anlegst, obwohl es die
|
||||
Desktop-Version schon gibt, hast du nach dem Sync zwei Dateien: die
|
||||
Desktop-Version unter dem normalen Namen und deine leere Fassung als
|
||||
`testkür1 (Lokal …).tres`. Besser: erst synchronisieren, dann die vorhandene
|
||||
`testkür1 (Lokal …).json`. Besser: erst synchronisieren, dann die vorhandene
|
||||
Kür öffnen und bearbeiten.
|
||||
- Vor dem Sync wird eine geänderte, bereits gespeicherte Kür automatisch
|
||||
gespeichert. Eine noch nie gespeicherte Kür öffnet zuerst „Speichern unter“.
|
||||
|
|
@ -82,6 +88,11 @@ Kür öffnen und bearbeiten.
|
|||
- Uploads gehen zuerst nach `name.uploading` und werden dann umbenannt
|
||||
(falls der Server das verweigert: direkter Upload).
|
||||
- Downloads landen in `name.part` und ersetzen die Zieldatei erst danach.
|
||||
- Heruntergeladene `.json`-Dateien werden als JSON validiert; Legacy-`.tres`
|
||||
laufen vor dem Laden durch die Whitelist in `RoutineFile`. Ein präparierter
|
||||
Server kann damit keine eingebetteten GDScripts ausführen.
|
||||
- Neue Speicherungen sind JSON; der Sync akzeptiert weiterhin `.tres`, damit
|
||||
bestehende Dateien auf Server und Tablet nicht verschwinden.
|
||||
- Zugangsdaten liegen in `user://sync.cfg` (Klartext, app-privat). Auf
|
||||
Android ist das der interne App-Speicher, auf dem Desktop
|
||||
`~/.local/share/godot/app_userdata/Rinkplanner/`.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue