README: Anmeldung nur noch ueber awlauth, PDF-Renderer und netdiagPdfText ergaenzt
All checks were successful
Deploy netdiag / deploy (push) Has been skipped

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Eduard Wisch 2026-08-17 18:05:26 +02:00
parent 0779440347
commit a0dc0750cb

View file

@ -8,10 +8,13 @@ Messungen und hängt die Protokolle dauerhaft an **Kunde** und **Auftrag**.
- 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. Anmeldung seit
v1.1.0 über das zentrale Auth-Modul **awlauth** (Brute-Force-Bremse,
gemeinsame Sitzungsliste, „Gerät abmelden"); der alte modul-eigene JWT-Pfad
bleibt als Rückfall, bis alle Geräte die neue APK haben
- JSON-API unter `/custom/netdiag/api/` für die mobile App. Anmeldung
**ausschließlich** über das zentrale Auth-Modul **awlauth** (Brute-Force-Bremse,
gemeinsame Sitzungsliste, „Gerät abmelden"). Der modul-eigene JWT-Pfad ist mit
v1.2.0 entfallen: er stellte Tokens aus, die an der awlauth-Sitzungsliste
vorbeiliefen — „Gerät abmelden" hatte darauf keine Wirkung. Ohne aktives
awlauth antwortet die Anmeldung mit 503 statt auf einen zweiten Weg auszuweichen.
Die Gültigkeit bestimmt allein `AWLAUTH_TTL` im awlauth-Setup (Standard 7 Tage)
- PDF-Protokoll, wird im Dokumentenarchiv (ECM) abgelegt
- **Zwei Sichten auf dieselben Messdaten:** die Technikeransicht zeigt alles,
das Kunden-PDF nur eine Whitelist (siehe „Neue Messart" unten)
@ -27,8 +30,9 @@ Messungen und hängt die Protokolle dauerhaft an **Kunde** und **Auftrag**.
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.
`llx_netdiag_device`, `llx_netdiag_measurement` angelegt.
**Voraussetzung: das Modul AWL-Auth muss aktiv sein** — ohne es gibt es
keine Anmeldung an der API (seit v1.2.0, siehe oben).
4. Benutzern das Recht **NetDiag → Protokolle lesen/schreiben** geben.
## API-Endpunkte
@ -63,6 +67,8 @@ ankommt, sind **drei** Stellen in `lib/netdiag.lib.php` zu pflegen:
|----------|-------|----------------|
| `netdiagKundenfelder()` | Whitelist + Beschriftung + Einheit | Feld verschwindet im Kunden-PDF spurlos, übrig bleibt die Ampel |
| `netdiagToolName()` | Klarname des Werkzeugs | beim Kunden steht „[netzwerk] meintool" |
| eigener PDF-Zweig | Werkzeuge mit Listenergebnis | alle Zeilen landen als `\|`-Kette in EINER Tabellenzelle |
| `netdiagPdfText()` | Unicode aus der App | Pfeile/Häkchen werden wortlos zu „?" (Core-Font, KB #1092) |
| `netdiagKundentext()` | Rohwerte übersetzen/entschärfen | englische API-Werte im deutschen Abnahmedokument |
Spiegelbildlich dazu `app/src/lib/messfelder.ts` in der App.