meldestelle/docs/06_Frontend/Guides/POC_INITIALISIERUNG.md

🏗️ [Lead Architect] Datum: 30. April 2026

🧪 POC-Anleitung: Zero-Config Initialisierung

Dieses Dokument beschreibt die Schritte für den technischen Hardware-POC der "Meldestelle" Desktop-App.

1. Bauen der App

Führen Sie auf Ihrem Entwicklungsrechner aus:

./gradlew :frontend:shells:meldestelle-desktop:createDistributable

Kopieren Sie den Ordner frontend/shells/meldestelle-desktop/build/compose/binaries/main/app auf einen USB-Stick.

2. Test am Master-PC (PC-1)

1. Starten Sie die App vom Stick.
2. Wählen Sie die Rolle Master (Host).
3. Vergeben Sie einen Namen (z.B. "Meldestelle-Zentrale").
4. Geben Sie den Sicherheitsschlüssel (Demo: 1234) ein.
5. Wählen Sie den USB-Pfad für Plan-USB aus (Native FileDialog öffnet sich).
6. Klicken Sie auf "Initialisierung abschließen".

3. Test am Client-PC (PC-2)

1. Starten Sie die App auf dem zweiten PC im selben LAN.
2. Wählen Sie die Rolle Client.
3. Wait-State: Sie sollten nun die Meldung "Suche nach der Meldestelle..." sehen.
4. Sobald der Master aktiv ist, erscheint er in der Liste.
5. Klicken Sie auf den Master-Eintrag.
6. Geben Sie denselben Sicherheitsschlüssel (1234) ein.
7. Klicken Sie auf "Jetzt verbinden".
8. Verifikation: Bei Erfolg erscheint ein grüner Haken und die Meldung "Verbunden mit Meldestelle-Zentrale".

4. Erfolgskriterien

• Master wird vom Client automatisch gefunden (mDNS).
• Client kann sich per Klick verbinden.
• Native Dateidialoge sind lesbar und stabil.
• Handshake-Feedback (Grün/Rot) funktioniert.