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,52 +1,10 @@
 ---
 type: Journal
-date: 2026-01-19
-author: Lead Architect
-participants:
-  - Frontend Expert
-  - Infrastructure & DevOps
-  - QA Specialist
-status: COMPLETED
+status: ARCHIVED
+owner: Lead Architect
+last_update: 2026-01-20
 ---

-# Session Log: 19. Jänner 2026
+# Session Log (19.01.2026)

-## Zielsetzung
-Abschluss des "Trace Bullet" (Ping Feature) durch Abarbeitung der offenen Punkte aus dem Handover vom 17.01., Bereinigung der Frontend-Struktur und Inbetriebnahme der lokalen Entwicklungsumgebung.
-
-## Durchgeführte Arbeiten
-
-### 1. Frontend Refactoring & Cleanup
-*   **Migration:** Tests aus `at.mocode.clients.pingfeature` wurden in die Clean Architecture Struktur (`at.mocode.ping.feature.data` und `presentation`) migriert.
-*   **Cleanup:** Das alte Package `at.mocode.clients.pingfeature` wurde vollständig entfernt (inkl. Tests).
-*   **Integration Test:** Ein neuer `PingSyncIntegrationTest` wurde erstellt, der den Datenfluss vom API-Client bis zum Repository verifiziert.
-*   **Dependency Injection Fixes:**
-    *   `SyncModule` nutzt nun korrekt den `named("apiClient")` HttpClient.
-    *   `localDbModule` wurde in `main.kt` (Desktop Shell) registriert, um `DatabaseProvider` verfügbar zu machen.
-*   **Code Quality:** Unused Imports, Variables und redundante Elvis-Operatoren wurden bereinigt.
-
-### 2. Infrastructure & Observability
-*   **Tracing Fix:** Der `ping-service` hatte die Tracing-Dependencies (`monitoring-client`) nicht eingebunden. Dies wurde in der `build.gradle.kts` korrigiert.
-*   **Local Dev Config:**
-    *   `monitoring-defaults.properties` wurde angepasst, damit Zipkin lokal unter `localhost:9411` angesprochen wird (statt `zipkin:9411`).
-    *   `application.yaml` des `ping-service` wurde bereinigt, um zentrale Defaults zu nutzen.
-*   **Docker Compose:**
-    *   `docker-compose.yaml` wurde strukturiert und um **Mailpit** erweitert.
-    *   Services (Postgres, Redis, Consul, Zipkin, Keycloak) laufen stabil.
-
-### 3. Build & Contracts
-*   **API Visibility:** `contracts:ping-api` exportiert nun `core-domain` via `api` statt `implementation`. Dies behebt die Compiler-Warnung `Cannot access 'Syncable'`.
-
-### 4. Dokumentation
-*   **Architecture:** Neue Datei `docs/01_Architecture/02_Frontend_Architecture.md` erstellt, die die Modularisierungsstrategie und Clean Architecture Vorgaben festhält.
-
-## Ergebnisse
-*   **Build:** GRÜN.
-*   **Backend:** Gateway und Ping-Service laufen lokal und kommunizieren mit der Docker-Infrastruktur. Tracing funktioniert.
-*   **Frontend:** Desktop-App startet erfolgreich.
-*   **Architektur:** Konsistent und sauber (keine Legacy-Pakete mehr im Ping-Feature).
-
-## Nächste Schritte (Ausblick)
-*   **Frontend Debugging:** Analyse der verbleibenden Laufzeit-Probleme in der Desktop-App.
-*   **Feature Development:** Beginn der Arbeit an den Fachdomänen (Veranstaltungen/Events).
-*   **Auth Migration:** Migration des `auth-feature` auf die neue Architektur bei nächster Gelegenheit.
+**MOVED:** This file has been archived to `_archive/2026-01-19_Session_Log.md`.