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,63 +1,10 @@
-# Analyse und Strategie zur Wiederherstellung und Strukturverbesserung
-
-**Datum:** 2026-01-02
-**Autor:** Junie
-**Kontext:** Dieser Bericht wurde nach einem großen Technologie-Upgrade (Kotlin 2.1.0+, Java 25, Spring Boot 3.5.x) erstellt, als die Infrastruktur und die Build-Prozesse instabil waren.
-
+---
+type: Report
+status: ARCHIVED
+owner: Lead Architect
+last_update: 2026-01-20
 ---

-Es ist eine klassische Situation: Nach einem großen Technologie-Upgrade knirscht es oft an den Schnittstellen. Da der `ping-service` als technischer Blueprint dient, ist er der absolut richtige Startpunkt.
+# Analyse Wiederherstellung (02.01.2026)

-Hier ist der Schlachtplan, um Ordnung zu schaffen und die hexagonale Architektur sauber zu etablieren:
-
-### 1. Wo beginnen? Bottom-Up vs. Top-Down
-Da die Infrastruktur aktuell nicht stabil läuft, wird ein **"Core-First"** Ansatz empfohlen, gefolgt vom **Backend-Durchstich**.
-
-*   **Zuerst: Core & Platform:** Ohne eine stabile Basis (`platform-bom`, `platform-dependencies`, `core-domain`) werden die anderen Module immer wieder Kompilierfehler werfen.
-*   **Dann: Der technische vertikale Durchstich (`ping-service`):** Sobald die Plattform steht, wird der Weg repariert: `Infrastruktur (Docker) -> Ping-Service -> Gateway`.
-*   **Zuletzt: Frontend:** Das Frontend (BFF-Gedanke) wird erst dann stabil, wenn die API-Contracts des Backends wieder verlässlich geliefert werden.
-
-### 2. Ordnung schaffen: Der "Clean Desk" im Projekt
-Bevor Code gefixt wird, muss die Build-Umgebung aufgeräumt werden:
-
-1.  **Version Catalog Synchronität:** Die `libs.versions.toml` nutzt bereits Java 25 und Kotlin 2.1.0. Es muss geprüft werden, ob alle Gradle-Plugins (insbesondere das `compose-multiplatform` und `spring-boot` Plugin) mit Kotlin 2.1.0 kompatibel sind.
-2.  **Modul-Konsolidierung (DDD):** Die "Modul-Explosion" sollte reduziert werden.
-    *   **Vorschlag:** Statt 5 Module pro Domain (`api`, `common`, `domain`, `infrastructure`, `service`), auf maximal zwei reduzieren:
-        *   `domain-api`: Nur DTOs und Interfaces (für KMP-Sharing mit dem Frontend).
-        *   `domain-service`: Die gesamte Implementierung (Hexagonal strukturiert in Packages).
-
-### 3. Hexagonale Architektur im `ping-service` umsetzen
-Der `ping-service` ist aktuell noch sehr "Spring-lastig". Für eine echte hexagonale Vorlage sollte das Modul `ping-service` intern wie folgt umstrukturiert werden:
-
-```text
-at.mocode.ping.service
-├── adapter
-│   ├── in
-│   │   └── web (PingController - Dein primärer Port-Adapter)
-│   └── out
-│       └── persistence (PingRepositoryAdapter - Sekundärer Port-Adapter)
-├── application
-│   ├── port
-│   │   ├── in (PingUseCase - Das Interface für den Controller)
-│   │   └── out (PingOutputPort - Interface für die Datenbank)
-│   └── service (PingService - Hier liegt die Business Logik, OHNE Spring-Annotationen wo möglich)
-└── domain
-    └── model (PingEntity/Value Objects)
-```
-
-### 4. Konkrete Schritte zur Reparatur
-
-**Schritt 1: Infrastruktur-Check (Docker)**
-*   Check `docker-compose.yaml`: Laufen Postgres und Keycloak?
-*   `ping-service` application.yaml: Die Datenbank-Verbindung (JPA) aktivieren.
-
-**Schritt 2: Backend API-Gateway Fix**
-*   Die Security-Konfiguration (`SecurityConfig.kt`) wegen Bibliotheks-Änderungen in Spring Security 7/Spring Boot 3.5 prüfen.
-
-**Schritt 3: Frontend (BFF) Anpassung**
-*   Der `PingApiClient` im Frontend sollte gegen das **Gateway** (BFF-Pattern) laufen, nicht direkt gegen den Service.
-
-### Empfehlung zur Vorgehensweise (Prioritäten):
-1.  **Gradle-Build stabilisieren:** Alle `:platform:*` und `:core:*` Module müssen mit `./gradlew build` fehlerfrei durchlaufen.
-2.  **Ping-SCS fertigstellen:** Eine minimale Datenbank-Speicherung im `ping-service` implementieren.
-3.  **Gateway-Security:** Sicherstellen, dass das JWT von Keycloak korrekt zum `ping-service` durchgereicht wird.
+**MOVED:** This file has been archived to `_archive/2026-01-02_Analyse_Wiederherstellung-Strukturverbesserung.md`.