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

8.6 KiB
Raw Blame 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.