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
parent e8124c047a
commit aba5b5c7a0
29 changed files with 816 additions and 3598 deletions
@@ -0,0 +1,66 @@
+---
+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/`