RBAC-04: modul-scoped-berechtigungen

internal/policy/module_scope.go: policy_module_scopes verknuepft optional eine (role, permission)-Regel mit einem LIC-02-Feature-Flag. Enforcer. AuthorizeForTenant ist DIESELBE zentrale Entscheidungsfunktion wie Authorize (Akzeptanzkriterium 3, kein zweiter Enforcement-Mechanismus) — prueft zusaetzlich zur Grundregel, ob das verknuepfte Modul fuer den Tenant aktiv ist. Existiert kein ModuleScope-Eintrag, bleibt eine Regel wie bisher ohne Lizenzbindung gueltig (Kombinationsfall). GuardModuleScoped erweitert policy.Guard um dieselbe Pruefung. internal/flag (LIC-02) wurde 1:1 aus dem lic-02-Branch uebernommen (git show aus derselben Repo-Historie, keine Aenderung) — RBAC-04 haengt sowohl an RBAC-01/02 als auch an LIC-02, aber diese leben auf getrennten, noch nicht gemergten Feature-Branches ohne gemeinsame Historie. Fail-Safe-Verhalten aus LIC-02 greift automatisch: ein nicht konfiguriertes oder nicht erreichbares Feature-Flag gilt als deaktiviert, nie als aktiviert (sicherer Default fuer Modul-Aktivierungspruefungen). Pruefungen (ausgefuehrt auf root@192.168.1.131, go build/vet/test PASS): 1. Zugriff auf deaktiviertes Modul trotz passender Rolle abgewiesen — TestAuthorizeForTenant_DeniesWhenModuleNotActivated: GuardModuleScoped ruft die Query-Funktion nachweislich nicht auf. PASS. 2. Reaktivierung macht Berechtigung im laufenden Betrieb wirksam, kein Neustart — TestAuthorizeForTenant_BecomesActiveWithoutRestart: derselbe Enforcer/Service-Prozess, Flag per Store.Set aktiviert, TTL abgewartet, danach erlaubt. PASS. 3. Zusammenspiel Modul-Scope + Rollenscope in Kombinationsfaellen — TestAuthorizeForTenant_CombinationsOfRoleAndModuleScope: keine Regel -> verboten; Regel ohne Modul-Scope -> immer erlaubt; Regel mit Modul-Scope und Flag aus -> verboten; Flag an -> erlaubt. PASS. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
RBAC-02: policy-enforcement-schicht-zentral
2026-08-27 22:04:58 +02:00 · 2026-08-27 21:43:26 +02:00 · 2026-08-27 19:45:16 +02:00
53 changed files with 1079 additions and 2422 deletions
@@ -2,16 +2,13 @@ module gitea.perlbach24.de/scripte/nexarch
 go 1.22
-require (
+require github.com/jackc/pgx/v5 v5.6.0
 	github.com/golang-jwt/jwt/v5 v5.3.1
 	github.com/jackc/pgx/v5 v5.6.0
 	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/crypto v0.17.0 // indirect
 	golang.org/x/sync v0.1.0 // indirect
 	golang.org/x/text v0.14.0 // indirect
 )
@@ -1,8 +1,6 @@
 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=
@@ -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")
 	}
 }
@@ -0,0 +1,87 @@
 // Package flag implementiert Core LIC-02: einen Feature-Flag-Dienst mit
 // Strategien (global an/aus, Prozentsatz, Tenant-Zielgruppe) als Kernfunktion
 // des Core-Dienstes selbst — keine zusaetzliche Infrastruktur (Unleash-Server
 // + eigene DB), siehe "bewusst vermeiden" im LIC-02-Ticket.
 package flag
 import (
 	"context"
 	"errors"
 	"fmt"
 	"hash/fnv"
 	"github.com/jackc/pgx/v5"
 	"github.com/jackc/pgx/v5/pgxpool"
 )
 var ErrNotFound = errors.New("flag: nicht gefunden")
 // Flag ist die zentrale Definition — Auswertung (Evaluate) ist bewusst davon
 // getrennt (Unleash-Prinzip: Flag-Verwaltung vs. Flag-Auswertung).
 type Flag struct {
 	Key               string
 	Enabled           bool
 	RolloutPercentage int
 	TargetTenantSlugs []string
 }
 // Store ist die Verwaltungsseite (Admin): Flags definieren/lesen.
 type Store struct {
 	pool *pgxpool.Pool
 }
 func NewStore(pool *pgxpool.Pool) *Store {
 	return &Store{pool: pool}
 }
 func (s *Store) Set(ctx context.Context, f Flag) error {
 	if f.TargetTenantSlugs == nil {
 		f.TargetTenantSlugs = []string{} // pgx uebertraegt ein nil-Slice sonst als SQL NULL statt leerem Array.
 	}
 	_, err := s.pool.Exec(ctx, `
 		INSERT INTO feature_flags (key, enabled, rollout_percentage, target_tenant_slugs, updated_at)
 		VALUES ($1, $2, $3, $4, now())
 		ON CONFLICT (key) DO UPDATE SET
 			enabled = $2, rollout_percentage = $3, target_tenant_slugs = $4, updated_at = now()
 	`, f.Key, f.Enabled, f.RolloutPercentage, f.TargetTenantSlugs)
 	if err != nil {
 		return fmt.Errorf("flag speichern: %w", err)
 	}
 	return nil
 }
 func (s *Store) Get(ctx context.Context, key string) (Flag, error) {
 	var f Flag
 	row := s.pool.QueryRow(ctx, `
 		SELECT key, enabled, rollout_percentage, target_tenant_slugs
 		FROM feature_flags WHERE key = $1
 	`, key)
 	if err := row.Scan(&f.Key, &f.Enabled, &f.RolloutPercentage, &f.TargetTenantSlugs); err != nil {
 		if errors.Is(err, pgx.ErrNoRows) {
 			return Flag{}, ErrNotFound
 		}
 		return Flag{}, fmt.Errorf("flag lesen: %w", err)
 	}
 	return f, nil
 }
 // evaluate wendet die Strategien in fester Reihenfolge an: globaler
 // An/Aus-Schalter zuerst, dann Tenant-Zielgruppe, dann Prozentsatz-Rollout.
 // Ein unbekannter/nicht getroffener Fall ergibt false — Fail-Safe-Default,
 // kein Feature wird versehentlich aktiv.
 func evaluate(f Flag, tenantSlug string) bool {
 	if f.Enabled {
 		return true
 	}
 	for _, target := range f.TargetTenantSlugs {
 		if target == tenantSlug {
 			return true
 		}
 	}
 	if f.RolloutPercentage > 0 {
 		h := fnv.New32a()
 		_, _ = h.Write([]byte(f.Key + "|" + tenantSlug))
 		return int(h.Sum32()%100) < f.RolloutPercentage
 	}
 	return false
 }
@@ -0,0 +1,87 @@
 package flag
 import (
 	"context"
 	"log/slog"
 	"sync"
 	"time"
 )
 // DefaultCacheTTL ist die dokumentierte Cache-Invalidierungszeit
 // (Akzeptanzkriterium 2/3): eine Aenderung wirkt spaetestens nach dieser
 // Zeit auf allen Core-Instanzen, ohne dass ein Dienst neu gestartet werden
 // muss (Akzeptanzkriterium 3).
 const DefaultCacheTTL = 5 * time.Second
 type cacheEntry struct {
 	flag      Flag
 	expiresAt time.Time
 }
 // Service ist die Auswertungsseite (SDK/Client-Analogon zu Unleash) mit
 // lokalem TTL-Cache. Bewusst getrennt von Store (Verwaltung).
 type Service struct {
 	store *Store
 	ttl   time.Duration
 	mu    sync.RWMutex
 	cache map[string]cacheEntry
 }
 func NewService(store *Store, ttl time.Duration) *Service {
 	if ttl <= 0 {
 		ttl = DefaultCacheTTL
 	}
 	return &Service{store: store, ttl: ttl, cache: make(map[string]cacheEntry)}
 }
 // IsEnabled wertet ein Flag fuer einen Tenant aus. Liefert IMMER einen
 // bool ohne Fehlerwert — ein nicht erreichbarer Flag-Dienst darf abhaengige
 // Aufrufer nicht zum Absturz bringen oder zu Fehlerbehandlungscode zwingen,
 // der leicht vergessen wird (Akzeptanzkriterium 3 / Pruefung 3: dokumentiertes
 // Fallback-Verhalten = false, ggf. aus dem zuletzt bekannten Zwischenspeicher).
 func (s *Service) IsEnabled(ctx context.Context, tenantSlug, key string) bool {
 	f, ok := s.resolve(ctx, key)
 	if !ok {
 		return false
 	}
 	return evaluate(f, tenantSlug)
 }
 func (s *Service) resolve(ctx context.Context, key string) (Flag, bool) {
 	s.mu.RLock()
 	entry, exists := s.cache[key]
 	fresh := exists && time.Now().Before(entry.expiresAt)
 	s.mu.RUnlock()
 	if fresh {
 		return entry.flag, true
 	}
 	f, err := s.store.Get(ctx, key)
 	if err != nil {
 		if exists {
 			slog.Warn("feature-flag-dienst nicht erreichbar, nutze zwischengespeicherten stand",
 				"flag_key", key, "error", err)
 			return entry.flag, true
 		}
 		slog.Warn("feature-flag-dienst nicht erreichbar, kein zwischengespeicherter stand vorhanden, fallback: deaktiviert",
 			"flag_key", key, "error", err)
 		return Flag{}, false
 	}
 	s.mu.Lock()
 	s.cache[key] = cacheEntry{flag: f, expiresAt: time.Now().Add(s.ttl)}
 	s.mu.Unlock()
 	return f, true
 }
 // Invalidate erzwingt beim naechsten IsEnabled-Aufruf ein sofortiges Neuladen
 // aus der Datenbank statt auf den TTL-Ablauf zu warten — wird nach Store.Set
 // auf derselben Instanz aufgerufen, damit der Schreiber die eigene Aenderung
 // ohne Wartezeit sieht. Andere Core-Instanzen sehen sie spaetestens nach
 // DefaultCacheTTL (siehe Akzeptanzkriterium 3).
 func (s *Service) Invalidate(key string) {
 	s.mu.Lock()
 	delete(s.cache, key)
 	s.mu.Unlock()
 }
@@ -1,27 +0,0 @@
 // Package ldapsync implementiert Core IAM-05: LDAP/Active-Directory-
 // Anbindung je Tenant fuer Benutzer-Synchronisation, Login-Delegation und
 // Rollenzuordnung aus Gruppen ueber eine explizite Erlaubnis-Matrix.
 //
 // WICHTIGER HINWEIS: In dieser Umgebung steht kein echter LDAP/AD-Server zur
 // Verfuegung (analog zur Archive-Engine bei AUD-05). Client ist deshalb eine
 // Schnittstelle — die Sync-/Rollenzuordnungs-Logik ist gegen einen Fake in
 // den Tests vollstaendig geprueft, eine echte Verbindungspruefung gegen
 // LDAP/AD steht noch aus.
 package ldapsync
 // Entry ist ein aus LDAP gelesener Benutzerdatensatz.
 type Entry struct {
 	Email    string
 	Name     string
 	Groups   []string
 	Disabled bool
 }
 // Client abstrahiert die eigentliche LDAP-Verbindung (Bind + Search).
 type Client interface {
 	// Search liefert alle Benutzer, die dem konfigurierten Filter
 	// entsprechen. Ein Fehler bedeutet "Quelle nicht erreichbar oder
 	// fehlerhaft" — Run() bricht dann komplett und folgenlos ab
 	// (Akzeptanzkriterium 2).
 	Search() ([]Entry, error)
 }
@@ -1,204 +0,0 @@
 package ldapsync
 import (
 	"context"
 	"errors"
 	"fmt"
 	"os"
 	"testing"
 	"time"
 	"github.com/jackc/pgx/v5/pgxpool"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 	"gitea.perlbach24.de/scripte/nexarch/internal/user"
 )
 type fakeClient struct {
 	entries []Entry
 	err     error
 }
 func (f *fakeClient) Search() ([]Entry, error) {
 	if f.err != nil {
 		return nil, f.err
 	}
 	return f.entries, nil
 }
 func setupTest(t *testing.T) (*user.TenantUserStore, *rbac.Store, *RoleMappingStore, 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', password_hash TEXT NOT NULL DEFAULT '',
 			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()
 		);
 		CREATE TABLE IF NOT EXISTS ldap_group_role_mapping (
 			ldap_group TEXT PRIMARY KEY, role TEXT NOT NULL CHECK (role IN ('user','tenant_admin'))
 		);
 	`); err != nil {
 		t.Fatalf("schema: %v", err)
 	}
 	cleanup := func() { pool.Close() }
 	return user.NewTenantUserStore(pool), rbac.NewStore(pool), NewRoleMappingStore(pool), cleanup
 }
 func uniqueEmail() string {
 	return fmt.Sprintf("ldap-test-%d@example.com", time.Now().UnixNano())
 }
 // Akzeptanzkriterium 3 + Pruefung 1: Rollen-Erlaubnis-Matrix mit Positiv- und
 // Negativfaellen — keine Privilege-Escalation ueber Gruppenmitgliedschaft.
 func TestRoleMapping_PositiveAndNegativeCases(t *testing.T) {
 	_, _, mappings, cleanup := setupTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	if err := mappings.SetMapping(ctx, "cn=IT-Admins,ou=groups,dc=example,dc=com", rbac.RoleTenantAdmin); err != nil {
 		t.Fatalf("set mapping: %v", err)
 	}
 	// Positivfall: gemappte Gruppe liefert die konfigurierte Rolle.
 	role, ok, err := mappings.HighestRoleFor(ctx, []string{"cn=IT-Admins,ou=groups,dc=example,dc=com"})
 	if err != nil {
 		t.Fatalf("highest role: %v", err)
 	}
 	if !ok || role != rbac.RoleTenantAdmin {
 		t.Fatalf("erwartet tenant_admin, habe ok=%v role=%q", ok, role)
 	}
 	// Negativfall 1: unbekannte Gruppe vergibt keine Rolle.
 	_, ok, err = mappings.HighestRoleFor(ctx, []string{"cn=Praktikanten,ou=groups,dc=example,dc=com"})
 	if err != nil {
 		t.Fatalf("highest role (unbekannt): %v", err)
 	}
 	if ok {
 		t.Fatal("erwartet KEINE rolle fuer nicht gemappte gruppe")
 	}
 	// Negativfall 2 (Privilege-Escalation-Versuch): eine Gruppe, die zufaellig
 	// wie eine interne Rolle heisst, aber NIE explizit gemappt wurde, darf
 	// keine Rolle vergeben.
 	_, ok, err = mappings.HighestRoleFor(ctx, []string{"tenant_admin", "superadmin"})
 	if err != nil {
 		t.Fatalf("highest role (namens-trick): %v", err)
 	}
 	if ok {
 		t.Fatal("erwartet KEINE privilege-escalation ueber gruppennamen, die wie rollen aussehen")
 	}
 }
 // Akzeptanzkriterium 1: Synchronisationslauf legt Benutzer an.
 func TestSyncer_CreatesUsers(t *testing.T) {
 	users, roles, mappings, cleanup := setupTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	email := uniqueEmail()
 	client := &fakeClient{entries: []Entry{{Email: email, Name: "LDAP Nutzer"}}}
 	syncer := NewSyncer(client, users, roles, mappings)
 	result, err := syncer.Run(ctx)
 	if err != nil {
 		t.Fatalf("run: %v", err)
 	}
 	if result.Created != 1 {
 		t.Fatalf("erwartet 1 angelegten benutzer, habe %d", result.Created)
 	}
 	if _, err := users.GetByEmailForAuth(ctx, email); err != nil {
 		t.Fatalf("benutzer sollte existieren: %v", err)
 	}
 }
 // Akzeptanzkriterium 2 + Pruefung 2: fehlerhafte/nicht erreichbare LDAP-
 // Quelle bricht kontrolliert ab, ohne bestehende Konten zu beschaedigen.
 func TestSyncer_AbortsCleanlyOnSourceError(t *testing.T) {
 	users, roles, mappings, cleanup := setupTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	// Ein bereits bestehendes Konto, das UNBERUEHRT bleiben muss.
 	existingEmail := uniqueEmail()
 	existing, err := users.Create(ctx, existingEmail, "Bestehender Nutzer")
 	if err != nil {
 		t.Fatalf("create existing: %v", err)
 	}
 	client := &fakeClient{err: errors.New("ldap-server nicht erreichbar (simuliert)")}
 	syncer := NewSyncer(client, users, roles, mappings)
 	if _, err := syncer.Run(ctx); err == nil {
 		t.Fatal("erwartet fehler bei nicht erreichbarer ldap-quelle")
 	}
 	// Bestehendes Konto unveraendert (noch aktiv, keine geloeschten/neuen Zeilen).
 	got, err := users.Get(ctx, existing.ID)
 	if err != nil {
 		t.Fatalf("bestehendes konto sollte weiterhin existieren: %v", err)
 	}
 	if got.Status != user.StatusActive {
 		t.Fatalf("bestehendes konto sollte unveraendert aktiv sein, ist %q", got.Status)
 	}
 }
 // Akzeptanzkriterium 3 + Pruefung 3: Deaktivierung in LDAP wird bei
 // naechster Synchronisation korrekt uebernommen.
 func TestSyncer_AppliesDeactivationOnNextRun(t *testing.T) {
 	users, roles, mappings, cleanup := setupTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	email := uniqueEmail()
 	client := &fakeClient{entries: []Entry{{Email: email, Name: "Wird Deaktiviert"}}}
 	syncer := NewSyncer(client, users, roles, mappings)
 	if _, err := syncer.Run(ctx); err != nil {
 		t.Fatalf("erster lauf: %v", err)
 	}
 	u, err := users.GetByEmailForAuth(ctx, email)
 	if err != nil {
 		t.Fatalf("benutzer nach erstem lauf: %v", err)
 	}
 	if u.User.Status != user.StatusActive {
 		t.Fatalf("erwartet aktiv nach erstem lauf, habe %q", u.User.Status)
 	}
 	// Zweiter Lauf: derselbe Benutzer ist jetzt in LDAP deaktiviert.
 	client.entries[0].Disabled = true
 	result, err := syncer.Run(ctx)
 	if err != nil {
 		t.Fatalf("zweiter lauf: %v", err)
 	}
 	if result.Deactivated != 1 {
 		t.Fatalf("erwartet 1 deaktivierung, habe %d", result.Deactivated)
 	}
 	u, err = users.GetByEmailForAuth(ctx, email)
 	if err != nil {
 		t.Fatalf("benutzer nach zweitem lauf: %v", err)
 	}
 	if u.User.Status != user.StatusInactive {
 		t.Fatalf("erwartet inaktiv nach deaktivierung in ldap, habe %q", u.User.Status)
 	}
 }
@@ -1,79 +0,0 @@
 package ldapsync
 import (
 	"context"
 	"errors"
 	"fmt"
 	"github.com/jackc/pgx/v5"
 	"github.com/jackc/pgx/v5/pgxpool"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 )
 // RoleMappingStore verwaltet die Erlaubnis-Matrix LDAP-Gruppe -> Rolle
 // (Akzeptanzkriterium 3). Nur explizit gemappte Gruppen vergeben eine Rolle
 // — der Schutz gegen Privilege-Escalation ist strukturell: es gibt keinen
 // Code-Pfad, der eine unbekannte Gruppe irgendeiner Rolle zuordnet.
 type RoleMappingStore struct {
 	pool *pgxpool.Pool
 }
 func NewRoleMappingStore(pool *pgxpool.Pool) *RoleMappingStore {
 	return &RoleMappingStore{pool: pool}
 }
 // SetMapping ordnet eine LDAP-Gruppe genau einer NEXARCH-Rolle zu. Nur
 // 'user'/'tenant_admin' sind zuweisbar (dieselbe Matrix wie RBAC-01/03) —
 // 'superadmin' bleibt mandantenuebergreifend und nie ueber LDAP erreichbar.
 func (s *RoleMappingStore) SetMapping(ctx context.Context, ldapGroup string, role rbac.Role) error {
 	if role != rbac.RoleUser && role != rbac.RoleTenantAdmin {
 		return fmt.Errorf("ldapsync: rolle %q ist ueber ldap nicht zuweisbar", role)
 	}
 	_, err := s.pool.Exec(ctx, `
 		INSERT INTO ldap_group_role_mapping (ldap_group, role) VALUES ($1, $2)
 		ON CONFLICT (ldap_group) DO UPDATE SET role = $2
 	`, ldapGroup, string(role))
 	if err != nil {
 		return fmt.Errorf("gruppenzuordnung speichern: %w", err)
 	}
 	return nil
 }
 // roleFor liefert die einer LDAP-Gruppe zugeordnete Rolle, sofern konfiguriert.
 func (s *RoleMappingStore) roleFor(ctx context.Context, ldapGroup string) (rbac.Role, bool, error) {
 	var role string
 	err := s.pool.QueryRow(ctx, `SELECT role FROM ldap_group_role_mapping WHERE ldap_group = $1`, ldapGroup).Scan(&role)
 	if err != nil {
 		if errors.Is(err, pgx.ErrNoRows) {
 			return "", false, nil
 		}
 		return "", false, fmt.Errorf("gruppenzuordnung lesen: %w", err)
 	}
 	return rbac.Role(role), true, nil
 }
 // HighestRoleFor bestimmt aus einer Liste von LDAP-Gruppen die hoechste
 // zugeordnete Rolle (tenant_admin > user). Gruppen ohne Eintrag in der
 // Matrix tragen NICHTS bei — auch nicht, wenn ihr Name zufaellig wie eine
 // interne Rolle aussieht (Akzeptanzkriterium 3 / Pruefung 1: keine
 // Privilege-Escalation ueber Gruppenmitgliedschaft).
 func (s *RoleMappingStore) HighestRoleFor(ctx context.Context, ldapGroups []string) (rbac.Role, bool, error) {
 	var best rbac.Role
 	found := false
 	for _, g := range ldapGroups {
 		role, ok, err := s.roleFor(ctx, g)
 		if err != nil {
 			return "", false, err
 		}
 		if !ok {
 			continue
 		}
 		if !found || role == rbac.RoleTenantAdmin {
 			best = role
 			found = true
 		}
 	}
 	return best, found, nil
 }
@@ -1,93 +0,0 @@
 package ldapsync
 import (
 	"context"
 	"errors"
 	"fmt"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 	"gitea.perlbach24.de/scripte/nexarch/internal/user"
 )
 // SyncResult fasst das Ergebnis eines Synchronisationslaufs zusammen.
 type SyncResult struct {
 	Created     int
 	Updated     int
 	Deactivated int
 	Failed      []string // Email-Adressen, bei denen die Verarbeitung fehlschlug
 }
 // Syncer fuehrt die Benutzer-/Rollen-Synchronisation aus LDAP aus.
 type Syncer struct {
 	client   Client
 	users    *user.TenantUserStore
 	roles    *rbac.Store
 	mappings *RoleMappingStore
 }
 func NewSyncer(client Client, users *user.TenantUserStore, roles *rbac.Store, mappings *RoleMappingStore) *Syncer {
 	return &Syncer{client: client, users: users, roles: roles, mappings: mappings}
 }
 // Run synchronisiert Benutzer aus LDAP (Akzeptanzkriterium 1). Ist die
 // LDAP-Quelle nicht erreichbar/fehlerhaft, wird SOFORT und OHNE jede
 // Aenderung an bestehenden Konten abgebrochen (Akzeptanzkriterium 2 /
 // Pruefung 2) — Search() wird als allererstes aufgerufen, bevor irgendein
 // Schreibzugriff stattfindet.
 func (s *Syncer) Run(ctx context.Context) (SyncResult, error) {
 	entries, err := s.client.Search()
 	if err != nil {
 		return SyncResult{}, fmt.Errorf("ldap-quelle nicht erreichbar, synchronisation abgebrochen: %w", err)
 	}
 	var result SyncResult
 	for _, entry := range entries {
 		if err := s.syncOne(ctx, entry, &result); err != nil {
 			// Ein fehlerhafter Einzeleintrag isoliert sich selbst — er
 			// beschaedigt weder bereits verarbeitete noch nachfolgende
 			// Konten (Akzeptanzkriterium 2).
 			result.Failed = append(result.Failed, entry.Email)
 		}
 	}
 	return result, nil
 }
 func (s *Syncer) syncOne(ctx context.Context, entry Entry, result *SyncResult) error {
 	existing, err := s.users.GetByEmailForAuth(ctx, entry.Email)
 	isNew := errors.Is(err, user.ErrNotFound)
 	if err != nil && !isNew {
 		return err
 	}
 	var userID string
 	if isNew {
 		created, err := s.users.Create(ctx, entry.Email, entry.Name)
 		if err != nil {
 			return err
 		}
 		userID = created.ID
 		result.Created++
 	} else {
 		userID = existing.User.ID
 		result.Updated++
 	}
 	// Deaktivierung in LDAP wird uebernommen (Akzeptanzkriterium 3 / Pruefung 3).
 	if entry.Disabled {
 		if _, err := s.users.Deactivate(ctx, userID); err != nil {
 			return err
 		}
 		result.Deactivated++
 	}
 	role, ok, err := s.mappings.HighestRoleFor(ctx, entry.Groups)
 	if err != nil {
 		return err
 	}
 	if ok {
 		if _, err := s.roles.Assign(ctx, userID, role, "ldap-sync"); err != nil {
 			return err
 		}
 	}
 	return nil
 }
@@ -1,78 +0,0 @@
 // Package oidc implementiert Core IAM-06: SSO-Anmeldung ueber OpenID
 // Connect gegen externe Identity-Provider.
 //
 // WICHTIGER HINWEIS: In dieser Umgebung ist kein registrierter externer
 // OIDC-Provider (Client-ID/Secret bei Google/Okta/Azure AD o.ae.) verfuegbar,
 // gegen den ein echter Authorization-Code-Redirect-Flow end-to-end
 // durchgefuehrt werden koennte (analog AUD-05/Archive, IAM-05/LDAP). ANDERS
 // als bei LDAP/Archive ist die eigentliche Token-VALIDIERUNG (JWKS-
 // Signaturpruefung, Ablauf, Claims, Nonce/State) aber ein rein
 // kryptographischer Vorgang ohne Netzwerkabhaengigkeit zur Testzeit — die
 // Tests unten erzeugen ein eigenes RSA-Schluesselpaar, signieren ein
 // ID-Token selbst und pruefen es exakt so, wie es ein echter Provider
 // liefern wuerde. Nur der Redirect zu einem echten externen Provider bleibt
 // ungeprueft.
 package oidc
 import (
 	"crypto/rsa"
 	"encoding/base64"
 	"encoding/binary"
 	"encoding/json"
 	"errors"
 	"fmt"
 	"math/big"
 )
 type jwk struct {
 	Kid string `json:"kid"`
 	Kty string `json:"kty"`
 	N   string `json:"n"`
 	E   string `json:"e"`
 }
 type jwkSet struct {
 	Keys []jwk `json:"keys"`
 }
 var ErrUnsupportedKeyType = errors.New("oidc: nicht unterstuetzter jwk-schluesseltyp")
 // ParseJWKS dekodiert eine JWKS-Antwort (RFC 7517) in kid -> RSA-Public-Key.
 // Nur RSA-Schluessel (kty=RSA, Standard bei allen gaengigen OIDC-Providern
 // fuer ID-Tokens) werden unterstuetzt.
 func ParseJWKS(data []byte) (map[string]*rsa.PublicKey, error) {
 	var set jwkSet
 	if err := json.Unmarshal(data, &set); err != nil {
 		return nil, fmt.Errorf("jwks parsen: %w", err)
 	}
 	out := make(map[string]*rsa.PublicKey, len(set.Keys))
 	for _, k := range set.Keys {
 		if k.Kty != "RSA" {
 			continue
 		}
 		pub, err := decodeRSAKey(k)
 		if err != nil {
 			return nil, fmt.Errorf("schluessel %q dekodieren: %w", k.Kid, err)
 		}
 		out[k.Kid] = pub
 	}
 	return out, nil
 }
 func decodeRSAKey(k jwk) (*rsa.PublicKey, error) {
 	nBytes, err := base64.RawURLEncoding.DecodeString(k.N)
 	if err != nil {
 		return nil, fmt.Errorf("modulus dekodieren: %w", err)
 	}
 	eBytes, err := base64.RawURLEncoding.DecodeString(k.E)
 	if err != nil {
 		return nil, fmt.Errorf("exponent dekodieren: %w", err)
 	}
 	eBuf := make([]byte, 8)
 	copy(eBuf[8-len(eBytes):], eBytes)
 	e := int(binary.BigEndian.Uint64(eBuf))
 	return &rsa.PublicKey{N: new(big.Int).SetBytes(nBytes), E: e}, nil
 }
@@ -1,69 +0,0 @@
 package oidc
 import (
 	"context"
 	"errors"
 	"fmt"
 	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
 	"gitea.perlbach24.de/scripte/nexarch/internal/ldapsync"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 	"gitea.perlbach24.de/scripte/nexarch/internal/user"
 )
 // CompleteOIDCLogin verifiziert das ID-Token (Signatur, Ablauf, Aussteller,
 // Nonce — Akzeptanzkriterium 3), loest den State einmalig ein
 // (Akzeptanzkriterium/Pruefung 3), legt bei Bedarf einen lokalen Benutzer an
 // und mapped Rollen aus den OIDC-Claims ueber DIESELBE Erlaubnis-Matrix wie
 // IAM-05/LDAP (ldapsync.RoleMappingStore — kein zweiter, paralleler
 // Mapping-Mechanismus, Akzeptanzkriterium 2). Bei Erfolg wird ein normales
 // IAM-02-Sitzungs-Token ausgestellt.
 func CompleteOIDCLogin(
 	ctx context.Context,
 	verifier *Verifier,
 	states *StateStore,
 	users *user.TenantUserStore,
 	roles *rbac.Store,
 	roleMapping *ldapsync.RoleMappingStore,
 	issuer *auth.TokenIssuer,
 	tenantSlug, state, idToken string,
 ) (token string, err error) {
 	nonce, err := states.Consume(ctx, state)
 	if err != nil {
 		return "", err
 	}
 	claims, err := verifier.VerifyWithNonce(idToken, nonce)
 	if err != nil {
 		return "", err
 	}
 	if claims.Email == "" {
 		return "", fmt.Errorf("%w: id-token ohne e-mail-claim", ErrInvalidToken)
 	}
 	u, err := findOrCreateUser(ctx, users, claims.Email)
 	if err != nil {
 		return "", err
 	}
 	if role, ok, err := roleMapping.HighestRoleFor(ctx, claims.Roles); err != nil {
 		return "", err
 	} else if ok {
 		if _, err := roles.Assign(ctx, u.ID, role, "oidc-sso"); err != nil {
 			return "", err
 		}
 	}
 	return issuer.Issue(u.ID, tenantSlug)
 }
 func findOrCreateUser(ctx context.Context, users *user.TenantUserStore, email string) (user.User, error) {
 	creds, err := users.GetByEmailForAuth(ctx, email)
 	if err == nil {
 		return creds.User, nil
 	}
 	if !errors.Is(err, user.ErrNotFound) {
 		return user.User{}, err
 	}
 	return users.Create(ctx, email, email)
 }
@@ -1,172 +0,0 @@
 package oidc
 import (
 	"context"
 	"crypto/rsa"
 	"fmt"
 	"os"
 	"testing"
 	"time"
 	"github.com/jackc/pgx/v5/pgxpool"
 	"github.com/golang-jwt/jwt/v5"
 	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
 	"gitea.perlbach24.de/scripte/nexarch/internal/ldapsync"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 	"gitea.perlbach24.de/scripte/nexarch/internal/user"
 )
 func setupLoginTest(t *testing.T) (*pgxpool.Pool, func()) {
 	t.Helper()
 	adminDSN := os.Getenv("TEST_ADMIN_DSN")
 	if adminDSN == "" {
 		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
 	}
 	ctx := context.Background()
 	pool, err := pgxpool.New(ctx, adminDSN)
 	if err != nil {
 		t.Fatalf("pool: %v", err)
 	}
 	if _, err := pool.Exec(ctx, `
 		CREATE TABLE IF NOT EXISTS 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()
 		);
 		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()
 		);
 		CREATE TABLE IF NOT EXISTS ldap_group_role_mapping (
 			ldap_group TEXT PRIMARY KEY, role TEXT NOT NULL CHECK (role IN ('user','tenant_admin'))
 		);
 		CREATE TABLE IF NOT EXISTS oidc_states (
 			state TEXT PRIMARY KEY, nonce TEXT NOT NULL, expires_at TIMESTAMPTZ NOT NULL,
 			used_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT now()
 		);
 	`); err != nil {
 		t.Fatalf("schema: %v", err)
 	}
 	cleanup := func() { pool.Close() }
 	return pool, cleanup
 }
 // Akzeptanzkriterium 1 + 3: End-to-End-Login gegen ein (selbst signiertes,
 // aber protokollkorrektes) ID-Token — Signatur, Nonce, State, Rollen-Mapping,
 // Sitzungs-Token-Ausstellung.
 func TestCompleteOIDCLogin_EndToEnd(t *testing.T) {
 	pool, cleanup := setupLoginTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	key := generateTestKey(t)
 	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
 	states := NewStateStore(pool)
 	users := user.NewTenantUserStore(pool)
 	roles := rbac.NewStore(pool)
 	roleMapping := ldapsync.NewRoleMappingStore(pool)
 	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
 	if err := roleMapping.SetMapping(ctx, "sso-admins", rbac.RoleTenantAdmin); err != nil {
 		t.Fatalf("set mapping: %v", err)
 	}
 	state, nonce, err := states.Generate(ctx)
 	if err != nil {
 		t.Fatalf("generate state: %v", err)
 	}
 	email := fmt.Sprintf("oidc-test-%d@example.com", time.Now().UnixNano())
 	claims := Claims{
 		Subject: "idp-subject-123",
 		Email:   email,
 		Nonce:   nonce,
 		Roles:   []string{"sso-admins"},
 		RegisteredClaims: jwt.RegisteredClaims{
 			Issuer:    "https://idp.example.com",
 			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
 		},
 	}
 	idToken := signTestToken(t, key, "kid-1", claims)
 	token, err := CompleteOIDCLogin(ctx, verifier, states, users, roles, roleMapping, issuer, "acme", state, idToken)
 	if err != nil {
 		t.Fatalf("complete oidc login: %v", err)
 	}
 	if token == "" {
 		t.Fatal("erwartet nicht-leeres sitzungs-token")
 	}
 	assignment, err := roles.Get(ctx, mustGetUserID(t, ctx, users, email))
 	if err != nil {
 		t.Fatalf("rollenzuweisung lesen: %v", err)
 	}
 	if assignment.Role != rbac.RoleTenantAdmin {
 		t.Fatalf("erwartet tenant_admin aus sso-admins-mapping, habe %q", assignment.Role)
 	}
 	// Replay desselben state schlaegt fehl.
 	if _, err := CompleteOIDCLogin(ctx, verifier, states, users, roles, roleMapping, issuer, "acme", state, idToken); err == nil {
 		t.Fatal("erwartet fehler bei wiederverwendetem state (replay)")
 	}
 }
 // Akzeptanzkriterium 2 + Pruefung 1: keine Privilege-Escalation ueber
 // manipulierte/unbekannte Rollen-Claims.
 func TestCompleteOIDCLogin_UnmappedRoleGrantsNothing(t *testing.T) {
 	pool, cleanup := setupLoginTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	key := generateTestKey(t)
 	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
 	states := NewStateStore(pool)
 	users := user.NewTenantUserStore(pool)
 	roles := rbac.NewStore(pool)
 	roleMapping := ldapsync.NewRoleMappingStore(pool)
 	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
 	state, nonce, err := states.Generate(ctx)
 	if err != nil {
 		t.Fatalf("generate state: %v", err)
 	}
 	email := fmt.Sprintf("oidc-test-%d@example.com", time.Now().UnixNano())
 	claims := Claims{
 		Email: email,
 		Nonce: nonce,
 		// Versuch, sich ueber einen manipulierten Rollen-Claim
 		// hochzustufen — diese Gruppen wurden NIE gemappt.
 		Roles: []string{"tenant_admin", "superadmin"},
 		RegisteredClaims: jwt.RegisteredClaims{
 			Issuer:    "https://idp.example.com",
 			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
 		},
 	}
 	idToken := signTestToken(t, key, "kid-1", claims)
 	if _, err := CompleteOIDCLogin(ctx, verifier, states, users, roles, roleMapping, issuer, "acme", state, idToken); err != nil {
 		t.Fatalf("complete oidc login: %v", err)
 	}
 	userID := mustGetUserID(t, ctx, users, email)
 	if _, err := roles.Get(ctx, userID); err == nil {
 		t.Fatal("erwartet KEINE rollenzuweisung fuer nicht gemappte claims (privilege-escalation-versuch)")
 	}
 }
 func mustGetUserID(t *testing.T, ctx context.Context, users *user.TenantUserStore, email string) string {
 	t.Helper()
 	creds, err := users.GetByEmailForAuth(ctx, email)
 	if err != nil {
 		t.Fatalf("get user by email: %v", err)
 	}
 	return creds.User.ID
 }
@@ -1,76 +0,0 @@
 package oidc
 import (
 	"context"
 	"crypto/rand"
 	"encoding/hex"
 	"errors"
 	"fmt"
 	"time"
 	"github.com/jackc/pgx/v5"
 	"github.com/jackc/pgx/v5/pgxpool"
 )
 var ErrStateInvalid = errors.New("oidc: state ungueltig, bereits verwendet oder abgelaufen")
 // DefaultStateTTL begrenzt, wie lange ein ausgestellter State/Nonce fuer den
 // Redirect-Umweg zum Identity-Provider gueltig bleibt.
 const DefaultStateTTL = 10 * time.Minute
 type StateStore struct {
 	pool *pgxpool.Pool
 }
 func NewStateStore(pool *pgxpool.Pool) *StateStore {
 	return &StateStore{pool: pool}
 }
 // Generate stellt state+nonce fuer einen neuen Login-Redirect aus. state
 // wird als OAuth2-"state"-Parameter mitgeschickt (CSRF-Schutz), nonce
 // erscheint spaeter im ID-Token und muss exakt uebereinstimmen (Replay-Schutz).
 func (s *StateStore) Generate(ctx context.Context) (state, nonce string, err error) {
 	state, err = randomValue()
 	if err != nil {
 		return "", "", err
 	}
 	nonce, err = randomValue()
 	if err != nil {
 		return "", "", err
 	}
 	_, err = s.pool.Exec(ctx, `
 		INSERT INTO oidc_states (state, nonce, expires_at) VALUES ($1, $2, $3)
 	`, state, nonce, time.Now().Add(DefaultStateTTL))
 	if err != nil {
 		return "", "", fmt.Errorf("state speichern: %w", err)
 	}
 	return state, nonce, nil
 }
 // Consume loest einen State EINMALIG ein (Akzeptanzkriterium/Pruefung 3:
 // Replay-Schutz) — atomar ueber WHERE used_at IS NULL, analog IAM-03/IAM-09.
 // Ein zweiter Callback mit demselben state (z.B. durch einen Angreifer, der
 // die Redirect-URL abgefangen hat) schlaegt fehl.
 func (s *StateStore) Consume(ctx context.Context, state string) (nonce string, err error) {
 	err = s.pool.QueryRow(ctx, `
 		UPDATE oidc_states SET used_at = now()
 		WHERE state = $1 AND used_at IS NULL AND expires_at > now()
 		RETURNING nonce
 	`, state).Scan(&nonce)
 	if err != nil {
 		if errors.Is(err, pgx.ErrNoRows) {
 			return "", ErrStateInvalid
 		}
 		return "", fmt.Errorf("state einloesen: %w", err)
 	}
 	return nonce, nil
 }
 func randomValue() (string, error) {
 	buf := make([]byte, 32)
 	if _, err := rand.Read(buf); err != nil {
 		return "", err
 	}
 	return hex.EncodeToString(buf), nil
 }
@@ -1,68 +0,0 @@
 package oidc
 import (
 	"context"
 	"errors"
 	"os"
 	"testing"
 	"github.com/jackc/pgx/v5/pgxpool"
 )
 func setupStateTest(t *testing.T) (*StateStore, 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 oidc_states (
 			state TEXT PRIMARY KEY, nonce TEXT NOT NULL, expires_at TIMESTAMPTZ NOT NULL,
 			used_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT now()
 		)`); err != nil {
 		t.Fatalf("schema: %v", err)
 	}
 	cleanup := func() { pool.Close() }
 	return NewStateStore(pool), cleanup
 }
 // Akzeptanzkriterium/Pruefung 3: State/Nonce-Handling gegen CSRF und Replay.
 func TestStateStore_ConsumeIsSingleUse(t *testing.T) {
 	store, cleanup := setupStateTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	state, nonce, err := store.Generate(ctx)
 	if err != nil {
 		t.Fatalf("generate: %v", err)
 	}
 	gotNonce, err := store.Consume(ctx, state)
 	if err != nil {
 		t.Fatalf("consume (erste einloesung): %v", err)
 	}
 	if gotNonce != nonce {
 		t.Fatalf("nonce = %q, want %q", gotNonce, nonce)
 	}
 	if _, err := store.Consume(ctx, state); !errors.Is(err, ErrStateInvalid) {
 		t.Fatalf("erwartet ErrStateInvalid bei erneutem einloesen (replay), habe %v", err)
 	}
 }
 func TestStateStore_RejectsUnknownState(t *testing.T) {
 	store, cleanup := setupStateTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	if _, err := store.Consume(ctx, "niemals-ausgestellter-state"); !errors.Is(err, ErrStateInvalid) {
 		t.Fatalf("erwartet ErrStateInvalid, habe %v", err)
 	}
 }
@@ -1,70 +0,0 @@
 package oidc
 import (
 	"crypto/rsa"
 	"errors"
 	"fmt"
 	"github.com/golang-jwt/jwt/v5"
 )
 var ErrInvalidToken = errors.New("oidc: id-token ungueltig, abgelaufen oder falscher aussteller")
 // Claims sind die fuer NEXARCH relevanten OIDC-ID-Token-Claims.
 type Claims struct {
 	Subject string   `json:"sub"`
 	Email   string   `json:"email"`
 	Nonce   string   `json:"nonce"`
 	Roles   []string `json:"roles"` // providerabhaengiger Claim-Name, hier vereinfacht fest "roles"
 	jwt.RegisteredClaims
 }
 // Verifier prueft ID-Tokens gegen den JWKS-Schluesselsatz eines konfigurierten
 // Providers (Akzeptanzkriterium 3: fehlerhafte/abgelaufene Tokens werden
 // abgewiesen).
 type Verifier struct {
 	keys   map[string]*rsa.PublicKey
 	issuer string
 }
 func NewVerifier(keys map[string]*rsa.PublicKey, issuer string) *Verifier {
 	return &Verifier{keys: keys, issuer: issuer}
 }
 // Verify prueft Signatur (gegen JWKS), Ablauf (jwt-Bibliothek lehnt
 // abgelaufene Tokens automatisch ab) und Aussteller.
 func (v *Verifier) Verify(idToken string) (*Claims, error) {
 	claims := &Claims{}
 	token, err := jwt.ParseWithClaims(idToken, claims, func(t *jwt.Token) (interface{}, error) {
 		if _, ok := t.Method.(*jwt.SigningMethodRSA); !ok {
 			return nil, ErrInvalidToken
 		}
 		kid, _ := t.Header["kid"].(string)
 		key, ok := v.keys[kid]
 		if !ok {
 			return nil, ErrInvalidToken
 		}
 		return key, nil
 	})
 	if err != nil || !token.Valid {
 		return nil, ErrInvalidToken
 	}
 	if claims.Issuer != v.issuer {
 		return nil, fmt.Errorf("%w: unerwarteter aussteller %q", ErrInvalidToken, claims.Issuer)
 	}
 	return claims, nil
 }
 // VerifyWithNonce prueft zusaetzlich, dass der nonce-Claim im Token exakt
 // dem bei der Anfrage ausgestellten Nonce entspricht — verhindert Replay
 // eines fremden, gueltigen ID-Tokens (Akzeptanzkriterium/Pruefung 3).
 func (v *Verifier) VerifyWithNonce(idToken, expectedNonce string) (*Claims, error) {
 	claims, err := v.Verify(idToken)
 	if err != nil {
 		return nil, err
 	}
 	if claims.Nonce == "" || claims.Nonce != expectedNonce {
 		return nil, fmt.Errorf("%w: nonce stimmt nicht ueberein", ErrInvalidToken)
 	}
 	return claims, nil
 }
@@ -1,184 +0,0 @@
 package oidc
 import (
 	"crypto/rand"
 	"crypto/rsa"
 	"encoding/base64"
 	"encoding/binary"
 	"encoding/json"
 	"testing"
 	"time"
 	"github.com/golang-jwt/jwt/v5"
 )
 func generateTestKey(t *testing.T) *rsa.PrivateKey {
 	t.Helper()
 	key, err := rsa.GenerateKey(rand.Reader, 2048)
 	if err != nil {
 		t.Fatalf("generate rsa key: %v", err)
 	}
 	return key
 }
 func signTestToken(t *testing.T, key *rsa.PrivateKey, kid string, claims Claims) string {
 	t.Helper()
 	token := jwt.NewWithClaims(jwt.SigningMethodRS256, claims)
 	token.Header["kid"] = kid
 	s, err := token.SignedString(key)
 	if err != nil {
 		t.Fatalf("sign token: %v", err)
 	}
 	return s
 }
 func TestVerify_AcceptsValidToken(t *testing.T) {
 	key := generateTestKey(t)
 	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
 	claims := Claims{
 		Subject: "user-123",
 		Email:   "person@example.com",
 		Nonce:   "erwarteter-nonce",
 		RegisteredClaims: jwt.RegisteredClaims{
 			Issuer:    "https://idp.example.com",
 			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
 		},
 	}
 	tok := signTestToken(t, key, "kid-1", claims)
 	got, err := verifier.Verify(tok)
 	if err != nil {
 		t.Fatalf("verify: %v", err)
 	}
 	if got.Email != "person@example.com" {
 		t.Fatalf("email = %q", got.Email)
 	}
 }
 // Akzeptanzkriterium 3 + Pruefung 2: Token-Signatur- und Ablaufpruefung.
 func TestVerify_RejectsExpiredToken(t *testing.T) {
 	key := generateTestKey(t)
 	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
 	claims := Claims{
 		Subject: "user-123",
 		RegisteredClaims: jwt.RegisteredClaims{
 			Issuer:    "https://idp.example.com",
 			ExpiresAt: jwt.NewNumericDate(time.Now().Add(-time.Hour)), // abgelaufen
 		},
 	}
 	tok := signTestToken(t, key, "kid-1", claims)
 	if _, err := verifier.Verify(tok); err == nil {
 		t.Fatal("erwartet fehler bei abgelaufenem token")
 	}
 }
 func TestVerify_RejectsWrongSigningKey(t *testing.T) {
 	realKey := generateTestKey(t)
 	attackerKey := generateTestKey(t)
 	// Verifier kennt NUR den echten oeffentlichen Schluessel.
 	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &realKey.PublicKey}, "https://idp.example.com")
 	claims := Claims{
 		Subject: "user-123",
 		RegisteredClaims: jwt.RegisteredClaims{
 			Issuer:    "https://idp.example.com",
 			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
 		},
 	}
 	// Mit dem Angreifer-Schluessel signiert, aber unter demselben kid wie der echte.
 	tok := signTestToken(t, attackerKey, "kid-1", claims)
 	if _, err := verifier.Verify(tok); err == nil {
 		t.Fatal("erwartet fehler bei fremd signiertem token")
 	}
 }
 func TestVerify_RejectsWrongIssuer(t *testing.T) {
 	key := generateTestKey(t)
 	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
 	claims := Claims{
 		Subject: "user-123",
 		RegisteredClaims: jwt.RegisteredClaims{
 			Issuer:    "https://ganz-anderer-idp.example.com",
 			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
 		},
 	}
 	tok := signTestToken(t, key, "kid-1", claims)
 	if _, err := verifier.Verify(tok); err == nil {
 		t.Fatal("erwartet fehler bei unerwartetem aussteller")
 	}
 }
 // Akzeptanzkriterium/Pruefung 3: Nonce-Handling gegen Replay.
 func TestVerifyWithNonce_RejectsMismatch(t *testing.T) {
 	key := generateTestKey(t)
 	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
 	claims := Claims{
 		Subject: "user-123",
 		Nonce:   "nonce-a",
 		RegisteredClaims: jwt.RegisteredClaims{
 			Issuer:    "https://idp.example.com",
 			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
 		},
 	}
 	tok := signTestToken(t, key, "kid-1", claims)
 	if _, err := verifier.VerifyWithNonce(tok, "nonce-b"); err == nil {
 		t.Fatal("erwartet fehler bei nonce-mismatch (moeglicher replay eines fremden tokens)")
 	}
 	if _, err := verifier.VerifyWithNonce(tok, "nonce-a"); err != nil {
 		t.Fatalf("erwartet erfolg bei passendem nonce: %v", err)
 	}
 }
 func TestParseJWKS_RoundTrip(t *testing.T) {
 	key := generateTestKey(t)
 	nBytes := key.PublicKey.N.Bytes()
 	eBuf := make([]byte, 8)
 	binary.BigEndian.PutUint64(eBuf, uint64(key.PublicKey.E))
 	// Fuehrende Nullbytes des Exponenten abschneiden (ueblich bei JWK-Kodierung).
 	eStart := 0
 	for eStart < len(eBuf)-1 && eBuf[eStart] == 0 {
 		eStart++
 	}
 	set := jwkSet{Keys: []jwk{{
 		Kid: "kid-1",
 		Kty: "RSA",
 		N:   base64.RawURLEncoding.EncodeToString(nBytes),
 		E:   base64.RawURLEncoding.EncodeToString(eBuf[eStart:]),
 	}}}
 	data, err := json.Marshal(set)
 	if err != nil {
 		t.Fatalf("marshal: %v", err)
 	}
 	parsed, err := ParseJWKS(data)
 	if err != nil {
 		t.Fatalf("parse jwks: %v", err)
 	}
 	got, ok := parsed["kid-1"]
 	if !ok {
 		t.Fatal("erwartet kid-1 im ergebnis")
 	}
 	if got.E != key.PublicKey.E || got.N.Cmp(key.PublicKey.N) != 0 {
 		t.Fatalf("erwartet identischen oeffentlichen schluessel nach roundtrip")
 	}
 	// Der wiederhergestellte Schluessel muss ein damit signiertes Token auch tatsaechlich verifizieren.
 	verifier := NewVerifier(parsed, "https://idp.example.com")
 	claims := Claims{Subject: "x", RegisteredClaims: jwt.RegisteredClaims{
 		Issuer: "https://idp.example.com", ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
 	}}
 	tok := signTestToken(t, key, "kid-1", claims)
 	if _, err := verifier.Verify(tok); err != nil {
 		t.Fatalf("verify mit aus jwks wiederhergestelltem schluessel: %v", err)
 	}
 }
@@ -0,0 +1,67 @@
 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)
 }
@@ -0,0 +1,90 @@
 package policy
 import (
 	"context"
 	"errors"
 	"fmt"
 	"github.com/jackc/pgx/v5"
 	"gitea.perlbach24.de/scripte/nexarch/internal/flag"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 )
 // ModuleScope verknuepft eine Policy-Regel mit einem Feature-Flag: existiert
 // ein ModuleScope fuer (role, permission), gilt die Regel nur zusaetzlich zur
 // Grundberechtigung, wenn FlagKey fuer den jeweiligen Tenant aktiv ist
 // (Akzeptanzkriterium 1: Rechte folgen der Lizenz).
 type ModuleScope struct {
 	Role       rbac.Role
 	Permission rbac.Permission
 	Module     string
 	FlagKey    string
 }
 // SetModuleScope verknuepft eine bestehende Policy-Regel mit einem Modul/
 // Feature-Flag. Die Regel selbst (Store.Grant) muss unabhaengig davon
 // existieren — ModuleScope schraenkt sie nur zusaetzlich ein.
 func (s *Store) SetModuleScope(ctx context.Context, role rbac.Role, perm rbac.Permission, module, flagKey string) error {
 	_, err := s.pool.Exec(ctx, `
 		INSERT INTO policy_module_scopes (role, permission, module, flag_key)
 		VALUES ($1, $2, $3, $4)
 		ON CONFLICT (role, permission) DO UPDATE SET module = $3, flag_key = $4
 	`, string(role), string(perm), module, flagKey)
 	if err != nil {
 		return fmt.Errorf("modul-scope setzen: %w", err)
 	}
 	return nil
 }
 func (s *Store) GetModuleScope(ctx context.Context, role rbac.Role, perm rbac.Permission) (ModuleScope, bool, error) {
 	var ms ModuleScope
 	ms.Role, ms.Permission = role, perm
 	err := s.pool.QueryRow(ctx, `
 		SELECT module, flag_key FROM policy_module_scopes WHERE role = $1 AND permission = $2
 	`, string(role), string(perm)).Scan(&ms.Module, &ms.FlagKey)
 	if err != nil {
 		if errors.Is(err, pgx.ErrNoRows) {
 			return ModuleScope{}, false, nil
 		}
 		return ModuleScope{}, false, fmt.Errorf("modul-scope lesen: %w", err)
 	}
 	return ms, true, nil
 }
 // AuthorizeForTenant ist dieselbe zentrale Entscheidungsfunktion wie
 // Authorize (Akzeptanzkriterium 3: keine zweite Enforcement-Schicht),
 // erweitert um die Modul-Scoping-Pruefung: eine sonst passende Regel greift
 // NICHT, wenn das zugehoerige Modul fuer den Tenant nicht aktiviert ist
 // (Akzeptanzkriterium 1). Feature-Flag-Aenderungen wirken ohne Neustart
 // (Akzeptanzkriterium 2), da flag.Service dieselbe TTL-Cache-Instanz der
 // aufrufenden Core-Instanz nutzt.
 func (e *Enforcer) AuthorizeForTenant(ctx context.Context, flags *flag.Service, tenantSlug string, role rbac.Role, perm rbac.Permission) error {
 	if err := e.Authorize(ctx, role, perm); err != nil {
 		return err
 	}
 	scope, found, err := e.store.GetModuleScope(ctx, role, perm)
 	if err != nil {
 		return err
 	}
 	if !found {
 		return nil // keine Modul-Bindung fuer diese Regel — Grundberechtigung reicht.
 	}
 	if !flags.IsEnabled(ctx, tenantSlug, scope.FlagKey) {
 		return fmt.Errorf("%w: modul %q ist fuer diesen mandanten nicht aktiviert", ErrDenied, scope.Module)
 	}
 	return nil
 }
 // GuardModuleScoped ist Guard mit zusaetzlicher Modul-Scoping-Pruefung —
 // dieselbe zentrale Enforcement-Funktion, kein paralleler Mechanismus
 // (Akzeptanzkriterium 3).
 func GuardModuleScoped[T any](ctx context.Context, e *Enforcer, flags *flag.Service, tenantSlug string, role rbac.Role, perm rbac.Permission, query func(ctx context.Context) (T, error)) (T, error) {
 	var zero T
 	if err := e.AuthorizeForTenant(ctx, flags, tenantSlug, role, perm); err != nil {
 		return zero, err
 	}
 	return query(ctx)
 }
@@ -0,0 +1,170 @@
 package policy
 import (
 	"context"
 	"errors"
 	"os"
 	"testing"
 	"time"
 	"github.com/jackc/pgx/v5/pgxpool"
 	"gitea.perlbach24.de/scripte/nexarch/internal/flag"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 )
 func setupModuleScopeTest(t *testing.T) (*Store, *Enforcer, *flag.Store, *flag.Service, 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()
 		);
 		CREATE TABLE IF NOT EXISTS policy_module_scopes (
 			role TEXT NOT NULL, permission TEXT NOT NULL, module TEXT NOT NULL, flag_key TEXT NOT NULL,
 			PRIMARY KEY (role, permission)
 		);
 		CREATE TABLE IF NOT EXISTS feature_flags (
 			key TEXT PRIMARY KEY, enabled BOOLEAN NOT NULL DEFAULT false,
 			rollout_percentage INT NOT NULL DEFAULT 0, target_tenant_slugs TEXT[] NOT NULL DEFAULT '{}',
 			updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
 		);
 	`); err != nil {
 		t.Fatalf("schema: %v", err)
 	}
 	store := NewStore(pool)
 	flagStore := flag.NewStore(pool)
 	flagService := flag.NewService(flagStore, 10*time.Millisecond) // kurze TTL fuer testbare invalidierung
 	cleanup := func() {
 		_, _ = pool.Exec(ctx, `DELETE FROM policy_module_scopes WHERE role LIKE 'test\_%' ESCAPE '\'`)
 		_, _ = 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.Exec(ctx, `DELETE FROM feature_flags WHERE key LIKE 'test\_%' ESCAPE '\'`)
 		pool.Close()
 	}
 	return store, NewEnforcer(store), flagStore, flagService, cleanup
 }
 // Akzeptanzkriterium 1 + Pruefung 1: Berechtigung fuer nicht aktiviertes
 // Modul greift nicht, selbst bei sonst passender Rolle.
 func TestAuthorizeForTenant_DeniesWhenModuleNotActivated(t *testing.T) {
 	store, enforcer, _, flagService, cleanup := setupModuleScopeTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	role := rbac.Role("test_dms_nutzer")
 	perm := rbac.Permission("test_dokumente_lesen")
 	if err := store.Grant(ctx, role, perm, "admin@example.com"); err != nil {
 		t.Fatalf("grant: %v", err)
 	}
 	if err := store.SetModuleScope(ctx, role, perm, "dms", "test_dms_enabled"); err != nil {
 		t.Fatalf("set module scope: %v", err)
 	}
 	// Flag existiert nicht/ist nicht gesetzt -> IsEnabled liefert false (Fail-Safe-Default).
 	queryCalled := false
 	_, err := GuardModuleScoped(ctx, enforcer, flagService, "acme", role, perm, func(ctx context.Context) (string, error) {
 		queryCalled = true
 		return "daten", nil
 	})
 	if !errors.Is(err, ErrDenied) {
 		t.Fatalf("erwartet ErrDenied bei deaktiviertem modul, habe %v", err)
 	}
 	if queryCalled {
 		t.Fatal("query haette bei deaktiviertem modul nicht aufgerufen werden duerfen")
 	}
 }
 // Akzeptanzkriterium 2 + Pruefung 2: Aktivierung des Moduls macht die
 // Berechtigung ohne Neustart wirksam.
 func TestAuthorizeForTenant_BecomesActiveWithoutRestart(t *testing.T) {
 	store, enforcer, flagStore, flagService, cleanup := setupModuleScopeTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	role := rbac.Role("test_dms_nutzer2")
 	perm := rbac.Permission("test_dokumente_schreiben")
 	if err := store.Grant(ctx, role, perm, "admin@example.com"); err != nil {
 		t.Fatalf("grant: %v", err)
 	}
 	if err := store.SetModuleScope(ctx, role, perm, "dms", "test_dms_enabled2"); err != nil {
 		t.Fatalf("set module scope: %v", err)
 	}
 	if err := enforcer.AuthorizeForTenant(ctx, flagService, "acme", role, perm); !errors.Is(err, ErrDenied) {
 		t.Fatalf("vor aktivierung: erwartet ErrDenied, habe %v", err)
 	}
 	// Modul "im laufenden Betrieb" aktivieren — derselbe Prozess, kein Neustart.
 	if err := flagStore.Set(ctx, flag.Flag{Key: "test_dms_enabled2", Enabled: true}); err != nil {
 		t.Fatalf("flag setzen: %v", err)
 	}
 	time.Sleep(20 * time.Millisecond) // TTL abwarten statt Neustart
 	if err := enforcer.AuthorizeForTenant(ctx, flagService, "acme", role, perm); err != nil {
 		t.Fatalf("nach aktivierung sollte erlaubt sein: %v", err)
 	}
 }
 // Akzeptanzkriterium 3 + Pruefung 3: Zusammenspiel Modul-Scope + Rollenscope
 // in Kombinationsfaellen.
 func TestAuthorizeForTenant_CombinationsOfRoleAndModuleScope(t *testing.T) {
 	store, enforcer, flagStore, flagService, cleanup := setupModuleScopeTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	scopedRole := rbac.Role("test_scoped_rolle")
 	unscopedRole := rbac.Role("test_unscoped_rolle")
 	perm := rbac.Permission("test_kombiniert")
 	// Fall 1: Rolle ohne jegliche Regel -> verboten, unabhaengig vom Flag.
 	if err := enforcer.AuthorizeForTenant(ctx, flagService, "acme", rbac.Role("test_unbekannt"), perm); !errors.Is(err, ErrDenied) {
 		t.Fatalf("fall 1: erwartet ErrDenied (keine regel), habe %v", err)
 	}
 	// Fall 2: Regel vorhanden, KEIN Modul-Scope -> immer erlaubt (Grundrecht ohne Lizenzbindung).
 	if err := store.Grant(ctx, unscopedRole, perm, "admin@example.com"); err != nil {
 		t.Fatalf("grant unscoped: %v", err)
 	}
 	if err := enforcer.AuthorizeForTenant(ctx, flagService, "acme", unscopedRole, perm); err != nil {
 		t.Fatalf("fall 2: erwartet erlaubt ohne modul-scope, habe %v", err)
 	}
 	// Fall 3: Regel + Modul-Scope, Flag aus -> verboten.
 	if err := store.Grant(ctx, scopedRole, perm, "admin@example.com"); err != nil {
 		t.Fatalf("grant scoped: %v", err)
 	}
 	if err := store.SetModuleScope(ctx, scopedRole, perm, "mail", "test_mail_enabled"); err != nil {
 		t.Fatalf("set module scope: %v", err)
 	}
 	if err := enforcer.AuthorizeForTenant(ctx, flagService, "acme", scopedRole, perm); !errors.Is(err, ErrDenied) {
 		t.Fatalf("fall 3: erwartet ErrDenied (modul aus), habe %v", err)
 	}
 	// Fall 4: Regel + Modul-Scope, Flag an -> erlaubt.
 	if err := flagStore.Set(ctx, flag.Flag{Key: "test_mail_enabled", Enabled: true}); err != nil {
 		t.Fatalf("flag setzen: %v", err)
 	}
 	time.Sleep(20 * time.Millisecond)
 	if err := enforcer.AuthorizeForTenant(ctx, flagService, "acme", scopedRole, perm); err != nil {
 		t.Fatalf("fall 4: erwartet erlaubt (modul an), habe %v", err)
 	}
 }
@@ -0,0 +1,187 @@
 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))
 	}
 }
@@ -0,0 +1,124 @@
 // 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()
 }
@@ -0,0 +1,48 @@
 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")
 	}
 }
@@ -0,0 +1,144 @@
 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,90 +0,0 @@
 // Package saml implementiert Core IAM-11: SAML 2.0 als zusaetzlicher
 // Anmeldeweg neben OIDC (IAM-06).
 //
 // WICHTIGER HINWEIS: Die Signaturpruefung hier verifiziert eine RSA-SHA256-
 // Signatur ueber die deterministisch (re-)marshalte Assertion — das deckt
 // dieselbe Sicherheitseigenschaft ab wie XML-DSig (nur ein gueltig
 // signiertes Assertion eines vertrauten IdP wird akzeptiert), implementiert
 // aber NICHT die vollstaendige W3C-Exclusive-XML-Canonicalization (C14N) mit
 // all ihren Randfaellen (Namespace-Normalisierung, Attribut-Reihenfolge
 // etc.), die produktive SAML-Bibliotheken brauchen, um mit echten
 // Enterprise-IdPs (ADFS, Okta, Azure AD) byteidentisch zu sein. Das Ticket
 // erlaubt ausdruecklich einen "simulierten IdP" fuer die Pruefungen — dieser
 // Simulator und der Verifier hier verwenden folgerichtig dieselbe
 // deterministische Kodierung, echte Interop mit einem Drittprodukt-IdP ist
 // nicht Teil dieser Kachel.
 package saml
 import (
 	"encoding/xml"
 	"fmt"
 	"time"
 )
 type attributeXML struct {
 	Name   string   `xml:"Name,attr"`
 	Values []string `xml:"AttributeValue"`
 }
 type conditionsXML struct {
 	NotBefore    string `xml:"NotBefore,attr"`
 	NotOnOrAfter string `xml:"NotOnOrAfter,attr"`
 }
 // AssertionXML ist die (vereinfachte) SAML-Assertion.
 type AssertionXML struct {
 	XMLName    xml.Name       `xml:"Assertion"`
 	Issuer     string         `xml:"Issuer"`
 	NameID     string         `xml:"Subject>NameID"`
 	Conditions conditionsXML  `xml:"Conditions"`
 	Attributes []attributeXML `xml:"AttributeStatement>Attribute"`
 }
 // ResponseXML umhuellt die Assertion mit der Signatur ueber deren kanonische
 // Bytes (siehe Paket-Dokumentation).
 type ResponseXML struct {
 	XMLName        xml.Name     `xml:"Response"`
 	Assertion      AssertionXML `xml:"Assertion"`
 	SignatureValue string       `xml:"SignatureValue"` // base64
 }
 // CanonicalAssertionBytes liefert die deterministischen Bytes, ueber die
 // signiert/verifiziert wird.
 func CanonicalAssertionBytes(a AssertionXML) ([]byte, error) {
 	b, err := xml.Marshal(a)
 	if err != nil {
 		return nil, fmt.Errorf("assertion serialisieren: %w", err)
 	}
 	return b, nil
 }
 // Attribute liefert die Werte eines benannten SAML-Attributs (z.B. "roles"),
 // oder nil wenn nicht vorhanden.
 func (a AssertionXML) Attribute(name string) []string {
 	for _, attr := range a.Attributes {
 		if attr.Name == name {
 			return attr.Values
 		}
 	}
 	return nil
 }
 // WithinValidity prueft die Conditions/NotBefore/NotOnOrAfter der Assertion
 // gegen die aktuelle Zeit.
 func (a AssertionXML) WithinValidity(now time.Time) error {
 	notBefore, err := time.Parse(time.RFC3339, a.Conditions.NotBefore)
 	if err != nil {
 		return fmt.Errorf("notbefore parsen: %w", err)
 	}
 	notOnOrAfter, err := time.Parse(time.RFC3339, a.Conditions.NotOnOrAfter)
 	if err != nil {
 		return fmt.Errorf("notonorafter parsen: %w", err)
 	}
 	if now.Before(notBefore) {
 		return ErrNotYetValid
 	}
 	if !now.Before(notOnOrAfter) {
 		return ErrExpired
 	}
 	return nil
 }
@@ -1,66 +0,0 @@
 package saml
 import (
 	"context"
 	"errors"
 	"fmt"
 	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
 	"gitea.perlbach24.de/scripte/nexarch/internal/ldapsync"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 	"gitea.perlbach24.de/scripte/nexarch/internal/user"
 )
 // CompleteSAMLLogin verifiziert die SAML-Response, bildet die Assertion auf
 // das bestehende Benutzer-/Rollenmodell ab (Akzeptanzkriterium 3) und
 // stellt bei Erfolg ein IAM-02-Sitzungs-Token aus. Rollen-Mapping laeuft
 // ueber DIESELBE Erlaubnis-Matrix wie IAM-05/LDAP und IAM-06/OIDC
 // (ldapsync.RoleMappingStore) — kein dritter paralleler Mapping-Mechanismus.
 func CompleteSAMLLogin(
 	ctx context.Context,
 	verifier *Verifier,
 	users *user.TenantUserStore,
 	roles *rbac.Store,
 	roleMapping *ldapsync.RoleMappingStore,
 	issuer *auth.TokenIssuer,
 	tenantSlug, rawSAMLResponse string,
 ) (token string, err error) {
 	resp, err := Parse(rawSAMLResponse)
 	if err != nil {
 		return "", err
 	}
 	assertion, err := verifier.Verify(resp)
 	if err != nil {
 		return "", err
 	}
 	if assertion.NameID == "" {
 		return "", fmt.Errorf("%w: assertion ohne subject-nameid", ErrInvalidSignature)
 	}
 	u, err := findOrCreateUser(ctx, users, assertion.NameID)
 	if err != nil {
 		return "", err
 	}
 	roleAttrs := assertion.Attribute("roles")
 	if role, ok, err := roleMapping.HighestRoleFor(ctx, roleAttrs); err != nil {
 		return "", err
 	} else if ok {
 		if _, err := roles.Assign(ctx, u.ID, role, "saml-sso"); err != nil {
 			return "", err
 		}
 	}
 	return issuer.Issue(u.ID, tenantSlug)
 }
 func findOrCreateUser(ctx context.Context, users *user.TenantUserStore, email string) (user.User, error) {
 	creds, err := users.GetByEmailForAuth(ctx, email)
 	if err == nil {
 		return creds.User, nil
 	}
 	if !errors.Is(err, user.ErrNotFound) {
 		return user.User{}, err
 	}
 	return users.Create(ctx, email, email)
 }
@@ -1,227 +0,0 @@
 package saml
 import (
 	"context"
 	"crypto/rsa"
 	"fmt"
 	"os"
 	"testing"
 	"time"
 	"github.com/golang-jwt/jwt/v5"
 	"github.com/jackc/pgx/v5/pgxpool"
 	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
 	"gitea.perlbach24.de/scripte/nexarch/internal/ldapsync"
 	"gitea.perlbach24.de/scripte/nexarch/internal/oidc"
 	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
 	"gitea.perlbach24.de/scripte/nexarch/internal/user"
 )
 const schema = `
 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', password_hash TEXT NOT NULL DEFAULT '',
 	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()
 );
 CREATE TABLE IF NOT EXISTS ldap_group_role_mapping (
 	ldap_group TEXT PRIMARY KEY, role TEXT NOT NULL CHECK (role IN ('user','tenant_admin'))
 );`
 func setupTest(t *testing.T) (*pgxpool.Pool, func()) {
 	t.Helper()
 	adminDSN := os.Getenv("TEST_ADMIN_DSN")
 	if adminDSN == "" {
 		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
 	}
 	ctx := context.Background()
 	pool, err := pgxpool.New(ctx, adminDSN)
 	if err != nil {
 		t.Fatalf("pool: %v", err)
 	}
 	if _, err := pool.Exec(ctx, schema); err != nil {
 		t.Fatalf("schema: %v", err)
 	}
 	cleanup := func() { pool.Close() }
 	return pool, cleanup
 }
 // Akzeptanzkriterium 1 + Pruefung 1: End-to-End-Test gegen simulierten SAML-IdP.
 // Akzeptanzkriterium 3 + Pruefung 3: Rollenzuordnung aus SAML-Attributen korrekt.
 func TestCompleteSAMLLogin_EndToEnd(t *testing.T) {
 	pool, cleanup := setupTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	idpKey := generateTestIdPKey(t)
 	verifier := NewVerifier(&idpKey.PublicKey, "https://test-idp.example.com")
 	users := user.NewTenantUserStore(pool)
 	roles := rbac.NewStore(pool)
 	roleMapping := ldapsync.NewRoleMappingStore(pool)
 	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
 	if err := roleMapping.SetMapping(ctx, "saml-admins", rbac.RoleTenantAdmin); err != nil {
 		t.Fatalf("set mapping: %v", err)
 	}
 	email := fmt.Sprintf("saml-test-%d@example.com", time.Now().UnixNano())
 	rawResp, err := BuildResponse(idpKey, testAssertion("https://test-idp.example.com", email, []string{"saml-admins"}))
 	if err != nil {
 		t.Fatalf("build response (simulierter idp): %v", err)
 	}
 	token, err := CompleteSAMLLogin(ctx, verifier, users, roles, roleMapping, issuer, "acme", rawResp)
 	if err != nil {
 		t.Fatalf("complete saml login: %v", err)
 	}
 	if token == "" {
 		t.Fatal("erwartet nicht-leeres sitzungs-token")
 	}
 	creds, err := users.GetByEmailForAuth(ctx, email)
 	if err != nil {
 		t.Fatalf("user nach login: %v", err)
 	}
 	assignment, err := roles.Get(ctx, creds.User.ID)
 	if err != nil {
 		t.Fatalf("rollenzuweisung lesen: %v", err)
 	}
 	if assignment.Role != rbac.RoleTenantAdmin {
 		t.Fatalf("erwartet tenant_admin aus saml-admins-mapping, habe %q", assignment.Role)
 	}
 }
 // Akzeptanzkriterium 3 + Pruefung 3 (Negativfall): keine Privilege-
 // Escalation ueber unbekannte/manipulierte Rollen-Attribute.
 func TestCompleteSAMLLogin_UnmappedRoleGrantsNothing(t *testing.T) {
 	pool, cleanup := setupTest(t)
 	defer cleanup()
 	ctx := context.Background()
 	idpKey := generateTestIdPKey(t)
 	verifier := NewVerifier(&idpKey.PublicKey, "https://test-idp.example.com")
 	users := user.NewTenantUserStore(pool)
 	roles := rbac.NewStore(pool)
 	roleMapping := ldapsync.NewRoleMappingStore(pool)
 	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
 	email := fmt.Sprintf("saml-test-%d@example.com", time.Now().UnixNano())
 	rawResp, err := BuildResponse(idpKey, testAssertion("https://test-idp.example.com", email, []string{"tenant_admin", "superadmin"}))
 	if err != nil {
 		t.Fatalf("build response: %v", err)
 	}
 	if _, err := CompleteSAMLLogin(ctx, verifier, users, roles, roleMapping, issuer, "acme", rawResp); err != nil {
 		t.Fatalf("complete saml login: %v", err)
 	}
 	creds, err := users.GetByEmailForAuth(ctx, email)
 	if err != nil {
 		t.Fatalf("user nach login: %v", err)
 	}
 	if _, err := roles.Get(ctx, creds.User.ID); err == nil {
 		t.Fatal("erwartet KEINE rollenzuweisung fuer nicht gemappte rollen-attribute")
 	}
 }
 // Akzeptanzkriterium 2 + Pruefung 2: SAML- und OIDC-Anmeldung koennen
 // nebeneinander fuer unterschiedliche Tenants konfiguriert sein — hier durch
 // zwei physisch getrennte Tenant-Datenbanken demonstriert (Modell C).
 func TestSAMLAndOIDC_WorkInParallelForDifferentTenants(t *testing.T) {
 	adminDSN := os.Getenv("TEST_ADMIN_DSN")
 	if adminDSN == "" {
 		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
 	}
 	ctx := context.Background()
 	poolSAML, cleanupSAML := setupTest(t)
 	defer cleanupSAML()
 	poolOIDC, err := pgxpool.New(ctx, adminDSN)
 	if err != nil {
 		t.Fatalf("pool oidc: %v", err)
 	}
 	defer poolOIDC.Close()
 	if _, err := poolOIDC.Exec(ctx, schema+`
 		CREATE TABLE IF NOT EXISTS oidc_states (
 			state TEXT PRIMARY KEY, nonce TEXT NOT NULL, expires_at TIMESTAMPTZ NOT NULL,
 			used_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT now()
 		)`); err != nil {
 		t.Fatalf("schema oidc: %v", err)
 	}
 	// Tenant "saml-tenant": SAML konfiguriert.
 	idpKey := generateTestIdPKey(t)
 	samlVerifier := NewVerifier(&idpKey.PublicKey, "https://test-idp.example.com")
 	samlUsers := user.NewTenantUserStore(poolSAML)
 	samlRoles := rbac.NewStore(poolSAML)
 	samlMapping := ldapsync.NewRoleMappingStore(poolSAML)
 	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
 	samlEmail := fmt.Sprintf("saml-parallel-%d@example.com", time.Now().UnixNano())
 	samlResp, err := BuildResponse(idpKey, testAssertion("https://test-idp.example.com", samlEmail, nil))
 	if err != nil {
 		t.Fatalf("build saml response: %v", err)
 	}
 	samlToken, err := CompleteSAMLLogin(ctx, samlVerifier, samlUsers, samlRoles, samlMapping, issuer, "saml-tenant", samlResp)
 	if err != nil {
 		t.Fatalf("saml-tenant login: %v", err)
 	}
 	if samlToken == "" {
 		t.Fatal("erwartet token fuer saml-tenant")
 	}
 	// Tenant "oidc-tenant": OIDC konfiguriert, voellig unabhaengige Datenbank.
 	oidcKey := generateTestIdPKey(t)
 	oidcVerifier := oidc.NewVerifier(map[string]*rsa.PublicKey{"kid-1": &oidcKey.PublicKey}, "https://oidc-idp.example.com")
 	oidcStates := oidc.NewStateStore(poolOIDC)
 	oidcUsers := user.NewTenantUserStore(poolOIDC)
 	oidcRoles := rbac.NewStore(poolOIDC)
 	oidcMapping := ldapsync.NewRoleMappingStore(poolOIDC)
 	state, nonce, err := oidcStates.Generate(ctx)
 	if err != nil {
 		t.Fatalf("oidc generate state: %v", err)
 	}
 	oidcEmail := fmt.Sprintf("oidc-parallel-%d@example.com", time.Now().UnixNano())
 	claims := oidc.Claims{
 		Email: oidcEmail,
 		Nonce: nonce,
 		RegisteredClaims: jwt.RegisteredClaims{
 			Issuer: "https://oidc-idp.example.com", ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
 		},
 	}
 	idToken := signOIDCTestToken(t, oidcKey, claims)
 	oidcToken, err := oidc.CompleteOIDCLogin(ctx, oidcVerifier, oidcStates, oidcUsers, oidcRoles, oidcMapping, issuer, "oidc-tenant", state, idToken)
 	if err != nil {
 		t.Fatalf("oidc-tenant login: %v", err)
 	}
 	if oidcToken == "" {
 		t.Fatal("erwartet token fuer oidc-tenant")
 	}
 	if samlToken == oidcToken {
 		t.Fatal("tokens sollten unterschiedlich sein")
 	}
 }
 func signOIDCTestToken(t *testing.T, key *rsa.PrivateKey, claims oidc.Claims) string {
 	t.Helper()
 	token := jwt.NewWithClaims(jwt.SigningMethodRS256, claims)
 	token.Header["kid"] = "kid-1"
 	s, err := token.SignedString(key)
 	if err != nil {
 		t.Fatalf("sign oidc test token: %v", err)
 	}
 	return s
 }
@@ -1,107 +0,0 @@
 package saml
 import (
 	"crypto"
 	"crypto/rand"
 	"crypto/rsa"
 	"crypto/sha256"
 	"encoding/base64"
 	"encoding/xml"
 	"errors"
 	"fmt"
 	"time"
 )
 var (
 	ErrInvalidSignature = errors.New("saml: assertion-signatur ungueltig")
 	ErrNotYetValid      = errors.New("saml: assertion noch nicht gueltig")
 	ErrExpired          = errors.New("saml: assertion abgelaufen")
 	ErrWrongIssuer      = errors.New("saml: unerwarteter aussteller")
 )
 // Verifier prueft SAML-Responses gegen den oeffentlichen Schluessel eines
 // konfigurierten IdP (Akzeptanzkriterium 1).
 type Verifier struct {
 	idpPublicKey *rsa.PublicKey
 	idpIssuer    string
 }
 func NewVerifier(idpPublicKey *rsa.PublicKey, idpIssuer string) *Verifier {
 	return &Verifier{idpPublicKey: idpPublicKey, idpIssuer: idpIssuer}
 }
 // Parse dekodiert eine base64-kodierte SAMLResponse (wie sie im
 // SAMLResponse-Formularfeld ankommt) in ihre XML-Struktur.
 func Parse(rawBase64 string) (ResponseXML, error) {
 	data, err := base64.StdEncoding.DecodeString(rawBase64)
 	if err != nil {
 		return ResponseXML{}, fmt.Errorf("base64 dekodieren: %w", err)
 	}
 	var resp ResponseXML
 	if err := xml.Unmarshal(data, &resp); err != nil {
 		return ResponseXML{}, fmt.Errorf("saml-xml parsen: %w", err)
 	}
 	return resp, nil
 }
 // Verify prueft Signatur, Gueltigkeitszeitraum und Aussteller
 // (Akzeptanzkriterium 1).
 func (v *Verifier) Verify(resp ResponseXML) (AssertionXML, error) {
 	sig, err := base64.StdEncoding.DecodeString(resp.SignatureValue)
 	if err != nil {
 		return AssertionXML{}, fmt.Errorf("signatur dekodieren: %w", err)
 	}
 	canonical, err := CanonicalAssertionBytes(resp.Assertion)
 	if err != nil {
 		return AssertionXML{}, err
 	}
 	hash := sha256.Sum256(canonical)
 	if err := rsa.VerifyPKCS1v15(v.idpPublicKey, crypto.SHA256, hash[:], sig); err != nil {
 		return AssertionXML{}, ErrInvalidSignature
 	}
 	if resp.Assertion.Issuer != v.idpIssuer {
 		return AssertionXML{}, fmt.Errorf("%w: %q", ErrWrongIssuer, resp.Assertion.Issuer)
 	}
 	if err := resp.Assertion.WithinValidity(time.Now()); err != nil {
 		return AssertionXML{}, err
 	}
 	return resp.Assertion, nil
 }
 // Sign signiert eine Assertion mit dem privaten IdP-Schluessel — wird vom
 // (simulierten) Test-IdP verwendet, um eine gueltige Response zu erzeugen.
 // Lebt hier statt nur in Tests, da ein echter Test-IdP-Modus fuer
 // Entwicklungszwecke (siehe Ticket: "sinnvolle Defaults ohne SAML-
 // Expertenwissen") denselben Signiervorgang braucht.
 func Sign(priv *rsa.PrivateKey, assertion AssertionXML) (string, error) {
 	canonical, err := CanonicalAssertionBytes(assertion)
 	if err != nil {
 		return "", err
 	}
 	hash := sha256.Sum256(canonical)
 	sig, err := rsa.SignPKCS1v15(rand.Reader, priv, crypto.SHA256, hash[:])
 	if err != nil {
 		return "", fmt.Errorf("assertion signieren: %w", err)
 	}
 	return base64.StdEncoding.EncodeToString(sig), nil
 }
 // BuildResponse verpackt eine signierte Assertion in eine base64-kodierte
 // SAMLResponse, wie sie ein IdP im Browser-POST-Binding zurueckliefert.
 func BuildResponse(priv *rsa.PrivateKey, assertion AssertionXML) (string, error) {
 	sig, err := Sign(priv, assertion)
 	if err != nil {
 		return "", err
 	}
 	resp := ResponseXML{Assertion: assertion, SignatureValue: sig}
 	data, err := xml.Marshal(resp)
 	if err != nil {
 		return "", fmt.Errorf("response serialisieren: %w", err)
 	}
 	return base64.StdEncoding.EncodeToString(data), nil
 }
@@ -1,123 +0,0 @@
 package saml
 import (
 	"crypto/rand"
 	"crypto/rsa"
 	"testing"
 	"time"
 )
 func generateTestIdPKey(t *testing.T) *rsa.PrivateKey {
 	t.Helper()
 	key, err := rsa.GenerateKey(rand.Reader, 2048)
 	if err != nil {
 		t.Fatalf("generate rsa key: %v", err)
 	}
 	return key
 }
 func testAssertion(issuer, nameID string, roles []string) AssertionXML {
 	now := time.Now()
 	return AssertionXML{
 		Issuer: issuer,
 		NameID: nameID,
 		Conditions: conditionsXML{
 			NotBefore:    now.Add(-time.Minute).Format(time.RFC3339),
 			NotOnOrAfter: now.Add(time.Hour).Format(time.RFC3339),
 		},
 		Attributes: []attributeXML{
 			{Name: "roles", Values: roles},
 		},
 	}
 }
 func TestVerify_AcceptsValidSignedAssertion(t *testing.T) {
 	key := generateTestIdPKey(t)
 	verifier := NewVerifier(&key.PublicKey, "https://idp.example.com")
 	rawResp, err := BuildResponse(key, testAssertion("https://idp.example.com", "person@example.com", []string{"sso-admins"}))
 	if err != nil {
 		t.Fatalf("build response: %v", err)
 	}
 	resp, err := Parse(rawResp)
 	if err != nil {
 		t.Fatalf("parse: %v", err)
 	}
 	assertion, err := verifier.Verify(resp)
 	if err != nil {
 		t.Fatalf("verify: %v", err)
 	}
 	if assertion.NameID != "person@example.com" {
 		t.Fatalf("nameid = %q", assertion.NameID)
 	}
 }
 func TestVerify_RejectsTamperedAssertion(t *testing.T) {
 	key := generateTestIdPKey(t)
 	verifier := NewVerifier(&key.PublicKey, "https://idp.example.com")
 	rawResp, err := BuildResponse(key, testAssertion("https://idp.example.com", "person@example.com", nil))
 	if err != nil {
 		t.Fatalf("build response: %v", err)
 	}
 	resp, err := Parse(rawResp)
 	if err != nil {
 		t.Fatalf("parse: %v", err)
 	}
 	// Manipulation NACH dem Signieren: NameID aendern (Signatur bleibt die alte).
 	resp.Assertion.NameID = "angreifer@example.com"
 	if _, err := verifier.Verify(resp); err != ErrInvalidSignature {
 		t.Fatalf("erwartet ErrInvalidSignature, habe %v", err)
 	}
 }
 func TestVerify_RejectsWrongIdPKey(t *testing.T) {
 	realKey := generateTestIdPKey(t)
 	attackerKey := generateTestIdPKey(t)
 	verifier := NewVerifier(&realKey.PublicKey, "https://idp.example.com")
 	rawResp, err := BuildResponse(attackerKey, testAssertion("https://idp.example.com", "person@example.com", nil))
 	if err != nil {
 		t.Fatalf("build response: %v", err)
 	}
 	resp, _ := Parse(rawResp)
 	if _, err := verifier.Verify(resp); err != ErrInvalidSignature {
 		t.Fatalf("erwartet ErrInvalidSignature bei fremd signierter assertion, habe %v", err)
 	}
 }
 func TestVerify_RejectsExpiredAssertion(t *testing.T) {
 	key := generateTestIdPKey(t)
 	verifier := NewVerifier(&key.PublicKey, "https://idp.example.com")
 	expired := testAssertion("https://idp.example.com", "person@example.com", nil)
 	expired.Conditions.NotOnOrAfter = time.Now().Add(-time.Hour).Format(time.RFC3339)
 	rawResp, err := BuildResponse(key, expired)
 	if err != nil {
 		t.Fatalf("build response: %v", err)
 	}
 	resp, _ := Parse(rawResp)
 	if _, err := verifier.Verify(resp); err != ErrExpired {
 		t.Fatalf("erwartet ErrExpired, habe %v", err)
 	}
 }
 func TestVerify_RejectsWrongIssuer(t *testing.T) {
 	key := generateTestIdPKey(t)
 	verifier := NewVerifier(&key.PublicKey, "https://idp.example.com")
 	rawResp, err := BuildResponse(key, testAssertion("https://anderer-idp.example.com", "person@example.com", nil))
 	if err != nil {
 		t.Fatalf("build response: %v", err)
 	}
 	resp, _ := Parse(rawResp)
 	if _, err := verifier.Verify(resp); err == nil {
 		t.Fatal("erwartet fehler bei unerwartetem aussteller")
 	}
 }
@@ -103,51 +103,6 @@ func (s *TenantUserStore) Deactivate(ctx context.Context, id string) (User, erro
 	`, 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 {
@@ -0,0 +1,2 @@
 DROP TABLE IF EXISTS policy_rule_changes;
 DROP TABLE IF EXISTS policy_rules;
@@ -0,0 +1,24 @@
 -- 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);
@@ -0,0 +1 @@
 DROP TABLE IF EXISTS feature_flags;
@@ -0,0 +1,10 @@
 -- Feature-Flags zentral je Mandant/Zielgruppe (LIC-02, siehe core-kanban/tickets/LIC-02.md).
 -- Lebt in der Registry-DB, nicht pro Tenant-Datenbank — Flags sind eine
 -- Core-weite Konfiguration, keine Mandanten-Geschaeftsdaten.
 CREATE TABLE feature_flags (
    key                 TEXT PRIMARY KEY,
    enabled             BOOLEAN NOT NULL DEFAULT false,
    rollout_percentage  INT NOT NULL DEFAULT 0 CHECK (rollout_percentage BETWEEN 0 AND 100),
    target_tenant_slugs TEXT[] NOT NULL DEFAULT '{}',
    updated_at          TIMESTAMPTZ NOT NULL DEFAULT now()
 );
@@ -0,0 +1 @@
 DROP TABLE IF EXISTS policy_module_scopes;
@@ -0,0 +1,11 @@
 -- Modul-Scoping fuer Policy-Regeln (RBAC-04, siehe core-kanban/tickets/RBAC-04.md).
 -- Existiert fuer eine (role, permission)-Regel ein Eintrag hier, gilt sie
 -- NUR, wenn zusaetzlich das verknuepfte Feature-Flag (LIC-02) fuer den
 -- Tenant aktiv ist — Rechte folgen der Lizenz, nicht umgekehrt.
 CREATE TABLE policy_module_scopes (
    role       TEXT NOT NULL,
    permission TEXT NOT NULL,
    module     TEXT NOT NULL,
    flag_key   TEXT NOT NULL,
    PRIMARY KEY (role, permission)
 );
@@ -1 +0,0 @@
 ALTER TABLE users DROP COLUMN password_hash;
@@ -1,3 +0,0 @@
 -- Passwort-Hash-Spalte fuer Login (IAM-02, siehe core-kanban/tickets/IAM-02.md).
 -- Enthaelt AUSSCHLIESSLICH den bcrypt-Hash, niemals das Klartext-Passwort.
 ALTER TABLE users ADD COLUMN password_hash TEXT NOT NULL DEFAULT '';
@@ -1,2 +0,0 @@
 DROP TABLE IF EXISTS ldap_group_role_mapping;
 DROP TABLE IF EXISTS ldap_config;
@@ -1,22 +0,0 @@
 -- LDAP/Active-Directory-Anbindung (IAM-05, siehe core-kanban/tickets/IAM-05.md).
 -- Bind-Credentials liegen NIE in dieser Tabelle im Klartext — bind_password_env
 -- nennt nur den Namen einer Umgebungsvariable, aus der das Passwort zur
 -- Laufzeit gelesen wird (Projekt-Konvention: Secrets nur ueber Env-Vars).
 CREATE TABLE ldap_config (
    id                 BOOLEAN PRIMARY KEY DEFAULT true CHECK (id),
    url                TEXT NOT NULL,
    bind_dn            TEXT NOT NULL,
    bind_password_env  TEXT NOT NULL,
    base_dn            TEXT NOT NULL,
    user_filter        TEXT NOT NULL DEFAULT '(objectClass=person)',
    updated_at         TIMESTAMPTZ NOT NULL DEFAULT now()
 );
 -- Erlaubnis-Matrix LDAP-Gruppe -> NEXARCH-Rolle (Akzeptanzkriterium 3).
 -- Eine LDAP-Gruppe OHNE Eintrag hier vergibt KEINE Rolle — kein impliziter
 -- Zugriff durch Gruppennamen-Zufall (Privilege-Escalation-Schutz, siehe
 -- "Bekannte Fehler vermeiden" im Ticket).
 CREATE TABLE ldap_group_role_mapping (
    ldap_group TEXT PRIMARY KEY,
    role       TEXT NOT NULL CHECK (role IN ('user', 'tenant_admin'))
 );
@@ -1 +0,0 @@
 DROP TABLE IF EXISTS oidc_states;
@@ -1,10 +0,0 @@
 -- CSRF-/Replay-Schutz fuer OIDC-Login (IAM-06, siehe
 -- core-kanban/tickets/IAM-06.md). Einmal-Verwendung erzwungen ueber
 -- used_at IS NULL in der Consume-Abfrage, analog IAM-03/IAM-09.
 CREATE TABLE oidc_states (
    state      TEXT PRIMARY KEY,
    nonce      TEXT NOT NULL,
    expires_at TIMESTAMPTZ NOT NULL,
    used_at    TIMESTAMPTZ,
    created_at TIMESTAMPTZ NOT NULL DEFAULT now()
 );
@@ -1 +0,0 @@
 DROP TABLE IF EXISTS saml_config;
@@ -1,13 +0,0 @@
 -- SAML 2.0-Anbindung (IAM-11, siehe core-kanban/tickets/IAM-11.md).
 -- Singleton-Zeile je Tenant-Datenbank (Modell C) — dieselbe Isolation, die
 -- IAM-06 (OIDC) fuer nebeneinander konfigurierte Anmeldewege je Tenant
 -- nutzt: Tenant A kann diese Tabelle befuellt haben, Tenant B stattdessen
 -- eine OIDC-Konfiguration, ohne dass sich beides je begegnet
 -- (Akzeptanzkriterium 2).
 CREATE TABLE saml_config (
    id                BOOLEAN PRIMARY KEY DEFAULT true CHECK (id),
    idp_issuer        TEXT NOT NULL,
    idp_certificate   TEXT NOT NULL, -- PEM-kodiertes oeffentliches Zertifikat des IdP
    sp_entity_id      TEXT NOT NULL,
    updated_at        TIMESTAMPTZ NOT NULL DEFAULT now()
 );
@@ -1,11 +1,23 @@
 #!/usr/bin/env bash
 # Setzt die nexarch-Testumgebung zurueck: loescht die geteilte
 # Registry-Tabelle "tenants" in der postgres-Wartungsdatenbank sowie alle
 # tenant_*-Datenbanken. Noetig, weil verschiedene Feature-Branches
 # unterschiedliche Registry-Schemata erwarten, aber dieselbe physische
 # Postgres-Instanz auf dem Testhost teilen (siehe [[project-nexarch-test-infra]]).
 #
 # Aufruf: NEXARCH_TEST_DB_PASSWORD=... ./scripts/reset-test-env.sh
 set -euo pipefail
 PASS="${NEXARCH_TEST_DB_PASSWORD:?Setze NEXARCH_TEST_DB_PASSWORD vor dem Aufruf}"
 ROLE="nexarch_test"
 export PGPASSWORD="$PASS"
 psql -h localhost -U "$ROLE" -d postgres -v ON_ERROR_STOP=1 -c "DROP TABLE IF EXISTS tenants CASCADE;"
 dbs=$(psql -h localhost -U "$ROLE" -d postgres -tAc "SELECT datname FROM pg_database WHERE datname LIKE 'tenant\_%' ESCAPE '\'")
 for db in $dbs; do
 	psql -h localhost -U "$ROLE" -d postgres -v ON_ERROR_STOP=1 -c "DROP DATABASE IF EXISTS \"${db}\";"
 done
 echo "Testumgebung zurueckgesetzt: registry-tabelle + $(echo "$dbs" | grep -c . || true) tenant-datenbank(en) entfernt."
@@ -1,12 +1,24 @@
 #!/usr/bin/env bash
 # Ein-Kommando-Pruefung fuer den aktuellen Code-Stand auf dem Testhost:
 # Registry+Tenant-DBs zuruecksetzen, dann build/vet/test in einem Rutsch.
 # -p 1 ist Pflicht, da mehrere Pakete dieselbe physische Registry-Tabelle auf
 # dem Testhost teilen (siehe [[project-nexarch-test-infra]]).
 #
 # Aufruf: NEXARCH_TEST_DB_PASSWORD=... ./scripts/run-checks.sh
 set -euo pipefail
 PASS="${NEXARCH_TEST_DB_PASSWORD:?Setze NEXARCH_TEST_DB_PASSWORD vor dem Aufruf}"
 cd "$(dirname "$0")/.."
 NEXARCH_TEST_DB_PASSWORD="$PASS" bash scripts/reset-test-env.sh
 export TEST_ADMIN_DSN="postgresql://nexarch_test:${PASS}@localhost:5432/postgres?sslmode=disable"
 echo "== go build =="
 go build ./...
 echo "== go vet =="
 go vet ./...
 echo "== go test (-p 1) =="
 go test ./... -p 1 -count=1
		`@@ -0,0 +1,2 @@`
							`DROP TABLE IF EXISTS policy_rule_changes;`
							`DROP TABLE IF EXISTS policy_rules;`
		`@@ -1 +0,0 @@`
			`ALTER TABLE users DROP COLUMN password_hash;`
		`@@ -1,2 +0,0 @@`
			`DROP TABLE IF EXISTS ldap_group_role_mapping;`
			`DROP TABLE IF EXISTS ldap_config;`