scripte/nexarch

0 Fork 0

Files

T

History

patrickandClaude Sonnet 5 4bfdaa4bca

CI / Core-Modul (Build/Vet/Test) (push) Canceled after 0s

Details

CI / DMS Security-Test-Gate (AC5, Merge-Gate) (push) Canceled after 0s

Details

CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (push) Canceled after 0s

Details

CI / DMS-Modul Supply-Chain-Scan (govulncheck) (push) Canceled after 0s

Details

CI / Web (dms-browser) (push) Canceled after 0s

Details

CI / Web (pdf-viewer) (push) Canceled after 0s

Details

CI / Web (shl) (push) Canceled after 0s

Details

MET-07: Sidecar-Beschreibung, Betriebsprobe

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-09-20 21:49:45 +02:00

nexarch-dms-kosit.service

MET-07: konformitätsvalidierung e-rechnung (Client, Migration 0029, Verdrahtung)

2026-09-20 21:46:44 +02:00

README.md

MET-07: Sidecar-Beschreibung, Betriebsprobe

2026-09-20 21:49:45 +02:00

README.md

KoSIT-Validator als Sidecar (MET-07)

Prüft E-Rechnungen (XRechnung, ZUGFeRD/Factur-X) gegen XSD und Schematron. Läuft als eigener Dienst, nur auf 127.0.0.1:8610 (DMS-Portbereich 8600-8699, deploy/ports.tsv). Der DMS-Worker spricht ihn über NEXARCH_DMS_WORKER_KOSIT_ADDR an. Ohne diese Variable ist das Ergebnis immer not_checked.

Bestandteile (feste Versionen, Prüfsummen SHA-256)

Datei	Version	SHA-256
Temurin JRE (Linux x64)	21.0.12.1	`2413149700df0f7d440500a84a8f764c535f21e5a5e87d38328b64eec2c5b500`
`validator-1.6.3-standalone.jar`	1.6.3	`799e64befca97d4080e03608c80b85dd5a5ecc5f4ae4f35d1116ec2855b9a7c9`
`xrechnung-3.0.2-validator-configuration-2026-08-31.zip`	XRechnung 3.0.2, Regelwerk 2026-08-31	`2530cd107c414511c5d0462ec10f886910395abfca820db82e83d70bf01221a8`

Quellen: github.com/adoptium/temurin21-binaries, github.com/itplr-kosit/validator, github.com/itplr-kosit/validator-configuration-xrechnung. Versionen unter 1.6.3 nicht verwenden (Lücke bei der URI-Auflösung im STRICT_LOCAL-Modus).

Installation (nur unter /opt/nexarch-kosit, nichts am System ändern)

useradd --system --no-create-home --home-dir /opt/nexarch-kosit --shell /usr/sbin/nologin nexarch-kosit
mkdir -p /opt/nexarch-kosit/{dl,jre,validator,config}
# Downloads nach dl/, Prüfsummen mit sha256sum -c prüfen, dann:
tar xzf dl/jre.tgz -C /opt/nexarch-kosit/jre --strip-components=1
cp dl/validator-standalone.jar /opt/nexarch-kosit/validator/
unzip -q dl/config.zip -d /opt/nexarch-kosit/config
chown -R root:root /opt/nexarch-kosit && chmod -R go-w /opt/nexarch-kosit
cp nexarch-dms-kosit.service /etc/systemd/system/
systemctl daemon-reload && systemctl enable --now nexarch-dms-kosit

Der Start dauert etwa 20 Sekunden (Laden der Szenarien). Der Dienst hat MemoryMax=768M, -Xmx384m und läuft ohne Rechte außerhalb von /opt/nexarch-kosit.

Betrieb

Worker: NEXARCH_DMS_WORKER_KOSIT_ADDR=http://127.0.0.1:8610, NEXARCH_DMS_WORKER_KOSIT_RULESET=xrechnung-3.0.2-2026-08-31 (Bezeichnung des installierten Regelwerks, wird im Ergebnis gespeichert), optional NEXARCH_DMS_WORKER_KOSIT_TIMEOUT_SECONDS.
Regelwerk-Update: Konfigurationspaket austauschen, Dienst neu starten, ..._RULESET ändern, Worker neu starten. Der Worker reiht beim Start die Neuprüfung aller Rechnungen ein, deren letztes Ergebnis nicht zum neuen Regelwerk passt oder not_checked ist. Alte Ergebnisse bleiben.
Der Daemon hat keine Zugriffskontrolle: nie an eine andere Adresse als Loopback binden.

Rückbau

systemctl disable --now nexarch-dms-kosit
rm /etc/systemd/system/nexarch-dms-kosit.service && systemctl daemon-reload
rm -rf /opt/nexarch-kosit
userdel nexarch-kosit

Bereits abgelegte Ergebnisse (revision_einvoice_conformance) bleiben erhalten; ohne Validator entstehen neue Ergebnisse mit not_checked.