feat(sdk): API-Referenz Frontend + Backend-Konsolidierung (Shared Utilities, CRUD Factory)

- API-Referenz Seite (/sdk/api-docs) mit ~690 Endpoints, Suche, Filter, Modul-Index
- Shared db_utils.py (row_to_dict) + tenant_utils Integration in 6 Route-Dateien
- CRUD Factory (crud_factory.py) fuer zukuenftige Module
- Version-Route Auto-Registration in versioning_utils.py
- 1338 Tests bestanden, -232 Zeilen Duplikat-Code

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

backend-compliance/compliance/api/loeschfristen_routes.py

@@ -16,19 +16,18 @@ import logging
 from datetime import datetime
 from typing import Optional, List, Any, Dict
 
-from fastapi import APIRouter, Depends, HTTPException, Query, Header
+from fastapi import APIRouter, Depends, HTTPException, Query
 from pydantic import BaseModel
 from sqlalchemy import text
 from sqlalchemy.orm import Session
-from uuid import UUID
 
 from classroom_engine.database import get_db
+from .tenant_utils import get_tenant_id as _get_tenant_id
+from .db_utils import row_to_dict as _row_to_dict
 
 logger = logging.getLogger(__name__)
 router = APIRouter(prefix="/loeschfristen", tags=["loeschfristen"])
 
-DEFAULT_TENANT_ID = "9282a473-5c95-4b3a-bf78-0ecc0ec71d3e"
-
 
 # =============================================================================
 # Pydantic Schemas
@@ -105,26 +104,6 @@ JSONB_FIELDS = {
 }
 
 
-def _row_to_dict(row) -> Dict[str, Any]:
-    result = dict(row._mapping)
-    for key, val in result.items():
-        if isinstance(val, datetime):
-            result[key] = val.isoformat()
-        elif hasattr(val, '__str__') and not isinstance(val, (str, int, float, bool, list, dict, type(None))):
-            result[key] = str(val)
-    return result
-
-
-def _get_tenant_id(x_tenant_id: Optional[str] = Header(None)) -> str:
-    if x_tenant_id:
-        try:
-            UUID(x_tenant_id)
-            return x_tenant_id
-        except ValueError:
-            pass
-    return DEFAULT_TENANT_ID
-
-
 # =============================================================================
 # Routes
 # =============================================================================
@@ -137,10 +116,9 @@ async def list_loeschfristen(
     limit: int = Query(500, ge=1, le=1000),
     offset: int = Query(0, ge=0),
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
     """List Loeschfristen with optional filters."""
-    tenant_id = _get_tenant_id(x_tenant_id)
 
     where_clauses = ["tenant_id = :tenant_id"]
     params: Dict[str, Any] = {"tenant_id": tenant_id, "limit": limit, "offset": offset}
@@ -189,10 +167,9 @@ async def list_loeschfristen(
 @router.get("/stats")
 async def get_loeschfristen_stats(
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
     """Return Loeschfristen statistics."""
-    tenant_id = _get_tenant_id(x_tenant_id)
 
     row = db.execute(text("""
         SELECT
@@ -222,10 +199,9 @@ async def get_loeschfristen_stats(
 async def create_loeschfrist(
     payload: LoeschfristCreate,
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
     """Create a new Loeschfrist policy."""
-    tenant_id = _get_tenant_id(x_tenant_id)
 
     data = payload.model_dump()
 
@@ -257,9 +233,8 @@ async def create_loeschfrist(
 async def get_loeschfrist(
     policy_id: str,
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
-    tenant_id = _get_tenant_id(x_tenant_id)
     row = db.execute(
         text("SELECT * FROM compliance_loeschfristen WHERE id = :id AND tenant_id = :tenant_id"),
         {"id": policy_id, "tenant_id": tenant_id},
@@ -274,10 +249,9 @@ async def update_loeschfrist(
     policy_id: str,
     payload: LoeschfristUpdate,
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
     """Full update of a Loeschfrist policy."""
-    tenant_id = _get_tenant_id(x_tenant_id)
 
     updates: Dict[str, Any] = {"id": policy_id, "tenant_id": tenant_id, "updated_at": datetime.utcnow()}
     set_clauses = ["updated_at = :updated_at"]
@@ -314,10 +288,9 @@ async def update_loeschfrist_status(
     policy_id: str,
     payload: StatusUpdate,
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
     """Quick status update."""
-    tenant_id = _get_tenant_id(x_tenant_id)
     valid = {"DRAFT", "ACTIVE", "REVIEW_NEEDED", "ARCHIVED"}
     if payload.status not in valid:
         raise HTTPException(status_code=400, detail=f"Invalid status. Must be one of: {', '.join(valid)}")
@@ -342,9 +315,8 @@ async def update_loeschfrist_status(
 async def delete_loeschfrist(
     policy_id: str,
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
-    tenant_id = _get_tenant_id(x_tenant_id)
     result = db.execute(
         text("DELETE FROM compliance_loeschfristen WHERE id = :id AND tenant_id = :tenant_id"),
         {"id": policy_id, "tenant_id": tenant_id},
@@ -362,11 +334,10 @@ async def delete_loeschfrist(
 async def list_loeschfristen_versions(
     policy_id: str,
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
     """List all versions for a Loeschfrist."""
     from .versioning_utils import list_versions
-    tenant_id = _get_tenant_id(x_tenant_id)
     return list_versions(db, "loeschfristen", policy_id, tenant_id)
 
 
@@ -375,11 +346,10 @@ async def get_loeschfristen_version(
     policy_id: str,
     version_number: int,
     db: Session = Depends(get_db),
-    x_tenant_id: Optional[str] = Header(None),
+    tenant_id: str = Depends(_get_tenant_id),
 ):
     """Get a specific Loeschfristen version with full snapshot."""
     from .versioning_utils import get_version
-    tenant_id = _get_tenant_id(x_tenant_id)
     v = get_version(db, "loeschfristen", policy_id, version_number, tenant_id)
     if not v:
         raise HTTPException(status_code=404, detail=f"Version {version_number} not found")