Add read-only Hermes document links

This commit is contained in:
gitea_admin committed 2026-09-21 15:00:04 +02:00
1 parent d0079aa5f7
commit 3d7f6b1820
4 files changed
+102 -2

No files matched your search

@@ -22,6 +22,36 @@ Der Token wird nicht in dieser Dokumentation oder im Repository gespeichert.
## Verbindungsablauf
## Dokumentlinks in Marktdurchführungen
Wenn Hermes Informationen aus einer Datei verarbeitet und diese in einer
Marktdurchführung speichert, muss Hermes die Quelldatei als vollständige
HTTPS-URL in das Feld `notes` aufnehmen. Der bestehende Text darf erhalten
bleiben; die Position im Freitext ist frei wählbar.
Die URL verwendet dieses Format:
```text
https://erpnaurua.imhochrain.ch/files.php?path=<RFC-3986-url-encodierter-relativer-Pfad>
```
Der Parameter `path` ist relativ zum Ordner `Hermes Naurua` und enthält nicht
den lokalen Mount-Prefix und nicht den Ordnernamen `Hermes Naurua` selbst.
Beispiel:
```text
Quelldatei: Hermes Naurua/Marktmanagement/2026 Bellevue Noël/Standmietvertrag_Naurua.pdf
Link: https://erpnaurua.imhochrain.ch/files.php?path=Marktmanagement%2F2026%20Bellevue%20No%C3%ABl%2FStandmietvertrag_Naurua.pdf
```
Leerzeichen, Umlaute und sonstige Sonderzeichen müssen vollständig URL-encodiert
werden. Die ERP-Anzeige macht ausschließlich diese Dokument-URLs klickbar. Der
Link ist schreibgeschützt und erfordert eine aktive ERP-Anmeldung.
Die Route benötigt auf dem ERP-Webserver die Konfiguration
`HERMES_DOCUMENT_ROOT=/volume1/Hermes/Hermes Naurua`. Dieser lokale Pfad ist
die auf DEV verifizierte Ablage der Synology-Freigabe.
## Fachliche Begrifflichkeit für Hermes
Die fachliche Hierarchie lautet:
@@ -68,7 +68,10 @@ Modulberechtigung.
- Fehlgeschlagene Aufrufe erzeugen keine Teilpersistierung.
- Alle Schreibvorgänge laufen über die interne Modul-API.
- Hermes darf bei einem neuen Markt nur eine bestehende Kategorie referenzieren.
- Dokumentlinks können optional als Herkunftsinformation mitgegeben werden.
- Wenn Hermes Informationen aus einer Datei verarbeitet und in einer
Marktdurchführung speichert, muss die Quelldatei als vollständige HTTPS-URL
im Feld `notes` referenziert werden. Die Position im bestehenden Freitext ist
frei wählbar.
- Unsichere Erkennung wird nicht durch eine zusätzliche App-Freigabelogik
behandelt; die fachliche Qualitätssicherung liegt im Hermes-Training.