rinkplanner/docs/findings-2026-10-30.md

195 lines
8.6 KiB
Markdown
Raw Normal View History

# Findings – Session 2026-10-30
Zusammenfassung der Erkenntnisse aus der Session, in der Rinkplanner von der
Web-Idee auf native Builds umgestellt, um Labels und den FTP-Sync erweitert
und erstmals auf dem Ziel-Tablet getestet wurde.
## Ziel und Ergebnis
| Ziel | Ergebnis |
| :--- | :--- |
| Web-Build aufgeben, native Builds | Linux, Windows, macOS, Android gebaut |
| Tablet-Test | Galaxy Tab S9+ installiert, gestartet, bedient |
| Segment-Labels | umgesetzt inkl. Ein-/Ausblenden und Export |
| Kontosync | manueller FTP-/FTPS-Sync, gegen den echten Server geprüft |
| App-Icon | Silhouette, dunkle und invertierte Variante |
| Windows-EXE | Icon + Versionsinfos über rcedit (Wine) |
## Gerät und Umgebung
- **Tablet:** Samsung Galaxy Tab S9+ (SM-X810), Auflösung 2800 × 1752,
Dichte 340 dpi → Skalierung 2,125, logische Fläche ca. 1317 × 824.
Die Android-Version wurde vor dem Abstecken nicht protokolliert.
- **Host:** Pop!_OS/Ubuntu (Noble), Godot 4.7.2, Temurin JDK 17.0.21,
Android build-tools 36.0.0 und 35.0.0, Platform `android-36`,
portables Wine 11.20, rcedit 2.0.0.
- **Builds:** Linux 71 MB, Windows 105 MB, macOS 58 MB,
Android-Debug-APK 28 MB.
## Android
### Toolchain
- `tools/setup_android.sh` installiert JDK, SDK, Godot-Templates und den
Debug-Keystore nach `~/.jdks`, `~/Android/Sdk`,
`~/.local/share/godot/export_templates/4.7.2.stable` und
`~/.local/share/godot/keystores`. Es trägt die Pfade in
`editor_settings-4.7.tres` ein (Backups als `.bak`).
- Der **Debug-Keystore** war die fehlende Zutat für den ersten Fehlschlag
(`keytool`-Aufruf ohne `-genkeypair`); danach signierte Godot das APK.
- **ETC2/ASTC** muss importiert werden
(`rendering/textures/vram_compression/import_etc2_astc=true`), sonst
bricht der Android-Export ab.
- Export ausschließen: `tests/*`, `prototype/*`, `addons/*`,
`assets/models/*` – spart ca. 2,5 MB und hält Editor-/Testcode aus dem APK.
### APK
- `de.rinkplanner.app`, Version 0.1.0, Label „Rinkplanner“
- `minSdk 24`, `targetSdk 36`, ABI `arm64-v8a`
- Landscape, Immersive Mode, `resizeableActivity=true`,
Berechtigung `INTERNET`
- Template-Export ohne Gradle (`gradle_build/use_gradle_build=false`)
- `tools/verify_apk.sh` prüft Paket, Version, SDK, ABI, Landscape, Label und
Signatur (aapt2 + apksigner; apksigner braucht `java` im PATH).
### Installation und Betrieb
- `adb install -r …` nutzt Incremental Install (ca. 2 s).
- Debug-APK ist debuggbar: App-Daten über
`adb shell run-as de.rinkplanner.app ls files/routines/` einsehbar.
- **Beenden:** Zurück-Geste (oder Nav-Bar-Zurück) beendet die App; dabei
greift `NOTIFICATION_WM_CLOSE_REQUEST` und schreibt das Autosave.
Verifiziert per `pidof` vor/nach `KEYCODE_BACK`.
- Entwickleroptionen: Die **Buildnummer** liegt in One UI unter
*Info zu Tablet → Softwareinformationen*, nicht direkt in „Info zu Tablet“.
### Beobachtungen
- Direkt nach dem Start steht das Fenster kurz im Hochformat (1752 × 2800),
bevor Android auf Landscape dreht. In diesem Moment ist die obere Leiste
zu breit und wird beschnitten – rein kosmetisch, nach der Drehung korrekt.
- Die UI-Skalierung (`content_scale_factor = screen_get_scale()`) ergibt auf
dem Gerät echte 56-CSS-Pixel-Ziele (≈ 1,3 cm) und scharfe Darstellung.
- Godot emuliert auf Android Maus aus Touch
(`emulate_mouse_from_touch`); der Guard gegen synthetische Maus-Events aus
der Web-Phase bleibt deshalb sinnvoll.
## Windows-Export mit Ressourcen
- Godot bettet Icon, Produktname, Beschreibung und Version per `rcedit` ein.
`rcedit` ist ein Windows-Programm; auf Linux läuft es über portables Wine.
- `tools/setup_windows_export.sh` lädt Wine (Kron4ek-Build) und rcedit nach
`~/.local/share/rinkplanner-toolchain`, legt einen Wrapper an und setzt
`export/windows/rcedit` in den Editor-Settings.
- Godot konvertiert das PNG-Icon selbst in ein ICO (6 Größen, 16–256 px).
- Verifikation mit `pefile`: `RT_ICON` (6), `RT_GROUP_ICON`, `RT_VERSION`
mit ProductName „Rinkplanner“, FileDescription
„2D-Whiteboard für Eiskunstlauf“, FileVersion/ProductVersion 0.1.0.0.
## Icons
- Vorlage: `figure-skating-silhouette-small.png` (454 × 454, Alphakanal) aus
dem externen Workbench-Archiv.
- `tools/make_app_icons.py` erzeugt Master (1024 px, abgerundet), Legacy-,
Adaptive- und Monochrom-Icon. Varianten:
`--inverted` (weiß/schwarz) bzw. `--background/--figure`.
- Gewählt wurde die **invertierte** Variante: weiße Kachel, schwarze
Biellmann-Silhouette. Auf dem Tablet im Launcher geprüft.
## Sync (FTP)
### Server-Eigenschaften
- Erreichbar auf Port 21, unterstützt `AUTH TLS` (explizites FTPS), `MLST`,
`MDTM`, `MFMT`, `EPSV`, `CCC`, `LANG`.
- Das TLS-Zertifikat hat **keinen zum Host passenden Namen** (leeres
CN/SAN). Strenge Prüfung schlägt fehl; die App braucht dafür die Option
„Server-Zertifikat prüfen“ aus. Die Verbindung bleibt verschlüsselt.
- Zielordner existiert in Kleinschreibung; die App wechselt direkt hinein
und legt ihn bei Bedarf per `MKD` an.
- Schreib- und Löschtest über den Client bestanden; ein Testlauf gegen den
echten Server (Upload, Skip, Download, Übernahme, Konflikt, Aufräumen)
lief grün.
### Regeln
- Zuordnung über den Dateinamen (aus dem Kür-Titel).
- Gemeinsamer Stand in `user://sync_state.cfg` (`local_mtime`,
`remote_modify` je Datei).
- Nur lokal → Upload; nur Server → Download; einseitig geändert → Richtung.
- Beide seit dem letzten Sync geändert → **Konflikt**: lokale Fassung bleibt
Hauptdatei, Serverfassung als `(Server …)`-Kopie.
- Beide vorhanden, aber kein gemeinsamer Stand (neues Gerät) →
**Server übernimmt** den Namen, lokale Fassung als `(Lokal …)`-Kopie.
- Löschungen werden nicht übertragen; Umbenennen erzeugt zwei Dateien.
- Ablauf im Thread, Fortschritt in der Statusleiste, Zusammenfassung im
Dialog; geöffnete Kür wird nur neu geladen, wenn sie nicht dirty ist.
### Behobene Fehler beim Bau des Clients
- TLS-Handshake auf dem **Datenkanal** muss nach dem Transferbefehl
(`RETR`/`STOR`/`MLSD`) erfolgen, nicht direkt nach dem Verbinden.
- `StreamPeerTLS` nutzt `disconnect_from_stream()`, nicht
`disconnect_from_host()`.
- `get_available_bytes()` vor der Statusprüfung erzeugt mbedTLS-Fehler;
erst Status prüfen, dann lesen.
- Downloads lesen exakt `SIZE` Bytes, damit die letzte Paketcharge nicht
verloren geht.
- Uploads über `name.uploading` + `RNFR/RNTO`, Downloads über `.part` und
`.bak` (atomare Ersetzung, kein Datenverlust bei Abbruch).
## Labels
- `PathSegment.label` (max. 40 Zeichen) mit Undo/Redo, Dirty-State und
Persistenz; `_clone_segment` kopiert das Feld.
- Dialog über „Label“ in der Timing-Leiste, Enter übernimmt, leeres Feld
entfernt; globaler Schalter „Labels“ blendet die Ansicht aus.
- Canvas: Pill am Segmentmittelpunkt, gelber Rahmen bei Auswahl, keine
Labels auf Ghosting-Abschnitten.
- SVG: `<text>` mit weißer Kontur (`paint-order="stroke"`), korrekt escaped.
PNG: Labels immer enthalten.
## Tests
`./tools/test.sh` ist grün mit **500 Assertions**:
| Suite | Assertions |
| :--- | ---: |
| Model | 55 |
| Canvas | 90 |
| Whiteboard (inkl. Labels, Sync-Dialog) | 149 |
| History | 53 |
| Playback | 38 |
| Timing | 41 |
| Export | 19 |
| Touch/Layout | 21 |
| Performance (480 Segmente) | 2 |
| Sync (Plan, Parser, State) | 32 |
Zusätzlich manuell/visuell geprüft: Launcher-Icon, App-Start, Landscape,
Zeichnen/Tippen, Labels, Back-Geste, Windows-Ressourcen, FTP-E2E.
## Offene Punkte und Risiken
1. **Hochformat / Multi-Window / DeX:** Die obere Leiste hat eine minimale
Breite von ca. 994 logischen Pixeln. Unterhalb (Hochformat, geteilter
Bildschirm, kleines DeX-Fenster) wird sie beschnitten. Lösung: umbruchfähige
Werkzeugleiste oder zweite Zeile.
2. **Sync-Komfort:** kein automatischer Abgleich, keine Konflikt-Zusammenführung
in der UI, keine Löschweitergabe, kein Locking zwischen Geräten.
3. **Zugangsdaten:** `user://sync.cfg` liegt im Klartext im app-privaten
Speicher. Für echte Konten wäre ein Token/Backend besser als FTP.
4. **Release:** Android nutzt den Debug-Keystore; macOS ist ad-hoc signiert und
nicht notarisiert; Windows-Ressourcen brauchen das rcedit-Setup.
5. **Datenpflege:** benannte Kürläufe haben keinen „Löschen“-Befehl in der App;
Dateien müssen über den Dateimanager entfernt werden.
6. **Labels:** keine Vorlagen/Elementkürzel-Auswahl.
7. **Protokollierung:** Android-Version des Testgeräts nicht erfasst.
## Nächste Schritte
Empfohlen für die nächste Session: **Element-Marker** (Sprungpunkte,
Pirouettenzentren, Sequenzbereiche) inklusive Inspector, Darstellung und
Export – siehe `docs/roadmap.md`. Danach Sync-Komfort und Layout-Härtung.