From 21ee130ebf5836f1fcad84d484a2cf76138fd764 Mon Sep 17 00:00:00 2001
From: StefanMoCoAt <stefan.mo.co@gmail.com>
Date: Mon, 8 Dec 2025 18:25:46 +0100
Subject: [PATCH] chore(MP-30): final docs cleanup, adr consolidation & legacy
 removal ### Summary - Rebuild `docs/how-to/start-local.md`

Ref: MP-30
---
 docs/how-to/start-local.md | 67 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 docs/how-to/start-local.md

diff --git a/docs/how-to/start-local.md b/docs/how-to/start-local.md
new file mode 100644
index 00000000..545220b5
--- /dev/null
+++ b/docs/how-to/start-local.md
@@ -0,0 +1,67 @@
+ # Start Local (Lokales Setup)
+
+ Kurzanleitung, um das Projekt lokal in wenigen Minuten zu starten.
+
+ ## Voraussetzungen
+ - Docker und Docker Compose (v2)
+ - Java 21 (JDK)
+ - Git
+
+ ## Schnellstart
+
+ ```bash
+ # 1) Repository klonen
+ git clone https://github.com/StefanMoCoAt/meldestelle.git
+ cd meldestelle
+
+ # 2) Runtime-Environment vorbereiten (Single Source of Truth)
+ #   Kopiere die Vorlage und passe sie bei Bedarf an.
+ cp -n .env.template config/env/.env 2>/dev/null || true
+ #   Optionale lokale Geheimnisse/Overrides (gitignored):
+ #   echo "POSTGRES_PASSWORD=meinlokalespasswort" >> config/env/.env.local
+
+ # 3) (Optional) Compose-Files generieren
+ #    (nur falls du die Generator-Pipeline nutzt)
+ # DOCKER_SSOT_MODE=envless bash scripts/generate-compose-files.sh all development
+
+ # 4) Infrastruktur starten (Postgres, Redis, Kafka, Keycloak, Monitoring, Gateway)
+ docker compose -f docker-compose.yaml up -d
+
+ # 5) Backend-Service starten (Beispiel: Results Service)
+ ./gradlew :backend:services:results:results-service:bootRun
+ # oder – falls zentral gewollt und unterstützt:
+ # ./gradlew bootRun
+ ```
+
+ 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
+ ./gradlew test
+ # Spezifisches Modul
+ ./gradlew :backend:services:results:results-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 -f docker-compose.yaml down -v
+   docker compose -f docker-compose.yaml up -d
+   ```
+ - Environment-Variablen: in `config/env/.env` und optional `config/env/.env.local`.
+
+ ## Weiterführende Hinweise
+ - Architektur: `docs/ARCHITECTURE.md`
+ - ADRs: `docs/adr/`
+ - C4-Diagramme: `docs/c4/`
+
+ Stand: Dezember 2025