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,37 @@
+# UI Rework 40: App-Links, externe Links und Dateiauswahl
+
+Epic: [Epic 1](epic-1.md)
+
+Abhängigkeiten: [Issue 20](epic-1-issue-20.md), [Issue 21](epic-1-issue-21.md), [Issue 38](epic-1-issue-38.md), [Issue 39](epic-1-issue-39.md)
+
+## Ziel und Grenzen
+
+App-Links, externe Links und Dateiauswahl 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); [resources/js/components](../../resources/js/components). 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/), [Remote-Inhalte und native Berechtigungen](https://v2.tauri.app/security/capabilities/).
+
+## Implementierungsweg
+
+1. Interne App-Links zur ausgewählten Installation und externe Browserlinks umsetzen.
+2. Avatar-Dateiauswahl, Zwischenablage und Browser-Zurück plattformübergreifend absichern.
+3. Native Schnittstellen eng begrenzen.
+
+## Akzeptanzkriterien
+
+- [ ] Fremde Links wechseln nicht ungefragt den Server.
+- [ ] Externe Git-Links funktionieren.
+- [ ] Uploads und Kopieren funktionieren auf allen App-Plattformen.
+
+## 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.