feat: added ui docs

2026-09-09 08:15:37 +02:00
parent 1d8fff1d51
commit 642e49d7b0
46 changed files with 1682 additions and 0 deletions
@@ -0,0 +1,38 @@
+# UI Rework 42: Signiertes Android-APK für Git-Releases
+
+Epic: [Epic 1](epic-1.md)
+
+Abhängigkeiten: [Issue 40](epic-1-issue-40.md)
+
+## Ziel und Grenzen
+
+Signiertes Android-APK für Git-Releases als abgegrenzten Teil des vollständigen Frontend-Neubaus umsetzen. Grundlage: Vue 3/Inertia 2 mit Laravel, Tauri 2 für Apps, gemeinsames Repository, servergeladene Oberfläche, HTTPS, Hell/Dunkel/System und englische Texte über Übersetzungsschlüssel. Bestehende Fachlogik bleibt maßgeblich; Resources und Routen nur soweit für diese Oberfläche erforderlich anpassen. Keine zusätzlichen Produktmodule.
+
+## Einstieg
+
+Gezielt prüfen: `native` (entsteht ab Issue 36); [.github/workflows](../../.github/workflows). Die Pfade sind Einstiegspunkte, keine Erlaubnis zu fachlichen Umbauten. [AGENTS.md](../../AGENTS.md) und die für den tatsächlich geänderten Bereich geltenden Skills beachten. Vor Codeänderungen die zur installierten Version passende Dokumentation prüfen.
+
+Design: [Fluid Emerald Kanban](https://stitch.withgoogle.com/projects/9754281177402648015)
+
+Technische Referenz: [Tauri 2](https://v2.tauri.app/), [Android-Releasevorbereitung](https://developer.android.com/studio/publish/preparing).
+
+## Implementierungsweg
+
+1. Reproduzierbaren signierten APK-Releasebuild konfigurieren.
+2. Dauerhafte Signing-Identität über Secrets beziehen.
+3. Versionierung und Upgrade vorhandener Installationen berücksichtigen.
+
+## Akzeptanzkriterien
+
+- [ ] APK ist direkt installierbar.
+- [ ] Updates behalten Daten/Sitzungen entsprechend Plattformverhalten.
+- [ ] Schlüssel fehlen im Repository.
+- [ ] Kein Play-Store-Upload.
+
+## Prüfung
+
+Zunächst den im Ticket genannten Plattformbuild und die beschriebenen Abläufe prüfen. Für neue App-Logik gezielte Tests für Navigation, Zustände oder URL-Verarbeitung ergänzen; Plattformverhalten im passenden Simulator bzw. auf einem geeigneten Gerät prüfen. Bei Vue/TypeScript-Änderungen abschließend `npm run types:check`; bei Backend-Anpassungen betroffene PHPUnit-Tests.
+
+## Grenze der Agentensitzung
+
+Nur dieses Ticket und bereits erfüllte Abhängigkeiten bearbeiten. Ein zusammenhängendes Ergebnis mit passenden Tests liefern; keine Nachbartickets mitziehen. Die Aufteilung zielt auf eine begrenzte Sitzung mit Reserve für Prüfung, garantiert aber kein festes Zeit- oder Tokenbudget. Wenn unerwartete Voraussetzungen den Umfang wesentlich vergrößern, rechtzeitig den Stand, betroffene Dateien, bereits ausgeführte Prüfungen und den konkret nötigen Folgeschritt festhalten.