meldestelle/docs/02_Domain/Development/start-local.md
Stefan Mogeritsch 7d71ca9a48 docs: add 2026 Austrian tournament regulations and special provisions
Added updated documentation for the 2026 Austrian Tournament Regulations, including general rules, special provisions, fees, and technical details. Covers Dressage, Jumping, and Eventing classes, along with appendices for heights and requirements across disciplines.
2026-01-14 14:45:28 +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)