Stefan Mogeritsch
aba5b5c7a0
Archived several outdated reports (`Ping-Service_Impl_01-2026.md`, `Frontend_Integration_Status.md`, etc.) and added archival notes and references to updated documents. Introduced a centralized reference structure for tech stack documentation, consolidating files under `01_Architecture/Reference/Tech_Stack`. Added new resources (`Gradle_Kotlin_DSL_Primer`, `Kotlin_2-3-0_ReleaseNotes`) for improved project organization and clarity.
1.5 KiB
1.5 KiB
| type | status | owner | tags | ||||
|---|---|---|---|---|---|---|---|
| Guide | ACTIVE | DevOps Engineer |
|
Start Local (Lokales Setup)
Kurzanleitung, um das Projekt lokal in wenigen Minuten zu starten.
Voraussetzungen
- Docker und Docker Compose (v2)
- Java 25 (JDK)
- Git
Schnellstart
# 1) Repository klonen
git clone https://github.com/StefanMoCoAt/meldestelle.git
cd meldestelle
# 2) Runtime-Environment vorbereiten
# Kopiere die Vorlage.
cp .env.example .env
# 3) Infrastruktur starten (Postgres, Redis, Keycloak, Monitoring, Gateway)
docker compose --profile infra up -d
# 4) Backend starten (Gateway + Ping Service)
docker compose --profile backend up -d
Sobald die Infrastruktur läuft, erreichst du unter anderem:
- Gateway: http://localhost:8081
- Keycloak: http://localhost:8180
- Grafana: http://localhost:3000
- Prometheus: http://localhost:9090
Tests ausführen
# Führt alle Tests aus
./gradlew test
# Spezifisches Backend-Modul testen
./gradlew :backend:services:ping:ping-service:test
Troubleshooting
- Dienste starten nicht? Ports belegt oder Logs prüfen:
docker ps docker logs <container-name> - Infrastruktur neu starten:
docker compose down -v docker compose --profile infra up -d - Environment-Variablen: werden aus der
.env-Datei im Root-Verzeichnis geladen.
Weiterführende Hinweise
- Architektur:
docs/01_Architecture/MASTER_ROADMAP_2026_Q1.md - ADRs:
docs/01_Architecture/adr/ - Aktuelle Reports:
docs/90_Reports/