meldestelle/docs/99_Journal/2026-04-16_Health-Connectivity-Fix.md
2026-04-16 18:47:21 +02:00

1.9 KiB

📓 Journal-Eintrag: 2026-04-16 - Health-Fixes & Connectivity Refactoring

🏗️ Status Quo

Nach der Integration des ZNS-First Wizards gab es Stabilitätsprobleme in der Docker-Umgebung (Unhealthy Services) und eine fachliche Fehlinterpretation des ping-service.

🚀 Wichtigste Korrekturen

1. Actuator & Docker Stability

  • Problem: masterdata-service und events-service meldeten unter Docker 404 auf den Readiness-Probes.
  • Lösung: Explizite Aktivierung der Spring Boot Probes (management.endpoint.health.probes.enabled: true) in den jeweiligen application.yml Dateien.
  • Docker-Compose: Vereinheitlichung der Healthchecks in dc-backend.yaml auf den /actuator/health/readiness Endpoint mit detaillierterer Diagnose (--no-verbose).

2. Connectivity Refactoring (The Ping "Un-Abuse")

  • Problem: Der ConnectivityTracker im Frontend nutzte den ping-service, um den generellen Online-Status ("Cloud synchronisiert") anzuzeigen. Der ping-service soll jedoch nur ein technischer Durchstich sein.
  • Lösung: Umstellung des ConnectivityTracker auf den neutralen /actuator/health/readiness Endpoint des API-Gateways.
  • Resultat: Der ping-service ist wieder frei für seine ursprüngliche Bestimmung als technisches Validierungs-Tool. Der Footer-Status repräsentiert nun korrekt die Erreichbarkeit der Cloud-Infrastruktur über das Gateway.

🛠️ Technische Details

  • Services: api-gateway, masterdata-service, events-service, ping-service.
  • Frontend: frontend:core:network (ConnectivityTracker.kt).

🧹 [Curator]: Health-Checks und Connectivity-Logik bereinigt. Dokumentation aktualisiert. 👷 [Backend Developer]: Alle Services sind nun auch unter Docker stabil healthy. 🏗️ [Lead Architect]: Fachliche Trennung von System-Health und technischem Durchstich (Ping) wiederhergestellt.