feat: FTP-Spiegel fuer externe 3D-Assets
- --publish laedt Workbench-Dateien per FTPS hoch und verifiziert sie durch Rueckdownload und SHA-256 - --sync laedt fehlende Assets vom Server, wenn die Workbench fehlt - Manifest um remote-Pfad ergaenzt, Manifest-Test auf 53 Assertions - Doku, Architektur (D13) und Roadmap aktualisiert
This commit is contained in:
parent
8861cbae92
commit
697274ce1b
7 changed files with 494 additions and 104 deletions
|
|
@ -3,8 +3,8 @@
|
|||
Stand: 2026-10-31
|
||||
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
|
||||
Übergeordnete Reihenfolge: `docs/roadmap.md`
|
||||
Letzte Session: `docs/findings-2026-10-31-arp-rig.md`
|
||||
(Session davor: `docs/findings-2026-10-31-sprungkombinationen.md`)
|
||||
Letzte Session: `docs/findings-2026-10-31-asset-ftp.md`
|
||||
(Session davor: `docs/findings-2026-10-31-arp-rig.md`)
|
||||
|
||||
## 1. Leitentscheidung
|
||||
|
||||
|
|
@ -182,6 +182,10 @@ den Godot-Import an. Damit bleiben Checkout und Build klein, während die
|
|||
Arbeitsdateien versioniert und reproduzierbar bleiben. Phase 1 lädt keine
|
||||
3D-Ressourcen; die Pipeline ist Vorbereitung für Phase 2. Details:
|
||||
`docs/assets.md`.
|
||||
Für Rechner ohne Workbench spiegelt `tools/sync_assets.sh --publish` die
|
||||
Dateien zusätzlich auf den bestehenden FTP-Server der Kür-Synchronisation;
|
||||
`--sync` lädt sie bei Bedarf und prüft sie gegen den Manifest-Hash. Der
|
||||
FTP-Spiegel ist eine Verteilungskopie, keine zweite Quelle der Wahrheit.
|
||||
|
||||
## 4. View- und Controller-Grenzen
|
||||
|
||||
|
|
@ -452,9 +456,9 @@ Aktueller Stand:
|
|||
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:** 48 Assertions für Manifest-Schema, Pfade, Platzierung,
|
||||
Rig-Metadaten, Hashes und – falls synchronisiert – Größe und SHA-256 der
|
||||
GLB-Datei.
|
||||
- **3D-Assets:** 53 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
|
||||
Platzierung, Rig-Metadaten, Hashes und – falls synchronisiert – Größe und
|
||||
SHA-256 der GLB-Datei.
|
||||
|
||||
Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
|
||||
end-to-end geprüft.
|
||||
|
|
|
|||
|
|
@ -37,27 +37,88 @@ tools/sync_assets.sh
|
|||
`library/` legen (`..._v001.glb`, `..._v002.glb`).
|
||||
3. Die bearbeitbare Quelle (`.blend`, Rig, Referenzvideo) nach `source/`.
|
||||
4. Eintrag in `rinkplanner/assets/asset_manifest.json` ergänzen:
|
||||
ID, Quelle, Ziel, SHA-256, Größe, Platzierung, Rig, Animationen.
|
||||
ID, Quelle, Ziel, FTP-Pfad, SHA-256, Größe, Platzierung, Rig, Animationen.
|
||||
5. `./tools/sync_assets.sh --sync` kopiert und importiert.
|
||||
6. Vor dem Commit `./tools/sync_assets.sh --check` laufen lassen.
|
||||
6. Bei geänderter Datei `./tools/sync_assets.sh --publish` für den Spiegel.
|
||||
7. Vor dem Commit `./tools/sync_assets.sh --check` laufen lassen.
|
||||
|
||||
### Befehle
|
||||
|
||||
```bash
|
||||
./tools/sync_assets.sh --check # Standard: nur prüfen
|
||||
./tools/sync_assets.sh --sync # fehlende Dateien kopieren + Godot-Import
|
||||
./tools/sync_assets.sh --check # Standard: nur lokal prüfen
|
||||
./tools/sync_assets.sh --sync # kopieren/laden + Godot-Import
|
||||
./tools/sync_assets.sh --sync --force # abweichendes Ziel überschreiben
|
||||
./tools/sync_assets.sh --publish # Workbench-Dateien auf den FTP-Spiegel laden
|
||||
```
|
||||
|
||||
Umgebungsvariablen:
|
||||
`--sync` arbeitet in dieser Reihenfolge:
|
||||
|
||||
1. Ziel in `assets/external/` ist vorhanden und hat den Manifest-Hash → OK.
|
||||
2. Workbench-Quelle ist vorhanden → kopieren.
|
||||
3. Sonst vom FTP-Spiegel laden.
|
||||
|
||||
Damit funktioniert ein frischer Checkout auf einem Rechner ohne
|
||||
Workbench-Archiv, sofern die FTP-Zugangsdaten vorliegen.
|
||||
|
||||
### FTP-Spiegel
|
||||
|
||||
Der vorhandene FTP-Server der Kür-Synchronisation dient als
|
||||
Verteilungskopie. Die Dateien liegen dort unterhalb des App-Verzeichnisses:
|
||||
|
||||
```
|
||||
<FTP_DIRECTORY>/assets/<remote>
|
||||
# z. B. rinkplanner/assets/characters/skater_figure_rigged_deform_v002.glb
|
||||
```
|
||||
|
||||
`FTP_DIRECTORY` ist das Verzeichnis aus `docs/credentials.txt` (aktuell
|
||||
`rinkplanner`). Der Unterordner `assets` wird beim ersten Upload automatisch
|
||||
angelegt (`--ftp-create-dirs`).
|
||||
|
||||
Zugangsdaten kommen aus `docs/credentials.txt` (gitignored) oder aus
|
||||
`RINKPLANNER_FTP_*`-Umgebungsvariablen. Das Format ist dasselbe wie für die
|
||||
App:
|
||||
|
||||
```
|
||||
FTP_URL=<host>
|
||||
FTP_USER=<benutzer>
|
||||
FTP_PASSWORD=<passwort>
|
||||
FTP_DIRECTORY=rinkplanner
|
||||
```
|
||||
|
||||
Optional:
|
||||
|
||||
| Schlüssel | Bedeutung |
|
||||
| :--- | :--- |
|
||||
| `FTP_ASSET_DIRECTORY` | überschreibt `<FTP_DIRECTORY>/assets` |
|
||||
| `FTP_VERIFY=1` | TLS-Zertifikat prüfen (Standard: 0) |
|
||||
|
||||
Der Server verwendet explizites FTPS (`AUTH TLS`, Port 21). Sein Zertifikat
|
||||
hat keinen passenden Hostnamen, deshalb ist die Prüfung standardmäßig aus.
|
||||
Die Integrität hängt nicht am Zertifikat, sondern am SHA-256 aus dem
|
||||
Manifest: Nach jedem Upload wird die Datei zurückgeladen und gehasht; nach
|
||||
jedem Download wird vor dem Verschieben gehasht.
|
||||
|
||||
`--publish` ist bewusst ein eigener Befehl. Ein normaler `--sync` lädt nichts
|
||||
hoch und überschreibt keine Serverdatei.
|
||||
|
||||
Auf einem neuen Rechner:
|
||||
|
||||
```bash
|
||||
cp /pfad/zu/credentials.txt docs/credentials.txt
|
||||
./tools/sync_assets.sh --sync
|
||||
```
|
||||
|
||||
Weitere Umgebungsvariablen:
|
||||
|
||||
| Variable | Standard | Zweck |
|
||||
| :--- | :--- | :--- |
|
||||
| `RINKPLANNER_WORKBENCH` | `~/Documents/workbench_rinkplanner` | Archivpfad |
|
||||
| `RINKPLANNER_CREDENTIALS` | `<repo>/docs/credentials.txt` | FTP-Konfiguration |
|
||||
| `GODOT` | `/opt/godot/Godot_v4.7.2-stable_linux.x86_64` | Import-Binary |
|
||||
|
||||
Das Skript prüft **Quelle und Ziel** gegen den Hash aus dem Manifest. Eine
|
||||
still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
||||
Das Skript prüft beim Kopieren, Laden und Veröffentlichen die jeweilige
|
||||
Datei gegen den Hash aus dem Manifest. `--check` prüft nur das lokale Ziel;
|
||||
eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
||||
|
||||
## Manifest
|
||||
|
||||
|
|
@ -69,6 +130,7 @@ still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
|||
"format": "glb",
|
||||
"source": "library/characters/skater_figure_rigged_deform_v002.glb",
|
||||
"target": "assets/external/characters/skater_figure_rigged_deform_v002.glb",
|
||||
"remote": "characters/skater_figure_rigged_deform_v002.glb",
|
||||
"sha256": "1c1f0646…",
|
||||
"bytes": 8345424,
|
||||
"source_scene": "source/characters/skater/skater_rig_v002.blend",
|
||||
|
|
@ -95,6 +157,7 @@ still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
|||
| `version` | Zähler der kuratierten Fassung |
|
||||
| `source` | Pfad relativ zum Workbench-Archiv |
|
||||
| `target` | Pfad relativ zum Godot-Projekt, immer unter `assets/external/` |
|
||||
| `remote` | Pfad relativ zum FTP-Asset-Verzeichnis |
|
||||
| `sha256` / `bytes` | Integritätsprüfung |
|
||||
| `source_scene` | bearbeitbare Quelle (`.blend`) für Rig/Animation |
|
||||
| `placement` | Up-Achse, Blickrichtung, Pivot und Höhe für die 3D-Szene |
|
||||
|
|
@ -155,6 +218,7 @@ Details und Messwerte: `docs/findings-2026-10-31-arp-rig.md`.
|
|||
|
||||
## Tests
|
||||
|
||||
`tests/run_asset_manifest_tests.gd` prüft Schema, Pfade, Hashes und – falls
|
||||
synchronisiert – Größe und SHA-256 der Zieldatei. Fehlt das Asset (z. B. in
|
||||
CI), wird der Dateicheck übersprungen, der Schema-Test bleibt aktiv.
|
||||
`tests/run_asset_manifest_tests.gd` prüft Schema, Pfade, FTP-Pfade, Hashes
|
||||
und – falls synchronisiert – Größe und SHA-256 der Zieldatei. Fehlt das
|
||||
Asset (z. B. in CI), wird der Dateicheck übersprungen, der Schema-Test bleibt
|
||||
aktiv. Aktuell: 53 Assertions.
|
||||
|
|
|
|||
107
docs/findings-2026-10-31-asset-ftp.md
Normal file
107
docs/findings-2026-10-31-asset-ftp.md
Normal file
|
|
@ -0,0 +1,107 @@
|
|||
# Findings 2026-10-31 – FTP-Spiegel für externe Assets
|
||||
|
||||
## Problem
|
||||
|
||||
Ein frischer Checkout auf einem anderen Rechner hat kein
|
||||
Workbench-Archiv und damit keine 3D-Modelle. `assets/external/` ist
|
||||
gitignored, der Rig und die GLB fehlen.
|
||||
|
||||
## Lösung
|
||||
|
||||
Der vorhandene FTP-Server der Kür-Synchronisation dient zusätzlich als
|
||||
Verteilungskopie für die 3D-Assets. Das Repo bleibt die Quelle der Wahrheit
|
||||
für IDs und Hashes; der Workbench bleibt die Quelle für die Bearbeitung.
|
||||
|
||||
```
|
||||
FTP-Server
|
||||
└── rinkplanner/ # FTP_DIRECTORY aus credentials.txt
|
||||
├── ... # Kür-Dateien
|
||||
└── assets/
|
||||
└── characters/
|
||||
└── skater_figure_rigged_deform_v002.glb
|
||||
```
|
||||
|
||||
`FTP_ASSET_DIRECTORY` ist standardmäßig `<FTP_DIRECTORY>/assets` und kann
|
||||
überschrieben werden. Beim ersten Upload legt curl die Ordner an.
|
||||
|
||||
## Ablauf
|
||||
|
||||
### Veröffentlichen
|
||||
|
||||
```bash
|
||||
./tools/sync_assets.sh --publish
|
||||
```
|
||||
|
||||
1. Quelle gegen den Manifest-Hash prüfen.
|
||||
2. Datei per explizitem FTPS hochladen (`AUTH TLS`, Port 21).
|
||||
3. Datei zurückladen, Größe und SHA-256 prüfen.
|
||||
4. Erst dann „OK".
|
||||
|
||||
`--publish` ist ein eigener Befehl; ein normaler `--sync` lädt nichts hoch.
|
||||
|
||||
### Auf einem Rechner ohne Workbench
|
||||
|
||||
```bash
|
||||
cp /pfad/zu/credentials.txt docs/credentials.txt
|
||||
./tools/sync_assets.sh --sync
|
||||
```
|
||||
|
||||
`--sync` prüft in dieser Reihenfolge:
|
||||
|
||||
1. Ziel in `assets/external/` vorhanden und Hash korrekt → OK.
|
||||
2. Workbench-Quelle vorhanden → kopieren.
|
||||
3. Sonst FTP-Download nach temporärer Datei, Hash prüfen, verschieben,
|
||||
Godot-Import anstoßen.
|
||||
|
||||
## Zugangsdaten
|
||||
|
||||
`docs/credentials.txt` (gitignored) mit den bestehenden Schlüsseln:
|
||||
|
||||
```
|
||||
FTP_URL=<host>
|
||||
FTP_USER=<benutzer>
|
||||
FTP_PASSWORD=<passwort>
|
||||
FTP_DIRECTORY=rinkplanner
|
||||
```
|
||||
|
||||
Optional `FTP_ASSET_DIRECTORY` und `FTP_VERIFY=1`. Alternativ
|
||||
`RINKPLANNER_FTP_*`-Umgebungsvariablen.
|
||||
|
||||
## Sicherheit und Integrität
|
||||
|
||||
- Der Server nutzt explizites FTPS. Sein Zertifikat hat keinen passenden
|
||||
Hostnamen; die Prüfung ist deshalb standardmäßig aus (`FTP_VERIFY=0`).
|
||||
- Der Vertrauensanker ist nicht das Zertifikat, sondern der SHA-256 aus
|
||||
`asset_manifest.json`. Jeder Upload wird zurückgelesen und gehasht, jeder
|
||||
Download vor dem Verschieben geprüft.
|
||||
- Zugangsdaten liegen ausschließlich in der gitignorierten Datei bzw. in
|
||||
Umgebungsvariablen. Das Manifest enthält keine Secrets.
|
||||
- Der FTP-Spiegel ist eine Verteilungskopie. Ohne Workbench kann man Assets
|
||||
laden, aber keine neuen Versionen erzeugen.
|
||||
|
||||
## Test
|
||||
|
||||
1. `--publish` lud `skater_figure_rigged_deform_v002.glb` (8.345.424 Bytes)
|
||||
nach `rinkplanner/assets/characters/` und verifizierte den Rückdownload.
|
||||
2. Ziel aus `assets/external/` entfernt, `RINKPLANNER_WORKBENCH` auf ein
|
||||
nicht existierendes Verzeichnis gesetzt.
|
||||
3. `--sync` lud die Datei per FTP, Hash
|
||||
`1c1f06461b58b02d9b8332a756fdc88f533ff2d25f65a59d21ca0209b65128cb`,
|
||||
Godot-Import erfolgreich.
|
||||
4. `--check` danach grün.
|
||||
|
||||
## Tests und Doku
|
||||
|
||||
- `tests/run_asset_manifest_tests.gd`: jetzt 53 Assertions (zusätzlich
|
||||
FTP-Pfad, Relativität, Eindeutigkeit).
|
||||
- Gesamtsuite: **1128 Assertions**.
|
||||
- `docs/assets.md` beschreibt Spiegel, Befehle und den Rechner ohne
|
||||
Workbench.
|
||||
|
||||
## Offen
|
||||
|
||||
- Aufräumregel für alte Versionen auf dem Server (aktuell sammeln sich
|
||||
versionierte Dateien).
|
||||
- Android: 1K-Texturen oder separater Asset-Pack, damit die 8,35 MB nicht
|
||||
ungeprüft ins APK wandern.
|
||||
- Optional: `--check --remote`, um die Serverdatei ohne Download zu prüfen.
|
||||
|
|
@ -183,6 +183,7 @@ UI-Feedback der Tester ohnehin noch ausstehen.
|
|||
## Phase 2 – 3D-Präsentation
|
||||
|
||||
- [x] Externe Asset-Pipeline (Manifest, Hash-Prüfung, Sync nach `assets/external/`)
|
||||
- [x] FTP-Spiegel für Rechner ohne Workbench (`--publish` / `--sync`-Fallback)
|
||||
- [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export)
|
||||
- [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`)
|
||||
- [ ] 3D-Rink und Skater auf Basis desselben Datenmodells im Godot-Prototyp
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue