From a0dc0750cbfcbab5651438cddb64cd6b6fe3cd07 Mon Sep 17 00:00:00 2001 From: Eduard Wisch Date: Mon, 17 Aug 2026 18:05:26 +0200 Subject: [PATCH] README: Anmeldung nur noch ueber awlauth, PDF-Renderer und netdiagPdfText ergaenzt Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 7cb4f6c..2a95a9a 100644 --- a/README.md +++ b/README.md @@ -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.