docs: massive restructuring of documentation, development guides and agent playbooks

2026-06-15 12:54:38 +02:00
parent e4988b4397
commit ce63303b2c
686 changed files with 45423 additions and 319 deletions
@@ -0,0 +1,78 @@
+# 🖌️ [UI/UX Designer] — Zwischenbericht zur Besprechung vom 3. April 2026
+
+> **Datum:** 3. April 2026, ca. 13:00 Uhr
+> **Rolle:** High-Density Design, Wireframes, Usability, Design-System, Empty States
+
+---
+
+## ✅ Was wurde erreicht?
+
+### Sprint A — vollständig abgeschlossen
+
+- **Design-Inventur (A-1):** Alle vorhandenen V3-Screens katalogisiert (Screenshots in `docs/06_Frontend/Screenshots/`).
+  Inkonsistenzen in Spacing, Typografie und Farbgebung identifiziert. Offene UX-Probleme und fehlende Empty States
+  dokumentiert. Issue-Liste für Sprint B vorbereitet.
+
+### Sprint B — vollständig abgeschlossen (3. April 2026)
+
+- **Editier-Formulare: Dialog vs. Fullscreen (B-1 ✅):**
+  - Entscheidungsgrundlage erarbeitet: Wann AlertDialog, wann Fullscreen-Edit?
+  - Wireframes für beide Varianten erstellt (Reiter-Edit, Pferd-Edit als Beispiele)
+  - Mapping aller bestehenden Edit-Screens auf AlertDialog / Side Sheet / Fullscreen dokumentiert
+  - Finale Entscheidung als **verbindliche Design-Richtlinie festgeschrieben** (Status: APPROVED)
+  - Ergebnis: `docs/06_Frontend/Guidelines/Editier-Formulare_Dialog-vs-Fullscreen_v1.md`
+
+- **Bewerb anlegen mit Abteilungs-Logik (B-2 ✅):**
+  - Dialog-Flow: Bewerb-Grunddaten → Abteilungs-Vorschlag → Bestätigung
+  - CSN-C-NEU Pflicht-Teilung visuell dargestellt
+  - Abteilungs-Typ-Auswahl (`SEPARATE_SIEGEREHRUNG` vs. `ORGANISATORISCH`) verständlich gestaltet
+  - Ergebnis: `docs/06_Frontend/Wireframes/Bewerb_anlegen_Abteilungs-Logik_v1.md`
+
+- **Veranstaltungs-Kassa (B-3 ✅):**
+  - Gesamt-Saldo-Ansicht: Teilnehmer mit offenen Beträgen aus mehreren Turnieren
+  - Zahlvorgang-Dialog: Eine Zahlung, Aufteilung auf Turniere sichtbar
+  - Rechnungsvorschau: Zwei separate Rechnungen je Turnier als Tab
+  - Ergebnis: `docs/06_Frontend/Wireframes/Kassa_Veranstaltung_v1.md`
+
+- **Empty States für alle Listenansichten (B-4 ✅):**
+  - Liste aller 10 Screens mit möglichen leeren Zuständen (3 Typen) erstellt
+  - Icon-Konzept: Material Symbols Outlined (kein Custom-Illustration-Set für MVP)
+  - Texte (Titel, Beschreibung, CTA) für alle Screens und Typen definiert
+  - Composable-API `MsEmptyState` spezifiziert (Ablageort, Parameter, Verhalten, Beispiel)
+  - Ergebnis: `docs/06_Frontend/Guidelines/Empty-States_Spezifikation_v1.md` (Status: APPROVED)
+
+---
+
+## 🔄 Was ist noch offen?
+
+### Sprint C — geplant (nächste Woche)
+
+- **C-1 Wireframes in Compose umsetzen:** Edit-Dialog/Fullscreen (B-1), Bewerb-Anlegen-Dialog (B-2), Kassa-Screen (B-3),
+  `MsEmptyState`-Composable implementieren, Empty States in alle 10 Listenansichten integrieren, `PferdProfilEditDialog`
+  zu Fullscreen migrieren.
+- **C-2 Design-System konsolidieren:** Farb-Palette in `MaterialTheme` / `Theme.kt`, Typografie-Skala, wiederverwendbare
+  Composables (Cards, Badges, Chips).
+- **C-3 Abteilungs-Ansicht:** Wireframes für Startliste, Ergebnisliste und Ranglisten-Zusammenführung (
+  `ORGANISATORISCH`).
+
+> ⏸️ **Web-App / PWA Design** — Nach Desktop-MVP; Anforderungen noch nicht definiert.
+
+---
+
+## 🔗 Abhängigkeiten & Auswirkungen
+
+| Meine Aufgabe          | Blockiert wen                                  |
+|------------------------|------------------------------------------------|
+| B-1 Richtlinie ✅       | 🎨 Frontend C-1: Edit-Dialoge implementieren   |
+| B-4 Spezifikation ✅    | 🎨 Frontend C-1: `MsEmptyState` implementieren |
+| B-2 / B-3 Wireframes ✅ | 🎨 Frontend C-1: Bewerb-Dialog, Kassa-Screen   |
+| Icons (PNG/ICO/ICNS)   | 🐧 DevOps C-1: Release-Build (noch ausstehend) |
+
+---
+
+## 💬 Botschaft an die Runde
+
+Sprint B ist vollständig abgeschlossen — alle vier Punkte (B-1 bis B-4) sind **APPROVED** und an das Frontend-Team
+übergeben. Die Spezifikationen und Wireframes liegen vor. Das Frontend kann sofort mit **`MsEmptyState` (C-1)** und der
+**`PferdProfilEditDialog`-Migration** beginnen. Die **App-Icons** (PNG/ICO/ICNS) sind der einzige ausstehende
+Design-Deliverable für den DevOps-Release-Build — diese müssen priorisiert werden.