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