# 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.**