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,73 @@
+# 🧐 [QA Specialist] — Zwischenbericht zur Besprechung vom 3. April 2026
+
+> **Datum:** 3. April 2026, ca. 13:00 Uhr
+> **Rolle:** Test-Strategie, Edge-Cases, Integrationstests, Regressionssicherung
+
+---
+
+## ✅ Was wurde erreicht?
+
+### Sprint A — vollständig abgeschlossen
+
+- **Test-Strategie für Desktop-App (A-1):** Testpyramide für Compose Desktop festgelegt (Unit / Integration / UI-Tests).
+  Tooling entschieden: `kotlin.test`, Compose UI Test, Mockk. Test-Konventionen dokumentiert (Namensschema,
+  Ordnerstruktur, Arrange-Act-Assert). `IdempotencyPluginTest` stabilisiert. `OetoValidatorsTest.kt` als Basis für
+  Grenzfall-Abdeckung etabliert.
+
+### Sprint B (teilweise) — zwei Test-Suiten abgeschlossen
+
+- **Onboarding-Wizard Edge-Cases (B-2) ✅ — 3. April 2026:**
+  - Leere Pflichtfelder → Speichern-Button bleibt deaktiviert
+  - Schnelles Doppelklick → kein doppelter Submit
+  - Abbrechen mitten im Wizard → kein inkonsistenter Zustand
+  - Zurück-Navigation: Gerätename und Sicherheitsschlüssel bleiben erhalten (`rememberSaveable`)
+  - **Fix:** `remember` → `rememberSaveable` in `OnboardingScreen.kt`
+  - **Neu:** `OnboardingValidator`-Objekt extrahiert für isolierte Unit-Tests
+  - **17 Tests, alle GRÜN** (`OnboardingValidatorTest.kt`)
+
+- **Abteilungs-Logik (B-3) ✅ — 3. April 2026:**
+  - CSN-C-NEU ≤95cm / ≥100cm: Pflicht-Teilungen korrekt vorgeschlagen
+  - `ORGANISATORISCH`: Gesamtrangliste korrekt zusammengeführt
+  - `SEPARATE_SIEGEREHRUNG`: Abteilungen werden nicht zusammengeführt
+  - Caprilli-Regression abgesichert, Grenzfälle 90 cm und 110 cm abgedeckt
+  - **Fix:** CSN-C-NEU-Logik in `AbteilungsRegelService.kt` implementiert
+  - **Neu:** `ORGANISATORISCH` + `SEPARATE_SIEGEREHRUNG` in `AbteilungsTeilungsTypE` ergänzt
+  - **14 neue Tests, alle GRÜN** (`AbteilungsRegelServiceTest.kt`)
+
+---
+
+## 🔄 Was ist noch offen?
+
+### Sprint B — offen
+
+- **B-1 Navigation & Back-Stack:** Navigations-Flows, Back-Stack-Verhalten, SingleTop-Tabs, Logout-Verhalten — noch
+  nicht begonnen.
+- **B-2 Restpunkt:** Ungültige OEPS-Nummer → Fehlermeldung sichtbar (abhängig von Frontend C-3).
+- **B-4 ViewModel-Verhalten:** State-Initialisierung, Intent → State-Transitionen, Fehler-State bei Backend-Fehler,
+  Loading-State — noch nicht begonnen.
+
+### Sprint C — geplant
+
+- **C-1** Mandanten-Isolation (sicherheitskritisch; wartet auf Backend A-1 Rollout)
+- **C-2** Kassa und Zahlvorgang (wartet auf Backend B-2)
+- **C-3** ÖTO-Validierung (wartet auf Rulebook C-1 `AltersklasseRechner`)
+- **C-4** Regressions-Test-Suite & CI-Integration (gemeinsam mit 🐧 DevOps)
+
+---
+
+## 🔗 Abhängigkeiten
+
+| Warte auf                        | Von wem       | Betrifft               |
+|----------------------------------|---------------|------------------------|
+| Rulebook C-1 AltersklasseRechner | 📜 Rulebook   | C-3 Validierungs-Tests |
+| Backend B-2 Kassa-Service        | 👷 Backend    | C-2 Kassa-Tests        |
+| DevOps CI/CD Pipeline            | 🐧 DevOps C-1 | C-4 CI-Integration     |
+
+---
+
+## 💬 Botschaft an die Runde
+
+Zwei wichtige Test-Suiten wurden heute fertiggestellt: **Onboarding (17 Tests)** und **Abteilungs-Logik (14 Tests)** —
+beide komplett grün, inklusive zweier produktiver Bugfixes im Produktivcode. Die Test-Basis steht. Der nächste kritische
+Schritt ist die **Mandanten-Isolation (C-1)** — sicherheitskritisch und sofort anzugehen, sobald Backend A-1 vollständig
+ausgerollt ist.