README: Anmeldung nur noch ueber awlauth, PDF-Renderer und netdiagPdfText ergaenzt
All checks were successful
Deploy netdiag / deploy (push) Has been skipped
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:
parent
0779440347
commit
a0dc0750cb
1 changed files with 12 additions and 6 deletions
18
README.md
18
README.md
|
|
@ -8,10 +8,13 @@ Messungen und hängt die Protokolle dauerhaft an **Kunde** und **Auftrag**.
|
||||||
|
|
||||||
- Datenmodell: Protokoll → Geräte → Messungen (`llx_netdiag_*`)
|
- Datenmodell: Protokoll → Geräte → Messungen (`llx_netdiag_*`)
|
||||||
- Tab **Netzwerk-Diagnose** an Kunde (thirdparty) und Auftrag (commande)
|
- Tab **Netzwerk-Diagnose** an Kunde (thirdparty) und Auftrag (commande)
|
||||||
- JSON-API unter `/custom/netdiag/api/` für die mobile App. Anmeldung seit
|
- JSON-API unter `/custom/netdiag/api/` für die mobile App. Anmeldung
|
||||||
v1.1.0 über das zentrale Auth-Modul **awlauth** (Brute-Force-Bremse,
|
**ausschließlich** über das zentrale Auth-Modul **awlauth** (Brute-Force-Bremse,
|
||||||
gemeinsame Sitzungsliste, „Gerät abmelden"); der alte modul-eigene JWT-Pfad
|
gemeinsame Sitzungsliste, „Gerät abmelden"). Der modul-eigene JWT-Pfad ist mit
|
||||||
bleibt als Rückfall, bis alle Geräte die neue APK haben
|
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
|
- PDF-Protokoll, wird im Dokumentenarchiv (ECM) abgelegt
|
||||||
- **Zwei Sichten auf dieselben Messdaten:** die Technikeransicht zeigt alles,
|
- **Zwei Sichten auf dieselben Messdaten:** die Technikeransicht zeigt alles,
|
||||||
das Kunden-PDF nur eine Whitelist (siehe „Neue Messart" unten)
|
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.
|
synct das Modul automatisch auf den Server.
|
||||||
2. In Dolibarr: **Einrichtung → Module → NetDiag** aktivieren.
|
2. In Dolibarr: **Einrichtung → Module → NetDiag** aktivieren.
|
||||||
3. Beim Aktivieren werden die Tabellen `llx_netdiag_protocol`,
|
3. Beim Aktivieren werden die Tabellen `llx_netdiag_protocol`,
|
||||||
`llx_netdiag_device`, `llx_netdiag_measurement` angelegt und ein
|
`llx_netdiag_device`, `llx_netdiag_measurement` angelegt.
|
||||||
JWT-Schlüssel erzeugt.
|
**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.
|
4. Benutzern das Recht **NetDiag → Protokolle lesen/schreiben** geben.
|
||||||
|
|
||||||
## API-Endpunkte
|
## 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 |
|
| `netdiagKundenfelder()` | Whitelist + Beschriftung + Einheit | Feld verschwindet im Kunden-PDF spurlos, übrig bleibt die Ampel |
|
||||||
| `netdiagToolName()` | Klarname des Werkzeugs | beim Kunden steht „[netzwerk] meintool" |
|
| `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 |
|
| `netdiagKundentext()` | Rohwerte übersetzen/entschärfen | englische API-Werte im deutschen Abnahmedokument |
|
||||||
|
|
||||||
Spiegelbildlich dazu `app/src/lib/messfelder.ts` in der App.
|
Spiegelbildlich dazu `app/src/lib/messfelder.ts` in der App.
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue