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
This commit is contained in:
torsten 2026-10-30 12:14:59 +01:00
parent dd8cc20de8
commit 7c6c8fc3d4
5 changed files with 257 additions and 10 deletions

View file

@ -3,6 +3,7 @@
Stand: 2026-10-30 Stand: 2026-10-30
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md` Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
Übergeordnete Reihenfolge: `docs/roadmap.md` Übergeordnete Reihenfolge: `docs/roadmap.md`
Letzte Session: `docs/findings-2026-10-30.md`
## 1. Leitentscheidung ## 1. Leitentscheidung
@ -285,10 +286,10 @@ Aktueller Stand:
Leistenlayout bei 1024 und 1400 px. Leistenlayout bei 1024 und 1400 px.
- **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere - **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere
Redraw-Zeit muss unter 120 ms bleiben (aktuell ca. 7–10 ms). 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. PASV/EPSV/MDTM-Parsing, Sync-Stand und die Einstellungs-Verdrahtung.
Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft 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` Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
end-to-end geprüft. end-to-end geprüft.

View file

@ -98,12 +98,22 @@ ist folgenlos.
- Paket: `de.rinkplanner.app`, Label „Rinkplanner“, Version 0.1.0 - Paket: `de.rinkplanner.app`, Label „Rinkplanner“, Version 0.1.0
- App-Icon aus der Silhouetten-Vorlage, erzeugt mit - App-Icon aus der Silhouetten-Vorlage, erzeugt mit
`tools/make_app_icons.py` (Launcher-Icons unter `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+) - `minSdk 24`, `targetSdk 36`, ABI **arm64-v8a** (Galaxy Tab S9+)
- Landscape, Immersive Mode, `resizeableActivity=true` - Landscape, Immersive Mode, `resizeableActivity=true`
- Berechtigung `INTERNET` (für den späteren Sync) - Berechtigung `INTERNET` (für den späteren Sync)
- Template-Export ohne Gradle-Projekt (`gradle_build/use_gradle_build=false`) - 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 ### Auf dem Tablet installieren
1. Auf dem Tablet: Einstellungen → Info zu Tablet → 7× „Buildnummer“ → 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 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 ## Release-Builds
- **Android Release:** eigener Keystore nötig; im Preset - **Android Release:** eigener Keystore nötig; im Preset

194
docs/findings-2026-10-30.md Normal file
View file

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

View file

@ -1,8 +1,9 @@
# Rinkplanner – Roadmap # 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 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 ## Leitprinzip
@ -64,9 +65,14 @@ Voraussetzung für Phase 1.
- [x] Android-Toolchain-Setup (`tools/setup_android.sh`), Debug-Keystore - [x] Android-Toolchain-Setup (`tools/setup_android.sh`), Debug-Keystore
- [x] Signiertes Android-Debug-APK (arm64-v8a, Landscape, minSdk 24) - [x] Signiertes Android-Debug-APK (arm64-v8a, Landscape, minSdk 24)
- [x] Web-Export entfernt; Zielplattformen sind nur noch Desktop + Android - [x] Web-Export entfernt; Zielplattformen sind nur noch Desktop + Android
- [ ] Test auf echtem Tablet (Galaxy Tab S9+) - [x] Test auf echtem Tablet (Galaxy Tab S9+): Installation per adb, Start,
- [ ] Hochformat-Layout (nur prüfen, falls benötigt) 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 - [ ] Release-Keystore für ein verteilbares APK
- [ ] Hochformat-, Multi-Window- und DeX-Layout (obere Leiste umbruchfähig)
### Erledigt: Touch-/Tablet-Härtung ### 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] UI-Skalierung in CSS-Pixeln (DPR-korrekt), kompakte Leiste < 1280 px
- [x] Kleine Displays (1024 px) geprüft - [x] Kleine Displays (1024 px) geprüft
- [x] Performance bei vielen Segmenten und Sections (Cache + Stresstest) - [x] Performance bei vielen Segmenten und Sections (Cache + Stresstest)
- [x] Auf dem Zielgerät verifiziert (340 dpi, 2800 × 1752, Landscape)
### Erledigt: Kontosync (Desktop ↔ Tablet) ### Erledigt: Kontosync (Desktop ↔ Tablet)
@ -86,12 +93,23 @@ Voraussetzung für Phase 1.
- [ ] Automatischer Sync im Hintergrund (später) - [ ] Automatischer Sync im Hintergrund (später)
- [ ] Konflikt-Zusammenführung in der Oberfläche (später) - [ ] Konflikt-Zusammenführung in der Oberfläche (später)
### Danach: Element-Marker ### Nächste Session: Element-Marker
- [ ] Sprungpunkte, Pirouettenzentren und Sequenzbereiche platzieren - [ ] Sprungpunkte, Pirouettenzentren und Sequenzbereiche platzieren
- [ ] Elementtyp, Level und Marker-Darstellung - [ ] Elementtyp, Level und Marker-Darstellung
- [ ] Element-Inspector und Auswahl auf dem Tablet - [ ] Element-Inspector und Auswahl auf dem Tablet
- [ ] Element-Marker im Export (SVG/PNG) - [ ] 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 ### Danach: ISU-Regelwerk
@ -106,8 +124,10 @@ Voraussetzung für Phase 1.
- [ ] Optional: Segment-Verknüpfung beim Verschieben von Endpunkten - [ ] Optional: Segment-Verknüpfung beim Verschieben von Endpunkten
- [ ] Optional: Section-Timeline mit Zeitproportionen - [ ] Optional: Section-Timeline mit Zeitproportionen
Die Reihenfolge ist bewusst: erst native Builds und Datenaustausch, dann Die Reihenfolge ist bewusst: native Builds und Datenaustausch sind erledigt,
sichtbare Element-Marker, dann die vollständige ISU-Logik. 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 ## Querschnittsaufgaben

View file

@ -87,6 +87,18 @@ Kür öffnen und bearbeiten.
`~/.local/share/godot/app_userdata/Rinkplanner/`. `~/.local/share/godot/app_userdata/Rinkplanner/`.
- Android braucht die `INTERNET`-Berechtigung – ist im APK gesetzt. - 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 ## Grenzen
- Kein automatischer Sync, kein Push, kein Locking. Zwei Geräte, die - Kein automatischer Sync, kein Push, kein Locking. Zwei Geräte, die