feat(desktop, network): Chat-Funktion hinzugefügt und P2P-Sync verbessert

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>

docs/02_Guides/Desktop-Packaging-Guide.md

@@ -1,98 +1,85 @@
-# 📦 Guide: Desktop App Packaging (Linux, Windows, macOS)
+# 📦 Guide: Desktop App Packaging (Conveyor & Gradle)
 
-Dieses Dokument beschreibt, wie die Meldestelle Desktop App für verschiedene Betriebssysteme paketiert wird. Wir nutzen einen hybriden Ansatz aus **Gradle (Compose-Desktop)** für lokale Linux-Builds und **Conveyor** für das Cross-Packaging (Windows/macOS) von Linux aus.
+Dieses Dokument beschreibt den professionellen Packaging-Prozess für die Meldestelle Desktop App. Wir nutzen **Conveyor** als primäres Werkzeug für das Cross-Platform Packaging (Windows, Linux, macOS), da es stabile Installer inklusive signierter Updates und gebündelter JREs erzeugt.
 
 ---
 
-## 1. Voraussetzungen
+## 1. Strategie: Conveyor vs. Gradle
 
-### Linux (Entwicklungsrechner / Fedora)
-Um native Pakete bauen zu können, müssen folgende Werkzeuge auf dem System vorhanden sein:
+| Feature | Conveyor (Empfohlen) | Gradle (Compose Plugin) |
+| :--- | :--- | :--- |
+| **Zielgruppe** | Endanwender (Produktion) | Entwickler (Lokaler Test) |
+| **Plattformen** | Windows (.msix), Linux (.deb), macOS | Nur Host-OS (Linux auf Linux) |
+| **Updates** | Automatisch integriert | Manuell |
+| **JRE** | Amazon Corretto (isoliert) | System JRE oder Toolchain |
 
-```bash
-# Für RPM-Pakete (Fedora)
-sudo dnf install rpm-build
+---
 
-# Für DEB-Pakete (Ubuntu/Debian)
-sudo apt install dpkg-dev fakeroot
-```
+## 2. Cross-Packaging mit Conveyor
 
-### Conveyor (Cross-Packaging Tool)
-Conveyor wird benötigt, um von Linux aus Windows-Installer (.msi) oder macOS-Pakete zu erzeugen.
+Conveyor ist so konfiguriert, dass es von Linux aus Pakete für alle Zielsysteme schnüren kann.
 
-**Installation auf Fedora/Linux:**
-Da automatisierte Skripte manchmal unzuverlässig sind, hier der direkte Weg über das Binär-Paket:
-
-1. **Tarball herunterladen:**
-   Besuchen Sie [https://downloads.hydraulic.dev/conveyor/download.html](https://downloads.hydraulic.dev/conveyor/download.html) und laden Sie die neueste `linux-amd64.tar.gz` Datei herunter.
-
-2. **Manuelle Installation:**
+### Voraussetzungen
+1. **JAR-Dateien:** Die App muss kompiliert sein:
    ```bash
-   # Entpacken
-   tar -xvf hydraulic-conveyor-*-linux-amd64.tar.gz
-   # In den Pfad verschieben
-   sudo mv conveyor /usr/local/bin/
+   ./gradlew :frontend:shells:meldestelle-desktop:jvmJar
    ```
+2. **Icons:** Das System sucht nach `icon.png` in `frontend/shells/meldestelle-desktop/src/jvmMain/resources/`.
 
-3. **Verifizieren:**
-   ```bash
-   conveyor --version
-   ```
+### Pakete bauen
+Führen Sie Conveyor im Projekt-Root aus:
 
----
-
-## 2. Lokale Linux-Builds (Gradle)
-
-Die schnellste Methode, um während der Entwicklung ein installierbares Paket für das eigene System zu erstellen.
-
-### RPM-Paket (Fedora)
 ```bash
-./gradlew :frontend:shells:meldestelle-desktop:packageRpm
-```
-*Ausgabe: `frontend/shells:meldestelle-desktop/build/compose/binaries/main/rpm/`*
-
-### DEB-Paket (Ubuntu/Debian)
-```bash
-./gradlew :frontend:shells:meldestelle-desktop:packageDeb
-```
-*Ausgabe: `frontend/shells:meldestelle-desktop/build/compose/binaries/main/deb/`*
-
-### Portable Version (Ohne Installation)
-```bash
-./gradlew :frontend:shells:meldestelle-desktop:createDistributable
-```
-*Ausgabe: `frontend/shells:meldestelle-desktop/build/compose/binaries/main/app/`*
-
----
-
-## 3. Cross-Packaging mit Conveyor
-
-Conveyor nutzt die kompilierte JAR-Datei und schnürt daraus Pakete für alle Zielplattformen.
-
-### Schritt 1: JAR erstellen
-```bash
-./gradlew :frontend:shells:meldestelle-desktop:jvmJar
-```
-
-### Schritt 2: Pakete bauen
-```bash
-# Erstellt den Windows-Installer und die HTML-Downloadseite
+# Komplette Release-Site (Windows & Linux)
 conveyor make site
+
+# Nur ein spezifisches Paket (schneller für Tests)
+conveyor make debian-package   # Linux .deb
+conveyor make windows-msix      # Windows .msix
 ```
 
-### Schritt 3: Ergebnisse
-Die fertigen Installer (z.B. `.msi` für Windows) befinden sich im neu erstellten Ordner `output/`.
+Die Ergebnisse liegen im Ordner `output/`.
 
 ---
 
-## 4. Problembehandlung & Optimierung
+## 3. Konfiguration (`conveyor.conf`)
 
-### Native Access Warnungen
-Die App benötigt Zugriff auf native Bibliotheken (Netty/SQLite). Der notwendige Parameter `--enable-native-access=ALL-UNNAMED` ist bereits fest hinterlegt.
+Wichtige Parameter der aktuellen Konfiguration (v1.0.1):
+*   **JDK:** Nutzt `Amazon Corretto 21` für maximale Cross-Platform Stabilität.
+*   **Heap-Size:** Erhöht auf `-Xmx1024m`, um auch große Stammdaten-Importe zu bewältigen.
+*   **Linux-Deps:** Automatische Installation von `libasound2`, `libgl1-mesa-glx` und `libx11-6`.
+*   **Native Access:** `--enable-native-access=ALL-UNNAMED` ist für Netty/SQLite aktiviert.
 
-### Firewall-Konfiguration
-Für Netzwerk-Tests (Discovery/Chat) müssen die Ports 8090, 8080 und 5353 (UDP) geöffnet sein.
-Nutzen Sie dafür das bereitgestellte Skript:
+---
+
+## 4. Netzwerk & Sicherheit (WICHTIG)
+
+Damit die P2P-Funktionen (Chat, Discovery, Sync) nach der Installation funktionieren, müssen folgende Ports auf dem Host-System offen sein:
+
+| Port | Protokoll | Funktion |
+| :--- | :--- | :--- |
+| **8080** | TCP | P2P Sync & Datenabgleich |
+| **8090** | TCP | Veranstaltungs-Chat (WebSocket) |
+| **5353** | UDP | mDNS Discovery (Geräte finden) |
+
+### Firewall-Einrichtung (Linux)
+Nutzen Sie das optimierte Setup-Script:
 ```bash
 sudo ./setup-firewall-linux.sh
 ```
+
+### Windows-Besonderheit
+Beim ersten Start der `.msix` App wird Windows fragen, ob der Netzwerkzugriff erlaubt werden soll. **Wichtig:** Sowohl "Private" als auch "Öffentliche" Netzwerke anhaken, falls auf Turnieren oft Gast-WLANs oder Hotspots genutzt werden.
+
+---
+
+## 5. Troubleshooting
+
+### Problem: "No main class specified"
+**Lösung:** Stellen Sie sicher, dass in der `Main.kt` eine saubere Top-Level `fun main()` existiert und in der `conveyor.conf` auf `at.mocode.frontend.shell.desktop.MainKt` verwiesen wird.
+
+### Problem: SQLite / Native Libs laden nicht
+**Lösung:** Prüfen Sie, ob `extract-native-libraries.conf` in der `conveyor.conf` inkludiert ist.
+
+### Problem: JmDNS findet keine Teilnehmer
+**Lösung:** Prüfen Sie die Ports via `ss -tulpn`. Auf Linux blockieren oft Docker-Interfaces (`br-*`) den Broadcast. Die App filtert diese nun automatisch, aber ein aktives `setup-firewall-linux.sh` ist zwingend erforderlich.

docs/ACTIVE_TASK.md

@@ -2,27 +2,25 @@
 
 **Status:** 🏗️ In Arbeit
 **SCS:** Desktop App / Infrastructure
-**Branch:** `feature/desktop-network-chat` (neuer Branch, erstellt ausgehend von `feature/turnier-anlage-wizard`)
+**Branch:** `feature/desktop-network-chat`
 
 ## 🎯 Aktuelles Ziel
-1. **Netzwerk-Kommunikation (Chat POC):** Implementierung einer simplen Chat-Funktion für die Desktop-App, die im lokalen Netzwerk funktioniert (Verbindungstest).
-2. **Multi-Node Architektur:** Host-Client-Modell (1..n Hosts, 1..n Clients) vorbereiten. Hosts und Clients müssen in einem lokalen Netzwerk (LAN/WLAN) plattformunabhängig (Windows, Mac, Linux) stabil kommunizieren können.
-3. **Conveyor Build (Pausiert):** Lauffähiger Build der Desktop-App via Conveyor für Windows (.msi/.exe) und Linux. Bereitstellung über Web-App. Wird nach dem Netzwerk-Proof-of-Concept in Angriff genommen.
+1. **Stabile Netzwerk-Kommunikation:** Implementierung einer robusten P2P-Kommunikation mit Reconnection-Logik und Heartbeats.
+2. **Multi-Node Architektur:** Host-Client-Modell stabilisiert.
+3. **Professional Packaging:** Vorbereitung für echte Installer (.msi, .deb) via Conveyor.
 
 ## 🛠️ Letzte Änderungen
-- Fokus auf Netzwerk- & Offline-Fähigkeiten gelegt. Turnier-Anlage-Wizard pausiert.
-- Neuer Branch `feature/desktop-network-chat` für die anstehenden Arbeiten.
+- **Hardening P2P:** `JvmP2pSyncService` komplett refactored. Jetzt mit automatischem Reconnect (3s Intervall) und Ktor Heartbeats (Ping/Pong alle 5s).
+- **Conveyor:** Konfiguration (`conveyor.conf`) für v1.0.1 vorbereitet (größere JVM Heaps, Linux Abhängigkeiten).
+- **Firewall Script:** Verbessert und um Kommentare/mDNS erweitert.
 
 ## 📍 Fokus-Bereiche
-- Lokale Netzwerk-Discovery (z.B. Ktor, UDP Broadcast, mDNS).
-- P2P oder Client-Server Chat-Kommunikation im lokalen Netzwerk für den Verbindungs-Check.
-- KMP Desktop-Modul.
-
-## 🚧 Offene Punkte / Blocker
-- [ ] Konzept für Host/Client-Discovery im lokalen Netz umsetzen.
-- [ ] Implementierung eines lokalen Chat-Moduls in der Desktop-App (Linux/Desktop-Test).
-- [ ] Erfolgreicher Conveyor Build für Windows & Linux (Später).
+- [x] Robuste Reconnection-Logik im P2P Service.
+- [x] Heartbeats zur Erkennung toter Verbindungen.
+- [ ] In-App Feedback bei Firewall-Blockaden.
+- [ ] Multi-Node Test mit > 2 Teilnehmern.
 
 ## 🔄 Nächste Schritte
-- [ ] Architektur-Entscheidung (ADR) für lokale Netzwerk-Discovery und Kommunikation treffen (Ktor Sockets, UDP, etc.).
-- [ ] Erste Implementierung des Discovery-Mechanismus.
+- [ ] Multi-Node Stabilitätstest (Simulierte Netzwerk-Drops).
+- [ ] Integration von Firewall-Checks im Connectivity-Wizard.
+- [ ] Erster Test-Build via Conveyor auf lokaler Maschine.