From 7c6c8fc3d4da49e469cd0aafeaddebdf3d71c503 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 30 Oct 2026 12:14:59 +0100 Subject: [PATCH] docs: Findings der Tablet-/Build-/Sync-Session festhalten MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- docs/architecture.md | 5 +- docs/builds.md | 22 +++- docs/findings-2026-10-30.md | 194 ++++++++++++++++++++++++++++++++++++ docs/roadmap.md | 34 +++++-- docs/sync.md | 12 +++ 5 files changed, 257 insertions(+), 10 deletions(-) create mode 100644 docs/findings-2026-10-30.md diff --git a/docs/architecture.md b/docs/architecture.md index 775f73b..e87afcc 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -3,6 +3,7 @@ Stand: 2026-10-30 Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md` Übergeordnete Reihenfolge: `docs/roadmap.md` +Letzte Session: `docs/findings-2026-10-30.md` ## 1. Leitentscheidung @@ -285,10 +286,10 @@ Aktueller Stand: Leistenlayout bei 1024 und 1400 px. - **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere Redraw-Zeit muss unter 120 ms bleiben (aktuell ca. 7–10 ms). -- **Sync:** 31 Assertions für Vergleichsregeln, Konfliktnamen, Zeitstempel, +- **Sync:** 32 Assertions für Vergleichsregeln, Konfliktnamen, Zeitstempel, PASV/EPSV/MDTM-Parsing, Sync-Stand und die Einstellungs-Verdrahtung. Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft - (Upload, Download, Konflikt, Aufräumen). + (Upload, Download, Übernahme, Konflikt, Aufräumen). Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME` end-to-end geprüft. diff --git a/docs/builds.md b/docs/builds.md index 9d82401..60eb4b8 100644 --- a/docs/builds.md +++ b/docs/builds.md @@ -98,12 +98,22 @@ ist folgenlos. - Paket: `de.rinkplanner.app`, Label „Rinkplanner“, Version 0.1.0 - App-Icon aus der Silhouetten-Vorlage, erzeugt mit `tools/make_app_icons.py` (Launcher-Icons unter - `rinkplanner/assets/icons/android/`) + `rinkplanner/assets/icons/android/`); aktuell die **invertierte** + Variante (weiße Kachel, schwarze Figur) - `minSdk 24`, `targetSdk 36`, ABI **arm64-v8a** (Galaxy Tab S9+) - Landscape, Immersive Mode, `resizeableActivity=true` - Berechtigung `INTERNET` (für den späteren Sync) - Template-Export ohne Gradle-Projekt (`gradle_build/use_gradle_build=false`) +### Auf dem Zielgerät verifiziert + +Galaxy Tab S9+ (SM-X810), 2800 × 1752, 340 dpi (Skalierung 2,125), Landscape: + +- Installation per `adb install -r` (Incremental Install, ca. 2 s) +- Start, Zeichnen, Tippen, Labels und Zurück-Geste (beendet und speichert) +- UI-Skalierung: 56-Pixel-Ziele entsprechen echten 56 CSS-Pixeln +- App-Daten einsehbar über `adb shell run-as de.rinkplanner.app ls files/` + ### Auf dem Tablet installieren 1. Auf dem Tablet: Einstellungen → Info zu Tablet → 7× „Buildnummer“ → @@ -139,6 +149,16 @@ adb shell run-as de.rinkplanner.app ls files/ adb exec-out run-as de.rinkplanner.app cat files/routines/kuer.tres > kuer.tres ``` +## Bekannte Grenzen + +- Die obere Werkzeugleiste hat eine Mindestbreite von ca. 994 logischen + Pixeln. Hochformat, geteilter Bildschirm und kleine DeX-Fenster + beschneiden sie; Vollbild-Landscape ist korrekt. +- Die Android-APK enthält nur `arm64-v8a`. +- Die Windows-Ressourcen (Icon/Version) werden nur eingebettet, wenn + `tools/setup_windows_export.sh` gelaufen ist. +- macOS ist ad-hoc signiert, nicht notarisiert. + ## Release-Builds - **Android Release:** eigener Keystore nötig; im Preset diff --git a/docs/findings-2026-10-30.md b/docs/findings-2026-10-30.md new file mode 100644 index 0000000..5314975 --- /dev/null +++ b/docs/findings-2026-10-30.md @@ -0,0 +1,194 @@ +# 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. diff --git a/docs/roadmap.md b/docs/roadmap.md index 8a62084..72e7e86 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -1,8 +1,9 @@ # Rinkplanner – Roadmap -Stand: 2026-10-30 +Stand: 2026-10-30 (nach der Tablet-/Build-/Sync-Session) Diese Reihenfolge ist die verbindliche Arbeitsgrundlage für Phase 1. Änderungen -nur bewusst und nach Rücksprache. +nur bewusst und nach Rücksprache. Erkenntnisse der letzten Session: +`docs/findings-2026-10-30.md`. ## Leitprinzip @@ -64,9 +65,14 @@ Voraussetzung für Phase 1. - [x] Android-Toolchain-Setup (`tools/setup_android.sh`), Debug-Keystore - [x] Signiertes Android-Debug-APK (arm64-v8a, Landscape, minSdk 24) - [x] Web-Export entfernt; Zielplattformen sind nur noch Desktop + Android -- [ ] Test auf echtem Tablet (Galaxy Tab S9+) -- [ ] Hochformat-Layout (nur prüfen, falls benötigt) +- [x] Test auf echtem Tablet (Galaxy Tab S9+): Installation per adb, Start, + Zeichnen, Labels, Beenden über die Zurück-Geste +- [x] App-Icon (Silhouette, dunkle und invertierte Variante) inkl. + Android-Launcher-Icons, reproduzierbar über `tools/make_app_icons.py` +- [x] Windows-EXE mit Icon und Versionsinformationen (rcedit über portables + Wine, `tools/setup_windows_export.sh`) - [ ] Release-Keystore für ein verteilbares APK +- [ ] Hochformat-, Multi-Window- und DeX-Layout (obere Leiste umbruchfähig) ### Erledigt: Touch-/Tablet-Härtung @@ -74,6 +80,7 @@ Voraussetzung für Phase 1. - [x] UI-Skalierung in CSS-Pixeln (DPR-korrekt), kompakte Leiste < 1280 px - [x] Kleine Displays (1024 px) geprüft - [x] Performance bei vielen Segmenten und Sections (Cache + Stresstest) +- [x] Auf dem Zielgerät verifiziert (340 dpi, 2800 × 1752, Landscape) ### Erledigt: Kontosync (Desktop ↔ Tablet) @@ -86,12 +93,23 @@ Voraussetzung für Phase 1. - [ ] Automatischer Sync im Hintergrund (später) - [ ] Konflikt-Zusammenführung in der Oberfläche (später) -### Danach: Element-Marker +### Nächste Session: Element-Marker - [ ] Sprungpunkte, Pirouettenzentren und Sequenzbereiche platzieren - [ ] Elementtyp, Level und Marker-Darstellung - [ ] Element-Inspector und Auswahl auf dem Tablet - [ ] Element-Marker im Export (SVG/PNG) +- [ ] Entscheidung: Marker als eigenes Modellobjekt (Position, Typ, Level) + oder als Segment mit `element_id`/`label` +- [ ] Tests für Marker-Modell, Interaktion und Export erweitern +- [ ] Labels optional aus Elementkürzeln vorschlagen + +### Danach: Sync-Komfort (optional, wenn Zeit) + +- [ ] Automatischer Sync beim Start/Beenden +- [ ] Konflikt-Zusammenführung in der Oberfläche +- [ ] Optional: Löschweitergabe mit Bestätigung +- [ ] Optional: echter Kontosync über HTTP/WebDAV statt FTP ### Danach: ISU-Regelwerk @@ -106,8 +124,10 @@ Voraussetzung für Phase 1. - [ ] Optional: Segment-Verknüpfung beim Verschieben von Endpunkten - [ ] Optional: Section-Timeline mit Zeitproportionen -Die Reihenfolge ist bewusst: erst native Builds und Datenaustausch, dann -sichtbare Element-Marker, dann die vollständige ISU-Logik. +Die Reihenfolge ist bewusst: native Builds und Datenaustausch sind erledigt, +jetzt kommen die sichtbaren Element-Marker, dann die vollständige ISU-Logik. +Sync-Komfort und Layout-Härtung laufen parallel nur, wenn sie den +Planungs-Workflow nicht blockieren. ## Querschnittsaufgaben diff --git a/docs/sync.md b/docs/sync.md index ac4cbbd..41a3aa4 100644 --- a/docs/sync.md +++ b/docs/sync.md @@ -87,6 +87,18 @@ Kür öffnen und bearbeiten. `~/.local/share/godot/app_userdata/Rinkplanner/`. - Android braucht die `INTERNET`-Berechtigung – ist im APK gesetzt. +## Erfahrungen mit dem Zielserver + +- Der Server spricht explizites FTPS (`AUTH TLS`), außerdem `MLST`, `MDTM`, + `MFMT` und `EPSV` – genau das, was der Abgleich braucht. +- Sein TLS-Zertifikat passt nicht zum Hostnamen (leeres CN/SAN). Deshalb muss + „Server-Zertifikat prüfen“ ausgeschaltet werden; die Übertragung bleibt + verschlüsselt. +- Der Zielordner existiert in Kleinschreibung. Die App wechselt direkt + hinein und legt ihn bei Bedarf per `MKD` an. +- Ein vollständiger Testlauf (Upload, Überspringen, Download, Übernahme, + Konflikt, Aufräumen) lief gegen den echten Server erfolgreich. + ## Grenzen - Kein automatischer Sync, kein Push, kein Locking. Zwei Geräte, die