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

View file

@ -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

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

View file

@ -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