rinkplanner/docs/findings-2026-10-30.md
torsten 7c6c8fc3d4 docs: Findings der Tablet-/Build-/Sync-Session festhalten
- docs/findings-2026-10-30.md: Gerät, Toolchain, Android-APK, Windows-
  Ressourcen, Icon-Pipeline, Sync-Regeln und -Fehler, Labels, Tests,
  offene Punkte
- Roadmap: Tablet-Test, Icons und rcedit als erledigt markiert; nächste
  Session auf Element-Marker gesetzt, danach Sync-Komfort und Layout
- builds.md: Zielgerät-Verifikation, invertiertes Icon, bekannte Grenzen
  (Hochformat/DeX, arm64, rcedit-Setup, macOS-Signierung)
- sync.md: Erfahrungen mit dem Zielserver (FTPS-Zertifikat, MLSD/MDTM,
  Ordneranlage)
- architecture.md: Sync-Testanzahl und Verweis auf die Findings
2026-10-30 12:14:59 +01:00

194 lines
8.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.