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
FDN-09: verschluesselung at rest & schluesselverwaltung
2026-08-29 22:23:36 +02:00 · 2026-08-29 22:13:49 +02:00 · 2026-08-29 20:58:26 +02:00 · 2026-08-29 20:33:35 +02:00 · 2026-08-29 19:22:54 +02:00 · 2026-08-29 19:07:02 +02:00
130 changed files with 4085 additions and 5002 deletions
@@ -1,4 +1,2 @@
 *.log
 .env
-web/*/node_modules/
-web/*/.next/
@@ -44,158 +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-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 ++++++++++
- 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
- 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
- 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 +++++++++++++++++++++
-
---
@@ -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,38 +15,16 @@ func main() {
 		log.Fatalf("config: %v", err)
 	}

-	ctx := context.Background()
-
-	registryPool, err := db.Connect(ctx, cfg.RegistryDSN)
+	pool, err := db.Connect(context.Background(), cfg.RegistryDSN)
 	if err != nil {
-		log.Fatalf("registry db: %v", err)
+		log.Fatalf("db: %v", err)
 	}
-	defer registryPool.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)
-
-	// 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)
+	defer pool.Close()

 	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/superadmins", userHandler.CreateSuperadmin)

 	log.Printf("nexarch-core listening on %s", cfg.ListenAddr)
 	if err := http.ListenAndServe(cfg.ListenAddr, mux); err != nil {
@@ -0,0 +1,18 @@
+version: "2"
+
+run:
+  timeout: 3m
+
+linters:
+  default: none
+  enable:
+    - govet
+    - staticcheck
+    - errcheck
+    - unused
+    - ineffassign
+
+formatters:
+  enable:
+    - gofmt
+    - goimports
@@ -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
@@ -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.
@@ -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)
+	}
+}
@@ -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())
+	}
+}
@@ -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.
+		}
+	}
+}
@@ -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).
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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
+)
@@ -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=
@@ -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
+}
@@ -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)
+	}
+}
@@ -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
+}
@@ -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")
+	}
+}
@@ -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)
+}
@@ -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)
+	}
+}
@@ -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
+}
@@ -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)
+	}
+}
@@ -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)
+}
@@ -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)
+	}
+}
@@ -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
+}
@@ -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")
+		}
+	})
+}
@@ -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"
@@ -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
+}
@@ -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
+}
@@ -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")
+}
@@ -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
+}
@@ -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")
+	}
+}
@@ -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)
+}
@@ -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")
+	}
+}
@@ -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
+}
@@ -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")
+	}
+}
@@ -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
+}
@@ -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))
+	}
+}
@@ -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
+}
@@ -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
+}
@@ -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
+}
@@ -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;
@@ -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);
@@ -0,0 +1 @@
+DROP TABLE IF EXISTS processing_jobs;
@@ -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);
@@ -0,0 +1 @@
+DROP TABLE IF EXISTS upload_sessions;
@@ -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()
+);
@@ -0,0 +1 @@
+ALTER TABLE file_revisions DROP COLUMN IF EXISTS wrapped_dek;
@@ -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;
@@ -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 $$;
@@ -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."
@@ -2,16 +2,4 @@ module gitea.perlbach24.de/scripte/nexarch

 go 1.22

-require (
-	github.com/golang-jwt/jwt/v5 v5.3.1
-	github.com/jackc/pgx/v5 v5.6.0
-	golang.org/x/crypto v0.17.0
-)
-
-require (
-	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/sync v0.1.0 // indirect
-	golang.org/x/text v0.14.0 // indirect
-)
+require github.com/jackc/pgx/v5 v5.6.0
@@ -1,30 +0,0 @@
-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/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=
@@ -1,67 +0,0 @@
-package auth
-
-import (
-	"encoding/json"
-	"net/http"
-	"time"
-)
-
-// Handler stellt Login/Logout als HTTP-Endpunkte bereit. Registrierung,
-// Passwort-Reset, 2FA, SSO/LDAP und Rate-Limiting sind ausdruecklich nicht
-// Teil dieser Kachel (siehe IAM-03..07).
-type Handler struct {
-	login *LoginService
-}
-
-func NewHandler(login *LoginService) *Handler {
-	return &Handler{login: login}
-}
-
-type loginRequest struct {
-	Email    string `json:"email"`
-	Password string `json:"password"`
-}
-
-func (h *Handler) Login(w http.ResponseWriter, r *http.Request) {
-	var req loginRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-
-	token, err := h.login.Login(r.Context(), req.Email, req.Password)
-	if err != nil {
-		http.Error(w, ErrInvalidCredentials.Error(), http.StatusUnauthorized)
-		return
-	}
-
-	http.SetCookie(w, &http.Cookie{
-		Name:     CookieName,
-		Value:    token,
-		Path:     "/",
-		HttpOnly: true,
-		Secure:   true,
-		SameSite: http.SameSiteStrictMode,
-		MaxAge:   int(AccessTokenTTL.Seconds()),
-	})
-	w.WriteHeader(http.StatusOK)
-}
-
-// Logout loescht das Session-Cookie. Da JWT hier bewusst zustandslos bleibt
-// (kein serverseitiger Blocklist-Speicher — das waere ueber "Grundgerüst"
-// hinaus und widerspraeche der projektweiten zustandslosen-JWT-Entscheidung),
-// bleibt ein bereits ausgestelltes Token bis zu seinem Ablauf technisch
-// gueltig, wenn es separat vom Cookie extrahiert und wiederverwendet wird.
-func (h *Handler) Logout(w http.ResponseWriter, r *http.Request) {
-	http.SetCookie(w, &http.Cookie{
-		Name:     CookieName,
-		Value:    "",
-		Path:     "/",
-		HttpOnly: true,
-		Secure:   true,
-		SameSite: http.SameSiteStrictMode,
-		MaxAge:   -1,
-		Expires:  time.Unix(0, 0),
-	})
-	w.WriteHeader(http.StatusOK)
-}
@@ -1,56 +0,0 @@
-package auth
-
-import (
-	"context"
-	"errors"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-var ErrInvalidCredentials = errors.New("auth: E-Mail oder Passwort falsch")
-
-// LoginService arbeitet gegen GENAU EINE Tenant-Datenbank (uebergeben ueber
-// den TenantUserStore-Pool) — das Login ist damit strukturell auf den
-// richtigen Tenant gescopt, siehe user.TenantUserStore.GetByEmailForAuth.
-type LoginService struct {
-	users  *user.TenantUserStore
-	issuer *TokenIssuer
-	// tenantSlug identifiziert im ausgestellten Token, gegen welchen Mandanten
-	// eingeloggt wurde (fuer nachgelagerte Pruefungen, z.B. Middleware-Logs).
-	tenantSlug string
-}
-
-func NewLoginService(users *user.TenantUserStore, issuer *TokenIssuer, tenantSlug string) *LoginService {
-	return &LoginService{users: users, issuer: issuer, tenantSlug: tenantSlug}
-}
-
-// Login liefert bei falscher E-Mail UND bei falschem Passwort denselben
-// Fehler (ErrInvalidCredentials), um keine Rueckschluesse auf die Existenz
-// eines Kontos zuzulassen (User-Enumeration-Schutz).
-func (s *LoginService) Login(ctx context.Context, email, password string) (string, error) {
-	creds, err := s.users.GetByEmailForAuth(ctx, email)
-	if err != nil {
-		// Trotzdem einen bcrypt-Vergleich gegen einen Dummy-Hash ausfuehren,
-		// damit die Antwortzeit bei unbekannter E-Mail nicht messbar kuerzer
-		// ist als bei falschem Passwort (Timing-Seitenkanal).
-		VerifyPassword(dummyHash, password)
-		return "", ErrInvalidCredentials
-	}
-
-	if creds.User.Status != user.StatusActive {
-		return "", ErrInvalidCredentials
-	}
-
-	if !VerifyPassword(creds.PasswordHash, password) {
-		return "", ErrInvalidCredentials
-	}
-
-	return s.issuer.Issue(creds.User.ID, s.tenantSlug)
-}
-
-// dummyHash ist ein echter bcrypt-Hash (Kostenfaktor BcryptCost) eines
-// beliebigen Platzhalter-Klartexts — bewusst KEIN kaputtes Format, da
-// bcrypt.CompareHashAndPassword bei ungueltigem Hash sofort ohne den
-// eigentlichen Kostenfaktor-Vergleich zurueckkehrt und die
-// Timing-Angleichung damit wirkungslos waere.
-const dummyHash = "$2a$12$cmwiETrG9DK5/uTM2fg4uetngYUspKjME5P8fNpk0QYTaO64N0r3C"
@@ -1,177 +0,0 @@
-package auth
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"net/http"
-	"net/http/httptest"
-	"os"
-	"strings"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-const usersSchema = `
-CREATE EXTENSION IF NOT EXISTS pgcrypto;
-CREATE TABLE users (
-	id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-	email TEXT NOT NULL UNIQUE,
-	name TEXT NOT NULL,
-	status TEXT NOT NULL DEFAULT 'active',
-	password_hash TEXT NOT NULL DEFAULT '',
-	created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-	updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);`
-
-func setupTenantDB(t *testing.T, dbName string) *pgxpool.Pool {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	adminPool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("admin pool: %v", err)
-	}
-	_, _ = adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-	if _, err := adminPool.Exec(ctx, fmt.Sprintf(`CREATE DATABASE %q`, dbName)); err != nil {
-		t.Fatalf("testdatenbank anlegen: %v", err)
-	}
-
-	dsn := strings.Replace(adminDSN, "/postgres?", "/"+dbName+"?", 1)
-	pool, err := pgxpool.New(ctx, dsn)
-	if err != nil {
-		t.Fatalf("connect testdatenbank: %v", err)
-	}
-	if _, err := pool.Exec(ctx, usersSchema); err != nil {
-		t.Fatalf("schema anwenden: %v", err)
-	}
-
-	t.Cleanup(func() {
-		pool.Close()
-		_, _ = adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-		adminPool.Close()
-	})
-	return pool
-}
-
-func createUserWithPassword(t *testing.T, store *user.TenantUserStore, email, password string) user.User {
-	t.Helper()
-	ctx := context.Background()
-	u, err := store.Create(ctx, email, "Test User")
-	if err != nil {
-		t.Fatalf("create user: %v", err)
-	}
-	hash, err := HashPassword(password)
-	if err != nil {
-		t.Fatalf("hash password: %v", err)
-	}
-	if err := store.SetPasswordHash(ctx, u.ID, hash); err != nil {
-		t.Fatalf("set password: %v", err)
-	}
-	return u
-}
-
-func TestLoginService_SuccessAndWrongPassword(t *testing.T) {
-	pool := setupTenantDB(t, "test_iam02_login")
-	store := user.NewTenantUserStore(pool)
-	createUserWithPassword(t, store, "alice@example.com", "korrektes-passwort")
-
-	issuer := NewTokenIssuer("test-secret-nur-fuer-tests")
-	login := NewLoginService(store, issuer, "acme")
-
-	token, err := login.Login(context.Background(), "alice@example.com", "korrektes-passwort")
-	if err != nil {
-		t.Fatalf("login: %v", err)
-	}
-	if token == "" {
-		t.Fatal("erwartet nicht-leeres token")
-	}
-
-	if _, err := login.Login(context.Background(), "alice@example.com", "falsches-passwort"); !errors.Is(err, ErrInvalidCredentials) {
-		t.Fatalf("erwartet ErrInvalidCredentials, habe %v", err)
-	}
-
-	if _, err := login.Login(context.Background(), "unbekannt@example.com", "irgendwas"); !errors.Is(err, ErrInvalidCredentials) {
-		t.Fatalf("erwartet ErrInvalidCredentials bei unbekannter email, habe %v", err)
-	}
-}
-
-// Pruefung 1: kein Cross-Tenant-Login moeglich, obwohl dieselbe E-Mail in
-// zwei unterschiedlichen Tenant-Datenbanken mit unterschiedlichen Passwoertern
-// existiert.
-func TestLoginService_NoCrossTenantLogin(t *testing.T) {
-	poolA := setupTenantDB(t, "test_iam02_tenant_a")
-	poolB := setupTenantDB(t, "test_iam02_tenant_b")
-
-	storeA := user.NewTenantUserStore(poolA)
-	storeB := user.NewTenantUserStore(poolB)
-	createUserWithPassword(t, storeA, "shared@example.com", "passwort-tenant-a")
-	createUserWithPassword(t, storeB, "shared@example.com", "passwort-tenant-b")
-
-	issuer := NewTokenIssuer("test-secret-nur-fuer-tests")
-	loginA := NewLoginService(storeA, issuer, "tenant-a")
-
-	// Login gegen Tenant A mit dem Passwort von Tenant B darf nicht klappen,
-	// obwohl die E-Mail-Adresse identisch ist — die Store-Instanz kennt
-	// strukturell nur die Zeilen ihrer eigenen Datenbank.
-	if _, err := loginA.Login(context.Background(), "shared@example.com", "passwort-tenant-b"); !errors.Is(err, ErrInvalidCredentials) {
-		t.Fatalf("erwartet ErrInvalidCredentials fuer fremdes tenant-passwort, habe %v", err)
-	}
-
-	token, err := loginA.Login(context.Background(), "shared@example.com", "passwort-tenant-a")
-	if err != nil {
-		t.Fatalf("login gegen eigenen tenant sollte klappen: %v", err)
-	}
-	claims, err := issuer.Verify(token)
-	if err != nil {
-		t.Fatalf("verify: %v", err)
-	}
-	if claims.TenantSlug != "tenant-a" {
-		t.Fatalf("token tenant = %q, want tenant-a", claims.TenantSlug)
-	}
-}
-
-// Akzeptanzkriterium 3: geschuetzte Route ohne gueltige Session nicht erreichbar.
-func TestRequireAuth_BlocksWithoutValidCookie(t *testing.T) {
-	issuer := NewTokenIssuer("test-secret-nur-fuer-tests")
-	protected := RequireAuth(issuer, func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(http.StatusOK)
-	})
-
-	// Kein Cookie.
-	req := httptest.NewRequest(http.MethodGet, "/geschuetzt", nil)
-	rec := httptest.NewRecorder()
-	protected(rec, req)
-	if rec.Code != http.StatusUnauthorized {
-		t.Fatalf("ohne cookie: status = %d, want 401", rec.Code)
-	}
-
-	// Manipuliertes Cookie.
-	req = httptest.NewRequest(http.MethodGet, "/geschuetzt", nil)
-	req.AddCookie(&http.Cookie{Name: CookieName, Value: "kaputt.token.hier"})
-	rec = httptest.NewRecorder()
-	protected(rec, req)
-	if rec.Code != http.StatusUnauthorized {
-		t.Fatalf("mit kaputtem cookie: status = %d, want 401", rec.Code)
-	}
-
-	// Gueltiges Token.
-	token, err := issuer.Issue("user-1", "acme")
-	if err != nil {
-		t.Fatalf("issue: %v", err)
-	}
-	req = httptest.NewRequest(http.MethodGet, "/geschuetzt", nil)
-	req.AddCookie(&http.Cookie{Name: CookieName, Value: token})
-	rec = httptest.NewRecorder()
-	protected(rec, req)
-	if rec.Code != http.StatusOK {
-		t.Fatalf("mit gueltigem cookie: status = %d, want 200", rec.Code)
-	}
-}
@@ -1,41 +0,0 @@
-package auth
-
-import (
-	"context"
-	"net/http"
-)
-
-const CookieName = "nexarch_session"
-
-type contextKey int
-
-const claimsContextKey contextKey = iota
-
-// RequireAuth schuetzt eine Route: ohne gueltiges, nicht abgelaufenes Token
-// im Session-Cookie wird 401 zurueckgegeben und der Handler nicht aufgerufen
-// (IAM-02 Akzeptanzkriterium 3).
-func RequireAuth(issuer *TokenIssuer, next http.HandlerFunc) http.HandlerFunc {
-	return func(w http.ResponseWriter, r *http.Request) {
-		cookie, err := r.Cookie(CookieName)
-		if err != nil {
-			http.Error(w, "nicht angemeldet", http.StatusUnauthorized)
-			return
-		}
-
-		claims, err := issuer.Verify(cookie.Value)
-		if err != nil {
-			http.Error(w, "nicht angemeldet", http.StatusUnauthorized)
-			return
-		}
-
-		ctx := context.WithValue(r.Context(), claimsContextKey, claims)
-		next(w, r.WithContext(ctx))
-	}
-}
-
-// ClaimsFromContext liest die Claims, die RequireAuth in den Request-Context
-// gelegt hat.
-func ClaimsFromContext(ctx context.Context) (*Claims, bool) {
-	c, ok := ctx.Value(claimsContextKey).(*Claims)
-	return c, ok
-}
@@ -1,28 +0,0 @@
-// Package auth implementiert Core IAM-02: Login/Logout, Passwort-Hashing und
-// die Middleware zum Schutz von Routen. Autorisierung (was ein Benutzer darf)
-// ist ausdruecklich NICHT Teil dieses Pakets, siehe RBAC-01 — auth prueft nur
-// "wer bin ich" (Casbin-Architekturprinzip, siehe IAM-02-Ticket).
-package auth
-
-import "golang.org/x/crypto/bcrypt"
-
-// BcryptCost ist bewusst explizit festgelegt statt bcrypt.DefaultCost (10)
-// unreflektiert zu uebernehmen (IAM-02 Akzeptanzkriterium 4). Kostenfaktor 12
-// wurde gegen die Ziel-Login-Latenz benchmarkt, siehe password_bench_test.go
-// und den Pruefungs-Eintrag in der Commit-Nachricht.
-const BcryptCost = 12
-
-func HashPassword(plain string) (string, error) {
-	hash, err := bcrypt.GenerateFromPassword([]byte(plain), BcryptCost)
-	if err != nil {
-		return "", err
-	}
-	return string(hash), nil
-}
-
-// VerifyPassword ist timing-safe: bcrypt.CompareHashAndPassword vergleicht
-// konstant in der Zeit bzgl. des Hash-Inhalts (Referenzimplementierung fuer
-// die projektweite Timing-safe-Vergleich-Konvention aus IAM-02).
-func VerifyPassword(hash, plain string) bool {
-	return bcrypt.CompareHashAndPassword([]byte(hash), []byte(plain)) == nil
-}
@@ -1,42 +0,0 @@
-package auth
-
-import (
-	"testing"
-	"time"
-)
-
-// TargetLoginLatency ist der Zielwert aus IAM-02 Akzeptanzkriterium 4: der
-// bcrypt-Vergleich allein darf die Login-Latenz nicht dominieren. 400ms ist
-// grosszuegig genug, um auf unterschiedlicher Hardware stabil zu sein, aber
-// eng genug, um eine versehentliche Kostenfaktor-Explosion (z.B. 16 statt 12)
-// zuverlaessig aufzudecken.
-const TargetLoginLatency = 400 * time.Millisecond
-
-// TestBcryptCostAgainstLatencyTarget misst die tatsaechliche Dauer eines
-// Passwort-Vergleichs mit dem festgelegten BcryptCost und dokumentiert das
-// Ergebnis (IAM-02 Pruefung 4).
-func TestBcryptCostAgainstLatencyTarget(t *testing.T) {
-	hash, err := HashPassword("benchmark-passwort")
-	if err != nil {
-		t.Fatalf("hash: %v", err)
-	}
-
-	start := time.Now()
-	if !VerifyPassword(hash, "benchmark-passwort") {
-		t.Fatal("verifikation haette erfolgreich sein muessen")
-	}
-	elapsed := time.Since(start)
-
-	t.Logf("bcrypt-vergleich mit cost=%d dauerte %s (ziel: unter %s)", BcryptCost, elapsed, TargetLoginLatency)
-	if elapsed > TargetLoginLatency {
-		t.Fatalf("bcrypt-vergleich zu langsam: %s > ziel %s", elapsed, TargetLoginLatency)
-	}
-}
-
-func BenchmarkVerifyPassword(b *testing.B) {
-	hash, _ := HashPassword("benchmark-passwort")
-	b.ResetTimer()
-	for i := 0; i < b.N; i++ {
-		VerifyPassword(hash, "benchmark-passwort")
-	}
-}
@@ -1,28 +0,0 @@
-package auth
-
-import "testing"
-
-func TestHashAndVerifyPassword(t *testing.T) {
-	hash, err := HashPassword("s3hr-geheim!")
-	if err != nil {
-		t.Fatalf("hash: %v", err)
-	}
-	if hash == "s3hr-geheim!" {
-		t.Fatal("passwort wurde nicht gehasht")
-	}
-	if !VerifyPassword(hash, "s3hr-geheim!") {
-		t.Fatal("erwartet erfolgreiche verifikation")
-	}
-	if VerifyPassword(hash, "falsches-passwort") {
-		t.Fatal("erwartet fehlgeschlagene verifikation")
-	}
-}
-
-func TestDummyHashIsValidBcryptHash(t *testing.T) {
-	// Stellt sicher, dass der Timing-Angleichs-Hash in login.go tatsaechlich
-	// ein gueltiges bcrypt-Format hat und den vollen Kostenfaktor durchlaeuft
-	// (siehe Kommentar dort) statt sofort mit einem Format-Fehler abzubrechen.
-	if VerifyPassword(dummyHash, "irgendein-text") {
-		t.Fatal("dummyHash sollte fuer beliebigen text nicht passen")
-	}
-}
@@ -1,63 +0,0 @@
-package auth
-
-import (
-	"errors"
-	"time"
-
-	"github.com/golang-jwt/jwt/v5"
-)
-
-// AccessTokenTTL ist bewusst kurz gehalten (Session-Ablauf statt langlebiger
-// Tokens), passend zur "so vertrauenswuerdig wie noetig"-Produkt-DNA.
-const AccessTokenTTL = 30 * time.Minute
-
-var ErrInvalidToken = errors.New("auth: ungueltiges oder abgelaufenes token")
-
-type Claims struct {
-	UserID     string `json:"uid"`
-	TenantSlug string `json:"tenant"`
-	jwt.RegisteredClaims
-}
-
-// TokenIssuer signiert/verifiziert JWTs mit einem HMAC-Secret. Das
-// asymmetrische Core-weite Signaturschema (API-05, kid-Rotation) ist
-// ausdruecklich nicht Teil dieser Kachel — hier geht es nur um das
-// Login-Grundgerüst innerhalb eines einzelnen Core-Prozesses.
-type TokenIssuer struct {
-	secret []byte
-}
-
-func NewTokenIssuer(secret string) *TokenIssuer {
-	return &TokenIssuer{secret: []byte(secret)}
-}
-
-func (i *TokenIssuer) Issue(userID, tenantSlug string) (string, error) {
-	now := time.Now()
-	claims := Claims{
-		UserID:     userID,
-		TenantSlug: tenantSlug,
-		RegisteredClaims: jwt.RegisteredClaims{
-			IssuedAt:  jwt.NewNumericDate(now),
-			ExpiresAt: jwt.NewNumericDate(now.Add(AccessTokenTTL)),
-		},
-	}
-	token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
-	return token.SignedString(i.secret)
-}
-
-// Verify prueft Signatur UND Ablauf (jwt.ParseWithClaims lehnt abgelaufene
-// Tokens automatisch ab) — der Signaturvergleich in golang-jwt ist
-// timing-safe (hmac.Equal).
-func (i *TokenIssuer) Verify(tokenString string) (*Claims, error) {
-	claims := &Claims{}
-	token, err := jwt.ParseWithClaims(tokenString, claims, func(t *jwt.Token) (interface{}, error) {
-		if _, ok := t.Method.(*jwt.SigningMethodHMAC); !ok {
-			return nil, ErrInvalidToken
-		}
-		return i.secret, nil
-	})
-	if err != nil || !token.Valid {
-		return nil, ErrInvalidToken
-	}
-	return claims, nil
-}
@@ -1,82 +0,0 @@
-package auth
-
-import (
-	"strings"
-	"testing"
-	"time"
-
-	"github.com/golang-jwt/jwt/v5"
-)
-
-func TestTokenIssueAndVerify(t *testing.T) {
-	issuer := NewTokenIssuer("test-secret-nur-fuer-tests")
-
-	token, err := issuer.Issue("user-1", "acme")
-	if err != nil {
-		t.Fatalf("issue: %v", err)
-	}
-
-	claims, err := issuer.Verify(token)
-	if err != nil {
-		t.Fatalf("verify: %v", err)
-	}
-	if claims.UserID != "user-1" || claims.TenantSlug != "acme" {
-		t.Fatalf("claims unerwartet: %+v", claims)
-	}
-}
-
-// Pruefung 2: Token-Manipulationstest.
-func TestTokenVerify_RejectsManipulatedPayload(t *testing.T) {
-	issuer := NewTokenIssuer("test-secret-nur-fuer-tests")
-	token, err := issuer.Issue("user-1", "acme")
-	if err != nil {
-		t.Fatalf("issue: %v", err)
-	}
-
-	parts := strings.Split(token, ".")
-	if len(parts) != 3 {
-		t.Fatalf("unerwartetes token-format: %d teile", len(parts))
-	}
-	// Payload-Segment leicht veraendern (Signatur passt danach nicht mehr).
-	tampered := parts[0] + "." + parts[1] + "x" + "." + parts[2]
-
-	if _, err := issuer.Verify(tampered); err == nil {
-		t.Fatal("erwartet fehler bei manipuliertem token, habe nil")
-	}
-}
-
-func TestTokenVerify_RejectsWrongSecret(t *testing.T) {
-	issuer := NewTokenIssuer("secret-a")
-	other := NewTokenIssuer("secret-b")
-
-	token, err := issuer.Issue("user-1", "acme")
-	if err != nil {
-		t.Fatalf("issue: %v", err)
-	}
-	if _, err := other.Verify(token); err == nil {
-		t.Fatal("erwartet fehler bei falschem secret, habe nil")
-	}
-}
-
-// Pruefung 3: abgelaufenes Token erzwingt Neuanmeldung.
-func TestTokenVerify_RejectsExpiredToken(t *testing.T) {
-	issuer := NewTokenIssuer("test-secret-nur-fuer-tests")
-
-	claims := Claims{
-		UserID:     "user-1",
-		TenantSlug: "acme",
-		RegisteredClaims: jwt.RegisteredClaims{
-			IssuedAt:  jwt.NewNumericDate(time.Now().Add(-2 * AccessTokenTTL)),
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(-time.Minute)),
-		},
-	}
-	tok := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
-	expired, err := tok.SignedString([]byte("test-secret-nur-fuer-tests"))
-	if err != nil {
-		t.Fatalf("signieren: %v", err)
-	}
-
-	if _, err := issuer.Verify(expired); err == nil {
-		t.Fatal("erwartet fehler bei abgelaufenem token, habe nil")
-	}
-}
@@ -10,15 +10,8 @@ import (
 // connection info, superadmin accounts) — see nexarch-state.json
 // multi_tenancy: Modell C (physisch getrennte DB pro Mandant).
 type Config struct {
-	ListenAddr string
-	// RegistryDSN verbindet zur Control-Plane-Registry-Datenbank.
+	ListenAddr  string
 	RegistryDSN string
-	// AdminDSN verbindet zur Wartungsdatenbank (z.B. "postgres") und wird nur
-	// fuer CREATE/DROP DATABASE beim Tenant-Provisioning verwendet.
-	AdminDSN string
-	// TenantDSNTemplate enthaelt genau ein "%s" als Platzhalter fuer den
-	// Datenbanknamen einer neu provisionierten Tenant-Datenbank.
-	TenantDSNTemplate string
 }

 func Load() (Config, error) {
@@ -27,25 +20,10 @@ func Load() (Config, error) {
 		return Config{}, fmt.Errorf("NEXARCH_REGISTRY_DSN not set")
 	}

-	adminDSN := os.Getenv("NEXARCH_ADMIN_DSN")
-	if adminDSN == "" {
-		return Config{}, fmt.Errorf("NEXARCH_ADMIN_DSN not set")
-	}
-
-	dsnTemplate := os.Getenv("NEXARCH_TENANT_DSN_TEMPLATE")
-	if dsnTemplate == "" {
-		return Config{}, fmt.Errorf("NEXARCH_TENANT_DSN_TEMPLATE not set")
-	}
-
 	addr := os.Getenv("NEXARCH_LISTEN_ADDR")
 	if addr == "" {
 		addr = ":8080"
 	}

-	return Config{
-		ListenAddr:        addr,
-		RegistryDSN:       dsn,
-		AdminDSN:          adminDSN,
-		TenantDSNTemplate: dsnTemplate,
-	}, nil
+	return Config{ListenAddr: addr, RegistryDSN: dsn}, nil
 }
@@ -1,67 +0,0 @@
-package policy
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-)
-
-// ErrDenied wird geliefert, wenn keine Regel role+permission erlaubt —
-// Default-Deny (Akzeptanzkriterium 2).
-var ErrDenied = errors.New("policy: zugriff verweigert")
-
-// Enforcer ist die EINE zentrale Entscheidungs- und Durchsetzungsschicht
-// (Akzeptanzkriterium 1). Repository-/Query-Code ruft ausschliesslich Guard
-// bzw. GuardTenantScoped auf, nie eine Rohabfrage direkt.
-type Enforcer struct {
-	store *Store
-}
-
-func NewEnforcer(store *Store) *Enforcer {
-	return &Enforcer{store: store}
-}
-
-// Authorize entscheidet erlaubt/verboten — unabhaengig von jeder konkreten
-// Query, rein anhand der deklarativen Regeln (Akzeptanzkriterium 2: fuer
-// sich genommen testbar, ohne Anwendungslogik).
-func (e *Enforcer) Authorize(ctx context.Context, role rbac.Role, perm rbac.Permission) error {
-	allowed, err := e.store.IsAllowed(ctx, role, perm)
-	if err != nil {
-		return err
-	}
-	if !allowed {
-		return fmt.Errorf("%w: rolle %q hat kein recht %q", ErrDenied, role, perm)
-	}
-	return nil
-}
-
-// Guard ist die zentrale Enforcement-Funktion (Akzeptanzkriterium 1): query
-// wird NUR aufgerufen, wenn Authorize zustimmt. Es gibt keinen Weg, query
-// ausserhalb von Guard aufzurufen und trotzdem den Aufrufer als autorisiert
-// zu behandeln — die Autorisierungsentscheidung steht immer VOR dem
-// Datenzugriff, nie danach.
-func Guard[T any](ctx context.Context, e *Enforcer, role rbac.Role, perm rbac.Permission, query func(ctx context.Context) (T, error)) (T, error) {
-	var zero T
-	if err := e.Authorize(ctx, role, perm); err != nil {
-		return zero, err
-	}
-	return query(ctx)
-}
-
-// GuardTenantScoped erzwingt zusaetzlich, dass tenantSlug TEIL der Query-
-// Funktion selbst ist (Akzeptanzkriterium 3): der Funktionstyp verlangt,
-// dass die Repository-Implementierung tenantSlug in ihre eigene WHERE-
-// Klausel einbaut — ein nachgelagerter Filter auf dem Ergebnis (der
-// archivmail-Fehler aus "Bekannte Fehler vermeiden") ist mit dieser
-// Signatur nicht moeglich, da die Query-Funktion tenantSlug selbst
-// entgegennimmt und dafuer verantwortlich ist, statt ihn hinterher
-// anzuwenden.
-func GuardTenantScoped[T any](ctx context.Context, e *Enforcer, role rbac.Role, perm rbac.Permission, tenantSlug string, query func(ctx context.Context, tenantSlug string) (T, error)) (T, error) {
-	var zero T
-	if err := e.Authorize(ctx, role, perm); err != nil {
-		return zero, err
-	}
-	return query(ctx, tenantSlug)
-}
@@ -1,187 +0,0 @@
-package policy
-
-import (
-	"context"
-	"errors"
-	"os"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-)
-
-func setupTest(t *testing.T) (*Store, *Enforcer, 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 policy_rules (
-			role TEXT NOT NULL, permission TEXT NOT NULL,
-			granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-			PRIMARY KEY (role, permission)
-		);
-		CREATE TABLE IF NOT EXISTS policy_rule_changes (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), role TEXT NOT NULL, permission TEXT NOT NULL,
-			action TEXT NOT NULL CHECK (action IN ('grant','revoke')), actor TEXT NOT NULL,
-			version INT NOT NULL, changed_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-	`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	store := NewStore(pool)
-	cleanup := func() {
-		_, _ = pool.Exec(ctx, `DELETE FROM policy_rule_changes WHERE role LIKE 'test\_%' ESCAPE '\'`)
-		_, _ = pool.Exec(ctx, `DELETE FROM policy_rules WHERE role LIKE 'test\_%' ESCAPE '\'`)
-		pool.Close()
-	}
-	return store, NewEnforcer(store), cleanup
-}
-
-// Akzeptanzkriterium 2 + Pruefung 2: Anfrage ohne passende Policy wird
-// zuverlaessig abgewiesen (Default-Deny), nicht standardmaessig erlaubt.
-func TestAuthorize_DefaultDeny(t *testing.T) {
-	_, enforcer, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	err := enforcer.Authorize(ctx, rbac.Role("test_niemand"), rbac.Permission("test_irgendwas"))
-	if !errors.Is(err, ErrDenied) {
-		t.Fatalf("erwartet ErrDenied ohne konfigurierte regel, habe %v", err)
-	}
-}
-
-// Akzeptanzkriterium 1 + Pruefung 1: Guard ruft query NUR bei Autorisierung
-// auf — kein Datenzugriffs-Pfad umgeht die Enforcement-Schicht.
-func TestGuard_NeverCallsQueryWithoutAuthorization(t *testing.T) {
-	store, enforcer, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	role := rbac.Role("test_rolle_guard")
-	perm := rbac.Permission("test_lesen")
-
-	queryCalled := false
-	_, err := Guard(ctx, enforcer, role, perm, func(ctx context.Context) (string, error) {
-		queryCalled = true
-		return "geheime-daten", nil
-	})
-	if !errors.Is(err, ErrDenied) {
-		t.Fatalf("erwartet ErrDenied, habe %v", err)
-	}
-	if queryCalled {
-		t.Fatal("query haette bei fehlender autorisierung NICHT aufgerufen werden duerfen")
-	}
-
-	if err := store.Grant(ctx, role, perm, "admin@example.com"); err != nil {
-		t.Fatalf("grant: %v", err)
-	}
-
-	result, err := Guard(ctx, enforcer, role, perm, func(ctx context.Context) (string, error) {
-		queryCalled = true
-		return "geheime-daten", nil
-	})
-	if err != nil {
-		t.Fatalf("guard nach grant: %v", err)
-	}
-	if !queryCalled || result != "geheime-daten" {
-		t.Fatalf("erwartet query-aufruf mit ergebnis nach autorisierung, habe queryCalled=%v result=%q", queryCalled, result)
-	}
-}
-
-// Akzeptanzkriterium 2 + 3: Policy-Entscheidungen deklarativ und unabhaengig
-// von Anwendungslogik testbar — Regelwechsel wirkt ohne Codeaenderung,
-// Historie ist versioniert nachvollziehbar.
-func TestGrantRevoke_ChangesBehaviorWithoutCodeChange(t *testing.T) {
-	store, enforcer, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	role := rbac.Role("test_rolle_history")
-	perm := rbac.Permission("test_schreiben")
-
-	allowed, err := store.IsAllowed(ctx, role, perm)
-	if err != nil {
-		t.Fatalf("is allowed (vorher): %v", err)
-	}
-	if allowed {
-		t.Fatal("erwartet nicht erlaubt vor grant")
-	}
-
-	if err := store.Grant(ctx, role, perm, "admin@example.com"); err != nil {
-		t.Fatalf("grant: %v", err)
-	}
-	if err := enforcer.Authorize(ctx, role, perm); err != nil {
-		t.Fatalf("authorize nach grant sollte erlauben: %v", err)
-	}
-
-	if err := store.Revoke(ctx, role, perm, "admin@example.com"); err != nil {
-		t.Fatalf("revoke: %v", err)
-	}
-	if err := enforcer.Authorize(ctx, role, perm); !errors.Is(err, ErrDenied) {
-		t.Fatalf("authorize nach revoke sollte verweigern, habe %v", err)
-	}
-
-	history, err := store.History(ctx, role, perm)
-	if err != nil {
-		t.Fatalf("history: %v", err)
-	}
-	if len(history) != 2 {
-		t.Fatalf("erwartet 2 historieneintraege (grant, revoke), habe %d", len(history))
-	}
-	if history[0].Action != "grant" || history[0].Version != 1 {
-		t.Fatalf("history[0] unerwartet: %+v", history[0])
-	}
-	if history[1].Action != "revoke" || history[1].Version != 2 {
-		t.Fatalf("history[1] unerwartet: %+v", history[1])
-	}
-}
-
-// Akzeptanzkriterium 3 + Pruefung 3 (Tenant-Scoping): GuardTenantScoped
-// zwingt tenantSlug in die Query-Funktion selbst, kein Post-Filter moeglich.
-func TestGuardTenantScoped_IsolatesDataBetweenTenants(t *testing.T) {
-	_, enforcer, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	// Simuliertes Repository: die WHERE-Klausel (hier: Map-Lookup) liegt
-	// INNERHALB der Query-Funktion, nicht als nachgelagerter Filter.
-	data := map[string][]string{
-		"acme":   {"dokument-a1", "dokument-a2"},
-		"globex": {"dokument-b1"},
-	}
-	repoQuery := func(ctx context.Context, tenantSlug string) ([]string, error) {
-		return data[tenantSlug], nil
-	}
-
-	role := rbac.Role("test_tenant_rolle")
-	perm := rbac.Permission("test_dokumente_lesen")
-	if err := enforcer.store.Grant(ctx, role, perm, "admin@example.com"); err != nil {
-		t.Fatalf("grant: %v", err)
-	}
-
-	gotAcme, err := GuardTenantScoped(ctx, enforcer, role, perm, "acme", repoQuery)
-	if err != nil {
-		t.Fatalf("guard tenant scoped (acme): %v", err)
-	}
-	if len(gotAcme) != 2 {
-		t.Fatalf("erwartet 2 dokumente fuer acme, habe %d", len(gotAcme))
-	}
-
-	gotGlobex, err := GuardTenantScoped(ctx, enforcer, role, perm, "globex", repoQuery)
-	if err != nil {
-		t.Fatalf("guard tenant scoped (globex): %v", err)
-	}
-	if len(gotGlobex) != 1 {
-		t.Fatalf("erwartet 1 dokument fuer globex, habe %d", len(gotGlobex))
-	}
-}
@@ -1,124 +0,0 @@
-// Package policy implementiert Core RBAC-02: die zentrale Policy-
-// Entscheidungs- und Durchsetzungsschicht. Regeln liegen deklarativ in der
-// Datenbank (Casbin-Prinzip: Policy als Modell+Regeln getrennt vom Code),
-// versioniert und auditierbar — anders als Casbin-Dateien im Dateisystem
-// (siehe "bewusst vermeiden" im Ticket).
-package policy
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-)
-
-// Rule ist eine gewaehrte Regel: role darf permission.
-type Rule struct {
-	Role       rbac.Role
-	Permission rbac.Permission
-}
-
-// RuleChange ist ein Eintrag der Aenderungshistorie (Akzeptanzkriterium 3).
-type RuleChange struct {
-	Role       rbac.Role
-	Permission rbac.Permission
-	Action     string // "grant" oder "revoke"
-	Actor      string
-	Version    int
-}
-
-// Store verwaltet den deklarativen Regelsatz. IsAllowed schaut NUR in die
-// Datenbank — es gibt keinen hartcodierten Go-Fallback, ein Regelwechsel
-// wirkt sich ohne Codeaenderung sofort aus (Akzeptanzkriterium 2 / 3).
-type Store struct {
-	pool *pgxpool.Pool
-}
-
-func NewStore(pool *pgxpool.Pool) *Store {
-	return &Store{pool: pool}
-}
-
-// IsAllowed prueft, ob role das Recht permission besitzt. Default-Deny:
-// existiert keine passende Regel, ist der Zugriff verboten
-// (Akzeptanzkriterium 2 / Pruefung 2) — es gibt keinen impliziten
-// "erlaubt, wenn nichts anderes gesagt"-Pfad.
-func (s *Store) IsAllowed(ctx context.Context, role rbac.Role, perm rbac.Permission) (bool, error) {
-	var exists bool
-	err := s.pool.QueryRow(ctx, `
-		SELECT EXISTS(SELECT 1 FROM policy_rules WHERE role = $1 AND permission = $2)
-	`, string(role), string(perm)).Scan(&exists)
-	if err != nil {
-		return false, fmt.Errorf("policy pruefen: %w", err)
-	}
-	return exists, nil
-}
-
-// Grant gewaehrt role das Recht permission — deklarativ, ohne Codeaenderung
-// wirksam. actor wird fuer die Aenderungshistorie festgehalten.
-func (s *Store) Grant(ctx context.Context, role rbac.Role, perm rbac.Permission, actor string) error {
-	return s.change(ctx, role, perm, "grant", actor, `
-		INSERT INTO policy_rules (role, permission, granted_by, granted_at)
-		VALUES ($1, $2, $3, now())
-		ON CONFLICT (role, permission) DO UPDATE SET granted_by = $3, granted_at = now()
-	`, string(role), string(perm), actor)
-}
-
-// Revoke entzieht role das Recht permission.
-func (s *Store) Revoke(ctx context.Context, role rbac.Role, perm rbac.Permission, actor string) error {
-	return s.change(ctx, role, perm, "revoke", actor, `
-		DELETE FROM policy_rules WHERE role = $1 AND permission = $2
-	`, string(role), string(perm))
-}
-
-func (s *Store) change(ctx context.Context, role rbac.Role, perm rbac.Permission, action, actor, sql string, args ...any) error {
-	tx, err := s.pool.Begin(ctx)
-	if err != nil {
-		return fmt.Errorf("transaktion starten: %w", err)
-	}
-	defer func() { _ = tx.Rollback(ctx) }()
-
-	if _, err := tx.Exec(ctx, sql, args...); err != nil {
-		return fmt.Errorf("regel aendern: %w", err)
-	}
-
-	var version int
-	if err := tx.QueryRow(ctx, `
-		SELECT COALESCE(MAX(version), 0) + 1 FROM policy_rule_changes WHERE role = $1 AND permission = $2
-	`, string(role), string(perm)).Scan(&version); err != nil {
-		return fmt.Errorf("naechste version ermitteln: %w", err)
-	}
-
-	if _, err := tx.Exec(ctx, `
-		INSERT INTO policy_rule_changes (role, permission, action, actor, version, changed_at)
-		VALUES ($1, $2, $3, $4, $5, now())
-	`, string(role), string(perm), action, actor, version); err != nil {
-		return fmt.Errorf("historie schreiben: %w", err)
-	}
-
-	return tx.Commit(ctx)
-}
-
-// History liefert die vollstaendige, versionierte Aenderungshistorie einer
-// Regel (Akzeptanzkriterium 3).
-func (s *Store) History(ctx context.Context, role rbac.Role, perm rbac.Permission) ([]RuleChange, error) {
-	rows, err := s.pool.Query(ctx, `
-		SELECT action, actor, version FROM policy_rule_changes
-		WHERE role = $1 AND permission = $2 ORDER BY version
-	`, string(role), string(perm))
-	if err != nil {
-		return nil, fmt.Errorf("historie abfragen: %w", err)
-	}
-	defer rows.Close()
-
-	var out []RuleChange
-	for rows.Next() {
-		c := RuleChange{Role: role, Permission: perm}
-		if err := rows.Scan(&c.Action, &c.Actor, &c.Version); err != nil {
-			return nil, fmt.Errorf("historieneintrag lesen: %w", err)
-		}
-		out = append(out, c)
-	}
-	return out, rows.Err()
-}
@@ -1,200 +0,0 @@
-package rbac
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-var ErrGroupNotFound = errors.New("rbac: gruppe nicht gefunden")
-
-type Group struct {
-	ID   string
-	Name string
-	Role Role // leer, wenn der Gruppe noch keine Rolle zugewiesen wurde
-}
-
-// GroupStore verwaltet Gruppen/Abteilungen innerhalb GENAU EINER Tenant-
-// Datenbank (Modell C, wie Store fuer direkte Rollenzuweisungen) —
-// Akzeptanzkriterium 3 (tenant-isoliert) ist damit strukturell erfuellt.
-type GroupStore struct {
-	pool *pgxpool.Pool
-}
-
-func NewGroupStore(pool *pgxpool.Pool) *GroupStore {
-	return &GroupStore{pool: pool}
-}
-
-// CreateGroup legt eine neue, noch rollenlose Gruppe an (Akzeptanzkriterium 1).
-func (s *GroupStore) CreateGroup(ctx context.Context, name string) (Group, error) {
-	if name == "" {
-		return Group{}, errors.New("rbac: gruppenname darf nicht leer sein")
-	}
-	var g Group
-	g.Name = name
-	if err := s.pool.QueryRow(ctx, `
-		INSERT INTO groups (name) VALUES ($1) RETURNING id
-	`, name).Scan(&g.ID); err != nil {
-		return Group{}, fmt.Errorf("gruppe anlegen: %w", err)
-	}
-	return g, nil
-}
-
-// SetGroupRole weist der Gruppe eine Rolle zu (Akzeptanzkriterium 2) — nur
-// 'user'/'tenant_admin' sind auf Gruppenebene zuweisbar, dieselbe erlaubte
-// Matrix wie in Store.Assign (superadmin bleibt mandantenuebergreifend und
-// ausserhalb jeder Gruppenlogik).
-func (s *GroupStore) SetGroupRole(ctx context.Context, groupID string, role Role) error {
-	if !assignableRoles[role] {
-		return ErrRoleNotAssignableInTenantScope
-	}
-	tag, err := s.pool.Exec(ctx, `UPDATE groups SET role = $2 WHERE id = $1`, groupID, string(role))
-	if err != nil {
-		return fmt.Errorf("gruppenrolle setzen: %w", err)
-	}
-	if tag.RowsAffected() == 0 {
-		return ErrGroupNotFound
-	}
-	return nil
-}
-
-// AddMember nimmt einen Benutzer in die Gruppe auf.
-func (s *GroupStore) AddMember(ctx context.Context, groupID, userID string) error {
-	_, err := s.pool.Exec(ctx, `
-		INSERT INTO group_members (group_id, user_id) VALUES ($1, $2)
-		ON CONFLICT (group_id, user_id) DO NOTHING
-	`, groupID, userID)
-	if err != nil {
-		return fmt.Errorf("mitglied hinzufuegen: %w", err)
-	}
-	return nil
-}
-
-// RemoveMember entfernt einen Benutzer aus der Gruppe — die gruppenbasierten
-// Rechte entfallen fuer ihn sofort (Akzeptanzkriterium 3 / Pruefung 2), da
-// EffectivePermissionsForUser bei jedem Aufruf neu berechnet wird, nicht
-// zwischengespeichert.
-func (s *GroupStore) RemoveMember(ctx context.Context, groupID, userID string) error {
-	_, err := s.pool.Exec(ctx, `DELETE FROM group_members WHERE group_id = $1 AND user_id = $2`, groupID, userID)
-	if err != nil {
-		return fmt.Errorf("mitglied entfernen: %w", err)
-	}
-	return nil
-}
-
-// DeleteGroup loescht die Gruppe — ON DELETE CASCADE entfernt die
-// Mitgliedschaften mit, Benutzerkonten selbst bleiben unberuehrt
-// (Akzeptanzkriterium 3).
-func (s *GroupStore) DeleteGroup(ctx context.Context, groupID string) error {
-	_, err := s.pool.Exec(ctx, `DELETE FROM groups WHERE id = $1`, groupID)
-	if err != nil {
-		return fmt.Errorf("gruppe loeschen: %w", err)
-	}
-	return nil
-}
-
-// ListGroups liefert alle Gruppen des Mandanten (Akzeptanzkriterium 1/2,
-// Grundlage fuer die Administrationsoberflaeche).
-func (s *GroupStore) ListGroups(ctx context.Context) ([]Group, error) {
-	rows, err := s.pool.Query(ctx, `SELECT id, name, COALESCE(role, '') FROM groups ORDER BY name`)
-	if err != nil {
-		return nil, fmt.Errorf("gruppen auflisten: %w", err)
-	}
-	defer rows.Close()
-
-	var out []Group
-	for rows.Next() {
-		var g Group
-		var role string
-		if err := rows.Scan(&g.ID, &g.Name, &role); err != nil {
-			return nil, fmt.Errorf("gruppe lesen: %w", err)
-		}
-		g.Role = Role(role)
-		out = append(out, g)
-	}
-	return out, rows.Err()
-}
-
-// Members liefert die User-IDs der Mitglieder einer Gruppe.
-func (s *GroupStore) Members(ctx context.Context, groupID string) ([]string, error) {
-	rows, err := s.pool.Query(ctx, `SELECT user_id FROM group_members WHERE group_id = $1`, groupID)
-	if err != nil {
-		return nil, fmt.Errorf("mitglieder abfragen: %w", err)
-	}
-	defer rows.Close()
-
-	var out []string
-	for rows.Next() {
-		var id string
-		if err := rows.Scan(&id); err != nil {
-			return nil, fmt.Errorf("mitglied lesen: %w", err)
-		}
-		out = append(out, id)
-	}
-	return out, rows.Err()
-}
-
-// RolesForUser liefert alle Rollen, die einem Benutzer ueber seine
-// Gruppenmitgliedschaften zufallen (Akzeptanzkriterium 2: wirkt auf alle
-// Mitglieder). Eine Gruppe ohne zugewiesene Rolle traegt nichts bei.
-func (s *GroupStore) RolesForUser(ctx context.Context, userID string) ([]Role, error) {
-	rows, err := s.pool.Query(ctx, `
-		SELECT g.role FROM groups g
-		JOIN group_members gm ON gm.group_id = g.id
-		WHERE gm.user_id = $1 AND g.role IS NOT NULL
-	`, userID)
-	if err != nil {
-		return nil, fmt.Errorf("gruppenrollen abfragen: %w", err)
-	}
-	defer rows.Close()
-
-	var out []Role
-	for rows.Next() {
-		var r string
-		if err := rows.Scan(&r); err != nil {
-			return nil, fmt.Errorf("gruppenrolle lesen: %w", err)
-		}
-		out = append(out, Role(r))
-	}
-	return out, rows.Err()
-}
-
-// EffectivePermissionsForUser vereinigt die Rechte aus der direkten
-// Rollenzuweisung (Store, RBAC-01) mit allen Rechten aus Gruppenrollen —
-// jede einzelne Rolle wird ueber die bestehende Hierarchie (EffectivePermissions)
-// aufgeloest, das Ergebnis dedupliziert.
-func (s *GroupStore) EffectivePermissionsForUser(ctx context.Context, directStore *Store, userID string) ([]Permission, error) {
-	seen := make(map[Permission]bool)
-	var out []Permission
-
-	add := func(role Role) {
-		for _, p := range EffectivePermissions(role) {
-			if !seen[p] {
-				seen[p] = true
-				out = append(out, p)
-			}
-		}
-	}
-
-	if directStore != nil {
-		assignment, err := directStore.Get(ctx, userID)
-		if err != nil && !errors.Is(err, ErrNotFound) {
-			return nil, err
-		}
-		if err == nil {
-			add(assignment.Role)
-		}
-	}
-
-	groupRoles, err := s.RolesForUser(ctx, userID)
-	if err != nil {
-		return nil, err
-	}
-	for _, r := range groupRoles {
-		add(r)
-	}
-
-	return out, nil
-}
@@ -1,209 +0,0 @@
-package rbac
-
-import (
-	"context"
-	"fmt"
-	"os"
-	"strings"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-const groupSchema = `
-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 role_assignments (
-	user_id UUID PRIMARY KEY REFERENCES users(id), role TEXT NOT NULL CHECK (role IN ('user','tenant_admin')),
-	granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-CREATE TABLE IF NOT EXISTS groups (
-	id UUID PRIMARY KEY DEFAULT gen_random_uuid(), name TEXT NOT NULL, role TEXT CHECK (role IN ('user','tenant_admin')),
-	created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-CREATE TABLE IF NOT EXISTS group_members (
-	group_id UUID NOT NULL REFERENCES groups(id) ON DELETE CASCADE, user_id UUID NOT NULL REFERENCES users(id),
-	added_at TIMESTAMPTZ NOT NULL DEFAULT now(), PRIMARY KEY (group_id, user_id)
-);`
-
-func setupGroupTestDB(t *testing.T, dbName string) *pgxpool.Pool {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	adminPool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("admin pool: %v", err)
-	}
-	_, _ = adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-	if _, err := adminPool.Exec(ctx, fmt.Sprintf(`CREATE DATABASE %q`, dbName)); err != nil {
-		t.Fatalf("testdatenbank anlegen: %v", err)
-	}
-
-	dsn := strings.Replace(adminDSN, "/postgres?", "/"+dbName+"?", 1)
-	pool, err := pgxpool.New(ctx, dsn)
-	if err != nil {
-		t.Fatalf("connect testdatenbank: %v", err)
-	}
-	if _, err := pool.Exec(ctx, groupSchema); err != nil {
-		t.Fatalf("schema anwenden: %v", err)
-	}
-
-	t.Cleanup(func() {
-		pool.Close()
-		_, _ = adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-		adminPool.Close()
-	})
-	return pool
-}
-
-func createTestUser(t *testing.T, pool *pgxpool.Pool, email string) string {
-	t.Helper()
-	u, err := user.NewTenantUserStore(pool).Create(context.Background(), email, "Test")
-	if err != nil {
-		t.Fatalf("testuser anlegen: %v", err)
-	}
-	return u.ID
-}
-
-// Akzeptanzkriterium 1: Gruppen anlegen und Benutzer zuordnen.
-func TestGroup_CreateAndAddMember(t *testing.T) {
-	pool := setupGroupTestDB(t, "test_rbac03_create")
-	gs := NewGroupStore(pool)
-	ctx := context.Background()
-
-	g, err := gs.CreateGroup(ctx, "Buchhaltung")
-	if err != nil {
-		t.Fatalf("create group: %v", err)
-	}
-	userID := createTestUser(t, pool, "alice@example.com")
-
-	if err := gs.AddMember(ctx, g.ID, userID); err != nil {
-		t.Fatalf("add member: %v", err)
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 1: Gruppenrolle wirkt auf ALLE aktuellen
-// Mitglieder.
-func TestGroup_RoleAffectsAllCurrentMembers(t *testing.T) {
-	pool := setupGroupTestDB(t, "test_rbac03_roleall")
-	gs := NewGroupStore(pool)
-	ctx := context.Background()
-
-	g, err := gs.CreateGroup(ctx, "Admins")
-	if err != nil {
-		t.Fatalf("create group: %v", err)
-	}
-	if err := gs.SetGroupRole(ctx, g.ID, RoleTenantAdmin); err != nil {
-		t.Fatalf("set group role: %v", err)
-	}
-
-	alice := createTestUser(t, pool, "alice@example.com")
-	bob := createTestUser(t, pool, "bob@example.com")
-	if err := gs.AddMember(ctx, g.ID, alice); err != nil {
-		t.Fatalf("add alice: %v", err)
-	}
-	if err := gs.AddMember(ctx, g.ID, bob); err != nil {
-		t.Fatalf("add bob: %v", err)
-	}
-
-	for _, uid := range []string{alice, bob} {
-		perms, err := gs.EffectivePermissionsForUser(ctx, nil, uid)
-		if err != nil {
-			t.Fatalf("effective permissions fuer %s: %v", uid, err)
-		}
-		if !contains(perms, PermManageUsers) {
-			t.Fatalf("mitglied %s sollte tenant_admin-rechte ueber die gruppe haben, habe %v", uid, perms)
-		}
-	}
-}
-
-// Akzeptanzkriterium 3 + Pruefung 2: Entfernen aus der Gruppe entzieht die
-// gruppenbasierten Rechte sofort.
-func TestGroup_RemoveMemberRevokesRightsImmediately(t *testing.T) {
-	pool := setupGroupTestDB(t, "test_rbac03_remove")
-	gs := NewGroupStore(pool)
-	ctx := context.Background()
-
-	g, _ := gs.CreateGroup(ctx, "Admins")
-	_ = gs.SetGroupRole(ctx, g.ID, RoleTenantAdmin)
-	userID := createTestUser(t, pool, "alice@example.com")
-	_ = gs.AddMember(ctx, g.ID, userID)
-
-	perms, err := gs.EffectivePermissionsForUser(ctx, nil, userID)
-	if err != nil {
-		t.Fatalf("effective permissions (mitglied): %v", err)
-	}
-	if !contains(perms, PermManageUsers) {
-		t.Fatal("erwartet tenant_admin-rechte als mitglied")
-	}
-
-	if err := gs.RemoveMember(ctx, g.ID, userID); err != nil {
-		t.Fatalf("remove member: %v", err)
-	}
-
-	perms, err = gs.EffectivePermissionsForUser(ctx, nil, userID)
-	if err != nil {
-		t.Fatalf("effective permissions (entfernt): %v", err)
-	}
-	if contains(perms, PermManageUsers) {
-		t.Fatal("erwartet KEINE tenant_admin-rechte nach entfernen aus der gruppe")
-	}
-}
-
-// Akzeptanzkriterium 3: Loeschen einer Gruppe entzieht Rechte sauber, ohne
-// das Benutzerkonto zu loeschen.
-func TestGroup_DeleteGroupRevokesRightsWithoutDeletingUser(t *testing.T) {
-	pool := setupGroupTestDB(t, "test_rbac03_delete")
-	gs := NewGroupStore(pool)
-	us := user.NewTenantUserStore(pool)
-	ctx := context.Background()
-
-	g, _ := gs.CreateGroup(ctx, "Temp")
-	_ = gs.SetGroupRole(ctx, g.ID, RoleTenantAdmin)
-	userID := createTestUser(t, pool, "alice@example.com")
-	_ = gs.AddMember(ctx, g.ID, userID)
-
-	if err := gs.DeleteGroup(ctx, g.ID); err != nil {
-		t.Fatalf("delete group: %v", err)
-	}
-
-	perms, err := gs.EffectivePermissionsForUser(ctx, nil, userID)
-	if err != nil {
-		t.Fatalf("effective permissions: %v", err)
-	}
-	if contains(perms, PermManageUsers) {
-		t.Fatal("erwartet keine rechte mehr nach loeschen der gruppe")
-	}
-
-	if _, err := us.Get(ctx, userID); err != nil {
-		t.Fatalf("benutzerkonto haette erhalten bleiben muessen: %v", err)
-	}
-}
-
-// Akzeptanzkriterium 3 + Pruefung 3: Gruppen sind sauber tenant-isoliert.
-func TestGroup_TenantIsolation(t *testing.T) {
-	poolA := setupGroupTestDB(t, "test_rbac03_tenanta")
-	poolB := setupGroupTestDB(t, "test_rbac03_tenantb")
-	gsA := NewGroupStore(poolA)
-	ctx := context.Background()
-
-	if _, err := gsA.CreateGroup(ctx, "Nur-Tenant-A"); err != nil {
-		t.Fatalf("create group a: %v", err)
-	}
-
-	var countB int
-	if err := poolB.QueryRow(ctx, `SELECT count(*) FROM groups`).Scan(&countB); err != nil {
-		t.Fatalf("count tenant b: %v", err)
-	}
-	if countB != 0 {
-		t.Fatalf("tenant b sollte keine gruppen aus tenant a sehen, habe %d", countB)
-	}
-}
@@ -1,250 +0,0 @@
-package rbac
-
-import (
-	"encoding/json"
-	"net/http"
-	"strings"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-)
-
-// Handler stellt Rollen-/Rechte- und Gruppenverwaltung als HTTP-Endpunkte
-// bereit (RBAC-05). Duenner Client der bestehenden Store/GroupStore-Schicht —
-// keine eigene Rechtelogik hier (siehe Ticket-Produkt-DNA).
-type Handler struct {
-	roles  *Store
-	groups *GroupStore
-}
-
-func NewHandler(roles *Store, groups *GroupStore) *Handler {
-	return &Handler{roles: roles, groups: groups}
-}
-
-// requireManageUsers prueft, ob der aufrufende Benutzer ueberhaupt
-// Rechteverwaltung ausueben darf — technisch durchgesetzt hier zusaetzlich
-// zu RBAC-02 (Policy-Enforcement-Schicht), da diese Kachel ein eigener,
-// besonders sicherheitskritischer HTTP-Einstiegspunkt ist.
-func requireManageUsers(w http.ResponseWriter, r *http.Request, roles *Store) (callerUserID string, ok bool) {
-	claims, authOK := auth.ClaimsFromContext(r.Context())
-	if !authOK {
-		http.Error(w, "nicht angemeldet", http.StatusUnauthorized)
-		return "", false
-	}
-	assignment, err := roles.Get(r.Context(), claims.UserID)
-	if err != nil || !HasPermission(assignment.Role, PermManageUsers) {
-		http.Error(w, "keine Berechtigung zur Rechteverwaltung", http.StatusForbidden)
-		return "", false
-	}
-	return claims.UserID, true
-}
-
-type roleInfo struct {
-	Role        Role         `json:"role"`
-	Permissions []Permission `json:"permissions"`
-}
-
-// ListRoles liefert die (im Tenant-Geltungsbereich zuweisbaren) Rollen mit
-// ihren vollstaendig aufgeloesten Rechten (Akzeptanzkriterium 1).
-func (h *Handler) ListRoles(w http.ResponseWriter, r *http.Request) {
-	if _, ok := requireManageUsers(w, r, h.roles); !ok {
-		return
-	}
-	out := make([]roleInfo, 0, len(assignableRoles))
-	for role := range assignableRoles {
-		out = append(out, roleInfo{Role: role, Permissions: EffectivePermissions(role)})
-	}
-	w.Header().Set("Content-Type", "application/json")
-	_ = json.NewEncoder(w).Encode(out)
-}
-
-type assignRoleRequest struct {
-	UserID string `json:"user_id"`
-	Role   Role   `json:"role"`
-}
-
-// roleRank ordnet die Rollenhierarchie fuer den Selbst-Eskalations-Vergleich
-// (Akzeptanzkriterium 2 / Pruefung 2) — hoehere Zahl = mehr Rechte. Basiert
-// auf derselben parent-Kette wie EffectivePermissions, nicht dupliziert als
-// eigenstaendiges Modell.
-func roleRank(role Role) int {
-	rank := 0
-	for r, ok := role, true; ok; r, ok = parent[r] {
-		rank++
-	}
-	return rank
-}
-
-// AssignRole weist einem Benutzer eine Rolle zu (Akzeptanzkriterium 1).
-// Verweigert explizit, dass sich der aufrufende Benutzer selbst eine
-// hoehere Rolle zuweist (Akzeptanzkriterium 2 / Pruefung 2) — unabhaengig
-// davon, ob RBAC-02 dieselbe Aktion ohnehin ueber die allgemeine
-// Policy-Schicht verhindern wuerde: Selbst-Eskalation ist ein derart
-// sicherheitskritischer Einzelfall, dass er hier zusaetzlich explizit und
-// unuebersehbar geprueft wird, statt sich allein auf eine generische
-// Regel an anderer Stelle zu verlassen.
-func (h *Handler) AssignRole(w http.ResponseWriter, r *http.Request) {
-	callerUserID, ok := requireManageUsers(w, r, h.roles)
-	if !ok {
-		return
-	}
-
-	var req assignRoleRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-
-	if req.UserID == callerUserID {
-		callerAssignment, err := h.roles.Get(r.Context(), callerUserID)
-		callerRole := RoleUser
-		if err == nil {
-			callerRole = callerAssignment.Role
-		}
-		if roleRank(req.Role) > roleRank(callerRole) {
-			http.Error(w, "Sie können sich nicht selbst eine höhere Rolle zuweisen.", http.StatusForbidden)
-			return
-		}
-	}
-
-	assignment, err := h.roles.Assign(r.Context(), req.UserID, req.Role, callerUserID)
-	if err != nil {
-		http.Error(w, "Rolle konnte nicht zugewiesen werden.", http.StatusBadRequest)
-		return
-	}
-
-	w.Header().Set("Content-Type", "application/json")
-	_ = json.NewEncoder(w).Encode(assignment)
-}
-
-// RoleHistory liefert die Zuweisungshistorie eines Benutzers — der in
-// Akzeptanzkriterium 3 geforderte Verweis auf das Audit-Log (die
-// role_assignment_history-Tabelle selbst IST die Nachvollziehbarkeits-Spur;
-// eine vollstaendige Anbindung an Core AUD-01 ist nicht Teil dieser Kachel).
-func (h *Handler) RoleHistory(w http.ResponseWriter, r *http.Request) {
-	if _, ok := requireManageUsers(w, r, h.roles); !ok {
-		return
-	}
-	userID := strings.TrimPrefix(r.URL.Path, "/rbac/users/")
-	userID = strings.TrimSuffix(userID, "/history")
-	if userID == "" {
-		http.Error(w, "user_id fehlt", http.StatusBadRequest)
-		return
-	}
-
-	history, err := h.roles.History(r.Context(), userID)
-	if err != nil {
-		http.Error(w, "historie konnte nicht geladen werden", http.StatusInternalServerError)
-		return
-	}
-	w.Header().Set("Content-Type", "application/json")
-	_ = json.NewEncoder(w).Encode(history)
-}
-
-type createGroupRequest struct {
-	Name string `json:"name"`
-}
-
-// CreateGroup legt eine neue Gruppe an (Akzeptanzkriterium 2).
-func (h *Handler) CreateGroup(w http.ResponseWriter, r *http.Request) {
-	if _, ok := requireManageUsers(w, r, h.roles); !ok {
-		return
-	}
-	var req createGroupRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-	group, err := h.groups.CreateGroup(r.Context(), req.Name)
-	if err != nil {
-		http.Error(w, "Gruppe konnte nicht angelegt werden.", http.StatusBadRequest)
-		return
-	}
-	w.Header().Set("Content-Type", "application/json")
-	w.WriteHeader(http.StatusCreated)
-	_ = json.NewEncoder(w).Encode(group)
-}
-
-type groupWithMembers struct {
-	Group
-	Members []string `json:"members"`
-}
-
-// ListGroups liefert alle Gruppen inkl. Mitgliederliste (Akzeptanzkriterium 2).
-func (h *Handler) ListGroups(w http.ResponseWriter, r *http.Request) {
-	if _, ok := requireManageUsers(w, r, h.roles); !ok {
-		return
-	}
-	groups, err := h.groups.ListGroups(r.Context())
-	if err != nil {
-		http.Error(w, "Gruppen konnten nicht geladen werden.", http.StatusInternalServerError)
-		return
-	}
-	out := make([]groupWithMembers, 0, len(groups))
-	for _, g := range groups {
-		members, err := h.groups.Members(r.Context(), g.ID)
-		if err != nil {
-			http.Error(w, "Mitglieder konnten nicht geladen werden.", http.StatusInternalServerError)
-			return
-		}
-		out = append(out, groupWithMembers{Group: g, Members: members})
-	}
-	w.Header().Set("Content-Type", "application/json")
-	_ = json.NewEncoder(w).Encode(out)
-}
-
-type groupActionRequest struct {
-	GroupID string `json:"group_id"`
-	UserID  string `json:"user_id"`
-	Role    Role   `json:"role"`
-}
-
-// SetGroupRole weist einer Gruppe eine Rolle zu (Akzeptanzkriterium 2).
-func (h *Handler) SetGroupRole(w http.ResponseWriter, r *http.Request) {
-	if _, ok := requireManageUsers(w, r, h.roles); !ok {
-		return
-	}
-	var req groupActionRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-	if err := h.groups.SetGroupRole(r.Context(), req.GroupID, req.Role); err != nil {
-		http.Error(w, "Gruppenrolle konnte nicht gesetzt werden.", http.StatusBadRequest)
-		return
-	}
-	w.WriteHeader(http.StatusOK)
-}
-
-// AddGroupMember nimmt einen Benutzer in eine Gruppe auf (Akzeptanzkriterium 2).
-func (h *Handler) AddGroupMember(w http.ResponseWriter, r *http.Request) {
-	if _, ok := requireManageUsers(w, r, h.roles); !ok {
-		return
-	}
-	var req groupActionRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-	if err := h.groups.AddMember(r.Context(), req.GroupID, req.UserID); err != nil {
-		http.Error(w, "Mitglied konnte nicht hinzugefügt werden.", http.StatusBadRequest)
-		return
-	}
-	w.WriteHeader(http.StatusOK)
-}
-
-// RemoveGroupMember entfernt einen Benutzer aus einer Gruppe.
-func (h *Handler) RemoveGroupMember(w http.ResponseWriter, r *http.Request) {
-	if _, ok := requireManageUsers(w, r, h.roles); !ok {
-		return
-	}
-	var req groupActionRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-	if err := h.groups.RemoveMember(r.Context(), req.GroupID, req.UserID); err != nil {
-		http.Error(w, "Mitglied konnte nicht entfernt werden.", http.StatusBadRequest)
-		return
-	}
-	w.WriteHeader(http.StatusOK)
-}
@@ -1,309 +0,0 @@
-package rbac
-
-import (
-	"bytes"
-	"context"
-	"encoding/json"
-	"fmt"
-	"net/http"
-	"net/http/httptest"
-	"os"
-	"strings"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-const handlerSchema = `
-CREATE EXTENSION IF NOT EXISTS pgcrypto;
-CREATE TABLE 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 role_assignments (
-	user_id UUID PRIMARY KEY REFERENCES users(id), role TEXT NOT NULL CHECK (role IN ('user','tenant_admin')),
-	granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-CREATE TABLE role_assignment_history (
-	id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID NOT NULL, role TEXT NOT NULL,
-	granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-CREATE TABLE groups (
-	id UUID PRIMARY KEY DEFAULT gen_random_uuid(), name TEXT NOT NULL, role TEXT CHECK (role IN ('user','tenant_admin')),
-	created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-CREATE TABLE group_members (
-	group_id UUID NOT NULL REFERENCES groups(id) ON DELETE CASCADE, user_id UUID NOT NULL REFERENCES users(id),
-	added_at TIMESTAMPTZ NOT NULL DEFAULT now(), PRIMARY KEY (group_id, user_id)
-);`
-
-func setupHandlerTest(t *testing.T, dbName string) (*Handler, *Store, *user.TenantUserStore, *pgxpool.Pool) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	adminPool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("admin pool: %v", err)
-	}
-	_, _ = adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-	if _, err := adminPool.Exec(ctx, fmt.Sprintf(`CREATE DATABASE %q`, dbName)); err != nil {
-		t.Fatalf("testdatenbank anlegen: %v", err)
-	}
-
-	dsn := strings.Replace(adminDSN, "/postgres?", "/"+dbName+"?", 1)
-	pool, err := pgxpool.New(ctx, dsn)
-	if err != nil {
-		t.Fatalf("connect testdatenbank: %v", err)
-	}
-	if _, err := pool.Exec(ctx, handlerSchema); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	t.Cleanup(func() {
-		pool.Close()
-		_, _ = adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-		adminPool.Close()
-	})
-
-	roleStore := NewStore(pool)
-	groupStore := NewGroupStore(pool)
-	return NewHandler(roleStore, groupStore), roleStore, user.NewTenantUserStore(pool), pool
-}
-
-func sessionCookieFor(t *testing.T, issuer *auth.TokenIssuer, userID string) *http.Cookie {
-	t.Helper()
-	token, err := issuer.Issue(userID, "acme")
-	if err != nil {
-		t.Fatalf("session-token ausstellen: %v", err)
-	}
-	return &http.Cookie{Name: auth.CookieName, Value: token}
-}
-
-// Akzeptanzkriterium 1: Rollen und ihre Grundrechte sind einsehbar.
-func TestListRoles(t *testing.T) {
-	h, roles, users, _ := setupHandlerTest(t, "rbac05_list_roles")
-	ctx := context.Background()
-	admin, err := users.Create(ctx, "admin@acme.example", "Admin")
-	if err != nil {
-		t.Fatalf("admin anlegen: %v", err)
-	}
-	if _, err := roles.Assign(ctx, admin.ID, RoleTenantAdmin, "system"); err != nil {
-		t.Fatalf("admin-rolle setzen: %v", err)
-	}
-
-	issuer := auth.NewTokenIssuer("test-secret")
-	req := httptest.NewRequest(http.MethodGet, "/rbac/roles", nil)
-	req.AddCookie(sessionCookieFor(t, issuer, admin.ID))
-	rec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.ListRoles)(rec, req)
-
-	if rec.Code != http.StatusOK {
-		t.Fatalf("status = %d, want 200, body: %s", rec.Code, rec.Body.String())
-	}
-	var out []roleInfo
-	if err := json.Unmarshal(rec.Body.Bytes(), &out); err != nil {
-		t.Fatalf("response dekodieren: %v", err)
-	}
-	if len(out) != 2 {
-		t.Fatalf("erwartet 2 zuweisbare rollen (user, tenant_admin), habe %d", len(out))
-	}
-}
-
-// Akzeptanzkriterium 2 / Pruefung 2: Selbst-Eskalation wird abgewiesen.
-func TestAssignRole_RejectsSelfEscalation(t *testing.T) {
-	h, roles, users, _ := setupHandlerTest(t, "rbac05_self_escalation")
-	ctx := context.Background()
-	u, err := users.Create(ctx, "normal@acme.example", "Normaler Nutzer")
-	if err != nil {
-		t.Fatalf("nutzer anlegen: %v", err)
-	}
-	if _, err := roles.Assign(ctx, u.ID, RoleUser, "system"); err != nil {
-		t.Fatalf("ausgangsrolle setzen: %v", err)
-	}
-
-	issuer := auth.NewTokenIssuer("test-secret")
-	body, _ := json.Marshal(assignRoleRequest{UserID: u.ID, Role: RoleTenantAdmin})
-	req := httptest.NewRequest(http.MethodPost, "/rbac/users/role", bytes.NewReader(body))
-	req.AddCookie(sessionCookieFor(t, issuer, u.ID))
-	rec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.AssignRole)(rec, req)
-
-	if rec.Code != http.StatusForbidden {
-		t.Fatalf("status = %d, want 403 (selbst-eskalation muss abgewiesen werden)", rec.Code)
-	}
-
-	// Rolle muss unveraendert geblieben sein.
-	assignment, err := roles.Get(ctx, u.ID)
-	if err != nil {
-		t.Fatalf("rolle laden: %v", err)
-	}
-	if assignment.Role != RoleUser {
-		t.Fatalf("rolle wurde trotz abgewiesener anfrage geaendert: %q", assignment.Role)
-	}
-}
-
-// Gegenprobe: ein Tenant-Admin darf EINEM ANDEREN Benutzer eine hoehere
-// Rolle zuweisen — nur die Selbst-Zuweisung ist gesperrt.
-func TestAssignRole_AdminCanPromoteOtherUser(t *testing.T) {
-	h, roles, users, _ := setupHandlerTest(t, "rbac05_promote_other")
-	ctx := context.Background()
-	admin, err := users.Create(ctx, "admin2@acme.example", "Admin")
-	if err != nil {
-		t.Fatalf("admin anlegen: %v", err)
-	}
-	if _, err := roles.Assign(ctx, admin.ID, RoleTenantAdmin, "system"); err != nil {
-		t.Fatalf("admin-rolle setzen: %v", err)
-	}
-	other, err := users.Create(ctx, "other@acme.example", "Anderer Nutzer")
-	if err != nil {
-		t.Fatalf("anderen nutzer anlegen: %v", err)
-	}
-
-	issuer := auth.NewTokenIssuer("test-secret")
-	body, _ := json.Marshal(assignRoleRequest{UserID: other.ID, Role: RoleTenantAdmin})
-	req := httptest.NewRequest(http.MethodPost, "/rbac/users/role", bytes.NewReader(body))
-	req.AddCookie(sessionCookieFor(t, issuer, admin.ID))
-	rec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.AssignRole)(rec, req)
-
-	if rec.Code != http.StatusOK {
-		t.Fatalf("status = %d, want 200, body: %s", rec.Code, rec.Body.String())
-	}
-}
-
-// Akzeptanzkriterium 3: Aenderungen an Rechten sind nachvollziehbar.
-func TestRoleHistory_TracksAssignments(t *testing.T) {
-	h, roles, users, _ := setupHandlerTest(t, "rbac05_history")
-	ctx := context.Background()
-	admin, err := users.Create(ctx, "admin3@acme.example", "Admin")
-	if err != nil {
-		t.Fatalf("admin anlegen: %v", err)
-	}
-	if _, err := roles.Assign(ctx, admin.ID, RoleTenantAdmin, "system"); err != nil {
-		t.Fatalf("admin-rolle setzen: %v", err)
-	}
-	target, err := users.Create(ctx, "target@acme.example", "Zielnutzer")
-	if err != nil {
-		t.Fatalf("zielnutzer anlegen: %v", err)
-	}
-	if _, err := roles.Assign(ctx, target.ID, RoleUser, admin.ID); err != nil {
-		t.Fatalf("erste zuweisung: %v", err)
-	}
-	if _, err := roles.Assign(ctx, target.ID, RoleTenantAdmin, admin.ID); err != nil {
-		t.Fatalf("zweite zuweisung: %v", err)
-	}
-
-	issuer := auth.NewTokenIssuer("test-secret")
-	req := httptest.NewRequest(http.MethodGet, "/rbac/users/"+target.ID+"/history", nil)
-	req.AddCookie(sessionCookieFor(t, issuer, admin.ID))
-	rec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.RoleHistory)(rec, req)
-
-	if rec.Code != http.StatusOK {
-		t.Fatalf("status = %d, want 200, body: %s", rec.Code, rec.Body.String())
-	}
-	var history []Assignment
-	if err := json.Unmarshal(rec.Body.Bytes(), &history); err != nil {
-		t.Fatalf("response dekodieren: %v", err)
-	}
-	if len(history) != 2 {
-		t.Fatalf("erwartet 2 historieneintraege, habe %d", len(history))
-	}
-}
-
-// Akzeptanzkriterium 2: Gruppen anlegen, Mitglieder zuordnen, Rolle zuweisen.
-func TestGroupWorkflow(t *testing.T) {
-	h, roles, users, _ := setupHandlerTest(t, "rbac05_group_workflow")
-	ctx := context.Background()
-	admin, err := users.Create(ctx, "admin4@acme.example", "Admin")
-	if err != nil {
-		t.Fatalf("admin anlegen: %v", err)
-	}
-	if _, err := roles.Assign(ctx, admin.ID, RoleTenantAdmin, "system"); err != nil {
-		t.Fatalf("admin-rolle setzen: %v", err)
-	}
-	member, err := users.Create(ctx, "member@acme.example", "Mitglied")
-	if err != nil {
-		t.Fatalf("mitglied anlegen: %v", err)
-	}
-
-	issuer := auth.NewTokenIssuer("test-secret")
-
-	createBody, _ := json.Marshal(createGroupRequest{Name: "Buchhaltung"})
-	createReq := httptest.NewRequest(http.MethodPost, "/rbac/groups", bytes.NewReader(createBody))
-	createReq.AddCookie(sessionCookieFor(t, issuer, admin.ID))
-	createRec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.CreateGroup)(createRec, createReq)
-	if createRec.Code != http.StatusCreated {
-		t.Fatalf("create group: status = %d, body: %s", createRec.Code, createRec.Body.String())
-	}
-	var group Group
-	if err := json.Unmarshal(createRec.Body.Bytes(), &group); err != nil {
-		t.Fatalf("group-response dekodieren: %v", err)
-	}
-
-	roleBody, _ := json.Marshal(groupActionRequest{GroupID: group.ID, Role: RoleUser})
-	roleReq := httptest.NewRequest(http.MethodPost, "/rbac/groups/role", bytes.NewReader(roleBody))
-	roleReq.AddCookie(sessionCookieFor(t, issuer, admin.ID))
-	roleRec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.SetGroupRole)(roleRec, roleReq)
-	if roleRec.Code != http.StatusOK {
-		t.Fatalf("set group role: status = %d, body: %s", roleRec.Code, roleRec.Body.String())
-	}
-
-	memberBody, _ := json.Marshal(groupActionRequest{GroupID: group.ID, UserID: member.ID})
-	memberReq := httptest.NewRequest(http.MethodPost, "/rbac/groups/members", bytes.NewReader(memberBody))
-	memberReq.AddCookie(sessionCookieFor(t, issuer, admin.ID))
-	memberRec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.AddGroupMember)(memberRec, memberReq)
-	if memberRec.Code != http.StatusOK {
-		t.Fatalf("add member: status = %d, body: %s", memberRec.Code, memberRec.Body.String())
-	}
-
-	listReq := httptest.NewRequest(http.MethodGet, "/rbac/groups", nil)
-	listReq.AddCookie(sessionCookieFor(t, issuer, admin.ID))
-	listRec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.ListGroups)(listRec, listReq)
-	if listRec.Code != http.StatusOK {
-		t.Fatalf("list groups: status = %d, body: %s", listRec.Code, listRec.Body.String())
-	}
-	var groups []groupWithMembers
-	if err := json.Unmarshal(listRec.Body.Bytes(), &groups); err != nil {
-		t.Fatalf("groups-response dekodieren: %v", err)
-	}
-	if len(groups) != 1 || len(groups[0].Members) != 1 || groups[0].Members[0] != member.ID {
-		t.Fatalf("erwartet 1 gruppe mit 1 mitglied (%s), habe %+v", member.ID, groups)
-	}
-}
-
-// Ohne Rechteverwaltungsberechtigung (normale 'user'-Rolle) wird jeder
-// Endpunkt abgewiesen — Tenant-Isolation ist strukturell (Modell C, siehe
-// GroupStore-Kommentar), diese Pruefung deckt die Rechte-Ebene ab.
-func TestRequireManageUsers_RejectsPlainUser(t *testing.T) {
-	h, roles, users, _ := setupHandlerTest(t, "rbac05_reject_plain")
-	ctx := context.Background()
-	u, err := users.Create(ctx, "plain@acme.example", "Normaler Nutzer")
-	if err != nil {
-		t.Fatalf("nutzer anlegen: %v", err)
-	}
-	if _, err := roles.Assign(ctx, u.ID, RoleUser, "system"); err != nil {
-		t.Fatalf("rolle setzen: %v", err)
-	}
-
-	issuer := auth.NewTokenIssuer("test-secret")
-	req := httptest.NewRequest(http.MethodGet, "/rbac/roles", nil)
-	req.AddCookie(sessionCookieFor(t, issuer, u.ID))
-	rec := httptest.NewRecorder()
-	auth.RequireAuth(issuer, h.ListRoles)(rec, req)
-
-	if rec.Code != http.StatusForbidden {
-		t.Fatalf("status = %d, want 403 fuer benutzer ohne rechteverwaltung", rec.Code)
-	}
-}
@@ -1,71 +0,0 @@
-// Package rbac implementiert Core RBAC-01: das Rollenmodell mit
-// Grundrollen/-rechten, Hierarchie und Zuweisung. Die eigentliche
-// Durchsetzung (erlaubt/verboten je Request) ist RBAC-02, dieses Paket
-// liefert nur Modell + Zuweisung (Casbin-Prinzip: Policy-Modell getrennt
-// von der Entscheidungsfunktion).
-package rbac
-
-// Role ist eine der drei Grundrollen. Superadmin lebt mandantenuebergreifend
-// (siehe internal/user.SuperadminStore aus IAM-01) und wird deshalb NICHT
-// ueber Store (tenant-gescoped) zugewiesen — die Existenz eines Superadmin-
-// Kontos IST die Rollenzuweisung.
-type Role string
-
-const (
-	RoleSuperadmin  Role = "superadmin"
-	RoleTenantAdmin Role = "tenant_admin"
-	RoleUser        Role = "user"
-)
-
-type Permission string
-
-const (
-	PermSelfRead       Permission = "self.read"
-	PermSelfUpdate     Permission = "self.update"
-	PermManageUsers    Permission = "tenant.manage_users"
-	PermManageSettings Permission = "tenant.manage_settings"
-	PermManageTenants  Permission = "platform.manage_tenants"
-)
-
-// parent bildet die Rollenhierarchie ab (Akzeptanzkriterium 2): eine Rolle
-// erbt alle Rechte ihrer Elternrolle. tenant_admin erbt von user,
-// superadmin erbt von tenant_admin.
-var parent = map[Role]Role{
-	RoleTenantAdmin: RoleUser,
-	RoleSuperadmin:  RoleTenantAdmin,
-}
-
-// direct sind die einer Rolle direkt (ohne Vererbung) zugeordneten Rechte.
-var direct = map[Role][]Permission{
-	RoleUser:        {PermSelfRead, PermSelfUpdate},
-	RoleTenantAdmin: {PermManageUsers, PermManageSettings},
-	RoleSuperadmin:  {PermManageTenants},
-}
-
-// EffectivePermissions liefert die vollstaendige, ueber die Hierarchie
-// aufgeloeste Rechtemenge einer Rolle (Akzeptanzkriterium 2 / Pruefung 2).
-func EffectivePermissions(role Role) []Permission {
-	seen := make(map[Permission]bool)
-	var out []Permission
-
-	for r, ok := role, true; ok; r, ok = parent[r] {
-		for _, p := range direct[r] {
-			if !seen[p] {
-				seen[p] = true
-				out = append(out, p)
-			}
-		}
-	}
-	return out
-}
-
-// HasPermission prueft, ob eine Rolle (inklusive geerbter Rechte) ein
-// bestimmtes Recht besitzt.
-func HasPermission(role Role, perm Permission) bool {
-	for _, p := range EffectivePermissions(role) {
-		if p == perm {
-			return true
-		}
-	}
-	return false
-}
@@ -1,48 +0,0 @@
-package rbac
-
-import "testing"
-
-func contains(perms []Permission, p Permission) bool {
-	for _, x := range perms {
-		if x == p {
-			return true
-		}
-	}
-	return false
-}
-
-// Akzeptanzkriterium 2 + Pruefung 2: Rollenhierarchie liefert die erwartete
-// effektive Rechtemenge.
-func TestEffectivePermissions_Inheritance(t *testing.T) {
-	userPerms := EffectivePermissions(RoleUser)
-	if !contains(userPerms, PermSelfRead) || !contains(userPerms, PermSelfUpdate) {
-		t.Fatalf("user sollte self.read/self.update haben, habe %v", userPerms)
-	}
-	if contains(userPerms, PermManageUsers) {
-		t.Fatal("user sollte KEIN tenant.manage_users haben")
-	}
-
-	adminPerms := EffectivePermissions(RoleTenantAdmin)
-	if !contains(adminPerms, PermSelfRead) || !contains(adminPerms, PermManageUsers) || !contains(adminPerms, PermManageSettings) {
-		t.Fatalf("tenant_admin sollte geerbte user-rechte + eigene rechte haben, habe %v", adminPerms)
-	}
-	if contains(adminPerms, PermManageTenants) {
-		t.Fatal("tenant_admin sollte KEIN platform.manage_tenants haben")
-	}
-
-	superPerms := EffectivePermissions(RoleSuperadmin)
-	for _, want := range []Permission{PermSelfRead, PermSelfUpdate, PermManageUsers, PermManageSettings, PermManageTenants} {
-		if !contains(superPerms, want) {
-			t.Fatalf("superadmin sollte %q haben (volle vererbte kette), habe %v", want, superPerms)
-		}
-	}
-}
-
-func TestHasPermission(t *testing.T) {
-	if !HasPermission(RoleTenantAdmin, PermSelfRead) {
-		t.Fatal("tenant_admin sollte geerbtes self.read haben")
-	}
-	if HasPermission(RoleUser, PermManageTenants) {
-		t.Fatal("user sollte platform.manage_tenants nicht haben")
-	}
-}
@@ -1,124 +0,0 @@
-package rbac
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"github.com/jackc/pgx/v5"
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-var (
-	// ErrRoleNotAssignableInTenantScope wird geliefert, wenn versucht wird,
-	// eine mandantenuebergreifende Rolle (superadmin) ueber den tenant-
-	// gescopten Store zu vergeben — die erlaubte Matrix laesst hier nur
-	// user/tenant_admin zu (Akzeptanzkriterium 1 / Pruefung 1).
-	ErrRoleNotAssignableInTenantScope = errors.New("rbac: rolle ist in diesem geltungsbereich nicht zuweisbar")
-	ErrNotFound                       = errors.New("rbac: keine rollenzuweisung gefunden")
-)
-
-// assignableRoles ist die erlaubte Matrix fuer Store (tenant-gescoped).
-var assignableRoles = map[Role]bool{
-	RoleUser:        true,
-	RoleTenantAdmin: true,
-}
-
-type Assignment struct {
-	UserID    string
-	Role      Role
-	GrantedBy string
-}
-
-// Store verwaltet Rollenzuweisungen innerhalb GENAU EINER Tenant-Datenbank —
-// analog zu internal/user.TenantUserStore (Modell C: der Pool bestimmt den
-// Tenant, keine tenant_id-Spalte noetig).
-type Store struct {
-	pool *pgxpool.Pool
-}
-
-func NewStore(pool *pgxpool.Pool) *Store {
-	return &Store{pool: pool}
-}
-
-// Assign vergibt eine Rolle an einen Benutzer. grantedBy identifiziert den
-// Akteur, der die Zuweisung vorgenommen hat (Akzeptanzkriterium 3). Jede
-// Zuweisung wird zusaetzlich in role_assignment_history festgehalten, auch
-// wenn sie eine vorherige Rolle ersetzt.
-func (s *Store) Assign(ctx context.Context, userID string, role Role, grantedBy string) (Assignment, error) {
-	if !assignableRoles[role] {
-		return Assignment{}, ErrRoleNotAssignableInTenantScope
-	}
-	if grantedBy == "" {
-		return Assignment{}, errors.New("rbac: grantedBy darf nicht leer sein")
-	}
-
-	tx, err := s.pool.Begin(ctx)
-	if err != nil {
-		return Assignment{}, fmt.Errorf("transaktion starten: %w", err)
-	}
-	defer func() { _ = tx.Rollback(ctx) }()
-
-	if _, err := tx.Exec(ctx, `
-		INSERT INTO role_assignments (user_id, role, granted_by, granted_at)
-		VALUES ($1, $2, $3, now())
-		ON CONFLICT (user_id) DO UPDATE SET role = $2, granted_by = $3, granted_at = now()
-	`, userID, string(role), grantedBy); err != nil {
-		return Assignment{}, fmt.Errorf("rolle zuweisen: %w", err)
-	}
-
-	if _, err := tx.Exec(ctx, `
-		INSERT INTO role_assignment_history (user_id, role, granted_by, granted_at)
-		VALUES ($1, $2, $3, now())
-	`, userID, string(role), grantedBy); err != nil {
-		return Assignment{}, fmt.Errorf("historie schreiben: %w", err)
-	}
-
-	if err := tx.Commit(ctx); err != nil {
-		return Assignment{}, fmt.Errorf("transaktion committen: %w", err)
-	}
-
-	return Assignment{UserID: userID, Role: role, GrantedBy: grantedBy}, nil
-}
-
-func (s *Store) Get(ctx context.Context, userID string) (Assignment, error) {
-	var a Assignment
-	var role string
-	a.UserID = userID
-	if err := s.pool.QueryRow(ctx, `
-		SELECT role, granted_by FROM role_assignments WHERE user_id = $1
-	`, userID).Scan(&role, &a.GrantedBy); err != nil {
-		if errors.Is(err, pgx.ErrNoRows) {
-			return Assignment{}, ErrNotFound
-		}
-		return Assignment{}, fmt.Errorf("rollenzuweisung lesen: %w", err)
-	}
-	a.Role = Role(role)
-	return a, nil
-}
-
-// History liefert jede Rollenzuweisung eines Benutzers in chronologischer
-// Reihenfolge — die Grundlage fuer "wer hat wann welche Rolle vergeben"
-// (Akzeptanzkriterium 3).
-func (s *Store) History(ctx context.Context, userID string) ([]Assignment, error) {
-	rows, err := s.pool.Query(ctx, `
-		SELECT role, granted_by FROM role_assignment_history
-		WHERE user_id = $1 ORDER BY granted_at
-	`, userID)
-	if err != nil {
-		return nil, fmt.Errorf("historie abfragen: %w", err)
-	}
-	defer rows.Close()
-
-	var out []Assignment
-	for rows.Next() {
-		var role string
-		a := Assignment{UserID: userID}
-		if err := rows.Scan(&role, &a.GrantedBy); err != nil {
-			return nil, fmt.Errorf("historieneintrag lesen: %w", err)
-		}
-		a.Role = Role(role)
-		out = append(out, a)
-	}
-	return out, rows.Err()
-}
@@ -1,144 +0,0 @@
-package rbac
-
-import (
-	"context"
-	"errors"
-	"os"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-func setupStoreTest(t *testing.T) (*Store, string, 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 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 role_assignments (
-			user_id UUID PRIMARY KEY REFERENCES users(id),
-			role TEXT NOT NULL CHECK (role IN ('user', 'tenant_admin')),
-			granted_by TEXT NOT NULL,
-			granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS role_assignment_history (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-			user_id UUID NOT NULL,
-			role TEXT NOT NULL,
-			granted_by TEXT NOT NULL,
-			granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-	`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	userStore := user.NewTenantUserStore(pool)
-	u, err := userStore.Create(ctx, "rbac_test@example.com", "RBAC Test")
-	if err != nil {
-		t.Fatalf("testuser anlegen: %v", err)
-	}
-
-	cleanup := func() {
-		_, _ = pool.Exec(ctx, `DELETE FROM role_assignment_history WHERE user_id = $1`, u.ID)
-		_, _ = pool.Exec(ctx, `DELETE FROM role_assignments WHERE user_id = $1`, u.ID)
-		_, _ = pool.Exec(ctx, `DELETE FROM users WHERE id = $1`, u.ID)
-		pool.Close()
-	}
-	return NewStore(pool), u.ID, cleanup
-}
-
-// Akzeptanzkriterium 1: Grundrollen sind einem Benutzer je Tenant zuweisbar.
-func TestStore_AssignAndGet(t *testing.T) {
-	store, userID, cleanup := setupStoreTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	assigned, err := store.Assign(ctx, userID, RoleTenantAdmin, "admin@acme.example")
-	if err != nil {
-		t.Fatalf("assign: %v", err)
-	}
-	if assigned.Role != RoleTenantAdmin {
-		t.Fatalf("erwartet tenant_admin, habe %q", assigned.Role)
-	}
-
-	got, err := store.Get(ctx, userID)
-	if err != nil {
-		t.Fatalf("get: %v", err)
-	}
-	if got.Role != RoleTenantAdmin || got.GrantedBy != "admin@acme.example" {
-		t.Fatalf("zuweisung unerwartet: %+v", got)
-	}
-}
-
-// Akzeptanzkriterium 1 + Pruefung 1: Zuweisung ausserhalb der erlaubten
-// Matrix (superadmin im tenant-gescopten Store) wird abgewiesen.
-func TestStore_RejectsSuperadminOutsideAllowedMatrix(t *testing.T) {
-	store, userID, cleanup := setupStoreTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	_, err := store.Assign(ctx, userID, RoleSuperadmin, "admin@acme.example")
-	if !errors.Is(err, ErrRoleNotAssignableInTenantScope) {
-		t.Fatalf("erwartet ErrRoleNotAssignableInTenantScope, habe %v", err)
-	}
-
-	// Sicherstellen, dass der abgewiesene Versuch keine Zeile hinterlassen hat.
-	if _, err := store.Get(ctx, userID); !errors.Is(err, ErrNotFound) {
-		t.Fatalf("erwartet ErrNotFound nach abgewiesener zuweisung, habe %v", err)
-	}
-}
-
-func TestStore_RejectsUnknownRole(t *testing.T) {
-	store, userID, cleanup := setupStoreTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if _, err := store.Assign(ctx, userID, Role("erfunden"), "admin@acme.example"); !errors.Is(err, ErrRoleNotAssignableInTenantScope) {
-		t.Fatalf("erwartet ErrRoleNotAssignableInTenantScope fuer unbekannte rolle, habe %v", err)
-	}
-}
-
-// Akzeptanzkriterium 3: Rollenzuweisung vollstaendig auditierbar.
-func TestStore_HistoryTracksWhoAndWhen(t *testing.T) {
-	store, userID, cleanup := setupStoreTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if _, err := store.Assign(ctx, userID, RoleUser, "system"); err != nil {
-		t.Fatalf("assign 1: %v", err)
-	}
-	if _, err := store.Assign(ctx, userID, RoleTenantAdmin, "admin@acme.example"); err != nil {
-		t.Fatalf("assign 2: %v", err)
-	}
-
-	history, err := store.History(ctx, userID)
-	if err != nil {
-		t.Fatalf("history: %v", err)
-	}
-	if len(history) != 2 {
-		t.Fatalf("erwartet 2 historieneintraege, habe %d", len(history))
-	}
-	if history[0].Role != RoleUser || history[0].GrantedBy != "system" {
-		t.Fatalf("history[0] unerwartet: %+v", history[0])
-	}
-	if history[1].Role != RoleTenantAdmin || history[1].GrantedBy != "admin@acme.example" {
-		t.Fatalf("history[1] unerwartet: %+v", history[1])
-	}
-}
@@ -1,45 +0,0 @@
-package tenant
-
-import (
-	"encoding/json"
-	"net/http"
-)
-
-// Handler ist eine schlanke Vorbereitung der Schnittstelle fuer API-01
-// (REST-API-Grundgerüst & Versionierung) und TEN-02 (Self-Service-Onboarding).
-// Auth/Rate-Limiting/Versionierung selbst sind ausdruecklich nicht Teil von
-// TEN-01 und werden dort nachgezogen.
-type Handler struct {
-	provisioner *Provisioner
-}
-
-func NewHandler(p *Provisioner) *Handler {
-	return &Handler{provisioner: p}
-}
-
-type createTenantRequest struct {
-	Slug string `json:"slug"`
-	Name string `json:"name"`
-}
-
-func (h *Handler) CreateTenant(w http.ResponseWriter, r *http.Request) {
-	var req createTenantRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-
-	t, err := h.provisioner.Provision(r.Context(), req.Slug, req.Name)
-	if err != nil {
-		if err == ErrInvalidSlug {
-			http.Error(w, err.Error(), http.StatusBadRequest)
-			return
-		}
-		http.Error(w, "tenant konnte nicht angelegt werden", http.StatusInternalServerError)
-		return
-	}
-
-	w.Header().Set("Content-Type", "application/json")
-	w.WriteHeader(http.StatusCreated)
-	_ = json.NewEncoder(w).Encode(t)
-}
@@ -1,78 +0,0 @@
-package tenant
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-// Provisioner legt fuer jeden neuen Mandanten eine vollstaendig isolierte
-// PostgreSQL-Datenbank an und registriert sie transaktional in der Registry
-// (Akzeptanzkriterium 2). Zwei Mandanten-Datenbanken sind danach auf
-// Infrastrukturebene komplett getrennt (Akzeptanzkriterium 3).
-type Provisioner struct {
-	// adminPool ist mit der Wartungsdatenbank (z. B. "postgres") verbunden
-	// und wird ausschliesslich fuer CREATE/DROP DATABASE verwendet, da diese
-	// Befehle in PostgreSQL nicht in einer Transaktion laufen koennen.
-	adminPool *pgxpool.Pool
-	registry  *Registry
-	// dsnTemplate enthaelt genau ein "%s" als Platzhalter fuer den
-	// Datenbanknamen, z. B. "postgresql://user:pass@host:5432/%s?sslmode=disable".
-	dsnTemplate string
-}
-
-func NewProvisioner(adminPool *pgxpool.Pool, registry *Registry, dsnTemplate string) *Provisioner {
-	return &Provisioner{adminPool: adminPool, registry: registry, dsnTemplate: dsnTemplate}
-}
-
-// Provision legt die Tenant-Datenbank an und registriert sie. Schlaegt die
-// Registrierung fehl, wird die bereits angelegte Datenbank wieder entfernt,
-// damit kein verwaister, unregistrierter Tenant zurueckbleibt.
-func (p *Provisioner) Provision(ctx context.Context, slug, name string) (Tenant, error) {
-	if err := ValidateSlug(slug); err != nil {
-		return Tenant{}, err
-	}
-
-	dbName := dbNameForSlug(slug)
-
-	// CREATE DATABASE erlaubt keine Parameter-Platzhalter; slug ist durch
-	// ValidateSlug bereits auf [a-z0-9_] beschraenkt, Injektion ausgeschlossen.
-	if _, err := p.adminPool.Exec(ctx, fmt.Sprintf(`CREATE DATABASE %q`, dbName)); err != nil {
-		return Tenant{}, fmt.Errorf("tenant-datenbank anlegen: %w", err)
-	}
-
-	t := Tenant{
-		Slug:   slug,
-		Name:   name,
-		DBName: dbName,
-		DBDSN:  fmt.Sprintf(p.dsnTemplate, dbName),
-		Status: StatusActive,
-	}
-
-	tx, err := p.registry.pool.Begin(ctx)
-	if err != nil {
-		p.rollbackDatabase(ctx, dbName)
-		return Tenant{}, fmt.Errorf("registry-transaktion starten: %w", err)
-	}
-
-	created, err := p.registry.insertTx(ctx, tx, t)
-	if err != nil {
-		_ = tx.Rollback(ctx)
-		p.rollbackDatabase(ctx, dbName)
-		return Tenant{}, err
-	}
-
-	if err := tx.Commit(ctx); err != nil {
-		p.rollbackDatabase(ctx, dbName)
-		return Tenant{}, fmt.Errorf("registry-transaktion committen: %w", err)
-	}
-
-	return created, nil
-}
-
-// rollbackDatabase entfernt eine bereits angelegte Tenant-Datenbank, wenn die
-// Registrierung fehlschlug, damit Provisioning insgesamt atomar wirkt.
-func (p *Provisioner) rollbackDatabase(ctx context.Context, dbName string) {
-	_, _ = p.adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-}
@@ -1,105 +0,0 @@
-package tenant
-
-import (
-	"context"
-	"os"
-	"strings"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-// Integrationstest fuer Akzeptanzkriterien 2 und 3. Benoetigt eine echte
-// Postgres-Instanz und wird ohne TEST_ADMIN_DSN uebersprungen, nicht als
-// fehlgeschlagen gewertet — siehe Pruefungen-Ergebnis im PR.
-//
-// TEST_ADMIN_DSN muss auf die Wartungsdatenbank zeigen, z. B.:
-//
-//	postgresql://postgres:postgres@localhost:5432/postgres?sslmode=disable
-func TestProvision_CreatesIsolatedDatabases(t *testing.T) {
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	adminPool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("admin pool: %v", err)
-	}
-	defer adminPool.Close()
-
-	registryPool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("registry pool: %v", err)
-	}
-	defer registryPool.Close()
-
-	if _, err := registryPool.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()
-		)`); err != nil {
-		t.Fatalf("registry-schema: %v", err)
-	}
-
-	dsnTemplate := strings.Replace(adminDSN, "/postgres?", "/%s?", 1)
-	registry := NewRegistry(registryPool)
-	provisioner := NewProvisioner(adminPool, registry, dsnTemplate)
-
-	t.Cleanup(func() {
-		_, _ = registryPool.Exec(ctx, `DELETE FROM tenants WHERE slug IN ('acme','globex')`)
-		_, _ = adminPool.Exec(ctx, `DROP DATABASE IF EXISTS tenant_acme`)
-		_, _ = adminPool.Exec(ctx, `DROP DATABASE IF EXISTS tenant_globex`)
-	})
-
-	tenantA, err := provisioner.Provision(ctx, "acme", "Acme GmbH")
-	if err != nil {
-		t.Fatalf("provision acme: %v", err)
-	}
-	tenantB, err := provisioner.Provision(ctx, "globex", "Globex AG")
-	if err != nil {
-		t.Fatalf("provision globex: %v", err)
-	}
-
-	if tenantA.DBName == tenantB.DBName {
-		t.Fatalf("erwartet unterschiedliche db_name, beide sind %q", tenantA.DBName)
-	}
-
-	// Akzeptanzkriterium 3 / Pruefung 3: In der Datenbank von Tenant A existiert
-	// keine Verbindungsmoeglichkeit zu Tenant B, weil beide physisch getrennte
-	// Datenbanken sind, statt sich auf einen Query-Filter zu verlassen.
-	poolA, err := pgxpool.New(ctx, tenantA.DBDSN)
-	if err != nil {
-		t.Fatalf("connect tenant a: %v", err)
-	}
-	defer poolA.Close()
-
-	var globexVisible bool
-	err = poolA.QueryRow(ctx, `
-		SELECT EXISTS (
-			SELECT 1 FROM pg_catalog.pg_database WHERE datname = $1
-		)
-	`, tenantB.DBName).Scan(&globexVisible)
-	if err != nil {
-		t.Fatalf("pruefung tenant-trennung: %v", err)
-	}
-	// pg_database ist clusterweit sichtbar (Existenz der DB), aber die
-	// eigentliche Pruefung ist: aus poolA (verbunden mit tenant_acme) ist keine
-	// Tabelle/Zeile aus tenant_globex erreichbar, da current_database() getrennt ist.
-	var currentDB string
-	if err := poolA.QueryRow(ctx, `SELECT current_database()`).Scan(&currentDB); err != nil {
-		t.Fatalf("current_database: %v", err)
-	}
-	if currentDB != tenantA.DBName {
-		t.Fatalf("current_database() = %q, want %q — keine physische Trennung", currentDB, tenantA.DBName)
-	}
-	if currentDB == tenantB.DBName {
-		t.Fatalf("tenant a verbindung zeigt auf tenant b datenbank")
-	}
-}
@@ -1,69 +0,0 @@
-package tenant
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/jackc/pgx/v5"
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-// Registry kapselt den Zugriff auf die Control-Plane-Registry-Datenbank.
-// Sie enthaelt ausschliesslich Tenant-Metadaten (Akzeptanzkriterium 1) —
-// niemals Geschaeftsdaten eines Mandanten.
-type Registry struct {
-	pool *pgxpool.Pool
-}
-
-func NewRegistry(pool *pgxpool.Pool) *Registry {
-	return &Registry{pool: pool}
-}
-
-// insertTx schreibt den Tenant-Datensatz innerhalb einer laufenden Transaktion,
-// damit Provisioner.Provision DB-Anlage und Registrierung atomar behandeln kann.
-func (r *Registry) insertTx(ctx context.Context, tx pgx.Tx, t Tenant) (Tenant, error) {
-	row := tx.QueryRow(ctx, `
-		INSERT INTO tenants (slug, name, db_name, db_dsn, status)
-		VALUES ($1, $2, $3, $4, $5)
-		RETURNING id, created_at
-	`, t.Slug, t.Name, t.DBName, t.DBDSN, t.Status)
-
-	if err := row.Scan(&t.ID, &t.CreatedAt); err != nil {
-		return Tenant{}, fmt.Errorf("tenant registrieren: %w", err)
-	}
-	return t, nil
-}
-
-func (r *Registry) GetBySlug(ctx context.Context, slug string) (Tenant, error) {
-	var t Tenant
-	row := r.pool.QueryRow(ctx, `
-		SELECT id, slug, name, db_name, db_dsn, status, created_at
-		FROM tenants WHERE slug = $1
-	`, slug)
-
-	if err := row.Scan(&t.ID, &t.Slug, &t.Name, &t.DBName, &t.DBDSN, &t.Status, &t.CreatedAt); err != nil {
-		return Tenant{}, fmt.Errorf("tenant laden: %w", err)
-	}
-	return t, nil
-}
-
-func (r *Registry) List(ctx context.Context) ([]Tenant, error) {
-	rows, err := r.pool.Query(ctx, `
-		SELECT id, slug, name, db_name, db_dsn, status, created_at
-		FROM tenants ORDER BY created_at
-	`)
-	if err != nil {
-		return nil, fmt.Errorf("tenants auflisten: %w", err)
-	}
-	defer rows.Close()
-
-	var out []Tenant
-	for rows.Next() {
-		var t Tenant
-		if err := rows.Scan(&t.ID, &t.Slug, &t.Name, &t.DBName, &t.DBDSN, &t.Status, &t.CreatedAt); err != nil {
-			return nil, fmt.Errorf("tenant lesen: %w", err)
-		}
-		out = append(out, t)
-	}
-	return out, rows.Err()
-}
@@ -1,42 +0,0 @@
-// Package tenant implements Core TEN-01: die Control-Plane-Registry und die
-// Provisioning-Routine fuer physisch getrennte Mandanten-Datenbanken (Modell C).
-package tenant
-
-import (
-	"errors"
-	"regexp"
-	"time"
-)
-
-type Status string
-
-const (
-	StatusActive Status = "active"
-)
-
-type Tenant struct {
-	ID        string
-	Slug      string
-	Name      string
-	DBName    string
-	DBDSN     string
-	Status    Status
-	CreatedAt time.Time
-}
-
-// slugPattern erzwingt sichere, als SQL-Identifier verwendbare Slugs, damit
-// der Datenbankname niemals aus unkontrolliertem Nutzereingabe-Text gebaut wird.
-var slugPattern = regexp.MustCompile(`^[a-z][a-z0-9_]{1,48}$`)
-
-var ErrInvalidSlug = errors.New("tenant: slug muss mit Kleinbuchstaben beginnen und darf nur [a-z0-9_] enthalten (2-49 Zeichen)")
-
-func ValidateSlug(slug string) error {
-	if !slugPattern.MatchString(slug) {
-		return ErrInvalidSlug
-	}
-	return nil
-}
-
-func dbNameForSlug(slug string) string {
-	return "tenant_" + slug
-}
@@ -1,35 +0,0 @@
-package tenant
-
-import "testing"
-
-func TestValidateSlug(t *testing.T) {
-	cases := []struct {
-		slug    string
-		wantErr bool
-	}{
-		{"acme", false},
-		{"acme_gmbh", false},
-		{"a1", false},
-		{"", true},
-		{"a", true},
-		{"1acme", true},
-		{"Acme", true},
-		{"acme-gmbh", true},
-		{"acme;drop table tenants", true},
-	}
-
-	for _, c := range cases {
-		err := ValidateSlug(c.slug)
-		if (err != nil) != c.wantErr {
-			t.Errorf("ValidateSlug(%q) error = %v, wantErr %v", c.slug, err, c.wantErr)
-		}
-	}
-}
-
-func TestDBNameForSlug(t *testing.T) {
-	got := dbNameForSlug("acme")
-	want := "tenant_acme"
-	if got != want {
-		t.Errorf("dbNameForSlug() = %q, want %q", got, want)
-	}
-}
@@ -1,66 +0,0 @@
-package user
-
-import (
-	"encoding/json"
-	"errors"
-	"net/http"
-)
-
-// Handler stellt die CRUD-API fuer Benutzerkonten bereit (IAM-01-Auftrag).
-// Auth/Sessions (IAM-02) und Rollen (RBAC-01) sind ausdruecklich nicht Teil
-// dieser Kachel und daher hier noch nicht angebunden.
-type Handler struct {
-	users       *TenantUserStore
-	superadmins *SuperadminStore
-}
-
-func NewHandler(users *TenantUserStore, superadmins *SuperadminStore) *Handler {
-	return &Handler{users: users, superadmins: superadmins}
-}
-
-type createUserRequest struct {
-	Email string `json:"email"`
-	Name  string `json:"name"`
-}
-
-func (h *Handler) CreateUser(w http.ResponseWriter, r *http.Request) {
-	var req createUserRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-
-	u, err := h.users.Create(r.Context(), req.Email, req.Name)
-	writeUserResult(w, u, err)
-}
-
-// CreateSuperadmin legt ein mandantenuebergreifendes Superadmin-Konto an —
-// bewusst ein eigener Endpunkt statt eines Tenant-Parameters mit Null-Wert.
-func (h *Handler) CreateSuperadmin(w http.ResponseWriter, r *http.Request) {
-	var req createUserRequest
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, "ungueltige Anfrage", http.StatusBadRequest)
-		return
-	}
-
-	u, err := h.superadmins.Create(r.Context(), req.Email, req.Name)
-	writeUserResult(w, u, err)
-}
-
-func writeUserResult(w http.ResponseWriter, u User, err error) {
-	if err != nil {
-		switch {
-		case errors.Is(err, ErrInvalidEmail), errors.Is(err, ErrEmailTaken):
-			http.Error(w, err.Error(), http.StatusBadRequest)
-		case errors.Is(err, ErrNotFound):
-			http.Error(w, err.Error(), http.StatusNotFound)
-		default:
-			http.Error(w, "benutzer konnte nicht verarbeitet werden", http.StatusInternalServerError)
-		}
-		return
-	}
-
-	w.Header().Set("Content-Type", "application/json")
-	w.WriteHeader(http.StatusCreated)
-	_ = json.NewEncoder(w).Encode(u)
-}
@@ -1,173 +0,0 @@
-package user
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"os"
-	"strings"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-// setupTestDB legt eine frische, isolierte Testdatenbank an, wendet die
-// uebergebene Migration an und liefert einen verbundenen Pool. Wird ohne
-// TEST_ADMIN_DSN uebersprungen — siehe internal/tenant/provisioner_test.go
-// fuer dasselbe Muster.
-func setupTestDB(t *testing.T, dbName, schemaSQL string) *pgxpool.Pool {
-	t.Helper()
-
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	adminPool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("admin pool: %v", err)
-	}
-
-	_, _ = adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-	if _, err := adminPool.Exec(ctx, fmt.Sprintf(`CREATE DATABASE %q`, dbName)); err != nil {
-		t.Fatalf("testdatenbank anlegen: %v", err)
-	}
-
-	dsn := strings.Replace(adminDSN, "/postgres?", "/"+dbName+"?", 1)
-	pool, err := pgxpool.New(ctx, dsn)
-	if err != nil {
-		t.Fatalf("connect testdatenbank: %v", err)
-	}
-
-	if _, err := pool.Exec(ctx, schemaSQL); err != nil {
-		t.Fatalf("schema anwenden: %v", err)
-	}
-
-	t.Cleanup(func() {
-		pool.Close()
-		_, _ = adminPool.Exec(ctx, fmt.Sprintf(`DROP DATABASE IF EXISTS %q`, dbName))
-		adminPool.Close()
-	})
-
-	return pool
-}
-
-const usersSchema = `
-CREATE EXTENSION IF NOT EXISTS pgcrypto;
-CREATE TABLE 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()
-);`
-
-const superadminsSchema = `
-CREATE EXTENSION IF NOT EXISTS pgcrypto;
-CREATE TABLE superadmins (
-	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()
-);`
-
-// Akzeptanzkriterium 1 + 3, Pruefung 1 (inkl. Negativfall doppelte E-Mail).
-func TestTenantUserStore_CRUD(t *testing.T) {
-	pool := setupTestDB(t, "test_iam01_users", usersSchema)
-	store := NewTenantUserStore(pool)
-	ctx := context.Background()
-
-	created, err := store.Create(ctx, "alice@example.com", "Alice")
-	if err != nil {
-		t.Fatalf("create: %v", err)
-	}
-	if created.Status != StatusActive {
-		t.Fatalf("erwartet status active, hat %q", created.Status)
-	}
-
-	got, err := store.Get(ctx, created.ID)
-	if err != nil {
-		t.Fatalf("get: %v", err)
-	}
-	if got.Email != "alice@example.com" {
-		t.Fatalf("get email = %q", got.Email)
-	}
-
-	updated, err := store.Update(ctx, created.ID, "", "Alice A.")
-	if err != nil {
-		t.Fatalf("update: %v", err)
-	}
-	if updated.Name != "Alice A." || updated.Email != "alice@example.com" {
-		t.Fatalf("update ergebnis unerwartet: %+v", updated)
-	}
-
-	list, err := store.List(ctx)
-	if err != nil {
-		t.Fatalf("list: %v", err)
-	}
-	if len(list) != 1 {
-		t.Fatalf("erwartet 1 benutzer, habe %d", len(list))
-	}
-
-	deactivated, err := store.Deactivate(ctx, created.ID)
-	if err != nil {
-		t.Fatalf("deactivate: %v", err)
-	}
-	if deactivated.Status != StatusInactive {
-		t.Fatalf("erwartet status inactive, hat %q", deactivated.Status)
-	}
-
-	// Negativfall: doppelte E-Mail-Adresse.
-	if _, err := store.Create(ctx, "second@example.com", "Bob"); err != nil {
-		t.Fatalf("create second: %v", err)
-	}
-	if _, err := store.Create(ctx, "second@example.com", "Bob Zwei"); !errors.Is(err, ErrEmailTaken) {
-		t.Fatalf("erwartet ErrEmailTaken, habe %v", err)
-	}
-
-	// Negativfall: fehlender Benutzer.
-	if _, err := store.Get(ctx, created.ID+"-nicht-vorhanden"); err == nil {
-		t.Fatalf("erwartet fehler bei unbekannter/ungueltiger id")
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 2: Superadmin-Anlage ohne Tenant-Kontext.
-// SuperadminStore.Create hat keinen Tenant-Parameter — es gibt syntaktisch
-// keine Moeglichkeit, hier versehentlich einen Tenant-Sonderfall zu vergessen.
-func TestSuperadminStore_CreateWithoutTenantContext(t *testing.T) {
-	pool := setupTestDB(t, "test_iam01_superadmins", superadminsSchema)
-	store := NewSuperadminStore(pool)
-	ctx := context.Background()
-
-	created, err := store.Create(ctx, "root@nexarch.internal", "Root")
-	if err != nil {
-		t.Fatalf("create superadmin: %v", err)
-	}
-	if created.Status != StatusActive {
-		t.Fatalf("erwartet status active, hat %q", created.Status)
-	}
-
-	got, err := store.Get(ctx, created.ID)
-	if err != nil {
-		t.Fatalf("get: %v", err)
-	}
-	if got.Email != "root@nexarch.internal" {
-		t.Fatalf("get email = %q", got.Email)
-	}
-
-	if _, err := store.Create(ctx, "root@nexarch.internal", "Root Zwei"); !errors.Is(err, ErrEmailTaken) {
-		t.Fatalf("erwartet ErrEmailTaken (globale eindeutigkeit), habe %v", err)
-	}
-
-	deactivated, err := store.Deactivate(ctx, created.ID)
-	if err != nil {
-		t.Fatalf("deactivate: %v", err)
-	}
-	if deactivated.Status != StatusInactive {
-		t.Fatalf("erwartet status inactive, hat %q", deactivated.Status)
-	}
-}
@@ -1,77 +0,0 @@
-package user
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-// SuperadminStore verwaltet mandantenuebergreifende Superadmin-Konten in der
-// Control-Plane-Registry (siehe internal/tenant.Registry). Superadmin-ohne-
-// Tenant ist dadurch ein eigener Typ statt eines Sonderfalls von User/
-// TenantUserStore — es gibt keinen Tenant-Parameter, den man weglassen
-// koennte (IAM-01, "ohne Sonderbehandlung im Code").
-type SuperadminStore struct {
-	pool *pgxpool.Pool
-}
-
-func NewSuperadminStore(pool *pgxpool.Pool) *SuperadminStore {
-	return &SuperadminStore{pool: pool}
-}
-
-func (s *SuperadminStore) Create(ctx context.Context, email, name string) (User, error) {
-	if err := ValidateEmail(email); err != nil {
-		return User{}, err
-	}
-
-	var u User
-	u.Email, u.Name, u.Status = email, name, StatusActive
-
-	row := s.pool.QueryRow(ctx, `
-		INSERT INTO superadmins (email, name, status)
-		VALUES ($1, $2, $3)
-		RETURNING id, created_at, updated_at
-	`, u.Email, u.Name, u.Status)
-
-	if err := row.Scan(&u.ID, &u.CreatedAt, &u.UpdatedAt); err != nil {
-		return User{}, mapWriteErr(err)
-	}
-	return u, nil
-}
-
-func (s *SuperadminStore) Get(ctx context.Context, id string) (User, error) {
-	return scanUser(s.pool.QueryRow(ctx, `
-		SELECT id, email, name, status, created_at, updated_at
-		FROM superadmins WHERE id = $1
-	`, id))
-}
-
-func (s *SuperadminStore) List(ctx context.Context) ([]User, error) {
-	rows, err := s.pool.Query(ctx, `
-		SELECT id, email, name, status, created_at, updated_at
-		FROM superadmins ORDER BY created_at
-	`)
-	if err != nil {
-		return nil, fmt.Errorf("superadmins auflisten: %w", err)
-	}
-	defer rows.Close()
-
-	var out []User
-	for rows.Next() {
-		var u User
-		if err := rows.Scan(&u.ID, &u.Email, &u.Name, &u.Status, &u.CreatedAt, &u.UpdatedAt); err != nil {
-			return nil, fmt.Errorf("superadmin lesen: %w", err)
-		}
-		out = append(out, u)
-	}
-	return out, rows.Err()
-}
-
-func (s *SuperadminStore) Deactivate(ctx context.Context, id string) (User, error) {
-	return scanUser(s.pool.QueryRow(ctx, `
-		UPDATE superadmins SET status = $2, updated_at = now()
-		WHERE id = $1
-		RETURNING id, email, name, status, created_at, updated_at
-	`, id, StatusInactive))
-}
@@ -1,173 +0,0 @@
-package user
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"github.com/jackc/pgx/v5"
-	"github.com/jackc/pgx/v5/pgconn"
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-// TenantUserStore verwaltet Benutzer innerhalb GENAU EINER Tenant-Datenbank.
-// Welcher Mandant gemeint ist, ergibt sich ausschliesslich aus dem
-// uebergebenen Pool — es gibt keine tenant_id-Spalte (siehe migrations/tenant/0001_users.up.sql).
-type TenantUserStore struct {
-	pool *pgxpool.Pool
-}
-
-func NewTenantUserStore(pool *pgxpool.Pool) *TenantUserStore {
-	return &TenantUserStore{pool: pool}
-}
-
-func (s *TenantUserStore) Create(ctx context.Context, email, name string) (User, error) {
-	if err := ValidateEmail(email); err != nil {
-		return User{}, err
-	}
-
-	var u User
-	u.Email, u.Name, u.Status = email, name, StatusActive
-
-	row := s.pool.QueryRow(ctx, `
-		INSERT INTO users (email, name, status)
-		VALUES ($1, $2, $3)
-		RETURNING id, created_at, updated_at
-	`, u.Email, u.Name, u.Status)
-
-	if err := row.Scan(&u.ID, &u.CreatedAt, &u.UpdatedAt); err != nil {
-		return User{}, mapWriteErr(err)
-	}
-	return u, nil
-}
-
-func (s *TenantUserStore) Get(ctx context.Context, id string) (User, error) {
-	return scanUser(s.pool.QueryRow(ctx, `
-		SELECT id, email, name, status, created_at, updated_at
-		FROM users WHERE id = $1
-	`, id))
-}
-
-func (s *TenantUserStore) List(ctx context.Context) ([]User, error) {
-	rows, err := s.pool.Query(ctx, `
-		SELECT id, email, name, status, created_at, updated_at
-		FROM users ORDER BY created_at
-	`)
-	if err != nil {
-		return nil, fmt.Errorf("benutzer auflisten: %w", err)
-	}
-	defer rows.Close()
-
-	var out []User
-	for rows.Next() {
-		var u User
-		if err := rows.Scan(&u.ID, &u.Email, &u.Name, &u.Status, &u.CreatedAt, &u.UpdatedAt); err != nil {
-			return nil, fmt.Errorf("benutzer lesen: %w", err)
-		}
-		out = append(out, u)
-	}
-	return out, rows.Err()
-}
-
-// Update aendert Name und E-Mail. Eine leere email/name laesst das jeweilige
-// Feld unveraendert.
-func (s *TenantUserStore) Update(ctx context.Context, id, email, name string) (User, error) {
-	if email != "" {
-		if err := ValidateEmail(email); err != nil {
-			return User{}, err
-		}
-	}
-
-	row := s.pool.QueryRow(ctx, `
-		UPDATE users
-		SET email = COALESCE(NULLIF($2, ''), email),
-		    name = COALESCE(NULLIF($3, ''), name),
-		    updated_at = now()
-		WHERE id = $1
-		RETURNING id, email, name, status, created_at, updated_at
-	`, id, email, name)
-
-	u, err := scanUser(row)
-	if err != nil {
-		return User{}, mapWriteErr(err)
-	}
-	return u, nil
-}
-
-// Deactivate setzt den Benutzer auf inaktiv statt ihn zu loeschen.
-func (s *TenantUserStore) Deactivate(ctx context.Context, id string) (User, error) {
-	return scanUser(s.pool.QueryRow(ctx, `
-		UPDATE users SET status = $2, updated_at = now()
-		WHERE id = $1
-		RETURNING id, email, name, status, created_at, updated_at
-	`, id, StatusInactive))
-}
-
-// SetPasswordHash schreibt einen bereits berechneten bcrypt-Hash (siehe
-// internal/auth, IAM-02). Der Store selbst kennt kein Klartext-Passwort.
-func (s *TenantUserStore) SetPasswordHash(ctx context.Context, id, hash string) error {
-	tag, err := s.pool.Exec(ctx, `
-		UPDATE users SET password_hash = $2, updated_at = now() WHERE id = $1
-	`, id, hash)
-	if err != nil {
-		return fmt.Errorf("passwort setzen: %w", err)
-	}
-	if tag.RowsAffected() == 0 {
-		return ErrNotFound
-	}
-	return nil
-}
-
-// AuthCredentials wird ausschliesslich fuer den Login-Pfad (internal/auth)
-// verwendet und traegt bewusst den password_hash, damit er nicht ueber den
-// regulaeren User-Typ/JSON-Serialisierungspfad nach aussen dringen kann.
-type AuthCredentials struct {
-	User         User
-	PasswordHash string
-}
-
-// GetByEmailForAuth liefert Benutzer + Passwort-Hash zu einer E-Mail-Adresse
-// aus GENAU DIESER Tenant-Datenbank — der Tenant-Scope ergibt sich damit
-// zwingend aus dem verwendeten Pool, es gibt keine Moeglichkeit, versehentlich
-// ueber Tenant-Grenzen hinweg zu suchen (bekannter archivmail-Fehler, siehe
-// IAM-02 "Bekannte Fehler vermeiden").
-func (s *TenantUserStore) GetByEmailForAuth(ctx context.Context, email string) (AuthCredentials, error) {
-	var c AuthCredentials
-	row := s.pool.QueryRow(ctx, `
-		SELECT id, email, name, status, created_at, updated_at, password_hash
-		FROM users WHERE email = $1
-	`, email)
-
-	if err := row.Scan(&c.User.ID, &c.User.Email, &c.User.Name, &c.User.Status,
-		&c.User.CreatedAt, &c.User.UpdatedAt, &c.PasswordHash); err != nil {
-		if errors.Is(err, pgx.ErrNoRows) {
-			return AuthCredentials{}, ErrNotFound
-		}
-		return AuthCredentials{}, fmt.Errorf("anmeldedaten lesen: %w", err)
-	}
-	return c, nil
-}
-
-func scanUser(row pgx.Row) (User, error) {
-	var u User
-	if err := row.Scan(&u.ID, &u.Email, &u.Name, &u.Status, &u.CreatedAt, &u.UpdatedAt); err != nil {
-		if errors.Is(err, pgx.ErrNoRows) {
-			return User{}, ErrNotFound
-		}
-		return User{}, fmt.Errorf("benutzer lesen: %w", err)
-	}
-	return u, nil
-}
-
-// mapWriteErr uebersetzt den Unique-Constraint-Verstoss der E-Mail-Spalte in
-// einen sprechenden Fehler statt der rohen Postgres-Fehlermeldung.
-func mapWriteErr(err error) error {
-	var pgErr *pgconn.PgError
-	if errors.As(err, &pgErr) && pgErr.Code == "23505" {
-		return ErrEmailTaken
-	}
-	if errors.Is(err, pgx.ErrNoRows) {
-		return ErrNotFound
-	}
-	return fmt.Errorf("benutzer schreiben: %w", err)
-}
@@ -1,42 +0,0 @@
-// Package user implementiert Core IAM-01: das Benutzer-Datenmodell und die
-// CRUD-Operationen. Tenant-Zugehoerigkeit ist ueber die Zieldatenbank
-// gegeben (Modell C, siehe internal/tenant) — Superadmin-Konten leben
-// dagegen mandantenuebergreifend in der Registry und sind ueber
-// SuperadminStore als eigener, First-Class-Typ modelliert, nicht als
-// tenant_id-NULL-Sonderfall in User.
-package user
-
-import (
-	"errors"
-	"regexp"
-	"time"
-)
-
-type Status string
-
-const (
-	StatusActive   Status = "active"
-	StatusInactive Status = "inactive"
-)
-
-type User struct {
-	ID        string
-	Email     string
-	Name      string
-	Status    Status
-	CreatedAt time.Time
-	UpdatedAt time.Time
-}
-
-var emailPattern = regexp.MustCompile(`^[^\s@]+@[^\s@]+\.[^\s@]+$`)
-
-var ErrInvalidEmail = errors.New("user: ungueltige E-Mail-Adresse")
-var ErrEmailTaken = errors.New("user: E-Mail-Adresse bereits vergeben")
-var ErrNotFound = errors.New("user: nicht gefunden")
-
-func ValidateEmail(email string) error {
-	if !emailPattern.MatchString(email) {
-		return ErrInvalidEmail
-	}
-	return nil
-}
@@ -1,24 +0,0 @@
-package user
-
-import "testing"
-
-func TestValidateEmail(t *testing.T) {
-	cases := []struct {
-		email   string
-		wantErr bool
-	}{
-		{"a@b.de", false},
-		{"a.b+c@sub.example.com", false},
-		{"", true},
-		{"keine-email", true},
-		{"a@b", true},
-		{"@b.de", true},
-	}
-
-	for _, c := range cases {
-		err := ValidateEmail(c.email)
-		if (err != nil) != c.wantErr {
-			t.Errorf("ValidateEmail(%q) error = %v, wantErr %v", c.email, err, c.wantErr)
-		}
-	}
-}
@@ -1 +0,0 @@
-DROP TABLE IF EXISTS tenants;
@@ -0,0 +1,10 @@
+-- Control-plane registry: tenant list + connection info (Modell C).
+-- Core TEN-01 (siehe core-kanban).
+CREATE TABLE tenants (
+    id           UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    slug         TEXT NOT NULL UNIQUE,
+    name         TEXT NOT NULL,
+    db_dsn       TEXT NOT NULL,
+    status       TEXT NOT NULL DEFAULT 'active',
+    created_at   TIMESTAMPTZ NOT NULL DEFAULT now()
+);
@@ -1,14 +0,0 @@
-- Control-plane registry: Tenant-Liste + Verbindungsinformationen (Modell C).
-- Enthaelt AUSSCHLIESSLICH Tenant-Metadaten, keine Geschaeftsdaten eines Mandanten.
-- Core TEN-01 (siehe core-kanban/tickets/TEN-01.md).
-CREATE EXTENSION IF NOT EXISTS pgcrypto;
-
-CREATE TABLE 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()
-);
@@ -1 +0,0 @@
-DROP TABLE IF EXISTS superadmins;
@@ -1,14 +0,0 @@
-- Superadmin-Konten arbeiten mandantenuebergreifend und leben deshalb in der
-- Control-Plane-Registry (siehe TEN-01), nicht in einer Tenant-Datenbank.
-- Das bildet "Superadmin ohne Tenant" strukturell als First-Class-Zustand ab,
-- statt ihn als Sonderfall in der Tenant-users-Tabelle zu behandeln
-- (IAM-01, siehe core-kanban/tickets/IAM-01.md — bekannte Fehler vermeiden).
-- E-Mail-Eindeutigkeit ist hier global, da die Registry-DB einmalig existiert.
-CREATE TABLE superadmins (
-    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()
-);
@@ -1,2 +0,0 @@
-DROP TABLE IF EXISTS policy_rule_changes;
-DROP TABLE IF EXISTS policy_rules;
@@ -1,24 +0,0 @@
-- Zentrale, deklarative Policy-Regeln (RBAC-02, siehe core-kanban/tickets/RBAC-02.md).
-- policy_rules haelt den AKTUELLEN, gewaehrten Regelsatz (Existenz = erlaubt,
-- Default-Deny fuer alles ohne Zeile). policy_rule_changes ist die
-- versionierte Aenderungshistorie (Akzeptanzkriterium 3: Regelwechsel ohne
-- Codeaenderung nachvollziehbar).
-CREATE TABLE policy_rules (
-    role       TEXT NOT NULL,
-    permission TEXT NOT NULL,
-    granted_by TEXT NOT NULL,
-    granted_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-    PRIMARY KEY (role, permission)
-);
-
-CREATE TABLE policy_rule_changes (
-    id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    role       TEXT NOT NULL,
-    permission TEXT NOT NULL,
-    action     TEXT NOT NULL CHECK (action IN ('grant', 'revoke')),
-    actor      TEXT NOT NULL,
-    version    INT NOT NULL,
-    changed_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-
-CREATE INDEX policy_rule_changes_idx ON policy_rule_changes (role, permission, version);
@@ -1 +0,0 @@
-DROP TABLE IF EXISTS users;
@@ -1,16 +0,0 @@
-- Benutzer-Datenmodell (IAM-01, siehe core-kanban/tickets/IAM-01.md).
-- Diese Migration laeuft in der DB EINES Mandanten (Modell C, siehe TEN-01) —
-- die Tenant-Zugehoerigkeit ist implizit durch die Datenbankverbindung
-- gegeben, es gibt daher bewusst KEINE tenant_id-Spalte.
-- E-Mail-Eindeutigkeit ist hier tenant-scoped: der UNIQUE-Constraint gilt
-- nur innerhalb dieser einen Tenant-Datenbank.
-CREATE EXTENSION IF NOT EXISTS pgcrypto;
-
-CREATE TABLE 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()
-);
@@ -1,2 +0,0 @@
-DROP TABLE IF EXISTS role_assignment_history;
-DROP TABLE IF EXISTS role_assignments;
@@ -1,23 +0,0 @@
-- Rollenzuweisung pro Benutzer (RBAC-01, siehe core-kanban/tickets/RBAC-01.md).
-- Nur 'user' und 'tenant_admin' sind hier zuweisbar — 'superadmin' lebt
-- mandantenuebergreifend in der Registry (IAM-01 SuperadminStore) und hat
-- daher bewusst KEINE Zeile in dieser tenant-lokalen Tabelle (Akzeptanz-
-- kriterium 1: nur Zuweisungen innerhalb der erlaubten Matrix).
-CREATE TABLE role_assignments (
-    user_id     UUID PRIMARY KEY REFERENCES users(id),
-    role        TEXT NOT NULL CHECK (role IN ('user', 'tenant_admin')),
-    granted_by  TEXT NOT NULL,
-    granted_at  TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-
-- Vollstaendige Historie jeder Rollenaenderung (Akzeptanzkriterium 3: wer
-- hat wann welche Rolle vergeben).
-CREATE TABLE role_assignment_history (
-    id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    user_id     UUID NOT NULL,
-    role        TEXT NOT NULL,
-    granted_by  TEXT NOT NULL,
-    granted_at  TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-
-CREATE INDEX role_assignment_history_user_idx ON role_assignment_history (user_id, granted_at);
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
sysopsandClaude Sonnet 5	9a374dd91e	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	2026-08-29 22:23:36 +02:00
sysopsandClaude Sonnet 5	bf7559e118	FDN-09: verschluesselung at rest & schluesselverwaltung Envelope-Encryption: DEK (32 Byte) frisch je Objekt, AES-256-GCM fuer Objektinhalt, DEK selbst mit Tenant-KEK verpackt (WrapDEK/UnwrapDEK). KEK kommt ausschliesslich ueber HTTPKEKProvider von Core API-10 (internal/kek.Handler.TenantKEKHandler-Vertrag, Service-Credential- authentifiziert), wird nie persistiert - jeder Seal/Open-Aufruf bezieht ihn frisch. RewrapDEK fuer KEK-Rotation ohne Neuverschluesselung der Objekte (nur der DEK-Wrapper wird neu verpackt, Chiffretext bleibt unveraendert). Auf 192.168.1.131 verifiziert: Round-Trip Encrypt/Decrypt, manipulierter Chiffretext UND falscher Schluessel werden beide ueber GCM-Auth-Tag abgelehnt, KEK-Rotation real getestet (RewrapDEK, altes Objekt danach mit neuem KEK weiterhin lesbar, alter KEK funktioniert nicht mehr). Befund dokumentiert: Cores internal/kek.Handler (Gegenstelle fuer den KEK-Bezug) ist noch in keinem cmd/*/main.go verdrahtet, dieselbe Fehlerklasse wie FDN-03/QA-05/AUD-06. HTTPKEKProvider daher gegen den dokumentierten Vertrag getestet, nicht gegen eine laufende Core-Instanz. Siehe dms/docs/FDN-09-PRUEFPROTOKOLL.md. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ	2026-08-29 22:13:49 +02:00
sysopsandClaude Sonnet 5	bfea94b032	FDN-04: job-queue & worker-runtime Postgres-Jobqueue (processing_jobs, FOR UPDATE SKIP LOCKED), In-Prozess- Worker-Goroutinen, kein Redis/AMQP. Enqueue mit Idempotency-Key-Dedup, Dequeue mit Stale-Lock-Wiedervorlage (Absturzsicherheit), Fail mit arithmetischem Backoff und Dead-Letter-Queue nach erschoepften Versuchen, RequeueDeadLetter fuer manuelle Wiederholung. Auf 192.168.1.131 verifiziert: Absturz-Wiedervorlage (Job von einem "abgestuerzten" Worker nie completed/failed, zweiter Worker holt ihn nach Ablauf der Sperre erneut), Idempotenz bei Doppelzustellung (gleicher idempotency_key erzeugt nur 1 Zeile), DLQ-Eintrag manuell wiederholbar. Vier reale Fehler beim Testen gefunden und behoben: zwei pgx-Typinferenz- Bugs im SQL-Parameterhandling (toter workerID-Parameter ohne Referenz in der Query; untypisiertes any statt []string fuer den ::text[]-Cast), sowie zwei Testinfrastruktur-Bugs (dms_tenant_test sammelte schema_migrations- Zustand ueber Sitzungen hinweg an, jobqueue-Testfixture raeumte processing_jobs nicht auf) - neues scripts/reset-test-env.sh + make check (-p 1) analog Core behoben. Siehe dms/docs/FDN-04-PRUEFPROTOKOLL.md fuer alle Pruefungsergebnisse. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ	2026-08-29 20:58:26 +02:00
sysopsandClaude Sonnet 5	a9ede93176	FDN-03: Protokoll ergaenzt - offener Punkt Pruefsummen-Schreibpfad checksum_sha256 (FDN-02) wird von keinem Schreibpfad in FDN-03 befuellt. Nachgetragen als AC/Pruefung in DOC-01 (Upload-API), Voraussetzung fuer Archive BAK-08 (neues Ticket: Checksum-basierte Objekt-Integritaetspruefung fuer extern eingebundenes, nicht selbst ueberwachtes Kunden-S3-Storage). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ	2026-08-29 20:33:35 +02:00
sysopsandClaude Sonnet 5	442bb674e9	FDN-03: objekt-storage-abstraktion Ein Driver-Interface, zwei austauschbare Treiber: LocalDriver (Entwicklung, Dateisystem, HMAC-signierte URLs) und S3Driver (Produktion, S3-kompatibel via aws-sdk-go-v2, echte presigned URLs). Pfadschema documents/<id>/ revisions/<id> innerhalb des mandantenspezifischen Buckets. Service verbindet Driver mit Nutzungsmeldung an Core LIC-05 (HTTPUsageReporter, Vertrag von internal/resync.Handler nachgebildet, DMS kann Cores internal/- Pakete als eigenes Modul nicht importieren). Auf 192.168.1.131 verifiziert, S3-Treiber gegen echtes lokal installiertes MinIO (kein Mock): Round-Trip beide Treiber, abgelaufene presigned URL real mit 403 abgewiesen (manuell zusaetzlich zum Unit-Test verifiziert), klare ErrNotFound bei fehlendem Objekt beide Treiber, Nutzungsmeldung mit korrektem Tenant/Metrik/Delta bei Put/Delete. Befund dokumentiert: Cores internal/resync.Handler (Gegenstelle fuer die Nutzungsmeldung) ist noch in keinem cmd/*/main.go verdrahtet (dieselbe Fehlerklasse wie QA-05/AUD-06) - HTTPUsageReporter daher gegen den dokumentierten Vertrag getestet, nicht gegen eine laufende Core-Instanz. Siehe dms/docs/FDN-03-PRUEFPROTOKOLL.md. golangci-lint auf v2.1.6 aktualisiert (v1.63.4 konnte go1.24-Zielstand nicht linten), .golangci.yml auf v2-Konfigurationsformat migriert. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ	2026-08-29 19:22:54 +02:00
sysopsandClaude Sonnet 5	9d4c2bae4a	FDN-02: datenmodell & migrationen Kern-Entitaeten (Dokument, Datei-Revision, Ordner, Tag, Metadatenfeld) als tenant-scoped SQL-Migration (Modell C, keine tenant_id-Spalte), FK auf users(id) aus Core IAM-01 (Auth bleibt vollstaendig in Core). Eigener, minimaler Migrations-Runner (internal/migrate, kein ORM) mit schema_migrations-Tracking fuer Idempotenz. Seed-Skript fuer Entwicklung. Auf 192.168.1.131 verifiziert: Migration auf leerer+bestehender DB, Rollback stellt Vorzustand wieder her, 4 FK-Negativtests, Seed-Skript end-to-end gegen frische DB. go.sum committet (Lock-Datei-Lehre aus dem Ticket). build/vet/lint/test clean. Siehe dms/docs/FDN-02-PRUEFPROTOKOLL.md fuer alle Pruefungsergebnisse. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ	2026-08-29 19:07:02 +02:00
sysopsandClaude Sonnet 5	08d54715d4	FDN-01: repository & projektgerüst DMS-Modul-Grundgerüst als Unterordner im bestehenden nexarch-Monorepo (dms/), eigenes Go-Modul (gitea.perlbach24.de/scripte/nexarch/dms), getrennt von Core. App/Worker-Trennung nach paperless-ngx-Vorbild (lange Aufgaben blockieren nie eine Anfrage): cmd/app (HTTP, /healthz), cmd/worker (Hintergrund-Dienst-Stub), internal/shared. golangci-lint (govet/staticcheck/errcheck/unused/ineffassign/gofmt/ goimports) + Makefile-Targets (install/run/lint/fmt/test). Auf 192.168.1.131 verifiziert: build/fmt/lint/test clean, absichtlich eingefuegter Lint-Verstoss bricht den Build wie gefordert ab (Exit 2), make run startet App+Worker und /healthz antwortet innerhalb 2s. Siehe dms/docs/FDN-01-PRUEFPROTOKOLL.md fuer alle Pruefungsergebnisse. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ	2026-08-29 17:32:35 +02:00
				`@@ -0,0 +1 @@`
				`ALTER TABLE file_revisions DROP COLUMN IF EXISTS wrapped_dek;`