GraalVM 25 • JavaFX • Jakarta EE 10 • JPMS • Microservices-Ready
👉 Für den schnellsten Einstieg: GETTING-STARTED.md
📚 Vollständiger Dokumentations-Index: DOCUMENTATION-INDEX.md
# 1. Container starten (alle Services)
source ~/.bashrc
ruu-startup
# 2. Warte 2-3 Minuten
# 3. Projekt bauen
cd /home/r-uu/develop/github/main/root
mvn clean install
Das war’s! ✅
| Dokument | Beschreibung |
|---|---|
| GETTING-STARTED.md | ⭐ Schnellstart-Anleitung |
| DOCUMENTATION-INDEX.md | 📚 Vollständiger Dokumentations-Index |
| config/shared/docker/README.md | 🐳 Docker Setup & Container |
| DOCKER-HEALTH-CHECK-FIX.md | 🏥 Health Check & Auto-Fix System |
| root/lib/keycloak_admin/README.md | 🔐 Keycloak Setup & Management |
Alle Container starten automatisch mit restart: always:
postgres-jeeeraaah (Port 5432) - Datenbanken: jeeeraaah + lib_testpostgres-keycloak (Port 5433) - Keycloak-Datenbankkeycloak (Port 8080) - Identity & Access Managementjasperreports (Port 8090) - Report-ServiceStatus prüfen:
ruu-docker-ps
ruu-startup # Kompletter Startup (empfohlen!)
ruu-docker-ps # Container-Status
ruu-docker-logs # Alle Logs anzeigen
ruu-docker-restart # Alle Container neu starten
ruu-build # Projekt komplett bauen
ruu-install # cd root && mvn clean install
ruu-install-fast # mvn clean install -DskipTests
ruu-postgres-shell # SQL Shell öffnen
ruu-postgres-ensure-lib-test # lib_test Datenbank prüfen/erstellen
ruu-keycloak-admin # Admin-URL anzeigen
ruu-keycloak-setup # Realm einrichten
ruu-help # Alle Aliase anzeigen
ruu-versions # Tool-Versionen prüfen
Mehr: config/shared/wsl/aliases.sh
cd /home/r-uu/develop/github/main/root/app/jeeeraaah/backend/api/ws_rs
mvn liberty:dev
Backend URLs:
IntelliJ: Run Configuration DashAppRunner
Oder manuell:
cd /home/r-uu/develop/github/main/root/app/jeeeraaah/frontend/ui/fx
mvn exec:java -Dexec.mainClass="de.ruu.app.jeeeraaah.frontend.ui.fx.dash.DashAppRunner"
main/
├── bom/ # Bill of Materials (zentrale Dependency-Verwaltung)
├── root/
│ ├── app/
│ │ └── jeeeraaah/
│ │ ├── backend/ # OpenLiberty REST API (Port 9080)
│ │ │ ├── api/ws_rs/ # REST Endpoints
│ │ │ └── persistence/ # JPA Entities
│ │ └── frontend/ # JavaFX UI
│ │ ├── api.client/ # REST Client
│ │ └── ui/fx/ # DashAppRunner (JavaFX)
│ ├── lib/ # Wiederverwendbare Libraries
│ │ ├── keycloak.admin/ # Keycloak Setup & Management
│ │ ├── jpa/ # JPA Core
│ │ └── office/word/ # Dokument-Generierung
│ │ ├── docx4j/ # DOCX4J Implementation
│ │ └── jasperreports/ # JasperReports Service
│ └── sandbox/ # Experimente & Prototypen
└── config/
└── shared/
├── docker/ # Docker Compose Konfiguration
├── scripts/ # Build & Setup Skripte
└── wsl/ # WSL-spezifische Konfiguration
# Gesamtprojekt bauen
cd /home/r-uu/develop/github/main/root
mvn clean install
# Nur Backend bauen
cd /home/r-uu/develop/github/main/root/app/jeeeraaah/backend/api/ws_rs
mvn clean package
# Container starten
docker compose up -d
# Container stoppen
docker compose down
# Container + Volumes löschen (Reset)
docker compose down -v
# Container Status
docker ps
# Setup ausführen
cd /home/r-uu/develop/github/main/root/lib/keycloak_admin
mvn exec:java -Dexec.mainClass="de.ruu.lib.keycloak.admin.setup.KeycloakRealmSetup"
# Admin Console
# URL: http://localhost:8080/admin
# Login: admin / changeme_in_local_env
# Dev-Modus (Hot Reload)
cd /home/r-uu/develop/github/main/root/app/jeeeraaah/backend/api/ws_rs
mvn liberty:dev
# Nur starten
mvn liberty:run
# Stoppen
mvn liberty:stop
Fehler:
Java 25 is not supported by the current version of Byte Buddy
Lösung: ✅ BEREITS BEHOBEN!
Byte Buddy wurde auf Version 1.18.4 aktualisiert in bom/pom.xml.
Hinweis: 1.18.4 ist die neueste stabile Version (Stand: Januar 2026) und unterstützt Java 25 vollständig.
Fehler:
invalid_client
Lösung:
Fehler:
Connection refused (Port 9080)
Lösung: Backend starten (siehe Schritt 3 oben)
Lösung:
# Container neustarten
cd /home/r-uu/develop/github/main/config/shared/docker
docker compose restart postgres-jeeeraaah
# Logs prüfen
docker logs postgres-jeeeraaah
# Prüfe welcher Prozess Port nutzt
sudo lsof -i:9080 # Backend
sudo lsof -i:8080 # Keycloak
sudo lsof -i:5432 # PostgreSQL
| Service | URL | Credentials |
|---|---|---|
| Keycloak Admin | http://localhost:8080/admin | admin / changeme_in_local_env |
| Keycloak Realm | http://localhost:8080/realms/jeeeraaah-realm | - |
| Backend API | http://localhost:9080/jeeeraaah/ | - |
| Backend Health | http://localhost:9080/health | - |
| JasperReports | http://localhost:8090/health | - |
NICHT unter Git-Kontrolle:
config.properties (Root-Level)testing.properties (Frontend)Datenbank (PostgreSQL):
db.host=localhost
db.port=5432
db.name=lib_test
db.user=r_uu
db.password=r_uu_password
Keycloak:
keycloak.url=http://localhost:8080
keycloak.realm=jeeeraaah-realm
keycloak.client=jeeeraaah-frontend
Backend REST API:
jeeeraaah.rest-api.scheme=http
jeeeraaah.rest-api.host=localhost
jeeeraaah.rest-api.port=9080
# 1. Docker Container starten (falls nicht laufen)
docker compose up -d
# 2. Backend starten
cd /home/r-uu/develop/github/main/root/app/jeeeraaah/backend/api/ws_rs
mvn liberty:dev
# 3. Frontend in IntelliJ starten
# Run → DashAppRunner
# Dependencies aktualisieren
cd /home/r-uu/develop/github/main/root
mvn clean install
# Container komplett reset
cd /home/r-uu/develop/github/main/config/shared/docker
docker compose down -v
docker compose up -d
# Keycloak Realm neu erstellen
cd /home/r-uu/develop/github/main/root/lib/keycloak_admin
mvn exec:java -Dexec.mainClass="de.ruu.lib.keycloak.admin.setup.KeycloakRealmSetup"
root/app/jeeeraaah/backend/api/ws_rs/README.mdIAM-KEYCLOAK-LIBERTY-GUIDE.mdconfig/shared/docker/README.md🎉 WENN ALLE PUNKTE ✅, DANN LÄUFT ALLES!