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 41: Signierter macOS-Release-Download
+
+Epic: [Epic 1](epic-1.md)
+
+Abhängigkeiten: [Issue 40](epic-1-issue-40.md)
+
+## Ziel und Grenzen
+
+Signierter macOS-Release-Download 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/), [macOS-Signierung](https://v2.tauri.app/distribute/sign/macos/).
+
+## Implementierungsweg
+
+1. Reproduzierbaren macOS-Releasebuild mit Signierung und Notarisierung vorbereiten.
+2. Zertifikate nur als externe Secrets erwarten.
+3. Installationsartefakt für Git-Releases erzeugen.
+
+## Akzeptanzkriterien
+
+- [ ] Builds verwenden keine eingecheckten Schlüssel.
+- [ ] Signiertes Artefakt lässt sich mit bereitgestellten Voraussetzungen installieren.
+- [ ] Fehlende Secrets werden klar gemeldet.
+
+## 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.