meldestelle/docs/02_Onboarding/start-local.md
Stefan Mogeritsch a454e6c97a docs: restructure domain documentation and update references
Implemented a standardized folder structure for domain documentation to improve clarity and maintainability. Migrated existing files to the new structure, updated links in related documentation, and added README files for navigation and guidance.
2026-01-15 13:44:49 +01:00

1.8 KiB

Start Local (Lokales Setup)

Kurzanleitung, um das Projekt lokal in wenigen Minuten zu starten.

Wichtiger Hinweis (Januar 2026): Der Build ist derzeit aufgrund eines Kotlin/Wasm-Compiler-Problems blockiert. Die Infrastruktur und die Backend-Services können jedoch unabhängig davon gestartet werden.

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 -f docker-compose.yaml up -d

# 4) Backend-Service starten (Beispiel: Results Service)
./gradlew :backend:services:results:results-service:bootRun

Sobald die Infrastruktur läuft, erreichst du unter anderem:

Tests ausführen

# Führt alle Tests aus (Frontend-Tests könnten fehlschlagen)
./gradlew test

# Spezifisches Backend-Modul testen
./gradlew :backend:services:results:results-service:test

Troubleshooting

  • Dienste starten nicht? Ports belegt oder Logs prüfen:
    docker ps
    docker logs <container-name>
    
  • Infrastruktur neu starten:
    docker compose -f docker-compose.yaml down -v
    docker compose -f docker-compose.yaml up -d
    
  • Environment-Variablen: werden aus der .env-Datei im Root-Verzeichnis geladen.

Weiterführende Hinweise

  • Architektur: docs/01_Architecture/ARCHITECTURE.md (veraltet, siehe Reports)
  • ADRs: docs/01_Architecture/adr/
  • Aktuelle Reports: docs/90_Reports/

Stand: Januar 2026 (teilweise aktualisiert)