meldestelle/docs/99_Journal/2026-04-30_Netzwerk-Discovery-Fix.md

Curator Journal - 30. April 2026

🛠️ Netzwerk-Discovery Fix (Meilenstein 0)

Status: Verifikation durch Hardware-POC ausstehend (Iteration 2)

Der erste Hardware-POC des Users zeigte Probleme bei der automatischen Discovery der Desktop-Instanzen auf. Trotz erfolgreichem Pings fanden sich die Instanzen nicht.

🔍 Ursachenanalyse

1. Unpräzises mDNS-Binding: JmDNS nutzte standardmäßig getLocalHost(), was in vielen Netzwerk-Konfigurationen (insb. bei VPNs oder Docker-Interfaces wie vom User gemeldet: 172.17.x.x) auf das falsche Interface bindet.
2. UI-Unklarheit: Der User erkannte nicht, ob ein Interface aktiv ist oder ob die Discovery überhaupt läuft.

🚀 Durchgeführte Änderungen

1. Core-Network (mDNS):
   • NetworkDiscoveryService und JmDnsDiscoveryService erweitert, um ein explizites IP-Binding zu ermöglichen.
   • Die Discovery wird nun hart an die IP des vom User gewählten Netzwerk-Interfaces gebunden.
2. Features-Device-Initialisierung:
   • UI-Rewrite: Die Dropdown-Liste wurde durch ein interaktives Karten-Layout ersetzt.
   • Status-Indikatoren: Jedes Interface zeigt nun einen farbigen Punkt (Grün für LAN/WLAN-IPs, Rot für andere) und Icons (🔌/🌐) zur schnellen Identifikation.
   • Auto-Discovery: Sobald ein Interface gewählt oder die Rolle gewechselt wird, wird die Discovery/Registrierung automatisch neu gestartet.
3. Guides:
   • POC_INITIALISIERUNG.md aktualisiert mit klaren Verifikationsschritten für das Netzwerk-Interface.

⚠️ Wichtiger Hinweis für den User

Bitte die Desktop-App mit ./gradlew :frontend:shells:meldestelle-desktop:createDistributable neu bauen und erneut auf die Ziel-Hardware übertragen. Achten Sie im Assistenten auf den grünen Punkt bei der Interface-Wahl.

Curator Ende.