Files
meldestelle/docs/02_Guides/start-local.md
T
stefan aba5b5c7a0 docs: archive outdated reports and organize references
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.
2026-01-23 13:34:20 +01:00

1.5 KiB

type, status, owner, tags
type status owner tags
Guide ACTIVE DevOps Engineer
setup
local
docker
gradle

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:

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/