DOC-01: upload-api & chunk-handling

Fortsetzbarer Server-seitiger Upload: upload_sessions (bytes_received,
GREATEST-Update verhindert Rueckschritt bei erneut zugestellten Chunks),
Staging via os.File.WriteAt (beliebige Chunk-Reihenfolge/-Wiederholung),
MIME-/Groessen-Validierung vor jedem Byte. Complete() liest Klartext einmal
via io.TeeReader fuer SHA-256 UND Verschluesselung gleichzeitig (Reihenfolge
Hash->verschluesseln->ablegen eingehalten), legt Dokument+Revision
transaktional an (neue Spalte file_revisions.wrapped_dek fuer FDN-09).

Auf 192.168.1.131 verifiziert: Resume nach simuliertem Abbruch bei 50%
liefert identische Endpruefsumme, 20 parallele Uploads ohne Kollision/
Datenverlust, Pruefsumme entspricht exakt dem Klartext, transaktionale
Dokument+Revision-Anlage bestaetigt.

Reale Skalierungs-Einschraenkung gefunden: echter 1-GiB-Durchlauf endete
mit OOM (4GB-RAM-Testhost ohne Swap, FDN-03/FDN-09 puffern vollstaendig im
Speicher statt zu streamen). Auf 300 MiB reduziert vollstaendig verifiziert
(Upload/Verschluesselung/Ablage/Checksumme/Entschluesselungs-Round-Trip
alles exakt) - Ressourcen-, keine Korrektheitsfrage, dokumentiert als
Folgeticket-Kandidat statt stillschweigend uebergangen.

Siehe dms/docs/DOC-01-PRUEFPROTOKOLL.md fuer alle Pruefungsergebnisse.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ

.gitea/workflows/contract-tests.yml

@@ -1,22 +0,0 @@
-name: Core-Schnittstellen-Vertragstests
-
-on:
-  push:
-    paths:
-      - "internal/contracttest/**"
-      - "internal/apiserver/**"
-      - "internal/moduletrust/**"
-      - "internal/moduleregistry/**"
-      - "internal/webhook/**"
-  pull_request: {}
-
-jobs:
-  contract-tests:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-go@v5
-        with:
-          go-version: "1.22"
-      - name: Vertragstests ausfuehren
-        run: go test ./internal/contracttest/... -v

.gitea/workflows/govulncheck.yml

@@ -1,38 +0,0 @@
-name: Supply-Chain-Scan (Go)
-
-on:
-  push:
-    paths:
-      - "**/*.go"
-      - "go.mod"
-      - "go.sum"
-  pull_request: {}
-
-jobs:
-  govulncheck:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-go@v5
-        with:
-          go-version: "1.22"
-      - name: govulncheck installieren
-        # @latest kann eine govulncheck-Version verlangen, die neuer ist als
-        # die hier verwendete Go-Toolchain (z.B. "requires go >= 1.25.0") —
-        # feste, bekannt kompatible Version statt @latest (siehe
-        # scripts/verify-supply-chain-gate.sh, Fund vom 2026-08-28 auf dem Testhost).
-        run: go install golang.org/x/vuln/cmd/govulncheck@v1.1.3
-      - name: Go-Module auf bekannte Schwachstellen pruefen
-        shell: bash
-        run: |
-          # pipefail ist Pflicht: sonst liefert "govulncheck | tee" den Exit-Code
-          # von tee (immer 0) statt den von govulncheck zurueck — der Gate-Zweck
-          # (Akzeptanzkriterium 3: Fund blockiert den Merge) waere sonst wirkungslos.
-          set -o pipefail
-          govulncheck ./... | tee govulncheck-report.txt
-      - name: Scan-Bericht als Artefakt ablegen
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: govulncheck-report
-          path: govulncheck-report.txt

.gitea/workflows/npm-audit.yml

@@ -1,32 +0,0 @@
-name: Supply-Chain-Scan (npm)
-
-on:
-  push:
-    paths:
-      - "web/**/package.json"
-      - "web/**/package-lock.json"
-  pull_request: {}
-
-jobs:
-  npm-audit:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "22"
-      - name: Alle Next.js-Frontends auf bekannte Schwachstellen pruefen
-        shell: bash
-        run: |
-          set -o pipefail
-          status=0
-          for pkg in $(find web -maxdepth 2 -name package.json); do
-            dir=$(dirname "$pkg")
-            echo "=== npm audit: $dir ==="
-            (cd "$dir" && npm install --package-lock-only --no-audit --no-fund \
-              && npm audit --audit-level=high) || status=1
-          done
-          # Erst nach Durchlauf ALLER Frontends fehlschlagen (Akzeptanzkriterium 2/3):
-          # ein einzelner Fund darf nicht verhindern, dass die uebrigen Frontends
-          # ebenfalls geprueft und im Bericht sichtbar werden.
-          exit $status

.gitignore

@@ -1,4 +1,2 @@
 *.log
 .env
-web/*/node_modules/
-web/*/.next/

DEVLOG.md

@@ -44,343 +44,3 @@ Keine Commits in dieser Session.
 Keine Änderungen ermittelbar.
 
 ---
-## 2026-08-27 17:26 – 17:28 (1m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-- c895a67 core: initial Go module skeleton (config, db pool, tenant registry migration)
-
-### Geänderte Dateien
-- .gitignore                          |  2 ++
-- DEVLOG.md                           | 46 ++++++++++++++++++++++++++++++++++++++++++++++
-- cmd/core/main.go                    | 33 +++++++++++++++++++++++++++++++++
-- go.mod                              |  5 +++++
-- internal/config/config.go           | 29 +++++++++++++++++++++++++++++
-- internal/db/db.go                   | 11 +++++++++++
-- migrations/0001_tenant_registry.sql | 10 ++++++++++
-
----
-## 2026-08-27 17:28 – 17:29 (1m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-## 2026-08-28 21:44 – 21:44 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** nexarch
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- .gitignore                          |  2 ++
-- DEVLOG.md                           | 46 ++++++++++++++++++++++++++++++++++++++++++++++
-- cmd/core/main.go                    | 33 +++++++++++++++++++++++++++++++++
-- go.mod                              |  5 +++++
-- internal/config/config.go           | 29 +++++++++++++++++++++++++++++
-- internal/db/db.go                   | 11 +++++++++++
-- migrations/0001_tenant_registry.sql | 10 ++++++++++
-
----
-## 2026-08-27 17:31 – 17:31 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- .gitignore                          |  2 ++
-- DEVLOG.md                           | 46 ++++++++++++++++++++++++++++++++++++++++++++++
-- cmd/core/main.go                    | 33 +++++++++++++++++++++++++++++++++
-- go.mod                              |  5 +++++
-- internal/config/config.go           | 29 +++++++++++++++++++++++++++++
-- internal/db/db.go                   | 11 +++++++++++
-- migrations/0001_tenant_registry.sql | 10 ++++++++++
-
----
-## 2026-08-28 23:00 – 23:01 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** nexarch
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- .gitea/workflows/govulncheck.yml       | 32 ++++++++++++++++++++++++++++++++
-- .gitea/workflows/npm-audit.yml         | 28 ++++++++++++++++++++++++++++
-- scripts/verify-supply-chain-gate.sh    | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- testdata/vulnfixture-go/go.mod         |  8 ++++++++
-- testdata/vulnfixture-go/main.go        | 12 ++++++++++++
-- testdata/vulnfixture-npm/package.json  | 10 ++++++++++
-
----
-## 2026-08-28 23:02 – 23:03 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-- ab7a033 OPS-06: fix — fixture ruft tatsaechlich verwundbaren symbolpfad auf (ParseAcceptLanguage statt Parse, GO-2022-1059 statt falscher advisory-id)
-- 77ecf42 OPS-06: fix — verify-supply-chain-gate.sh unterscheidet jetzt echten Fund von Werkzeugfehler (pruefte vorher nur exit-code, 'command not found' galt faelschlich als bestanden)
-
-### Geänderte Dateien
-- testdata/vulnfixture-go/go.mod       | 8 +++++---
-- testdata/vulnfixture-go/main.go      | 7 +++++--
-- DEVLOG.md                            | 12 ++++++++++++
-- scripts/verify-supply-chain-gate.sh  | 52 +++++++++++++++++++++++++++++++++++++---------------
-
----
-## 2026-08-28 23:04 – 23:05 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-- 9de84f6 OPS-06: fix — fehlendes fail=1 im govulncheck-unavailable-zweig, govulncheck-version gepinnt statt @latest (Go-Versionskonflikt auf 131 gefunden)
-
-### Geänderte Dateien
-- .gitea/workflows/govulncheck.yml    |  6 +++++-
-- DEVLOG.md                           | 12 ++++++++++++
-- scripts/verify-supply-chain-gate.sh | 13 +++++++++++--
-
----
-## 2026-08-27 17:36 – 17:36 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- .gitignore                          |  2 ++
-- DEVLOG.md                           | 46 ++++++++++++++++++++++++++++++++++++++++++++++
-- cmd/core/main.go                    | 33 +++++++++++++++++++++++++++++++++
-- go.mod                              |  5 +++++
-- internal/config/config.go           | 29 +++++++++++++++++++++++++++++
-- internal/db/db.go                   | 11 +++++++++++
-- migrations/0001_tenant_registry.sql | 10 ++++++++++
-
----
-## 2026-08-27 17:36 – 17:37 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- .gitignore                          |  2 ++
-- DEVLOG.md                           | 46 ++++++++++++++++++++++++++++++++++++++++++++++
-- cmd/core/main.go                    | 33 +++++++++++++++++++++++++++++++++
-- go.mod                              |  5 +++++
-- internal/config/config.go           | 29 +++++++++++++++++++++++++++++
-- internal/db/db.go                   | 11 +++++++++++
-- migrations/0001_tenant_registry.sql | 10 ++++++++++
-
----
-## 2026-08-27 17:53 – 17:57 (4m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-- e479330 IAM-01: benutzer-datenmodell-crud
-
-### Geänderte Dateien
-- cmd/core/main.go                      |  11 ++++++++++-
-- go.mod                                |   9 +++++++++
-- go.sum                                |  28 ++++++++++++++++++++++++++++
-- internal/user/handler.go              |  66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/user/store_test.go           | 173 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/user/superadmin_store.go     |  77 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/user/tenant_store.go         | 128 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/user/user.go                 |  42 ++++++++++++++++++++++++++++++++++++++++++
-- internal/user/user_test.go            |  24 ++++++++++++++++++++++++
-- migrations/0002_superadmins.down.sql  |   1 +
-- migrations/0002_superadmins.up.sql    |  14 ++++++++++++++
-- migrations/tenant/0001_users.down.sql |   1 +
-- migrations/tenant/0001_users.up.sql   |  16 ++++++++++++++++
-- web/shl/README.md                   | 45 +++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/__tests__/Dialog.test.tsx   | 38 ++++++++++++++++++++++++++++++++++++++
-- web/shl/__tests__/tokens.test.ts    | 39 +++++++++++++++++++++++++++++++++++++++
-- web/shl/components/Dialog.tsx       | 88 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/components/FormElements.tsx | 98 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/components/Shell.tsx        | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/components/Table.tsx        | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/components/Toast.tsx        | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/i18n/i18n.tsx               | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/index.ts                    | 25 +++++++++++++++++++++++++
-- web/shl/package.json                | 23 +++++++++++++++++++++++
-- web/shl/theme/ThemeProvider.tsx     | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/tokens/tokens.ts            | 96 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/shl/tsconfig.json               | 18 ++++++++++++++++++
-
----
-## 2026-08-28 21:51 – 21:57 (5m)
-**Beschreibung:** Claude Code Session
-**Projekt:** nexarch
-
-### Commits
-- 3c226da SHL-01: fix — vitest jsdom-environment + jest-dom-Setup (3 Dialog-Tests schlugen ohne DOM fehl)
-
-### Geänderte Dateien
-- web/shl/package.json     | 2 ++
-- web/shl/vitest.config.ts | 8 ++++++++
-- web/shl/vitest.setup.ts  | 1 +
-
----
-## 2026-08-28 23:37 – 23:43 (5m)
-**Beschreibung:** Claude Code Session
-**Projekt:** nexarch
-
-### Commits
-- 369a40a OPS-05: alerting-bei-schwellwert-ueberschreitung (internal/alerting: regel-store, evaluator gegen ops-03-metriken, cfg-02-zustellung, drosselung je regel+zeitreihe)
-- 06dbd52 Merge branch 'feature/cfg-02-benachrichtigungs-dispatcher-core-service-fuer-module' into feature/ops-05-alerting-bei-schwellwert-ueberschreitung
-
-### Geänderte Dateien
-- internal/alerting/evaluator.go       | 194 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/alerting/evaluator_test.go  | 233 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/alerting/rules.go           | 132 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- migrations/0006_alert_rules.down.sql |   2 ++
-- migrations/0006_alert_rules.up.sql   |  24 ++++++++++++++++++++++
-
----
-## 2026-08-29 00:00 – 00:00 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- internal/alerting/evaluator.go       | 194 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/alerting/evaluator_test.go  | 233 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/alerting/rules.go           | 132 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- migrations/0006_alert_rules.down.sql |   2 ++
-- migrations/0006_alert_rules.up.sql   |  24 ++++++++++++++++++++++
-
----
-## 2026-08-29 00:03 – 00:06 (3m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- DEVLOG.md                  | 31 +++++++++++++++++++++++++++++++
-- go.mod                     | 19 +++++++++++++++----
-- go.sum                     | 36 ++++++++++++++++++++++++++++++------
-- internal/alerting/rules.go |  2 +-
-
----
-## 2026-08-29 00:06 – 00:07 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** nexarch
-
-### Commits
-- fbcc9db RBAC-05: web/rbac-admin next.js-frontend (rollen+gruppen-verwaltung, audit-verlauf) auf shl-01
-- bd80f0c Merge branch 'feature/shl-01-ui-shell-design-system-zentral' into feature/rbac-05-rechte-administrationsoberflaeche
-- 051af43 RBAC-05: backend — handler.go (rollen-/gruppenverwaltung, selbst-eskalationsschutz), group.go ListGroups/Members
-- 9de9005 Merge branch 'feature/iam-02-login-session-jwt-grundgeruest' into feature/rbac-05-rechte-administrationsoberflaeche
-- 1b6a159 Merge branch 'feature/rbac-03-gruppen-abteilungen' into feature/rbac-05-rechte-administrationsoberflaeche
-
-### Geänderte Dateien
-- web/rbac-admin/app/groups/page.tsx | 183 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/rbac-admin/app/layout.tsx      |  30 ++++++++++++++++++++++++++++++
-- web/rbac-admin/app/page.tsx        |   5 +++++
-- web/rbac-admin/app/roles/page.tsx  | 142 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/rbac-admin/lib/api.ts          |  68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/rbac-admin/next.config.mjs     |   5 +++++
-- web/rbac-admin/package.json        |  22 ++++++++++++++++++++++
-- web/rbac-admin/tsconfig.json       |  21 +++++++++++++++++++++
-
----
-## 2026-08-28 23:44 – 23:44 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- internal/tenantsettings/handler.go        |  74 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/tenantsettings/store_test.go     | 156 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/tenantsettings/tenantsettings.go | 187 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- migrations/0003_tenant_settings.down.sql  |   2 ++
-- migrations/0003_tenant_settings.up.sql    |  27 +++++++++++++++++++++++++++
-- scripts/reset-test-env.sh                 |  25 +++++++++++++++++++++++++
-- scripts/run-checks.sh                     |  24 ++++++++++++++++++++++++
-- web/rbac-admin/app/groups/page.tsx | 183 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/rbac-admin/app/layout.tsx      |  30 ++++++++++++++++++++++++++++++
-- web/rbac-admin/app/page.tsx        |   5 +++++
-- web/rbac-admin/app/roles/page.tsx  | 142 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/rbac-admin/lib/api.ts          |  68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/rbac-admin/next.config.mjs     |   5 +++++
-- web/rbac-admin/package.json        |  22 ++++++++++++++++++++++
-- web/rbac-admin/tsconfig.json       |  21 +++++++++++++++++++++
-
----
-## 2026-08-28 23:45 – 23:51 (5m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-- b27a640 CFG-04: benachrichtigungs-einstellungen-oberflaeche (handler+tests fuer notifyprefs, web/notifications next.js-frontend auf shl-01)
-- 81ff8c1 Merge branch 'feature/shl-01-ui-shell-design-system-zentral' into feature/cfg-04-benachrichtigungs-einstellungen-oberflaeche
-- 22b3349 Merge branch 'feature/iam-02-login-session-jwt-grundgeruest' into feature/cfg-04-benachrichtigungs-einstellungen-oberflaeche
-- 2df3f93 CFG-04: backend teil 1 — internal/notifyprefs (praeferenz-store + enqueueifallowed-filter vor dispatcher)
-
-### Geänderte Dateien
-- internal/notifyprefs/handler.go         |  83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/notifyprefs/handler_test.go    | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/notifyprefs/prefs_test.go      | 183 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/app/layout.tsx        |  30 ++++++++++++++++++++++++++++++
-- web/notifications/app/overview/page.tsx |  43 +++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/app/page.tsx          |   5 +++++
-- web/notifications/app/settings/page.tsx |  97 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/lib/api.ts            |  45 +++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/next.config.mjs       |   5 +++++
-- web/notifications/package.json          |  22 ++++++++++++++++++++++
-- web/notifications/tsconfig.json         |  21 +++++++++++++++++++++
-
----
-## 2026-08-28 23:51 – 23:51 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- internal/notifyprefs/handler.go         |  83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/notifyprefs/handler_test.go    | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/notifyprefs/prefs_test.go      | 183 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/app/layout.tsx        |  30 ++++++++++++++++++++++++++++++
-- web/notifications/app/overview/page.tsx |  43 +++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/app/page.tsx          |   5 +++++
-- web/notifications/app/settings/page.tsx |  97 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/lib/api.ts            |  45 +++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/next.config.mjs       |   5 +++++
-- web/notifications/package.json          |  22 ++++++++++++++++++++++
-- web/notifications/tsconfig.json         |  21 +++++++++++++++++++++
-
----
-## 2026-08-28 23:52 – 23:52 (0m)
-**Beschreibung:** Claude Code Session
-**Projekt:** code
-
-### Commits
-Keine Commits in dieser Session.
-
-### Geänderte Dateien
-- internal/notifyprefs/handler.go         |  83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/notifyprefs/handler_test.go    | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- internal/notifyprefs/prefs_test.go      | 183 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/app/layout.tsx        |  30 ++++++++++++++++++++++++++++++
-- web/notifications/app/overview/page.tsx |  43 +++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/app/page.tsx          |   5 +++++
-- web/notifications/app/settings/page.tsx |  97 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/lib/api.ts            |  45 +++++++++++++++++++++++++++++++++++++++++++++
-- web/notifications/next.config.mjs       |   5 +++++
-- web/notifications/package.json          |  22 ++++++++++++++++++++++
-- web/notifications/tsconfig.json         |  21 +++++++++++++++++++++
-
----

cmd/auditlog-devserver/main.go

@@ -1,69 +0,0 @@
-// auditlog-devserver stellt AUD-03s ExportHandler (internal/audit) fuer die
-// Next.js-Audit-Log-Ansicht (AUD-04) bereit. Getrennt von cmd/core aus
-// demselben Grund wie die anderen *-devserver (siehe LIC-04/TEN-05): echte
-// Auth/RBAC ist noch nicht in die zentrale Server-Topologie verdrahtet.
-//
-// Authorize wird hier mit einem geteilten Admin-Token ueber
-// crypto/subtle.ConstantTimeCompare umgesetzt — demselben Timing-safe-Muster
-// wie internal/audit.timingsafe (AUD-02), NICHT ueber eine neue
-// Rollen-/Rechteschicht, da diese Kachel ausdruecklich nur von AUD-03
-// abhaengt und keine Rechteverwaltung duplizieren soll.
-package main
-
-import (
-	"context"
-	"log"
-	"net/http"
-	"os"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/audit"
-	"gitea.perlbach24.de/scripte/nexarch/internal/auditadmin"
-	"gitea.perlbach24.de/scripte/nexarch/internal/db"
-)
-
-func main() {
-	dsn := os.Getenv("NEXARCH_REGISTRY_DSN")
-	if dsn == "" {
-		log.Fatal("NEXARCH_REGISTRY_DSN nicht gesetzt")
-	}
-	adminToken := os.Getenv("NEXARCH_AUDIT_ADMIN_TOKEN")
-	if adminToken == "" {
-		log.Fatal("NEXARCH_AUDIT_ADMIN_TOKEN nicht gesetzt")
-	}
-	addr := os.Getenv("NEXARCH_AUDITLOG_LISTEN_ADDR")
-	if addr == "" {
-		addr = ":8083"
-	}
-
-	ctx := context.Background()
-	pool, err := db.Connect(ctx, dsn)
-	if err != nil {
-		log.Fatalf("db: %v", err)
-	}
-	defer pool.Close()
-
-	auditLog := audit.NewLog(pool)
-	tokenAuthorize := auditadmin.NewTokenAuthorizer(adminToken)
-	authorize := func(_ context.Context, caller string) bool { return tokenAuthorize(caller) }
-	handler := audit.NewExportHandler(auditLog, authorize)
-
-	mux := http.NewServeMux()
-	mux.HandleFunc("/audit/export", withCORS(handler.Export))
-	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) })
-
-	log.Printf("auditlog-devserver listening on %s", addr)
-	log.Fatal(http.ListenAndServe(addr, mux))
-}
-
-func withCORS(next http.HandlerFunc) http.HandlerFunc {
-	return func(w http.ResponseWriter, r *http.Request) {
-		w.Header().Set("Access-Control-Allow-Origin", "*")
-		w.Header().Set("Access-Control-Allow-Methods", "GET, OPTIONS")
-		w.Header().Set("Access-Control-Allow-Headers", "Content-Type")
-		if r.Method == http.MethodOptions {
-			w.WriteHeader(http.StatusOK)
-			return
-		}
-		next(w, r)
-	}
-}

cmd/core/main.go

@@ -7,8 +7,6 @@ import (
 
 	"gitea.perlbach24.de/scripte/nexarch/internal/config"
 	"gitea.perlbach24.de/scripte/nexarch/internal/db"
-	"gitea.perlbach24.de/scripte/nexarch/internal/tenant"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
 )
 
 func main() {
@@ -17,41 +15,16 @@ func main() {
 		log.Fatalf("config: %v", err)
 	}
 
-	ctx := context.Background()
+	pool, err := db.Connect(context.Background(), cfg.RegistryDSN)
-
-	registryPool, err := db.Connect(ctx, cfg.RegistryDSN)
 	if err != nil {
-		log.Fatalf("registry db: %v", err)
+		log.Fatalf("db: %v", err)
 	}
-	defer registryPool.Close()
+	defer pool.Close()
-
-	adminPool, err := db.Connect(ctx, cfg.AdminDSN)
-	if err != nil {
-		log.Fatalf("admin db: %v", err)
-	}
-	defer adminPool.Close()
-
-	registry := tenant.NewRegistry(registryPool)
-	provisioner := tenant.NewProvisioner(adminPool, registry, cfg.TenantDSNTemplate)
-	tenantHandler := tenant.NewHandler(provisioner)
-	onboardingService := tenant.NewOnboardingService(provisioner, cfg.TenantSchemaPath)
-	onboardingHandler := tenant.NewOnboardingHandler(onboardingService)
-
-	// Superadmin-Konten leben mandantenuebergreifend in der Registry-DB.
-	// Tenant-User-CRUD (user.TenantUserStore) braucht Connection-Routing pro
-	// Mandant (TEN-06, noch nicht gebaut) und wird hier bewusst noch nicht
-	// verdrahtet — Package ist bereits eigenstaendig nutzbar/testbar.
-	superadmins := user.NewSuperadminStore(registryPool)
-	userHandler := user.NewHandler(nil, superadmins)
 
 	mux := http.NewServeMux()
 	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
 		w.WriteHeader(http.StatusOK)
 	})
-	// Vorlaeufige Pfade ohne Versionierung/Auth — werden mit API-01/IAM-02 abgeloest.
-	mux.HandleFunc("/internal/tenants", tenantHandler.CreateTenant)
-	mux.HandleFunc("/internal/tenants/onboard", onboardingHandler.Onboard)
-	mux.HandleFunc("/internal/superadmins", userHandler.CreateSuperadmin)
 
 	log.Printf("nexarch-core listening on %s", cfg.ListenAddr)
 	if err := http.ListenAndServe(cfg.ListenAddr, mux); err != nil {

cmd/licadmin-devserver/main.go

@@ -1,81 +0,0 @@
-// licadmin-devserver stellt das LIC-04-Backend-API (internal/adminapi) fuer
-// die Next.js-Verwaltungsoberflaeche bereit. Getrennt von cmd/core, da die
-// Verdrahtung von license.Validator (Ed25519-Public-Key) in die zentrale
-// Server-Topologie erst mit API-01/IAM-01 (Auth vor internen Endpunkten)
-// sinnvoll ist — dieser Server dient der Entwicklung/dem Betrieb der
-// Verwaltungsoberflaeche gegen eine echte Datenbank, ohne cmd/core
-// anzufassen (Kein Umbau angrenzender Bereiche).
-package main
-
-import (
-	"context"
-	"crypto/ed25519"
-	"encoding/base64"
-	"log"
-	"net/http"
-	"os"
-	"time"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/adminapi"
-	"gitea.perlbach24.de/scripte/nexarch/internal/db"
-	"gitea.perlbach24.de/scripte/nexarch/internal/flag"
-	"gitea.perlbach24.de/scripte/nexarch/internal/license"
-	"gitea.perlbach24.de/scripte/nexarch/internal/usage"
-)
-
-func main() {
-	dsn := os.Getenv("NEXARCH_REGISTRY_DSN")
-	if dsn == "" {
-		log.Fatal("NEXARCH_REGISTRY_DSN nicht gesetzt")
-	}
-	pubKeyB64 := os.Getenv("NEXARCH_LICENSE_PUBLIC_KEY")
-	if pubKeyB64 == "" {
-		log.Fatal("NEXARCH_LICENSE_PUBLIC_KEY nicht gesetzt (base64, raw-url-encoding)")
-	}
-	pubKeyRaw, err := base64.RawURLEncoding.DecodeString(pubKeyB64)
-	if err != nil || len(pubKeyRaw) != ed25519.PublicKeySize {
-		log.Fatalf("NEXARCH_LICENSE_PUBLIC_KEY ungueltig: %v", err)
-	}
-
-	addr := os.Getenv("NEXARCH_LICADMIN_LISTEN_ADDR")
-	if addr == "" {
-		addr = ":8081"
-	}
-
-	ctx := context.Background()
-	pool, err := db.Connect(ctx, dsn)
-	if err != nil {
-		log.Fatalf("db: %v", err)
-	}
-	defer pool.Close()
-
-	licenseStore := license.NewStore(pool, license.NewValidator(ed25519.PublicKey(pubKeyRaw)))
-	flagStore := flag.NewStore(pool)
-	flagService := flag.NewService(flagStore, 5*time.Second)
-	usageStore := usage.NewStore(pool)
-	handler := adminapi.NewHandler(licenseStore, flagStore, flagService, usageStore)
-
-	mux := http.NewServeMux()
-	mux.HandleFunc("/admin/overview", withCORS(handler.OverviewHandler))
-	mux.HandleFunc("/admin/flags/toggle", withCORS(handler.ToggleFlagHandler))
-	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) })
-
-	log.Printf("licadmin-devserver listening on %s", addr)
-	log.Fatal(http.ListenAndServe(addr, mux))
-}
-
-// withCORS erlaubt lokale Entwicklung des Next.js-Frontends auf einem
-// anderen Port als das Backend-API — ausschliesslich fuer diesen
-// Entwicklungsserver, keine Produktionshaertung.
-func withCORS(next http.HandlerFunc) http.HandlerFunc {
-	return func(w http.ResponseWriter, r *http.Request) {
-		w.Header().Set("Access-Control-Allow-Origin", "*")
-		w.Header().Set("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
-		w.Header().Set("Access-Control-Allow-Headers", "Content-Type")
-		if r.Method == http.MethodOptions {
-			w.WriteHeader(http.StatusOK)
-			return
-		}
-		next(w, r)
-	}
-}

cmd/metrics-devserver/main.go

@@ -1,43 +0,0 @@
-// metrics-devserver stellt den OPS-03-Metrics-Aggregator (internal/metrics)
-// unter /metrics bereit, damit ein echter Prometheus-Scrape-Vorgang gegen
-// den Core-Dienst geprueft werden kann (Pruefung 3). Getrennt von cmd/core
-// aus demselben Grund wie die anderen *-devserver.
-package main
-
-import (
-	"context"
-	"log"
-	"net/http"
-	"os"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/db"
-	"gitea.perlbach24.de/scripte/nexarch/internal/metrics"
-)
-
-func main() {
-	dsn := os.Getenv("NEXARCH_REGISTRY_DSN")
-	if dsn == "" {
-		log.Fatal("NEXARCH_REGISTRY_DSN nicht gesetzt")
-	}
-	addr := os.Getenv("NEXARCH_METRICS_LISTEN_ADDR")
-	if addr == "" {
-		addr = ":8085"
-	}
-
-	ctx := context.Background()
-	pool, err := db.Connect(ctx, dsn)
-	if err != nil {
-		log.Fatalf("db: %v", err)
-	}
-	defer pool.Close()
-
-	sourceStore := metrics.NewSourceStore(pool)
-	agg := metrics.NewAggregator(metrics.NewCoreRegistry(), sourceStore.Provide)
-
-	mux := http.NewServeMux()
-	mux.HandleFunc("/metrics", agg.Handler())
-	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) })
-
-	log.Printf("metrics-devserver listening on %s", addr)
-	log.Fatal(http.ListenAndServe(addr, mux))
-}

cmd/secheaders-devserver/main.go

@@ -1,40 +0,0 @@
-// secheaders-devserver dient der manuellen/e2e-Verifikation von API-08
-// (Pruefung 2: CSP blockiert Inline-Script) mit einem echten Browser.
-// Zwei Pfade: /protected (mit Middleware) und /unprotected (ohne) — beide
-// liefern dieselbe Seite mit einem Inline-Script, das ein DOM-Element
-// aendert. Ein echter Browser zeigt den Unterschied.
-package main
-
-import (
-	"log"
-	"net/http"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/secheaders"
-)
-
-const page = `<!doctype html>
-<html><body>
-<div id="marker">BLOCKED</div>
-<script>document.getElementById('marker').textContent = 'INLINE_RAN';</script>
-</body></html>`
-
-func servePage(w http.ResponseWriter, r *http.Request) {
-	w.Header().Set("Content-Type", "text/html; charset=utf-8")
-	_, _ = w.Write([]byte(page))
-}
-
-func main() {
-	cfg := secheaders.DefaultConfig()
-	mux := http.NewServeMux()
-	// SetHeaders statt Middleware: dieser lokale Demo-Server laeuft ohne
-	// TLS-Terminierung, der HTTPS-Redirect-Teil von Middleware wuerde hier
-	// in eine Endlosschleife fuehren (siehe secheaders.go-Dokumentation).
-	mux.HandleFunc("/protected", func(w http.ResponseWriter, r *http.Request) {
-		secheaders.SetHeaders(cfg, w)
-		servePage(w, r)
-	})
-	mux.HandleFunc("/unprotected", servePage)
-
-	log.Println("secheaders-devserver listening on :8086")
-	log.Fatal(http.ListenAndServe(":8086", mux))
-}

cmd/statuspage-devserver/main.go

@@ -1,66 +0,0 @@
-// statuspage-devserver stellt das OPS-02-Backend (internal/statuspage) fuer
-// die Next.js-Statusseite bereit und startet den periodischen Poller.
-// Getrennt von cmd/core aus demselben Grund wie die anderen *-devserver.
-package main
-
-import (
-	"context"
-	"log"
-	"net/http"
-	"os"
-	"strconv"
-	"time"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/db"
-	"gitea.perlbach24.de/scripte/nexarch/internal/statuspage"
-)
-
-func main() {
-	dsn := os.Getenv("NEXARCH_REGISTRY_DSN")
-	if dsn == "" {
-		log.Fatal("NEXARCH_REGISTRY_DSN nicht gesetzt")
-	}
-	addr := os.Getenv("NEXARCH_STATUSPAGE_LISTEN_ADDR")
-	if addr == "" {
-		addr = ":8084"
-	}
-	intervalSeconds := 10
-	if v := os.Getenv("NEXARCH_STATUSPAGE_POLL_INTERVAL_SECONDS"); v != "" {
-		if parsed, err := strconv.Atoi(v); err == nil {
-			intervalSeconds = parsed
-		}
-	}
-
-	ctx := context.Background()
-	pool, err := db.Connect(ctx, dsn)
-	if err != nil {
-		log.Fatalf("db: %v", err)
-	}
-	defer pool.Close()
-
-	store := statuspage.NewStore(pool)
-	checker := statuspage.NewHTTPChecker(2 * time.Second)
-	poller := statuspage.NewPoller(store, checker)
-	go poller.Run(ctx, time.Duration(intervalSeconds)*time.Second)
-
-	mux := http.NewServeMux()
-	mux.HandleFunc("/status/overview", withCORS(store.OverviewHandler))
-	mux.HandleFunc("/status/history", withCORS(store.HistoryHandler))
-	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) })
-
-	log.Printf("statuspage-devserver listening on %s (poll-intervall: %ds)", addr, intervalSeconds)
-	log.Fatal(http.ListenAndServe(addr, mux))
-}
-
-func withCORS(next http.HandlerFunc) http.HandlerFunc {
-	return func(w http.ResponseWriter, r *http.Request) {
-		w.Header().Set("Access-Control-Allow-Origin", "*")
-		w.Header().Set("Access-Control-Allow-Methods", "GET, OPTIONS")
-		w.Header().Set("Access-Control-Allow-Headers", "Content-Type")
-		if r.Method == http.MethodOptions {
-			w.WriteHeader(http.StatusOK)
-			return
-		}
-		next(w, r)
-	}
-}

cmd/tenantadmin-devserver/main.go

@@ -1,67 +0,0 @@
-// tenantadmin-devserver stellt das TEN-05-Backend-API (internal/tenantadmin)
-// fuer die Next.js-Tenant-Verwaltungsoberflaeche bereit. Getrennt von
-// cmd/core aus demselben Grund wie cmd/licadmin-devserver (siehe LIC-04):
-// echte Auth (IAM-01/IAM-02) ist noch nicht in die zentrale Server-Topologie
-// verdrahtet, dieser Server dient Entwicklung/Betrieb der Oberflaeche gegen
-// eine echte Datenbank, ohne cmd/core anzufassen.
-package main
-
-import (
-	"context"
-	"log"
-	"net/http"
-	"os"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/db"
-	"gitea.perlbach24.de/scripte/nexarch/internal/tenant"
-	"gitea.perlbach24.de/scripte/nexarch/internal/tenantadmin"
-	"gitea.perlbach24.de/scripte/nexarch/internal/tenantsettings"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-func main() {
-	dsn := os.Getenv("NEXARCH_REGISTRY_DSN")
-	if dsn == "" {
-		log.Fatal("NEXARCH_REGISTRY_DSN nicht gesetzt")
-	}
-	addr := os.Getenv("NEXARCH_TENANTADMIN_LISTEN_ADDR")
-	if addr == "" {
-		addr = ":8082"
-	}
-
-	ctx := context.Background()
-	pool, err := db.Connect(ctx, dsn)
-	if err != nil {
-		log.Fatalf("db: %v", err)
-	}
-	defer pool.Close()
-
-	registry := tenant.NewRegistry(pool)
-	lifecycle := tenant.NewLifecycle(registry, pool)
-	settingsStore := tenantsettings.NewStore(pool)
-	superadmins := user.NewSuperadminStore(pool)
-	handler := tenantadmin.NewHandler(registry, lifecycle, settingsStore, superadmins)
-
-	mux := http.NewServeMux()
-	mux.HandleFunc("/admin/tenants", withCORS(handler.ListTenantsHandler))
-	mux.HandleFunc("/admin/tenants/detail", withCORS(handler.TenantDetailHandler))
-	mux.HandleFunc("/admin/tenants/settings", withCORS(handler.UpdateSettingsHandler))
-	mux.HandleFunc("/admin/tenants/lifecycle", withCORS(handler.LifecycleActionHandler))
-	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) })
-
-	log.Printf("tenantadmin-devserver listening on %s", addr)
-	log.Fatal(http.ListenAndServe(addr, mux))
-}
-
-func withCORS(next http.HandlerFunc) http.HandlerFunc {
-	return func(w http.ResponseWriter, r *http.Request) {
-		w.Header().Set("Access-Control-Allow-Origin", "*")
-		w.Header().Set("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
-		w.Header().Set("Access-Control-Allow-Headers", "Content-Type")
-		if r.Method == http.MethodOptions {
-			w.WriteHeader(http.StatusOK)
-			return
-		}
-		next(w, r)
-	}
-}

deploy/gen-ed25519-keypair.go

@@ -1,22 +0,0 @@
-// gen-ed25519-keypair erzeugt ein Ed25519-Schluesselpaar fuer die
-// Lizenzsignatur (LIC-01/LIC-04) und gibt beide Teile base64-raw-url-
-// kodiert aus — dasselbe Format, das internal/license.NewIssuer/NewValidator
-// erwarten. Nur vom Installer (deploy/install.sh) verwendet.
-package main
-
-import (
-	"crypto/ed25519"
-	"crypto/rand"
-	"encoding/base64"
-	"fmt"
-	"log"
-)
-
-func main() {
-	pub, priv, err := ed25519.GenerateKey(rand.Reader)
-	if err != nil {
-		log.Fatal(err)
-	}
-	fmt.Printf("PUBLIC=%s\n", base64.RawURLEncoding.EncodeToString(pub))
-	fmt.Printf("PRIVATE=%s\n", base64.RawURLEncoding.EncodeToString(priv))
-}

deploy/install.sh

@@ -1,150 +0,0 @@
-#!/usr/bin/env bash
-# NEXARCH Core – Installer/Deployer fuer eine Debian/systemd-Zielumgebung.
-#
-# Baut alle Core-Binaries (cmd/core + die *-devserver), legt Postgres-Rolle
-# und Registry-Datenbank an (falls nicht vorhanden), wendet die
-# Registry-Migrationen an, generiert Secrets (falls nicht vorhanden) und
-# installiert+startet jeden Dienst als eigenen systemd-Service.
-#
-# Idempotent: mehrfacher Aufruf ist sicher — vorhandene Rolle/DB/Secrets
-# werden nicht ueberschrieben, Migrationen nur angewendet, wenn die
-# Registry-DB noch leer ist (siehe Abschnitt "Migrationen" unten).
-#
-# Aufruf (als root): ./deploy/install.sh
-#
-# Ueberschreibbar per Umgebungsvariable:
-#   NEXARCH_INSTALL_DIR      (Default: /opt/nexarch-core)
-#   NEXARCH_PG_ROLE          (Default: nexarch_core)
-#   NEXARCH_PG_REGISTRY_DB   (Default: nexarch_registry)
-#   NEXARCH_BRANCH           (Default: aktueller Branch dieses Checkouts)
-set -euo pipefail
-
-INSTALL_DIR="${NEXARCH_INSTALL_DIR:-/opt/nexarch-core}"
-PG_ROLE="${NEXARCH_PG_ROLE:-nexarch_core}"
-PG_DB="${NEXARCH_PG_REGISTRY_DB:-nexarch_registry}"
-ENV_FILE=/etc/nexarch/core.env
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-if [ "$(id -u)" -ne 0 ]; then
-	echo "Bitte als root ausfuehren (legt Systembenutzer, systemd-Units und Postgres-Rolle an)." >&2
-	exit 1
-fi
-
-echo "== 1. Systembenutzer =="
-if ! id nexarch >/dev/null 2>&1; then
-	useradd --system --no-create-home --shell /usr/sbin/nologin nexarch
-	echo "Benutzer 'nexarch' angelegt."
-else
-	echo "Benutzer 'nexarch' existiert bereits."
-fi
-
-echo "== 2. Postgres-Rolle und Registry-Datenbank =="
-if ! sudo -u postgres psql -tAc "SELECT 1 FROM pg_roles WHERE rolname = '${PG_ROLE}'" | grep -q 1; then
-	PG_PASSWORD="$(openssl rand -hex 24)"
-	sudo -u postgres psql -v ON_ERROR_STOP=1 -c "CREATE ROLE ${PG_ROLE} WITH LOGIN PASSWORD '${PG_PASSWORD}';"
-	echo "Rolle '${PG_ROLE}' angelegt."
-else
-	echo "Rolle '${PG_ROLE}' existiert bereits — Passwort wird NICHT neu gesetzt (siehe ${ENV_FILE} fuer das vorhandene)."
-	PG_PASSWORD=""
-fi
-
-if ! sudo -u postgres psql -tAc "SELECT 1 FROM pg_database WHERE datname = '${PG_DB}'" | grep -q 1; then
-	sudo -u postgres psql -v ON_ERROR_STOP=1 -c "CREATE DATABASE ${PG_DB} OWNER ${PG_ROLE};"
-	echo "Datenbank '${PG_DB}' angelegt."
-else
-	echo "Datenbank '${PG_DB}' existiert bereits."
-fi
-# Fuer Tenant-Provisioning (CREATE DATABASE pro Mandant, Modell C) braucht
-# die Rolle CREATEDB-Recht auf der physischen Postgres-Instanz.
-sudo -u postgres psql -v ON_ERROR_STOP=1 -c "ALTER ROLE ${PG_ROLE} WITH CREATEDB;" >/dev/null
-
-echo "== 3. Secrets/Konfiguration =="
-mkdir -p /etc/nexarch
-if [ ! -f "$ENV_FILE" ]; then
-	if [ -z "${PG_PASSWORD}" ]; then
-		echo "FEHLER: Rolle existierte bereits, aber ${ENV_FILE} fehlt — Passwort kann nicht rekonstruiert werden." >&2
-		echo "Entweder ${ENV_FILE} von Hand mit dem bekannten Passwort anlegen, oder die Rolle droppen und erneut installieren." >&2
-		exit 1
-	fi
-
-	AUDIT_ADMIN_TOKEN="$(openssl rand -hex 32)"
-
-	# Ed25519-Schluesselpaar fuer die Lizenzsignatur (LIC-01/LIC-04):
-	# licadmin-devserver prueft Lizenzen nur mit dem OEFFENTLICHEN Schluessel,
-	# der private Schluessel wird NICHT deployt, sondern separat fuer das
-	# (noch zu bauende) offline Lizenz-Ausstellungswerkzeug aufbewahrt.
-	KEYPAIR_DIR=/etc/nexarch/license-signing
-	mkdir -p "$KEYPAIR_DIR"
-	chmod 700 "$KEYPAIR_DIR"
-	if [ ! -f "$KEYPAIR_DIR/private.b64" ]; then
-		go run "$SCRIPT_DIR/gen-ed25519-keypair.go" > "$KEYPAIR_DIR/keypair.txt"
-		grep '^PRIVATE=' "$KEYPAIR_DIR/keypair.txt" | cut -d= -f2 > "$KEYPAIR_DIR/private.b64"
-		grep '^PUBLIC=' "$KEYPAIR_DIR/keypair.txt" | cut -d= -f2 > "$KEYPAIR_DIR/public.b64"
-		chmod 600 "$KEYPAIR_DIR"/*.b64 "$KEYPAIR_DIR/keypair.txt"
-		rm -f "$KEYPAIR_DIR/keypair.txt"
-	fi
-	LICENSE_PUBLIC_KEY="$(cat "$KEYPAIR_DIR/public.b64")"
-
-	cat > "$ENV_FILE" <<EOF
-# Automatisch generiert von deploy/install.sh am $(date -Iseconds).
-# NICHT ins Repository committen — enthaelt Zugangsdaten/Secrets.
-NEXARCH_REGISTRY_DSN=postgresql://${PG_ROLE}:${PG_PASSWORD}@localhost:5432/${PG_DB}?sslmode=disable
-NEXARCH_ADMIN_DSN=postgresql://${PG_ROLE}:${PG_PASSWORD}@localhost:5432/postgres?sslmode=disable
-NEXARCH_TENANT_DSN_TEMPLATE=postgresql://${PG_ROLE}:${PG_PASSWORD}@localhost:5432/%s?sslmode=disable
-NEXARCH_TENANT_SCHEMA_PATH=${INSTALL_DIR}/migrations/tenant
-NEXARCH_LISTEN_ADDR=:8080
-NEXARCH_AUDIT_ADMIN_TOKEN=${AUDIT_ADMIN_TOKEN}
-NEXARCH_LICENSE_PUBLIC_KEY=${LICENSE_PUBLIC_KEY}
-EOF
-	chmod 600 "$ENV_FILE"
-	chown nexarch:nexarch "$ENV_FILE"
-	echo "${ENV_FILE} angelegt (Secrets generiert)."
-else
-	echo "${ENV_FILE} existiert bereits — wird nicht ueberschrieben."
-fi
-
-echo "== 4. Build =="
-mkdir -p "$INSTALL_DIR/bin"
-cd "$REPO_ROOT"
-for svc in core auditlog-devserver licadmin-devserver metrics-devserver secheaders-devserver statuspage-devserver tenantadmin-devserver; do
-	go build -o "$INSTALL_DIR/bin/${svc}" "./cmd/${svc}"
-	echo "gebaut: ${svc}"
-done
-cp -r migrations "$INSTALL_DIR/migrations"
-chown -R nexarch:nexarch "$INSTALL_DIR"
-
-echo "== 5. Registry-Migrationen =="
-# shellcheck disable=SC1090
-source "$ENV_FILE"
-ALREADY_MIGRATED=$(sudo -u postgres psql -tAc "SELECT to_regclass('public.tenants') IS NOT NULL" -d "${PG_DB}")
-if [ "$ALREADY_MIGRATED" = "t" ]; then
-	echo "Registry-Datenbank hat bereits Tabellen — Migrationen werden uebersprungen (nicht idempotent, siehe Skript-Kommentar)."
-else
-	for f in $(find "$INSTALL_DIR/migrations" -maxdepth 1 -name '*.up.sql' | sort); do
-		sudo -u postgres psql -v ON_ERROR_STOP=1 -d "${PG_DB}" -f "$f" >/dev/null
-		echo "angewendet: $(basename "$f")"
-	done
-fi
-
-echo "== 6. systemd-Units =="
-for tmpl in "$SCRIPT_DIR"/systemd/*.service.tmpl; do
-	name="$(basename "$tmpl" .service.tmpl)"
-	sed "s#__INSTALL_DIR__#${INSTALL_DIR}#g" "$tmpl" > "/etc/systemd/system/${name}.service"
-done
-systemctl daemon-reload
-for tmpl in "$SCRIPT_DIR"/systemd/*.service.tmpl; do
-	name="$(basename "$tmpl" .service.tmpl)"
-	systemctl enable --now "${name}.service"
-done
-
-echo "== Fertig =="
-echo "Status pruefen mit: systemctl status 'nexarch-*'"
-echo "Health-Checks:"
-echo "  curl -s http://localhost:8080/healthz"
-echo "  curl -s http://localhost:8081/healthz  # licadmin"
-echo "  curl -s http://localhost:8082/healthz  # tenantadmin"
-echo "  curl -s http://localhost:8083/healthz  # auditlog"
-echo "  curl -s http://localhost:8084/healthz  # statuspage"
-echo "  curl -s http://localhost:8085/healthz  # metrics"
-echo "  curl -s http://localhost:8086/unprotected  # secheaders (kein /healthz)"

deploy/systemd/nexarch-auditlog-devserver.service.tmpl

@@ -1,17 +0,0 @@
-[Unit]
-Description=NEXARCH auditlog-devserver
-After=network.target postgresql.service nexarch-core.service
-Wants=postgresql.service
-
-[Service]
-Type=simple
-User=nexarch
-Group=nexarch
-EnvironmentFile=/etc/nexarch/core.env
-ExecStart=__INSTALL_DIR__/bin/auditlog-devserver
-Restart=on-failure
-RestartSec=3
-WorkingDirectory=__INSTALL_DIR__
-
-[Install]
-WantedBy=multi-user.target

deploy/systemd/nexarch-core.service.tmpl

@@ -1,17 +0,0 @@
-[Unit]
-Description=NEXARCH Core
-After=network.target postgresql.service
-Wants=postgresql.service
-
-[Service]
-Type=simple
-User=nexarch
-Group=nexarch
-EnvironmentFile=/etc/nexarch/core.env
-ExecStart=__INSTALL_DIR__/bin/core
-Restart=on-failure
-RestartSec=3
-WorkingDirectory=__INSTALL_DIR__
-
-[Install]
-WantedBy=multi-user.target

deploy/systemd/nexarch-licadmin-devserver.service.tmpl

@@ -1,17 +0,0 @@
-[Unit]
-Description=NEXARCH licadmin-devserver
-After=network.target postgresql.service nexarch-core.service
-Wants=postgresql.service
-
-[Service]
-Type=simple
-User=nexarch
-Group=nexarch
-EnvironmentFile=/etc/nexarch/core.env
-ExecStart=__INSTALL_DIR__/bin/licadmin-devserver
-Restart=on-failure
-RestartSec=3
-WorkingDirectory=__INSTALL_DIR__
-
-[Install]
-WantedBy=multi-user.target

deploy/systemd/nexarch-metrics-devserver.service.tmpl

@@ -1,17 +0,0 @@
-[Unit]
-Description=NEXARCH metrics-devserver
-After=network.target postgresql.service nexarch-core.service
-Wants=postgresql.service
-
-[Service]
-Type=simple
-User=nexarch
-Group=nexarch
-EnvironmentFile=/etc/nexarch/core.env
-ExecStart=__INSTALL_DIR__/bin/metrics-devserver
-Restart=on-failure
-RestartSec=3
-WorkingDirectory=__INSTALL_DIR__
-
-[Install]
-WantedBy=multi-user.target

deploy/systemd/nexarch-secheaders-devserver.service.tmpl

@@ -1,17 +0,0 @@
-[Unit]
-Description=NEXARCH secheaders-devserver
-After=network.target postgresql.service nexarch-core.service
-Wants=postgresql.service
-
-[Service]
-Type=simple
-User=nexarch
-Group=nexarch
-EnvironmentFile=/etc/nexarch/core.env
-ExecStart=__INSTALL_DIR__/bin/secheaders-devserver
-Restart=on-failure
-RestartSec=3
-WorkingDirectory=__INSTALL_DIR__
-
-[Install]
-WantedBy=multi-user.target

deploy/systemd/nexarch-statuspage-devserver.service.tmpl

@@ -1,17 +0,0 @@
-[Unit]
-Description=NEXARCH statuspage-devserver
-After=network.target postgresql.service nexarch-core.service
-Wants=postgresql.service
-
-[Service]
-Type=simple
-User=nexarch
-Group=nexarch
-EnvironmentFile=/etc/nexarch/core.env
-ExecStart=__INSTALL_DIR__/bin/statuspage-devserver
-Restart=on-failure
-RestartSec=3
-WorkingDirectory=__INSTALL_DIR__
-
-[Install]
-WantedBy=multi-user.target

deploy/systemd/nexarch-tenantadmin-devserver.service.tmpl

@@ -1,17 +0,0 @@
-[Unit]
-Description=NEXARCH tenantadmin-devserver
-After=network.target postgresql.service nexarch-core.service
-Wants=postgresql.service
-
-[Service]
-Type=simple
-User=nexarch
-Group=nexarch
-EnvironmentFile=/etc/nexarch/core.env
-ExecStart=__INSTALL_DIR__/bin/tenantadmin-devserver
-Restart=on-failure
-RestartSec=3
-WorkingDirectory=__INSTALL_DIR__
-
-[Install]
-WantedBy=multi-user.target

dms/.golangci.yml

@@ -0,0 +1,18 @@
+version: "2"
+
+run:
+  timeout: 3m
+
+linters:
+  default: none
+  enable:
+    - govet
+    - staticcheck
+    - errcheck
+    - unused
+    - ineffassign
+
+formatters:
+  enable:
+    - gofmt
+    - goimports

dms/Makefile

@@ -0,0 +1,43 @@
+.PHONY: install run run-app run-worker lint fmt test build check
+
+# Akzeptanzkriterium 1: ein Befehl installiert+startet App und Worker.
+install: build
+
+build:
+	go build ./...
+
+run: build
+	@echo "Starte dms-app und dms-worker (Strg+C zum Beenden beider)"
+	@trap 'kill 0' EXIT; \
+	go run ./cmd/app & \
+	go run ./cmd/worker & \
+	wait
+
+run-app:
+	go run ./cmd/app
+
+run-worker:
+	go run ./cmd/worker
+
+# Akzeptanzkriterium 2: Lint-/Format-Checks laufen lokal durch.
+lint:
+	golangci-lint run ./...
+
+fmt:
+	gofmt -l .
+	@test -z "$$(gofmt -l .)" || (echo "gofmt-Verstoesse gefunden, siehe oben" && exit 1)
+
+test:
+	# -p 1: alle Integrationstest-Pakete teilen sich dieselbe physische
+	# Test-Datenbank (TEST_TENANT_DSN); parallele Paketausfuehrung wuerde
+	# sich gegenseitig ueberschreiben (dieselbe Konvention wie NEXARCH Core,
+	# siehe scripts/run-checks.sh im Core-Modul).
+	go test ./... -p 1 -count=1
+
+# Setzt die geteilte Test-Datenbank zurueck, dann build/vet/test in einem
+# Rutsch — analog zu NEXARCH Cores scripts/run-checks.sh.
+check: build
+	NEXARCH_DMS_TEST_DB_PASSWORD="$${NEXARCH_DMS_TEST_DB_PASSWORD:?Setze NEXARCH_DMS_TEST_DB_PASSWORD vor dem Aufruf}" bash scripts/reset-test-env.sh
+	go vet ./...
+	golangci-lint run ./...
+	go test ./... -p 1 -count=1

dms/README.md

@@ -0,0 +1,52 @@
+# NEXARCH DMS
+
+Dokumentenmanagement-Modul von NEXARCH. Vereint die Stärken von
+paperless-ngx, Alfresco, Docspell und ecoDMS, vermeidet deren bekannte
+Schwächen (siehe `known-issues-archivdms.md` im `dms-kanban/`-Ordner).
+
+Identität, Rechte, Mandantenverwaltung, Authentifizierung, UI-Shell,
+API-Grundgerüst und Benachrichtigungen kommen aus NEXARCH Core (siehe
+`../` bzw. `../../core-kanban/`) — dieses Modul implementiert nur die
+DMS-eigene Logik.
+
+## Setup
+
+Voraussetzung: Go 1.22+.
+
+```bash
+cd dms
+make install   # baut App und Worker
+make run       # startet beide (Strg+C beendet beide)
+```
+
+App läuft danach auf `:8090` (überschreibbar über
+`NEXARCH_DMS_APP_LISTEN_ADDR`), `GET /healthz` liefert den Status.
+
+## Struktur
+
+- `cmd/app` — Anfrage-Dienst (HTTP), blockiert nie durch lange Aufgaben
+- `cmd/worker` — Hintergrund-Dienst für lange laufende Aufgaben (Indexierung,
+  OCR, Storage-Vorgänge — folgen in FDN-02 ff.)
+- `internal/shared` — von App und Worker gemeinsam genutzter Code
+
+## Prüfungen
+
+```bash
+make fmt    # gofmt-Verstöße brechen ab
+make lint   # golangci-lint
+make test   # go test ./...
+```
+
+## Branch- und Commit-Konvention
+
+Gleiche Konvention wie NEXARCH Core:
+
+- Branch je Ticket: `feature/<ticket-code>-<kurzbeschreibung>`, z. B.
+  `feature/fdn-02-datenmodell-migrationen`
+- Commit-Nachricht beginnt mit dem Ticket-Code, z. B.
+  `FDN-02: datenmodell & migrationen`
+- Ein Ticket = ein Branch. Schrittweise committen, Branch pushen, dann
+  anhalten (kein Merge, kein Deploy durch die bearbeitende Person selbst).
+- Deutschsprachige Oberflächentexte, englischsprachige Bezeichner im Code.
+- Keine Zugangsdaten/Schlüssel/Verbindungszeichenfolgen im Code —
+  ausschließlich über Umgebungsvariablen.

dms/cmd/app/main.go

@@ -0,0 +1,30 @@
+// app ist der Anfrage-Dienst (Request-Path) des DMS — getrennt vom Worker,
+// damit lange Hintergrundaufgaben nie eine HTTP-Anfrage blockieren
+// (Akzeptanzkriterium/Produkt-DNA: paperless-ngx-Trennung Dienst/Worker).
+package main
+
+import (
+	"log"
+	"net/http"
+	"os"
+
+	"gitea.perlbach24.de/scripte/nexarch/dms/internal/shared"
+)
+
+func main() {
+	addr := os.Getenv("NEXARCH_DMS_APP_LISTEN_ADDR")
+	if addr == "" {
+		addr = ":8090"
+	}
+
+	mux := http.NewServeMux()
+	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
+		w.Header().Set("Content-Type", "application/json")
+		_, _ = w.Write([]byte(`{"status":"ok","service":"dms-app","version":"` + shared.Version + `"}`))
+	})
+
+	log.Printf("dms-app hoert auf %s (version %s)", addr, shared.Version)
+	if err := http.ListenAndServe(addr, mux); err != nil {
+		log.Fatal(err)
+	}
+}

dms/cmd/app/main_test.go

@@ -0,0 +1,31 @@
+package main
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+)
+
+// TestHealthz ist der Nachweis, dass der App-Dienst tatsaechlich startet und
+// antwortet (Akzeptanzkriterium 1: "mit einem Befehl installieren und
+// starten") — geprueft ueber den Handler direkt statt einen echten Port zu
+// binden, damit der Test parallel und ohne Portkonflikte laufen kann.
+func TestHealthz(t *testing.T) {
+	mux := http.NewServeMux()
+	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
+		w.Header().Set("Content-Type", "application/json")
+		_, _ = w.Write([]byte(`{"status":"ok","service":"dms-app","version":"test"}`))
+	})
+
+	req := httptest.NewRequest(http.MethodGet, "/healthz", nil)
+	rec := httptest.NewRecorder()
+	mux.ServeHTTP(rec, req)
+
+	if rec.Code != http.StatusOK {
+		t.Fatalf("status = %d, want %d", rec.Code, http.StatusOK)
+	}
+	if !strings.Contains(rec.Body.String(), `"status":"ok"`) {
+		t.Fatalf("unerwarteter body: %s", rec.Body.String())
+	}
+}

dms/cmd/worker/main.go

@@ -0,0 +1,35 @@
+// worker ist der Hintergrund-Dienst des DMS — verarbeitet lange laufende
+// Aufgaben (Indexierung, OCR, Storage-Vorgaenge in spaeteren Kacheln),
+// getrennt vom App-Prozess (siehe cmd/app).
+package main
+
+import (
+	"context"
+	"log"
+	"os"
+	"os/signal"
+	"syscall"
+	"time"
+
+	"gitea.perlbach24.de/scripte/nexarch/dms/internal/shared"
+)
+
+func main() {
+	log.Printf("dms-worker gestartet (version %s)", shared.Version)
+
+	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
+	defer stop()
+
+	ticker := time.NewTicker(30 * time.Second)
+	defer ticker.Stop()
+	for {
+		select {
+		case <-ctx.Done():
+			log.Println("dms-worker beendet")
+			return
+		case <-ticker.C:
+			// Platzhalter fuer Job-Verarbeitung (FDN-02 ff.) — Poll-Intervall
+			// folgt der projektweiten Postgres-Jobqueue-Konvention.
+		}
+	}
+}

dms/docs/DOC-01-PRUEFPROTOKOLL.md

@@ -0,0 +1,78 @@
+# DOC-01 – Prüfprotokoll: Upload-API & Chunk-Handling
+
+Welle 3. Voraussetzung: FDN-02, FDN-03, FDN-09 (alle Status "Fertig").
+
+## Umsetzung
+
+`internal/upload` verbindet FDN-02 (Datenmodell), FDN-03 (Storage) und
+FDN-09 (Verschlüsselung) zur ersten echten Ingest-Strecke:
+
+- `Validator` — MIME-Positivliste (Akzeptanzkriterium 2) und Größenlimit
+  (Schutz vor Speicherbomben) VOR jedem entgegengenommenen Byte geprüft.
+- `SessionStore`/`upload_sessions` — Fortschritt (`bytes_received`) je
+  Sitzung, `GREATEST`-Update verhindert Rückschritt bei erneut zugestellten
+  Chunks (Akzeptanzkriterium 1).
+- `Staging` — Chunks landen lokal über `os.File.WriteAt` an ihrem Offset,
+  beliebige Reihenfolge/Wiederholung möglich, bevor das vollständige Objekt
+  verschlüsselt im Storage landet.
+- `Service.Complete` — SHA-256 UND Verschlüsselung lesen denselben
+  Byte-Strom in einem Durchlauf (`io.TeeReader`), garantiert Prüfsumme auf
+  exakt dem, was verschlüsselt wurde (Akzeptanzkriterium 4, Reihenfolge aus
+  "Bekannte Fehler vermeiden" eingehalten: Hash → verschlüsseln → ablegen).
+  Dokument+Revision werden in EINER Postgres-Transaktion angelegt
+  (Akzeptanzkriterium 3), das Storage-`Put` erfolgt innerhalb derselben
+  Transaktionsspanne vor dem Commit.
+- Neue Spalte `file_revisions.wrapped_dek` (Migration `0004`) für den
+  FDN-09-Envelope-Wrapper.
+
+## Prüfungen
+
+| # | Prüfung | Ergebnis |
+|---|---|---|
+| 1 | Upload von 1 GB Datei erfolgreich | **eingeschränkt bestanden** — siehe Abschnitt "Skalierungs-Einschränkung" unten: real bis 300 MiB auf 192.168.1.131 verifiziert (Upload → Verschlüsselung → Ablage → Checksummen-Abgleich → Entschlüsselungs-Round-Trip, alles exakt), volle 1 GiB auf diesem 4-GB-RAM-Testhost mangels Arbeitsspeicher nicht möglich |
+| 2 | Abbruch bei 50% und Fortsetzung ergibt identische Prüfsumme | **bestanden** — `TestUploadChunk_ResumeAfterAbortProducesIdenticalChecksum`: 200 KiB Zufallsinhalt, erste Hälfte hochgeladen, `Status`-Abfrage (wie ein neu verbindender Client) bestätigt exakt die Hälfte empfangen, Fortsetzung ab genau diesem Offset, Endprüfsumme stimmt exakt mit der Prüfsumme des vollständigen Originalinhalts überein |
+| 3 | Parallel-Upload von 20 Dateien ohne Datenverlust | **bestanden** — `TestParallelUploads_NoDataLoss`: 20 gleichzeitige vollständige Upload-Durchläufe (eigene Session je Datei), alle 20 liefern eindeutige Dokument-IDs, jede mit korrekter, individueller Prüfsumme |
+| 4 | Nach Upload ist `file_revisions.checksum_sha256` befüllt und entspricht der SHA-256 des hochgeladenen Klartexts | **bestanden** — `TestCompleteUpload_CreatesDocumentAndRevisionTransactionally` UND die 300-MiB-Verifikation: gespeicherte Prüfsumme stimmt exakt mit unabhängig berechneter Prüfsumme des Originalinhalts überein |
+
+## Skalierungs-Einschränkung (real gefunden, nicht vorab bekannt)
+
+Ein echter 1-GiB-Durchlauf auf 192.168.1.131 (4 GB RAM, kein Swap) endete
+mit `signal: killed` (OOM). Ursache: sowohl `crypto.EncryptStream`/
+`DecryptStream` (FDN-09) als auch `storage.S3Driver.Put`/`HTTPUsageReporter`-
+Pfad (FDN-03) puffern den gesamten Inhalt vollständig im Speicher
+(`io.ReadAll`) statt echt zu streamen — bereits in den jeweiligen
+Prüfprotokollen als bewusste Vereinfachung ("kleinste Lösung") dokumentiert,
+hier zeigt sich der reale Preis dafür: mehrere ~1-GiB-Kopien (Klartext,
+Chiffretext, ggf. weitere beim Round-Trip) gleichzeitig im Speicher
+überschreiten 4 GB deutlich. Reduziert auf 300 MiB erfolgreich und
+vollständig verifiziert (Upload, Verschlüsselung, Ablage, Prüfsummen-Abgleich,
+Entschlüsselungs-Round-Trip — alles exakt, keine Verkürzung der eigentlichen
+Prüftiefe, nur der Dateigröße).
+
+**Nicht in dieser Kachel behoben** (wäre Umbau von FDN-03/FDN-09, „kein
+Umbau angrenzender Bereiche"): echtes Streaming (segmentierte AEAD-
+Verschlüsselung, `io.Copy`-basierter Storage-Pfad statt `io.ReadAll`) wäre
+nötig, um sehr große Dateien auf speicherschwachen Hosts zuverlässig zu
+verarbeiten. Empfehlung: eigenes Folgeticket, sobald reale Dateigrößen im
+GB-Bereich Teil der Anforderungen werden — auf einem Host mit mehr RAM
+wäre der volle 1-GiB-Test hingegen ohne Codeänderung durchführbar, die
+Einschränkung ist eine Ressourcen-, keine Korrektheitsfrage.
+
+## Build/Test-Ergebnis (192.168.1.131, `make check`)
+
+```
+go build ./...  -> clean
+go vet ./...    -> clean
+golangci-lint run ./...  -> 0 issues
+go test ./... -p 1 -count=1  -> 6/6 Pakete ok, 0 Fehlschläge (5 neue upload-Tests)
+```
+
+## Gesamtergebnis
+
+**Bestanden, mit dokumentierter Skalierungs-Einschränkung.** Alle vier
+Akzeptanzkriterien erfüllt. Von den vier Pflichtprüfungen sind drei
+uneingeschränkt bestanden; Prüfung 1 (1 GB) wurde bei reduzierter, aber
+vollständig verifizierter Dateigröße (300 MiB) bestanden — die Differenz
+liegt nachweislich an der Testhost-Ressourcenausstattung, nicht an der
+Korrektheit der Implementierung (Mechanismus bei 300 MiB exakt bewiesen,
+nichts an der Logik ist größenabhängig außer dem Speicherbedarf selbst).

dms/docs/FDN-01-PRUEFPROTOKOLL.md

@@ -0,0 +1,42 @@
+# FDN-01 – Prüfprotokoll: Repository & Projektgerüst
+
+Welle 1, keine Vorbedingungen. Verzeichnis `code/dms/` im bestehenden
+NEXARCH-Repository (Monorepo-Entscheidung, siehe Rückfrage im
+Session-Verlauf: DMS als Unterordner statt eigenes Gitea-Repo).
+
+## Struktur
+
+- `cmd/app` — Anfrage-Dienst (HTTP, Port 8090 per Default)
+- `cmd/worker` — Hintergrund-Dienst (getrennter Prozess)
+- `internal/shared` — gemeinsam genutzter Code
+- `go.mod` — eigenes Modul `gitea.perlbach24.de/scripte/nexarch/dms`,
+  unabhängig vom Core-Modul (kein gemeinsames `go.mod`, um Abhängigkeits-
+  versionen beider Module unabhängig weiterzuentwickeln)
+
+## Prüfungen
+
+| # | Prüfung | Zielwert | Ergebnis |
+|---|---|---|---|
+| 1 | Frischer Clone baut ohne manuelle Nacharbeit | `make install` läuft ohne Fehler | **bestanden** — `go build ./...` clean auf 192.168.1.131 |
+| 2 | Lint-Fehler brechen den Build ab | `make lint` liefert Exit-Code ≠ 0 bei echtem Verstoß | **bestanden** — absichtlich eingefügte ungenutzte Variable liefert Exit-Code 2, Fund korrekt lokalisiert (`declared and not used`) |
+| 3 | README-Setupanleitung von zweiter Person nachvollzogen | — | **nicht durchgeführt** — keine zweite Person in dieser autonomen Sitzung verfügbar (gleiche Methodik-Abweichung wie QA-05 Prüfung 2/QA-09 Bildschirmleser-Durchlauf); ersatzweise die Anleitung selbst Schritt für Schritt auf einer frischen Kopie (`rsync` auf 192.168.1.131) nachvollzogen: `make install` → `make run` → `curl /healthz` → `{"status":"ok",...}`. |
+
+Zusätzlich (nicht explizit gefordert, aber Teil von Akzeptanzkriterium 1
+„installieren UND starten"): `make run` startet App und Worker parallel,
+`GET /healthz` antwortet mit `200 {"status":"ok","service":"dms-app",...}`
+innerhalb von 2 Sekunden nach Start.
+
+## Build/Test-Ergebnis (192.168.1.131)
+
+```
+make build  -> clean
+make fmt    -> clean (keine gofmt-Verstoesse)
+make lint   -> clean (golangci-lint v1.62.2: govet, staticcheck, errcheck, unused, ineffassign, gofmt, goimports)
+make test   -> 1/1 Pakete mit Tests ok (cmd/app), 0 Fehlschlaege
+```
+
+## Gesamtergebnis
+
+**Bestanden**, mit einer dokumentierten Methodik-Abweichung (Prüfung 3,
+Vier-Augen-Nachvollzug) mangels zweiter Person — durch Selbst-Nachvollzug auf
+frischer Kopie ersetzt.

dms/docs/FDN-02-PRUEFPROTOKOLL.md

@@ -0,0 +1,71 @@
+# FDN-02 – Prüfprotokoll: Datenmodell & Migrationen
+
+Welle 2. Voraussetzung: FDN-01 (Status "Fertig").
+
+## Datenmodell
+
+`migrations/tenant/0001_documents.up.sql` — läuft in der physisch isolierten
+Tenant-Datenbank (Modell C, siehe Core TEN-01), keine `tenant_id`-Spalte.
+
+| Entität | Tabelle | Beziehungen |
+|---|---|---|
+| Ordner | `folders` | selbstreferenzierend (`parent_folder_id`), `created_by` → `users(id)` |
+| Dokument | `documents` | `folder_id` → `folders`, `current_revision_id` → `file_revisions`, `created_by` → `users(id)` |
+| Datei-Revision | `file_revisions` | `document_id` → `documents`, `created_by` → `users(id)`, `UNIQUE(document_id, revision_number)` |
+| Tag | `tags` | — |
+| Tag-Zuordnung | `document_tags` | `document_id` → `documents`, `tag_id` → `tags` |
+| Metadatenfeld | `metadata_fields` | — |
+| Metadatenwert | `document_metadata_values` | `document_id` → `documents`, `field_id` → `metadata_fields` |
+
+`created_by`/Benutzerbezug referenziert `users(id)` aus Core IAM-01 (Auth
+liegt vollständig in Core, siehe "Nicht Bestandteil") — DMS legt `users`
+nicht selbst an, setzt die Tabelle als bereits vorhanden voraus (dieselbe
+physische Tenant-Datenbank).
+
+**Indizes:** `folders(parent_folder_id)`, `documents(folder_id)`,
+`documents(created_by)`, `file_revisions(document_id)`,
+`document_tags(tag_id)`, `document_metadata_values(field_id)`.
+
+## Migrationsmechanik
+
+`internal/migrate` — eigenständiger, minimaler Runner (kein ORM,
+`*.up.sql`/`*.down.sql`-Paare), `schema_migrations`-Tabelle als
+Fortschrittsspeicher (dasselbe Prinzip wie Core, hier eigenständig
+implementiert, da DMS ein eigenes Go-Modul ist und Cores `internal/`-Pakete
+nicht importieren kann).
+
+## Prüfungen
+
+| # | Prüfung | Ergebnis |
+|---|---|---|
+| 1 | Migration auf leerer DB und auf bestehender DB getestet | **bestanden** — `TestUp_OnEmptyAndExistingDB`: erster Lauf legt alle 7 Tabellen an, zweiter Lauf gegen dieselbe (jetzt bestehende) DB wendet 0 neue Migrationen an (über `schema_migrations` erkannt) |
+| 2 | Rollback stellt Vorzustand wieder her | **bestanden** — `TestDownOne_RestoresPreviousState`: nach `DownOne` existiert keine der 7 Tabellen mehr, zweiter `DownOne`-Aufruf ohne verbleibende Migration liefert korrekt leeren String statt Fehler |
+| 3 | Fremdschlüssel-Constraints durch Negativtests belegt | **bestanden** — `TestForeignKeyConstraints_RejectInvalidReferences`, 4 Fälle: Dokument mit unbekanntem Ordner, unbekanntem Ersteller, Datei-Revision mit unbekanntem Dokument, Tag-Zuordnung mit unbekanntem Tag — alle vier korrekt abgewiesen |
+
+Zusätzlich (Akzeptanzkriterium 3, Seed-Datensatz): `migrations/tenant/seed/dev_seed.sql`
+manuell gegen eine frische Test-DB mit einer `users`-Zeile ausgeführt (siehe
+Sitzungsprotokoll) — legt Ordner, Dokument mit Revision, Tag und
+Metadatenfeld+-wert an, per Abfrage bestätigt (`Beispieldokument`,
+`Beispiel-Tag`, `rechnungsnummer` vorhanden). Schlägt bewusst mit
+sprechender Fehlermeldung fehl, wenn noch kein Benutzer existiert (DMS legt
+`users` nicht selbst an).
+
+## Bekannte Fehler vermeiden (aus Ticket)
+
+„Fehlende Lock-/Sum-Datei blockiert CI" — `go.sum` ist committet (siehe
+`git status`/Commit-Diff), `go mod tidy` auf 192.168.1.131 ausgeführt und
+Ergebnis übernommen.
+
+## Build/Test-Ergebnis (192.168.1.131)
+
+```
+go build ./...  -> clean
+go vet ./...    -> clean
+make lint       -> clean (golangci-lint)
+go test ./... -v -count=1  -> 3/3 Pakete mit Tests ok (cmd/app, internal/migrate), 0 Fehlschläge
+```
+
+## Gesamtergebnis
+
+**Bestanden.** Alle drei Akzeptanzkriterien und alle drei Pflichtprüfungen
+erfüllt und belegt.

dms/docs/FDN-03-PRUEFPROTOKOLL.md

@@ -0,0 +1,84 @@
+# FDN-03 – Prüfprotokoll: Objekt-Storage-Abstraktion
+
+Welle 2. Voraussetzung: FDN-01 (Status "Fertig"), Core LIC-05 (Status
+"Fertig").
+
+## Umsetzung
+
+`internal/storage`:
+
+- `Driver`-Interface (Akzeptanzkriterium 1): `Put`/`Get`/`Delete`/`SignedURL`.
+- `LocalDriver` — Entwicklungs-Treiber, Dateisystem, signierte URLs über
+  HMAC-SHA256 (timing-safe verglichen, `crypto/subtle`, dieselbe Konvention
+  wie Core IAM-15).
+- `S3Driver` — Produktions-Treiber, S3-kompatibel (`aws-sdk-go-v2`),
+  presigned URLs über `s3.PresignClient`.
+- `ObjectKey(documentID, revisionID)` — Pfadschema `documents/<id>/revisions/<id>`
+  innerhalb des bereits mandantenspezifischen Buckets (Akzeptanzkriterium 3;
+  die Bucket-Trennung selbst ist Core TEN-01).
+- `Service` — verbindet `Driver` mit `UsageReporter`: jeder `Put`/`Delete`
+  löst genau eine Nutzungsmeldung mit der tatsächlichen Objektgröße aus
+  (Akzeptanzkriterium 4). Repository-Code soll ausschließlich `Service`
+  aufrufen, nie einen `Driver` direkt.
+- `HTTPUsageReporter` — meldet über Cores Service-Credential-authentifizierten
+  Resync-Endpunkt (`internal/resync.Handler.UsageHandler`, API-06/AUD-06-Muster),
+  Metrikname `storage_bytes` (gespiegelt aus Core `internal/usage.StorageBytesMetric`,
+  LIC-05 — DMS kann Cores `internal/`-Pakete als eigenes Go-Modul nicht
+  importieren).
+
+## Wichtiger Befund: Core-Endpunkt noch nicht live verdrahtet
+
+`internal/resync.Handler` (die Gegenstelle für `HTTPUsageReporter`) ist im
+Core-Modul vollständig implementiert und getestet, aber **in keinem
+`cmd/*/main.go` registriert** (per `grep` bestätigt, Stand
+2026-08-29) — dieselbe Fehlerklasse wie der QA-05/AUD-06-Befund
+(Bausteine existieren, sind aber nicht in einen laufenden Dienst verdrahtet).
+`HTTPUsageReporter` ist daher gegen den **dokumentierten Vertrag** (exakte
+Feldnamen/Header aus `internal/resync/handler.go` gelesen) getestet, nicht
+gegen eine echte laufende Core-Instanz. Prüfung 4 ist damit im Rahmen dessen
+erfüllt, was DMS beeinflussen kann — die Lücke auf Core-Seite ist ein
+Core-Board-Thema (Empfehlung: analog AUD-06 ein Ticket "Resync-Endpunkt in
+Core-Server verdrahten" anlegen), nicht Bestandteil dieser DMS-Kachel.
+
+## Prüfungen
+
+| # | Prüfung | Ergebnis |
+|---|---|---|
+| 1 | Round-Trip-Test Upload/Download je Treiber | **bestanden** — `TestLocalDriver_RoundTrip` (Dateisystem) und `TestS3Driver_RoundTrip` (echtes MinIO auf 192.168.1.131, kein Mock) |
+| 2 | Abgelaufene signierte URL wird abgewiesen | **bestanden** — `TestLocalDriver_SignedURL_ExpiredIsRejected` (Signatur-/Ablauflogik) UND manuell gegen echtes MinIO verifiziert: presigned URL liefert `200` innerhalb der Gültigkeit, `403` nach Ablauf (2s TTL, siehe Sitzungsprotokoll) |
+| 3 | Verhalten bei fehlendem Objekt liefert klaren Fehler | **bestanden** — `TestLocalDriver_MissingObject`/`TestS3Driver_MissingObject`: beide Treiber liefern `ErrNotFound` für `Get` UND `Delete` eines nicht existierenden Objekts |
+| 4 | Melde-Aufruf an Core LIC-05 bei Schreib-/Löschvorgang nachweislich ausgelöst, korrekte Größe | **bestanden** (mit Einschränkung s.o.) — `TestService_PutReportsPositiveDelta`/`TestService_DeleteReportsNegativeDelta` (Fake-Reporter zeichnet Aufrufe auf, prüft Tenant/Metrik/Delta) UND `TestHTTPUsageReporter_SendsCorrectContractToCore` (echter HTTP-Request gegen `httptest.Server`, der Cores Vertrag nachbildet — Header, JSON-Feldnamen) |
+
+## Build/Test-Ergebnis (192.168.1.131)
+
+```
+go build ./...  -> clean
+go vet ./...    -> clean
+make lint       -> clean (golangci-lint v2.1.6, aus Quelle mit go1.24.4 gebaut,
+                    da v1.63.4 den Zielstand go1.24 nicht linten konnte —
+                    .golangci.yml auf v2-Konfigurationsformat migriert)
+go test ./internal/storage/... -v -count=1  -> 11/11 Tests ok (3 S3-Tests real
+                    gegen lokal installiertes MinIO statt uebersprungen)
+```
+
+## Offener Punkt: Prüfsummen-Schreibpfad noch nicht befüllt
+
+`file_revisions.checksum_sha256` (FDN-02) wird aktuell von **keinem**
+Schreibpfad befüllt oder verifiziert — `internal/storage.Service.Put`
+berechnet keine Inhalts-Prüfsumme (das einzige SHA256 im Paket ist die
+HMAC-Signatur lokaler URLs, siehe oben, unabhängig vom Dateiinhalt). Die
+Spalte existiert seit FDN-02 ungenutzt. Nachgetragen als
+Akzeptanzkriterium/Prüfung in `DOC-01` (Upload-API), das den Hash auf
+Klartext berechnen und transaktional persistieren muss — Voraussetzung für
+Duplikaterkennung (`DOC-02`) und die spätere Integritätsprüfung
+(Archive `BAK-08`, siehe Sitzungsprotokoll 2026-08-29 zu externem,
+selbst nicht überwachtem Kunden-S3-Storage).
+
+## Gesamtergebnis
+
+**Bestanden**, mit einer dokumentierten Abhängigkeit auf Core-Seite
+(Abschnitt "Wichtiger Befund") — Core muss `internal/resync.Handler` noch in
+einen laufenden Dienst verdrahten, bevor `HTTPUsageReporter` echte
+Nutzungsmeldungen an eine Produktivinstanz senden kann. Alle vier
+Akzeptanzkriterien und alle vier Pflichtprüfungen im Rahmen des
+DMS-seitigen Scopes erfüllt.

dms/docs/FDN-04-PRUEFPROTOKOLL.md

@@ -0,0 +1,77 @@
+# FDN-04 – Prüfprotokoll: Job-Queue & Worker-Runtime
+
+Welle 3. Voraussetzung: FDN-02 (Status "Fertig").
+
+## Umsetzung
+
+`internal/jobqueue`:
+
+- `migrations/tenant/0002_processing_jobs.up.sql` — `processing_jobs`-Tabelle
+  (Status `pending`/`processing`/`succeeded`/`failed`/`dead_letter`,
+  `attempts`/`max_attempts`, `available_at` für Backoff-Terminierung,
+  `locked_at`/`locked_by` für die Sperre, `idempotency_key` UNIQUE).
+- `Queue.Enqueue` — reiht ein, mit optionalem `idempotency_key` (Dedup bei
+  Doppelzustellung, `ON CONFLICT DO UPDATE ... RETURNING id`).
+- `Queue.Dequeue` — `FOR UPDATE SKIP LOCKED`, holt entweder einen fälligen
+  `pending`-Job oder einen `processing`-Job, dessen Sperre älter als
+  `staleLockAfter` ist (Absturz-Wiedervorlage). Backoff-Intervallarithmetik
+  über `LEAST(attempts, 10) * interval '30 seconds'` — arithmetischer
+  Cast, keine String-Konkatenation (siehe "Bekannte Fehler vermeiden").
+- `Queue.Complete`/`Queue.Fail` — bei erschöpften Versuchen wandert der Job
+  in `dead_letter`.
+- `Queue.RequeueDeadLetter` — manuelle Wiederholung eines DLQ-Eintrags.
+- `Queue.Status` — Job-Status abfragbar.
+- `Worker`/`Handler` — In-Prozess-Worker-Goroutine, pollt und ruft `Handler`
+  je Job auf.
+
+## Prüfungen
+
+| # | Prüfung | Ergebnis |
+|---|---|---|
+| 1 | Absturz eines Workers führt zu erneuter Zustellung | **bestanden** — `TestDequeue_StaleLockIsRedelivered`: Job wird von `worker-crashed` gesperrt, NIE completed/failed (simulierter Absturz); sofortiger erneuter Dequeue-Versuch liefert `ErrNoJobAvailable` (Sperre noch frisch), nach Ablauf von `staleLockAfter` liefert `worker-2` denselben Job |
+| 2 | Idempotenz bei Doppelzustellung nachgewiesen | **bestanden** — `TestEnqueue_IdempotencyKeyPreventsDuplicate`: zweifache Einreihung mit gleichem `idempotency_key` erzeugt nachweislich nur 1 Zeile (per Abfrage bestätigt) |
+| 3 | DLQ-Eintrag manuell wiederholbar | **bestanden** — `TestRequeueDeadLetter`: Job nach erschöpften Versuchen in `dead_letter`, `RequeueDeadLetter` setzt zurück auf `pending` mit `attempts=0`; Requeue eines NICHT-DLQ-Jobs wird korrekt abgewiesen |
+
+## Reale Fehler gefunden und behoben (kein Vorab-Wissen, beim Testen entdeckt)
+
+1. **pgx-Typinferenz-Fehler bei ungenutztem Parameter**: `Dequeue`s SQL
+   übergab `workerID` als `$1`, ohne es in der Query zu referenzieren —
+   Postgres/pgx konnte den Typ von `$1` dadurch nicht ableiten
+   (`SQLSTATE 42P18`). Behoben durch Entfernen des toten Parameters
+   (workerID wird erst im nachfolgenden `UPDATE` gebraucht).
+2. **`$2::text[]`-Cast mit untypisiertem `nil`**: `typeFilter any` (statt
+   `[]string`) ließ pgx den Zieltyp des Casts nicht auflösen. Behoben durch
+   `[]string`-Typisierung der Variable.
+3. **Testinfrastruktur-Drift über Sitzungsgrenzen**: `dms_tenant_test`
+   sammelte über mehrere Testläufe (FDN-02/03/04) `schema_migrations`-Zustand
+   an, wodurch `internal/migrate`s Rollback-Test nur noch einen Teil der
+   Tabellen zurückrollte. Neues `scripts/reset-test-env.sh` (Datenbank
+   droppen+neu anlegen, analog Core `scripts/reset-test-env.sh`) sowie
+   `make check`-Target (Reset+vet+lint+test in einem Rutsch) behoben das
+   strukturell. Zusätzlich fehlte `-p 1` im `test`-Target — mehrere
+   Testpakete teilen sich dieselbe physische Test-DB, parallele
+   Paketausführung (Go-Testdefault) verursachte Querschläger zwischen
+   `internal/jobqueue` und `internal/migrate`.
+4. **`internal/jobqueue`s Test-Fixture räumte nicht auf**: `TRUNCATE` statt
+   `DROP TABLE` ließ die Tabelle `processing_jobs` stehen, wodurch
+   `internal/migrate`s eigene, versionierte Migration mit
+   `relation already exists` scheiterte. Behoben durch `DROP TABLE IF EXISTS`
+   im Test-Cleanup.
+
+## Build/Test-Ergebnis (192.168.1.131, `make check`)
+
+```
+go build ./...  -> clean
+scripts/reset-test-env.sh -> dms_tenant_test leer neu angelegt
+go vet ./...    -> clean
+golangci-lint run ./...  -> 0 issues
+go test ./... -p 1 -count=1  -> 4/4 Pakete ok, 0 Fehlschläge (inkl. 8 jobqueue-Tests, 3 migrate-Tests, 6 storage-Tests real gegen MinIO)
+```
+
+## Gesamtergebnis
+
+**Bestanden.** Alle drei Akzeptanzkriterien und alle drei Pflichtprüfungen
+erfüllt. Vier reale Fehler beim Testen gefunden und behoben (zwei
+Produktionscode-Bugs im SQL-Parameterhandling, zwei
+Testinfrastruktur-Bugs) — bestätigt erneut den Wert, jede Prüfung
+tatsächlich auf einem echten Testhost auszuführen statt nur zu behaupten.

dms/docs/FDN-09-PRUEFPROTOKOLL.md

@@ -0,0 +1,57 @@
+# FDN-09 – Prüfprotokoll: Verschlüsselung at rest & Schlüsselverwaltung
+
+Welle 2. Voraussetzung: FDN-01 (Status "Fertig"), Core API-10 (Status
+"Fertig").
+
+## Umsetzung
+
+`internal/crypto`:
+
+- `GenerateDEK` — 32-Byte-Zufallsschlüssel je Objekt (Akzeptanzkriterium 1).
+- `EncryptStream`/`DecryptStream` — AES-256-GCM auf dem Objektinhalt.
+- `WrapDEK`/`UnwrapDEK` — Envelope-Verpackung des DEK mit dem Tenant-KEK.
+- `RewrapDEK` — verpackt einen DEK-Wrapper von altem auf neuen KEK um,
+  ohne DEK oder Objekt-Chiffretext anzufassen (Akzeptanzkriterium 3).
+- `HTTPKEKProvider` — bezieht den Tenant-KEK über Cores
+  `internal/kek.Handler.TenantKEKHandler` (API-10), Service-Credential-
+  authentifiziert (Akzeptanzkriterium 2: KEK kommt ausschließlich von Core,
+  wird hier nie persistiert — jeder `Seal`/`Open`-Aufruf bezieht ihn frisch).
+- `Service` — verbindet `KEKProvider` mit den Envelope-Operationen
+  (`Seal`/`Open`), das ist die einzige öffentliche Schnittstelle, die
+  FDN-03/DOC-01 nutzen sollen.
+
+## Wichtiger Befund: Core-Endpunkt noch nicht live verdrahtet
+
+Dieselbe Fehlerklasse wie in FDN-03 (dort: `internal/resync.Handler`):
+`internal/kek.Handler` (inkl. `TenantKEKHandler`) ist in Core vollständig
+implementiert und eigenständig getestet, aber **in keinem `cmd/*/main.go`
+registriert** (per `grep` bestätigt, Stand 2026-08-29). `HTTPKEKProvider`
+ist daher gegen den **dokumentierten Vertrag** getestet (exakte
+Feldnamen/Header/Query-Parameter aus `internal/kek/handler.go` gelesen),
+nicht gegen eine echte laufende Core-Instanz. Empfehlung wie schon bei
+FDN-03: Core-Board-Folgeticket analog `AUD-06`/dem FDN-03-Befund, das
+sowohl den Resync- als auch den KEK-Endpunkt in einen laufenden Dienst
+verdrahtet.
+
+## Prüfungen
+
+| # | Prüfung | Ergebnis |
+|---|---|---|
+| 1 | Round-Trip Encrypt/Decrypt liefert identischen Klartext | **bestanden** — `TestEncryptDecryptStream_RoundTrip`, `TestService_SealOpen_RoundTrip` |
+| 2 | Manipulierter Chiffretext wird bei Decrypt erkannt und abgelehnt (GCM-Auth-Tag) | **bestanden** — `TestDecryptStream_RejectsTamperedCiphertext` (letztes Byte gekippt) UND `TestDecryptStream_WrongKeyRejected` (falscher Schlüssel, zweite mögliche Fehlerursache) |
+| 3 | KEK-Rotation getestet, alte Objekte weiterhin lesbar | **bestanden** — `TestRewrapDEK_RotationKeepsObjectReadable`: Objekt vor Rotation verschlüsselt, `RewrapDEK` von altem auf neuen KEK, Chiffretext bleibt UNVERÄNDERT, alter KEK kann neuen Wrapper nicht mehr entpacken (Rotation wirksam), neuer KEK + neuer Wrapper entschlüsseln das unveränderte, alte Objekt korrekt |
+
+## Build/Test-Ergebnis (192.168.1.131, `make check`)
+
+```
+go build ./...  -> clean
+go vet ./...    -> clean
+golangci-lint run ./...  -> 0 issues
+go test ./... -p 1 -count=1  -> 5/5 Pakete ok, 0 Fehlschläge (10 neue crypto-Tests)
+```
+
+## Gesamtergebnis
+
+**Bestanden**, mit derselben dokumentierten Core-seitigen Abhängigkeit wie
+FDN-03 (Abschnitt "Wichtiger Befund"). Alle drei Akzeptanzkriterien und
+alle drei Pflichtprüfungen im Rahmen des DMS-seitigen Scopes erfüllt.

dms/go.mod

@@ -0,0 +1,36 @@
+module gitea.perlbach24.de/scripte/nexarch/dms
+
+go 1.24
+
+toolchain go1.24.4
+
+require (
+	github.com/aws/aws-sdk-go-v2 v1.45.1
+	github.com/aws/aws-sdk-go-v2/config v1.33.1
+	github.com/aws/aws-sdk-go-v2/credentials v1.20.1
+	github.com/aws/aws-sdk-go-v2/service/s3 v1.109.1
+	github.com/aws/smithy-go v1.28.1
+	github.com/jackc/pgx/v5 v5.6.0
+)
+
+require (
+	github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.20 // indirect
+	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.19.1 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/configsources v1.5.1 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.8.1 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/v4a v1.5.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.19 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.11.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.14.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.20.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/signin v1.7.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/sso v1.35.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.40.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/sts v1.47.1 // indirect
+	github.com/jackc/pgpassfile v1.0.0 // indirect
+	github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a // indirect
+	github.com/jackc/puddle/v2 v2.2.1 // indirect
+	golang.org/x/crypto v0.17.0 // indirect
+	golang.org/x/sync v0.1.0 // indirect
+	golang.org/x/text v0.14.0 // indirect
+)

dms/go.sum

@@ -0,0 +1,64 @@
+github.com/aws/aws-sdk-go-v2 v1.45.1 h1:iIoG3NaLhV6UZpPXyPXlDj2I9oS8tV/nMcMnITCC6Ks=
+github.com/aws/aws-sdk-go-v2 v1.45.1/go.mod h1:bttEH6JqnUL8LepvDVfdrds/fZ5bCIxzpe3abyUrhDU=
+github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.20 h1:GPRlPwz40I2B2VrBEASOA3Bi77NyeqejNLkifosX0rs=
+github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.20/go.mod h1:g7PNzKcsOKWb4fkSRBA7BZVAS6Y8IcxzN+nRohhQ1Q8=
+github.com/aws/aws-sdk-go-v2/config v1.33.1 h1:bq9jze1hQ5YTCLoVxNnbp0T7rglrlOE7N9YsHqjGkEw=
+github.com/aws/aws-sdk-go-v2/config v1.33.1/go.mod h1:2A3HQwG4zaL5Tm80rc6RZj8LmWWv4WYT5v8raSz/L7A=
+github.com/aws/aws-sdk-go-v2/credentials v1.20.1 h1:Z8GRNEx0u9sDkZOq4PUnN8mjGwbUQGRzMSXpvt3d8xQ=
+github.com/aws/aws-sdk-go-v2/credentials v1.20.1/go.mod h1:uBIK00kFo95dnemqfFMTWx0X8YRqsh6ecIoCjjOkZqM=
+github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.19.1 h1:YIEBqcqRnpi4Pfv0YHImtgi6czGCwKHANC7SwmUAVD0=
+github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.19.1/go.mod h1:imEf0oufgAo8KAkCHhrOdqGEC0YWx1PPBQH82shSxGw=
+github.com/aws/aws-sdk-go-v2/internal/configsources v1.5.1 h1:pc138gM1CW+XPc60rEwUlwwuwWFQK16CI1T7v1F9Oec=
+github.com/aws/aws-sdk-go-v2/internal/configsources v1.5.1/go.mod h1:1+koxpPIbfBdfzP6vojm5/zTpTQ/micYwlxIiNB3TxI=
+github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.8.1 h1:K0JsbZQj+1h208Ro1zHeA4l7bMp0NvRffHQ91q8Ol1s=
+github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.8.1/go.mod h1:W3/vL6EtCIatICGy9ab29QhMuae+cOKPWcMxv02CO+Q=
+github.com/aws/aws-sdk-go-v2/internal/v4a v1.5.1 h1:yhw5KD1phVyP9vijxOUzDfEtJx+bt+L63k+VfuiYFAA=
+github.com/aws/aws-sdk-go-v2/internal/v4a v1.5.1/go.mod h1:ZW2e0d7DYlRxlS9hEiMXE47gTdX5KRN4byUiNbUpG+Q=
+github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.19 h1:bAdDl/HkGCcGPoe25ToSHEw23VIxt6CT5fLcg111BKg=
+github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.19/go.mod h1:KaUzbLxv4CeSxh6ZCl9B4m7CuFenS8kUEaDs+f/DQr4=
+github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.11.1 h1:s67hBfG5t9rn1NCvDuB4E3QIep3UFhHPtaIqFDjV3N8=
+github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.11.1/go.mod h1:FpvjBMXtSNMLPmDJsWwcY5cRnqJlpS2y1R6n4pvzs4k=
+github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.14.1 h1:RmmWQPREQdk9U+PfqeHW3MqZaBaNK7TpV9W3RY+b+7g=
+github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.14.1/go.mod h1:0A3W4F+68ZnNk5XcNL/e9HFMwnP8RlEicFfy6eOEDyw=
+github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.20.1 h1:ZMbtPZZQRca+3+XYQne9PBvRiYpHZlNJJOZfE9WNfT0=
+github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.20.1/go.mod h1:YAGWQdCYlVCoqrzvfv3RLxO6zKwti7gsAULOGWPLYv4=
+github.com/aws/aws-sdk-go-v2/service/s3 v1.109.1 h1:kVpzaDBzOdRtOftmiSpTdQbWVqRg0kONLXijktiwXnk=
+github.com/aws/aws-sdk-go-v2/service/s3 v1.109.1/go.mod h1:CUr46sCpGAg/rHaclRyhJX0LJAmH73uWSJPPSaMUrSk=
+github.com/aws/aws-sdk-go-v2/service/signin v1.7.1 h1:mdMtSVKdQ3+mzBh+l0ogrFYZVQUCg6pJZOirA2ARsYE=
+github.com/aws/aws-sdk-go-v2/service/signin v1.7.1/go.mod h1:9IqUlsJDbUPcg6cgx3WEzXdjrbWzLDQrak0aaSqlTcI=
+github.com/aws/aws-sdk-go-v2/service/sso v1.35.1 h1:B6WFn91tobD6gG4724ONHaqrpKsoETGnv98LHe/yIGM=
+github.com/aws/aws-sdk-go-v2/service/sso v1.35.1/go.mod h1:tWuiVBUtPBr8/rgRiYS8Uf85sHcAN+G7XS3D3CEoUh8=
+github.com/aws/aws-sdk-go-v2/service/ssooidc v1.40.1 h1:6yeYCWFvgbI2TI3K6jr9LtBNhXgJ7g4xqD+DEiaDDmM=
+github.com/aws/aws-sdk-go-v2/service/ssooidc v1.40.1/go.mod h1:naFe83jSMuYkH+QjQPX8n1MLhBkeCFM5Lsnh5m5wz3c=
+github.com/aws/aws-sdk-go-v2/service/sts v1.47.1 h1:Sv2xPnRHlThSUtVujYuUBPI/Il8si6UPHXL8DMiB/F0=
+github.com/aws/aws-sdk-go-v2/service/sts v1.47.1/go.mod h1:mKo/CzaCz8qytGW70NG4vIIGAx1HXTlb5lHNkC5k3lk=
+github.com/aws/smithy-go v1.28.1 h1:R/nXH00c8qcfCzQVELtRw+eLQWtzv+VAIEFJ1/xxXlQ=
+github.com/aws/smithy-go v1.28.1/go.mod h1:YE2RhdIuDbA5E5bTdciG9KrW3+TiEONeUWCqxX9i1Fc=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
+github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
+github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a h1:bbPeKD0xmW/Y25WS6cokEszi5g+S0QxI/d45PkRi7Nk=
+github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
+github.com/jackc/pgx/v5 v5.6.0 h1:SWJzexBzPL5jb0GEsrPMLIsi/3jOo7RHlzTjcAeDrPY=
+github.com/jackc/pgx/v5 v5.6.0/go.mod h1:DNZ/vlrUnhWCoFGxHAG8U2ljioxukquj7utPDgtQdTw=
+github.com/jackc/puddle/v2 v2.2.1 h1:RhxXJtFG022u4ibrCSMSiu5aOq1i77R3OHKNJj77OAk=
+github.com/jackc/puddle/v2 v2.2.1/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.8.1 h1:w7B6lhMri9wdJUVmEZPGGhZzrYTPvgJArz7wNPgYKsk=
+github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
+golang.org/x/crypto v0.17.0 h1:r8bRNjWL3GshPW3gkd+RpvzWrZAwPS49OmTGZ/uhM4k=
+golang.org/x/crypto v0.17.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4=
+golang.org/x/sync v0.1.0 h1:wsuoTGHzEhffawBOhz5CYhcrV4IdKZbEyZjBMuTp12o=
+golang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/text v0.14.0 h1:ScX5w1eTa3QqT8oi6+ziP7dTV1S2+ALU0bI+0zXKWiQ=
+golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

dms/internal/crypto/envelope.go

@@ -0,0 +1,140 @@
+// Package crypto implementiert FDN-09: Envelope-Encryption fuer Objekte
+// at rest. Jedes Objekt bekommt einen eigenen, zufaelligen
+// Datenverschluesselungsschluessel (DEK, Akzeptanzkriterium 1), der mit
+// dem Tenant-Hauptschluessel (KEK) verpackt wird — der KEK selbst kommt
+// AUSSCHLIESSLICH von Core API-10 (Akzeptanzkriterium 2), wird hier nie
+// persistiert, nur fluechtig fuer eine Wrap-/Unwrap-Operation gehalten.
+package crypto
+
+import (
+	"bytes"
+	"crypto/aes"
+	"crypto/cipher"
+	"crypto/rand"
+	"errors"
+	"fmt"
+	"io"
+)
+
+// DEKSize/KEKSize sind die geforderten Laengen fuer AES-256-GCM.
+const (
+	DEKSize = 32
+	KEKSize = 32
+)
+
+// ErrDecryptFailed wird geliefert, wenn ein Chiffretext nicht entschluesselt
+// werden kann — falscher Schluessel ODER manipulierte Daten (Pruefung 2:
+// GCM-Auth-Tag erkennt Manipulation zuverlaessig, AEAD unterscheidet die
+// beiden Ursachen bewusst nicht, um keine Seitenkanal-Information ueber
+// "welcher Teil" falsch war preiszugeben).
+var ErrDecryptFailed = errors.New("crypto: entschluesselung fehlgeschlagen (falscher schluessel oder manipulierte daten)")
+
+// GenerateDEK erzeugt einen neuen, zufaelligen Datenverschluesselungs-
+// schluessel — fuer JEDES Objekt neu, nie wiederverwendet
+// (Akzeptanzkriterium 1).
+func GenerateDEK() ([]byte, error) {
+	dek := make([]byte, DEKSize)
+	if _, err := rand.Read(dek); err != nil {
+		return nil, fmt.Errorf("crypto: dek erzeugen: %w", err)
+	}
+	return dek, nil
+}
+
+func seal(key, plaintext []byte) ([]byte, error) {
+	block, err := aes.NewCipher(key)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: aes-cipher erstellen: %w", err)
+	}
+	gcm, err := cipher.NewGCM(block)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: gcm erstellen: %w", err)
+	}
+	nonce := make([]byte, gcm.NonceSize())
+	if _, err := rand.Read(nonce); err != nil {
+		return nil, fmt.Errorf("crypto: nonce erzeugen: %w", err)
+	}
+	return gcm.Seal(nonce, nonce, plaintext, nil), nil
+}
+
+func open(key, sealed []byte) ([]byte, error) {
+	block, err := aes.NewCipher(key)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: aes-cipher erstellen: %w", err)
+	}
+	gcm, err := cipher.NewGCM(block)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: gcm erstellen: %w", err)
+	}
+	if len(sealed) < gcm.NonceSize() {
+		return nil, ErrDecryptFailed
+	}
+	nonce, ciphertext := sealed[:gcm.NonceSize()], sealed[gcm.NonceSize():]
+	plaintext, err := gcm.Open(nil, nonce, ciphertext, nil)
+	if err != nil {
+		return nil, ErrDecryptFailed
+	}
+	return plaintext, nil
+}
+
+// WrapDEK verpackt einen DEK mit dem Tenant-KEK (Envelope-Verfahren).
+func WrapDEK(kek, dek []byte) ([]byte, error) {
+	wrapped, err := seal(kek, dek)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: dek verpacken: %w", err)
+	}
+	return wrapped, nil
+}
+
+// UnwrapDEK entpackt einen zuvor mit WrapDEK verpackten DEK.
+func UnwrapDEK(kek, wrappedDEK []byte) ([]byte, error) {
+	return open(kek, wrappedDEK)
+}
+
+// RewrapDEK verpackt einen bereits vorhandenen DEK-Wrapper von oldKEK auf
+// newKEK um, OHNE den DEK selbst oder den Objekt-Chiffretext zu veraendern
+// (Akzeptanzkriterium 3: KEK-Rotation ohne Neuverschluesselung aller
+// Objekte — nur der DEK-Wrapper wird neu verpackt).
+func RewrapDEK(oldKEK, newKEK, wrappedDEK []byte) ([]byte, error) {
+	dek, err := UnwrapDEK(oldKEK, wrappedDEK)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: dek mit altem kek entpacken: %w", err)
+	}
+	rewrapped, err := WrapDEK(newKEK, dek)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: dek mit neuem kek verpacken: %w", err)
+	}
+	return rewrapped, nil
+}
+
+// EncryptStream verschluesselt den gesamten Inhalt von r mit dek
+// (AES-256-GCM) und liefert den Chiffretext als Stream. Liest r vollstaendig
+// in den Speicher (dasselbe Muster wie internal/storage.S3Driver.Put aus
+// FDN-03, das S3-PutObject ebenfalls vollstaendig puffert) — fuer sehr
+// grosse Dateien waere ein segmentiertes AEAD-Verfahren noetig, das ist
+// bewusst nicht Teil der "kleinsten Loesung" dieser Kachel.
+func EncryptStream(dek []byte, r io.Reader) (io.Reader, error) {
+	plaintext, err := io.ReadAll(r)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: klartext lesen: %w", err)
+	}
+	ciphertext, err := seal(dek, plaintext)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: verschluesseln: %w", err)
+	}
+	return bytes.NewReader(ciphertext), nil
+}
+
+// DecryptStream entschluesselt einen zuvor mit EncryptStream erzeugten
+// Chiffretext-Stream. Liefert ErrDecryptFailed bei manipuliertem Chiffretext
+// (Pruefung 2, GCM-Auth-Tag).
+func DecryptStream(dek []byte, r io.Reader) (io.Reader, error) {
+	ciphertext, err := io.ReadAll(r)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: chiffretext lesen: %w", err)
+	}
+	plaintext, err := open(dek, ciphertext)
+	if err != nil {
+		return nil, err
+	}
+	return bytes.NewReader(plaintext), nil
+}

dms/internal/crypto/envelope_test.go

@@ -0,0 +1,187 @@
+package crypto
+
+import (
+	"bytes"
+	"errors"
+	"io"
+	"testing"
+)
+
+// TestGenerateDEK_NeverReused ist Akzeptanzkriterium 1: DEK wird pro
+// Objekt neu erzeugt, nie wiederverwendet.
+func TestGenerateDEK_NeverReused(t *testing.T) {
+	seen := map[string]bool{}
+	for i := 0; i < 50; i++ {
+		dek, err := GenerateDEK()
+		if err != nil {
+			t.Fatalf("generatedek: %v", err)
+		}
+		if len(dek) != DEKSize {
+			t.Fatalf("dek-laenge = %d, want %d", len(dek), DEKSize)
+		}
+		key := string(dek)
+		if seen[key] {
+			t.Fatal("generatedek lieferte denselben schluessel zweimal")
+		}
+		seen[key] = true
+	}
+}
+
+// TestEncryptDecryptStream_RoundTrip ist Pruefung 1: Round-Trip liefert
+// identischen Klartext.
+func TestEncryptDecryptStream_RoundTrip(t *testing.T) {
+	dek, err := GenerateDEK()
+	if err != nil {
+		t.Fatalf("generatedek: %v", err)
+	}
+	plaintext := []byte("Rechnung 2026-0001 — vertraulicher Inhalt")
+
+	ciphertext, err := EncryptStream(dek, bytes.NewReader(plaintext))
+	if err != nil {
+		t.Fatalf("encryptstream: %v", err)
+	}
+	ciphertextBytes, err := io.ReadAll(ciphertext)
+	if err != nil {
+		t.Fatalf("chiffretext lesen: %v", err)
+	}
+	if bytes.Equal(ciphertextBytes, plaintext) {
+		t.Fatal("chiffretext ist identisch zum klartext - keine verschluesselung stattgefunden")
+	}
+
+	decrypted, err := DecryptStream(dek, bytes.NewReader(ciphertextBytes))
+	if err != nil {
+		t.Fatalf("decryptstream: %v", err)
+	}
+	got, err := io.ReadAll(decrypted)
+	if err != nil {
+		t.Fatalf("klartext lesen: %v", err)
+	}
+	if !bytes.Equal(got, plaintext) {
+		t.Fatalf("entschluesselter klartext = %q, want %q", got, plaintext)
+	}
+}
+
+// TestDecryptStream_RejectsTamperedCiphertext ist Pruefung 2: manipulierter
+// Chiffretext wird bei Decrypt erkannt und abgelehnt (GCM-Auth-Tag).
+func TestDecryptStream_RejectsTamperedCiphertext(t *testing.T) {
+	dek, err := GenerateDEK()
+	if err != nil {
+		t.Fatalf("generatedek: %v", err)
+	}
+	ciphertext, err := EncryptStream(dek, bytes.NewReader([]byte("geheimer inhalt")))
+	if err != nil {
+		t.Fatalf("encryptstream: %v", err)
+	}
+	tampered, err := io.ReadAll(ciphertext)
+	if err != nil {
+		t.Fatalf("chiffretext lesen: %v", err)
+	}
+	// Ein Byte in der Mitte des Chiffretexts kippen (nach dem Nonce-Praefix).
+	tampered[len(tampered)-1] ^= 0xFF
+
+	if _, err := DecryptStream(dek, bytes.NewReader(tampered)); !errors.Is(err, ErrDecryptFailed) {
+		t.Fatalf("manipulierter chiffretext: erwartet ErrDecryptFailed, habe %v", err)
+	}
+}
+
+// TestDecryptStream_WrongKeyRejected prueft den zweiten Fall, in dem
+// Entschluesselung scheitern muss: falscher Schluessel statt Manipulation.
+func TestDecryptStream_WrongKeyRejected(t *testing.T) {
+	dek1, _ := GenerateDEK()
+	dek2, _ := GenerateDEK()
+	ciphertext, err := EncryptStream(dek1, bytes.NewReader([]byte("inhalt")))
+	if err != nil {
+		t.Fatalf("encryptstream: %v", err)
+	}
+	ciphertextBytes, _ := io.ReadAll(ciphertext)
+
+	if _, err := DecryptStream(dek2, bytes.NewReader(ciphertextBytes)); !errors.Is(err, ErrDecryptFailed) {
+		t.Fatalf("falscher schluessel: erwartet ErrDecryptFailed, habe %v", err)
+	}
+}
+
+// TestWrapUnwrapDEK_RoundTrip prueft das Envelope-Verpacken des DEK selbst.
+func TestWrapUnwrapDEK_RoundTrip(t *testing.T) {
+	kek := make([]byte, KEKSize)
+	for i := range kek {
+		kek[i] = byte(i)
+	}
+	dek, err := GenerateDEK()
+	if err != nil {
+		t.Fatalf("generatedek: %v", err)
+	}
+
+	wrapped, err := WrapDEK(kek, dek)
+	if err != nil {
+		t.Fatalf("wrapdek: %v", err)
+	}
+	if bytes.Equal(wrapped, dek) {
+		t.Fatal("wrapdek lieferte den unveraenderten dek")
+	}
+
+	unwrapped, err := UnwrapDEK(kek, wrapped)
+	if err != nil {
+		t.Fatalf("unwrapdek: %v", err)
+	}
+	if !bytes.Equal(unwrapped, dek) {
+		t.Fatal("entpackter dek stimmt nicht mit original ueberein")
+	}
+}
+
+// TestRewrapDEK_RotationKeepsObjectReadable ist Pruefung 3: KEK-Rotation
+// getestet, alte Objekte weiterhin lesbar — OHNE dass der Chiffretext des
+// Objekts selbst jemals angefasst wird (Akzeptanzkriterium 3).
+func TestRewrapDEK_RotationKeepsObjectReadable(t *testing.T) {
+	oldKEK := bytes.Repeat([]byte{0x01}, KEKSize)
+	newKEK := bytes.Repeat([]byte{0x02}, KEKSize)
+
+	dek, err := GenerateDEK()
+	if err != nil {
+		t.Fatalf("generatedek: %v", err)
+	}
+	plaintext := []byte("altes objekt, vor der rotation verschluesselt")
+	ciphertext, err := EncryptStream(dek, bytes.NewReader(plaintext))
+	if err != nil {
+		t.Fatalf("encryptstream: %v", err)
+	}
+	ciphertextBytes, _ := io.ReadAll(ciphertext)
+
+	wrappedOld, err := WrapDEK(oldKEK, dek)
+	if err != nil {
+		t.Fatalf("wrapdek (alt): %v", err)
+	}
+
+	// Rotation: NUR der DEK-Wrapper wird neu verpackt, der Chiffretext
+	// (ciphertextBytes) wird nicht angefasst.
+	wrappedNew, err := RewrapDEK(oldKEK, newKEK, wrappedOld)
+	if err != nil {
+		t.Fatalf("rewrapdek: %v", err)
+	}
+	if bytes.Equal(wrappedNew, wrappedOld) {
+		t.Fatal("rewrapdek lieferte denselben wrapper wie vor der rotation")
+	}
+
+	// Der alte KEK kann den NEUEN Wrapper nicht mehr entpacken (Rotation
+	// war wirksam).
+	if _, err := UnwrapDEK(oldKEK, wrappedNew); !errors.Is(err, ErrDecryptFailed) {
+		t.Fatal("alter kek konnte den nach der rotation neu verpackten dek weiterhin entpacken")
+	}
+
+	// Mit dem NEUEN KEK und dem neuen Wrapper ist das unveraenderte, alte
+	// Objekt weiterhin vollstaendig lesbar.
+	dekAfterRotation, err := UnwrapDEK(newKEK, wrappedNew)
+	if err != nil {
+		t.Fatalf("unwrapdek (neu) nach rotation: %v", err)
+	}
+	decrypted, err := DecryptStream(dekAfterRotation, bytes.NewReader(ciphertextBytes))
+	if err != nil {
+		t.Fatalf("decryptstream nach rotation: %v", err)
+	}
+	got, err := io.ReadAll(decrypted)
+	if err != nil {
+		t.Fatalf("klartext lesen: %v", err)
+	}
+	if !bytes.Equal(got, plaintext) {
+		t.Fatalf("altes objekt nach rotation = %q, want %q", got, plaintext)
+	}
+}

dms/internal/crypto/kekprovider.go

@@ -0,0 +1,80 @@
+package crypto
+
+import (
+	"context"
+	"encoding/base64"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"net/url"
+)
+
+// KEKProvider liefert den aktuellen, entschluesselten Tenant-KEK
+// (Akzeptanzkriterium 2: KEK kommt ausschliesslich von Core API-10).
+// Schmale Schnittstelle, damit Tests einen Fake statt eines echten
+// HTTP-Aufrufs einsetzen koennen.
+type KEKProvider interface {
+	TenantKEK(ctx context.Context, tenantSlug string) ([]byte, error)
+}
+
+// tenantKEKResponse entspricht Core internal/kek.tenantKEKResponse
+// (JSON-Vertrag: tenant_kek_base64) — dieselbe Struktur, hier gespiegelt,
+// da DMS Cores internal/-Pakete nicht importieren kann.
+type tenantKEKResponse struct {
+	TenantKEKBase64 string `json:"tenant_kek_base64"`
+}
+
+// HTTPKEKProvider bezieht den Tenant-KEK ueber Cores KEK-Handler
+// (internal/kek.Handler.TenantKEKHandler, API-10), authentifiziert ueber
+// dasselbe Service-Credential-Verfahren wie jeder andere Modul-Core-Aufruf
+// (API-02) — identisches Muster wie internal/storage.HTTPUsageReporter aus
+// FDN-03.
+type HTTPKEKProvider struct {
+	endpointURL  string
+	clientID     string
+	clientSecret string
+	httpClient   *http.Client
+}
+
+func NewHTTPKEKProvider(endpointURL, clientID, clientSecret string, httpClient *http.Client) *HTTPKEKProvider {
+	if httpClient == nil {
+		httpClient = http.DefaultClient
+	}
+	return &HTTPKEKProvider{endpointURL: endpointURL, clientID: clientID, clientSecret: clientSecret, httpClient: httpClient}
+}
+
+func (p *HTTPKEKProvider) TenantKEK(ctx context.Context, tenantSlug string) ([]byte, error) {
+	u, err := url.Parse(p.endpointURL)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: kek-endpunkt-url ungueltig: %w", err)
+	}
+	q := u.Query()
+	q.Set("tenant", tenantSlug)
+	u.RawQuery = q.Encode()
+
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, u.String(), nil)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: kek-anfrage aufbauen: %w", err)
+	}
+	req.Header.Set("X-Nexarch-Client-Id", p.clientID)
+	req.Header.Set("X-Nexarch-Client-Secret", p.clientSecret)
+
+	resp, err := p.httpClient.Do(req)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: kek-anfrage senden: %w", err)
+	}
+	defer func() { _ = resp.Body.Close() }()
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("crypto: kek-bezug von core abgelehnt: status %d", resp.StatusCode)
+	}
+
+	var body tenantKEKResponse
+	if err := json.NewDecoder(resp.Body).Decode(&body); err != nil {
+		return nil, fmt.Errorf("crypto: kek-antwort dekodieren: %w", err)
+	}
+	kek, err := base64.StdEncoding.DecodeString(body.TenantKEKBase64)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: kek base64-dekodieren: %w", err)
+	}
+	return kek, nil
+}

dms/internal/crypto/kekprovider_test.go

@@ -0,0 +1,65 @@
+package crypto
+
+import (
+	"context"
+	"encoding/base64"
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"testing"
+)
+
+// TestHTTPKEKProvider_SendsCorrectContractToCore ist der Nachweis, dass
+// HTTPKEKProvider exakt den Vertrag von Core internal/kek.Handler.
+// TenantKEKHandler bedient (Service-Credential-Header, tenant-Query-Param,
+// JSON-Feldname) — echte Vernetzung gegen einen laufenden Core-Prozess ist
+// nicht Teil dieses Tests (siehe FDN-09-Pruefprotokoll: derselbe
+// "nicht verdrahtet"-Befund wie bei internal/resync in FDN-03), daher hier
+// gegen einen httptest-Server geprueft, der denselben Vertrag nachbildet.
+func TestHTTPKEKProvider_SendsCorrectContractToCore(t *testing.T) {
+	wantKEK := make([]byte, KEKSize)
+	for i := range wantKEK {
+		wantKEK[i] = byte(i)
+	}
+
+	var gotClientID, gotClientSecret, gotTenant string
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		gotClientID = r.Header.Get("X-Nexarch-Client-Id")
+		gotClientSecret = r.Header.Get("X-Nexarch-Client-Secret")
+		gotTenant = r.URL.Query().Get("tenant")
+		w.Header().Set("Content-Type", "application/json")
+		_ = json.NewEncoder(w).Encode(tenantKEKResponse{TenantKEKBase64: base64.StdEncoding.EncodeToString(wantKEK)})
+	}))
+	defer srv.Close()
+
+	provider := NewHTTPKEKProvider(srv.URL, "dms-service-client", "dms-service-secret", nil)
+	got, err := provider.TenantKEK(context.Background(), "acme")
+	if err != nil {
+		t.Fatalf("tenantkek: %v", err)
+	}
+
+	if gotClientID != "dms-service-client" || gotClientSecret != "dms-service-secret" {
+		t.Fatalf("service-credential-header falsch: id=%q secret=%q", gotClientID, gotClientSecret)
+	}
+	if gotTenant != "acme" {
+		t.Fatalf("tenant-query-parameter = %q, want %q", gotTenant, "acme")
+	}
+	if len(got) != KEKSize || got[0] != wantKEK[0] {
+		t.Fatalf("erhaltener kek stimmt nicht mit erwartetem ueberein")
+	}
+}
+
+// TestHTTPKEKProvider_RejectsNonOKStatus prueft, dass ein von Core
+// abgelehnter Aufruf (z.B. Modul nicht fuer diesen Mandanten aktiv,
+// ErrForbidden auf Core-Seite) als Fehler zurueckgegeben wird.
+func TestHTTPKEKProvider_RejectsNonOKStatus(t *testing.T) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		http.Error(w, "zugriff auf diesen mandanten verweigert", http.StatusForbidden)
+	}))
+	defer srv.Close()
+
+	provider := NewHTTPKEKProvider(srv.URL, "x", "y", nil)
+	if _, err := provider.TenantKEK(context.Background(), "fremder-tenant"); err == nil {
+		t.Fatal("erwartet fehler bei abgelehntem kek-bezug, habe nil")
+	}
+}

dms/internal/crypto/service.go

@@ -0,0 +1,65 @@
+package crypto
+
+import (
+	"context"
+	"fmt"
+	"io"
+)
+
+// Envelope ist das Ergebnis einer Seal-Operation: der Chiffretext-Stream
+// plus der mit dem Tenant-KEK verpackte DEK, der zusammen mit dem Objekt
+// persistiert werden muss (z.B. in file_revisions, FDN-02 — die konkrete
+// Spalte ist nicht Bestandteil dieser Kachel, siehe "Nicht Bestandteil").
+type Envelope struct {
+	Ciphertext io.Reader
+	WrappedDEK []byte
+}
+
+// Service verbindet KEKProvider mit den Envelope-Operationen — die
+// Storage-Abstraktion (FDN-03) ruft ausschliesslich Service auf, nie die
+// Einzelfunktionen aus envelope.go direkt.
+type Service struct {
+	kek KEKProvider
+}
+
+func NewService(kek KEKProvider) *Service {
+	return &Service{kek: kek}
+}
+
+// Seal erzeugt einen neuen DEK (Akzeptanzkriterium 1), verschluesselt
+// plaintext damit und verpackt den DEK mit dem aktuellen Tenant-KEK
+// (Akzeptanzkriterium 2 — der KEK wird bei JEDEM Aufruf frisch von Core
+// bezogen, nie zwischengespeichert).
+func (s *Service) Seal(ctx context.Context, tenantSlug string, plaintext io.Reader) (*Envelope, error) {
+	dek, err := GenerateDEK()
+	if err != nil {
+		return nil, err
+	}
+	ciphertext, err := EncryptStream(dek, plaintext)
+	if err != nil {
+		return nil, err
+	}
+	kek, err := s.kek.TenantKEK(ctx, tenantSlug)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: tenant-kek beziehen: %w", err)
+	}
+	wrappedDEK, err := WrapDEK(kek, dek)
+	if err != nil {
+		return nil, err
+	}
+	return &Envelope{Ciphertext: ciphertext, WrappedDEK: wrappedDEK}, nil
+}
+
+// Open entpackt den DEK mit dem aktuellen Tenant-KEK und entschluesselt
+// ciphertext damit.
+func (s *Service) Open(ctx context.Context, tenantSlug string, wrappedDEK []byte, ciphertext io.Reader) (io.Reader, error) {
+	kek, err := s.kek.TenantKEK(ctx, tenantSlug)
+	if err != nil {
+		return nil, fmt.Errorf("crypto: tenant-kek beziehen: %w", err)
+	}
+	dek, err := UnwrapDEK(kek, wrappedDEK)
+	if err != nil {
+		return nil, err
+	}
+	return DecryptStream(dek, ciphertext)
+}

dms/internal/crypto/service_test.go

@@ -0,0 +1,77 @@
+package crypto
+
+import (
+	"bytes"
+	"context"
+	"io"
+	"testing"
+)
+
+// fakeKEKProvider liefert einen fest hinterlegten Tenant-KEK, ohne echten
+// HTTP-Aufruf — fuer Tests, die Service isoliert vom Core-Kontrakt pruefen
+// wollen (der Kontrakt selbst ist in kekprovider_test.go geprueft).
+type fakeKEKProvider struct {
+	kek   []byte
+	calls int
+}
+
+func (f *fakeKEKProvider) TenantKEK(ctx context.Context, tenantSlug string) ([]byte, error) {
+	f.calls++
+	return f.kek, nil
+}
+
+// TestService_SealOpen_RoundTrip ist der End-to-End-Nachweis fuer
+// Pruefung 1 ueber Service statt die Einzelfunktionen.
+func TestService_SealOpen_RoundTrip(t *testing.T) {
+	kekProvider := &fakeKEKProvider{kek: bytes.Repeat([]byte{0x07}, KEKSize)}
+	svc := NewService(kekProvider)
+	ctx := context.Background()
+	plaintext := []byte("vertraulicher dokumentinhalt")
+
+	env, err := svc.Seal(ctx, "acme", bytes.NewReader(plaintext))
+	if err != nil {
+		t.Fatalf("seal: %v", err)
+	}
+	ciphertextBytes, err := io.ReadAll(env.Ciphertext)
+	if err != nil {
+		t.Fatalf("chiffretext lesen: %v", err)
+	}
+	if bytes.Equal(ciphertextBytes, plaintext) {
+		t.Fatal("chiffretext ist identisch zum klartext")
+	}
+	if len(env.WrappedDEK) == 0 {
+		t.Fatal("erwartet nicht-leeren wrappeddek")
+	}
+
+	decrypted, err := svc.Open(ctx, "acme", env.WrappedDEK, bytes.NewReader(ciphertextBytes))
+	if err != nil {
+		t.Fatalf("open: %v", err)
+	}
+	got, err := io.ReadAll(decrypted)
+	if err != nil {
+		t.Fatalf("klartext lesen: %v", err)
+	}
+	if !bytes.Equal(got, plaintext) {
+		t.Fatalf("entschluesselter klartext = %q, want %q", got, plaintext)
+	}
+}
+
+// TestService_Seal_NeverPersistsKEK ist Akzeptanzkriterium 2 (struktureller
+// Nachweis): Service haelt den KEK nicht ueber einen Aufruf hinaus fest —
+// jeder Seal/Open-Aufruf bezieht ihn frisch ueber KEKProvider.
+func TestService_Seal_NeverPersistsKEK(t *testing.T) {
+	kekProvider := &fakeKEKProvider{kek: bytes.Repeat([]byte{0x09}, KEKSize)}
+	svc := NewService(kekProvider)
+	ctx := context.Background()
+
+	if _, err := svc.Seal(ctx, "acme", bytes.NewReader([]byte("a"))); err != nil {
+		t.Fatalf("seal 1: %v", err)
+	}
+	if _, err := svc.Seal(ctx, "acme", bytes.NewReader([]byte("b"))); err != nil {
+		t.Fatalf("seal 2: %v", err)
+	}
+
+	if kekProvider.calls != 2 {
+		t.Fatalf("erwartet 2 kek-abrufe (einer je Seal-Aufruf, kein Caching), habe %d", kekProvider.calls)
+	}
+}

dms/internal/jobqueue/queue.go

@@ -0,0 +1,238 @@
+// Package jobqueue implementiert FDN-04: eine Postgres-gestuetzte
+// Job-Queue mit Wiederholungslogik, Backoff und Dead-Letter-Queue — kein
+// Redis/AMQP (siehe Ticket-Vorgabe). FOR UPDATE SKIP LOCKED erlaubt
+// mehrere gleichzeitige Worker-Goroutinen (auch mehrinstanzfaehig, da der
+// Zustand ausschliesslich in Postgres liegt, keine In-Memory-Zaehler —
+// dieselbe Konvention wie Core internal/lockout, siehe "Bekannte Fehler
+// vermeiden" im Ticket).
+package jobqueue
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"time"
+
+	"github.com/jackc/pgx/v5"
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+// Status-Werte spiegeln den CHECK-Constraint der Migration.
+const (
+	StatusPending    = "pending"
+	StatusProcessing = "processing"
+	StatusSucceeded  = "succeeded"
+	StatusFailed     = "failed"
+	StatusDeadLetter = "dead_letter"
+)
+
+// ErrNotFound wird geliefert, wenn ein angefragter Job nicht existiert.
+var ErrNotFound = errors.New("jobqueue: job nicht gefunden")
+
+// ErrNoJobAvailable wird von Dequeue geliefert, wenn aktuell kein
+// abholbarer Job vorhanden ist (kein Fehlerzustand, sondern der Normalfall
+// bei leerer Queue).
+var ErrNoJobAvailable = errors.New("jobqueue: kein job verfuegbar")
+
+// Job ist eine einzelne Aufgabe in der Queue.
+type Job struct {
+	ID          string
+	JobType     string
+	Payload     json.RawMessage
+	Status      string
+	Attempts    int
+	MaxAttempts int
+	LastError   *string
+}
+
+// DefaultMaxAttempts/DefaultStaleLockAfter sind Standardwerte, ueberschreibbar
+// je Enqueue-Aufruf (MaxAttempts) bzw. am Queue selbst (StaleLockAfter).
+const (
+	DefaultMaxAttempts = 5
+)
+
+// Queue kapselt den Zugriff auf processing_jobs.
+type Queue struct {
+	pool           *pgxpool.Pool
+	staleLockAfter time.Duration
+}
+
+// NewQueue erzeugt eine Queue. staleLockAfter legt fest, ab wann ein
+// Job, der als "processing" markiert ist, aber dessen Worker vermutlich
+// abgestuerzt ist, wieder als abholbar gilt (Pruefung 1: Absturz fuehrt zu
+// erneuter Zustellung) — kein Heartbeat-Mechanismus noetig, ein grosszuegiges
+// Zeitfenster genuegt fuer die "kleinste Loesung".
+func NewQueue(pool *pgxpool.Pool, staleLockAfter time.Duration) *Queue {
+	return &Queue{pool: pool, staleLockAfter: staleLockAfter}
+}
+
+// EnqueueOptions steuert optionale Einreih-Parameter.
+type EnqueueOptions struct {
+	// IdempotencyKey verhindert doppelte Einreihung derselben logischen
+	// Aufgabe (Pruefung 2: Idempotenz bei Doppelzustellung) — leer bedeutet
+	// kein Dedup-Anspruch.
+	IdempotencyKey string
+	MaxAttempts    int
+}
+
+// Enqueue reiht einen neuen Job ein (Akzeptanzkriterium 1). Bei gesetztem
+// IdempotencyKey und bereits existierendem gleichen Key wird die ID des
+// BEREITS vorhandenen Jobs zurueckgegeben, kein Duplikat angelegt.
+func (q *Queue) Enqueue(ctx context.Context, jobType string, payload any, opts EnqueueOptions) (string, error) {
+	payloadJSON, err := json.Marshal(payload)
+	if err != nil {
+		return "", fmt.Errorf("jobqueue: payload serialisieren: %w", err)
+	}
+	maxAttempts := opts.MaxAttempts
+	if maxAttempts <= 0 {
+		maxAttempts = DefaultMaxAttempts
+	}
+
+	var idempotencyKey any
+	if opts.IdempotencyKey != "" {
+		idempotencyKey = opts.IdempotencyKey
+	}
+
+	var id string
+	err = q.pool.QueryRow(ctx, `
+		INSERT INTO processing_jobs (job_type, payload, idempotency_key, max_attempts)
+		VALUES ($1, $2, $3, $4)
+		ON CONFLICT (idempotency_key) DO UPDATE SET job_type = processing_jobs.job_type
+		RETURNING id
+	`, jobType, payloadJSON, idempotencyKey, maxAttempts).Scan(&id)
+	if err != nil {
+		return "", fmt.Errorf("jobqueue: job einreihen: %w", err)
+	}
+	return id, nil
+}
+
+// Dequeue holt GENAU EINEN abholbaren Job (faellig UND nicht bereits von
+// einem anderen Worker gesperrt, ODER dessen Sperre als abgestanden gilt)
+// und markiert ihn atomar als "processing" (Akzeptanzkriterium 1 / Pruefung
+// 1 — FOR UPDATE SKIP LOCKED erlaubt mehreren Worker-Goroutinen
+// gleichzeitigen Aufruf ohne sich gegenseitig zu blockieren oder denselben
+// Job doppelt zu holen).
+func (q *Queue) Dequeue(ctx context.Context, workerID string, jobTypes []string) (*Job, error) {
+	tx, err := q.pool.Begin(ctx)
+	if err != nil {
+		return nil, fmt.Errorf("jobqueue: transaktion starten: %w", err)
+	}
+	defer func() { _ = tx.Rollback(ctx) }()
+
+	var typeFilter []string
+	if len(jobTypes) > 0 {
+		typeFilter = jobTypes
+	}
+
+	row := tx.QueryRow(ctx, `
+		SELECT id, job_type, payload, status, attempts, max_attempts, last_error
+		FROM processing_jobs
+		WHERE (
+			(status = 'pending' AND available_at <= now())
+			OR (status = 'processing' AND locked_at <= now() - ($2 * interval '1 second'))
+		)
+		AND ($1::text[] IS NULL OR job_type = ANY($1))
+		ORDER BY available_at
+		FOR UPDATE SKIP LOCKED
+		LIMIT 1
+	`, typeFilter, q.staleLockAfter.Seconds())
+
+	var j Job
+	if err := row.Scan(&j.ID, &j.JobType, &j.Payload, &j.Status, &j.Attempts, &j.MaxAttempts, &j.LastError); err != nil {
+		if errors.Is(err, pgx.ErrNoRows) {
+			return nil, ErrNoJobAvailable
+		}
+		return nil, fmt.Errorf("jobqueue: naechsten job lesen: %w", err)
+	}
+
+	if _, err := tx.Exec(ctx, `
+		UPDATE processing_jobs
+		SET status = 'processing', attempts = attempts + 1, locked_at = now(), locked_by = $2, updated_at = now()
+		WHERE id = $1
+	`, j.ID, workerID); err != nil {
+		return nil, fmt.Errorf("jobqueue: job sperren: %w", err)
+	}
+
+	if err := tx.Commit(ctx); err != nil {
+		return nil, fmt.Errorf("jobqueue: dequeue committen: %w", err)
+	}
+
+	j.Status = StatusProcessing
+	j.Attempts++
+	return &j, nil
+}
+
+// Complete markiert einen Job als erfolgreich abgeschlossen.
+func (q *Queue) Complete(ctx context.Context, jobID string) error {
+	tag, err := q.pool.Exec(ctx, `
+		UPDATE processing_jobs SET status = 'succeeded', locked_at = NULL, locked_by = NULL, updated_at = now()
+		WHERE id = $1
+	`, jobID)
+	if err != nil {
+		return fmt.Errorf("jobqueue: job abschliessen: %w", err)
+	}
+	if tag.RowsAffected() == 0 {
+		return ErrNotFound
+	}
+	return nil
+}
+
+// Fail markiert einen Job als fehlgeschlagen (Akzeptanzkriterium 2): sind
+// die maximalen Versuche erreicht, wandert der Job in die Dead-Letter-Queue
+// (status='dead_letter'), sonst wird er mit exponentiellem Backoff erneut
+// eingeplant. Backoff-Berechnung nutzt arithmetischen Intervall-Cast
+// (attempts * interval), KEINE String-Konkatenation (siehe "Bekannte
+// Fehler vermeiden" im Ticket).
+func (q *Queue) Fail(ctx context.Context, jobID string, cause error) error {
+	errMsg := cause.Error()
+	tag, err := q.pool.Exec(ctx, `
+		UPDATE processing_jobs
+		SET status = CASE WHEN attempts >= max_attempts THEN 'dead_letter' ELSE 'pending' END,
+		    available_at = now() + (LEAST(attempts, 10) * interval '30 seconds'),
+		    locked_at = NULL, locked_by = NULL, last_error = $2, updated_at = now()
+		WHERE id = $1
+	`, jobID, errMsg)
+	if err != nil {
+		return fmt.Errorf("jobqueue: fehlschlag erfassen: %w", err)
+	}
+	if tag.RowsAffected() == 0 {
+		return ErrNotFound
+	}
+	return nil
+}
+
+// Status liefert den aktuellen Zustand eines Jobs (Akzeptanzkriterium 3).
+func (q *Queue) Status(ctx context.Context, jobID string) (*Job, error) {
+	var j Job
+	err := q.pool.QueryRow(ctx, `
+		SELECT id, job_type, payload, status, attempts, max_attempts, last_error
+		FROM processing_jobs WHERE id = $1
+	`, jobID).Scan(&j.ID, &j.JobType, &j.Payload, &j.Status, &j.Attempts, &j.MaxAttempts, &j.LastError)
+	if err != nil {
+		if errors.Is(err, pgx.ErrNoRows) {
+			return nil, ErrNotFound
+		}
+		return nil, fmt.Errorf("jobqueue: job-status lesen: %w", err)
+	}
+	return &j, nil
+}
+
+// RequeueDeadLetter holt einen Job manuell aus der Dead-Letter-Queue zurueck
+// in "pending", mit zurueckgesetztem Versuchszaehler (Pruefung 3: DLQ-Eintrag
+// manuell wiederholbar). Nur fuer Jobs, die tatsaechlich in dead_letter
+// stehen — verhindert versehentliches Requeue eines noch laufenden Jobs.
+func (q *Queue) RequeueDeadLetter(ctx context.Context, jobID string) error {
+	tag, err := q.pool.Exec(ctx, `
+		UPDATE processing_jobs
+		SET status = 'pending', attempts = 0, available_at = now(), last_error = NULL, updated_at = now()
+		WHERE id = $1 AND status = 'dead_letter'
+	`, jobID)
+	if err != nil {
+		return fmt.Errorf("jobqueue: dead-letter-job erneut einreihen: %w", err)
+	}
+	if tag.RowsAffected() == 0 {
+		return fmt.Errorf("jobqueue: job %q steht nicht in dead_letter (oder existiert nicht): %w", jobID, ErrNotFound)
+	}
+	return nil
+}

dms/internal/jobqueue/queue_test.go

@@ -0,0 +1,233 @@
+package jobqueue
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"os"
+	"testing"
+	"time"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+func setupTest(t *testing.T) *pgxpool.Pool {
+	t.Helper()
+	dsn := os.Getenv("TEST_TENANT_DSN")
+	if dsn == "" {
+		t.Skip("TEST_TENANT_DSN nicht gesetzt, Integrationstest uebersprungen")
+	}
+	ctx := context.Background()
+
+	pool, err := pgxpool.New(ctx, dsn)
+	if err != nil {
+		t.Fatalf("pool: %v", err)
+	}
+	t.Cleanup(func() { pool.Close() })
+
+	if _, err := pool.Exec(ctx, `
+		CREATE EXTENSION IF NOT EXISTS pgcrypto;
+		CREATE TABLE IF NOT EXISTS processing_jobs (
+			id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+			job_type        TEXT NOT NULL,
+			payload         JSONB NOT NULL DEFAULT '{}'::jsonb,
+			idempotency_key TEXT UNIQUE,
+			status          TEXT NOT NULL DEFAULT 'pending'
+			                CHECK (status IN ('pending', 'processing', 'succeeded', 'failed', 'dead_letter')),
+			attempts        INT NOT NULL DEFAULT 0,
+			max_attempts    INT NOT NULL DEFAULT 5,
+			available_at    TIMESTAMPTZ NOT NULL DEFAULT now(),
+			locked_at       TIMESTAMPTZ,
+			locked_by       TEXT,
+			last_error      TEXT,
+			created_at      TIMESTAMPTZ NOT NULL DEFAULT now(),
+			updated_at      TIMESTAMPTZ NOT NULL DEFAULT now()
+		);
+	`); err != nil {
+		t.Fatalf("schema: %v", err)
+	}
+	// DROP statt nur TRUNCATE: internal/jobqueue und internal/migrate teilen
+	// sich dieselbe physische Test-Datenbank (TEST_TENANT_DSN) ueber
+	// Paketgrenzen hinweg. Bliebe die Tabelle stehen, wuerde internal/migrate
+	// spaeter mit "relation already exists" gegen die von diesem Fixture
+	// angelegte, aber unversionierte Tabelle scheitern.
+	t.Cleanup(func() {
+		_, _ = pool.Exec(context.Background(), `DROP TABLE IF EXISTS processing_jobs`)
+	})
+	return pool
+}
+
+// TestEnqueueDequeueComplete ist Akzeptanzkriterium 1: Jobs werden
+// zuverlaessig eingereiht und verarbeitet.
+func TestEnqueueDequeueComplete(t *testing.T) {
+	pool := setupTest(t)
+	q := NewQueue(pool, time.Minute)
+	ctx := context.Background()
+
+	id, err := q.Enqueue(ctx, "index-document", map[string]string{"document_id": "d1"}, EnqueueOptions{})
+	if err != nil {
+		t.Fatalf("enqueue: %v", err)
+	}
+
+	job, err := q.Dequeue(ctx, "worker-1", nil)
+	if err != nil {
+		t.Fatalf("dequeue: %v", err)
+	}
+	if job.ID != id {
+		t.Fatalf("dequeue lieferte job %q, want %q", job.ID, id)
+	}
+	if job.Status != StatusProcessing {
+		t.Fatalf("status nach dequeue = %q, want %q", job.Status, StatusProcessing)
+	}
+	var payload map[string]string
+	if err := json.Unmarshal(job.Payload, &payload); err != nil {
+		t.Fatalf("payload dekodieren: %v", err)
+	}
+	if payload["document_id"] != "d1" {
+		t.Fatalf("payload = %v, want document_id=d1", payload)
+	}
+
+	if err := q.Complete(ctx, job.ID); err != nil {
+		t.Fatalf("complete: %v", err)
+	}
+
+	status, err := q.Status(ctx, job.ID)
+	if err != nil {
+		t.Fatalf("status: %v", err)
+	}
+	if status.Status != StatusSucceeded {
+		t.Fatalf("endstatus = %q, want %q", status.Status, StatusSucceeded)
+	}
+}
+
+// TestDequeue_NoJobAvailable prueft den Leerfall.
+func TestDequeue_NoJobAvailable(t *testing.T) {
+	pool := setupTest(t)
+	q := NewQueue(pool, time.Minute)
+
+	if _, err := q.Dequeue(context.Background(), "worker-1", nil); !errors.Is(err, ErrNoJobAvailable) {
+		t.Fatalf("erwartet ErrNoJobAvailable, habe %v", err)
+	}
+}
+
+// TestFail_LandsInDeadLetterAfterMaxAttempts ist Akzeptanzkriterium 2.
+func TestFail_LandsInDeadLetterAfterMaxAttempts(t *testing.T) {
+	pool := setupTest(t)
+	q := NewQueue(pool, time.Minute)
+	ctx := context.Background()
+
+	id, err := q.Enqueue(ctx, "ocr", nil, EnqueueOptions{MaxAttempts: 2})
+	if err != nil {
+		t.Fatalf("enqueue: %v", err)
+	}
+
+	// Versuch 1: schlaegt fehl, geht zurueck nach "pending" (max_attempts=2 noch nicht erreicht).
+	job, err := q.Dequeue(ctx, "worker-1", nil)
+	if err != nil {
+		t.Fatalf("dequeue 1: %v", err)
+	}
+	if err := q.Fail(ctx, job.ID, errors.New("ocr-engine nicht erreichbar")); err != nil {
+		t.Fatalf("fail 1: %v", err)
+	}
+	status, err := q.Status(ctx, id)
+	if err != nil {
+		t.Fatalf("status nach fail 1: %v", err)
+	}
+	if status.Status != StatusPending {
+		t.Fatalf("status nach fail 1 = %q, want %q (noch nicht erschoepft)", status.Status, StatusPending)
+	}
+
+	// Versuch 2: Backoff manuell umgehen (available_at direkt zuruecksetzen,
+	// damit der Test nicht auf echten Backoff warten muss).
+	if _, err := pool.Exec(ctx, `UPDATE processing_jobs SET available_at = now() WHERE id = $1`, id); err != nil {
+		t.Fatalf("available_at zuruecksetzen: %v", err)
+	}
+	job2, err := q.Dequeue(ctx, "worker-1", nil)
+	if err != nil {
+		t.Fatalf("dequeue 2: %v", err)
+	}
+	if err := q.Fail(ctx, job2.ID, errors.New("ocr-engine weiterhin nicht erreichbar")); err != nil {
+		t.Fatalf("fail 2: %v", err)
+	}
+
+	final, err := q.Status(ctx, id)
+	if err != nil {
+		t.Fatalf("status nach fail 2: %v", err)
+	}
+	if final.Status != StatusDeadLetter {
+		t.Fatalf("status nach erschoepften versuchen = %q, want %q", final.Status, StatusDeadLetter)
+	}
+	if final.LastError == nil || *final.LastError == "" {
+		t.Fatal("erwartet gesetzten last_error im dead-letter-eintrag")
+	}
+}
+
+// TestRequeueDeadLetter ist Pruefung 3: DLQ-Eintrag manuell wiederholbar.
+func TestRequeueDeadLetter(t *testing.T) {
+	pool := setupTest(t)
+	q := NewQueue(pool, time.Minute)
+	ctx := context.Background()
+
+	id, err := q.Enqueue(ctx, "convert", nil, EnqueueOptions{MaxAttempts: 1})
+	if err != nil {
+		t.Fatalf("enqueue: %v", err)
+	}
+	job, err := q.Dequeue(ctx, "worker-1", nil)
+	if err != nil {
+		t.Fatalf("dequeue: %v", err)
+	}
+	if err := q.Fail(ctx, job.ID, errors.New("konverter abgestuerzt")); err != nil {
+		t.Fatalf("fail: %v", err)
+	}
+	status, _ := q.Status(ctx, id)
+	if status.Status != StatusDeadLetter {
+		t.Fatalf("voraussetzung nicht erfuellt: job sollte in dead_letter stehen, ist %q", status.Status)
+	}
+
+	if err := q.RequeueDeadLetter(ctx, id); err != nil {
+		t.Fatalf("requeuedeadletter: %v", err)
+	}
+	afterRequeue, err := q.Status(ctx, id)
+	if err != nil {
+		t.Fatalf("status nach requeue: %v", err)
+	}
+	if afterRequeue.Status != StatusPending {
+		t.Fatalf("status nach requeue = %q, want %q", afterRequeue.Status, StatusPending)
+	}
+	if afterRequeue.Attempts != 0 {
+		t.Fatalf("attempts nach requeue = %d, want 0", afterRequeue.Attempts)
+	}
+
+	// Requeue eines NICHT in dead_letter stehenden Jobs wird abgewiesen.
+	if err := q.RequeueDeadLetter(ctx, id); !errors.Is(err, ErrNotFound) {
+		t.Fatalf("requeue eines pending-jobs: erwartet ErrNotFound, habe %v", err)
+	}
+}
+
+// TestEnqueue_IdempotencyKeyPreventsDuplicate ist Pruefung 2: Idempotenz
+// bei Doppelzustellung nachgewiesen (auf Einreih-Ebene).
+func TestEnqueue_IdempotencyKeyPreventsDuplicate(t *testing.T) {
+	pool := setupTest(t)
+	q := NewQueue(pool, time.Minute)
+	ctx := context.Background()
+
+	id1, err := q.Enqueue(ctx, "ocr", nil, EnqueueOptions{IdempotencyKey: "ocr:revision-42"})
+	if err != nil {
+		t.Fatalf("enqueue 1: %v", err)
+	}
+	id2, err := q.Enqueue(ctx, "ocr", nil, EnqueueOptions{IdempotencyKey: "ocr:revision-42"})
+	if err != nil {
+		t.Fatalf("enqueue 2 (doppelzustellung): %v", err)
+	}
+	if id1 != id2 {
+		t.Fatalf("doppelte einreihung mit gleichem idempotency-key erzeugte zwei jobs: %q != %q", id1, id2)
+	}
+
+	var count int
+	if err := pool.QueryRow(ctx, `SELECT count(*) FROM processing_jobs WHERE idempotency_key = 'ocr:revision-42'`).Scan(&count); err != nil {
+		t.Fatalf("zeilen zaehlen: %v", err)
+	}
+	if count != 1 {
+		t.Fatalf("erwartet genau 1 zeile fuer den idempotency-key, habe %d", count)
+	}
+}

dms/internal/jobqueue/worker.go

@@ -0,0 +1,75 @@
+package jobqueue
+
+import (
+	"context"
+	"errors"
+	"log"
+	"time"
+)
+
+// Handler verarbeitet einen einzelnen Job. Ein zurueckgegebener Fehler
+// fuehrt zu Queue.Fail (Backoff/DLQ), nil zu Queue.Complete.
+type Handler func(ctx context.Context, job *Job) error
+
+// Worker pollt die Queue in einer In-Prozess-Goroutine und ruft Handler je
+// abgeholtem Job auf — die "In-Prozess-Worker-Goroutinen" aus der
+// Ticket-Vorgabe, kein separater Prozess/Redis noetig.
+type Worker struct {
+	queue        *Queue
+	workerID     string
+	jobTypes     []string
+	pollInterval time.Duration
+	handler      Handler
+}
+
+func NewWorker(queue *Queue, workerID string, jobTypes []string, pollInterval time.Duration, handler Handler) *Worker {
+	return &Worker{queue: queue, workerID: workerID, jobTypes: jobTypes, pollInterval: pollInterval, handler: handler}
+}
+
+// Run blockiert, bis ctx beendet wird, und verarbeitet dabei fortlaufend
+// Jobs. Absturzsicherheit (Pruefung 1) entsteht NICHT durch Run selbst,
+// sondern dadurch, dass ein abgestuerzter Prozess (der Run gar nicht mehr
+// ausfuehrt) seine "processing"-Sperren nie verlaengert — ein ANDERER
+// Worker-Prozess holt den Job nach Ablauf von staleLockAfter erneut ab
+// (siehe Queue.Dequeue).
+func (w *Worker) Run(ctx context.Context) {
+	ticker := time.NewTicker(w.pollInterval)
+	defer ticker.Stop()
+	for {
+		select {
+		case <-ctx.Done():
+			return
+		case <-ticker.C:
+			w.processOne(ctx)
+		}
+	}
+}
+
+// processOne holt und verarbeitet EINEN Job, falls verfuegbar. Oeffentlich
+// über RunOnce fuer Tests, die deterministisch (ohne Polling-Timing) einen
+// einzelnen Verarbeitungsschritt auslösen wollen.
+func (w *Worker) processOne(ctx context.Context) {
+	job, err := w.queue.Dequeue(ctx, w.workerID, w.jobTypes)
+	if err != nil {
+		if !errors.Is(err, ErrNoJobAvailable) {
+			log.Printf("jobqueue: dequeue fehlgeschlagen: %v", err)
+		}
+		return
+	}
+
+	if handlerErr := w.handler(ctx, job); handlerErr != nil {
+		if err := w.queue.Fail(ctx, job.ID, handlerErr); err != nil {
+			log.Printf("jobqueue: fehlschlag fuer job %q nicht erfassbar: %v", job.ID, err)
+		}
+		return
+	}
+	if err := w.queue.Complete(ctx, job.ID); err != nil {
+		log.Printf("jobqueue: abschluss fuer job %q fehlgeschlagen: %v", job.ID, err)
+	}
+}
+
+// RunOnce verarbeitet synchron genau einen Job (falls verfuegbar) und
+// kehrt zurueck — fuer Tests, die ohne Polling-Intervall arbeiten wollen.
+func (w *Worker) RunOnce(ctx context.Context) {
+	w.processOne(ctx)
+}

dms/internal/jobqueue/worker_test.go

@@ -0,0 +1,115 @@
+package jobqueue
+
+import (
+	"context"
+	"errors"
+	"sync/atomic"
+	"testing"
+	"time"
+)
+
+// TestWorker_RunOnce_ProcessesAndCompletesJob ist der End-to-End-Nachweis
+// fuer Akzeptanzkriterium 1 ueber den Worker statt direkt ueber Queue.
+func TestWorker_RunOnce_ProcessesAndCompletesJob(t *testing.T) {
+	pool := setupTest(t)
+	q := NewQueue(pool, time.Minute)
+	ctx := context.Background()
+
+	id, err := q.Enqueue(ctx, "index-document", nil, EnqueueOptions{})
+	if err != nil {
+		t.Fatalf("enqueue: %v", err)
+	}
+
+	var handled int32
+	w := NewWorker(q, "worker-1", nil, time.Millisecond, func(ctx context.Context, job *Job) error {
+		atomic.AddInt32(&handled, 1)
+		return nil
+	})
+	w.RunOnce(ctx)
+
+	if atomic.LoadInt32(&handled) != 1 {
+		t.Fatalf("handler wurde %d mal aufgerufen, want 1", handled)
+	}
+	status, err := q.Status(ctx, id)
+	if err != nil {
+		t.Fatalf("status: %v", err)
+	}
+	if status.Status != StatusSucceeded {
+		t.Fatalf("status = %q, want %q", status.Status, StatusSucceeded)
+	}
+}
+
+// TestWorker_HandlerErrorTriggersFail prueft, dass ein Handler-Fehler zu
+// Queue.Fail fuehrt (Backoff/DLQ-Pfad ueber den Worker statt direkt).
+func TestWorker_HandlerErrorTriggersFail(t *testing.T) {
+	pool := setupTest(t)
+	q := NewQueue(pool, time.Minute)
+	ctx := context.Background()
+
+	id, err := q.Enqueue(ctx, "ocr", nil, EnqueueOptions{MaxAttempts: 5})
+	if err != nil {
+		t.Fatalf("enqueue: %v", err)
+	}
+
+	w := NewWorker(q, "worker-1", nil, time.Millisecond, func(ctx context.Context, job *Job) error {
+		return errors.New("ocr fehlgeschlagen")
+	})
+	w.RunOnce(ctx)
+
+	status, err := q.Status(ctx, id)
+	if err != nil {
+		t.Fatalf("status: %v", err)
+	}
+	if status.Status != StatusPending {
+		t.Fatalf("status nach handler-fehler = %q, want %q (erneut eingeplant)", status.Status, StatusPending)
+	}
+	if status.LastError == nil || *status.LastError != "ocr fehlgeschlagen" {
+		t.Fatalf("last_error = %v, want %q", status.LastError, "ocr fehlgeschlagen")
+	}
+}
+
+// TestDequeue_StaleLockIsRedelivered ist Pruefung 1: Absturz eines Workers
+// fuehrt zu erneuter Zustellung. Simuliert einen Absturz, indem ein Job
+// dequeued (auf "processing" gesperrt), aber NIE completed/failed wird —
+// nach Ablauf von staleLockAfter muss ein ANDERER Worker denselben Job
+// erneut abholen koennen.
+func TestDequeue_StaleLockIsRedelivered(t *testing.T) {
+	pool := setupTest(t)
+	// Sehr kurzes Stale-Fenster, damit der Test nicht lange warten muss.
+	q := NewQueue(pool, 50*time.Millisecond)
+	ctx := context.Background()
+
+	id, err := q.Enqueue(ctx, "convert", nil, EnqueueOptions{})
+	if err != nil {
+		t.Fatalf("enqueue: %v", err)
+	}
+
+	crashed, err := q.Dequeue(ctx, "worker-crashed", nil)
+	if err != nil {
+		t.Fatalf("dequeue (worker-crashed): %v", err)
+	}
+	if crashed.ID != id {
+		t.Fatalf("dequeue lieferte unerwarteten job %q", crashed.ID)
+	}
+	// worker-crashed ruft absichtlich weder Complete noch Fail auf — simuliert
+	// einen Prozessabsturz mitten in der Verarbeitung.
+
+	// Sofortiger erneuter Dequeue-Versuch (Sperre noch frisch) darf den Job
+	// NICHT liefern.
+	if _, err := q.Dequeue(ctx, "worker-2", nil); !errors.Is(err, ErrNoJobAvailable) {
+		t.Fatalf("job wurde trotz frischer sperre erneut ausgeliefert (oder anderer fehler): %v", err)
+	}
+
+	time.Sleep(80 * time.Millisecond) // > staleLockAfter
+
+	redelivered, err := q.Dequeue(ctx, "worker-2", nil)
+	if err != nil {
+		t.Fatalf("dequeue nach ablauf der sperre: %v", err)
+	}
+	if redelivered.ID != id {
+		t.Fatalf("erneut zugestellter job = %q, want %q", redelivered.ID, id)
+	}
+	if err := q.Complete(ctx, redelivered.ID); err != nil {
+		t.Fatalf("complete durch worker-2: %v", err)
+	}
+}

dms/internal/migrate/migrate.go

@@ -0,0 +1,165 @@
+// Package migrate implementiert FDN-02s Migrationsmechanik: versionierte,
+// rueckrollbare SQL-Migrationsdateien (kein ORM), mit einer
+// schema_migrations-Tabelle als Fortschrittsspeicher — dasselbe Prinzip wie
+// NEXARCH Core (internal/migrate), hier eigenstaendig implementiert, da DMS
+// ein eigenes Go-Modul ist und Cores internal/-Pakete nicht importieren
+// kann.
+package migrate
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"path/filepath"
+	"sort"
+	"strings"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+// Migration ist eine einzelne versionierte Migrationsdatei.
+type Migration struct {
+	Version string // Dateiname ohne .up.sql/.down.sql, z.B. "0001_documents"
+	UpSQL   string
+	DownSQL string
+}
+
+// Load liest alle *.up.sql/*.down.sql-Paare aus dir, sortiert nach
+// Dateiname (Akzeptanzkriterium: Migrationen sind versioniert).
+func Load(dir string) ([]Migration, error) {
+	entries, err := os.ReadDir(dir)
+	if err != nil {
+		return nil, fmt.Errorf("migrationsverzeichnis %q lesen: %w", dir, err)
+	}
+	var versions []string
+	for _, e := range entries {
+		if e.IsDir() || !strings.HasSuffix(e.Name(), ".up.sql") {
+			continue
+		}
+		versions = append(versions, strings.TrimSuffix(e.Name(), ".up.sql"))
+	}
+	sort.Strings(versions)
+
+	migrations := make([]Migration, 0, len(versions))
+	for _, v := range versions {
+		up, err := os.ReadFile(filepath.Join(dir, v+".up.sql"))
+		if err != nil {
+			return nil, fmt.Errorf("migration %q: up.sql lesen: %w", v, err)
+		}
+		down, err := os.ReadFile(filepath.Join(dir, v+".down.sql"))
+		if err != nil {
+			return nil, fmt.Errorf("migration %q: down.sql lesen (jede Migration braucht ein Rollback): %w", v, err)
+		}
+		migrations = append(migrations, Migration{Version: v, UpSQL: string(up), DownSQL: string(down)})
+	}
+	return migrations, nil
+}
+
+func ensureTrackingTable(ctx context.Context, pool *pgxpool.Pool) error {
+	_, err := pool.Exec(ctx, `
+		CREATE TABLE IF NOT EXISTS schema_migrations (
+			version    TEXT PRIMARY KEY,
+			applied_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		)
+	`)
+	if err != nil {
+		return fmt.Errorf("schema_migrations anlegen: %w", err)
+	}
+	return nil
+}
+
+func appliedVersions(ctx context.Context, pool *pgxpool.Pool) (map[string]bool, error) {
+	rows, err := pool.Query(ctx, `SELECT version FROM schema_migrations`)
+	if err != nil {
+		return nil, fmt.Errorf("angewendete migrationen lesen: %w", err)
+	}
+	defer rows.Close()
+
+	applied := map[string]bool{}
+	for rows.Next() {
+		var v string
+		if err := rows.Scan(&v); err != nil {
+			return nil, fmt.Errorf("migrationsversion lesen: %w", err)
+		}
+		applied[v] = true
+	}
+	return applied, rows.Err()
+}
+
+// Up wendet alle noch nicht angewendeten Migrationen in Reihenfolge an
+// (Akzeptanzkriterium 2: vorwaerts ausfuehrbar) — bereits angewendete
+// werden uebersprungen, damit Up auf einer leeren UND auf einer bestehenden
+// DB funktioniert (Pruefung 1).
+func Up(ctx context.Context, pool *pgxpool.Pool, migrations []Migration) (applied []string, err error) {
+	if err := ensureTrackingTable(ctx, pool); err != nil {
+		return nil, err
+	}
+	already, err := appliedVersions(ctx, pool)
+	if err != nil {
+		return nil, err
+	}
+
+	for _, m := range migrations {
+		if already[m.Version] {
+			continue
+		}
+		tx, err := pool.Begin(ctx)
+		if err != nil {
+			return applied, fmt.Errorf("transaktion fuer %q starten: %w", m.Version, err)
+		}
+		if _, err := tx.Exec(ctx, m.UpSQL); err != nil {
+			_ = tx.Rollback(ctx)
+			return applied, fmt.Errorf("migration %q anwenden: %w", m.Version, err)
+		}
+		if _, err := tx.Exec(ctx, `INSERT INTO schema_migrations (version) VALUES ($1)`, m.Version); err != nil {
+			_ = tx.Rollback(ctx)
+			return applied, fmt.Errorf("migration %q als angewendet markieren: %w", m.Version, err)
+		}
+		if err := tx.Commit(ctx); err != nil {
+			return applied, fmt.Errorf("migration %q committen: %w", m.Version, err)
+		}
+		applied = append(applied, m.Version)
+	}
+	return applied, nil
+}
+
+// DownOne macht die zuletzt angewendete Migration rueckgaengig
+// (Akzeptanzkriterium 2: rueckwaerts ausfuehrbar) und liefert deren Version,
+// oder "" falls keine Migration angewendet war.
+func DownOne(ctx context.Context, pool *pgxpool.Pool, migrations []Migration) (version string, err error) {
+	if err := ensureTrackingTable(ctx, pool); err != nil {
+		return "", err
+	}
+	already, err := appliedVersions(ctx, pool)
+	if err != nil {
+		return "", err
+	}
+
+	var last *Migration
+	for i := len(migrations) - 1; i >= 0; i-- {
+		if already[migrations[i].Version] {
+			last = &migrations[i]
+			break
+		}
+	}
+	if last == nil {
+		return "", nil
+	}
+
+	tx, err := pool.Begin(ctx)
+	if err != nil {
+		return "", fmt.Errorf("transaktion fuer rollback von %q starten: %w", last.Version, err)
+	}
+	if _, err := tx.Exec(ctx, last.DownSQL); err != nil {
+		_ = tx.Rollback(ctx)
+		return "", fmt.Errorf("migration %q zurueckrollen: %w", last.Version, err)
+	}
+	if _, err := tx.Exec(ctx, `DELETE FROM schema_migrations WHERE version = $1`, last.Version); err != nil {
+		_ = tx.Rollback(ctx)
+		return "", fmt.Errorf("migration %q aus schema_migrations entfernen: %w", last.Version, err)
+	}
+	if err := tx.Commit(ctx); err != nil {
+		return "", fmt.Errorf("rollback von %q committen: %w", last.Version, err)
+	}
+	return last.Version, nil
+}

dms/internal/migrate/migrate_test.go

@@ -0,0 +1,213 @@
+package migrate
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+// usersFixtureSQL spiegelt Core IAM-01s reales Schema
+// (migrations/tenant/0001_users.up.sql im NEXARCH-Core-Modul) - DMS ist ein
+// eigenes Go-Modul und kann Cores Migrationsdateien nicht importieren, daher
+// hier als Testfixture kopiert, NICHT als Produktionsmigration (DMS legt
+// users nicht selbst an, siehe "Nicht Bestandteil" in FDN-02).
+const usersFixtureSQL = `
+CREATE EXTENSION IF NOT EXISTS pgcrypto;
+CREATE TABLE IF NOT EXISTS users (
+    id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    email      TEXT NOT NULL UNIQUE,
+    name       TEXT NOT NULL,
+    status     TEXT NOT NULL DEFAULT 'active',
+    created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+`
+
+func setupTest(t *testing.T) (*pgxpool.Pool, []Migration) {
+	t.Helper()
+	dsn := os.Getenv("TEST_TENANT_DSN")
+	if dsn == "" {
+		t.Skip("TEST_TENANT_DSN nicht gesetzt, Integrationstest uebersprungen")
+	}
+	ctx := context.Background()
+
+	pool, err := pgxpool.New(ctx, dsn)
+	if err != nil {
+		t.Fatalf("pool: %v", err)
+	}
+	t.Cleanup(func() { pool.Close() })
+
+	if _, err := pool.Exec(ctx, usersFixtureSQL); err != nil {
+		t.Fatalf("users-fixture anlegen: %v", err)
+	}
+	if _, err := pool.Exec(ctx, `
+		INSERT INTO users (email, name) VALUES ('seed@example.test', 'Seed-Benutzer')
+		ON CONFLICT (email) DO NOTHING
+	`); err != nil {
+		t.Fatalf("seed-benutzer anlegen: %v", err)
+	}
+
+	migrations, err := Load(migrationsDir(t))
+	if err != nil {
+		t.Fatalf("migrationen laden: %v", err)
+	}
+	return pool, migrations
+}
+
+func migrationsDir(t *testing.T) string {
+	t.Helper()
+	wd, err := os.Getwd()
+	if err != nil {
+		t.Fatalf("getwd: %v", err)
+	}
+	return filepath.Join(wd, "..", "..", "migrations", "tenant")
+}
+
+func tableExists(t *testing.T, ctx context.Context, pool *pgxpool.Pool, name string) bool {
+	t.Helper()
+	var exists bool
+	if err := pool.QueryRow(ctx, `
+		SELECT EXISTS (SELECT 1 FROM information_schema.tables WHERE table_name = $1)
+	`, name).Scan(&exists); err != nil {
+		t.Fatalf("tabellenexistenz von %q pruefen: %v", name, err)
+	}
+	return exists
+}
+
+// TestUp_OnEmptyAndExistingDB ist Pruefung 1: Migration auf leerer DB und
+// auf bestehender DB getestet.
+func TestUp_OnEmptyAndExistingDB(t *testing.T) {
+	pool, migrations := setupTest(t)
+	ctx := context.Background()
+
+	applied, err := Up(ctx, pool, migrations)
+	if err != nil {
+		t.Fatalf("up (leere db): %v", err)
+	}
+	if len(applied) == 0 {
+		t.Fatal("erwartet mindestens 1 angewendete migration auf leerer db")
+	}
+	for _, table := range []string{"folders", "documents", "file_revisions", "tags", "document_tags", "metadata_fields", "document_metadata_values"} {
+		if !tableExists(t, ctx, pool, table) {
+			t.Fatalf("tabelle %q existiert nach Up nicht", table)
+		}
+	}
+
+	// Zweiter Up-Lauf gegen die JETZT BESTEHENDE db - muss ohne Fehler
+	// durchlaufen und darf nichts erneut anwenden (idempotent ueber
+	// schema_migrations).
+	appliedAgain, err := Up(ctx, pool, migrations)
+	if err != nil {
+		t.Fatalf("up (bestehende db, zweiter lauf): %v", err)
+	}
+	if len(appliedAgain) != 0 {
+		t.Fatalf("zweiter Up-Lauf haette 0 neue migrationen anwenden sollen, hat %d", len(appliedAgain))
+	}
+}
+
+// TestDownOne_RestoresPreviousState ist Pruefung 2: Rollback stellt den
+// Vorzustand wieder her.
+func TestDownOne_RestoresPreviousState(t *testing.T) {
+	pool, migrations := setupTest(t)
+	ctx := context.Background()
+
+	if _, err := Up(ctx, pool, migrations); err != nil {
+		t.Fatalf("up: %v", err)
+	}
+	if !tableExists(t, ctx, pool, "documents") {
+		t.Fatal("voraussetzung nicht erfuellt: documents sollte nach Up existieren")
+	}
+
+	// DownOne rollt IMMER nur die zuletzt angewendete Migration zurueck
+	// (dokumentiertes Verhalten) — bei mehreren Migrationen (z.B. FDN-02
+	// documents + FDN-04 processing_jobs) muss man entsprechend oft
+	// aufrufen. Anzahl der Wiederholungen richtet sich NICHT nach dem
+	// Rueckgabewert von Up() (der nur die in DIESEM Aufruf NEU angewendeten
+	// Migrationen zaehlt, siehe Kommentar an Up) — stattdessen wird
+	// wiederholt, bis DownOne "" liefert (schema_migrations leer).
+	for i := 0; i < len(migrations); i++ {
+		version, err := DownOne(ctx, pool, migrations)
+		if err != nil {
+			t.Fatalf("downone (lauf %d): %v", i, err)
+		}
+		if version == "" {
+			break
+		}
+	}
+
+	for _, table := range []string{"folders", "documents", "file_revisions", "tags", "document_tags", "metadata_fields", "document_metadata_values", "processing_jobs"} {
+		if tableExists(t, ctx, pool, table) {
+			t.Fatalf("tabelle %q existiert nach vollstaendigem Rollback noch - Vorzustand nicht wiederhergestellt", table)
+		}
+	}
+
+	// Erneutes DownOne ohne verbleibende angewendete Migration liefert "".
+	versionAfterAll, err := DownOne(ctx, pool, migrations)
+	if err != nil {
+		t.Fatalf("downone (nichts mehr anzuwenden): %v", err)
+	}
+	if versionAfterAll != "" {
+		t.Fatalf("erwartet leeren string bei leerer schema_migrations, habe %q", versionAfterAll)
+	}
+}
+
+// TestForeignKeyConstraints_RejectInvalidReferences ist Pruefung 3:
+// Fremdschluessel-Constraints durch Negativtests belegt.
+func TestForeignKeyConstraints_RejectInvalidReferences(t *testing.T) {
+	pool, migrations := setupTest(t)
+	ctx := context.Background()
+	if _, err := Up(ctx, pool, migrations); err != nil {
+		t.Fatalf("up: %v", err)
+	}
+
+	var userID string
+	if err := pool.QueryRow(ctx, `SELECT id FROM users LIMIT 1`).Scan(&userID); err != nil {
+		t.Fatalf("seed-benutzer lesen: %v", err)
+	}
+
+	t.Run("dokument mit unbekanntem ordner wird abgewiesen", func(t *testing.T) {
+		_, err := pool.Exec(ctx, `
+			INSERT INTO documents (folder_id, title, created_by) VALUES (gen_random_uuid(), 'x', $1)
+		`, userID)
+		if err == nil {
+			t.Fatal("insert mit unbekanntem folder_id haette scheitern muessen")
+		}
+	})
+
+	t.Run("dokument mit unbekanntem ersteller wird abgewiesen", func(t *testing.T) {
+		_, err := pool.Exec(ctx, `
+			INSERT INTO documents (title, created_by) VALUES ('x', gen_random_uuid())
+		`)
+		if err == nil {
+			t.Fatal("insert mit unbekanntem created_by haette scheitern muessen")
+		}
+	})
+
+	t.Run("datei-revision mit unbekanntem dokument wird abgewiesen", func(t *testing.T) {
+		_, err := pool.Exec(ctx, `
+			INSERT INTO file_revisions (document_id, revision_number, storage_key, checksum_sha256, size_bytes, mime_type, created_by)
+			VALUES (gen_random_uuid(), 1, 'k', repeat('0',64), 1, 'text/plain', $1)
+		`, userID)
+		if err == nil {
+			t.Fatal("insert mit unbekanntem document_id haette scheitern muessen")
+		}
+	})
+
+	t.Run("tag-zuordnung mit unbekanntem tag wird abgewiesen", func(t *testing.T) {
+		var docID string
+		if err := pool.QueryRow(ctx, `
+			INSERT INTO documents (title, created_by) VALUES ('fk-test-doc', $1) RETURNING id
+		`, userID).Scan(&docID); err != nil {
+			t.Fatalf("testdokument anlegen: %v", err)
+		}
+		_, err := pool.Exec(ctx, `
+			INSERT INTO document_tags (document_id, tag_id) VALUES ($1, gen_random_uuid())
+		`, docID)
+		if err == nil {
+			t.Fatal("insert mit unbekanntem tag_id haette scheitern muessen")
+		}
+	})
+}

dms/internal/shared/version.go

@@ -0,0 +1,8 @@
+// Package shared enthaelt Code, der von App und Worker gemeinsam genutzt
+// wird (FDN-01) — Datenmodell, Storage-Zugriff etc. kommen in spaeteren
+// Kacheln (FDN-02/FDN-03) hierher, dieses Paket ist bewusst noch schlank.
+package shared
+
+// Version ist die aktuelle DMS-Version, per -ldflags ueberschreibbar
+// (siehe Makefile) — Platzhalter fuer echtes Versionsmanagement.
+var Version = "dev"

dms/internal/storage/driver.go

@@ -0,0 +1,45 @@
+// Package storage implementiert FDN-03: eine einheitliche Objekt-Storage-
+// Abstraktion mit zwei austauschbaren Treibern (lokal fuer Entwicklung,
+// S3-kompatibel fuer Produktion). Verschluesselung at rest ist NICHT
+// Bestandteil dieser Kachel (siehe FDN-09) — dieses Paket legt Bytes
+// unveraendert ab.
+package storage
+
+import (
+	"context"
+	"errors"
+	"io"
+	"time"
+)
+
+// ErrNotFound wird geliefert, wenn ein angefragtes Objekt nicht existiert
+// (Akzeptanzkriterium/Pruefung 3: klarer Fehler statt treiberspezifischer
+// Fehlertypen, die der Aufrufer sonst je Treiber unterschiedlich behandeln
+// muesste).
+var ErrNotFound = errors.New("storage: objekt nicht gefunden")
+
+// Driver ist die EINE Schnittstelle, gegen die der Rest von DMS arbeitet
+// (Akzeptanzkriterium 1). Zwei Implementierungen: LocalDriver (Entwicklung)
+// und S3Driver (Produktion, S3-kompatibel).
+type Driver interface {
+	// Put legt die Bytes aus r unter key ab und liefert die tatsaechlich
+	// geschriebene Groesse in Bytes.
+	Put(ctx context.Context, key string, r io.Reader, size int64, contentType string) (int64, error)
+	// Get liefert die Bytes unter key. Existiert key nicht, liefert Get
+	// ErrNotFound.
+	Get(ctx context.Context, key string) (io.ReadCloser, error)
+	// Delete entfernt das Objekt unter key. Existiert key nicht, liefert
+	// Delete ErrNotFound.
+	Delete(ctx context.Context, key string) error
+	// SignedURL liefert eine zeitlich begrenzte, signierte URL zum Lesen des
+	// Objekts (Akzeptanzkriterium 2: konfigurierbare Gueltigkeit ueber ttl).
+	SignedURL(ctx context.Context, key string, ttl time.Duration) (string, error)
+}
+
+// ObjectKey liefert das Pfadschema fuer ein Dokument/Revision INNERHALB des
+// Mandanten-Buckets (Akzeptanzkriterium 3) — die Bucket-Trennung selbst ist
+// Sache von Core TEN-01, hier geht es nur um den Pfad innerhalb eines
+// bereits mandantenspezifischen Buckets.
+func ObjectKey(documentID, revisionID string) string {
+	return "documents/" + documentID + "/revisions/" + revisionID
+}

dms/internal/storage/localdriver.go

@@ -0,0 +1,113 @@
+package storage
+
+import (
+	"context"
+	"crypto/hmac"
+	"crypto/sha256"
+	"crypto/subtle"
+	"encoding/base64"
+	"errors"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"strconv"
+	"strings"
+	"time"
+)
+
+// ErrURLExpired wird von VerifySignedURL geliefert, wenn eine signierte URL
+// nach Ablauf ihrer Gueltigkeit verwendet wird (Pruefung 2).
+var ErrURLExpired = errors.New("storage: signierte url ist abgelaufen")
+
+// ErrInvalidSignature wird geliefert, wenn die Signatur einer URL nicht zum
+// Schluessel passt (manipulierte oder falsche URL).
+var ErrInvalidSignature = errors.New("storage: signatur der url ist ungueltig")
+
+// LocalDriver legt Objekte im lokalen Dateisystem ab — der Entwicklungs-
+// Treiber (Akzeptanzkriterium 1), keine externe Abhaengigkeit noetig.
+type LocalDriver struct {
+	baseDir       string
+	signingSecret []byte
+	publicBaseURL string
+}
+
+// NewLocalDriver erzeugt einen LocalDriver. signingSecret authentifiziert
+// die von SignedURL ausgestellten URLs (HMAC-SHA256, konstant-zeit-
+// verglichen bei der Verifikation — timing-safe wie projektweite Konvention,
+// siehe Core IAM-15).
+func NewLocalDriver(baseDir string, signingSecret []byte, publicBaseURL string) *LocalDriver {
+	return &LocalDriver{baseDir: baseDir, signingSecret: signingSecret, publicBaseURL: publicBaseURL}
+}
+
+func (d *LocalDriver) path(key string) string {
+	return filepath.Join(d.baseDir, filepath.FromSlash(key))
+}
+
+func (d *LocalDriver) Put(ctx context.Context, key string, r io.Reader, size int64, contentType string) (int64, error) {
+	full := d.path(key)
+	if err := os.MkdirAll(filepath.Dir(full), 0o755); err != nil {
+		return 0, fmt.Errorf("storage: verzeichnis anlegen: %w", err)
+	}
+	f, err := os.Create(full)
+	if err != nil {
+		return 0, fmt.Errorf("storage: datei anlegen: %w", err)
+	}
+	defer func() { _ = f.Close() }()
+
+	written, err := io.Copy(f, r)
+	if err != nil {
+		return 0, fmt.Errorf("storage: schreiben: %w", err)
+	}
+	return written, nil
+}
+
+func (d *LocalDriver) Get(ctx context.Context, key string) (io.ReadCloser, error) {
+	f, err := os.Open(d.path(key))
+	if err != nil {
+		if os.IsNotExist(err) {
+			return nil, ErrNotFound
+		}
+		return nil, fmt.Errorf("storage: lesen: %w", err)
+	}
+	return f, nil
+}
+
+func (d *LocalDriver) Delete(ctx context.Context, key string) error {
+	if err := os.Remove(d.path(key)); err != nil {
+		if os.IsNotExist(err) {
+			return ErrNotFound
+		}
+		return fmt.Errorf("storage: loeschen: %w", err)
+	}
+	return nil
+}
+
+func (d *LocalDriver) SignedURL(ctx context.Context, key string, ttl time.Duration) (string, error) {
+	expiry := time.Now().Add(ttl).Unix()
+	sig := d.sign(key, expiry)
+	return fmt.Sprintf("%s/%s?exp=%d&sig=%s", strings.TrimRight(d.publicBaseURL, "/"), key, expiry, sig), nil
+}
+
+func (d *LocalDriver) sign(key string, expiry int64) string {
+	mac := hmac.New(sha256.New, d.signingSecret)
+	mac.Write([]byte(key))
+	mac.Write([]byte(strconv.FormatInt(expiry, 10)))
+	return base64.RawURLEncoding.EncodeToString(mac.Sum(nil))
+}
+
+// VerifySignedURL prueft key/expiry/sig, wie sie z.B. aus den Query-
+// Parametern einer von SignedURL ausgestellten URL stammen (Pruefung 2:
+// abgelaufene URL wird abgewiesen). Die eigentliche HTTP-Auslieferung ist
+// nicht Bestandteil dieser Kachel (siehe DOC-01) — hier wird nur die
+// Signatur-/Ablauflogik bereitgestellt und getestet.
+func (d *LocalDriver) VerifySignedURL(key string, expiry int64, sig string) error {
+	expected := d.sign(key, expiry)
+	if subtle.ConstantTimeCompare([]byte(expected), []byte(sig)) != 1 {
+		return ErrInvalidSignature
+	}
+	if time.Now().Unix() > expiry {
+		return ErrURLExpired
+	}
+	return nil
+}

dms/internal/storage/localdriver_test.go

@@ -0,0 +1,108 @@
+package storage
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"io"
+	"net/url"
+	"strconv"
+	"testing"
+	"time"
+)
+
+func newTestLocalDriver(t *testing.T) *LocalDriver {
+	t.Helper()
+	return NewLocalDriver(t.TempDir(), []byte("test-signing-secret"), "https://files.example.test")
+}
+
+// TestLocalDriver_RoundTrip ist Pruefung 1 fuer den lokalen Treiber:
+// Upload/Download-Roundtrip.
+func TestLocalDriver_RoundTrip(t *testing.T) {
+	d := newTestLocalDriver(t)
+	ctx := context.Background()
+	key := "documents/doc-1/revisions/rev-1"
+	content := []byte("hallo welt")
+
+	written, err := d.Put(ctx, key, bytes.NewReader(content), int64(len(content)), "text/plain")
+	if err != nil {
+		t.Fatalf("put: %v", err)
+	}
+	if written != int64(len(content)) {
+		t.Fatalf("geschriebene groesse = %d, want %d", written, len(content))
+	}
+
+	rc, err := d.Get(ctx, key)
+	if err != nil {
+		t.Fatalf("get: %v", err)
+	}
+	defer func() { _ = rc.Close() }()
+	got, err := io.ReadAll(rc)
+	if err != nil {
+		t.Fatalf("lesen: %v", err)
+	}
+	if !bytes.Equal(got, content) {
+		t.Fatalf("gelesener inhalt = %q, want %q", got, content)
+	}
+}
+
+// TestLocalDriver_MissingObject ist Pruefung 3: klarer Fehler bei
+// fehlendem Objekt, sowohl fuer Get als auch Delete.
+func TestLocalDriver_MissingObject(t *testing.T) {
+	d := newTestLocalDriver(t)
+	ctx := context.Background()
+
+	if _, err := d.Get(ctx, "nie-angelegt"); !errors.Is(err, ErrNotFound) {
+		t.Fatalf("get eines fehlenden objekts: erwartet ErrNotFound, habe %v", err)
+	}
+	if err := d.Delete(ctx, "nie-angelegt"); !errors.Is(err, ErrNotFound) {
+		t.Fatalf("delete eines fehlenden objekts: erwartet ErrNotFound, habe %v", err)
+	}
+}
+
+// TestLocalDriver_SignedURL_ExpiredIsRejected ist Pruefung 2: eine
+// abgelaufene signierte URL wird abgewiesen.
+func TestLocalDriver_SignedURL_ExpiredIsRejected(t *testing.T) {
+	d := newTestLocalDriver(t)
+	ctx := context.Background()
+	key := "documents/doc-2/revisions/rev-1"
+
+	// Gueltige, noch nicht abgelaufene URL wird akzeptiert.
+	urlValid, err := d.SignedURL(ctx, key, time.Hour)
+	if err != nil {
+		t.Fatalf("signedurl (gueltig): %v", err)
+	}
+	expiry, sig := parseSignedURLQuery(t, urlValid)
+	if err := d.VerifySignedURL(key, expiry, sig); err != nil {
+		t.Fatalf("gueltige url wurde abgewiesen: %v", err)
+	}
+
+	// Bereits abgelaufene URL (negative TTL) wird abgewiesen.
+	urlExpired, err := d.SignedURL(ctx, key, -time.Hour)
+	if err != nil {
+		t.Fatalf("signedurl (abgelaufen): %v", err)
+	}
+	expiredExpiry, expiredSig := parseSignedURLQuery(t, urlExpired)
+	if err := d.VerifySignedURL(key, expiredExpiry, expiredSig); !errors.Is(err, ErrURLExpired) {
+		t.Fatalf("abgelaufene url: erwartet ErrURLExpired, habe %v", err)
+	}
+
+	// Manipulierte Signatur wird abgewiesen.
+	if err := d.VerifySignedURL(key, expiry, "manipuliert"); !errors.Is(err, ErrInvalidSignature) {
+		t.Fatalf("manipulierte signatur: erwartet ErrInvalidSignature, habe %v", err)
+	}
+}
+
+func parseSignedURLQuery(t *testing.T, rawURL string) (expiry int64, sig string) {
+	t.Helper()
+	parsed, err := url.Parse(rawURL)
+	if err != nil {
+		t.Fatalf("signierte url parsen: %v (%s)", err, rawURL)
+	}
+	q := parsed.Query()
+	expInt, err := strconv.ParseInt(q.Get("exp"), 10, 64)
+	if err != nil {
+		t.Fatalf("exp parsen: %v", err)
+	}
+	return expInt, q.Get("sig")
+}

dms/internal/storage/s3driver.go

@@ -0,0 +1,135 @@
+package storage
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"fmt"
+	"io"
+	"time"
+
+	"github.com/aws/aws-sdk-go-v2/aws"
+	"github.com/aws/aws-sdk-go-v2/config"
+	"github.com/aws/aws-sdk-go-v2/credentials"
+	"github.com/aws/aws-sdk-go-v2/service/s3"
+	"github.com/aws/aws-sdk-go-v2/service/s3/types"
+	"github.com/aws/smithy-go"
+)
+
+// S3Driver legt Objekte in einem S3-kompatiblen Objektspeicher ab — der
+// Produktions-Treiber (Akzeptanzkriterium 1). Funktioniert gegen echtes
+// AWS S3 UND gegen jeden S3-kompatiblen Anbieter (MinIO etc.) ueber
+// endpointURL — bewusst offenes Objektformat statt Herstellerbindung
+// (Produkt-DNA: "jederzeit ohne Herstellerwerkzeug lesbar").
+type S3Driver struct {
+	client *s3.Client
+	bucket string
+}
+
+// NewS3Driver verbindet zu einem S3-kompatiblen Endpunkt. endpointURL leer
+// laesst den AWS-SDK-Standardendpunkt (echtes AWS S3) gelten,
+// usePathStyle=true ist fuer die meisten Nicht-AWS-S3-kompatiblen Anbieter
+// (MinIO, etc.) noetig.
+func NewS3Driver(ctx context.Context, bucket, region, endpointURL, accessKeyID, secretAccessKey string, usePathStyle bool) (*S3Driver, error) {
+	cfg, err := config.LoadDefaultConfig(ctx,
+		config.WithRegion(region),
+		config.WithCredentialsProvider(credentials.NewStaticCredentialsProvider(accessKeyID, secretAccessKey, "")),
+	)
+	if err != nil {
+		return nil, fmt.Errorf("storage: s3-konfiguration laden: %w", err)
+	}
+
+	client := s3.NewFromConfig(cfg, func(o *s3.Options) {
+		if endpointURL != "" {
+			o.BaseEndpoint = aws.String(endpointURL)
+		}
+		o.UsePathStyle = usePathStyle
+	})
+	return &S3Driver{client: client, bucket: bucket}, nil
+}
+
+func (d *S3Driver) Put(ctx context.Context, key string, r io.Reader, size int64, contentType string) (int64, error) {
+	buf, err := io.ReadAll(r)
+	if err != nil {
+		return 0, fmt.Errorf("storage: objekt vor upload lesen: %w", err)
+	}
+	_, err = d.client.PutObject(ctx, &s3.PutObjectInput{
+		Bucket:        aws.String(d.bucket),
+		Key:           aws.String(key),
+		Body:          bytesReader(buf),
+		ContentLength: aws.Int64(int64(len(buf))),
+		ContentType:   aws.String(contentType),
+	})
+	if err != nil {
+		return 0, fmt.Errorf("storage: s3-upload: %w", err)
+	}
+	return int64(len(buf)), nil
+}
+
+func (d *S3Driver) Get(ctx context.Context, key string) (io.ReadCloser, error) {
+	out, err := d.client.GetObject(ctx, &s3.GetObjectInput{
+		Bucket: aws.String(d.bucket),
+		Key:    aws.String(key),
+	})
+	if err != nil {
+		if isS3NotFound(err) {
+			return nil, ErrNotFound
+		}
+		return nil, fmt.Errorf("storage: s3-download: %w", err)
+	}
+	return out.Body, nil
+}
+
+func (d *S3Driver) Delete(ctx context.Context, key string) error {
+	// S3 liefert bei DeleteObject fuer ein nicht existierendes Objekt KEINEN
+	// Fehler (idempotente Semantik der S3-API) — um denselben Vertrag wie
+	// LocalDriver (ErrNotFound bei fehlendem Objekt) zu erfuellen, wird die
+	// Existenz vorher explizit geprueft (Pruefung 3).
+	_, err := d.client.HeadObject(ctx, &s3.HeadObjectInput{Bucket: aws.String(d.bucket), Key: aws.String(key)})
+	if err != nil {
+		if isS3NotFound(err) {
+			return ErrNotFound
+		}
+		return fmt.Errorf("storage: s3-existenzpruefung vor loeschen: %w", err)
+	}
+
+	if _, err := d.client.DeleteObject(ctx, &s3.DeleteObjectInput{
+		Bucket: aws.String(d.bucket),
+		Key:    aws.String(key),
+	}); err != nil {
+		return fmt.Errorf("storage: s3-loeschen: %w", err)
+	}
+	return nil
+}
+
+func (d *S3Driver) SignedURL(ctx context.Context, key string, ttl time.Duration) (string, error) {
+	presignClient := s3.NewPresignClient(d.client)
+	req, err := presignClient.PresignGetObject(ctx, &s3.GetObjectInput{
+		Bucket: aws.String(d.bucket),
+		Key:    aws.String(key),
+	}, s3.WithPresignExpires(ttl))
+	if err != nil {
+		return "", fmt.Errorf("storage: presigned url erzeugen: %w", err)
+	}
+	return req.URL, nil
+}
+
+func bytesReader(b []byte) *bytes.Reader {
+	return bytes.NewReader(b)
+}
+
+// isS3NotFound erkennt sowohl den typisierten NoSuchKey-Fehler
+// (GetObject) als auch den generischen "NotFound"-API-Fehlercode
+// (HeadObject liefert keinen typisierten NoSuchKey, sondern einen
+// generischen smithy-API-Fehler mit Code "NotFound").
+func isS3NotFound(err error) bool {
+	var nsk *types.NoSuchKey
+	if errors.As(err, &nsk) {
+		return true
+	}
+	var apiErr smithy.APIError
+	if errors.As(err, &apiErr) && apiErr.ErrorCode() == "NotFound" {
+		return true
+	}
+	return false
+}

dms/internal/storage/s3driver_test.go

@@ -0,0 +1,98 @@
+package storage
+
+import (
+	"bytes"
+	"context"
+	"errors"
+	"io"
+	"os"
+	"testing"
+	"time"
+)
+
+// requireS3TestEnv liefert die S3-Testkonfiguration oder ueberspringt den
+// Test — dasselbe Muster wie TEST_ADMIN_DSN im Core-Modul: kein S3-
+// kompatibler Speicher in dieser Umgebung verfuegbar/geprueft (siehe
+// FDN-03-Pruefprotokoll), daher hier bewusst als optional markiert statt
+// den Treiber ungetestet zu lassen.
+func requireS3TestEnv(t *testing.T) *S3Driver {
+	t.Helper()
+	bucket := os.Getenv("TEST_S3_BUCKET")
+	if bucket == "" {
+		t.Skip("TEST_S3_BUCKET nicht gesetzt, S3-Integrationstest uebersprungen")
+	}
+	endpoint := os.Getenv("TEST_S3_ENDPOINT")
+	region := os.Getenv("TEST_S3_REGION")
+	if region == "" {
+		region = "us-east-1"
+	}
+	accessKey := os.Getenv("TEST_S3_ACCESS_KEY_ID")
+	secretKey := os.Getenv("TEST_S3_SECRET_ACCESS_KEY")
+
+	d, err := NewS3Driver(context.Background(), bucket, region, endpoint, accessKey, secretKey, true)
+	if err != nil {
+		t.Fatalf("s3-treiber aufbauen: %v", err)
+	}
+	return d
+}
+
+// TestS3Driver_RoundTrip ist Pruefung 1 fuer den S3-Treiber.
+func TestS3Driver_RoundTrip(t *testing.T) {
+	d := requireS3TestEnv(t)
+	ctx := context.Background()
+	key := "fdn03-test/roundtrip"
+	content := []byte("s3 roundtrip inhalt")
+
+	t.Cleanup(func() { _ = d.Delete(ctx, key) })
+
+	if _, err := d.Put(ctx, key, bytes.NewReader(content), int64(len(content)), "text/plain"); err != nil {
+		t.Fatalf("put: %v", err)
+	}
+	rc, err := d.Get(ctx, key)
+	if err != nil {
+		t.Fatalf("get: %v", err)
+	}
+	defer func() { _ = rc.Close() }()
+	got, err := io.ReadAll(rc)
+	if err != nil {
+		t.Fatalf("lesen: %v", err)
+	}
+	if !bytes.Equal(got, content) {
+		t.Fatalf("gelesener inhalt = %q, want %q", got, content)
+	}
+}
+
+// TestS3Driver_MissingObject ist Pruefung 3 fuer den S3-Treiber.
+func TestS3Driver_MissingObject(t *testing.T) {
+	d := requireS3TestEnv(t)
+	ctx := context.Background()
+
+	if _, err := d.Get(ctx, "fdn03-test/nie-angelegt"); !errors.Is(err, ErrNotFound) {
+		t.Fatalf("get eines fehlenden objekts: erwartet ErrNotFound, habe %v", err)
+	}
+	if err := d.Delete(ctx, "fdn03-test/nie-angelegt"); !errors.Is(err, ErrNotFound) {
+		t.Fatalf("delete eines fehlenden objekts: erwartet ErrNotFound, habe %v", err)
+	}
+}
+
+// TestS3Driver_SignedURL ist Pruefung 2 fuer den S3-Treiber: eine
+// presigned URL wird erzeugt und ist innerhalb der Gueltigkeit abrufbar.
+func TestS3Driver_SignedURL(t *testing.T) {
+	d := requireS3TestEnv(t)
+	ctx := context.Background()
+	key := "fdn03-test/signed-url"
+	content := []byte("presigned")
+	t.Cleanup(func() { _ = d.Delete(ctx, key) })
+
+	if _, err := d.Put(ctx, key, bytes.NewReader(content), int64(len(content)), "text/plain"); err != nil {
+		t.Fatalf("put: %v", err)
+	}
+
+	url, err := d.SignedURL(ctx, key, time.Minute)
+	if err != nil {
+		t.Fatalf("signedurl: %v", err)
+	}
+	if url == "" {
+		t.Fatal("erwartet nicht-leere presigned url")
+	}
+}

dms/internal/storage/service.go

@@ -0,0 +1,59 @@
+package storage
+
+import (
+	"context"
+	"fmt"
+	"io"
+	"time"
+)
+
+// Service verbindet einen Driver mit der Nutzungsmeldung an Core
+// (Akzeptanzkriterium 4) — jeder Schreib-/Loeschvorgang ueber Service loest
+// GENAU EINE Meldung mit der tatsaechlich geschriebenen/geloeschten
+// Objektgroesse aus. Repository-/Handler-Code (spaetere Kacheln, z.B.
+// DOC-01) ruft ausschliesslich Service auf, nie einen Driver direkt — das
+// verhindert einen Schreibpfad, der die Nutzungsmeldung vergisst.
+type Service struct {
+	driver     Driver
+	usage      UsageReporter
+	tenantSlug string
+}
+
+func NewService(driver Driver, usage UsageReporter, tenantSlug string) *Service {
+	return &Service{driver: driver, usage: usage, tenantSlug: tenantSlug}
+}
+
+// Put legt das Objekt ab und meldet die geschriebene Groesse als positives
+// Delta (Pruefung 4).
+func (s *Service) Put(ctx context.Context, key string, r io.Reader, size int64, contentType string) (int64, error) {
+	written, err := s.driver.Put(ctx, key, r, size, contentType)
+	if err != nil {
+		return 0, err
+	}
+	if err := s.usage.Report(ctx, s.tenantSlug, UsageMetric, written); err != nil {
+		return written, fmt.Errorf("storage: objekt gespeichert, aber nutzungsmeldung fehlgeschlagen: %w", err)
+	}
+	return written, nil
+}
+
+func (s *Service) Get(ctx context.Context, key string) (io.ReadCloser, error) {
+	return s.driver.Get(ctx, key)
+}
+
+// Delete entfernt das Objekt und meldet dessen Groesse als negatives Delta
+// (Pruefung 4) — dafuer muss der Aufrufer die Groesse kennen (z.B. aus
+// file_revisions.size_bytes, FDN-02), da Delete selbst die Groesse eines
+// bereits geloeschten Objekts nicht mehr ermitteln kann.
+func (s *Service) Delete(ctx context.Context, key string, sizeBytes int64) error {
+	if err := s.driver.Delete(ctx, key); err != nil {
+		return err
+	}
+	if err := s.usage.Report(ctx, s.tenantSlug, UsageMetric, -sizeBytes); err != nil {
+		return fmt.Errorf("storage: objekt geloescht, aber nutzungsmeldung fehlgeschlagen: %w", err)
+	}
+	return nil
+}
+
+func (s *Service) SignedURL(ctx context.Context, key string, ttl time.Duration) (string, error) {
+	return s.driver.SignedURL(ctx, key, ttl)
+}

dms/internal/storage/service_test.go

@@ -0,0 +1,89 @@
+package storage
+
+import (
+	"bytes"
+	"context"
+	"sync"
+	"testing"
+)
+
+// fakeUsageReporter zeichnet jeden Report-Aufruf auf, damit Tests
+// nachweisen koennen, dass Service tatsaechlich meldet (Akzeptanzkriterium
+// 4 / Pruefung 4) — ohne echten HTTP-Aufruf gegen Core.
+type fakeUsageReporter struct {
+	mu     sync.Mutex
+	calls  []reportCall
+	failOn int // wenn >0, schlaegt der reportCall-te Aufruf fehl
+}
+
+type reportCall struct {
+	tenantSlug string
+	metric     string
+	delta      int64
+}
+
+func (f *fakeUsageReporter) Report(ctx context.Context, tenantSlug, metric string, delta int64) error {
+	f.mu.Lock()
+	defer f.mu.Unlock()
+	f.calls = append(f.calls, reportCall{tenantSlug, metric, delta})
+	if f.failOn > 0 && len(f.calls) == f.failOn {
+		return context.DeadlineExceeded
+	}
+	return nil
+}
+
+// TestService_PutReportsPositiveDelta ist Pruefung 4 (Schreibvorgang):
+// Melde-Aufruf an Core wird bei Put ausgeloest, mit korrekter Groesse.
+func TestService_PutReportsPositiveDelta(t *testing.T) {
+	driver := NewLocalDriver(t.TempDir(), []byte("secret"), "https://files.example.test")
+	usage := &fakeUsageReporter{}
+	svc := NewService(driver, usage, "acme")
+
+	content := []byte("zwoelf bytes")
+	if _, err := svc.Put(context.Background(), "documents/d1/revisions/r1", bytes.NewReader(content), int64(len(content)), "text/plain"); err != nil {
+		t.Fatalf("put: %v", err)
+	}
+
+	if len(usage.calls) != 1 {
+		t.Fatalf("erwartet 1 nutzungsmeldung, habe %d", len(usage.calls))
+	}
+	call := usage.calls[0]
+	if call.tenantSlug != "acme" || call.metric != UsageMetric || call.delta != int64(len(content)) {
+		t.Fatalf("unerwarteter meldungsinhalt: %+v", call)
+	}
+}
+
+// TestService_DeleteReportsNegativeDelta ist Pruefung 4 (Loeschvorgang).
+func TestService_DeleteReportsNegativeDelta(t *testing.T) {
+	driver := NewLocalDriver(t.TempDir(), []byte("secret"), "https://files.example.test")
+	usage := &fakeUsageReporter{}
+	svc := NewService(driver, usage, "acme")
+	ctx := context.Background()
+	key := "documents/d2/revisions/r1"
+
+	if _, err := svc.Put(ctx, key, bytes.NewReader([]byte("abc")), 3, "text/plain"); err != nil {
+		t.Fatalf("put: %v", err)
+	}
+	if err := svc.Delete(ctx, key, 3); err != nil {
+		t.Fatalf("delete: %v", err)
+	}
+
+	if len(usage.calls) != 2 {
+		t.Fatalf("erwartet 2 nutzungsmeldungen (put+delete), habe %d", len(usage.calls))
+	}
+	del := usage.calls[1]
+	if del.delta != -3 {
+		t.Fatalf("delete-delta = %d, want -3", del.delta)
+	}
+}
+
+// TestService_GetMissingObjectReturnsClearError ist Pruefung 3 auf
+// Service-Ebene.
+func TestService_GetMissingObjectReturnsClearError(t *testing.T) {
+	driver := NewLocalDriver(t.TempDir(), []byte("secret"), "https://files.example.test")
+	svc := NewService(driver, &fakeUsageReporter{}, "acme")
+
+	if _, err := svc.Get(context.Background(), "nie-angelegt"); err == nil {
+		t.Fatal("get eines fehlenden objekts haette einen fehler liefern muessen")
+	}
+}

dms/internal/storage/usagereport.go

@@ -0,0 +1,75 @@
+package storage
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"fmt"
+	"net/http"
+)
+
+// UsageMetric ist der Metrikname, unter dem Core (internal/usage, LIC-05)
+// den Speicherverbrauch je Mandant fuehrt — muss exakt
+// internal/usage.StorageBytesMetric aus dem NEXARCH-Core-Modul entsprechen
+// (Core kann von DMS als eigenem Go-Modul nicht importiert werden, daher
+// hier als Konstante gespiegelt statt importiert).
+const UsageMetric = "storage_bytes"
+
+// UsageReporter meldet Speicherverbrauchsaenderungen an Core (Akzeptanz-
+// kriterium 4). Schmale Schnittstelle, damit Tests einen Fake statt eines
+// echten HTTP-Aufrufs einsetzen koennen.
+type UsageReporter interface {
+	Report(ctx context.Context, tenantSlug, metric string, delta int64) error
+}
+
+// usageDeltaDTO entspricht Core internal/resync.usageDeltaDTO
+// (JSON-Vertrag: tenant_slug/metric/delta) — dieselbe Struktur, hier
+// gespiegelt, da DMS Cores internal/-Pakete nicht importieren kann.
+type usageDeltaDTO struct {
+	TenantSlug string `json:"tenant_slug"`
+	Metric     string `json:"metric"`
+	Delta      int64  `json:"delta"`
+}
+
+// HTTPUsageReporter meldet ueber Cores Resync-Nutzungs-Endpunkt
+// (internal/resync.Handler.UsageHandler, API-06), authentifiziert ueber
+// dasselbe Service-Credential-Verfahren wie jeder andere Modul-Core-Aufruf
+// (API-02).
+type HTTPUsageReporter struct {
+	endpointURL  string
+	clientID     string
+	clientSecret string
+	httpClient   *http.Client
+}
+
+func NewHTTPUsageReporter(endpointURL, clientID, clientSecret string, httpClient *http.Client) *HTTPUsageReporter {
+	if httpClient == nil {
+		httpClient = http.DefaultClient
+	}
+	return &HTTPUsageReporter{endpointURL: endpointURL, clientID: clientID, clientSecret: clientSecret, httpClient: httpClient}
+}
+
+func (r *HTTPUsageReporter) Report(ctx context.Context, tenantSlug, metric string, delta int64) error {
+	body, err := json.Marshal([]usageDeltaDTO{{TenantSlug: tenantSlug, Metric: metric, Delta: delta}})
+	if err != nil {
+		return fmt.Errorf("storage: nutzungsmeldung serialisieren: %w", err)
+	}
+
+	req, err := http.NewRequestWithContext(ctx, http.MethodPost, r.endpointURL, bytes.NewReader(body))
+	if err != nil {
+		return fmt.Errorf("storage: nutzungsmeldungs-anfrage aufbauen: %w", err)
+	}
+	req.Header.Set("Content-Type", "application/json")
+	req.Header.Set("X-Nexarch-Client-Id", r.clientID)
+	req.Header.Set("X-Nexarch-Client-Secret", r.clientSecret)
+
+	resp, err := r.httpClient.Do(req)
+	if err != nil {
+		return fmt.Errorf("storage: nutzungsmeldung senden: %w", err)
+	}
+	defer func() { _ = resp.Body.Close() }()
+	if resp.StatusCode != http.StatusOK {
+		return fmt.Errorf("storage: nutzungsmeldung von core abgelehnt: status %d", resp.StatusCode)
+	}
+	return nil
+}

dms/internal/storage/usagereport_test.go

@@ -0,0 +1,62 @@
+package storage
+
+import (
+	"context"
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"testing"
+)
+
+// TestHTTPUsageReporter_SendsCorrectContractToCore ist der Nachweis, dass
+// HTTPUsageReporter exakt den Vertrag von Core internal/resync.Handler.
+// UsageHandler bedient (Service-Credential-Header, JSON-Feldnamen) — echte
+// Vernetzung gegen einen laufenden Core-Prozess ist nicht Teil dieses
+// Tests (internal/resync.Handler ist in Core aktuell in keinem cmd/*/
+// main.go verdrahtet, siehe FDN-03-Pruefprotokoll), daher hier gegen einen
+// httptest-Server geprueft, der denselben Vertrag nachbildet.
+func TestHTTPUsageReporter_SendsCorrectContractToCore(t *testing.T) {
+	var gotClientID, gotClientSecret string
+	var gotBody []usageDeltaDTO
+
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		gotClientID = r.Header.Get("X-Nexarch-Client-Id")
+		gotClientSecret = r.Header.Get("X-Nexarch-Client-Secret")
+		if err := json.NewDecoder(r.Body).Decode(&gotBody); err != nil {
+			t.Errorf("anfrage-koerper dekodieren: %v", err)
+		}
+		w.Header().Set("Content-Type", "application/json")
+		_ = json.NewEncoder(w).Encode(map[string]int{"applied": len(gotBody)})
+	}))
+	defer srv.Close()
+
+	reporter := NewHTTPUsageReporter(srv.URL, "dms-service-client", "dms-service-secret", nil)
+	if err := reporter.Report(context.Background(), "acme", UsageMetric, 4096); err != nil {
+		t.Fatalf("report: %v", err)
+	}
+
+	if gotClientID != "dms-service-client" || gotClientSecret != "dms-service-secret" {
+		t.Fatalf("service-credential-header falsch: id=%q secret=%q", gotClientID, gotClientSecret)
+	}
+	if len(gotBody) != 1 {
+		t.Fatalf("erwartet 1 delta im koerper, habe %d", len(gotBody))
+	}
+	if gotBody[0].TenantSlug != "acme" || gotBody[0].Metric != UsageMetric || gotBody[0].Delta != 4096 {
+		t.Fatalf("unerwarteter delta-inhalt: %+v", gotBody[0])
+	}
+}
+
+// TestHTTPUsageReporter_RejectsNonOKStatus prueft, dass ein von Core
+// abgelehnter Aufruf (z.B. ungueltiges Service-Credential) als Fehler
+// zurueckgegeben wird, statt stillschweigend zu verlieren.
+func TestHTTPUsageReporter_RejectsNonOKStatus(t *testing.T) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		http.Error(w, "ungueltiges service-credential", http.StatusUnauthorized)
+	}))
+	defer srv.Close()
+
+	reporter := NewHTTPUsageReporter(srv.URL, "x", "y", nil)
+	if err := reporter.Report(context.Background(), "acme", UsageMetric, 1); err == nil {
+		t.Fatal("erwartet fehler bei abgelehnter nutzungsmeldung, habe nil")
+	}
+}

dms/internal/upload/service.go

@@ -0,0 +1,157 @@
+package upload
+
+import (
+	"bytes"
+	"context"
+	"crypto/sha256"
+	"encoding/hex"
+	"fmt"
+	"io"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+
+	dmscrypto "gitea.perlbach24.de/scripte/nexarch/dms/internal/crypto"
+	"gitea.perlbach24.de/scripte/nexarch/dms/internal/storage"
+)
+
+// Service verbindet Validierung, Staging, Verschlüsselung (FDN-09) und
+// Objekt-Storage (FDN-03) zu der einen Upload-API, gegen die Handler/CLI
+// später aufrufen (Akzeptanzkriterium 3: Dokument+Revision transaktional).
+type Service struct {
+	pool       *pgxpool.Pool
+	sessions   *SessionStore
+	staging    *Staging
+	storageSvc *storage.Service
+	cryptoSvc  *dmscrypto.Service
+	validator  *Validator
+	tenantSlug string
+}
+
+func NewService(pool *pgxpool.Pool, sessions *SessionStore, staging *Staging, storageSvc *storage.Service, cryptoSvc *dmscrypto.Service, validator *Validator, tenantSlug string) *Service {
+	return &Service{
+		pool: pool, sessions: sessions, staging: staging,
+		storageSvc: storageSvc, cryptoSvc: cryptoSvc, validator: validator, tenantSlug: tenantSlug,
+	}
+}
+
+// StartUpload validiert Größe/MIME-Typ (Akzeptanzkriterium 2, VOR jedem
+// entgegengenommenen Byte) und legt eine neue Upload-Sitzung an.
+func (s *Service) StartUpload(ctx context.Context, filename, mimeType string, totalSize int64, folderID *string, createdBy string) (string, error) {
+	if err := s.validator.ValidateMimeType(mimeType); err != nil {
+		return "", err
+	}
+	if err := s.validator.ValidateSize(totalSize); err != nil {
+		return "", err
+	}
+	return s.sessions.Create(ctx, filename, mimeType, totalSize, folderID, createdBy)
+}
+
+// UploadChunk nimmt einen Chunk ab offset entgegen (Akzeptanzkriterium 1:
+// Chunks können nach einem Abbruch ab dem zuletzt bestätigten Offset erneut
+// gesendet werden) und aktualisiert den Fortschritt.
+func (s *Service) UploadChunk(ctx context.Context, sessionID string, offset int64, chunk io.Reader) (int64, error) {
+	newTotal, err := s.staging.WriteChunk(sessionID, offset, chunk)
+	if err != nil {
+		return 0, err
+	}
+	if err := s.sessions.RecordChunk(ctx, sessionID, newTotal); err != nil {
+		return 0, err
+	}
+	return newTotal, nil
+}
+
+// Status liefert den aktuellen Fortschritt — der Client fragt dies nach
+// einem Verbindungsabbruch ab, um zu wissen, ab welchem Offset er
+// fortsetzen muss (Akzeptanzkriterium 1).
+func (s *Service) Status(ctx context.Context, sessionID string) (*Session, error) {
+	return s.sessions.Get(ctx, sessionID)
+}
+
+// Complete wird aufgerufen, sobald alle Bytes empfangen wurden: berechnet
+// SHA-256 auf dem KLARTEXT (Akzeptanzkriterium 4, vor jeder
+// Verschlüsselung — siehe "Bekannte Fehler vermeiden"), verschlüsselt
+// (FDN-09), legt im Objekt-Storage ab (FDN-03) und erzeugt Dokument+
+// Revision TRANSAKTIONAL (Akzeptanzkriterium 3).
+func (s *Service) Complete(ctx context.Context, sessionID string) (documentID, revisionID string, err error) {
+	sess, err := s.sessions.Get(ctx, sessionID)
+	if err != nil {
+		return "", "", err
+	}
+	if sess.BytesReceived < sess.TotalSize {
+		return "", "", fmt.Errorf("upload: sitzung %q unvollstaendig (%d von %d bytes)", sessionID, sess.BytesReceived, sess.TotalSize)
+	}
+
+	f, err := s.staging.OpenForRead(sessionID)
+	if err != nil {
+		return "", "", err
+	}
+	defer func() { _ = f.Close() }()
+
+	// SHA-256 UND Verschluesselung lesen denselben Byte-Strom in EINEM
+	// Durchlauf (io.TeeReader) — die berechnete Pruefsumme bezieht sich
+	// garantiert exakt auf das, was tatsaechlich verschluesselt wurde.
+	hasher := sha256.New()
+	tee := io.TeeReader(f, hasher)
+
+	env, err := s.cryptoSvc.Seal(ctx, s.tenantSlug, tee)
+	if err != nil {
+		return "", "", fmt.Errorf("upload: verschluesseln: %w", err)
+	}
+	checksumHex := hex.EncodeToString(hasher.Sum(nil))
+
+	ciphertext, err := io.ReadAll(env.Ciphertext)
+	if err != nil {
+		return "", "", fmt.Errorf("upload: chiffretext lesen: %w", err)
+	}
+
+	tx, err := s.pool.Begin(ctx)
+	if err != nil {
+		return "", "", fmt.Errorf("upload: transaktion starten: %w", err)
+	}
+	defer func() { _ = tx.Rollback(ctx) }()
+
+	if err := tx.QueryRow(ctx, `
+		INSERT INTO documents (folder_id, title, created_by) VALUES ($1, $2, $3) RETURNING id
+	`, sess.FolderID, sess.Filename, sess.CreatedBy).Scan(&documentID); err != nil {
+		return "", "", fmt.Errorf("upload: dokument anlegen: %w", err)
+	}
+
+	objectKey := storage.ObjectKey(documentID, "pending")
+	if err := tx.QueryRow(ctx, `
+		INSERT INTO file_revisions (document_id, revision_number, storage_key, checksum_sha256, size_bytes, mime_type, created_by, wrapped_dek)
+		VALUES ($1, 1, $2, $3, $4, $5, $6, $7)
+		RETURNING id
+	`, documentID, objectKey, checksumHex, sess.TotalSize, sess.MimeType, sess.CreatedBy, env.WrappedDEK).Scan(&revisionID); err != nil {
+		return "", "", fmt.Errorf("upload: revision anlegen: %w", err)
+	}
+
+	// objectKey haengt vom Pfadschema ab (documents/<id>/revisions/<id>,
+	// FDN-03), die Revision-ID ist aber erst NACH dem INSERT bekannt — der
+	// vorlaeufige Key wird daher mit dem echten aktualisiert, bevor das
+	// Objekt tatsaechlich unter diesem Key im Storage abgelegt wird.
+	finalKey := storage.ObjectKey(documentID, revisionID)
+	if _, err := tx.Exec(ctx, `UPDATE file_revisions SET storage_key = $2 WHERE id = $1`, revisionID, finalKey); err != nil {
+		return "", "", fmt.Errorf("upload: storage-key aktualisieren: %w", err)
+	}
+
+	if _, err := tx.Exec(ctx, `UPDATE documents SET current_revision_id = $2 WHERE id = $1`, documentID, revisionID); err != nil {
+		return "", "", fmt.Errorf("upload: aktuelle revision setzen: %w", err)
+	}
+
+	if _, err := s.storageSvc.Put(ctx, finalKey, bytes.NewReader(ciphertext), int64(len(ciphertext)), "application/octet-stream"); err != nil {
+		return "", "", fmt.Errorf("upload: objekt ablegen: %w", err)
+	}
+
+	if err := tx.Commit(ctx); err != nil {
+		return "", "", fmt.Errorf("upload: transaktion committen: %w", err)
+	}
+
+	if err := s.sessions.MarkCompleted(ctx, sessionID, documentID); err != nil {
+		return "", "", fmt.Errorf("upload: sitzung als abgeschlossen markieren: %w", err)
+	}
+	if err := s.staging.Remove(sessionID); err != nil {
+		return "", "", fmt.Errorf("upload: staging-datei aufraeumen: %w", err)
+	}
+
+	return documentID, revisionID, nil
+}

dms/internal/upload/service_test.go

@@ -0,0 +1,299 @@
+package upload
+
+import (
+	"bytes"
+	"context"
+	"crypto/rand"
+	"crypto/sha256"
+	"encoding/hex"
+	"errors"
+	"fmt"
+	"os"
+	"sync"
+	"testing"
+	"time"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+
+	dmscrypto "gitea.perlbach24.de/scripte/nexarch/dms/internal/crypto"
+	"gitea.perlbach24.de/scripte/nexarch/dms/internal/storage"
+)
+
+// fakeKEKProvider liefert einen fest hinterlegten Tenant-KEK — dieselbe
+// Fixture wie in internal/crypto, hier lokal dupliziert, da Testhilfen
+// nicht paketuebergreifend exportiert sind.
+type fakeKEKProvider struct{ kek []byte }
+
+func (f *fakeKEKProvider) TenantKEK(ctx context.Context, tenantSlug string) ([]byte, error) {
+	return f.kek, nil
+}
+
+func setupServiceTest(t *testing.T) (*Service, *pgxpool.Pool, string) {
+	t.Helper()
+	dsn := os.Getenv("TEST_TENANT_DSN")
+	if dsn == "" {
+		t.Skip("TEST_TENANT_DSN nicht gesetzt, Integrationstest uebersprungen")
+	}
+	ctx := context.Background()
+
+	pool, err := pgxpool.New(ctx, dsn)
+	if err != nil {
+		t.Fatalf("pool: %v", err)
+	}
+	t.Cleanup(func() { pool.Close() })
+
+	if _, err := pool.Exec(ctx, `
+		CREATE EXTENSION IF NOT EXISTS pgcrypto;
+		CREATE TABLE IF NOT EXISTS users (
+			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), email TEXT NOT NULL UNIQUE, name TEXT NOT NULL,
+			status TEXT NOT NULL DEFAULT 'active', created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		);
+		CREATE TABLE IF NOT EXISTS folders (
+			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), parent_folder_id UUID REFERENCES folders(id) ON DELETE CASCADE,
+			name TEXT NOT NULL, created_by UUID NOT NULL REFERENCES users(id),
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		);
+		CREATE TABLE IF NOT EXISTS documents (
+			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), folder_id UUID REFERENCES folders(id) ON DELETE SET NULL,
+			title TEXT NOT NULL, current_revision_id UUID, created_by UUID NOT NULL REFERENCES users(id),
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now(), deleted_at TIMESTAMPTZ
+		);
+		CREATE TABLE IF NOT EXISTS file_revisions (
+			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), document_id UUID NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+			revision_number INT NOT NULL, storage_key TEXT NOT NULL, checksum_sha256 TEXT NOT NULL,
+			size_bytes BIGINT NOT NULL, mime_type TEXT NOT NULL, created_by UUID NOT NULL REFERENCES users(id),
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(), wrapped_dek BYTEA,
+			UNIQUE (document_id, revision_number)
+		);
+		CREATE TABLE IF NOT EXISTS upload_sessions (
+			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), filename TEXT NOT NULL, mime_type TEXT NOT NULL,
+			total_size BIGINT NOT NULL CHECK (total_size > 0), bytes_received BIGINT NOT NULL DEFAULT 0 CHECK (bytes_received >= 0),
+			folder_id UUID REFERENCES folders(id) ON DELETE SET NULL, created_by UUID NOT NULL REFERENCES users(id),
+			status TEXT NOT NULL DEFAULT 'uploading' CHECK (status IN ('uploading','completed','aborted')),
+			document_id UUID REFERENCES documents(id),
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		);
+	`); err != nil {
+		t.Fatalf("schema: %v", err)
+	}
+	t.Cleanup(func() {
+		ctx := context.Background()
+		_, _ = pool.Exec(ctx, `TRUNCATE upload_sessions, file_revisions, documents, folders, users CASCADE`)
+	})
+
+	var userID string
+	if err := pool.QueryRow(ctx, `
+		INSERT INTO users (email, name) VALUES ($1, 'Test-Benutzer') RETURNING id
+	`, fmt.Sprintf("upload-test-%d@example.test", time.Now().UnixNano())).Scan(&userID); err != nil {
+		t.Fatalf("testbenutzer anlegen: %v", err)
+	}
+
+	sessions := NewSessionStore(pool)
+	staging := NewStaging(t.TempDir())
+	storageSvc := storage.NewService(storage.NewLocalDriver(t.TempDir(), []byte("secret"), "https://files.example.test"), noopUsageReporter{}, "acme")
+	cryptoSvc := dmscrypto.NewService(&fakeKEKProvider{kek: bytes.Repeat([]byte{0x11}, dmscrypto.KEKSize)})
+	validator := NewValidator(10*1024*1024, []string{"application/pdf", "text/plain"})
+
+	svc := NewService(pool, sessions, staging, storageSvc, cryptoSvc, validator, "acme")
+	return svc, pool, userID
+}
+
+// noopUsageReporter ersetzt den echten HTTPUsageReporter aus FDN-03 fuer
+// diese Tests — Nutzungsmeldung ist bereits in FDN-03 eigenstaendig
+// getestet, hier geht es nur um den Upload-Pfad selbst.
+type noopUsageReporter struct{}
+
+func (noopUsageReporter) Report(ctx context.Context, tenantSlug, metric string, delta int64) error {
+	return nil
+}
+
+// TestUploadChunk_DisallowedMimeTypeRejected ist Akzeptanzkriterium 2.
+func TestUploadChunk_DisallowedMimeTypeRejected(t *testing.T) {
+	svc, _, userID := setupServiceTest(t)
+	ctx := context.Background()
+
+	_, err := svc.StartUpload(ctx, "schadcode.exe", "application/x-msdownload", 100, nil, userID)
+	if !errors.Is(err, ErrDisallowedMimeType) {
+		t.Fatalf("erwartet ErrDisallowedMimeType, habe %v", err)
+	}
+}
+
+// TestUploadChunk_OversizedRejected prueft die Groessenpruefung
+// (Schutz vor Speicherbomben).
+func TestUploadChunk_OversizedRejected(t *testing.T) {
+	svc, _, userID := setupServiceTest(t)
+	ctx := context.Background()
+
+	_, err := svc.StartUpload(ctx, "riesig.pdf", "application/pdf", 100*1024*1024, nil, userID)
+	if !errors.Is(err, ErrFileTooLarge) {
+		t.Fatalf("erwartet ErrFileTooLarge, habe %v", err)
+	}
+}
+
+// TestCompleteUpload_CreatesDocumentAndRevisionTransactionally ist
+// Akzeptanzkriterium 3 UND 4 (Pruefsumme).
+func TestCompleteUpload_CreatesDocumentAndRevisionTransactionally(t *testing.T) {
+	svc, pool, userID := setupServiceTest(t)
+	ctx := context.Background()
+
+	content := []byte("Rechnung 2026-0001 — Testinhalt fuer DOC-01")
+	sum := sha256.Sum256(content)
+	wantChecksum := hex.EncodeToString(sum[:])
+
+	sessionID, err := svc.StartUpload(ctx, "rechnung.pdf", "application/pdf", int64(len(content)), nil, userID)
+	if err != nil {
+		t.Fatalf("startupload: %v", err)
+	}
+	if _, err := svc.UploadChunk(ctx, sessionID, 0, bytes.NewReader(content)); err != nil {
+		t.Fatalf("uploadchunk: %v", err)
+	}
+
+	documentID, revisionID, err := svc.Complete(ctx, sessionID)
+	if err != nil {
+		t.Fatalf("complete: %v", err)
+	}
+	if documentID == "" || revisionID == "" {
+		t.Fatal("erwartet nicht-leere document/revision-ids")
+	}
+
+	var title string
+	var currentRevisionID *string
+	if err := pool.QueryRow(ctx, `SELECT title, current_revision_id FROM documents WHERE id = $1`, documentID).Scan(&title, &currentRevisionID); err != nil {
+		t.Fatalf("dokument lesen: %v", err)
+	}
+	if title != "rechnung.pdf" {
+		t.Fatalf("titel = %q, want %q", title, "rechnung.pdf")
+	}
+	if currentRevisionID == nil || *currentRevisionID != revisionID {
+		t.Fatalf("current_revision_id = %v, want %q", currentRevisionID, revisionID)
+	}
+
+	var checksum string
+	var wrappedDEK []byte
+	if err := pool.QueryRow(ctx, `SELECT checksum_sha256, wrapped_dek FROM file_revisions WHERE id = $1`, revisionID).Scan(&checksum, &wrappedDEK); err != nil {
+		t.Fatalf("revision lesen: %v", err)
+	}
+	if checksum != wantChecksum {
+		t.Fatalf("checksum_sha256 = %q, want %q (sha256 des klartexts)", checksum, wantChecksum)
+	}
+	if len(wrappedDEK) == 0 {
+		t.Fatal("erwartet nicht-leeren wrapped_dek (objekt wurde verschluesselt)")
+	}
+}
+
+// TestUploadChunk_ResumeAfterAbortProducesIdenticalChecksum ist
+// Akzeptanzkriterium 1 / Pruefung 2: Abbruch bei 50% und Fortsetzung ergibt
+// identische Pruefsumme.
+func TestUploadChunk_ResumeAfterAbortProducesIdenticalChecksum(t *testing.T) {
+	svc, _, userID := setupServiceTest(t)
+	ctx := context.Background()
+
+	content := make([]byte, 200*1024) // 200 KiB
+	if _, err := rand.Read(content); err != nil {
+		t.Fatalf("zufallsinhalt erzeugen: %v", err)
+	}
+	sum := sha256.Sum256(content)
+	wantChecksum := hex.EncodeToString(sum[:])
+
+	sessionID, err := svc.StartUpload(ctx, "grosse-datei.pdf", "application/pdf", int64(len(content)), nil, userID)
+	if err != nil {
+		t.Fatalf("startupload: %v", err)
+	}
+
+	half := len(content) / 2
+	if _, err := svc.UploadChunk(ctx, sessionID, 0, bytes.NewReader(content[:half])); err != nil {
+		t.Fatalf("uploadchunk (erste haelfte): %v", err)
+	}
+
+	// Simulierter Verbindungsabbruch: Sitzung abfragen wie ein Client, der
+	// nach dem Abbruch neu verbindet und wissen will, wo er stand.
+	status, err := svc.Status(ctx, sessionID)
+	if err != nil {
+		t.Fatalf("status: %v", err)
+	}
+	if status.BytesReceived != int64(half) {
+		t.Fatalf("bytes_received nach abbruch = %d, want %d", status.BytesReceived, half)
+	}
+
+	// Fortsetzung GENAU ab dem zuletzt bestaetigten Offset.
+	if _, err := svc.UploadChunk(ctx, sessionID, int64(half), bytes.NewReader(content[half:])); err != nil {
+		t.Fatalf("uploadchunk (fortsetzung): %v", err)
+	}
+
+	_, revisionID, err := svc.Complete(ctx, sessionID)
+	if err != nil {
+		t.Fatalf("complete: %v", err)
+	}
+
+	got := checksumOf(t, svc, revisionID)
+	if got != wantChecksum {
+		t.Fatalf("checksum nach fortgesetztem upload = %q, want %q", got, wantChecksum)
+	}
+}
+
+func checksumOf(t *testing.T, svc *Service, revisionID string) string {
+	t.Helper()
+	var checksum string
+	if err := svc.pool.QueryRow(context.Background(), `SELECT checksum_sha256 FROM file_revisions WHERE id = $1`, revisionID).Scan(&checksum); err != nil {
+		t.Fatalf("checksum lesen: %v", err)
+	}
+	return checksum
+}
+
+// TestParallelUploads_NoDataLoss ist Pruefung 3: Parallel-Upload von 20
+// Dateien ohne Datenverlust.
+func TestParallelUploads_NoDataLoss(t *testing.T) {
+	svc, _, userID := setupServiceTest(t)
+	ctx := context.Background()
+	const n = 20
+
+	type result struct {
+		documentID string
+		checksum   string
+	}
+	results := make([]result, n)
+	var wg sync.WaitGroup
+	for i := 0; i < n; i++ {
+		wg.Add(1)
+		go func(idx int) {
+			defer wg.Done()
+			content := []byte(fmt.Sprintf("paralleler inhalt nummer %d, eindeutig genug fuer eigenen hash", idx))
+			sum := sha256.Sum256(content)
+			wantChecksum := hex.EncodeToString(sum[:])
+
+			sessionID, err := svc.StartUpload(ctx, fmt.Sprintf("datei-%d.pdf", idx), "application/pdf", int64(len(content)), nil, userID)
+			if err != nil {
+				t.Errorf("startupload %d: %v", idx, err)
+				return
+			}
+			if _, err := svc.UploadChunk(ctx, sessionID, 0, bytes.NewReader(content)); err != nil {
+				t.Errorf("uploadchunk %d: %v", idx, err)
+				return
+			}
+			docID, revID, err := svc.Complete(ctx, sessionID)
+			if err != nil {
+				t.Errorf("complete %d: %v", idx, err)
+				return
+			}
+			results[idx] = result{documentID: docID, checksum: checksumOf(t, svc, revID)}
+			if results[idx].checksum != wantChecksum {
+				t.Errorf("upload %d: checksum = %q, want %q", idx, results[idx].checksum, wantChecksum)
+			}
+		}(i)
+	}
+	wg.Wait()
+
+	seen := map[string]bool{}
+	for i, r := range results {
+		if r.documentID == "" {
+			t.Fatalf("upload %d lieferte keine document-id (fehlgeschlagen)", i)
+		}
+		if seen[r.documentID] {
+			t.Fatalf("document-id %q doppelt vergeben - datenverlust/kollision", r.documentID)
+		}
+		seen[r.documentID] = true
+	}
+	if len(seen) != n {
+		t.Fatalf("erwartet %d eindeutige dokumente, habe %d", n, len(seen))
+	}
+}

dms/internal/upload/session.go

@@ -0,0 +1,105 @@
+package upload
+
+import (
+	"context"
+	"errors"
+	"fmt"
+
+	"github.com/jackc/pgx/v5"
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+// ErrSessionNotFound wird geliefert, wenn eine angefragte Upload-Sitzung
+// nicht existiert.
+var ErrSessionNotFound = errors.New("upload: sitzung nicht gefunden")
+
+// Session ist der Zustand eines laufenden oder abgeschlossenen Uploads
+// (Akzeptanzkriterium 1: Grundlage fuer Fortsetzung nach Abbruch).
+type Session struct {
+	ID            string
+	Filename      string
+	MimeType      string
+	TotalSize     int64
+	BytesReceived int64
+	FolderID      *string
+	CreatedBy     string
+	Status        string
+	DocumentID    *string
+}
+
+const (
+	StatusUploading = "uploading"
+	StatusCompleted = "completed"
+	StatusAborted   = "aborted"
+)
+
+// SessionStore verwaltet upload_sessions.
+type SessionStore struct {
+	pool *pgxpool.Pool
+}
+
+func NewSessionStore(pool *pgxpool.Pool) *SessionStore {
+	return &SessionStore{pool: pool}
+}
+
+func (s *SessionStore) Create(ctx context.Context, filename, mimeType string, totalSize int64, folderID *string, createdBy string) (string, error) {
+	var id string
+	err := s.pool.QueryRow(ctx, `
+		INSERT INTO upload_sessions (filename, mime_type, total_size, folder_id, created_by)
+		VALUES ($1, $2, $3, $4, $5)
+		RETURNING id
+	`, filename, mimeType, totalSize, folderID, createdBy).Scan(&id)
+	if err != nil {
+		return "", fmt.Errorf("upload: sitzung anlegen: %w", err)
+	}
+	return id, nil
+}
+
+func (s *SessionStore) Get(ctx context.Context, sessionID string) (*Session, error) {
+	var sess Session
+	err := s.pool.QueryRow(ctx, `
+		SELECT id, filename, mime_type, total_size, bytes_received, folder_id, created_by, status, document_id
+		FROM upload_sessions WHERE id = $1
+	`, sessionID).Scan(&sess.ID, &sess.Filename, &sess.MimeType, &sess.TotalSize, &sess.BytesReceived,
+		&sess.FolderID, &sess.CreatedBy, &sess.Status, &sess.DocumentID)
+	if err != nil {
+		if errors.Is(err, pgx.ErrNoRows) {
+			return nil, ErrSessionNotFound
+		}
+		return nil, fmt.Errorf("upload: sitzung lesen: %w", err)
+	}
+	return &sess, nil
+}
+
+// RecordChunk aktualisiert bytes_received auf das Maximum aus dem
+// bisherigen und dem neu gemeldeten Wert (Akzeptanzkriterium 1: ein
+// erneut zugestellter/uebersprungener Chunk darf den Fortschritt nie
+// zurueckdrehen — GREATEST statt blindem Ueberschreiben).
+func (s *SessionStore) RecordChunk(ctx context.Context, sessionID string, bytesReceivedNow int64) error {
+	tag, err := s.pool.Exec(ctx, `
+		UPDATE upload_sessions
+		SET bytes_received = GREATEST(bytes_received, $2), updated_at = now()
+		WHERE id = $1 AND status = 'uploading'
+	`, sessionID, bytesReceivedNow)
+	if err != nil {
+		return fmt.Errorf("upload: fortschritt aktualisieren: %w", err)
+	}
+	if tag.RowsAffected() == 0 {
+		return ErrSessionNotFound
+	}
+	return nil
+}
+
+func (s *SessionStore) MarkCompleted(ctx context.Context, sessionID, documentID string) error {
+	tag, err := s.pool.Exec(ctx, `
+		UPDATE upload_sessions SET status = 'completed', document_id = $2, updated_at = now()
+		WHERE id = $1
+	`, sessionID, documentID)
+	if err != nil {
+		return fmt.Errorf("upload: sitzung abschliessen: %w", err)
+	}
+	if tag.RowsAffected() == 0 {
+		return ErrSessionNotFound
+	}
+	return nil
+}

dms/internal/upload/staging.go

@@ -0,0 +1,68 @@
+package upload
+
+import (
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+)
+
+// Staging haelt Uploads waehrend der Uebertragung lokal auf der Platte —
+// getrennt von der finalen Objekt-Storage-Ablage (FDN-03), die erst nach
+// vollstaendigem, verifiziertem Empfang beschrieben wird. Chunks koennen in
+// beliebiger Reihenfolge und wiederholt an einem Offset geschrieben werden
+// (Akzeptanzkriterium 1: Fortsetzung nach Abbruch) — os.File.WriteAt ist
+// dafuer das richtige Werkzeug, kein sequenzielles Append.
+type Staging struct {
+	dir string
+}
+
+func NewStaging(dir string) *Staging {
+	return &Staging{dir: dir}
+}
+
+func (s *Staging) path(sessionID string) string {
+	return filepath.Join(s.dir, sessionID+".part")
+}
+
+// WriteChunk schreibt r ab byte-offset offset in die Staging-Datei der
+// Sitzung. Ein bereits vorher (auch teilweise) geschriebener Bereich wird
+// beim erneuten Zustellen desselben Chunks (Client-Retry) einfach identisch
+// ueberschrieben — idempotent, kein Duplikat.
+func (s *Staging) WriteChunk(sessionID string, offset int64, r io.Reader) (int64, error) {
+	if err := os.MkdirAll(s.dir, 0o755); err != nil {
+		return 0, fmt.Errorf("upload: staging-verzeichnis anlegen: %w", err)
+	}
+	f, err := os.OpenFile(s.path(sessionID), os.O_CREATE|os.O_WRONLY, 0o600)
+	if err != nil {
+		return 0, fmt.Errorf("upload: staging-datei oeffnen: %w", err)
+	}
+	defer func() { _ = f.Close() }()
+
+	if _, err := f.Seek(offset, io.SeekStart); err != nil {
+		return 0, fmt.Errorf("upload: zu offset %d springen: %w", offset, err)
+	}
+	written, err := io.Copy(f, r)
+	if err != nil {
+		return 0, fmt.Errorf("upload: chunk schreiben: %w", err)
+	}
+	return offset + written, nil
+}
+
+// OpenForRead oeffnet die vollstaendige Staging-Datei zum Lesen (nach
+// Abschluss des Uploads, fuer Hash-Berechnung + Verschluesselung).
+func (s *Staging) OpenForRead(sessionID string) (*os.File, error) {
+	f, err := os.Open(s.path(sessionID))
+	if err != nil {
+		return nil, fmt.Errorf("upload: staging-datei lesen: %w", err)
+	}
+	return f, nil
+}
+
+// Remove entfernt die Staging-Datei nach erfolgreichem Abschluss oder Abbruch.
+func (s *Staging) Remove(sessionID string) error {
+	if err := os.Remove(s.path(sessionID)); err != nil && !os.IsNotExist(err) {
+		return fmt.Errorf("upload: staging-datei entfernen: %w", err)
+	}
+	return nil
+}

dms/internal/upload/validate.go

@@ -0,0 +1,59 @@
+// Package upload implementiert DOC-01: fortsetzbare Server-seitige
+// Dateiaufnahme mit Größen-/MIME-Validierung und transaktionaler
+// Dokument+Revision-Anlage. Nutzt FDN-03 (Storage) und FDN-09
+// (Verschlüsselung) als bereits fertige Bausteine, dupliziert sie nicht.
+package upload
+
+import (
+	"errors"
+	"fmt"
+)
+
+// ErrFileTooLarge wird geliefert, wenn die angekündigte oder tatsächliche
+// Größe das konfigurierte Limit überschreitet (Schutz vor
+// Speicherbomben — siehe "Bekannte Fehler vermeiden" im Ticket).
+var ErrFileTooLarge = errors.New("upload: datei ueberschreitet das erlaubte groessenlimit")
+
+// ErrDisallowedMimeType wird geliefert, wenn der MIME-Typ nicht auf der
+// Positivliste steht (Akzeptanzkriterium 2).
+var ErrDisallowedMimeType = errors.New("upload: dateityp ist nicht erlaubt")
+
+// Validator prüft Größe und MIME-Typ VOR jedem Byte, das tatsächlich
+// entgegengenommen wird — die Prüfung selbst braucht keinen Datei-Inhalt,
+// nur die vom Client angekündigten Metadaten.
+type Validator struct {
+	maxSizeBytes     int64
+	allowedMimeTypes map[string]bool
+}
+
+// NewValidator erzeugt einen Validator. maxSizeBytes<=0 bedeutet kein
+// Limit (bewusst explizit statt eines "magischen" Default — siehe Ticket-
+// Vorgabe "kein Start ohne Konfiguration" NUR für die Voreinstellung
+// selbst, nicht für sicherheitsrelevante Limits).
+func NewValidator(maxSizeBytes int64, allowedMimeTypes []string) *Validator {
+	allowed := make(map[string]bool, len(allowedMimeTypes))
+	for _, m := range allowedMimeTypes {
+		allowed[m] = true
+	}
+	return &Validator{maxSizeBytes: maxSizeBytes, allowedMimeTypes: allowed}
+}
+
+func (v *Validator) ValidateMimeType(mimeType string) error {
+	if len(v.allowedMimeTypes) == 0 {
+		return nil
+	}
+	if !v.allowedMimeTypes[mimeType] {
+		return fmt.Errorf("%w: %q", ErrDisallowedMimeType, mimeType)
+	}
+	return nil
+}
+
+func (v *Validator) ValidateSize(sizeBytes int64) error {
+	if v.maxSizeBytes <= 0 {
+		return nil
+	}
+	if sizeBytes > v.maxSizeBytes {
+		return fmt.Errorf("%w: %d bytes > limit %d bytes", ErrFileTooLarge, sizeBytes, v.maxSizeBytes)
+	}
+	return nil
+}

dms/migrations/tenant/0001_documents.down.sql

@@ -0,0 +1,8 @@
+DROP TABLE IF EXISTS document_metadata_values;
+DROP TABLE IF EXISTS metadata_fields;
+DROP TABLE IF EXISTS document_tags;
+DROP TABLE IF EXISTS tags;
+ALTER TABLE documents DROP CONSTRAINT IF EXISTS fk_documents_current_revision;
+DROP TABLE IF EXISTS file_revisions;
+DROP TABLE IF EXISTS documents;
+DROP TABLE IF EXISTS folders;

dms/migrations/tenant/0001_documents.up.sql

@@ -0,0 +1,88 @@
+-- Kern-Entitaeten des DMS (FDN-02): Dokument, Datei-Revision, Ordner, Tag,
+-- Metadatenfeld. Laeuft in der DB EINES Mandanten (Modell C, siehe Core
+-- TEN-01) — keine tenant_id-Spalte, die Tenant-Zugehoerigkeit ist implizit
+-- durch die Datenbankverbindung gegeben. FK auf users(id) spiegelt das
+-- Benutzer-Datenmodell aus Core IAM-01 (migrations/tenant/0001_users.up.sql
+-- im NEXARCH-Core-Modul) — Auth/Benutzerverwaltung liegt vollstaendig in
+-- Core (siehe "Nicht Bestandteil" in FDN-02), diese Migration dupliziert sie
+-- NICHT, sondern setzt sie als bereits vorhanden voraus (users-Tabelle wird
+-- durch Cores eigene Migration in derselben physischen Tenant-Datenbank
+-- angelegt, bevor DMS-Migrationen laufen).
+CREATE EXTENSION IF NOT EXISTS pgcrypto;
+
+CREATE TABLE folders (
+    id               UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    parent_folder_id UUID REFERENCES folders(id) ON DELETE CASCADE,
+    name             TEXT NOT NULL,
+    created_by       UUID NOT NULL REFERENCES users(id),
+    created_at       TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at       TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+CREATE INDEX idx_folders_parent_folder_id ON folders(parent_folder_id);
+
+CREATE TABLE documents (
+    id                  UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    folder_id           UUID REFERENCES folders(id) ON DELETE SET NULL,
+    title               TEXT NOT NULL,
+    -- current_revision_id verweist erst NACH der Anlage von file_revisions
+    -- auf eine Zeile (siehe ALTER TABLE unten) — beim INSERT eines Dokuments
+    -- existiert noch keine Revision, daher NULLable und zirkulaer per
+    -- nachtraeglichem FOREIGN KEY statt Inline-Referenz geloest.
+    current_revision_id UUID,
+    created_by          UUID NOT NULL REFERENCES users(id),
+    created_at          TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at          TIMESTAMPTZ NOT NULL DEFAULT now(),
+    deleted_at          TIMESTAMPTZ
+);
+CREATE INDEX idx_documents_folder_id ON documents(folder_id);
+CREATE INDEX idx_documents_created_by ON documents(created_by);
+
+CREATE TABLE file_revisions (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    document_id     UUID NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+    revision_number INT NOT NULL,
+    -- storage_key ist ein Platzhalter fuer die Objekt-Storage-Abstraktion
+    -- (FDN-03, "Nicht Bestandteil" dieser Kachel) — hier nur die Spalte, die
+    -- spaetere Kachel legt fest, was tatsaechlich dahinter liegt.
+    storage_key     TEXT NOT NULL,
+    checksum_sha256 TEXT NOT NULL,
+    size_bytes      BIGINT NOT NULL,
+    mime_type       TEXT NOT NULL,
+    created_by      UUID NOT NULL REFERENCES users(id),
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT now(),
+    UNIQUE (document_id, revision_number)
+);
+CREATE INDEX idx_file_revisions_document_id ON file_revisions(document_id);
+
+ALTER TABLE documents
+    ADD CONSTRAINT fk_documents_current_revision
+    FOREIGN KEY (current_revision_id) REFERENCES file_revisions(id) ON DELETE SET NULL;
+
+CREATE TABLE tags (
+    id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name       TEXT NOT NULL UNIQUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE TABLE document_tags (
+    document_id UUID NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+    tag_id      UUID NOT NULL REFERENCES tags(id) ON DELETE CASCADE,
+    PRIMARY KEY (document_id, tag_id)
+);
+CREATE INDEX idx_document_tags_tag_id ON document_tags(tag_id);
+
+CREATE TABLE metadata_fields (
+    id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    field_key  TEXT NOT NULL UNIQUE,
+    label      TEXT NOT NULL,
+    field_type TEXT NOT NULL CHECK (field_type IN ('text', 'number', 'date', 'bool', 'select')),
+    created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE TABLE document_metadata_values (
+    document_id UUID NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+    field_id    UUID NOT NULL REFERENCES metadata_fields(id) ON DELETE CASCADE,
+    value       TEXT NOT NULL,
+    PRIMARY KEY (document_id, field_id)
+);
+CREATE INDEX idx_document_metadata_values_field_id ON document_metadata_values(field_id);

dms/migrations/tenant/0002_processing_jobs.down.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS processing_jobs;

dms/migrations/tenant/0002_processing_jobs.up.sql

@@ -0,0 +1,30 @@
+-- FDN-04: Postgres-Jobqueue fuer asynchrone Verarbeitung (OCR, Konvertierung,
+-- Indexierung, Exporte) — kein Redis/AMQP, dasselbe Muster wie das
+-- projektweite Postgres-Jobqueue-Konzept (siehe SKALIERUNGSKONZEPT.md).
+-- Laeuft in der DB EINES Mandanten (Modell C, siehe Core TEN-01).
+CREATE TABLE processing_jobs (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    job_type        TEXT NOT NULL,
+    payload         JSONB NOT NULL DEFAULT '{}'::jsonb,
+    -- idempotency_key verhindert doppelte Einreihung DERSELBEN logischen
+    -- Aufgabe (z.B. "ocr:<revision_id>") — NULL erlaubt mehrere Zeilen ohne
+    -- Dedup-Anspruch (Standard-Postgres-Verhalten: NULL ist nie gleich NULL
+    -- im UNIQUE-Index).
+    idempotency_key TEXT UNIQUE,
+    status          TEXT NOT NULL DEFAULT 'pending'
+                    CHECK (status IN ('pending', 'processing', 'succeeded', 'failed', 'dead_letter')),
+    attempts        INT NOT NULL DEFAULT 0,
+    max_attempts    INT NOT NULL DEFAULT 5,
+    available_at    TIMESTAMPTZ NOT NULL DEFAULT now(),
+    locked_at       TIMESTAMPTZ,
+    locked_by       TEXT,
+    last_error      TEXT,
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at      TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- Deckt genau die Zugriffsmuster von Dequeue (status+available_at) und der
+-- Stale-Lock-Wiedervorlage (status+locked_at) ab.
+CREATE INDEX idx_processing_jobs_pending ON processing_jobs (available_at) WHERE status = 'pending';
+CREATE INDEX idx_processing_jobs_processing ON processing_jobs (locked_at) WHERE status = 'processing';
+CREATE INDEX idx_processing_jobs_job_type ON processing_jobs (job_type);

dms/migrations/tenant/0003_upload_sessions.down.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS upload_sessions;

dms/migrations/tenant/0003_upload_sessions.up.sql

@@ -0,0 +1,18 @@
+-- DOC-01: Sitzungszustand fuer fortsetzbaren Upload (Akzeptanzkriterium 1).
+-- Ein Sitzungseintrag je laufendem Upload, bytes_received wird bei jedem
+-- angenommenen Chunk aktualisiert — nach einem Verbindungsabbruch kann der
+-- Client anhand von bytes_received genau dort fortsetzen, wo er stand.
+CREATE TABLE upload_sessions (
+    id             UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    filename       TEXT NOT NULL,
+    mime_type      TEXT NOT NULL,
+    total_size     BIGINT NOT NULL CHECK (total_size > 0),
+    bytes_received BIGINT NOT NULL DEFAULT 0 CHECK (bytes_received >= 0),
+    folder_id      UUID REFERENCES folders(id) ON DELETE SET NULL,
+    created_by     UUID NOT NULL REFERENCES users(id),
+    status         TEXT NOT NULL DEFAULT 'uploading'
+                   CHECK (status IN ('uploading', 'completed', 'aborted')),
+    document_id    UUID REFERENCES documents(id),
+    created_at     TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at     TIMESTAMPTZ NOT NULL DEFAULT now()
+);

dms/migrations/tenant/0004_file_revisions_wrapped_dek.down.sql

@@ -0,0 +1 @@
+ALTER TABLE file_revisions DROP COLUMN IF EXISTS wrapped_dek;

dms/migrations/tenant/0004_file_revisions_wrapped_dek.up.sql

@@ -0,0 +1,6 @@
+-- DOC-01: file_revisions bekommt den verpackten Datenverschluesselungs-
+-- schluessel (DEK) aus FDN-09s Envelope-Encryption. Nullable, weil ein
+-- Datensatz theoretisch auch unverschluesselt vorliegen kann (z.B. der
+-- FDN-02-Entwicklungs-Seed) — DOC-01s regulaerer Upload-Pfad setzt ihn
+-- jedoch immer.
+ALTER TABLE file_revisions ADD COLUMN wrapped_dek BYTEA;

dms/migrations/tenant/seed/dev_seed.sql

@@ -0,0 +1,43 @@
+-- Entwicklungs-Seed (Akzeptanzkriterium 3): legt einen Beispielordner, ein
+-- Beispieldokument mit einer Revision, ein Tag und ein Metadatenfeld an.
+-- Setzt voraus, dass mindestens ein Benutzer existiert (Core IAM-01 legt
+-- users an, DMS tut das nicht selbst - siehe "Nicht Bestandteil" in
+-- FDN-02) - schlaegt sonst absichtlich mit einer sprechenden Fehlermeldung
+-- fehl statt einen Platzhalter-Benutzer anzulegen, den DMS gar nicht
+-- verwalten darf.
+DO $$
+DECLARE
+    seed_user_id UUID;
+    seed_folder_id UUID;
+    seed_document_id UUID;
+BEGIN
+    SELECT id INTO seed_user_id FROM users ORDER BY created_at LIMIT 1;
+    IF seed_user_id IS NULL THEN
+        RAISE EXCEPTION 'dev_seed.sql: keine Zeile in users gefunden - zuerst Core-Seed (IAM-01) ausfuehren';
+    END IF;
+
+    INSERT INTO folders (name, created_by) VALUES ('Beispielordner', seed_user_id)
+        RETURNING id INTO seed_folder_id;
+
+    INSERT INTO documents (folder_id, title, created_by) VALUES (seed_folder_id, 'Beispieldokument', seed_user_id)
+        RETURNING id INTO seed_document_id;
+
+    INSERT INTO file_revisions (document_id, revision_number, storage_key, checksum_sha256, size_bytes, mime_type, created_by)
+        VALUES (seed_document_id, 1, 'dev-seed/beispiel.pdf', repeat('0', 64), 12345, 'application/pdf', seed_user_id);
+
+    UPDATE documents SET current_revision_id = (
+        SELECT id FROM file_revisions WHERE document_id = seed_document_id AND revision_number = 1
+    ) WHERE id = seed_document_id;
+
+    INSERT INTO tags (name) VALUES ('Beispiel-Tag')
+    ON CONFLICT (name) DO NOTHING;
+
+    INSERT INTO document_tags (document_id, tag_id)
+        SELECT seed_document_id, id FROM tags WHERE name = 'Beispiel-Tag';
+
+    INSERT INTO metadata_fields (field_key, label, field_type) VALUES ('rechnungsnummer', 'Rechnungsnummer', 'text')
+    ON CONFLICT (field_key) DO NOTHING;
+
+    INSERT INTO document_metadata_values (document_id, field_id, value)
+        SELECT seed_document_id, id, 'RE-2026-0001' FROM metadata_fields WHERE field_key = 'rechnungsnummer';
+END $$;

dms/scripts/reset-test-env.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Setzt die DMS-Testumgebung zurueck: droppt die Tenant-Test-Datenbank und
+# legt sie leer neu an. Noetig, weil mehrere Testpakete (internal/jobqueue,
+# internal/migrate, ...) dieselbe physische Test-Datenbank ueber
+# Sitzungsgrenzen hinweg teilen — ohne Reset sammelt sich Zustand
+# (z.B. schema_migrations-Eintraege) an, der Migrations-/Rollback-Tests
+# verfaelscht (dieselbe Fehlerklasse wie in NEXARCH Core, siehe
+# [[project-nexarch-test-infra]]).
+#
+# Aufruf: NEXARCH_DMS_TEST_DB_PASSWORD=... TEST_TENANT_DB=dms_tenant_test ./scripts/reset-test-env.sh
+set -euo pipefail
+
+PASS="${NEXARCH_DMS_TEST_DB_PASSWORD:?Setze NEXARCH_DMS_TEST_DB_PASSWORD vor dem Aufruf}"
+ROLE="${TEST_TENANT_ROLE:-nexarch_dms_test}"
+DB="${TEST_TENANT_DB:-dms_tenant_test}"
+
+export PGPASSWORD="$PASS"
+
+psql -h localhost -U "$ROLE" -d postgres -v ON_ERROR_STOP=1 -c "DROP DATABASE IF EXISTS ${DB};"
+psql -h localhost -U "$ROLE" -d postgres -v ON_ERROR_STOP=1 -c "CREATE DATABASE ${DB};"
+
+echo "Testumgebung zurueckgesetzt: ${DB} leer neu angelegt."

docs/AUD-06-PRUEFPROTOKOLL.md

@@ -1,74 +0,0 @@
-# AUD-06 – Audit-Log-Verdrahtung in sicherheitsrelevante Core-Handler
-
-Welle 8. Voraussetzung: AUD-01, AUD-02, RBAC-02, TEN-04, IAM-07, API-10 (alle
-Status "Fertig"). Branch:
-`feature/aud-06-audit-log-verdrahtung-in-sicherheitsrelevante-core-handler`,
-aufbauend auf dem gemergten Stand von QA-05.
-
-Entstanden aus einem Befund des QA-05-Abnahmegates
-(`docs/QA-05-ABNAHME-COMPLIANCE-PRUEFUNG.md` Abschnitt 2): der zentrale
-Audit-Log (AUD-01/AUD-02) existierte und war getestet, wurde aber von
-keinem Produktions-Handler tatsächlich befüllt.
-
-## Umsetzung
-
-Additive `WithAudit(...)`-Methode je betroffenem Store (Konvention aus
-`internal/lockout.Store.WithPolicy` übernommen) — bestehende Konstruktoren
-(`NewStore`/`NewRegistry`) bleiben unverändert, `audit == nil` bleibt gültig
-und verhält sich exakt wie vorher (kein Verhaltensbruch für bestehende
-Aufrufer/Tests):
-
-| Bereich | Datei | Verdrahtete Methode(n) | Audit-Action |
-|---|---|---|---|
-| Policy (RBAC-02) | `internal/policy/store.go` | `Grant`, `Revoke` | `policy.grant` / `policy.revoke` |
-| Tenant-Lifecycle (TEN-04) | `internal/tenant/registry.go`, `lifecycle.go` | `transition` (genutzt von `Suspend`/`Reactivate`/`ScheduleDeletion`/`CancelDeletion`) | `tenant.transition` |
-| Lockout (IAM-07) | `internal/lockout/lockout.go` | `RecordFailure`, `Unlock` | `auth.login_failed` / `auth.account_locked` / `auth.account_unlocked` |
-| KEK-Rotation (API-10) | `internal/kek/store.go` | `RotateTenantKEK`, `RotateMasterKey` | `kek.tenant_rotated` / `kek.master_rotated` |
-
-`login_attempts` (Lockout) liegt in der Tenant-Datenbank, `audit_events` in
-der Registry-Datenbank — `lockout.Store.WithAudit` nimmt daher zusätzlich
-zum `*audit.Log` den Tenant-Slug entgegen, damit das Event den korrekten
-Tenant-Bezug trägt (`audit.Event.TenantSlug`).
-
-## Prüfung 1: reale Aktion je Bereich, Nachweis per direkter Abfrage von `audit_events`
-
-Neues Testpaket `internal/audit/wiring_test.go`, vier Tests, jeweils: reale
-Aktion über den öffentlichen Store-API ausführen, anschließend
-`SELECT count(*) FROM audit_events WHERE action = ... AND target = ...`
-direkt abfragen — derselbe Nachweisstil wie der QA-05-Stichprobenabgleich.
-
-| Test | Ergebnis |
-|---|---|
-| `TestWiring_PolicyGrantRevokeAreAudited` | **bestanden** — je 1 Eintrag für `policy.grant`/`policy.revoke` |
-| `TestWiring_TenantLifecycleTransitionIsAudited` | **bestanden** — Eintrag für `tenant.transition` → `suspended` |
-| `TestWiring_LockoutFailuresAndUnlockAreAudited` | **bestanden** — je 1 Eintrag für `auth.login_failed`, `auth.account_locked`, `auth.account_unlocked` |
-| `TestWiring_KEKRotationIsAudited` | **bestanden** — je 1 Eintrag für `kek.tenant_rotated`, `kek.master_rotated` |
-
-## Prüfung 2: bestehende Tests aller vier Pakete bleiben grün
-
-`internal/policy`, `internal/tenant`, `internal/lockout`, `internal/kek` —
-alle bestehenden Tests unverändert grün (rein additive Verdrahtung, siehe
-Tabelle oben zu `audit == nil`).
-
-## Prüfung 3: QA-05-Stichprobenabgleich wiederholt
-
-Derselbe Stichprobenabgleich wie in QA-05 (`policy.Store.Grant`/`Revoke`
-über `internal/pentest`) erneut ausgeführt — jetzt mit Treffer statt 0
-Zeilen (siehe `TestWiring_PolicyGrantRevokeAreAudited`, welche exakt diesen
-Fall abdeckt).
-
-## Build/Test-Ergebnis
-
-```
-go build ./... / go vet ./...  -> clean
-go test ./... -p 1 -count=1     -> 51/51 Pakete ok, 0 Fehlschläge
-```
-
-## Gesamtergebnis
-
-**Bestanden.** Alle drei Akzeptanzkriterien und alle drei Pflichtprüfungen
-erfüllt. Die in QA-05 als Auflage vor QA-06 vermerkte Audit-Log-Lücke ist
-für die vier dort konkret benannten Bereiche geschlossen. Weiterhin nicht
-Bestandteil (siehe QA-05 „Nicht Bestandteil"): Vereinheitlichung der
-`*-devserver`-Binaries zu einer zentralen Server-Topologie, sowie
-Verdrahtung außerhalb Core.

docs/CODING-GUIDELINES-CORE.md

@@ -1,73 +0,0 @@
-# NEXARCH Core – Projektweite Sicherheits-Coding-Konventionen
-
-Stand: 2026-08-28. Ticket: IAM-15. Ergänzt `docs/TESTSTRATEGIE-CORE.md` (QA-01) um Coding-Regeln,
-die als Code-Review-Checkliste gelten — keine dieser Regeln ist optional oder "nur für ein Modul".
-
-## 1. Warum dieses Dokument existiert
-
-Eine sicherheitsrelevante Coding-Regel, die nur einmal an einer Stelle vorgemacht statt projektweit
-verankert wird, wird beim nächsten neuen Vergleich vergessen. Das gilt für jede Regel in diesem
-Dokument gleichermaßen — die erste Regel (SQL) ist bereits als Konvention etabliert, die zweite
-(timing-safe Vergleich, IAM-15) macht sie hier zum ersten Mal explizit schriftlich.
-
-## 2. Regel: Kein `fmt.Sprintf` für SQL-Bestandteile aus Nutzereingabe
-
-**Spalten-/Tabellennamen ausschließlich aus statischen Konstanten bzw. einem geschlossenen
-Enum/Switch-Typ, nie aus Nutzereingabe oder generischem String-Zusammenbau — auch nicht hinter
-einer Whitelist-Funktion.** Werte (nicht Bezeichner) gehören als Parameter (`$1`, `$2`, …) in die
-Query, niemals interpoliert.
-
-Lehre aus beiden Altsystemen (`known-issues-archivdms.md` Punkt 10, `known-issues-archivmail.md`
-Punkt 12): dynamische Tabellennamen via `fmt.Sprintf`, nur durch eine fragile Whitelist-Funktion
-abgesichert. Siehe DMS/Mail `SRC-11` für die board-spezifische Umsetzung dieser Regel im
-Suchindex-Kontext.
-
-**Referenzbeispiel (korrekt):** `internal/tenant/lifecycle.go`, `ProcessDueDeletions` — Statuswerte
-und IDs ausschließlich als Parameter (`$1`, `$2`, …), niemals interpoliert; der einzige Einsatz von
-`fmt.Sprintf` im Package baut einen **Datenbanknamen aus einem bereits validierten Slug**
-(`dbNameForSlug`, `slugPattern` in `tenant.go` erzwingt `^[a-z][a-z0-9_]{1,48}$` vor jeder
-Verwendung) — keine ungeprüfte Nutzereingabe erreicht die Query.
-
-## 3. Regel: Timing-safe Vergleich für jede sicherheitsrelevante Zugriffsentscheidung (IAM-15)
-
-**Jeder Vergleich, der eine sicherheitsrelevante Zugriffsentscheidung trifft — Passwort-Hash, Token,
-Signatur, 2FA-Code/-Wiederherstellungscode — nutzt einen timing-safe/constant-time Vergleich, nie
-den regulären `==`-Operator.** Ein naiver `==`-Vergleich zweier Byte-Folgen bricht bei der ersten
-abweichenden Stelle ab; die dadurch messbare Laufzeitdifferenz lässt sich aus der Ferne ausmessen und
-erlaubt ein Byte-für-Byte-Erraten des korrekten Werts (Timing-Angriff).
-
-**So wird es gemacht:** `internal/timingsafe` (dieses Ticket) bündelt die kanonische Implementierung
-(`crypto/subtle.ConstantTimeCompare`) für neue Vergleichsstellen:
-
-```go
-import "gitea.perlbach24.de/scripte/nexarch/internal/timingsafe"
-
-if !timingsafe.EqualString(providedCode, expectedCode) {
-    return ErrInvalid
-}
-```
-
-Ausnahme: `bcrypt.CompareHashAndPassword` (Passwort-Hashes) ist bereits von Haus aus timing-safe —
-hier ist kein zusätzlicher Wrapper nötig.
-
-### 3.1 Audit bestehender Vergleichsstellen (Prüfung 2)
-
-Durchgeführt 2026-08-28, Ergebnis: **alle bestehenden sicherheitsrelevanten Vergleichsstellen
-implementierten die Regel bereits korrekt**, unabhängig voneinander mit `crypto/subtle` — nichts
-musste korrigiert werden (Akzeptanzkriterium 3, „ggf.").
-
-| Ort | Was wird verglichen | Fundstelle |
-|---|---|---|
-| `internal/totp/totp.go`, `Validate` | TOTP-Code (2FA) | nutzte bereits `subtle.ConstantTimeCompare` direkt, in diesem Ticket auf `timingsafe.EqualString` umgestellt (erster Verwender des neuen Packages) |
-| `internal/webhook/dispatcher.go`, `VerifySignature` | HMAC-Webhook-Signatur | `subtle.ConstantTimeCompare(expectedBytes, gotBytes)` |
-| `internal/moduleregistry/credentials.go`, `Authenticate` | Service-Credential-Secret-Hash | eigene `timingSafeEqual`-Hilfsfunktion, gleiches Muster |
-| `internal/authtoken/token.go`, `Consume` (Passwort-Reset/Einladung) | Einmal-Token | Hash-Lookup über DB-Index (`WHERE token_hash = $1`), kein manueller Byte-Vergleich nötig — bei zufälligen, hochentropischen Token ist der indexierte Hash-Abgleich gleichwertig sicher |
-
-Neue Vergleichsstellen sollen `internal/timingsafe` verwenden, statt das Muster erneut inline zu
-duplizieren — bestehende Stellen müssen dafür nicht umgebaut werden (kein Umbau angrenzender
-Bereiche über Board-Branch-Grenzen hinweg).
-
-## 4. Wie diese Liste wächst
-
-Neue projektweite Sicherheits-Coding-Regeln werden hier ergänzt, sobald sie (wie SQL-Sprintf und
-timing-safe Vergleich) mehr als einmal unabhängig als Lehre auftauchen — nicht vorab spekulativ.

docs/INCIDENT-RESPONSE-PLAN.md

@@ -1,205 +0,0 @@
-# NEXARCH Incident-Response-Plan (inkl. DSGVO-Meldefristen)
-
-**Kachel:** Core OPS-04 | **Stand:** 2026-08-28 | **Geltungsbereich:** NEXARCH Core und alle Fachmodule (DMS, Mail, Archive, Workflow, AI, Connect)
-
-> Dieses Dokument ist eine **auszufüllende Vorlage**. Felder in eckigen Klammern
-> (`[AUSZUFÜLLEN: ...]`) müssen vom jeweiligen Betreiber (SaaS-Anbieter oder
-> On-Premise-Kunde, siehe `SAAS-BETRIEBSMODELL.md`) mit echten Namen,
-> Telefonnummern und E-Mail-Adressen befüllt werden, bevor der Plan
-> betrieblich wirksam ist. Ohne befüllte Kontaktliste (Abschnitt 7) ist
-> dieser Plan nicht einsatzbereit — siehe Prüfung 3.
-
-## 1. Zweck
-
-Ablaufplan für Sicherheitsvorfälle (Datenleck, kompromittiertes
-Service-Credential, kompromittierter Core-Signaturschlüssel, unbefugter
-Zugriff, Ransomware, Ausfall mit Datenverlust): Erkennung, Klassifizierung,
-Eskalation, Sofortmaßnahmen, DSGVO-Meldefristen, Kommunikation,
-Nachbereitung. Ergänzt `SICHERHEITSKONZEPT.md` (dort: präventive
-Architekturentscheidungen) um den reaktiven Ablauf im Ernstfall.
-
-## 2. Erkennung — technische Quellen
-
-Ein Vorfall wird über eine oder mehrere dieser Quellen bemerkt:
-
-| Quelle | Was sie zeigt | Code-Anknüpfung |
-|---|---|---|
-| Zentrale Statusseite | Ausfall/Fehlverhalten eines Moduls | Core `OPS-02` |
-| Metrics-Aggregation | Anomale Kennzahlen (z.B. Anstieg von 401/403, ungewöhnliche Zugriffszahlen) | Core `OPS-03` |
-| Health-/Readiness-Endpunkte | Abhängigkeitsausfall (DB, Queue) | Core `OPS-01` (`internal/health`) |
-| **Audit-Log** | Wer hat wann was getan — die primäre forensische Quelle für JEDEN Vorfall mit Personenbezug oder Rechteänderung | Core `AUD-01` (`internal/audit/audit.go`, `Log.Record`), Export/Filter über `AUD-03` (`internal/audit/export.go`, `StreamCSV`/`StreamJSON` nach Zeitraum/Akteur/Aktion/Tenant) |
-| Aufbewahrungs-/Löschprotokoll | Ungewöhnliche oder unautorisierte Löschvorgänge | Archive `RET-03`/`CMP-06` (geplant, noch nicht gebaut) |
-| Meldung durch Dritte | Kunde, Mitarbeiter, externer Sicherheitsforscher meldet einen Verdacht | — |
-
-Das Audit-Log (`AUD-01`) ist laut `SICHERHEITSKONZEPT.md` **append-only**
-(`AUD-02`, DB-Trigger-Schutz gegen UPDATE/DELETE) — es ist damit die
-vertrauenswürdigste Quelle für die Rekonstruktion eines Vorfalls, weil ein
-Angreifer es nicht nachträglich manipulieren kann.
-
-## 3. Klassifizierung
-
-| Schweregrad | Beispiel | Meldepflichtig nach Art. 33 DSGVO? |
-|---|---|---|
-| **Kritisch** | Personenbezogene Daten mehrerer Mandanten abgeflossen; Master-Key (`API-10`) kompromittiert | Ja, mit hoher Wahrscheinlichkeit |
-| **Hoch** | Ein Mandant betroffen, personenbezogene Daten eingesehen/exfiltriert | Ja, sofern Risiko für Betroffene nicht auszuschließen ist |
-| **Mittel** | Kompromittiertes Service-Credential (`API-02`) ohne nachweisbaren Datenzugriff | Einzelfallprüfung durch Datenschutzbeauftragten |
-| **Niedrig** | Fehlkonfiguration ohne Datenzugriff, rechtzeitig erkannt | Nein, aber intern dokumentieren |
-
-Die Einstufung "meldepflichtig" ist IMMER eine rechtliche Bewertung durch
-den Datenschutzbeauftragten (Rolle, siehe Abschnitt 7) — diese Tabelle ist
-eine Ersteinschätzungshilfe für die technische Eskalation, kein Ersatz für
-die rechtliche Prüfung.
-
-## 4. Eskalationskette (Rollen)
-
-| Rolle | Verantwortlich für | Wird informiert |
-|---|---|---|
-| **Incident Commander** | Koordiniert die gesamte Reaktion, trifft operative Entscheidungen | Sofort bei Erkennung (Schweregrad Mittel/Hoch/Kritisch) |
-| **Technischer Verantwortlicher** | Eindämmung, Beweissicherung (Audit-Log-Export), technische Ursachenanalyse | Sofort bei Erkennung |
-| **Datenschutzbeauftragter (DSB)** | Rechtliche Einstufung, DSGVO-Meldung an Aufsichtsbehörde, Betroffenen-Benachrichtigung (Art. 34) | Innerhalb 1 Stunde ab Schweregrad Mittel |
-| **Geschäftsführung/Betreiber** | Externe Kommunikation, Kundenbenachrichtigung, AVV-Pflichten (siehe `SAAS-BETRIEBSMODELL.md`) | Innerhalb 4 Stunden ab Schweregrad Hoch/Kritisch |
-
-Jede dieser Rollen benötigt Stellvertretung (Urlaub/Krankheit) — siehe
-Kontaktliste Abschnitt 7.
-
-## 5. Sofortmaßnahmen (Eindämmung)
-
-1. Betroffene Zugänge/Credentials sperren (Service-Credential-Widerruf,
-   `API-02`; Session-Widerruf, `IAM-12`; bei kompromittiertem
-   Core-Signaturschlüssel: sofortige Schlüsselrotation ohne Ausfallzeit,
-   `API-05`/`API-09`/`API-10` — alle drei unterstützen rotationsfähige
-   Schlüssel/Zertifikate ohne Downtime).
-2. Beweissicherung: Audit-Log-Export für den betroffenen Zeitraum/Tenant/
-   Akteur **vor** jeder Aufräumaktion (`internal/audit.Log.StreamCSV`/
-   `StreamJSON`, `AUD-03`) — unveränderlich, daher jederzeit nachträglich
-   exportierbar.
-3. Betroffenen Mandanten identifizieren (Tenant-Registry, `TEN-01`) — dank
-   physischer Modell-C-Trennung ist ein Vorfall bei einem Mandanten
-   technisch strukturell auf diesen einen begrenzt (siehe
-   `SICHERHEITSKONZEPT.md` Abschnitt zu TEN-01).
-4. Zeitpunkt der Kenntniserlangung dokumentieren (Startpunkt der
-   72-Stunden-Frist, siehe Abschnitt 6).
-
-## 6. DSGVO-Meldefrist-Prozess (Art. 33/34 DSGVO)
-
-1. **Start der Frist**: Zeitpunkt, an dem der Betreiber (nicht der
-   Entdecker im technischen Team) hinreichend sichere Kenntnis vom Vorfall
-   hat — dokumentiert vom Incident Commander.
-2. **Verantwortlich für die Meldung**: Datenschutzbeauftragter.
-3. **Frist**: 72 Stunden ab Kenntniserlangung, an die zuständige
-   Aufsichtsbehörde — auch wenn die Untersuchung noch nicht abgeschlossen
-   ist (Art. 33 Abs. 4 erlaubt eine gestaffelte Meldung).
-4. **Inhalt der Meldung** (Art. 33 Abs. 3): Art der Verletzung, betroffene
-   Kategorien/ungefähre Anzahl Betroffener und Datensätze, Kontakt des DSB,
-   wahrscheinliche Folgen, ergriffene/vorgeschlagene Maßnahmen.
-5. **Betroffenen-Benachrichtigung** (Art. 34): zusätzlich erforderlich, wenn
-   ein VORAUSSICHTLICH HOHES Risiko für die Rechte der betroffenen Personen
-   besteht — Entscheidung durch DSB, unverzüglich.
-6. **Keine Meldung nötig**: nur wenn nachweislich kein Risiko für
-   Betroffene besteht (z.B. Daten waren durch API-10-Envelope-Encryption
-   wirksam verschlüsselt und der Schlüssel selbst nicht kompromittiert) —
-   diese Einschätzung UND ihre Begründung wird dennoch dokumentiert
-   (Art. 33 Abs. 5: Dokumentationspflicht besteht unabhängig von der
-   Meldepflicht).
-7. **Vertragliche Ebene**: bei SaaS-/Private-Cloud-Betrieb regelt der AVV
-   (Art. 28 DSGVO) zusätzlich, in welcher (kürzeren) Frist der
-   Auftragsverarbeiter den Verantwortlichen (Kunde) informieren muss, BEVOR
-   die 72-Stunden-Frist gegenüber der Behörde zu laufen beginnt — siehe
-   `SAAS-BETRIEBSMODELL.md`.
-
-## 7. Kontaktliste (auszufüllen vom Betreiber)
-
-| Rolle | Name | Telefon | E-Mail | Stellvertretung |
-|---|---|---|---|---|
-| Incident Commander | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] |
-| Technischer Verantwortlicher | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] |
-| Datenschutzbeauftragter | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] |
-| Geschäftsführung/Betreiber | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] | [AUSZUFÜLLEN] |
-| Zuständige Aufsichtsbehörde | [AUSZUFÜLLEN, abhängig vom Sitz des Betreibers] | — | [AUSZUFÜLLEN] | — |
-
-**Zuletzt bestätigt (Erreichbarkeitstest durchgeführt am):** [AUSZUFÜLLEN —
-noch nicht durchgeführt, siehe Prüfung 3]
-
-## 8. Kommunikation
-
-- **Intern**: Eskalationskette (Abschnitt 4) zuerst, keine Information nach
-  außen vor Freigabe durch Geschäftsführung.
-- **Extern (Kunden)**: bei SaaS-/Private-Cloud-Betrieb gemäß AVV-Frist,
-  spätestens mit/vor der Behördenmeldung.
-- **Extern (Betroffene)**: nur bei hohem Risiko, siehe Abschnitt 6.5, Text
-  in verständlicher, nicht-technischer Sprache.
-- **Presse/Öffentlichkeit**: ausschließlich durch Geschäftsführung.
-
-## 9. Nachbereitung
-
-1. Lessons-Learned-Sitzung mit allen beteiligten Rollen (spätestens 2
-   Wochen nach Abschluss).
-2. Vollständige Audit-Log-Auswertung des Vorfallszeitraums archivieren
-   (separat vom laufenden Audit-Log, als Vorfallsakte).
-3. Prüfen, ob eine Schlüssel-Notfallrotation nötig ist/war (`API-05` JWT-
-   Signaturschlüssel, `API-09` mTLS-Zertifikate, `API-10` Master-/
-   Tenant-KEK) — alle drei sind so gebaut, dass Rotation ohne Ausfallzeit
-   möglich ist.
-4. Diesen Plan aktualisieren, wenn die Übung/der echte Vorfall eine Lücke
-   aufgezeigt hat.
-
-## 10. Durchgeführte Prüfungen
-
-### Prüfung 1 — Simulierte Vorfallsübung (Tabletop), durchgeführt 2026-08-28
-
-**Szenario**: Ein kompromittiertes Service-Credential des DMS-Moduls wird
-festgestellt (ungewöhnliche Anfragemuster in der Metrics-Aggregation,
-`OPS-03`).
-
-**Durchgespielter Ablauf**:
-1. *Erkennung*: Anomalie fällt in der Metrics-Aggregation auf (Abschnitt 2)
-   → Technischer Verantwortlicher prüft das Audit-Log für den betroffenen
-   Zeitraum (`AUD-03`-Export, gefiltert nach `actor` = Service-Credential
-   des DMS-Moduls).
-2. *Klassifizierung*: Kompromittiertes Service-Credential ohne
-   nachgewiesenen Datenzugriff → Schweregrad **Mittel** (Abschnitt 3).
-3. *Eskalation*: Incident Commander + Technischer Verantwortlicher sofort,
-   DSB innerhalb 1 Stunde (Abschnitt 4).
-4. *Sofortmaßnahme*: Service-Credential des DMS-Moduls über `API-02`
-   widerrufen und neu provisioniert; betroffene Tenant-Verbindungen
-   (`TEN-01`) identifiziert.
-5. *Beweissicherung*: Vollständiger Audit-Log-Export für den Zeitraum vor
-   dem Widerruf (`AUD-03`).
-6. *DSGVO-Bewertung*: DSB prüft anhand des Audit-Log-Exports, ob
-   tatsächlich personenbezogene Daten abgerufen wurden. Ergebnis im
-   simulierten Szenario: kein nachweisbarer Datenzugriff über die normale
-   Nutzung des Moduls hinaus → keine Meldepflicht, aber Dokumentation
-   gemäß Art. 33 Abs. 5.
-7. *Nachbereitung*: Ursache (wie kam das Credential abhanden) klären,
-   Rotationsintervall für Service-Credentials als offenen Punkt vermerkt.
-
-**Ergebnis**: Der Ablauf war anhand des Dokuments ohne Lücke durchspielbar
-— jeder Schritt hatte eine konkrete technische Anknüpfung. **PASS.**
-
-### Prüfung 2 — Meldefrist-Prozess auf Vollständigkeit geprüft, 2026-08-28
-
-Abgleich von Abschnitt 6 gegen Art. 33/34 DSGVO, Punkt für Punkt:
-
-| Anforderung (Art. 33/34) | Im Plan enthalten? |
-|---|---|
-| Fristbeginn = Kenntniserlangung, nicht Entdeckung durch Einzelperson | Ja (6.1) |
-| 72-Stunden-Frist an Aufsichtsbehörde | Ja (6.3) |
-| Gestaffelte Meldung erlaubt | Ja (6.3) |
-| Pflichtinhalt der Meldung | Ja (6.4) |
-| Betroffenen-Benachrichtigung bei hohem Risiko | Ja (6.5) |
-| Dokumentationspflicht auch ohne Meldepflicht | Ja (6.6) |
-| Verantwortliche Rolle benannt | Ja (6.2, DSB) |
-| Vertragliche AVV-Frist ggü. Kunde vor Behördenfrist | Ja (6.7) |
-
-**Ergebnis: vollständig. PASS.**
-
-### Prüfung 3 — Kontaktliste aktuell und erreichbar bestätigt
-
-**Status: OFFEN.** Abschnitt 7 enthält ausschließlich Platzhalter
-(`[AUSZUFÜLLEN]`), da dieses Projekt noch keine reale Betreiber-Organisation
-mit benannten Personen/Telefonnummern hat. Diese Prüfung kann nicht durch
-Code oder Dokumentation allein bestanden werden — sie erfordert, dass der
-tatsächliche Betreiber Abschnitt 7 mit echten Kontakten befüllt UND einen
-Erreichbarkeitstest durchführt (z.B. Testanruf/Test-E-Mail an jede Rolle).
-**Bleibt nicht durchgeführt, bis diese Angaben vorliegen — wird hier
-transparent als offen dokumentiert statt fälschlich als erledigt markiert.**

docs/QA-02-PRUEFPROTOKOLL.md

@@ -1,93 +0,0 @@
-# QA-02 – Prüfprotokoll: Prüfgate Identität & Mandanten
-
-Stand: 2026-08-29. Branch `feature/qa-02-pruefgate-identitaet-mandanten` (alle 21 Vorbedingungs-Tickets TEN-01..07 und IAM-01..14 gemergt, per `git merge-base` gegen jeden Feature-Branch verifiziert).
-
-## 1. Akzeptanzkriterien TEN-01 bis TEN-07 — Testabdeckung
-
-| Ticket | Titel | Abdeckende Tests |
-|---|---|---|
-| TEN-01 | Mandantenregistrierung / Modell A/C | `internal/tenant/tenant_test.go`: `TestValidateSlug`, `TestDBNameForSlug` |
-| TEN-02 | Self-Service-Onboarding | `internal/tenant/provisioner_test.go`: `TestProvision_CreatesIsolatedDatabases`; `internal/tenant/onboarding_test.go`: `TestOnboarding_ValidationErrors`, `TestOnboarding_CreatesTenantAndAdmin`, `TestOnboarding_RejectsDuplicateSlugConcurrently` |
-| TEN-03 | Tenant-Router / Verbindungsauswahl | `internal/tenant/router_test.go`: `TestRouter_ResolvesCorrectTenantDatabase`, `TestRouter_RejectsMissingOrUnknownTenant`, `TestRouter_ReusesConnectionForSameTenant`, `TestRouter_BoundsOpenConnectionsUnderLoad` |
-| TEN-04 | Mandanten-Lebenszyklus (Suspend/Reaktivieren) | `internal/tenant/lifecycle_test.go`: `TestLifecycle_SuspendAndReactivate`, `TestLifecycle_RejectsInvalidTransitions`, `TestLifecycle_CheckActive_RejectsNonActive` |
-| TEN-05 | Mandanten-Löschung (DSGVO-Löschfrist) | `internal/tenant/lifecycle_test.go`: `TestLifecycle_ScheduleAndCancelDeletion_RestoresExactPreviousState`, `TestLifecycle_ProcessDueDeletions` |
-| TEN-06 | Tenant-Router-Integration | siehe TEN-03 (dasselbe Testpaket, Router ist die TEN-06-Lieferung) |
-| TEN-07 | Migrations-Rollout über alle Mandanten | `internal/migrate` (kein eigenes `*_test.go` im Merge-Ergebnis gefunden — siehe Abweichung 4.1); Rollout-Pfad wird indirekt durch `internal/e2e/tenant_onboarding_test.go` und `cross_tenant_isolation_test.go` genutzt (`applyTenantSchema` wendet dieselben `migrations/tenant/*.up.sql` in derselben Reihenfolge an) |
-
-## 2. Akzeptanzkriterien IAM-01 bis IAM-14 — Testabdeckung
-
-| Ticket | Titel | Abdeckende Tests |
-|---|---|---|
-| IAM-01 | Benutzerverwaltung (CRUD) | `internal/user/store_test.go`: `TestTenantUserStore_CRUD`, `TestSuperadminStore_CreateWithoutTenantContext`; `internal/user/user_test.go`: `TestValidateEmail` |
-| IAM-02 | Einladungs-Flow | `internal/authtoken/token_test.go`: `TestCompleteInvitation_SetsPasswordWithoutSession`, `TestCreateAndConsume_NeverLogTokenPlaintext`; `internal/authtoken/handler_test.go` |
-| IAM-03 | Passwort-Hashing (bcrypt) | `internal/auth/password_test.go`: `TestHashAndVerifyPassword`, `TestDummyHashIsValidBcryptHash`; `internal/auth/password_bench_test.go`: `TestBcryptCostAgainstLatencyTarget` |
-| IAM-04 | Login-Grundgerüst | `internal/auth/login_test.go`: `TestLoginService_SuccessAndWrongPassword`, `TestLoginService_NoCrossTenantLogin`, `TestRequireAuth_BlocksWithoutValidCookie` |
-| IAM-05 | Sitzungsverwaltung (JWT) | `internal/auth/token_test.go`: `TestTokenIssueAndVerify`, `TestTokenVerify_RejectsManipulatedPayload`, `TestTokenVerify_RejectsWrongSecret`, `TestTokenVerify_RejectsExpiredToken`; `internal/session/session_test.go`: `TestLoginAndCreateSession`, `TestListForUser_ShowsAllActiveSessions`, `TestRevoke_InvalidatesTokenImmediately`, `TestRevokeAllExcept_KeepsCurrentSessionActive` |
-| IAM-06 | Konto-Sperre nach Fehlversuchen | `internal/lockout/lockout_test.go`: `TestRecordFailure_LocksAfterThreshold`, `TestRecordFailure_SharedAcrossInstances`, `TestIsLocked_AutoUnlocksAfterExpiry`, `TestUnlock_ClearsLockImmediately`, `TestGuardedLogin_LocksAfterRepeatedFailures` |
-| IAM-07 | Passwort-Richtlinie | `internal/pwpolicy/policy_test.go`: `TestValidate_RejectsTooShortOrSimple`, `TestValidate_RejectsBlocklistedPassword`, `TestStore_GetReturnsDefaultWhenUnset`, `TestStore_SetAndGetRoundTrip`, `TestLoginAndCheckPolicy_FlagsNonConformantExistingPassword` |
-| IAM-08 | Passwort-Reset / Profil-Selbstverwaltung | `internal/auth/changepassword_test.go`: `TestChangePassword_RequiresCurrentPassword`, `TestChangePassword_SucceedsWithCorrectCurrentPassword`; `internal/auth/profile_test.go`: `TestProfileMe_ReturnsOwnData`, `TestProfileMe_RejectsWithoutSession`; `internal/authtoken/handler_test.go`: `TestRequestReset_SameResponseRegardlessOfExistence`, `TestCompleteReset_Works` |
-| IAM-09 | TOTP-Zweitfaktor | `internal/totp/totp_test.go`: `TestGenerateAndValidateCode_RoundTrip`, `TestValidate_ClockSkewTolerance`; `internal/totp/store_test.go`: `TestBeginAndConfirmSetup`, `TestLoginWithTOTP_RequiresSecondFactorWhenEnabled`, `TestVerifyLoginCode_RecoveryCodeIsSingleUse`; `internal/totp/handler_test.go`: `TestHandlerLogin_WithoutTOTP`, `TestHandlerLogin_WrongPassword_GivesGenericError`, `TestHandlerLogin_WithTOTP_RequiresCode`, `TestHandlerSetupConfirm_ReturnsRecoveryCodes` |
-| IAM-10 | WebAuthn / Passwortlos | `internal/webauthn/webauthn_test.go`: `TestRegisterAndLogin_WithoutPassword`, `TestFinishRegistration_RejectsWrongSignature`, `TestChallenge_CannotBeReplayed`, `TestMultipleCredentials_BothWork`, `TestPasswordLoginStillWorks_AfterWebAuthnRegistration`, `TestBeginLogin_RejectsUserWithoutCredentials` |
-| IAM-11 | LDAP-Synchronisierung | `internal/ldapsync/ldapsync_test.go`: `TestRoleMapping_PositiveAndNegativeCases`, `TestSyncer_CreatesUsers`, `TestSyncer_AbortsCleanlyOnSourceError`, `TestSyncer_AppliesDeactivationOnNextRun` |
-| IAM-12 | SAML-SSO | `internal/saml/login_test.go`: `TestCompleteSAMLLogin_EndToEnd`, `TestCompleteSAMLLogin_UnmappedRoleGrantsNothing`, `TestSAMLAndOIDC_WorkInParallelForDifferentTenants`; `internal/saml/verify_test.go`: `TestVerify_AcceptsValidSignedAssertion`, `TestVerify_RejectsTamperedAssertion`, `TestVerify_RejectsWrongIdPKey`, `TestVerify_RejectsExpiredAssertion`, `TestVerify_RejectsWrongIssuer` |
-| IAM-13 | OIDC-Provider (Core als IdP) | `internal/oidc/provider_test.go`: `TestFullAuthorizationCodeFlow`, `TestGrantedScopes_NeverExceedsAllowed`, `TestValidateRedirectURI_RejectsUnregistered`, `TestAuthCodeStore_CannotBeConsumedTwice`; `internal/oidc/login_test.go`: `TestCompleteOIDCLogin_EndToEnd`, `TestCompleteOIDCLogin_UnmappedRoleGrantsNothing`; `internal/oidc/state_test.go`, `internal/oidc/verify_test.go` |
-| IAM-14 | Service-Accounts / Modul-Vertrauen | `internal/serviceaccount/serviceaccount_test.go`: `TestIssueToken_StoresOnlyHash`, `TestVerify_RejectsInsufficientScope`, `TestVerify_RejectsExpiredToken`, `TestRevoke_TakesEffectImmediately`, `TestVerify_RejectsUnknownToken`; `internal/moduletrust/moduletrust_test.go`: `TestIssueAndVerify_RoundTrip`, `TestVerify_DoesNotFetchPerCall`, `TestVerify_FailsOpenWhenCoreUnreachableButStaleKeysExist`, `TestRequireFreshKeys_FailsClosedWhenCoreUnreachable`, `TestRotate_NoDowntimeForAlreadyIssuedTokens`, `TestVerify_RejectsUnknownKid`, `TestJWKSRoundTrip` |
-
-**Ergebnis Abschnitt 1+2:** alle 21 Tickets haben eigene, automatisierte Unit-/Integrationstests, die ihre dokumentierten Akzeptanzkriterien einzeln abdecken.
-
-## 3. Echter End-to-End-Testlauf (QA-02-Kernauftrag)
-
-Die Einzeltests aus Abschnitt 1+2 prüfen jedes Ticket isoliert — sie beweisen nicht, dass die 21 Pakete *zusammen* den vollen Weg tragen. Dafür neu geschrieben: `internal/e2e/`.
-
-### 3.1 `TestE2E_TenantOnboardingLoginFlow`
-
-Treibt den vollständigen Weg über die echten Produktionspakete, nicht über Mocks:
-
-1. `internal/tenant.Provisioner.Provision` — physisch isolierte Datenbank für einen neuen Mandanten (TEN-01/TEN-02).
-2. Schema-Rollout über **alle** `migrations/tenant/*.up.sql` in Produktionsreihenfolge (TEN-07-Migrationslogik, nicht nur die verkürzte Testkopie aus `OnboardingService`).
-3. `internal/user.TenantUserStore.Create` + `SetPasswordHash` — Benutzer anlegen, bcrypt-Hash setzen (IAM-01/IAM-03).
-4. `internal/auth.LoginService.Login` — Anmeldung (IAM-04/IAM-05).
-5. Assert: Token ist mit `TokenIssuer.Verify` gültig, `Claims.TenantSlug` und `Claims.UserID` stimmen exakt, falsches Passwort scheitert weiterhin (Gegenprobe).
-
-**Ergebnis:** bestanden (siehe Abschnitt 5, Build/Test-Ergebnis auf 131).
-
-### 3.2 `TestE2E_CrossTenantIsolation`
-
-Zwei vollständig provisionierte Mandanten (`e2e-tenant-a`, `e2e-tenant-b`), je ein Benutzer, drei unabhängige Beweise:
-
-- **Datenbankebene:** aus der Datenbank von Tenant A ist keine Zeile für den Tenant-B-Benutzer abfragbar (und umgekehrt) — kein Query-Filter, sondern physisch getrennte Datenbanken.
-- **Login-Ebene:** ein Tenant-B-Benutzer kann sich nicht über den Tenant-A-`LoginService` anmelden (und umgekehrt) — `LoginService` ist strukturell auf genau eine Tenant-DB gescopt.
-- **Token-Ebene:** ausgestellte Tokens tragen exakt den richtigen `TenantSlug` und die richtige `UserID`, keine Überschneidung mit den Tenant-B-Werten.
-
-**Ergebnis:** bestanden (siehe Abschnitt 5).
-
-## 4. Abweichungen
-
-### 4.1 `internal/migrate` (TEN-07) hat keine eigene Testdatei im gemergten Stand — Schweregrad: Niedrig
-
-Kein `*_test.go` für `internal/migrate/orchestrator.go`/`migrations.go` im Merge-Ergebnis dieses Branches gefunden. Der eigentliche Rollout-Mechanismus (`LoadMigrations` + sequentielle Anwendung) wird in `internal/e2e` indirekt über `applyTenantSchema`/`applyRegistrySchema` genutzt und dadurch faktisch mitgetestet, aber es fehlen dedizierte Unit-Tests für `Orchestrator.RolloutAll` (insbesondere Fehlerisolation: ein fehlschlagender Mandant darf andere nicht blockieren, laut Paket-Doku Akzeptanzkriterium 2). Kein blockierender Fund für QA-02, da der End-to-End-Weg nachweislich funktioniert — Empfehlung: `internal/migrate/orchestrator_test.go` bei Gelegenheit nachziehen.
-
-Keine weiteren Abweichungen festgestellt — insbesondere kein Wiederauftreten des RBAC-05/RBAC-02-Bypass-Fundes aus QA-03 im Identitäts-/Mandanten-Bereich: Login und Provisionierung laufen ausschließlich über die hier geprüften Pakete, keine parallele/umgangene Prüfschicht gefunden.
-
-### 4.2 Echter Merge-Konflikt zwischen IAM-12 (SAML/OIDC-Client) und IAM-13 (Core als OIDC-Provider) — Schweregrad: Hoch, behoben
-
-**Fund:** `internal/oidc/jwks.go` (IAM-12, JWKS-Parsing für externe Provider, RSA-Schlüssel) und `internal/oidc/provider.go` (IAM-13, Core als eigener IdP, Ed25519/OKP-Schlüssel) definierten beide einen Typ `jwk`/`jwkSet` im selben Package — kompiliert einzeln pro Branch fehlerfrei, scheitert aber beim Zusammenführen beider Branches mit `jwk redeclared in this block` und Folgefehlern (unbekannte Felder `Crv`/`X`/`Use`/`Alg`). Dieser Fund wäre bei isolierten Pro-Ticket-Tests **nie** aufgefallen — nur der echte Merge aller 21 Branches deckt ihn auf.
-
-**Behoben:** IAM-13s Typen in `internal/oidc/provider.go` umbenannt zu `idpJWK`/`idpJWKSet` (RFC-8037-Format für Core als IdP), IAM-12s `jwk`/`jwkSet` in `jwks.go` (RSA-Format für externe Provider) unverändert belassen — beide Formate bleiben fachlich getrennt, nur der Namenskonflikt ist aufgelöst. `internal/oidc/provider_test.go` entsprechend angepasst.
-
-**Konsequenz für den Prozess:** bestätigt den Sinn von QA-02 als eigenem Prüfgate — Einzel-Ticket-CI kann strukturelle Merge-Konflikte zwischen thematisch verwandten, aber unabhängig entwickelten Tickets grundsätzlich nicht erkennen.
-
-## 5. Build/Test-Ergebnis auf 131
-
-Durchgeführt 2026-08-29 auf root@192.168.1.131 (`/root/nexarch-code-qa02`, isolierter Sync, kein Konflikt mit dem parallelen QA-03-Testlauf in `/root/nexarch-code-qa03`):
-
-- `go mod tidy`, `go build ./...`, `go vet ./...` — nach Behebung des Merge-Konflikts aus 4.2 alle sauber, keine Fehler.
-- `go test ./... -v -p 1` gegen frisch zurückgesetzte Testumgebung — **alle 124 Tests grün** (0 Fehlschläge), über alle 21 betroffenen Pakete inklusive `internal/e2e` (`TestE2E_TenantOnboardingLoginFlow`, `TestE2E_CrossTenantIsolation`).
-- Auf dem Weg zum grünen Lauf zwei echte, nur durch den vollen Merge sichtbare Fehler gefunden und behoben: der Typkonflikt aus 4.2, sowie eine fehlende Idempotenz-Behandlung in den neuen E2E-Test-Hilfsfunktionen selbst (Registry-Migrationen liefen beim zweiten E2E-Test gegen dieselbe geteilte Registry-Datenbank erneut und scheiterten an `relation already exists` — behoben durch tolerantes Überspringen bereits angewendeter Migrationen in `internal/e2e/helpers_test.go`, kein Produktionscode betroffen).
-- Keine Regressionen in TEN-01..07 oder IAM-01..14 durch den 21-Branch-Merge.
-
-**QA-02 Gesamtergebnis: bestanden.** Ein behobener Hoch-Schweregrad-Merge-Konflikt (4.2, echter struktureller Fund dieses Prüfgates), keine offenen Blocker.
-
-## 6. Gesamtergebnis
-
-**Bestanden.** Der volle End-to-End-Weg über alle 21 Vorbedingungs-Tickets (TEN-01..07, IAM-01..14) ist durch echte, gegen eine laufende Postgres-Instanz laufende Tests bewiesen (Abschnitt 3), nicht nur durch isolierte Einzeltests. Ein struktureller Merge-Konflikt wurde aufgedeckt und behoben (4.2) — genau die Art Fund, für die dieses Prüfgate existiert. Ein Niedrig-Schweregrad-Hinweis zu fehlender `internal/migrate`-Testabdeckung bleibt als Empfehlung offen (4.1).

docs/QA-03-PRUEFPROTOKOLL.md

@@ -1,68 +0,0 @@
-# QA-03 – Prüfprotokoll: Prüfgate Rechte & Policy
-
-Stand: 2026-08-29. Branch `feature/qa-03-pruefgate-rechte-policy` (RBAC-05 + RBAC-04 gemergt).
-
-## 1. Akzeptanzkriterien RBAC-01 bis RBAC-05 — Testabdeckung
-
-| Ticket | Titel | Abdeckende Tests |
-|---|---|---|
-| RBAC-01 | Rollenmodell & Grundrechte | `internal/rbac/role_test.go`: `TestEffectivePermissions_Inheritance`, `TestHasPermission` |
-| RBAC-01 | Rollenzuweisung | `internal/rbac/store_test.go`: `TestStore_AssignAndGet`, `TestStore_RejectsSuperadminOutsideAllowedMatrix`, `TestStore_RejectsUnknownRole`, `TestStore_HistoryTracksWhoAndWhen` |
-| RBAC-02 | Policy-Enforcement-Schicht (zentral) | `internal/policy` — kein eigenes `*_test.go` in diesem Merge gefunden für `enforcer.go`/`store.go` direkt (siehe Abweichungen unten); Verhalten indirekt über `TestBypass_PolicyEnforcerItselfRespectsRevocation` (dieser Branch) nachgewiesen |
-| RBAC-03 | Gruppen & Abteilungen | `internal/rbac/group_test.go`: `TestGroup_CreateAndAddMember`, `TestGroup_RoleAffectsAllCurrentMembers`, `TestGroup_RemoveMemberRevokesRightsImmediately`, `TestGroup_DeleteGroupRevokesRightsWithoutDeletingUser`, `TestGroup_TenantIsolation` |
-| RBAC-04 | Modul-scoped Berechtigungen | `internal/policy/module_scope_test.go`: `TestAuthorizeForTenant_DeniesWhenModuleNotActivated`, `TestAuthorizeForTenant_BecomesActiveWithoutRestart`, `TestAuthorizeForTenant_CombinationsOfRoleAndModuleScope` |
-| RBAC-05 | Rechte-Administrationsoberfläche | `internal/rbac/handler_test.go`: `TestListRoles`, `TestAssignRole_RejectsSelfEscalation`, `TestAssignRole_AdminCanPromoteOtherUser`, `TestAssignRole_AdminCanDemoteOtherUser` (neu, dieser Branch), `TestRoleHistory_TracksAssignments`, `TestGroupWorkflow`, `TestRequireManageUsers_RejectsPlainUser` |
-
-**Ergebnis Abschnitt 1:** alle 5 Tickets haben automatisierte Tests, die ihre dokumentierten Akzeptanzkriterien abdecken. RBAC-02 selbst hat keine eigene Testdatei im gemergten Stand — abgedeckt nur indirekt über den in diesem Branch neu geschriebenen `TestBypass_PolicyEnforcerItselfRespectsRevocation`. Als Abweichung festgehalten (Abschnitt 4).
-
-## 2. Umgehungsversuch der zentralen Policy-Schicht (Akzeptanzkriterium 2 / Prüfung 1)
-
-Getestet in `internal/rbac/bypass_test.go`:
-
-- **`TestBypass_NoDirectWriteAPIOutsideStore`**: bestanden. `role_assignments` hat keine Schreib-API außerhalb von `Store.Assign` — Umgehungsversuch scheitert strukturell (Typsystem, kein exportierter DB-Pool).
-- **`TestBypass_PolicyEnforcerItselfRespectsRevocation`**: bestanden. RBAC-02s eigentliche Policy-Tabelle (`policy_rules`) reagiert sofort auf `Revoke` — kein Cache, keine verzögerte Wirkung.
-- **`TestBypass_HandlerIgnoresCentralPolicyRevocation`**: **deckt einen echten Fund auf**, siehe Abschnitt 4.
-
-## 3. Rollenwechsel-Szenario (Akzeptanzkriterium 2 / Prüfung 2)
-
-- Hochstufung (user → tenant_admin): `TestAssignRole_AdminCanPromoteOtherUser` — bestanden.
-- Rückstufung (tenant_admin → user): `TestAssignRole_AdminCanDemoteOtherUser` (neu, dieser Branch) — bestanden, inklusive Prüfung, dass `role_assignment_history` beide Richtungen (erst `tenant_admin`, dann `user`) korrekt in chronologischer Reihenfolge festhält.
-- Selbst-Eskalation bleibt weiterhin gesperrt (`TestAssignRole_RejectsSelfEscalation`, aus RBAC-05).
-
-**Ergebnis Abschnitt 3:** bestanden, beide Richtungen automatisiert nachgewiesen.
-
-## 4. Abweichungen (Akzeptanzkriterium 3: nicht stillschweigend ignoriert)
-
-### 4.1 RBAC-05-Handler prüfen nicht gegen die zentrale Policy-Schicht (RBAC-02) — Schweregrad: Mittel
-
-**Fund:** `internal/rbac/handler.go` (`requireManageUsers`) entscheidet Zugriff über `HasPermission(role, PermManageUsers)` — die **statische**, hartcodierte Rollenhierarchie aus `role.go`. Es ruft nirgends `internal/policy.Enforcer.Authorize`/`Guard` auf, die eigentliche zentrale, DB-gestützte Durchsetzungsschicht aus RBAC-02 (`policy_rules`-Tabelle, per `Store.Grant`/`Revoke` administrierbar, versioniert in `policy_rule_changes`).
-
-**Konsequenz:** ein Administrator, der über die RBAC-02-Policy-Schicht das Recht `tenant.manage_users` von `tenant_admin` entzieht (`policy.Store.Revoke`), sperrt die RBAC-05-Endpunkte **nicht** aus — sie fragen `policy_rules` nie ab. Zwei parallele Enforcement-Pfade statt einer zentralen Schicht, verletzt die Ticket-Produkt-DNA "Rechte werden zentral entschieden, nicht in jedem Handler neu erfunden" (RBAC-05-Ticket) UND RBAC-02s eigenen Anspruch ("keine Tenant- oder Rechteprüfung verstreut in einzelnen Handlern").
-
-**Nachweis:** `TestBypass_HandlerIgnoresCentralPolicyRevocation` in `internal/rbac/bypass_test.go`.
-
-**Nicht in dieser Kachel behoben** (QA-03-Arbeitsweise: kein Umbau angrenzender Bereiche, RBAC-05 ist nicht Vorbedingung von QA-03) — Empfehlung: eigenes Folgeticket, das `requireManageUsers` auf `internal/policy.Guard`/`Enforcer.Authorize` umstellt.
-
-### 4.2 RBAC-02 hat keine eigene Testdatei im gemergten Stand — Schweregrad: Niedrig
-
-`internal/policy/enforcer.go` und `store.go` (RBAC-02 selbst) haben keine `enforcer_test.go`/`store_test.go` im Merge-Ergebnis dieses Branches — nur `module_scope_test.go` (RBAC-04) prüft sie indirekt über `AuthorizeForTenant`. Die in diesem Branch neu geschriebenen Bypass-Tests schließen die Lücke teilweise, ersetzen aber keine dedizierten RBAC-02-Unit-Tests. Empfehlung: bei Gelegenheit nachziehen, kein blockierender Fund.
-
-## 5. RBAC-04-Zusammenspiel mit Lizenz-/Flag-Zustand (Akzeptanzkriterium 3)
-
-`internal/flag` (aus RBAC-04-Merge) ist vorhanden. `internal/policy.Enforcer.AuthorizeForTenant` verknüpft eine Policy-Regel optional mit einem `flag.Service`-Eintrag (`ModuleScope.FlagKey`): eine sonst erlaubte Regel greift nicht, wenn das zugehörige Modul für den Tenant nicht aktiviert ist. `TestAuthorizeForTenant_DeniesWhenModuleNotActivated` und `TestAuthorizeForTenant_BecomesActiveWithoutRestart` beweisen das bereits (aus RBAC-04, unverändert übernommen).
-
-**Ergebnis Abschnitt 5:** bestanden, Zusammenspiel vorhanden und getestet.
-
-## 6. Gesamtergebnis
-
-Bestanden mit einem dokumentierten Mittel-Schweregrad-Fund (4.1) und einem Niedrig-Schweregrad-Hinweis (4.2). Build-/Test-Ergebnis auf dem Testhost: siehe Abschnitt 7.
-
-## 7. Build/Test-Ergebnis auf 131
-
-Durchgeführt 2026-08-29 auf root@192.168.1.131 (`/root/nexarch-code-qa03`, isolierter Sync, kein Konflikt mit parallelem QA-02-Testlauf):
-
-- `go mod tidy`, `go build ./...`, `go vet ./...` — alle sauber, keine Fehler.
-- `go test ./... -v -p 1` gegen frisch zurückgesetzte Testumgebung — **alle 30 Tests grün**, über alle betroffenen Pakete (`internal/auth`, `internal/policy`, `internal/rbac`, `internal/tenant`, `internal/user`), inklusive `TestBypass_HandlerIgnoresCentralPolicyRevocation` (bestätigt den Fund aus Abschnitt 4.1 als reproduzierbar, nicht nur behauptet) und `TestAssignRole_AdminCanDemoteOtherUser` (neuer Rückstufungs-Test aus Abschnitt 3).
-- Keine Regressionen in RBAC-01/02/03/04/05 durch den Merge.
-
-**QA-03 Gesamtergebnis: bestanden**, mit einem dokumentierten Mittel-Schweregrad-Fund (4.1, Empfehlung: Folgeticket) und einem Niedrig-Schweregrad-Hinweis (4.2).

docs/QA-04-PRUEFPROTOKOLL.md

@@ -1,149 +0,0 @@
-# QA-04 – Prüfprotokoll: Sicherheits- & Penetrationsprüfung Core
-
-Welle 6. Voraussetzung: RBAC-02, IAM-06, IAM-07, API-03, API-10, API-08,
-API-09, IAM-10, IAM-11, IAM-13 (alle Status "Fertig"). Branch:
-`feature/qa-04-sicherheits-penetrationspruefung-core`, alle 10 Vorbedingungen
-real gemergt (kein isolierter Cherry-Pick).
-
-## 1. Gezielte Angriffsversuche und Ergebnis
-
-Alle Tests in `internal/pentest/qa04_pentest_test.go`, echte Angriffe gegen
-die tatsächlichen Produktionspakete, nicht gegen Mocks.
-
-### 1.1 SSO/OIDC gegen Token-Manipulation, Replay, Claims-Manipulation (Akzeptanzkriterium 1)
-
-| Angriff | Test | Zielwert | Ergebnis |
-|---|---|---|---|
-| `alg=none`-Angriff gegen externen OIDC-Verifier (IAM-06) | `TestPentest_OIDC_AlgNoneAttack` | abgewiesen | **bestanden** |
-| Signatur mit fremdem (Angreifer-)Schlüssel unter bekannter `kid` | `TestPentest_OIDC_ForeignKeySignature` | abgewiesen | **bestanden** |
-| Claims nachträglich manipuliert (Rechteausweitung `roles`), alte Signatur wiederverwendet | `TestPentest_OIDC_TamperedClaims` | abgewiesen | **bestanden** |
-| Replay eines gültigen ID-Tokens mit abweichendem Nonce | `TestPentest_OIDC_NonceReplay` | abgewiesen | **bestanden** |
-| Core als eigener IdP (IAM-13): ID-Token mit Angreiferschlüssel unter vorgetäuschter `kid` | `TestPentest_OIDC_IdPTokenManipulation` | abgewiesen | **bestanden** |
-
-Ergebnis: `internal/oidc.Verifier` erzwingt Algorithmus (`RS256` bzw.
-`EdDSA`), prüft Signatur ausschließlich gegen den unter der `kid` tatsächlich
-registrierten Schlüssel, prüft Aussteller und Nonce. Kein Umgehungsweg
-gefunden.
-
-### 1.2 Rate-Limiting/Account-Lockout im Mehrinstanz-Betrieb (Akzeptanzkriterium 2, Prüfung 1)
-
-| Angriff | Test | Zielwert | Ergebnis |
-|---|---|---|---|
-| Rate-Limit über 4 unabhängige "Instanzen" (eigene DB-Pools) parallel umgehen | `TestPentest_RateLimit_MultiInstanceBypassAttempt` | Gesamtsumme erlaubter Anfragen = konfiguriertes Limit, nicht mehr | **bestanden** – 200 Anfragen über 4 Instanzen, exakt 100 (=Limit) erlaubt |
-| Account-Lockout über 3 unabhängige Instanzen verteilte Brute-Force-Versuche umgehen | `TestPentest_Lockout_MultiInstanceBypassAttempt` | Konto wird trotz Verteilung gesperrt | **bestanden** – 12 Versuche über 3 Instanzen, Sperre nach Erreichen von `maxFailed=5` |
-
-Ergebnis: beide Mechanismen nutzen ein atomares SQL-`UPSERT` gegen
-geteilten, externen Zustand (Postgres) statt In-Process-Zähler – exakt der
-in archivdms als Fehlerklasse dokumentierte Schwachpunkt wird hier vermieden.
-
-### 1.3 Zentrale Policy-Durchsetzung, gezielter Umgehungsversuch je Modul (Akzeptanzkriterium 3, Prüfung 3)
-
-| Angriff | Test | Zielwert | Ergebnis |
-|---|---|---|---|
-| Rechteausweitung: Rolle `user`/`tenant_admin` versucht `platform.manage_tenants` (Identität/Mandanten-Modul) | `TestPentest_Policy_PrivilegeEscalationViaWrongRole` | `policy.ErrDenied` | **bestanden** |
-| Strukturelle Umgehung von `policy.Guard` (Durchsetzungsschicht selbst): Query darf bei verweigerter Autorisierung nie ausgeführt werden | `TestPentest_Policy_GuardBypassStructurallyImpossible` | Query-Zähler bleibt bei 0 trotz 10 Versuchen | **bestanden** |
-
-Ergebnis: Default-Deny greift zuverlässig (keine Regel = kein Zugriff);
-`policy.Guard`/`GuardTenantScoped` lassen strukturell keinen Weg zu, die
-Query-Funktion ohne vorherige Autorisierung aufzurufen.
-
-### 1.4 Master-Key- und Tenant-KEK-Verwaltung gegen Kompromittierung/Rotation (Akzeptanzkriterium 4)
-
-| Angriff | Test | Zielwert | Ergebnis |
-|---|---|---|---|
-| Kompromittierter ALTER Master-Key nach Rotation weiterverwenden | `TestPentest_KEK_CompromisedMasterKeyCannotDecryptAfterRotation` | alter Key entschlüsselt nicht mehr, Plaintext-KEK unverändert | **bestanden** |
-| Tenant-KEK-Rotation eines Mandanten wirkt sich auf einen anderen Mandanten aus | `TestPentest_KEK_TenantKEKRotationDoesNotAffectOtherTenants` | Mandant B unberührt | **bestanden** |
-| Manipulierter, gespeicherter `wrapped_kek` (DB-Zugriff ohne Master-Key) wird beim Entschlüsseln akzeptiert | `TestPentest_KEK_TamperedWrappedKeyRejected` | `ErrUnwrapFailed` | **bestanden** |
-
-Ergebnis: AES-256-GCM (authentifizierend) verhindert Akzeptanz manipulierter
-Chiffretexte; Master-Key-Rotation ändert ausschließlich die Verpackung, nie
-den Plaintext-Tenant-KEK; Tenant-KEK-Isolation (Modell C, Fortsetzung auf
-Schlüsselebene) hält auch unter gezielter Rotation eines einzelnen Mandanten.
-
-## 2. Beim Merge/Pentest gefundene Fehler (nicht vorab bekannt)
-
-### 2.1 `scripts/reset-test-env.sh`: fehlende Bereinigung von `tenant_keks` (Schweregrad **Hoch**, behoben)
-
-Beim ersten vollen Testlauf über alle 29 Pakete schlug
-`TestPentest_KEK_CompromisedMasterKeyCannotDecryptAfterRotation` mit 48
-unerwarteten `failedTenantIDs` in `RotateMasterKey` fehl. Ursache:
-`DROP TABLE tenants CASCADE` entfernt bei einer referenzierenden Tabelle
-(`tenant_keks.tenant_id REFERENCES tenants(id)`) nur die FK-Constraint,
-NICHT deren Zeilen. Da `reset-test-env.sh` `tenant_keks` (API-10-Migration
-`0006_tenant_keks.up.sql`) nie explizit droppte, überlebten verwaiste
-`tenant_keks`-Zeilen aus früheren `internal/kek`-Testläufen jeden Reset und
-verfälschten `RotateMasterKey`s ungefilterte `SELECT * FROM tenant_keks`.
-
-Behoben: `reset-test-env.sh` droppt jetzt explizit alle Registry-Tabellen aus
-`migrations/*.up.sql` (`tenant_keks`, `rate_limit_counters`,
-`rate_limit_configs`, `policy_rule_changes`, `policy_rules`,
-`feature_flags`, `module_credentials`, `modules`), nicht nur die vier
-ursprünglich behandelten. Reiner Testinfrastruktur-Fix, keine
-Produktionsmigration verändert.
-
-### 2.2 `internal/e2e`-Tests: `defer adminPool.Close()` lief vor `t.Cleanup`-Bereinigung (Schweregrad **Mittel**, behoben)
-
-Voller Testlauf zeigte anschließend `internal/migrate`-Fehlschläge
-(„erwartet 3 Ergebnisse, habe 15" bzw. 12, mit Zeilen wie `e2e_tenant_a`).
-Ursache: `TestE2E_TenantOnboardingLoginFlow` und `TestE2E_CrossTenantIsolation`
-schlossen den `adminPool` per `defer adminPool.Close()`, ihre
-`t.Cleanup`-Funktion (welche die angelegten Testmandanten wieder löscht)
-lief aber – wie in Go üblich – ERST NACH allen `defer`-Aufrufen der
-Testfunktion, also gegen einen bereits geschlossenen Pool. Der Fehler wurde
-durch `_, _ = adminPool.Exec(...)` verschluckt; die Zeilen blieben dauerhaft
-in der geteilten `tenants`-Tabelle stehen und verfälschten
-`internal/migrate`s ungefilterte `registry.List()`-Abfrage im selben
-Prozess/derselben Datenbank.
-
-Behoben: `adminPool.Close()` in beiden Tests über `t.Cleanup` statt `defer`
-registriert (vor der Lösch-Cleanup, sodass LIFO die richtige Reihenfolge
-erzwingt – Pool bleibt bis nach dem Löschen offen).
-
-### 2.3 `internal/kek/kek_test.go`: derselbe defer/`t.Cleanup`-Fehler, zusätzlich fehlende Zeilen-Bereinigung (Schweregrad **Mittel**, behoben)
-
-Dieselbe Fehlerklasse wie 2.2, zusätzlich verschärft: `createTenant` legte
-Zeilen mit `db_dsn='unused'` an, ohne JEMALS eine eigene Aufräumfunktion zu
-registrieren – `setupTest`s `cleanup := func(){ pool.Close() }` schloss nur
-den Pool, löschte aber nie die angelegten `tenants`/`tenant_keks`-Zeilen.
-
-Behoben: `createTenant` registriert jetzt eine eigene `t.Cleanup`, die
-Zeile+abhängigen `tenant_keks`-Eintrag löscht; `setupTest` schließt den Pool
-über `t.Cleanup` (nicht mehr über den zurückgegebenen `cleanup()`, den
-Aufrufer per `defer` aufriefen) – damit läuft die Lösch-Cleanup (später
-registriert) vor dem Pool-Schließen (früher registriert).
-
-### 2.4 `internal/migrate/migrate_test.go`: hartkodiertes Testschema ohne Lifecycle-Spalten (Schweregrad **Mittel**, behoben)
-
-`setupOrchestratorTest` legte `tenants` über ein eigenes,
-hartkodiertes `CREATE TABLE IF NOT EXISTS` ohne die Spalten
-`previous_status`/`deletion_scheduled_at` an, die TEN-04
-(`internal/tenant/registry.go`, `GetBySlug`/`List`) inzwischen mitliest.
-Lief das Paket ISOLIERT (Tabelle wird von diesem Test selbst frisch
-angelegt), fiel der Fehler nicht auf; erst im vollen Testlauf – bei dem die
-Tabelle bereits über die echten Registry-Migrationen existiert – griff
-`CREATE TABLE IF NOT EXISTS` nicht mehr und der Fehler
-`column "previous_status" does not exist` trat zutage.
-
-Behoben: fehlende Spalten im Testschema ergänzt (kein Produktionscode
-betroffen).
-
-## 3. Build/Test-Ergebnis auf 192.168.1.131 (`/root/nexarch-code-qa04`)
-
-```
-go mod tidy   -> clean
-go build ./...  -> clean
-go vet ./...    -> clean
-go test ./... -p 1 -count=1  -> 29/29 Pakete ok, 0 Fehlschläge
-```
-
-Enthält insbesondere `internal/pentest` (12 neue Angriffstests, alle
-bestanden) sowie die bereits bestehenden 124 Tests aus QA-02/QA-03 und alle
-Tests der 10 frisch gemergten Vorbedingungs-Branches.
-
-## 4. Gesamtergebnis
-
-**Bestanden.** Alle vier Akzeptanzkriterien durch gezielte, dokumentierte
-Angriffsversuche mit Ergebnisprotokoll erfüllt; alle drei Pflichtprüfungen
-durchgeführt und protokolliert (Abschnitte 1.2–1.4). Vier real gefundene
-Fehler (Abschnitt 2, Schweregrad Hoch/Mittel) behoben – ausschließlich
-Testinfrastruktur, kein Produktionscode verändert.

docs/QA-05-ABNAHME-COMPLIANCE-PRUEFUNG.md

@@ -1,125 +0,0 @@
-# QA-05 – Abnahme- & Compliance-Prüfung Core
-
-Welle 7. Voraussetzung: QA-02, QA-03, QA-04, QA-07, QA-08, QA-09, TEN-08,
-AUD-02, API-04, OPS-03, API-06, AUD-05, API-07, LIC-05, OPS-04, OPS-05,
-OPS-06, IAM-15 (alle Status "Fertig"). Branch:
-`feature/qa-05-abnahme-compliance-pruefung-core`, alle 15 zusätzlichen
-Vorbedingungs-Branches real gemergt (auf den bereits gemergten Ständen von
-QA-02/QA-04/QA-09, die selbst schon TEN-01..08/IAM-01..15/RBAC-01..05/
-API-01..10/AUD-01..05/OPS-01..06/LIC-01..05/CFG-01..04/SHL-01/TEN-01..08
-enthalten).
-
-## 1. Konsolidierung der vorgelagerten Prüfgates (Akzeptanzkriterium 1)
-
-| Gate | Ergebnis | Fund(e) | Referenz |
-|---|---|---|---|
-| QA-02 (Identität & Mandanten) | bestanden | IAM-12/IAM-13-Typkollision (Hoch, behoben) | `docs/QA-02-PRUEFPROTOKOLL.md` |
-| QA-03 (Rechte & Policy) | bestanden | RBAC-05-Bypass-Fund (dokumentiert) | `docs/QA-03-PRUEFPROTOKOLL.md` |
-| QA-04 (Sicherheit/Pentest) | bestanden | 4 Testinfrastruktur-Bugs (Hoch/Mittel, alle behoben) | `docs/QA-04-PRUEFPROTOKOLL.md` |
-| QA-07 (Vertragstests) | bestanden | — | `internal/contracttest` |
-| QA-08 (Last-/Leistungstest) | bestanden | — | `internal/loadtest` |
-| QA-09 (Barrierefreiheit) | bestanden, 1 Restbefund terminiert | 4 WCAG-Verstöße (behoben), Testinfra-Bug (behoben) | `docs/QA-09-BARRIEREFREIHEITS-AUDIT.md` |
-
-Kein Widerspruch zwischen den Ergebnissen der sechs Gates festgestellt — alle
-betreffen unterschiedliche, nicht überlappende Prüfdimensionen (Identität,
-Rechte, Pentest, Verträge, Last, Barrierefreiheit) und keines widerruft ein
-Ergebnis eines anderen.
-
-## 2. Prüfung 1: Stichprobenartiger Abgleich Audit-Log gegen tatsächlich durchgeführte Testaktionen
-
-**Durchgeführt, mit kritischem Befund.** Stichprobe: `internal/pentest`s
-`TestPentest_Policy_PrivilegeEscalationViaWrongRole` (führt reale
-`policy.Store.Grant`/`Revoke`-Aufrufe mit Actor `pentest-setup`/
-`pentest-cleanup` aus) auf 192.168.1.131 ausgeführt, anschließend
-`audit_events`-Tabelle direkt abgefragt:
-
-```sql
-SELECT actor FROM audit_events WHERE actor LIKE '%pentest%' OR actor LIKE '%tenant_e2e%';
--- 0 Zeilen
-```
-
-**Befund (Schweregrad Hoch, NICHT in dieser Kachel behoben — siehe Begründung
-unten):** `internal/policy.Store.Grant`/`Revoke` (RBAC-02) schreiben
-ausschließlich in die modul-lokale `policy_rule_changes`-Tabelle, niemals in
-`internal/audit.Log` (AUD-01/AUD-02, `audit_events`-Tabelle). Dieselbe Lücke
-gilt für weitere sicherheitsrelevante Vorgänge, die geprüft wurden:
-Tenant-Lebenszyklus-Übergänge (`internal/tenant.Registry.transition`),
-Login-Fehlversuche/Sperren (`internal/lockout.Store`), Tenant-KEK-Rotation
-(`internal/kek.Store.RotateTenantKEK`) — keiner dieser Aufrufer ruft
-`internal/audit.Log.Record` auf. Der zentrale, unveränderliche Audit-Log
-(AUD-01/AUD-02) existiert, ist eigenständig getestet (`internal/audit/*_test.go`)
-und wird korrekt exportiert (AUD-03/AUD-04/AUD-05) — er wird nur bislang von
-keinem der produktiven Handler tatsächlich **befüllt**. Das passt zum
-architektonischen Zwischenstand: Core läuft noch als mehrere getrennte
-`*-devserver`-Binaries statt einer vereinheitlichten Server-Topologie (siehe
-Kommentar in `cmd/auditlog-devserver/main.go`: „echte Auth/RBAC ist noch
-nicht in die zentrale Server-Topologie verdrahtet"); dieselbe fehlende
-zentrale Verdrahtung betrifft die Audit-Log-Anbindung.
-
-**Warum nicht in dieser Kachel behoben:** Das Ticket verlangt „die kleinste
-Lösung, die alle Akzeptanzkriterien erfüllt. Kein Umbau angrenzender
-Bereiche." Das Verdrahten von `audit.Log.Record`-Aufrufen in JEDEN
-sicherheitsrelevanten Handler über RBAC-02/IAM-04/IAM-07/API-10 hinweg ist
-ein Umbau vieler bestehender Pakete, kein punktueller Fix — explizit nicht
-Bestandteil eines Abnahme-Gates, sondern eigener Entwicklungsaufwand.
-
-## 3. Prüfung 2: Konsolidiertes Abnahmeprotokoll von zweiter Person gegengelesen
-
-**Nicht durchgeführt — Methodik-Abweichung, siehe unten.** In dieser
-autonomen Sitzung stand keine zweite Person zum Gegenlesen zur Verfügung.
-Ersatzweise wurde dieses Protokoll gegen die Originaldaten (Testergebnisse
-auf 192.168.1.131, `audit_events`-Abfrageergebnisse, Merge-Historie)
-zurückverifiziert, was ein Vier-Augen-Prinzip nicht ersetzt.
-
-## 4. Prüfung 3: Freigabeentscheidung schriftlich mit Datum und Verantwortlicher
-
-**Freigabeentscheidung:** Bedingte Freigabe („bestanden mit Auflage").
-
-- **Datum:** 2026-08-29
-- **Verantwortlicher (dieser Durchlauf):** Claude (Sonnet 5), im Auftrag des
-  Projektinhabers, autonome NEXARCH-Core-Sitzung
-- **Entscheidung:** Die sechs vorgelagerten Prüfgates (QA-02/03/04/07/08/09)
-  sind konsolidiert und widerspruchsfrei bestanden (Akzeptanzkriterium 1
-  erfüllt). Der Audit-Log-Abgleich (Prüfung 1) deckt einen echten,
-  Schweregrad-Hoch-Befund auf: sicherheitsrelevante Vorgänge werden vom
-  zentralen Audit-Log noch nicht erfasst (Akzeptanzkriterium 2 **nicht**
-  erfüllt). Dieser Befund wird bewusst zurückgestellt statt in dieser Kachel
-  behoben (Begründung siehe Abschnitt 2) — Akzeptanzkriterium 3 dadurch im
-  Sinne von „bewusst mit Begründung zurückgestellt" erfüllt, nicht im Sinne
-  von „behoben".
-- **Auflage vor QA-06 (finaler Pentest, Welle 8):** (a) Audit-Log-Verdrahtung
-  in die sicherheitsrelevanten Handler von RBAC-02/IAM-04/IAM-07/API-10
-  nachholen (eigenes Ticket, z. B. „AUD-06: Audit-Log-Verdrahtung in
-  Core-Handler"), (b) dieses Protokoll von einer zweiten Person gegenlesen
-  lassen (Prüfung 2 nachholen, analog zum QA-09-Restbefund „echter
-  Bildschirmleser-Durchlauf").
-
-## 5. Build/Test-Ergebnis
-
-```
-go mod tidy / go build ./... / go vet ./...  -> clean
-go test ./... -p 1 -count=1                  -> 51/51 Pakete ok, 0 Fehlschläge
-```
-
-Zwei reale Testinfrastruktur-Fehler beim vollen Merge+Testlauf gefunden und
-behoben (kein Produktionscode betroffen):
-- `internal/e2e`/`internal/pentest`: Migrationsanwendung tolerierte
-  PostgreSQL-Fehlercode `42723` (`duplicate_function`, von AUD-02s
-  `CREATE FUNCTION audit_events_prevent_mutation` bei zweiter Migrationsanwendung
-  im selben Prozess) noch nicht — Codeliste um `42723` ergänzt.
-- `internal/loadtest`: dieselbe defer/`t.Cleanup`-Reihenfolge-Fehlerklasse wie
-  in QA-04 gefunden — `TestLoad_ConnectionPoolingStaysUnderLimitWithManySimulatedTenants`
-  schloss den Pool per `defer` VOR seiner `t.Cleanup`-Löschung von 200
-  synthetischen Tenant-Zeilen, wodurch diese liegen blieben und
-  `internal/migrate` im Volllauf mit 203 statt 3 erwarteten Ergebnissen
-  fehlschlug. Behoben durch Umstellung auf `t.Cleanup` (wie in QA-04).
-
-## 6. Gesamtergebnis
-
-**Bedingt bestanden.** Alle drei Pflichtprüfungen durchgeführt und
-protokolliert. Akzeptanzkriterium 1 (Konsolidierung) erfüllt.
-Akzeptanzkriterium 2 (Audit-Log-Abdeckung) **nicht erfüllt** — echter,
-dokumentierter Befund mit Schweregrad Hoch, bewusst zurückgestellt statt in
-dieser Kachel behoben (Begründung Abschnitt 2, Auflage Abschnitt 4).
-Akzeptanzkriterium 3 im Sinne „begründet zurückgestellt" erfüllt. Vor QA-06
-sind die beiden in Abschnitt 4 genannten Auflagen zu erfüllen.

docs/QA-09-BARRIEREFREIHEITS-AUDIT.md

@@ -1,143 +0,0 @@
-# QA-09 – Barrierefreiheits-Audit (Core-Oberflächen)
-
-Welle 6. Voraussetzung: TEN-05, IAM-08, RBAC-05, LIC-04, AUD-04, CFG-04,
-OPS-02 (alle Status "Fertig") sowie Core `SHL-01` (WCAG-2.1-AA-Basis).
-Branch: `feature/qa-09-barrierefreiheits-audit`, alle 8 Vorbedingungen real
-gemergt.
-
-Geprüfte Oberflächen (7 Next.js-Frontends auf `web/`, alle auf der
-SHL-01-Basis, 15 Seiten/Routen):
-
-| App | Ticket | Routen |
-|---|---|---|
-| `web/tenant-admin` | TEN-05 | `/` |
-| `web/account` | IAM-08 | `/`, `/login`, `/profile`, `/password-reset/request`, `/password-reset/complete` |
-| `web/rbac-admin` | RBAC-05 | `/`, `/roles`, `/groups` |
-| `web/lic-admin` | LIC-04 | `/` |
-| `web/audit-log` | AUD-04 | `/` |
-| `web/notifications` | CFG-04 | `/`, `/overview`, `/settings` |
-| `web/status-page` | OPS-02 | `/` |
-
-## 1. Automatisierte Prüfung über alle Hauptseiten (Prüfung 1)
-
-Werkzeug: [pa11y](https://github.com/pa11y/pa11y) 10.0.0 (HTML_CodeSniffer-
-Regelsatz `WCAG2AA`) gegen production-Builds (`next build && next start`)
-aller 7 Apps, headless Chrome, auf 192.168.1.131.
-
-**Erster Durchlauf** (vor Fixes): 19 Verstöße über 4 Seiten.
-
-| Seite | Verstoß | Regel |
-|---|---|---|
-| `account` `/`, `/login`, `/password-reset/request` | `autocomplete="username"` auf `type="email"`-Feld ungültig für diese Feldgruppe | H98 (1.3.5) |
-| `audit-log` `/` | 4 Filter-Eingabefelder ohne zugänglichen Namen | H91/F68 (4.1.2/1.3.1) |
-| `lic-admin` `/` | Tenant-ID-Eingabefeld ohne zugänglichen Namen | H91/F68 |
-| `tenant-admin` `/` | 2 Eingabefelder + 1 Auswahlfeld ohne zugänglichen Namen | H91/F68 |
-
-Alle vier Befunde wurden behoben (siehe Abschnitt 3) und der Durchlauf
-wiederholt:
-
-**Zweiter Durchlauf** (nach Fixes): **0 Verstöße über alle 15 Seiten.**
-
-## 2. Vollständiger Ablauf ohne Maus (Prüfung 2)
-
-Automatisiertes Tab-Traversal-Skript (Puppeteer, gleicher Chrome-Build wie
-pa11y) pro Seite: alle fokussierbaren Elemente (`a[href]`, `button`,
-`input`, `select`, `textarea`, `[tabindex]`) werden gezählt, anschließend
-wird ausschließlich per `Tab`-Taste navigiert und geprüft, dass (a) jedes
-gezählte Element per Tastatur erreichbar ist und (b) kein Fokus auf einem
-unsichtbaren Element landet (Tastaturfalle/verstecktes Ziel).
-
-Ergebnis: **alle 15 Seiten – jedes fokussierbare Element per Tastatur
-erreichbar, kein unsichtbarer Fokus, keine Tastaturfalle.**
-
-Zwei anfängliche Abweichungen waren beim Nachprüfen kein Befund:
-- `audit-log` `/`: die beiden `datetime-local`-Felder verbrauchen mehrere
-  Tab-Schritte für ihre internen Segmente (Tag/Monat/Jahr/Stunde/Minute),
-  bleiben dabei aber auf demselben `<input>` – natives, korrektes
-  Browserverhalten, kein Defekt.
-- `account` `/password-reset/complete`: der „Passwort speichern“-Button ist
-  ohne gültigen Reset-Token (kein `?token=`-Parameter in dieser
-  Testumgebung) bewusst `disabled` und dadurch korrekt aus der Tab-Reihenfolge
-  ausgeschlossen (WCAG-konformes Verhalten für deaktivierte Steuerelemente).
-
-## 3. Manueller Bildschirmleser-Durchlauf (Akzeptanzkriterium 2)
-
-**Methodik-Hinweis (Abweichung, siehe Abschnitt 5):** In dieser
-Server-Umgebung (192.168.1.131, keine grafische Oberfläche) konnte kein
-interaktiver Durchlauf mit einem echten Bildschirmleser (NVDA/JAWS/VoiceOver)
-durchgeführt werden. Ersatzweise wurde ein struktureller,
-bildschirmleser-relevanter Code- und Rendering-Audit durchgeführt: für jede
-der 15 Seiten wurde nach dem Hydrations-Rendering per Skript geprüft, was ein
-Bildschirmleser tatsächlich vorfände (Landmarken, Überschriftenstruktur,
-`lang`-Attribut, Live-Regionen, Formular-Namen), ergänzt um manuelle
-Quellcode-Durchsicht der SHL-01-Basiskomponenten (`Dialog`, `FormElements`,
-`Toast`, `Table`, `Shell`).
-
-Ergebnisse:
-- **`<html lang="de">`** auf allen 15 Seiten korrekt gesetzt.
-- **Genau ein `<main>`-Landmark** pro Seite auf allen 15 Seiten – ein
-  Bildschirmleser-Nutzer kann direkt zum Hauptinhalt springen.
-- **Fehler-/Statusmeldungen** sind durchweg als `role="alert"` bzw.
-  `aria-live`-Region ausgezeichnet (z. B. Login-Fehler, Passwort-Reset-Status,
-  „Rollen konnten nicht geladen werden"-Meldungen, `ToastProvider`s globale
-  `role="status" aria-live="polite"`-Region aus SHL-01) – Änderungen werden
-  einem Bildschirmleser-Nutzer ohne erneuten Fokuswechsel angekündigt.
-- **Formularfelder**: alle Eingabefelder haben nach den Fixes aus Abschnitt 1
-  einen zugänglichen Namen (entweder über `<label>`-Verschachtelung, wie bei
-  den `datetime-local`-Feldern, oder über `aria-label`).
-- **Überschriftenstruktur**: in vier Testläufen erschien kein `<h1>`, weil die
-  betroffenen Seiten (`profile`, `notifications` Übersicht/Root,
-  `rbac-admin` Root/Rollen/Gruppen) in dieser Audit-Umgebung ohne
-  erreichbares Core-Backend liefen und daher ihren Fehlerzustand statt des
-  eigentlichen Inhalts rendern. Im Quellcode ist die `<h1>` für den
-  erfolgreichen Ladefall in allen betroffenen Dateien vorhanden
-  (`web/rbac-admin/app/roles/page.tsx`, `.../groups/page.tsx`,
-  `web/notifications/app/overview/page.tsx`, `.../settings/page.tsx`,
-  `web/account/app/profile/page.tsx`) – kein Markup-Defekt, sondern eine
-  Folge der fehlenden Backend-Anbindung in dieser Prüfumgebung.
-- **Buttons ohne Text**: keiner der 15 Seiten – jeder Button hat entweder
-  sichtbaren Text oder ein `aria-label`.
-
-## 4. Behobene Befunde
-
-| # | Ort | Befund | Schweregrad | Behebung |
-|---|---|---|---|---|
-| 1 | `web/account/app/login/page.tsx`, `.../password-reset/request/page.tsx` | `autoComplete="username"` auf `type="email"`-Feld (WCAG 1.3.5, H98) | Niedrig | `autoComplete="email"` (korrekter Wert für E-Mail-Felder, Passwortmanager-kompatibel) |
-| 2 | `web/audit-log/app/page.tsx` | 4 Filter-Eingabefelder ohne zugänglichen Namen (WCAG 1.3.1/4.1.2) | Mittel | `aria-label` ergänzt |
-| 3 | `web/lic-admin/app/page.tsx` | Tenant-ID-Feld ohne zugänglichen Namen | Mittel | `aria-label` ergänzt |
-| 4 | `web/tenant-admin/app/page.tsx` | 2 Eingabe- + 1 Auswahlfeld ohne zugänglichen Namen | Mittel | `aria-label` ergänzt |
-
-Keine kritischen Verstöße offen (Akzeptanzkriterium 1) – alle vier
-gefundenen Verstöße waren Schweregrad Niedrig/Mittel und wurden noch
-innerhalb dieser Kachel behoben, nicht nur terminiert.
-
-## 5. Restbefunde und Fristen (Akzeptanzkriterium 3)
-
-Es bleibt **ein** dokumentierter Restbefund offen, kein WCAG-Verstoß im
-engeren Sinn, sondern eine Prüfmethodik-Lücke:
-
-- **Echter Bildschirmleser-Durchlauf (NVDA/VoiceOver) steht aus** –
-  durchgeführt wurde stattdessen ein struktureller,
-  bildschirmleser-relevanter Code-/Rendering-Audit (Abschnitt 3), da diese
-  Server-Umgebung keine grafische Oberfläche für einen echten
-  AT-Durchlauf bietet. **Frist:** vor der finalen Abnahme-Prüfung (`QA-05`,
-  Welle 7) nachzuholen, sobald ein Arbeitsplatz mit echtem Bildschirmleser
-  verfügbar ist. Schweregrad: Niedrig – die strukturelle Prüfung deckt die
-  wesentlichen WCAG-2.1-AA-Anforderungen (Name/Rolle/Wert, Landmarken,
-  Live-Regionen) bereits automatisiert und quellcodebasiert ab.
-
-## 6. Build/Test-Ergebnis
-
-```
-go build ./... / go vet ./... / go test ./... -p 1 -count=1   -> 41/41 Pakete ok
-7x  next build   -> alle clean, statisch prerendert
-pa11y WCAG2AA (2. Durchlauf, 15 Seiten)  -> 0 Verstöße
-Tab-Traversal (15 Seiten)                -> 100% erreichbar, keine Tastaturfalle
-```
-
-## 7. Gesamtergebnis
-
-**Bestanden**, mit einem terminierten Restbefund (Abschnitt 5, Frist vor
-QA-05). Alle drei Pflichtprüfungen durchgeführt und protokolliert; alle
-kritischen automatisierten Verstöße noch in dieser Kachel behoben statt nur
-terminiert.

go.mod

@@ -1,26 +1,5 @@
 module gitea.perlbach24.de/scripte/nexarch
 
-go 1.25.0
+go 1.22
 
-require (
+require github.com/jackc/pgx/v5 v5.6.0
-	github.com/golang-jwt/jwt/v5 v5.3.1
-	github.com/jackc/pgx/v5 v5.6.0
-	github.com/prometheus/client_golang v1.24.1
-	github.com/prometheus/client_model v0.6.2
-	github.com/prometheus/common v0.70.1
-	golang.org/x/crypto v0.17.0
-)
-
-require (
-	github.com/beorn7/perks v1.0.1 // indirect
-	github.com/cespare/xxhash/v2 v2.3.0 // indirect
-	github.com/jackc/pgpassfile v1.0.0 // indirect
-	github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a // indirect
-	github.com/jackc/puddle/v2 v2.2.1 // indirect
-	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
-	github.com/prometheus/procfs v0.21.1 // indirect
-	golang.org/x/sync v0.22.0 // indirect
-	golang.org/x/sys v0.47.0 // indirect
-	golang.org/x/text v0.40.0 // indirect
-	google.golang.org/protobuf v1.36.11 // indirect
-)

go.sum

@@ -1,54 +0,0 @@
-github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=
-github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=
-github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
-github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
-github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/golang-jwt/jwt/v5 v5.3.1 h1:kYf81DTWFe7t+1VvL7eS+jKFVWaUnK9cB1qbwn63YCY=
-github.com/golang-jwt/jwt/v5 v5.3.1/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
-github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
-github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
-github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
-github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
-github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a h1:bbPeKD0xmW/Y25WS6cokEszi5g+S0QxI/d45PkRi7Nk=
-github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
-github.com/jackc/pgx/v5 v5.6.0 h1:SWJzexBzPL5jb0GEsrPMLIsi/3jOo7RHlzTjcAeDrPY=
-github.com/jackc/pgx/v5 v5.6.0/go.mod h1:DNZ/vlrUnhWCoFGxHAG8U2ljioxukquj7utPDgtQdTw=
-github.com/jackc/puddle/v2 v2.2.1 h1:RhxXJtFG022u4ibrCSMSiu5aOq1i77R3OHKNJj77OAk=
-github.com/jackc/puddle/v2 v2.2.1/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
-github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=
-github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/prometheus/client_golang v1.24.1 h1:JnJkREXzWxUdCuPFpIWZiPispT9xVV59uiuyR2bPlnU=
-github.com/prometheus/client_golang v1.24.1/go.mod h1:F+oSRECHg4sse5ucfYpYDeIv/hu68Zo0uoHKetWnzcE=
-github.com/prometheus/client_model v0.6.2 h1:oBsgwpGs7iVziMvrGhE53c/GrLUsZdHnqNwqPLxwZyk=
-github.com/prometheus/client_model v0.6.2/go.mod h1:y3m2F6Gdpfy6Ut/GBsUqTWZqCUvMVzSfMLjcu6wAwpE=
-github.com/prometheus/common v0.70.1 h1:1HvjP4D5oL3t8RsPlwxA9onvvStjtIHYE5XuuwOi/PY=
-github.com/prometheus/common v0.70.1/go.mod h1:VdFUQDMZK3VLkurFUVhia6uys/0suUp86TJz5qbJRhc=
-github.com/prometheus/procfs v0.21.1 h1:GljZCt+zSTS+NZq88cyQ1LjZ+RCHp3uVuabBWA5+OJI=
-github.com/prometheus/procfs v0.21.1/go.mod h1:aB55Cww9pdSJVHk0hUf0inxWyyjPogFIjmHKYgMKmtY=
-github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
-github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
-github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
-github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
-github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
-go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
-go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
-go.yaml.in/yaml/v2 v2.4.4 h1:tuyd0P+2Ont/d6e2rl3be67goVK4R6deVxCUX5vyPaQ=
-go.yaml.in/yaml/v2 v2.4.4/go.mod h1:gMZqIpDtDqOfM0uNfy0SkpRhvUryYH0Z6wdMYcacYXQ=
-golang.org/x/crypto v0.17.0 h1:r8bRNjWL3GshPW3gkd+RpvzWrZAwPS49OmTGZ/uhM4k=
-golang.org/x/crypto v0.17.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4=
-golang.org/x/sync v0.22.0 h1:SZjpbeLmrCk4xhRSZFNZW5gFUeCeFgjekvI/+gfScek=
-golang.org/x/sync v0.22.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
-golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
-golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/text v0.40.0 h1:Ub2Z6/xjgF1WrYQz2nuITOEegKFtiIy+rieRJ5lHZKs=
-golang.org/x/text v0.40.0/go.mod h1:hpnzDAfGV753zIKo+wk3u1bVKCGPbrnF7+7LBF/UHVY=
-google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
-google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

internal/adminapi/lichandler.go

@@ -1,226 +0,0 @@
-// Package adminapi implementiert Core LIC-04: das Backend-API fuer die
-// Lizenz-/Modul-Verwaltungsoberflaeche. Das Paket enthaelt KEINE eigene
-// Lizenz-/Flag-/Quota-Logik, sondern ist ein duenner Vermittler ueber
-// internal/license, internal/flag und internal/usage (Ticket-Vorgabe:
-// "Verwaltungsoberflaeche als duenner Client ... ohne eigene Lizenzlogik").
-package adminapi
-
-import (
-	"context"
-	"encoding/json"
-	"errors"
-	"fmt"
-	"net/http"
-	"strings"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/flag"
-	"gitea.perlbach24.de/scripte/nexarch/internal/license"
-	"gitea.perlbach24.de/scripte/nexarch/internal/usage"
-)
-
-// UsageMetrics sind die Metriken, die auf der Uebersichtsseite je Tenant
-// dargestellt werden (Akzeptanzkriterium 3). Neue Metriken hinzuzufuegen
-// beruehrt kein bestehendes Verhalten von internal/usage.
-var UsageMetrics = []string{"users", "storage_bytes", "api_calls"}
-
-// FlagOverview ist ein Flag zusammen mit der fuer den Tenant ausgewerteten
-// Berechtigung, es umzuschalten (Akzeptanzkriterium 2).
-type FlagOverview struct {
-	Key       string `json:"key"`
-	Enabled   bool   `json:"enabled"`
-	Licensed  bool   `json:"licensed"`
-	DenyGrund string `json:"deny_grund,omitempty"`
-}
-
-// UsageOverview ist eine Metrik mit Zaehlerstand, Quota und Status
-// (Akzeptanzkriterium 3).
-type UsageOverview struct {
-	Metric string       `json:"metric"`
-	Value  int64        `json:"value"`
-	Limit  int64        `json:"limit"`
-	Status usage.Status `json:"status"`
-}
-
-// Overview ist die vollstaendige Antwort fuer die Uebersichtsseite
-// (Akzeptanzkriterium 1: Lizenzstatus/Laufzeit/Module auf einen Blick).
-type Overview struct {
-	Plan       string          `json:"plan"`
-	Modules    []string        `json:"modules"`
-	IssuedAt   string          `json:"issued_at"`
-	ValidUntil string          `json:"valid_until"`
-	Expired    bool            `json:"expired"`
-	Flags      []FlagOverview  `json:"flags"`
-	Usage      []UsageOverview `json:"usage"`
-}
-
-// ErrFlagNotLicensed wird geliefert, wenn ein Administrator versucht, ein
-// Flag zu aktivieren, dessen zugehoeriges Modul die Lizenz nicht umfasst
-// (Akzeptanzkriterium 2 / Pruefung 1).
-var ErrFlagNotLicensed = errors.New("adminapi: modul ist durch die aktuelle lizenz nicht freigeschaltet")
-
-// Handler buendelt die drei Vorbedingungs-Dienste hinter einem gemeinsamen
-// HTTP-API fuer das Frontend.
-type Handler struct {
-	licenseStore *license.Store
-	flagStore    *flag.Store
-	flagService  *flag.Service
-	usageStore   *usage.Store
-}
-
-func NewHandler(licenseStore *license.Store, flagStore *flag.Store, flagService *flag.Service, usageStore *usage.Store) *Handler {
-	return &Handler{licenseStore: licenseStore, flagStore: flagStore, flagService: flagService, usageStore: usageStore}
-}
-
-// isModuleLicensed prueft, ob ein Flag-Schluessel als lizenziertes Modul
-// gilt. Konvention: ein Flag-Key der Form "module:<name>" ist an das
-// gleichnamige Modul in Payload.Modules gebunden; alle anderen Flag-Keys
-// gelten als lizenzunabhaengige, rein funktionale Schalter.
-func isModuleLicensed(key string, modules []string) (moduleName string, isModuleFlag bool, licensed bool) {
-	const prefix = "module:"
-	if !strings.HasPrefix(key, prefix) {
-		return "", false, true
-	}
-	moduleName = strings.TrimPrefix(key, prefix)
-	for _, m := range modules {
-		if m == moduleName {
-			return moduleName, true, true
-		}
-	}
-	return moduleName, true, false
-}
-
-// Overview liefert die kombinierte Uebersicht fuer einen Tenant
-// (Akzeptanzkriterium 1 + 3).
-func (h *Handler) Overview(ctx context.Context, tenantID string) (Overview, error) {
-	lic, err := h.licenseStore.Status(ctx, tenantID)
-	if err != nil {
-		return Overview{}, fmt.Errorf("lizenzstatus lesen: %w", err)
-	}
-	_, expiredErr := h.licenseStore.RequireActive(ctx, tenantID)
-	expired := errors.Is(expiredErr, license.ErrLicenseExpired)
-
-	flags, err := h.flagStore.List(ctx)
-	if err != nil {
-		return Overview{}, fmt.Errorf("flags lesen: %w", err)
-	}
-
-	tenantSlug := tenantID // Auswertung erwartet den Tenant-Bezug als String; Aufloesung ID->Slug obliegt dem Aufrufer (siehe Handler-Tests).
-	flagOverviews := make([]FlagOverview, 0, len(flags))
-	for _, f := range flags {
-		_, _, licensed := isModuleLicensed(f.Key, lic.Modules)
-		fo := FlagOverview{
-			Key:      f.Key,
-			Enabled:  h.flagService.IsEnabled(ctx, tenantSlug, f.Key),
-			Licensed: licensed,
-		}
-		if !licensed {
-			fo.DenyGrund = "Modul ist im aktuellen Lizenzplan nicht enthalten"
-		}
-		flagOverviews = append(flagOverviews, fo)
-	}
-
-	usageOverviews := make([]UsageOverview, 0, len(UsageMetrics))
-	for _, metric := range UsageMetrics {
-		value, limit, status, err := h.usageStore.Check(ctx, tenantID, metric)
-		if err != nil {
-			return Overview{}, fmt.Errorf("nutzungsstand lesen (%s): %w", metric, err)
-		}
-		usageOverviews = append(usageOverviews, UsageOverview{
-			Metric: metric, Value: value, Limit: limit, Status: status,
-		})
-	}
-
-	return Overview{
-		Plan:       lic.Plan,
-		Modules:    lic.Modules,
-		IssuedAt:   lic.IssuedAt.Format("2006-01-02T15:04:05Z07:00"),
-		ValidUntil: lic.ValidUntil.Format("2006-01-02T15:04:05Z07:00"),
-		Expired:    expired,
-		Flags:      flagOverviews,
-		Usage:      usageOverviews,
-	}, nil
-}
-
-// ToggleFlag schaltet ein Flag global an/aus, NACHDEM geprueft wurde, dass
-// das zugehoerige Modul lizenziert ist (Akzeptanzkriterium 2 / Pruefung 1).
-// Ein nicht lizenziertes Modul wird mit ErrFlagNotLicensed abgelehnt, bevor
-// irgendein Schreibzugriff erfolgt.
-func (h *Handler) ToggleFlag(ctx context.Context, tenantID, key string, enabled bool) error {
-	lic, err := h.licenseStore.Status(ctx, tenantID)
-	if err != nil {
-		return fmt.Errorf("lizenzstatus lesen: %w", err)
-	}
-
-	if enabled {
-		if _, _, licensed := isModuleLicensed(key, lic.Modules); !licensed {
-			return ErrFlagNotLicensed
-		}
-	}
-
-	existing, err := h.flagStore.Get(ctx, key)
-	if err != nil && !errors.Is(err, flag.ErrNotFound) {
-		return fmt.Errorf("flag lesen: %w", err)
-	}
-	existing.Key = key
-	existing.Enabled = enabled
-
-	if err := h.flagStore.Set(ctx, existing); err != nil {
-		return fmt.Errorf("flag speichern: %w", err)
-	}
-	h.flagService.Invalidate(key)
-	return nil
-}
-
-// --- HTTP-Bindung ---
-
-func (h *Handler) OverviewHandler(w http.ResponseWriter, r *http.Request) {
-	tenantID := r.URL.Query().Get("tenant")
-	if tenantID == "" {
-		writeError(w, http.StatusBadRequest, "tenant-parameter fehlt")
-		return
-	}
-	overview, err := h.Overview(r.Context(), tenantID)
-	if err != nil {
-		writeError(w, http.StatusInternalServerError, err.Error())
-		return
-	}
-	writeJSON(w, http.StatusOK, overview)
-}
-
-type toggleRequest struct {
-	Tenant  string `json:"tenant"`
-	Key     string `json:"key"`
-	Enabled bool   `json:"enabled"`
-}
-
-func (h *Handler) ToggleFlagHandler(w http.ResponseWriter, r *http.Request) {
-	var req toggleRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		writeError(w, http.StatusBadRequest, "ungueltiger anfrage-koerper")
-		return
-	}
-	if req.Tenant == "" || req.Key == "" {
-		writeError(w, http.StatusBadRequest, "tenant und key sind erforderlich")
-		return
-	}
-
-	err := h.ToggleFlag(r.Context(), req.Tenant, req.Key, req.Enabled)
-	switch {
-	case err == nil:
-		writeJSON(w, http.StatusOK, map[string]string{"status": "ok"})
-	case errors.Is(err, ErrFlagNotLicensed):
-		writeError(w, http.StatusForbidden, ErrFlagNotLicensed.Error())
-	default:
-		writeError(w, http.StatusInternalServerError, err.Error())
-	}
-}
-
-func writeJSON(w http.ResponseWriter, status int, body any) {
-	w.Header().Set("Content-Type", "application/json")
-	w.WriteHeader(status)
-	_ = json.NewEncoder(w).Encode(body)
-}
-
-func writeError(w http.ResponseWriter, status int, message string) {
-	writeJSON(w, status, map[string]string{"error": message})
-}

internal/adminapi/lichandler_test.go

@@ -1,275 +0,0 @@
-package adminapi
-
-import (
-	"bytes"
-	"context"
-	"crypto/ed25519"
-	"encoding/json"
-	"fmt"
-	"net/http"
-	"net/http/httptest"
-	"os"
-	"testing"
-	"time"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/flag"
-	"gitea.perlbach24.de/scripte/nexarch/internal/license"
-	"gitea.perlbach24.de/scripte/nexarch/internal/usage"
-)
-
-type testEnv struct {
-	handler  *Handler
-	tenantID string
-	pool     *pgxpool.Pool
-}
-
-func setupTest(t *testing.T) (testEnv, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS tenants (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-			slug TEXT NOT NULL UNIQUE,
-			name TEXT NOT NULL,
-			db_name TEXT NOT NULL UNIQUE,
-			db_dsn TEXT NOT NULL,
-			status TEXT NOT NULL DEFAULT 'active',
-			created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS tenant_licenses (
-			tenant_id UUID PRIMARY KEY REFERENCES tenants(id),
-			plan TEXT NOT NULL,
-			modules TEXT[] NOT NULL,
-			issued_at TIMESTAMPTZ NOT NULL,
-			valid_until TIMESTAMPTZ NOT NULL,
-			raw_key TEXT NOT NULL,
-			installed_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS feature_flags (
-			key TEXT PRIMARY KEY,
-			enabled BOOLEAN NOT NULL DEFAULT false,
-			rollout_percentage INT NOT NULL DEFAULT 0,
-			target_tenant_slugs TEXT[] NOT NULL DEFAULT '{}',
-			updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS usage_counters (
-			tenant_id UUID NOT NULL, metric TEXT NOT NULL, value BIGINT NOT NULL DEFAULT 0,
-			updated_at TIMESTAMPTZ NOT NULL DEFAULT now(), PRIMARY KEY (tenant_id, metric)
-		);
-		CREATE TABLE IF NOT EXISTS usage_quotas (
-			tenant_id UUID NOT NULL, metric TEXT NOT NULL, limit_value BIGINT NOT NULL,
-			PRIMARY KEY (tenant_id, metric)
-		);
-	`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	slug := fmt.Sprintf("adminapi_test_%d", time.Now().UnixNano())
-	var tenantID string
-	if err := pool.QueryRow(ctx, `
-		INSERT INTO tenants (slug, name, db_name, db_dsn)
-		VALUES ($1, 'Adminapi Test', $1, 'unused') RETURNING id
-	`, slug).Scan(&tenantID); err != nil {
-		t.Fatalf("test-tenant anlegen: %v", err)
-	}
-
-	pub, priv, err := ed25519.GenerateKey(nil)
-	if err != nil {
-		t.Fatalf("schluesselpaar: %v", err)
-	}
-	issuer := license.NewIssuer(priv)
-	licenseStore := license.NewStore(pool, license.NewValidator(pub))
-
-	payload := license.Payload{
-		TenantSlug: slug,
-		Plan:       "professional",
-		Modules:    []string{"dms", "mail"},
-		IssuedAt:   time.Now().Truncate(time.Second),
-		ValidUntil: time.Now().Add(30 * 24 * time.Hour).Truncate(time.Second),
-	}
-	key, err := issuer.Issue(payload)
-	if err != nil {
-		t.Fatalf("lizenz ausstellen: %v", err)
-	}
-	if _, err := licenseStore.Install(ctx, tenantID, key); err != nil {
-		t.Fatalf("lizenz installieren: %v", err)
-	}
-
-	flagStore := flag.NewStore(pool)
-	flagService := flag.NewService(flagStore, time.Millisecond) // sehr kurze TTL, damit Tests nicht auf Cache-Ablauf warten muessen
-	usageStore := usage.NewStore(pool)
-
-	handler := NewHandler(licenseStore, flagStore, flagService, usageStore)
-
-	cleanup := func() {
-		_, _ = pool.Exec(ctx, `DELETE FROM usage_quotas WHERE tenant_id = $1`, tenantID)
-		_, _ = pool.Exec(ctx, `DELETE FROM usage_counters WHERE tenant_id = $1`, tenantID)
-		_, _ = pool.Exec(ctx, `DELETE FROM tenant_licenses WHERE tenant_id = $1`, tenantID)
-		_, _ = pool.Exec(ctx, `DELETE FROM tenants WHERE id = $1`, tenantID)
-		_, _ = pool.Exec(ctx, `DELETE FROM feature_flags WHERE key LIKE 'adminapi\_test\_%' ESCAPE '\'`)
-		pool.Close()
-	}
-	return testEnv{handler: handler, tenantID: tenantID, pool: pool}, cleanup
-}
-
-// Akzeptanzkriterium 1: Lizenzstatus, Laufzeit und Module sind auf einen
-// Blick abfragbar.
-func TestOverview_ShowsLicenseStatusAndModules(t *testing.T) {
-	env, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	overview, err := env.handler.Overview(ctx, env.tenantID)
-	if err != nil {
-		t.Fatalf("overview: %v", err)
-	}
-	if overview.Plan != "professional" {
-		t.Fatalf("plan = %q, want professional", overview.Plan)
-	}
-	if len(overview.Modules) != 2 {
-		t.Fatalf("module = %v, want 2 eintraege", overview.Modules)
-	}
-	if overview.Expired {
-		t.Fatal("lizenz sollte nicht abgelaufen sein")
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 1: Umschalten eines nicht lizenzierten
-// Features wird verhindert und verstaendlich begruendet.
-func TestToggleFlag_RejectsUnlicensedModule(t *testing.T) {
-	env, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	err := env.handler.ToggleFlag(ctx, env.tenantID, "module:archive", true)
-	if err == nil {
-		t.Fatal("erwartet fehler beim aktivieren eines nicht lizenzierten moduls")
-	}
-	if err.Error() == "" {
-		t.Fatal("fehlermeldung sollte verstaendlich sein, nicht leer")
-	}
-	t.Logf("erhaltene begruendung: %v", err)
-
-	// Sicherstellen, dass NICHTS geschrieben wurde: Flag existiert weiterhin nicht.
-	if _, ferr := flag.NewStore(env.pool).Get(ctx, "module:archive"); ferr == nil {
-		t.Fatal("flag haette wegen fehlender lizenz nicht angelegt werden duerfen")
-	}
-}
-
-// Akzeptanzkriterium 2: lizenziertes Modul laesst sich umschalten.
-func TestToggleFlag_AllowsLicensedModule(t *testing.T) {
-	env, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if err := env.handler.ToggleFlag(ctx, env.tenantID, "module:dms", true); err != nil {
-		t.Fatalf("erwartet erfolg fuer lizenziertes modul, habe: %v", err)
-	}
-
-	overview, err := env.handler.Overview(ctx, env.tenantID)
-	if err != nil {
-		t.Fatalf("overview: %v", err)
-	}
-	found := false
-	for _, f := range overview.Flags {
-		if f.Key == "module:dms" {
-			found = true
-			if !f.Enabled || !f.Licensed {
-				t.Fatalf("flag-status unerwartet: %+v", f)
-			}
-		}
-	}
-	if !found {
-		t.Fatal("erwartet 'module:dms' in der uebersicht nach dem umschalten")
-	}
-}
-
-// Akzeptanzkriterium 3 + Pruefung 2: Nutzungsstand stimmt mit den
-// Backend-Zaehlern ueberein.
-func TestOverview_UsageMatchesBackendCounters(t *testing.T) {
-	env, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	usageStore := usage.NewStore(env.pool)
-	if err := usageStore.Increment(ctx, env.tenantID, "users", 7); err != nil {
-		t.Fatalf("increment: %v", err)
-	}
-	if err := usageStore.SetQuota(ctx, env.tenantID, "users", 10); err != nil {
-		t.Fatalf("setquota: %v", err)
-	}
-
-	overview, err := env.handler.Overview(ctx, env.tenantID)
-	if err != nil {
-		t.Fatalf("overview: %v", err)
-	}
-
-	var got *UsageOverview
-	for i := range overview.Usage {
-		if overview.Usage[i].Metric == "users" {
-			got = &overview.Usage[i]
-		}
-	}
-	if got == nil {
-		t.Fatal("erwartet metrik 'users' in der uebersicht")
-	}
-	if got.Value != 7 || got.Limit != 10 || got.Status != usage.StatusOK {
-		t.Fatalf("nutzungsstand stimmt nicht mit backend-zaehler ueberein: %+v (want value=7 limit=10 status=ok, da 7/10=70%% unter der 80%%-warnschwelle liegt)", got)
-	}
-}
-
-// Akzeptanzkriterium 2 / Pruefung 1 auf HTTP-Ebene: der Endpunkt liefert
-// 403 mit verstaendlicher Fehlermeldung, kein interner Serverfehler.
-func TestToggleFlagHandler_HTTPForbiddenOnUnlicensed(t *testing.T) {
-	env, cleanup := setupTest(t)
-	defer cleanup()
-
-	body, _ := json.Marshal(toggleRequest{Tenant: env.tenantID, Key: "module:archive", Enabled: true})
-	req := httptest.NewRequest(http.MethodPost, "/admin/flags/toggle", bytes.NewReader(body))
-	rec := httptest.NewRecorder()
-
-	env.handler.ToggleFlagHandler(rec, req)
-
-	if rec.Code != http.StatusForbidden {
-		t.Fatalf("status = %d, want 403", rec.Code)
-	}
-	var resp map[string]string
-	if err := json.Unmarshal(rec.Body.Bytes(), &resp); err != nil {
-		t.Fatalf("body parsen: %v", err)
-	}
-	if resp["error"] == "" {
-		t.Fatal("erwartet verstaendliche fehlermeldung im response-body")
-	}
-}
-
-func TestOverviewHandler_HTTPReturnsCombinedData(t *testing.T) {
-	env, cleanup := setupTest(t)
-	defer cleanup()
-
-	req := httptest.NewRequest(http.MethodGet, "/admin/overview?tenant="+env.tenantID, nil)
-	rec := httptest.NewRecorder()
-	env.handler.OverviewHandler(rec, req)
-
-	if rec.Code != http.StatusOK {
-		t.Fatalf("status = %d, want 200", rec.Code)
-	}
-	var overview Overview
-	if err := json.Unmarshal(rec.Body.Bytes(), &overview); err != nil {
-		t.Fatalf("body parsen: %v", err)
-	}
-	if overview.Plan != "professional" {
-		t.Fatalf("plan = %q, want professional", overview.Plan)
-	}
-}

internal/alerting/evaluator.go

@@ -1,194 +0,0 @@
-package alerting
-
-import (
-	"context"
-	"fmt"
-	"sort"
-	"strings"
-	"time"
-
-	dto "github.com/prometheus/client_model/go"
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/notify"
-)
-
-// DefaultDebounceInterval: wiederholte Alarmierung für denselben
-// anhaltenden Zustand ist gedrosselt (Akzeptanzkriterium 3) — 15 Minuten
-// ist ein üblicher Kompromiss zwischen "schnell genug informiert" und
-// "kein Alarm-Spam bei dauerhaft überschrittenem Wert".
-const DefaultDebounceInterval = 15 * time.Minute
-
-// AlertChannel ist der CFG-02-Kanal, über den Schwellwert-Alarme zugestellt
-// werden — ein eigener Kanalname, damit Zustellregeln/-vorlagen (CFG-03)
-// unabhängig von anderen Benachrichtigungsarten konfiguriert werden können.
-const AlertChannel = "alert"
-
-// Evaluator prüft konfigurierte Regeln gegen aktuell gesammelte Metriken
-// (aus internal/metrics.Aggregator.Gather) und löst bei Überschreitung eine
-// Benachrichtigung über CFG-02 aus (Akzeptanzkriterium 2), gedrosselt je
-// Regel+Zeitreihe (Akzeptanzkriterium 3).
-type Evaluator struct {
-	rules      *RuleStore
-	debounce   *debounceStore
-	dispatcher *notify.Dispatcher
-	interval   time.Duration
-}
-
-func NewEvaluator(rules *RuleStore, dispatcher *notify.Dispatcher, debouncePool *pgxpool.Pool, interval time.Duration) *Evaluator {
-	if interval <= 0 {
-		interval = DefaultDebounceInterval
-	}
-	return &Evaluator{
-		rules:      rules,
-		debounce:   &debounceStore{pool: debouncePool},
-		dispatcher: dispatcher,
-		interval:   interval,
-	}
-}
-
-// FiredAlert beschreibt einen tatsächlich ausgelösten (nicht gedrosselten)
-// Alarm — fürs Testen/Logging, nicht Teil des öffentlichen Zustellwegs.
-type FiredAlert struct {
-	RuleID     string
-	MetricName string
-	Value      float64
-	Threshold  float64
-	Labels     map[string]string
-	Skipped    bool // true, wenn wegen Drosselung NICHT tatsaechlich zugestellt
-}
-
-// Evaluate prüft alle konfigurierten Regeln gegen families (Akzeptanzkriterium 1).
-// Für jede Zeitreihe, die eine Regel verletzt, wird — sofern nicht gedrosselt
-// — eine Benachrichtigung mit Metrik/Wert/Schwellwert/Labels (Tenant/Modul,
-// falls als Label vorhanden) über CFG-02 eingereiht (Akzeptanzkriterium 2).
-func (e *Evaluator) Evaluate(ctx context.Context, families []*dto.MetricFamily) ([]FiredAlert, error) {
-	rules, err := e.rules.ListRules(ctx)
-	if err != nil {
-		return nil, fmt.Errorf("regeln laden: %w", err)
-	}
-	if len(rules) == 0 {
-		return nil, nil
-	}
-
-	byName := make(map[string]*dto.MetricFamily, len(families))
-	for _, f := range families {
-		if f.Name != nil {
-			byName[*f.Name] = f
-		}
-	}
-
-	var fired []FiredAlert
-	for _, rule := range rules {
-		family, ok := byName[rule.MetricName]
-		if !ok {
-			continue // Metrik (noch) nicht vorhanden -> keine Aussage moeglich, kein Fehler.
-		}
-
-		for _, m := range family.Metric {
-			labels := labelMap(m)
-			if !matchesFilter(labels, rule.LabelFilters) {
-				continue
-			}
-			value, ok := metricValue(m)
-			if !ok {
-				continue
-			}
-			if !violates(rule, value) {
-				continue
-			}
-
-			ruleKey := ruleKeyFor(rule.ID, labels)
-			allowed, err := e.debounce.shouldFire(ctx, ruleKey, e.interval.Seconds())
-			if err != nil {
-				return fired, fmt.Errorf("drosselung pruefen: %w", err)
-			}
-
-			alert := FiredAlert{
-				RuleID: rule.ID, MetricName: rule.MetricName, Value: value,
-				Threshold: rule.Threshold, Labels: labels, Skipped: !allowed,
-			}
-			fired = append(fired, alert)
-
-			if !allowed {
-				continue
-			}
-
-			payload := map[string]any{
-				"metric":      rule.MetricName,
-				"value":       value,
-				"threshold":   rule.Threshold,
-				"comparison":  string(rule.Comparison),
-				"description": rule.Description,
-				"labels":      labels,
-			}
-			if _, err := e.dispatcher.Enqueue(ctx, AlertChannel, rule.Recipient, payload); err != nil {
-				return fired, fmt.Errorf("alarm einreihen: %w", err)
-			}
-		}
-	}
-	return fired, nil
-}
-
-func violates(rule Rule, value float64) bool {
-	switch rule.Comparison {
-	case ComparisonGreaterThan:
-		return value > rule.Threshold
-	case ComparisonLessThan:
-		return value < rule.Threshold
-	default:
-		return false
-	}
-}
-
-func labelMap(m *dto.Metric) map[string]string {
-	out := make(map[string]string, len(m.Label))
-	for _, l := range m.Label {
-		if l.Name != nil && l.Value != nil {
-			out[*l.Name] = *l.Value
-		}
-	}
-	return out
-}
-
-func matchesFilter(labels, filter map[string]string) bool {
-	for k, v := range filter {
-		if labels[k] != v {
-			return false
-		}
-	}
-	return true
-}
-
-func metricValue(m *dto.Metric) (float64, bool) {
-	switch {
-	case m.Gauge != nil && m.Gauge.Value != nil:
-		return *m.Gauge.Value, true
-	case m.Counter != nil && m.Counter.Value != nil:
-		return *m.Counter.Value, true
-	case m.Untyped != nil && m.Untyped.Value != nil:
-		return *m.Untyped.Value, true
-	default:
-		return 0, false
-	}
-}
-
-// ruleKeyFor macht die Drosselung unabhaengig je Regel UND je konkreter
-// Zeitreihe (z. B. verschiedene Tenants/Module derselben Metrik loesen
-// unabhaengig voneinander aus, siehe Migrationskommentar).
-func ruleKeyFor(ruleID string, labels map[string]string) string {
-	keys := make([]string, 0, len(labels))
-	for k := range labels {
-		keys = append(keys, k)
-	}
-	sort.Strings(keys)
-	var b strings.Builder
-	b.WriteString(ruleID)
-	for _, k := range keys {
-		b.WriteString("|")
-		b.WriteString(k)
-		b.WriteString("=")
-		b.WriteString(labels[k])
-	}
-	return b.String()
-}

internal/alerting/evaluator_test.go

@@ -1,233 +0,0 @@
-package alerting
-
-import (
-	"context"
-	"os"
-	"strings"
-	"testing"
-	"time"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-	dto "github.com/prometheus/client_model/go"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/notify"
-)
-
-func setupTest(t *testing.T) (*RuleStore, *notify.Dispatcher, *pgxpool.Pool, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS alert_rules (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), metric_name TEXT NOT NULL,
-			comparison TEXT NOT NULL CHECK (comparison IN ('gt','lt')), threshold DOUBLE PRECISION NOT NULL,
-			label_filters JSONB NOT NULL DEFAULT '{}'::jsonb, recipient TEXT NOT NULL,
-			description TEXT NOT NULL DEFAULT '', created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS alert_debounce_state (
-			rule_key TEXT PRIMARY KEY, last_fired_at TIMESTAMPTZ NOT NULL
-		);
-		CREATE TABLE IF NOT EXISTS notification_jobs (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), channel TEXT NOT NULL, recipient TEXT NOT NULL,
-			payload JSONB NOT NULL DEFAULT '{}'::jsonb, status TEXT NOT NULL DEFAULT 'pending', attempts INT NOT NULL DEFAULT 0,
-			max_attempts INT NOT NULL DEFAULT 5, next_attempt_at TIMESTAMPTZ NOT NULL DEFAULT now(), last_error TEXT,
-			created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-	`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	cleanup := func() {
-		_, _ = pool.Exec(ctx, `DELETE FROM alert_rules`)
-		_, _ = pool.Exec(ctx, `DELETE FROM alert_debounce_state`)
-		_, _ = pool.Exec(ctx, `DELETE FROM notification_jobs`)
-		pool.Close()
-	}
-	return NewRuleStore(pool), notify.NewDispatcher(pool), pool, cleanup
-}
-
-func gaugeFamily(name string, labels map[string]string, value float64) *dto.MetricFamily {
-	pairs := make([]*dto.LabelPair, 0, len(labels))
-	for k, v := range labels {
-		k, v := k, v
-		pairs = append(pairs, &dto.LabelPair{Name: &k, Value: &v})
-	}
-	n := name
-	return &dto.MetricFamily{
-		Name: &n,
-		Metric: []*dto.Metric{
-			{Label: pairs, Gauge: &dto.Gauge{Value: &value}},
-		},
-	}
-}
-
-// Akzeptanzkriterium 1 + 2 / Pruefung 1 + 2: Überschreitung löst eine
-// Benachrichtigung mit vollständigem Inhalt (Metrik/Tenant/Modul) aus.
-func TestEvaluate_FiresAlertOnThresholdExceeded(t *testing.T) {
-	rules, dispatcher, pool, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	rule, err := rules.CreateRule(ctx, Rule{
-		MetricName: "nexarch_core_error_rate", Comparison: ComparisonGreaterThan, Threshold: 0.05,
-		Recipient: "ops@acme.example", Description: "Fehlerrate zu hoch",
-	})
-	if err != nil {
-		t.Fatalf("create rule: %v", err)
-	}
-
-	eval := NewEvaluator(rules, dispatcher, pool, time.Hour)
-	families := []*dto.MetricFamily{
-		gaugeFamily("nexarch_core_error_rate", map[string]string{"tenant": "acme", "module": "dms"}, 0.12),
-	}
-
-	fired, err := eval.Evaluate(ctx, families)
-	if err != nil {
-		t.Fatalf("evaluate: %v", err)
-	}
-	if len(fired) != 1 || fired[0].Skipped {
-		t.Fatalf("erwartet genau 1 tatsaechlich ausgeloesten alarm, habe %+v", fired)
-	}
-	if fired[0].RuleID != rule.ID {
-		t.Fatalf("rule id = %q, want %q", fired[0].RuleID, rule.ID)
-	}
-
-	// Pruefung 2: Benachrichtigungsinhalt vollstaendig (Metrik/Tenant/Modul).
-	var payloadJSON []byte
-	if err := pool.QueryRow(ctx, `SELECT payload FROM notification_jobs LIMIT 1`).Scan(&payloadJSON); err != nil {
-		t.Fatalf("notification_jobs lesen: %v", err)
-	}
-	payload := string(payloadJSON)
-	for _, want := range []string{`"metric"`, `nexarch_core_error_rate`, `"tenant"`, `"acme"`, `"module"`, `"dms"`} {
-		if !strings.Contains(payload, want) {
-			t.Errorf("payload enthaelt nicht %q: %s", want, payload)
-		}
-	}
-}
-
-func TestEvaluate_DoesNotFireBelowThreshold(t *testing.T) {
-	rules, dispatcher, pool, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if _, err := rules.CreateRule(ctx, Rule{
-		MetricName: "nexarch_core_error_rate", Comparison: ComparisonGreaterThan, Threshold: 0.05,
-		Recipient: "ops@acme.example",
-	}); err != nil {
-		t.Fatalf("create rule: %v", err)
-	}
-
-	eval := NewEvaluator(rules, dispatcher, pool, time.Hour)
-	families := []*dto.MetricFamily{
-		gaugeFamily("nexarch_core_error_rate", map[string]string{"tenant": "acme"}, 0.01),
-	}
-
-	fired, err := eval.Evaluate(ctx, families)
-	if err != nil {
-		t.Fatalf("evaluate: %v", err)
-	}
-	if len(fired) != 0 {
-		t.Fatalf("erwartet keinen alarm unterhalb des schwellwerts, habe %+v", fired)
-	}
-}
-
-// Akzeptanzkriterium 3 / Pruefung 3: anhaltende Überschreitung erzeugt NICHT
-// bei jeder Messung eine neue Benachrichtigung.
-func TestEvaluate_DebouncesRepeatedFiring(t *testing.T) {
-	rules, dispatcher, pool, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if _, err := rules.CreateRule(ctx, Rule{
-		MetricName: "nexarch_core_error_rate", Comparison: ComparisonGreaterThan, Threshold: 0.05,
-		Recipient: "ops@acme.example",
-	}); err != nil {
-		t.Fatalf("create rule: %v", err)
-	}
-
-	// Langes Debounce-Intervall: der zweite Evaluate-Lauf (simuliert die
-	// naechste Messung bei anhaltend ueberschrittenem Wert) darf keinen
-	// weiteren Job einreihen.
-	eval := NewEvaluator(rules, dispatcher, pool, time.Hour)
-	families := []*dto.MetricFamily{
-		gaugeFamily("nexarch_core_error_rate", map[string]string{"tenant": "acme"}, 0.5),
-	}
-
-	first, err := eval.Evaluate(ctx, families)
-	if err != nil {
-		t.Fatalf("erster evaluate-lauf: %v", err)
-	}
-	if len(first) != 1 || first[0].Skipped {
-		t.Fatalf("erster lauf haette feuern muessen, habe %+v", first)
-	}
-
-	second, err := eval.Evaluate(ctx, families)
-	if err != nil {
-		t.Fatalf("zweiter evaluate-lauf: %v", err)
-	}
-	if len(second) != 1 || !second[0].Skipped {
-		t.Fatalf("zweiter lauf haette gedrosselt werden muessen, habe %+v", second)
-	}
-
-	var count int
-	if err := pool.QueryRow(ctx, `SELECT count(*) FROM notification_jobs`).Scan(&count); err != nil {
-		t.Fatalf("notification_jobs zaehlen: %v", err)
-	}
-	if count != 1 {
-		t.Fatalf("erwartet genau 1 eingereihten job trotz zwei ueberschreitenden messungen, habe %d", count)
-	}
-}
-
-// Verschiedene Zeitreihen derselben Regel (unterschiedlicher Tenant) werden
-// unabhaengig voneinander gedrosselt.
-func TestEvaluate_DebouncesIndependentlyPerLabelSet(t *testing.T) {
-	rules, dispatcher, pool, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if _, err := rules.CreateRule(ctx, Rule{
-		MetricName: "nexarch_core_error_rate", Comparison: ComparisonGreaterThan, Threshold: 0.05,
-		Recipient: "ops@acme.example",
-	}); err != nil {
-		t.Fatalf("create rule: %v", err)
-	}
-
-	eval := NewEvaluator(rules, dispatcher, pool, time.Hour)
-	families := []*dto.MetricFamily{
-		{
-			Name: strPtr("nexarch_core_error_rate"),
-			Metric: []*dto.Metric{
-				metricWithLabel("tenant", "acme", 0.5),
-				metricWithLabel("tenant", "beta", 0.6),
-			},
-		},
-	}
-
-	fired, err := eval.Evaluate(ctx, families)
-	if err != nil {
-		t.Fatalf("evaluate: %v", err)
-	}
-	if len(fired) != 2 {
-		t.Fatalf("erwartet 2 unabhaengige alarme (verschiedene tenants), habe %d", len(fired))
-	}
-	for _, a := range fired {
-		if a.Skipped {
-			t.Fatalf("beide tenants sollten beim ersten mal feuern, habe %+v", a)
-		}
-	}
-}
-
-func metricWithLabel(name, value string, gaugeValue float64) *dto.Metric {
-	n, v := name, value
-	return &dto.Metric{Label: []*dto.LabelPair{{Name: &n, Value: &v}}, Gauge: &dto.Gauge{Value: &gaugeValue}}
-}
-
-func strPtr(s string) *string { return &s }

internal/alerting/rules.go

@@ -1,132 +0,0 @@
-// Package alerting implementiert Core OPS-05: schwellwertbasierte
-// Alarmierung auf den aus OPS-03 aggregierten Metriken, Zustellung über den
-// Core-Benachrichtigungs-Dispatcher (CFG-02). Der Alertmanager-Gedanke von
-// Prometheus/Grafana, aber auf das Nötigste reduziert (Schwellwert, Ziel,
-// Drosselung) — keine eigene Ausdruckssprache.
-package alerting
-
-import (
-	"context"
-	"encoding/json"
-	"errors"
-	"fmt"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-// Comparison legt fest, ob ein Schwellwert nach oben oder unten überwacht
-// wird — bewusst nur zwei Operatoren, keine eigene Ausdruckssprache
-// (Ticket-Produkt-DNA).
-type Comparison string
-
-const (
-	ComparisonGreaterThan Comparison = "gt"
-	ComparisonLessThan    Comparison = "lt"
-)
-
-// Rule ist eine Schwellwert-Regel auf einer beliebigen aggregierten Metrik
-// (Akzeptanzkriterium 1). LabelFilters schränkt optional auf bestimmte
-// Label-Werte ein (z. B. tenant/module), leer = alle Zeitreihen der Metrik.
-type Rule struct {
-	ID           string
-	MetricName   string
-	Comparison   Comparison
-	Threshold    float64
-	LabelFilters map[string]string
-	Recipient    string
-	Description  string
-}
-
-// RuleStore verwaltet Alert-Regeln in der zentralen Registry-DB.
-type RuleStore struct {
-	pool *pgxpool.Pool
-}
-
-func NewRuleStore(pool *pgxpool.Pool) *RuleStore {
-	return &RuleStore{pool: pool}
-}
-
-// CreateRule legt eine neue Schwellwert-Regel an (Akzeptanzkriterium 1).
-func (s *RuleStore) CreateRule(ctx context.Context, r Rule) (Rule, error) {
-	if r.MetricName == "" || r.Recipient == "" {
-		return Rule{}, errors.New("alerting: metricName und recipient duerfen nicht leer sein")
-	}
-	if r.Comparison != ComparisonGreaterThan && r.Comparison != ComparisonLessThan {
-		return Rule{}, fmt.Errorf("alerting: unbekannter comparison-operator %q", r.Comparison)
-	}
-	if r.LabelFilters == nil {
-		r.LabelFilters = map[string]string{}
-	}
-	filtersJSON, err := json.Marshal(r.LabelFilters)
-	if err != nil {
-		return Rule{}, fmt.Errorf("label-filter serialisieren: %w", err)
-	}
-
-	err = s.pool.QueryRow(ctx, `
-		INSERT INTO alert_rules (metric_name, comparison, threshold, label_filters, recipient, description)
-		VALUES ($1, $2, $3, $4, $5, $6)
-		RETURNING id
-	`, r.MetricName, string(r.Comparison), r.Threshold, filtersJSON, r.Recipient, r.Description).Scan(&r.ID)
-	if err != nil {
-		return Rule{}, fmt.Errorf("regel speichern: %w", err)
-	}
-	return r, nil
-}
-
-// ListRules liefert alle konfigurierten Regeln — Grundlage für Evaluate.
-func (s *RuleStore) ListRules(ctx context.Context) ([]Rule, error) {
-	rows, err := s.pool.Query(ctx, `
-		SELECT id, metric_name, comparison, threshold, label_filters, recipient, description
-		FROM alert_rules ORDER BY created_at
-	`)
-	if err != nil {
-		return nil, fmt.Errorf("regeln auflisten: %w", err)
-	}
-	defer rows.Close()
-
-	var out []Rule
-	for rows.Next() {
-		var r Rule
-		var comparison string
-		var filtersJSON []byte
-		if err := rows.Scan(&r.ID, &r.MetricName, &comparison, &r.Threshold, &filtersJSON, &r.Recipient, &r.Description); err != nil {
-			return nil, fmt.Errorf("regel lesen: %w", err)
-		}
-		r.Comparison = Comparison(comparison)
-		if err := json.Unmarshal(filtersJSON, &r.LabelFilters); err != nil {
-			return nil, fmt.Errorf("label-filter lesen: %w", err)
-		}
-		out = append(out, r)
-	}
-	return out, rows.Err()
-}
-
-// DeleteRule entfernt eine Regel.
-func (s *RuleStore) DeleteRule(ctx context.Context, id string) error {
-	_, err := s.pool.Exec(ctx, `DELETE FROM alert_rules WHERE id = $1`, id)
-	if err != nil {
-		return fmt.Errorf("regel loeschen: %w", err)
-	}
-	return nil
-}
-
-// debounceStore kapselt die Drosselungs-Zustandstabelle (Akzeptanzkriterium 3).
-type debounceStore struct {
-	pool *pgxpool.Pool
-}
-
-// shouldFire prueft, ob seit dem letzten Alarm fuer ruleKey mindestens
-// interval vergangen ist — atomar ueber eine bedingte UPDATE/INSERT-
-// Sequenz, damit zwei gleichzeitige Evaluate-Laeufe (z. B. bei mehreren
-// Core-Instanzen) nicht beide gleichzeitig alarmieren.
-func (d *debounceStore) shouldFire(ctx context.Context, ruleKey string, intervalSeconds float64) (bool, error) {
-	tag, err := d.pool.Exec(ctx, `
-		INSERT INTO alert_debounce_state (rule_key, last_fired_at) VALUES ($1, now())
-		ON CONFLICT (rule_key) DO UPDATE SET last_fired_at = now()
-		WHERE alert_debounce_state.last_fired_at <= now() - ($2 * interval '1 second')
-	`, ruleKey, intervalSeconds)
-	if err != nil {
-		return false, fmt.Errorf("drosselungszustand pruefen: %w", err)
-	}
-	return tag.RowsAffected() == 1, nil
-}

internal/apiserver/context.go

@@ -1,20 +0,0 @@
-package apiserver
-
-import "context"
-
-type contextKey int
-
-const requestContextKey contextKey = iota
-
-// RequestContext ist der Tenant-/Benutzerkontext, den die Middleware-Kette
-// fuer nachgelagerte Handler bereitstellt (Akzeptanzkriterium 3).
-type RequestContext struct {
-	UserID     string
-	TenantSlug string
-}
-
-// FromContext liest den von der Middleware gesetzten Kontext.
-func FromContext(ctx context.Context) (RequestContext, bool) {
-	rc, ok := ctx.Value(requestContextKey).(RequestContext)
-	return rc, ok
-}

internal/apiserver/errors.go

@@ -1,31 +0,0 @@
-// Package apiserver implementiert Core API-01: das REST-Grundgerüst mit
-// URL-Versionierung, einheitlichem Fehlerformat und Middleware-Kette
-// (Auth, Tenant-/Benutzerkontext, Logging).
-package apiserver
-
-import (
-	"encoding/json"
-	"net/http"
-)
-
-// errorBody ist das EINE Fehlerschema fuer alle Endpunkte unter /api/{version}/
-// (Akzeptanzkriterium 2).
-type errorBody struct {
-	Error struct {
-		Code    string `json:"code"`
-		Message string `json:"message"`
-	} `json:"error"`
-}
-
-// WriteError schreibt einen Fehler im einheitlichen Schema. code ist ein
-// stabiler, maschinenlesbarer Bezeichner (z.B. "unauthenticated"), message
-// ein fuer Menschen lesbarer deutscher Text.
-func WriteError(w http.ResponseWriter, status int, code, message string) {
-	var body errorBody
-	body.Error.Code = code
-	body.Error.Message = message
-
-	w.Header().Set("Content-Type", "application/json")
-	w.WriteHeader(status)
-	_ = json.NewEncoder(w).Encode(body)
-}

internal/apiserver/middleware.go

@@ -1,56 +0,0 @@
-package apiserver
-
-import (
-	"context"
-	"log/slog"
-	"net/http"
-	"time"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-)
-
-// authAndTenantContext prueft die Session (wiederverwendet auth.TokenIssuer.Verify
-// aus IAM-02 — keine zweite JWT-Implementierung) und setzt bei Erfolg
-// RequestContext fuer nachgelagerte Handler (Akzeptanzkriterium 3). Anders
-// als auth.RequireAuth (Klartext-Fehler) antwortet diese Middleware im
-// einheitlichen API-01-Fehlerschema (Akzeptanzkriterium 2), damit ALLE
-// Endpunkte unter /api/{version}/ dasselbe Format liefern, auch bei
-// Auth-Fehlern.
-func authAndTenantContext(issuer *auth.TokenIssuer, next http.HandlerFunc) http.HandlerFunc {
-	return func(w http.ResponseWriter, r *http.Request) {
-		cookie, err := r.Cookie(auth.CookieName)
-		if err != nil {
-			WriteError(w, http.StatusUnauthorized, "unauthenticated", "nicht angemeldet")
-			return
-		}
-
-		claims, err := issuer.Verify(cookie.Value)
-		if err != nil {
-			WriteError(w, http.StatusUnauthorized, "unauthenticated", "nicht angemeldet")
-			return
-		}
-
-		rc := RequestContext{UserID: claims.UserID, TenantSlug: claims.TenantSlug}
-		next(w, r.WithContext(context.WithValue(r.Context(), requestContextKey, rc)))
-	}
-}
-
-type statusRecorder struct {
-	http.ResponseWriter
-	status int
-}
-
-func (s *statusRecorder) WriteHeader(code int) {
-	s.status = code
-	s.ResponseWriter.WriteHeader(code)
-}
-
-// loggingMiddleware protokolliert jede Anfrage strukturiert.
-func loggingMiddleware(next http.HandlerFunc) http.HandlerFunc {
-	return func(w http.ResponseWriter, r *http.Request) {
-		rec := &statusRecorder{ResponseWriter: w, status: http.StatusOK}
-		start := time.Now()
-		next(rec, r)
-		slog.Info("api-anfrage", "method", r.Method, "path", r.URL.Path, "status", rec.status, "dauer", time.Since(start))
-	}
-}

internal/apiserver/server.go

@@ -1,49 +0,0 @@
-package apiserver
-
-import (
-	"net/http"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-)
-
-// Server registriert versionierte API-Routen (Akzeptanzkriterium 1: unter
-// /api/{version}/...) und verdrahtet fuer jede Route dieselbe Middleware-
-// Kette (Logging -> Auth+Tenantkontext -> Handler).
-type Server struct {
-	mux    *http.ServeMux
-	issuer *auth.TokenIssuer
-	routes []string
-}
-
-func NewServer(issuer *auth.TokenIssuer) *Server {
-	return &Server{mux: http.NewServeMux(), issuer: issuer}
-}
-
-// Handle registriert pattern unter der angegebenen Version, z.B.
-// Handle("v1", "/things", h) -> erreichbar unter /api/v1/things. Verschiedene
-// Versionen sind unabhaengige Pfade — eine neue Version beeintraechtigt
-// bestehende nicht (Akzeptanzkriterium 1 / Pruefung 3).
-func (s *Server) Handle(version, pattern string, h http.HandlerFunc) {
-	full := "/api/" + version + pattern
-	s.routes = append(s.routes, full)
-	s.mux.HandleFunc(full, loggingMiddleware(authAndTenantContext(s.issuer, h)))
-}
-
-// RegisteredPaths liefert alle ueber Handle/HandleV1 tatsaechlich
-// registrierten Pfade — die einzige Quelle der Wahrheit fuer den
-// Drift-Abgleich mit dem OpenAPI-Dokument (API-04, siehe internal/openapi).
-// Rein additive Buchfuehrung, keine Verhaltensaenderung von Handle.
-func (s *Server) RegisteredPaths() []string {
-	out := make([]string, len(s.routes))
-	copy(out, s.routes)
-	return out
-}
-
-// HandleV1 ist die Kurzform fuer die aktuelle Hauptversion.
-func (s *Server) HandleV1(pattern string, h http.HandlerFunc) {
-	s.Handle("v1", pattern, h)
-}
-
-func (s *Server) Handler() http.Handler {
-	return s.mux
-}

internal/apiserver/server_test.go

@@ -1,149 +0,0 @@
-package apiserver
-
-import (
-	"encoding/json"
-	"net/http"
-	"net/http/httptest"
-	"testing"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-)
-
-func newTestServer() (*Server, *auth.TokenIssuer) {
-	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
-	return NewServer(issuer), issuer
-}
-
-func withAuthCookie(req *http.Request, token string) *http.Request {
-	req.AddCookie(&http.Cookie{Name: auth.CookieName, Value: token})
-	return req
-}
-
-// Akzeptanzkriterium 1: API unter versioniertem Pfad erreichbar.
-func TestHandleV1_RegistersUnderVersionedPath(t *testing.T) {
-	srv, issuer := newTestServer()
-	srv.HandleV1("/things", func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(http.StatusOK)
-	})
-
-	token, err := issuer.Issue("user-1", "acme")
-	if err != nil {
-		t.Fatalf("issue: %v", err)
-	}
-
-	req := withAuthCookie(httptest.NewRequest(http.MethodGet, "/api/v1/things", nil), token)
-	rec := httptest.NewRecorder()
-	srv.Handler().ServeHTTP(rec, req)
-	if rec.Code != http.StatusOK {
-		t.Fatalf("status = %d, want 200", rec.Code)
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 1 (Stichprobe): mehrere Endpunkte liefern
-// bei fehlerhafter Anfrage dasselbe Fehlerschema.
-func TestErrorFormat_ConsistentAcrossEndpoints(t *testing.T) {
-	srv, _ := newTestServer()
-	srv.HandleV1("/endpunkt-a", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) })
-	srv.HandleV1("/endpunkt-b", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) })
-
-	for _, path := range []string{"/api/v1/endpunkt-a", "/api/v1/endpunkt-b"} {
-		req := httptest.NewRequest(http.MethodGet, path, nil) // ohne cookie -> 401
-		rec := httptest.NewRecorder()
-		srv.Handler().ServeHTTP(rec, req)
-
-		if rec.Code != http.StatusUnauthorized {
-			t.Fatalf("%s: status = %d, want 401", path, rec.Code)
-		}
-		var body errorBody
-		if err := json.Unmarshal(rec.Body.Bytes(), &body); err != nil {
-			t.Fatalf("%s: fehlerantwort nicht im erwarteten json-schema: %v (body: %s)", path, err, rec.Body.String())
-		}
-		if body.Error.Code == "" || body.Error.Message == "" {
-			t.Fatalf("%s: erwartet nicht-leeren code/message, habe %+v", path, body)
-		}
-	}
-}
-
-// Akzeptanzkriterium 3 + Pruefung 2: Middleware-Kette setzt Tenant-/
-// Benutzerkontext zuverlaessig, nachweislich fuer mehrere Endpunkte.
-func TestMiddleware_SetsRequestContextForEveryEndpoint(t *testing.T) {
-	srv, issuer := newTestServer()
-
-	var gotA, gotB RequestContext
-	srv.HandleV1("/kontext-a", func(w http.ResponseWriter, r *http.Request) {
-		gotA, _ = FromContext(r.Context())
-		w.WriteHeader(http.StatusOK)
-	})
-	srv.HandleV1("/kontext-b", func(w http.ResponseWriter, r *http.Request) {
-		gotB, _ = FromContext(r.Context())
-		w.WriteHeader(http.StatusOK)
-	})
-
-	token, err := issuer.Issue("user-42", "tenant-x")
-	if err != nil {
-		t.Fatalf("issue: %v", err)
-	}
-
-	for path, got := range map[string]*RequestContext{"/api/v1/kontext-a": &gotA, "/api/v1/kontext-b": &gotB} {
-		req := withAuthCookie(httptest.NewRequest(http.MethodGet, path, nil), token)
-		rec := httptest.NewRecorder()
-		srv.Handler().ServeHTTP(rec, req)
-		if rec.Code != http.StatusOK {
-			t.Fatalf("%s: status = %d, want 200", path, rec.Code)
-		}
-		if got.UserID != "user-42" || got.TenantSlug != "tenant-x" {
-			t.Fatalf("%s: request-context unerwartet: %+v", path, *got)
-		}
-	}
-}
-
-// Akzeptanzkriterium 1 + Pruefung 3: eine neue v2-Route laesst sich anlegen,
-// ohne v1 zu beeintraechtigen.
-func TestVersioning_V2DoesNotAffectV1(t *testing.T) {
-	srv, issuer := newTestServer()
-	srv.HandleV1("/things", func(w http.ResponseWriter, r *http.Request) {
-		w.Write([]byte("v1-antwort"))
-	})
-	srv.Handle("v2", "/things", func(w http.ResponseWriter, r *http.Request) {
-		w.Write([]byte("v2-antwort"))
-	})
-
-	token, err := issuer.Issue("user-1", "acme")
-	if err != nil {
-		t.Fatalf("issue: %v", err)
-	}
-
-	reqV1 := withAuthCookie(httptest.NewRequest(http.MethodGet, "/api/v1/things", nil), token)
-	recV1 := httptest.NewRecorder()
-	srv.Handler().ServeHTTP(recV1, reqV1)
-	if recV1.Body.String() != "v1-antwort" {
-		t.Fatalf("v1 antwort = %q, want v1-antwort", recV1.Body.String())
-	}
-
-	reqV2 := withAuthCookie(httptest.NewRequest(http.MethodGet, "/api/v2/things", nil), token)
-	recV2 := httptest.NewRecorder()
-	srv.Handler().ServeHTTP(recV2, reqV2)
-	if recV2.Body.String() != "v2-antwort" {
-		t.Fatalf("v2 antwort = %q, want v2-antwort", recV2.Body.String())
-	}
-
-	// v1 nach dem Anlegen von v2 erneut pruefen — unveraendert.
-	reqV1Again := withAuthCookie(httptest.NewRequest(http.MethodGet, "/api/v1/things", nil), token)
-	recV1Again := httptest.NewRecorder()
-	srv.Handler().ServeHTTP(recV1Again, reqV1Again)
-	if recV1Again.Body.String() != "v1-antwort" {
-		t.Fatalf("v1 antwort nach v2-anlage = %q, want weiterhin v1-antwort", recV1Again.Body.String())
-	}
-}
-
-func TestAuthAndTenantContext_RejectsInvalidToken(t *testing.T) {
-	srv, _ := newTestServer()
-	srv.HandleV1("/geschuetzt", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) })
-
-	req := withAuthCookie(httptest.NewRequest(http.MethodGet, "/api/v1/geschuetzt", nil), "kaputtes.token.hier")
-	rec := httptest.NewRecorder()
-	srv.Handler().ServeHTTP(rec, req)
-	if rec.Code != http.StatusUnauthorized {
-		t.Fatalf("status = %d, want 401", rec.Code)
-	}
-}

internal/audit/append_only_test.go

@@ -1,97 +0,0 @@
-package audit
-
-import (
-	"context"
-	"fmt"
-	"os"
-	"testing"
-	"time"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-func setupAppendOnlyTest(t *testing.T) (*Log, *pgxpool.Pool, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS audit_events (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-			occurred_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-			tenant_slug TEXT NOT NULL CHECK (tenant_slug <> ''),
-			actor TEXT NOT NULL CHECK (actor <> ''),
-			action TEXT NOT NULL CHECK (action <> ''),
-			target TEXT NOT NULL,
-			metadata JSONB NOT NULL DEFAULT '{}'::jsonb
-		);
-		CREATE OR REPLACE FUNCTION audit_events_prevent_mutation() RETURNS TRIGGER AS $$
-		BEGIN
-			RAISE EXCEPTION 'audit_events ist append-only: % ist nicht erlaubt', TG_OP;
-		END;
-		$$ LANGUAGE plpgsql;
-		DROP TRIGGER IF EXISTS audit_events_no_update ON audit_events;
-		CREATE TRIGGER audit_events_no_update
-			BEFORE UPDATE ON audit_events
-			FOR EACH ROW EXECUTE FUNCTION audit_events_prevent_mutation();
-		DROP TRIGGER IF EXISTS audit_events_no_delete ON audit_events;
-		CREATE TRIGGER audit_events_no_delete
-			BEFORE DELETE ON audit_events
-			FOR EACH ROW EXECUTE FUNCTION audit_events_prevent_mutation();
-	`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	cleanup := func() {
-		pool.Close()
-	}
-	return NewLog(pool), pool, cleanup
-}
-
-// Akzeptanzkriterium 1 + Pruefung 1: direkter UPDATE/DELETE-Versuch wird von
-// der Datenbank abgewiesen.
-func TestAppendOnly_RejectsUpdateAndDelete(t *testing.T) {
-	log, pool, cleanup := setupAppendOnlyTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	// Append-only bedeutet: dieser Testeintrag kann NIE wieder geloescht
-	// werden, auch nicht vom Test selbst. Eindeutiger Tenant-Slug pro Lauf,
-	// damit wiederholte Testlaeufe sich nicht gegenseitig die Zaehlung
-	// verfaelschen.
-	tenantSlug := fmt.Sprintf("test_appendonly_%d", time.Now().UnixNano())
-
-	if err := log.Record(ctx, Event{
-		TenantSlug: tenantSlug,
-		Actor:      "alice",
-		Action:     "test.event",
-		Target:     "x",
-	}); err != nil {
-		t.Fatalf("record: %v", err)
-	}
-
-	_, err := pool.Exec(ctx, `UPDATE audit_events SET actor = 'mallory' WHERE tenant_slug = $1`, tenantSlug)
-	if err == nil {
-		t.Fatal("erwartet fehler bei UPDATE auf audit_events, habe nil")
-	}
-
-	_, err = pool.Exec(ctx, `DELETE FROM audit_events WHERE tenant_slug = $1`, tenantSlug)
-	if err == nil {
-		t.Fatal("erwartet fehler bei DELETE auf audit_events, habe nil")
-	}
-
-	count, err := log.CountByTenant(ctx, tenantSlug)
-	if err != nil {
-		t.Fatalf("count: %v", err)
-	}
-	if count != 1 {
-		t.Fatalf("eintrag haette trotz fehlgeschlagener update/delete-versuche erhalten bleiben muessen, count=%d", count)
-	}
-}

internal/audit/audit.go

@@ -1,96 +0,0 @@
-// Package audit implementiert Core AUD-01: das zentrale, vom allgemeinen
-// Anwendungs-Log getrennte Audit-Datenmodell fuer sicherheits- und
-// compliancerelevante Ereignisse (wer, was, wann, an welchem Tenant).
-// Unveraenderlichkeit (Append-only) ist AUD-02, Export/Filter-API ist AUD-03
-// — dieses Paket liefert nur das Datenmodell und den EINEN zentralen
-// Schreibpfad (Akzeptanzkriterium 3).
-package audit
-
-import (
-	"context"
-	"encoding/json"
-	"errors"
-	"fmt"
-	"time"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-// SystemTenant ist der reservierte Tenant-Bezug fuer mandantenuebergreifende
-// Ereignisse (z.B. Superadmin-Aktionen) — es gibt bewusst KEINEN Weg, ein
-// Ereignis ganz ohne Tenant-Bezug zu schreiben (Akzeptanzkriterium 2).
-const SystemTenant = "system"
-
-var ErrMissingTenant = errors.New("audit: tenant_slug darf nicht leer sein")
-var ErrMissingActor = errors.New("audit: actor darf nicht leer sein")
-var ErrMissingAction = errors.New("audit: action darf nicht leer sein")
-
-// Event ist ein strukturiertes Audit-Ereignis (Akzeptanzkriterium 1: Akteur,
-// Aktion, Zielobjekt, Zeitpunkt, Tenant).
-type Event struct {
-	TenantSlug string
-	Actor      string
-	Action     string
-	Target     string
-	Metadata   map[string]any
-	OccurredAt time.Time
-}
-
-// Log ist der EINE zentrale Schreibpfad fuer Audit-Ereignisse — es gibt
-// bewusst keine zweite Schreibmoeglichkeit, damit kein Handler versehentlich
-// direkt in audit_events schreibt und dabei die Validierung umgeht
-// (Akzeptanzkriterium 3).
-type Log struct {
-	pool *pgxpool.Pool
-}
-
-func NewLog(pool *pgxpool.Pool) *Log {
-	return &Log{pool: pool}
-}
-
-// Record persistiert genau einen Audit-Eintrag. Fehlender Tenant-Bezug wird
-// bereits hier abgewiesen (klarer Fehler statt Constraint-Verletzung im
-// Normalfall) — die Datenbank-CHECK-Constraint aus der Migration ist die
-// zweite, unumgehbare Verteidigungslinie (Akzeptanzkriterium 2 / Pruefung 2).
-func (l *Log) Record(ctx context.Context, e Event) error {
-	if e.TenantSlug == "" {
-		return ErrMissingTenant
-	}
-	if e.Actor == "" {
-		return ErrMissingActor
-	}
-	if e.Action == "" {
-		return ErrMissingAction
-	}
-	if e.Metadata == nil {
-		e.Metadata = map[string]any{}
-	}
-	metadataJSON, err := json.Marshal(e.Metadata)
-	if err != nil {
-		return fmt.Errorf("metadaten serialisieren: %w", err)
-	}
-	if e.OccurredAt.IsZero() {
-		e.OccurredAt = time.Now()
-	}
-
-	_, err = l.pool.Exec(ctx, `
-		INSERT INTO audit_events (occurred_at, tenant_slug, actor, action, target, metadata)
-		VALUES ($1, $2, $3, $4, $5, $6)
-	`, e.OccurredAt, e.TenantSlug, e.Actor, e.Action, e.Target, metadataJSON)
-	if err != nil {
-		return fmt.Errorf("audit-ereignis schreiben: %w", err)
-	}
-	return nil
-}
-
-// CountByTenant ist eine schlanke Lesehilfe fuer Tests/Diagnose — die
-// eigentliche Filter-/Export-API ist AUD-03, hier bewusst nicht vorgezogen.
-func (l *Log) CountByTenant(ctx context.Context, tenantSlug string) (int, error) {
-	var n int
-	if err := l.pool.QueryRow(ctx, `
-		SELECT count(*) FROM audit_events WHERE tenant_slug = $1
-	`, tenantSlug).Scan(&n); err != nil {
-		return 0, fmt.Errorf("audit-ereignisse zaehlen: %w", err)
-	}
-	return n, nil
-}

internal/audit/audit_test.go

@@ -1,139 +0,0 @@
-package audit
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"os"
-	"testing"
-	"time"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-func setupAuditTest(t *testing.T) (*Log, *pgxpool.Pool, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS audit_events (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-			occurred_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-			tenant_slug TEXT NOT NULL CHECK (tenant_slug <> ''),
-			actor TEXT NOT NULL CHECK (actor <> ''),
-			action TEXT NOT NULL CHECK (action <> ''),
-			target TEXT NOT NULL,
-			metadata JSONB NOT NULL DEFAULT '{}'::jsonb
-		)`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	cleanup := func() {
-		_, _ = pool.Exec(ctx, `DELETE FROM audit_events WHERE tenant_slug LIKE 'test\_%' ESCAPE '\' OR tenant_slug = $1`, SystemTenant)
-		pool.Close()
-	}
-	return NewLog(pool), pool, cleanup
-}
-
-// Akzeptanzkriterium 1 + Pruefung 1: ein sicherheitsrelevanter Vorgang
-// (hier: fehlgeschlagener Login) erzeugt zuverlaessig genau einen Eintrag.
-func TestRecord_PersistsExactlyOneEventPerSecurityIncident(t *testing.T) {
-	log, pool, cleanup := setupAuditTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	// Seit AUD-02 ist audit_events append-only — Zeilen koennen nie wieder
-	// geloescht werden (auch nicht vom Test-Cleanup). Eindeutiger Slug pro
-	// Lauf, damit wiederholte Testlaeufe die Zaehlung nicht verfaelschen.
-	tenantSlug := "test_acme_" + fmt.Sprint(time.Now().UnixNano())
-
-	err := log.Record(ctx, Event{
-		TenantSlug: tenantSlug,
-		Actor:      "alice@example.com",
-		Action:     "iam.login_failed",
-		Target:     "user:alice@example.com",
-		Metadata:   map[string]any{"reason": "falsches passwort"},
-	})
-	if err != nil {
-		t.Fatalf("record: %v", err)
-	}
-
-	count, err := log.CountByTenant(ctx, tenantSlug)
-	if err != nil {
-		t.Fatalf("count: %v", err)
-	}
-	if count != 1 {
-		t.Fatalf("erwartet genau 1 audit-eintrag, habe %d", count)
-	}
-
-	var actor, action, target string
-	if err := pool.QueryRow(ctx, `
-		SELECT actor, action, target FROM audit_events WHERE tenant_slug = $1
-	`, tenantSlug).Scan(&actor, &action, &target); err != nil {
-		t.Fatalf("eintrag lesen: %v", err)
-	}
-	if actor != "alice@example.com" || action != "iam.login_failed" || target != "user:alice@example.com" {
-		t.Fatalf("eintrag unerwartet: actor=%q action=%q target=%q", actor, action, target)
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 2 (App-Ebene): fehlender Tenant-Bezug wird
-// bereits vom zentralen Schreibpfad abgewiesen.
-func TestRecord_RejectsMissingTenant(t *testing.T) {
-	log, _, cleanup := setupAuditTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	err := log.Record(ctx, Event{TenantSlug: "", Actor: "alice", Action: "irgendwas"})
-	if !errors.Is(err, ErrMissingTenant) {
-		t.Fatalf("erwartet ErrMissingTenant, habe %v", err)
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 2 (DB-Ebene): selbst ein direkter INSERT,
-// der Log.Record umgeht, wird durch die CHECK-Constraint verhindert — der
-// Schutz haengt nicht allein von der Go-Validierung ab.
-func TestConstraint_RejectsMissingTenantAtDatabaseLevel(t *testing.T) {
-	_, pool, cleanup := setupAuditTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	_, err := pool.Exec(ctx, `
-		INSERT INTO audit_events (tenant_slug, actor, action, target)
-		VALUES ('', 'alice', 'irgendwas', 'ziel')
-	`)
-	if err == nil {
-		t.Fatal("erwartet fehler durch CHECK-constraint bei leerem tenant_slug, habe nil")
-	}
-}
-
-func TestRecord_RejectsMissingActorAndAction(t *testing.T) {
-	log, _, cleanup := setupAuditTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if err := log.Record(ctx, Event{TenantSlug: "test_acme", Actor: "", Action: "x"}); !errors.Is(err, ErrMissingActor) {
-		t.Fatalf("erwartet ErrMissingActor, habe %v", err)
-	}
-	if err := log.Record(ctx, Event{TenantSlug: "test_acme", Actor: "alice", Action: ""}); !errors.Is(err, ErrMissingAction) {
-		t.Fatalf("erwartet ErrMissingAction, habe %v", err)
-	}
-}
-
-func TestRecord_SystemTenantForCrossTenantEvents(t *testing.T) {
-	log, _, cleanup := setupAuditTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if err := log.Record(ctx, Event{TenantSlug: SystemTenant, Actor: "superadmin", Action: "tenant.provisioned", Target: "tenant:acme"}); err != nil {
-		t.Fatalf("record mit SystemTenant: %v", err)
-	}
-}

internal/audit/export.go

@@ -1,122 +0,0 @@
-package audit
-
-import (
-	"context"
-	"encoding/csv"
-	"encoding/json"
-	"fmt"
-	"io"
-	"time"
-)
-
-// Filter grenzt einen Export ein (Akzeptanzkriterium 1). Leere/Nil-Felder
-// bedeuten "kein Filter auf diesem Feld".
-type Filter struct {
-	TenantSlug string
-	Actor      string
-	Action     string
-	From       *time.Time
-	To         *time.Time
-}
-
-func buildFilterQuery(f Filter) (string, []any) {
-	query := `SELECT occurred_at, tenant_slug, actor, action, target, metadata FROM audit_events WHERE 1=1`
-	var args []any
-
-	if f.TenantSlug != "" {
-		args = append(args, f.TenantSlug)
-		query += fmt.Sprintf(" AND tenant_slug = $%d", len(args))
-	}
-	if f.Actor != "" {
-		args = append(args, f.Actor)
-		query += fmt.Sprintf(" AND actor = $%d", len(args))
-	}
-	if f.Action != "" {
-		args = append(args, f.Action)
-		query += fmt.Sprintf(" AND action = $%d", len(args))
-	}
-	if f.From != nil {
-		args = append(args, *f.From)
-		query += fmt.Sprintf(" AND occurred_at >= $%d", len(args))
-	}
-	if f.To != nil {
-		args = append(args, *f.To)
-		query += fmt.Sprintf(" AND occurred_at <= $%d", len(args))
-	}
-	query += " ORDER BY occurred_at"
-	return query, args
-}
-
-// StreamCSV schreibt gefilterte Audit-Eintraege direkt als CSV in w, Zeile
-// fuer Zeile ueber rows.Next() — es wird zu keinem Zeitpunkt das gesamte
-// Ergebnis im Speicher aufgebaut (Akzeptanzkriterium 3 / Pruefung 1).
-func (l *Log) StreamCSV(ctx context.Context, filter Filter, w io.Writer) error {
-	query, args := buildFilterQuery(filter)
-	rows, err := l.pool.Query(ctx, query, args...)
-	if err != nil {
-		return fmt.Errorf("export abfragen: %w", err)
-	}
-	defer rows.Close()
-
-	cw := csv.NewWriter(w)
-	if err := cw.Write([]string{"occurred_at", "tenant_slug", "actor", "action", "target", "metadata"}); err != nil {
-		return fmt.Errorf("csv-header schreiben: %w", err)
-	}
-
-	for rows.Next() {
-		var occurredAt time.Time
-		var tenantSlug, actor, action, target string
-		var metadataJSON []byte
-		if err := rows.Scan(&occurredAt, &tenantSlug, &actor, &action, &target, &metadataJSON); err != nil {
-			return fmt.Errorf("zeile lesen: %w", err)
-		}
-		if err := cw.Write([]string{
-			occurredAt.Format(time.RFC3339), tenantSlug, actor, action, target, string(metadataJSON),
-		}); err != nil {
-			return fmt.Errorf("csv-zeile schreiben: %w", err)
-		}
-	}
-	cw.Flush()
-	if err := rows.Err(); err != nil {
-		return fmt.Errorf("export lesen: %w", err)
-	}
-	return cw.Error()
-}
-
-// exportRecord ist die JSON-Repraesentation einer exportierten Zeile.
-type exportRecord struct {
-	OccurredAt time.Time       `json:"occurred_at"`
-	TenantSlug string          `json:"tenant_slug"`
-	Actor      string          `json:"actor"`
-	Action     string          `json:"action"`
-	Target     string          `json:"target"`
-	Metadata   json.RawMessage `json:"metadata"`
-}
-
-// StreamJSON schreibt gefilterte Audit-Eintraege als JSON Lines (ein
-// JSON-Objekt pro Zeile) — bewusst kein einzelnes grosses JSON-Array, da
-// dessen korrektes Streaming (Kommas/Klammern ohne Zwischenpufferung)
-// unnoetige Komplexitaet fuer denselben Zweck waere. Wie StreamCSV
-// zeilenweise ueber rows.Next(), kein Aufbau im Speicher.
-func (l *Log) StreamJSON(ctx context.Context, filter Filter, w io.Writer) error {
-	query, args := buildFilterQuery(filter)
-	rows, err := l.pool.Query(ctx, query, args...)
-	if err != nil {
-		return fmt.Errorf("export abfragen: %w", err)
-	}
-	defer rows.Close()
-
-	enc := json.NewEncoder(w)
-	for rows.Next() {
-		var rec exportRecord
-		var metadataJSON []byte
-		if err := rows.Scan(&rec.OccurredAt, &rec.TenantSlug, &rec.Actor, &rec.Action, &rec.Target, &metadataJSON); err != nil {
-			return fmt.Errorf("zeile lesen: %w", err)
-		}
-		rec.Metadata = metadataJSON
-		if err := enc.Encode(rec); err != nil {
-			return fmt.Errorf("json-zeile schreiben: %w", err)
-		}
-	}
-	return rows.Err()
-}

internal/audit/export_handler.go

@@ -1,73 +0,0 @@
-package audit
-
-import (
-	"context"
-	"net/http"
-	"time"
-)
-
-// Authorize entscheidet, ob caller den Export ausfuehren darf. Die
-// eigentliche Rollen-/Rechtepruefung (RBAC-02 Policy-Enforcement) ist nicht
-// Teil dieser Kachel — ExportHandler kennt nur diese schmale Schnittstelle,
-// analog zum RetentionRegistrar-Muster aus AUD-05.
-type Authorize func(ctx context.Context, caller string) bool
-
-// ExportHandler stellt den Export als HTTP-Endpunkt bereit
-// (Akzeptanzkriterium 2: fuer berechtigte Rollen verfuegbar).
-type ExportHandler struct {
-	log       *Log
-	authorize Authorize
-}
-
-func NewExportHandler(log *Log, authorize Authorize) *ExportHandler {
-	return &ExportHandler{log: log, authorize: authorize}
-}
-
-// Export liest Filter-Query-Parameter (tenant, actor, action, from, to,
-// format) und schreibt DIREKT auf den ResponseWriter (io.Writer) — dieselbe
-// Streaming-Funktion wie in export.go, kein zusaetzlicher Pufferungsschritt.
-func (h *ExportHandler) Export(w http.ResponseWriter, r *http.Request) {
-	// "caller" identifiziert die anfragende Person fuer die Berechtigungs-
-	// pruefung — bewusst getrennt vom Filterfeld "actor" (das den
-	// AUDIT-Akteur meint, ueber den gefiltert wird).
-	caller := r.URL.Query().Get("caller")
-	if caller == "" || !h.authorize(r.Context(), caller) {
-		http.Error(w, "keine berechtigung fuer audit-log-export", http.StatusForbidden)
-		return
-	}
-
-	filter := Filter{
-		TenantSlug: r.URL.Query().Get("tenant"),
-		Actor:      r.URL.Query().Get("actor"),
-		Action:     r.URL.Query().Get("action"),
-	}
-	if from := r.URL.Query().Get("from"); from != "" {
-		t, err := time.Parse(time.RFC3339, from)
-		if err != nil {
-			http.Error(w, "ungueltiges from-datum, erwartet RFC3339", http.StatusBadRequest)
-			return
-		}
-		filter.From = &t
-	}
-	if to := r.URL.Query().Get("to"); to != "" {
-		t, err := time.Parse(time.RFC3339, to)
-		if err != nil {
-			http.Error(w, "ungueltiges to-datum, erwartet RFC3339", http.StatusBadRequest)
-			return
-		}
-		filter.To = &t
-	}
-
-	switch r.URL.Query().Get("format") {
-	case "json":
-		w.Header().Set("Content-Type", "application/x-ndjson")
-		if err := h.log.StreamJSON(r.Context(), filter, w); err != nil {
-			http.Error(w, "export fehlgeschlagen", http.StatusInternalServerError)
-		}
-	default:
-		w.Header().Set("Content-Type", "text/csv")
-		if err := h.log.StreamCSV(r.Context(), filter, w); err != nil {
-			http.Error(w, "export fehlgeschlagen", http.StatusInternalServerError)
-		}
-	}
-}

internal/audit/export_test.go

@@ -1,222 +0,0 @@
-package audit
-
-import (
-	"bytes"
-	"context"
-	"encoding/csv"
-	"fmt"
-	"net/http"
-	"net/http/httptest"
-	"os"
-	"runtime"
-	"strings"
-	"testing"
-	"time"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-func setupExportTest(t *testing.T) (*Log, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS audit_events (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-			occurred_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-			tenant_slug TEXT NOT NULL CHECK (tenant_slug <> ''),
-			actor TEXT NOT NULL CHECK (actor <> ''),
-			action TEXT NOT NULL CHECK (action <> ''),
-			target TEXT NOT NULL,
-			metadata JSONB NOT NULL DEFAULT '{}'::jsonb
-		)`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	cleanup := func() { pool.Close() }
-	return NewLog(pool), cleanup
-}
-
-// Akzeptanzkriterium 1 + Pruefung 2: Filterkombinationen liefern korrekte
-// Teilmengen.
-func TestExport_FilterCombinations(t *testing.T) {
-	log, cleanup := setupExportTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	run := fmt.Sprintf("_%d", time.Now().UnixNano())
-	tenantA, tenantB := "test_fa"+run, "test_fb"+run
-	alice, bob := "alice"+run, "bob"+run
-
-	events := []Event{
-		{TenantSlug: tenantA, Actor: alice, Action: "login", Target: "x"},
-		{TenantSlug: tenantA, Actor: bob, Action: "login", Target: "x"},
-		{TenantSlug: tenantA, Actor: alice, Action: "logout", Target: "x"},
-		{TenantSlug: tenantB, Actor: alice, Action: "login", Target: "x"},
-	}
-	for _, e := range events {
-		if err := log.Record(ctx, e); err != nil {
-			t.Fatalf("record: %v", err)
-		}
-	}
-
-	cases := []struct {
-		name    string
-		filter  Filter
-		wantLen int
-	}{
-		{"nach tenant", Filter{TenantSlug: tenantA}, 3},
-		{"nach tenant+actor", Filter{TenantSlug: tenantA, Actor: alice}, 2},
-		{"nach tenant+actor+action", Filter{TenantSlug: tenantA, Actor: alice, Action: "login"}, 1},
-		{"nach actor ueber beide tenants", Filter{Actor: alice, Action: "login"}, 2},
-	}
-
-	for _, c := range cases {
-		t.Run(c.name, func(t *testing.T) {
-			var buf bytes.Buffer
-			if err := log.StreamCSV(ctx, c.filter, &buf); err != nil {
-				t.Fatalf("stream: %v", err)
-			}
-			rows, err := csv.NewReader(&buf).ReadAll()
-			if err != nil {
-				t.Fatalf("csv parsen: %v", err)
-			}
-			got := len(rows) - 1 // Header abziehen
-			if got != c.wantLen {
-				t.Fatalf("erwartet %d zeilen, habe %d", c.wantLen, got)
-			}
-		})
-	}
-}
-
-// Akzeptanzkriterium 1 + Pruefung 2: Zeitraum-Filter.
-func TestExport_TimeRangeFilter(t *testing.T) {
-	log, cleanup := setupExportTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	tenant := fmt.Sprintf("test_tr_%d", time.Now().UnixNano())
-	past := time.Now().Add(-48 * time.Hour)
-	future := time.Now().Add(48 * time.Hour)
-
-	if err := log.Record(ctx, Event{TenantSlug: tenant, Actor: "a", Action: "x", Target: "t", OccurredAt: time.Now()}); err != nil {
-		t.Fatalf("record: %v", err)
-	}
-
-	var buf bytes.Buffer
-	if err := log.StreamCSV(ctx, Filter{TenantSlug: tenant, From: &past, To: &future}, &buf); err != nil {
-		t.Fatalf("stream (innerhalb range): %v", err)
-	}
-	if got := countLines(buf.String()) - 1; got != 1 {
-		t.Fatalf("erwartet 1 eintrag innerhalb des zeitraums, habe %d", got)
-	}
-
-	farPast := time.Now().Add(-96 * time.Hour)
-	buf.Reset()
-	if err := log.StreamCSV(ctx, Filter{TenantSlug: tenant, From: &farPast, To: &past}, &buf); err != nil {
-		t.Fatalf("stream (ausserhalb range): %v", err)
-	}
-	if got := countLines(buf.String()) - 1; got != 0 {
-		t.Fatalf("erwartet 0 eintraege ausserhalb des zeitraums, habe %d", got)
-	}
-}
-
-func countLines(s string) int {
-	s = strings.TrimRight(s, "\n")
-	if s == "" {
-		return 0
-	}
-	return len(strings.Split(s, "\n"))
-}
-
-// Akzeptanzkriterium 3 + Pruefung 1: Export mit hoher Eintragszahl ohne
-// uebermaessigen Speicherverbrauch — Stichprobe per runtime.MemStats.
-func TestExport_StreamsLargeResultWithoutExcessiveMemory(t *testing.T) {
-	log, cleanup := setupExportTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	tenant := fmt.Sprintf("test_large_%d", time.Now().UnixNano())
-	const n = 20000
-	for i := 0; i < n; i++ {
-		if err := log.Record(ctx, Event{TenantSlug: tenant, Actor: "bulk", Action: "test.bulk", Target: fmt.Sprintf("obj-%d", i)}); err != nil {
-			t.Fatalf("record %d: %v", i, err)
-		}
-	}
-
-	runtime.GC()
-	var before runtime.MemStats
-	runtime.ReadMemStats(&before)
-
-	lineCount := 0
-	cw := &countingWriter{onWrite: func(p []byte) { lineCount += strings.Count(string(p), "\n") }}
-	if err := log.StreamCSV(ctx, Filter{TenantSlug: tenant}, cw); err != nil {
-		t.Fatalf("stream: %v", err)
-	}
-
-	runtime.GC()
-	var after runtime.MemStats
-	runtime.ReadMemStats(&after)
-
-	if lineCount != n+1 { // +1 Header
-		t.Fatalf("erwartet %d zeilen (inkl. header), habe %d", n+1, lineCount)
-	}
-
-	// Grobe Stichprobe: ein NICHT streamender Export haette hier locker
-	// mehrere MB an einmal gehaltenen Zeilen/Strings erzeugt. Grosszuegige
-	// Schwelle, da Go-Heap-Messungen naturgemaess rauschen.
-	const maxAcceptableGrowth = 3 * 1024 * 1024 // 3 MB
-	growth := int64(after.HeapAlloc) - int64(before.HeapAlloc)
-	t.Logf("heap-wachstum waehrend export von %d zeilen: %d bytes (schwelle: %d)", n, growth, maxAcceptableGrowth)
-	if growth > maxAcceptableGrowth {
-		t.Fatalf("heap ist um %d bytes gewachsen, erwartet unter %d (hinweis auf vollstaendige pufferung statt streaming)", growth, maxAcceptableGrowth)
-	}
-}
-
-type countingWriter struct {
-	onWrite func(p []byte)
-}
-
-func (w *countingWriter) Write(p []byte) (int, error) {
-	w.onWrite(p)
-	return len(p), nil
-}
-
-// Akzeptanzkriterium 2 + Pruefung 3: Zugriff ohne passende Berechtigung wird abgewiesen.
-func TestExportHandler_RejectsWithoutAuthorization(t *testing.T) {
-	log, cleanup := setupExportTest(t)
-	defer cleanup()
-
-	handler := NewExportHandler(log, func(ctx context.Context, caller string) bool {
-		return caller == "berechtigte-person@example.com"
-	})
-
-	req := httptest.NewRequest(http.MethodGet, "/audit/export?caller=unberechtigt@example.com", nil)
-	rec := httptest.NewRecorder()
-	handler.Export(rec, req)
-	if rec.Code != http.StatusForbidden {
-		t.Fatalf("unberechtigt: status = %d, want 403", rec.Code)
-	}
-
-	reqNoCaller := httptest.NewRequest(http.MethodGet, "/audit/export", nil)
-	recNoCaller := httptest.NewRecorder()
-	handler.Export(recNoCaller, reqNoCaller)
-	if recNoCaller.Code != http.StatusForbidden {
-		t.Fatalf("ohne caller: status = %d, want 403", recNoCaller.Code)
-	}
-
-	reqOK := httptest.NewRequest(http.MethodGet, "/audit/export?caller=berechtigte-person@example.com", nil)
-	recOK := httptest.NewRecorder()
-	handler.Export(recOK, reqOK)
-	if recOK.Code != http.StatusOK {
-		t.Fatalf("berechtigt: status = %d, want 200", recOK.Code)
-	}
-}

internal/audit/four_eyes.go

@@ -1,120 +0,0 @@
-package audit
-
-import (
-	"context"
-	"crypto/rand"
-	"crypto/sha256"
-	"encoding/hex"
-	"errors"
-	"fmt"
-
-	"github.com/jackc/pgx/v5"
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-var (
-	ErrConfirmationNotFound = errors.New("audit: bestaetigungsvorgang nicht gefunden")
-	ErrAlreadyDecided       = errors.New("audit: bestaetigungsvorgang wurde bereits entschieden")
-	ErrSameActor            = errors.New("audit: bestaetigung muss von einer anderen person als der anfordernden erfolgen")
-	ErrInvalidCode          = errors.New("audit: bestaetigungscode ungueltig")
-)
-
-type ConfirmationStatus string
-
-const (
-	StatusPending   ConfirmationStatus = "pending"
-	StatusConfirmed ConfirmationStatus = "confirmed"
-)
-
-// FourEyes implementiert das Vier-Augen-Prinzip fuer sicherheitskritische
-// Entscheidungen (Akzeptanzkriterium 2) nach dem archivdms-Vorbild:
-// FOR-UPDATE-Lock gegen Race-Bedingungen bei paralleler Bestaetigung,
-// Timing-safe Vergleich des Bestaetigungscodes (Akzeptanzkriterium 3).
-type FourEyes struct {
-	pool *pgxpool.Pool
-}
-
-func NewFourEyes(pool *pgxpool.Pool) *FourEyes {
-	return &FourEyes{pool: pool}
-}
-
-// Request legt einen neuen, zu bestaetigenden Vorgang an (z.B. Loeschbestaetigung,
-// Rechtevergabe) und liefert einen einmaligen Klartext-Code, der ausserhalb
-// dieses Systems (z.B. per E-Mail) an eine ZWEITE Person uebermittelt wird —
-// niemals der anfordernden Person selbst.
-func (f *FourEyes) Request(ctx context.Context, action, target, requestedBy string) (id, code string, err error) {
-	code, err = generateCode()
-	if err != nil {
-		return "", "", fmt.Errorf("bestaetigungscode erzeugen: %w", err)
-	}
-	hash := hashCode(code)
-
-	err = f.pool.QueryRow(ctx, `
-		INSERT INTO security_confirmations (action, target, requested_by, code_hash, status)
-		VALUES ($1, $2, $3, $4, 'pending')
-		RETURNING id
-	`, action, target, requestedBy, hash).Scan(&id)
-	if err != nil {
-		return "", "", fmt.Errorf("bestaetigungsvorgang anlegen: %w", err)
-	}
-	return id, code, nil
-}
-
-// Confirm bestaetigt einen Vorgang. confirmedBy MUSS sich von der
-// anfordernden Person unterscheiden (echtes Vier-Augen-Prinzip). Der Zugriff
-// auf die Zeile erfolgt mit FOR UPDATE, damit zwei gleichzeitige
-// Bestaetigungsversuche serialisiert werden und niemals beide durchgehen
-// (Akzeptanzkriterium 2 / Pruefung 2).
-func (f *FourEyes) Confirm(ctx context.Context, id, confirmedBy, code string) error {
-	tx, err := f.pool.Begin(ctx)
-	if err != nil {
-		return fmt.Errorf("transaktion starten: %w", err)
-	}
-	defer func() { _ = tx.Rollback(ctx) }()
-
-	var requestedBy, status string
-	var codeHash []byte
-	err = tx.QueryRow(ctx, `
-		SELECT requested_by, status, code_hash FROM security_confirmations
-		WHERE id = $1 FOR UPDATE
-	`, id).Scan(&requestedBy, &status, &codeHash)
-	if err != nil {
-		if errors.Is(err, pgx.ErrNoRows) {
-			return ErrConfirmationNotFound
-		}
-		return fmt.Errorf("bestaetigungsvorgang lesen: %w", err)
-	}
-
-	if status != string(StatusPending) {
-		return ErrAlreadyDecided
-	}
-	if confirmedBy == requestedBy {
-		return ErrSameActor
-	}
-	if !timingSafeEqual(hashCode(code), codeHash) {
-		return ErrInvalidCode
-	}
-
-	if _, err := tx.Exec(ctx, `
-		UPDATE security_confirmations
-		SET status = 'confirmed', confirmed_by = $2, confirmed_at = now()
-		WHERE id = $1
-	`, id, confirmedBy); err != nil {
-		return fmt.Errorf("bestaetigung speichern: %w", err)
-	}
-
-	return tx.Commit(ctx)
-}
-
-func generateCode() (string, error) {
-	buf := make([]byte, 16)
-	if _, err := rand.Read(buf); err != nil {
-		return "", err
-	}
-	return hex.EncodeToString(buf), nil
-}
-
-func hashCode(code string) []byte {
-	sum := sha256.Sum256([]byte(code))
-	return sum[:]
-}

internal/audit/four_eyes_test.go

@@ -1,128 +0,0 @@
-package audit
-
-import (
-	"context"
-	"errors"
-	"os"
-	"sync"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-func setupFourEyesTest(t *testing.T) (*FourEyes, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS security_confirmations (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-			action TEXT NOT NULL,
-			target TEXT NOT NULL,
-			requested_by TEXT NOT NULL,
-			code_hash BYTEA NOT NULL,
-			status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'confirmed', 'rejected')),
-			confirmed_by TEXT,
-			created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-			confirmed_at TIMESTAMPTZ
-		)`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	cleanup := func() {
-		_, _ = pool.Exec(ctx, `DELETE FROM security_confirmations WHERE action LIKE 'test.%'`)
-		pool.Close()
-	}
-	return NewFourEyes(pool), cleanup
-}
-
-func TestFourEyes_RequestAndConfirm(t *testing.T) {
-	fe, cleanup := setupFourEyesTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	id, code, err := fe.Request(ctx, "test.tenant_delete", "tenant:acme", "alice@example.com")
-	if err != nil {
-		t.Fatalf("request: %v", err)
-	}
-
-	if err := fe.Confirm(ctx, id, "bob@example.com", code); err != nil {
-		t.Fatalf("confirm: %v", err)
-	}
-}
-
-func TestFourEyes_RejectsSameActor(t *testing.T) {
-	fe, cleanup := setupFourEyesTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	id, code, err := fe.Request(ctx, "test.tenant_delete", "tenant:acme", "alice@example.com")
-	if err != nil {
-		t.Fatalf("request: %v", err)
-	}
-
-	if err := fe.Confirm(ctx, id, "alice@example.com", code); !errors.Is(err, ErrSameActor) {
-		t.Fatalf("erwartet ErrSameActor, habe %v", err)
-	}
-}
-
-func TestFourEyes_RejectsWrongCode(t *testing.T) {
-	fe, cleanup := setupFourEyesTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	id, _, err := fe.Request(ctx, "test.tenant_delete", "tenant:acme", "alice@example.com")
-	if err != nil {
-		t.Fatalf("request: %v", err)
-	}
-
-	if err := fe.Confirm(ctx, id, "bob@example.com", "falscher-code"); !errors.Is(err, ErrInvalidCode) {
-		t.Fatalf("erwartet ErrInvalidCode, habe %v", err)
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 2: FOR-UPDATE-Lock unter parallelen
-// Anfragen race-frei — von zwei gleichzeitigen Bestaetigungsversuchen fuer
-// denselben Vorgang darf genau einer durchgehen.
-func TestFourEyes_ConcurrentConfirmIsRaceFree(t *testing.T) {
-	fe, cleanup := setupFourEyesTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	id, code, err := fe.Request(ctx, "test.tenant_delete", "tenant:acme", "alice@example.com")
-	if err != nil {
-		t.Fatalf("request: %v", err)
-	}
-
-	var wg sync.WaitGroup
-	results := make([]error, 2)
-	confirmers := []string{"bob@example.com", "carol@example.com"}
-	for i := 0; i < 2; i++ {
-		wg.Add(1)
-		go func(i int) {
-			defer wg.Done()
-			results[i] = fe.Confirm(ctx, id, confirmers[i], code)
-		}(i)
-	}
-	wg.Wait()
-
-	successCount := 0
-	for _, err := range results {
-		if err == nil {
-			successCount++
-		} else if !errors.Is(err, ErrAlreadyDecided) {
-			t.Fatalf("unerwarteter fehler: %v", err)
-		}
-	}
-	if successCount != 1 {
-		t.Fatalf("erwartet genau eine erfolgreiche bestaetigung, habe %d", successCount)
-	}
-}