chore: refactor Gradle config, standardize Kotlin MPP plugin usage, and update dependencies

- Unified plugin application across modules using `alias(libs.plugins.*)` instead of hardcoded IDs. - Removed redundant JVM/JS source map tasks, improving Gradle and Docker build consistency. - Updated dependencies, including `logback` and Webpack `copy-webpack-plugin`, and added contextual documentation. - Added frontend architecture diagram in PlantUML (`docs/01_Architecture/Reference`), standardizing feature-core-shell dependencies.
2026-02-03 22:11:31 +01:00
parent c613acb91d
commit 03e1484dd3
24 changed files with 246 additions and 377 deletions
@@ -0,0 +1,57 @@
+# Session Log: Diagnose Docker Build Issues (IsolatedKotlinClasspathClassCastException)
+
+**Datum:** 03.02.2026
+**Teilnehmer:** User, DevOps Engineer
+**Fokus:** Behebung des `IsolatedKotlinClasspathClassCastException` Fehlers im Docker-Build des Frontends.
+
+## 🎯 Ziel
+Den Docker-Build für den `web-app` Service reparieren, der mit einem `IsolatedKotlinClasspathClassCastException` fehlschlägt, während der lokale Build erfolgreich ist.
+
+## 📝 Protokoll
+
+### 1. Ausgangslage
+*   **Fehler:** `IsolatedKotlinClasspathClassCastException: The Kotlin Gradle plugin was loaded multiple times in different subprojects...`
+*   **Kontext:** Tritt nur im Docker-Container auf (Gradle 9.3.1, Java 25, KMP 2.3.0).
+*   **Lokaler Build:** Funktioniert einwandfrei (`./gradlew clean build`).
+
+### 2. Durchgeführte Maßnahmen & Analysen
+
+#### A. Caching-Hypothese
+*   **Vermutung:** Docker Build-Cache (`--mount=type=cache`) verursacht Inkonsistenzen.
+*   **Aktion:** Cache-Mounts im Dockerfile deaktiviert.
+*   **Ergebnis:** ❌ Build schlägt weiterhin fehl.
+
+#### B. Plugin-Konfiguration (Subprojekte)
+*   **Vermutung:** `frontend:core:auth` wendet Plugins falsch an oder hat Konflikte durch `browser()` Target.
+*   **Aktion 1:** `browser()` durch `nodejs()` ersetzt. -> ❌ Fehlschlag.
+*   **Aktion 2:** `js` Target komplett entfernt (temporär). -> ❌ Fehlschlag (Kompilierfehler, aber Plugin-Fehler weg -> Compose als Verdächtiger).
+*   **Aktion 3:** Legacy `apply(plugin = ...)` Syntax versucht. -> ❌ Fehlschlag (DSL Accessors fehlen).
+
+#### C. Root-Projekt Konfiguration
+*   **Vermutung:** `NodeJsRootPlugin` wird nicht zentral geladen.
+*   **Aktion 1:** `js { browser(); nodejs() }` im Root `build.gradle.kts` hinzugefügt. -> ❌ Fehlschlag.
+*   **Aktion 2:** `apply<NodeJsRootPlugin>()` explizit im Root ausgeführt. -> ❌ Fehlschlag.
+*   **Aktion 3:** `buildscript { dependencies { classpath("kotlin-gradle-plugin") } }` Hack angewendet, um Plugin in Root-Classloader zu zwingen. -> ❌ Fehlschlag.
+
+#### D. Umgebungsvariablen & Daemon
+*   **Vermutung:** Gradle Daemon oder parallele Ausführung im Docker verursacht Race Conditions.
+*   **Aktion:** `--no-daemon` und `org.gradle.parallel=false` gesetzt. `GRADLE_USER_HOME` auf `/workspace/.gradle` geändert.
+*   **Ergebnis:** ❌ Fehlschlag.
+
+#### E. Downgrade-Versuch
+*   **Aktion:** Versuch, auf Gradle 8.12 downzugraden.
+*   **Ergebnis:** ❌ Gescheitert, da Gradle 8.12 Java 25 nicht unterstützt (`IllegalArgumentException: 25.0.2`).
+
+### 3. Ergebnis & Fazit
+*   Das Problem ist ein **Bug in der Interaktion zwischen Gradle 9.x, Kotlin 2.3.0 und Docker**.
+*   Es manifestiert sich als Classloader-Isolation-Problem, bei dem das `NodeJsRootPlugin` mehrfach geladen wird, obwohl es das nicht sollte.
+*   Alle gängigen Workarounds (Cache, Daemon, explizites Laden) haben versagt.
+*   Ein Downgrade ist aufgrund der Java 25 Abhängigkeit nicht trivial möglich.
+
+### 4. Nächste Schritte (Empfehlung)
+1.  **Warten auf Upstream-Fix:** Das Problem liegt bei JetBrains/Gradle.
+2.  **Temporärer Workaround (nicht implementiert):** Java-Version auf 21 senken und Gradle auf 8.10 downgraden (würde aber Code-Änderungen erfordern, da Java 25 Features genutzt werden).
+3.  **Lokal bauen, Docker nur für Runtime:** Als Übergangslösung könnte das Artefakt lokal gebaut und in den Container kopiert werden, statt im Container zu bauen.
+
+## 🧹 Cleanup
+Alle experimentellen Änderungen an `build.gradle.kts`, `gradle.properties` und `Dockerfile` wurden rückgängig gemacht, um den Codebase sauber zu halten.