docs: enhance local dev docs, update Docker Compose, and archive old journals

Added Mailpit setup and updated Keycloak configuration in local development runbooks. Improved Docker Compose stability with updated service dependencies and configurations. Archived outdated journal entries and documents for better organization.
2026-01-20 14:00:09 +01:00
parent 5dc8f18201
commit 46361185d0
56 changed files with 596 additions and 1832 deletions
@@ -1,35 +1,10 @@
-# Session Log: Prozess-Optimierung & Cleanup
+---
+type: Journal
+status: ARCHIVED
+owner: Curator
+last_update: 2026-01-20
+---

-**Datum:** 15.01.2026
-**Autor:** Documentation & Knowledge Curator
-**Thema:** Verbesserung der Agenten-Kollaboration und Dokumentations-Hygiene.
+# Session Log Cleanup (15.01.2026)

-## 1. Zusammenfassung
-In dieser Session wurden die Arbeitsabläufe der KI-Agenten optimiert und die Projektdokumentation grundlegend aufgeräumt. Ziel war es, Reibungsverluste bei der Übergabe (Handover) zu minimieren und eine klare Unterscheidung zwischen "aktuell" und "veraltet" zu schaffen.
-
-## 2. Durchgeführte Änderungen
-
-### A. Agent Playbooks (Prozess)
-Alle Playbooks in `docs/04_Agents/Playbooks/` wurden aktualisiert:
-*   **Domain Expert:** Nutzt nun **Gherkin** für Requirements-Handover.
-*   **Architect:** Liefert Diagramme (Mermaid/PlantUML) statt nur Text.
-*   **QA Specialist:** "Shift-Left" Ansatz (Prüfung schon während der Analyse).
-*   **Devs (Backend/Frontend/DevOps):** Einführung von **Pre-Flight Checks** vor der Umsetzung.
-*   **Curator:** Neue Rolle als **Quality Gate** für Dokumentations-Standards.
-
-### B. Dokumentations-Strategie
-*   **Archivierung:** Einführung von `_archive/` Unterordnern in allen Bereichen. Veraltete Dokumente werden nicht gelöscht, sondern verschoben (mit Datums-Präfix).
-*   **Standard-Header:** Jedes Dokument muss nun einen YAML-Frontmatter Header haben (`status: ACTIVE | ARCHIVED`, `owner`, `last_update`).
-*   **Single Source of Truth:** Die `MASTER_ROADMAP` wurde als alleinige Quelle für die Planung etabliert.
-
-### C. Cleanup
-Folgende Bereiche wurden bereinigt und archiviert:
-*   `01_Architecture`: Alte Roadmaps archiviert.
-*   `05_Backend`: Alte Roadmap archiviert.
-*   `90_Reports`: Veraltete Status-Reports archiviert.
-*   `06_Frontend` & `07_Infrastructure`: Header aktualisiert.
-
-## 3. Ergebnis
-Das Projekt verfügt nun über einen sauberen, konsistenten Dokumentations-Stand. Die Regeln für die Zusammenarbeit der Agenten sind formalisiert und in den Playbooks verankert.
-
-**Status:** ✅ Session erfolgreich abgeschlossen.
+**MOVED:** This file has been archived to `_archive/2026-01-15_Session_Log_Cleanup_and_Process.md`.