docs: massive restructuring of documentation, development guides and agent playbooks

docs/04_Operations/Infrastructure/Reference/ports-and-urls.md

@@ -0,0 +1,48 @@
+---
+type: Reference
+owner: DevOps Engineer
+status: ACTIVE
+review_cycle: 180d
+last_reviewed: 2025-10-31
+summary: "Übersicht der wichtigsten lokalen URLs und Ports. Quelle: docker-compose.yaml + config/env"
+last_update: 2026-03-15
+---
+
+# Referenz: Wichtige URLs und Ports (lokal)
+
+Quelle der Wahrheit für Ports/URLs (Repo-aktuell):
+
+* `docker-compose.yaml`
+* `config/env/.env` (und optional `config/env/.env.local`)
+
+## Infrastruktur
+
+- API Gateway: http://localhost:8081
+- Keycloak (Auth): http://localhost:8180
+- Consul (Service Discovery): http://localhost:8500
+- PostgreSQL: localhost:5432
+- Redis: localhost:6379
+
+## Services
+
+- Ping Service: http://localhost:8082
+- Members Service: http://localhost:8083
+- Horses Service: http://localhost:8084
+- Events Service: http://localhost:8085
+- Masterdata Service: http://localhost:8086
+
+## Monitoring
+
+- Prometheus: http://localhost:9090
+- Grafana: http://localhost:3000
+
+## Clients
+
+- Web App: http://localhost:4000
+- Desktop App (VNC): localhost:5901
+- Desktop App (noVNC): http://localhost:6080
+
+## Hinweise
+
+- Die oben genannten Ports sind aus dem aktuellen Compose-/Env-Setup abgeleitet.
+- Bei Port-Konflikten passe die Werte in `config/env/.env` an (oder nutze lokale Overrides in `config/env/.env.local`).