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

2026-06-15 12:54:38 +02:00
parent e4988b4397
commit ce63303b2c
686 changed files with 45423 additions and 319 deletions
@@ -0,0 +1,37 @@
+🏗️ **[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:
+```bash
+./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.