# NetDiag — Netzwerk-Diagnose für Dolibarr

Dolibarr-Modul für die Ablage von Netzwerk-Diagnose-Protokollen. Erfasst per
mobiler App (siehe Projekt `NetzwerkDiagnose/app`) gefundene Geräte, Ports und
Messungen und hängt die Protokolle dauerhaft an **Kunde** und **Auftrag**.

## Funktionen

- Datenmodell: Protokoll → Geräte → Messungen (`llx_netdiag_*`)
- Tab **Netzwerk-Diagnose** an Kunde (thirdparty) und Auftrag (commande)
- JSON-API unter `/custom/netdiag/api/` für die mobile App (JWT-Auth)
- PDF-Protokoll, wird im Dokumentenarchiv (ECM) abgelegt
- Rechtesystem: `netdiag → protocol → read/write/delete`
- Mehrsprachig (de_DE, en_US)
- QR-Code zum App-Download in der Modul-Einrichtung

## Installation

1. Verzeichnis `netdiag/` nach `htdocs/custom/` auf den Dolibarr-Server kopieren.
   Auf dem Produktivsystem übernimmt das die Forgejo-Pipeline
   (`.forgejo/workflows/deploy.yml`) — Commit mit `[deploy]` in der Message
   synct das Modul automatisch auf den Server.
2. In Dolibarr: **Einrichtung → Module → NetDiag** aktivieren.
3. Beim Aktivieren werden die Tabellen `llx_netdiag_protocol`,
   `llx_netdiag_device`, `llx_netdiag_measurement` angelegt und ein
   JWT-Schlüssel erzeugt.
4. Benutzern das Recht **NetDiag → Protokolle lesen/schreiben** geben.

## API-Endpunkte

Alle unter `https://<dolibarr>/custom/netdiag/api/`:

| Endpunkt | Methode | Zweck |
|----------|---------|-------|
| `auth.php` | POST `{login,password}` | Anmeldung → `{token,expiresIn,user}` |
| `customers.php` | GET `?q=` / `?id=` | Kundensuche / Kundendetail |
| `orders.php` | GET `?open=1&q=` / `?id=` | Auftragsliste / Auftragsdetail |
| `protocols.php` | GET `?id=` | Protokoll mit Geräten + Messungen |
| `protocols.php` | POST `{action:"sync",protocol:{…}}` | Protokoll anlegen/aktualisieren (idempotent über `clientUuid`) |
| `pdf.php` | GET `?id=&jwt=` | Protokoll-PDF streamen |

Authentifizierung per `Authorization: Bearer <token>` oder `?jwt=<token>`.

## Einrichtung

**Einrichtung → Module → NetDiag → Einstellungen:**
- Token-Gültigkeit (Sekunden)
- App-Download-URL (APK) — wird als QR-Code angezeigt

## Lizenz

GPLv3