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,36 @@
+# Journal: ZNS-Import & Security Fixes
+
+**Datum:** 2026-04-17
+**Agent:** 🧹 [Curator]
+
+## 📝 Zusammenfassung
+
+In dieser Session wurden kritische Probleme bei der Authentifizierung im Onboarding-Workflow sowie Einschränkungen beim
+ZNS-Stammdaten-Import behoben.
+
+## 🚀 Änderungen
+
+### 🔐 Security & Auth
+
+- **Onboarding-Fix:** Der `sharedKey` wird nun beim Abschluss des Onboardings sofort in den `AuthTokenManager` geladen.
+  Dies behebt den **HTTP 401** Fehler bei der Cloud-Suche und beim ZNS-Sync, da Anfragen an das Backend nun korrekt
+  authentifiziert sind.
+- **Header-Integration:** Der `sharedKey` fungiert als Bearer-Token für die Kommunikation mit dem API-Gateway.
+
+### 📦 ZNS-Stammdaten-Import
+
+- **Dateinamens-Toleranz:** Der `ZnsImportService` im Backend wurde erweitert. Er erkennt nun Dateien wie `VEREIN.DAT`
+  oder `VEREIN01.DAT` (Präfix-Matching), was die Kompatibilität mit verschiedenen Export-Formaten der ZNS verbessert.
+- **Fehler-Reporting:** Wenn Pflichtdateien (Vereine, Reiter) im ZIP fehlen, werden nun explizite Warnungen generiert.
+- **UI-Veredelung:**
+  - Der `StammdatenImportScreen` zeigt nun die detaillierte Abschluss-Meldung des Backends in einem hervorgehobenen
+    Banner an (z.B. "X neu importiert, Y aktualisiert").
+  - Fehler- und Erfolgs-Zustände sind visuell deutlicher voneinander getrennt (PrimaryContainer vs ErrorContainer).
+  - Polling-Statusmeldungen wurden verbessert.
+
+## 🏁 Ergebnis
+
+Der Onboarding-Workflow ist nun nahtlos mit der Cloud-Suche verzahnt. Der ZNS-Import ist robuster gegenüber abweichenden
+Dateibenennungen im ZIP-Archiv.
+
+**Status:** ✅ Abgeschlossen