tooling: make .junie/.gemini docs-first (remove legacy guidelines)

2026-01-13 14:32:49 +01:00
parent 696c2e0bd8
commit ff0e1a36cc
66 changed files with 347 additions and 8923 deletions
@@ -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 25 (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