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.
67 lines
1.5 KiB
Markdown
67 lines
1.5 KiB
Markdown
---
|
|
type: Guide
|
|
status: ACTIVE
|
|
owner: DevOps Engineer
|
|
tags: [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
|
|
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
docker ps
|
|
docker logs <container-name>
|
|
```
|
|
- Infrastruktur neu starten:
|
|
```bash
|
|
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/`
|