feat(training+controls): interactive video pipeline, training blocks, control generator, CE libraries

Interactive Training Videos (CP-TRAIN):
- DB migration 022: training_checkpoints + checkpoint_progress tables
- NarratorScript generation via Anthropic (AI Teacher persona, German)
- TTS batch synthesis + interactive video pipeline (slides + checkpoint slides + FFmpeg)
- 4 new API endpoints: generate-interactive, interactive-manifest, checkpoint submit, checkpoint progress
- InteractiveVideoPlayer component (HTML5 Video, quiz overlay, seek protection, progress tracking)
- Learner portal integration with automatic completion on all checkpoints passed
- 30 new tests (handler validation + grading logic + manifest/progress + seek protection)

Training Blocks:
- Block generator, block store, block config CRUD + preview/generate endpoints
- Migration 021: training_blocks schema

Control Generator + Canonical Library:
- Control generator routes + service enhancements
- Canonical control library helpers, sidebar entry
- Citation backfill service + tests
- CE libraries data (hazard, protection, evidence, lifecycle, components)

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

docs-src/services/sdk-modules/canonical-control-library.md

@@ -37,13 +37,21 @@ Wir benoetigen ein System, um aus verschiedenen Security-Guidelines **eigenstaen
 | Domain | Name | Beschreibung |
 |--------|------|-------------|
 | AUTH | Identity & Access Management | Authentisierung, MFA, Token-Management |
-| NET | Network & Transport Security | TLS, Zertifikate, Netzwerk-Haertung |
-| SUP | Software Supply Chain | Signierung, SBOM, Dependency-Scanning |
-| LOG | Security Operations & Logging | Privacy-Aware Logging, SIEM |
-| WEB | Web Application Security | Admin-Flows, Account Recovery |
-| DATA | Data Governance & Classification | Datenklassifikation, Schutzmassnahmen |
 | CRYP | Cryptographic Operations | Key Management, Rotation, HSM |
-| REL | Release & Change Governance | Change Impact Assessment, Security Review |
+| NET | Network & Transport Security | TLS, Zertifikate, Netzwerk-Haertung |
+| DATA | Data Governance & Classification | Datenklassifikation, Schutzmassnahmen |
+| LOG | Security Operations & Logging | Privacy-Aware Logging, SIEM |
+| ACC | Access Control | Zugriffskontrolle, Berechtigungen |
+| SEC | IT Security | Schwachstellen, Haertung, Konfiguration |
+| INC | Incident Management | Vorfallmanagement, Wiederherstellung |
+| AI | Artificial Intelligence | KI-Compliance, Bias, Transparenz |
+| COMP | Compliance | Konformitaet, Audit, Zertifizierung |
+| GOV | Government & Public Administration | Behoerden, Verwaltung, Aufsicht |
+| LAB | Labor Law | Arbeitsrecht, Arbeitsschutz, Betriebsverfassung |
+| FIN | Financial Regulation | Finanzregulierung, Rechnungslegung, BaFin |
+| TRD | Trade Regulation | Gewerbe, Handelsrecht, Produktsicherheit |
+| ENV | Environmental | Umweltschutz, Nachhaltigkeit, Emissionen |
+| HLT | Health | Gesundheit, Medizinprodukte, Hygiene |
 
 !!! warning "Keine BSI-Nomenklatur"
     Die Domains verwenden bewusst KEINE BSI-Bezeichner (O.Auth_*, O.Netz_*).
@@ -123,6 +131,8 @@ erDiagram
 | `GET` | `/v1/canonical/generate/processed-stats` | Verarbeitungsstatistik pro Collection |
 | `GET` | `/v1/canonical/generate/review-queue` | Controls zur Pruefung |
 | `POST` | `/v1/canonical/generate/review/{control_id}` | Review abschliessen |
+| `POST` | `/v1/canonical/generate/bulk-review` | Bulk-Review (approve/reject nach State) |
+| `POST` | `/v1/canonical/generate/qa-reclassify` | QA-Reklassifizierung bestehender Controls |
 | `GET` | `/v1/canonical/blocked-sources` | Gesperrte Quellen (Rule 3) |
 | `POST` | `/v1/canonical/blocked-sources/cleanup` | Cleanup-Workflow starten |
 
@@ -231,25 +241,28 @@ Der Validator (`scripts/validate-controls.py`) prueft bei jedem Commit:
 
 ## Control Generator Pipeline
 
-Automatische Generierung von Controls aus dem gesamten RAG-Korpus (~183.000 Chunks aus Gesetzen, Verordnungen und Standards).
-Aktueller Stand: **~2.120 Controls** generiert.
+Automatische Generierung von Controls aus dem gesamten RAG-Korpus (~105.000 Chunks aus Gesetzen, Verordnungen und Standards).
+Aktueller Stand: **~4.738 Controls** generiert.
 
-### 8-Stufen-Pipeline
+### 9-Stufen-Pipeline
 
 ```mermaid
 flowchart TD
-    A[1. RAG Scroll] -->|Alle Chunks| B[2. Prefilter - Lokales LLM]
+    A[1. RAG Scroll] -->|max_chunks| B[2. Prefilter - Lokales LLM]
     B -->|Irrelevant| C[Als processed markieren]
     B -->|Relevant| D[3. License Classify]
     D -->|Batch sammeln| E[4. Batch Processing - 5 Chunks/API-Call]
     E -->|Rule 1/2| F[4a. Structure Batch - Anthropic]
     E -->|Rule 3| G[4b. Reform Batch - Anthropic]
-    F --> H[5. Harmonization - Embeddings]
-    G --> H
+    F --> QA[5. QA Validation - Lokales LLM]
+    G --> QA
+    QA -->|Mismatch| QAF[Auto-Fix Category/Domain]
+    QA -->|OK| H[6. Harmonization - Embeddings]
+    QAF --> H
     H -->|Duplikat| I[Als Duplikat speichern]
-    H -->|Neu| J[6. Anchor Search]
-    J --> K[7. Store Control]
-    K --> L[8. Mark Processed]
+    H -->|Neu| J[7. Anchor Search]
+    J --> K[8. Store Control]
+    K --> L[9. Mark Processed]
 ```
 
 ### Stufe 1: RAG Scroll (Vollstaendig)
@@ -343,12 +356,64 @@ except Exception as e:
     Die `batch_size` ist ueber `GeneratorConfig` konfigurierbar.
     Bei grosser Batch-Size steigt die Wahrscheinlichkeit fuer Parsing-Fehler.
 
-### Stufe 5: Harmonisierung (Embedding-basiert)
+### Stufe 5: QA Validation (Automatische Qualitaetspruefung)
+
+Die QA-Stufe validiert die Klassifizierung jedes Controls automatisch. Sie vergleicht die LLM-Klassifizierung mit Keyword-basierter Erkennung und loest bei Abweichungen eine Arbitrierung durch das lokale Ollama-Modell aus.
+
+#### Ablauf
+
+1. **LLM-Category auswerten:** Der Anthropic-Prompt fragt jetzt explizit nach `category` und `domain`
+2. **Keyword-Detection als Cross-Check:** `_detect_category(chunk.text)` liefert eine zweite Meinung
+3. **Stimmen beide ueberein?** → Kein QA noetig (schneller Pfad)
+4. **Bei Disagreement:** Lokales LLM (Ollama qwen3.5:35b-a3b) arbitriert
+5. **Auto-Fix:** Bei hoher Konfidenz wird Category/Domain automatisch korrigiert
+
+#### Beispiel
+
+```
+Control: "Offenlegung von Risikokonzentrationen bei Finanzinstrumenten"
+LLM sagt:     domain=AUTH, category=authentication
+Keyword sagt:  domain=FIN,  category=finance
+→ QA via Ollama: domain=FIN, category=finance (Grund: IFRS-Thema)
+→ Auto-Fix: AUTH-315 → FIN-xxx
+```
+
+#### QA-Metriken in generation_metadata
+
+```json
+{
+  "qa_category_fix": {"from": "authentication", "to": "finance", "reason": "IFRS-Thema"},
+  "qa_domain_fix": {"from": "AUTH", "to": "FIN", "reason": "Finanzregulierung"}
+}
+```
+
+#### QA-Reklassifizierung bestehender Controls
+
+Fuer bereits generierte Controls gibt es den Backfill-Endpoint:
+
+```bash
+# Dry Run: Welche AUTH-Controls sind falsch klassifiziert?
+curl -X POST https://macmini:8002/api/compliance/v1/canonical/generate/qa-reclassify \
+  -H 'Content-Type: application/json' \
+  -d '{"limit": 50, "dry_run": true, "filter_domain_prefix": "AUTH"}'
+
+# Korrekturen anwenden:
+curl -X POST https://macmini:8002/api/compliance/v1/canonical/generate/qa-reclassify \
+  -H 'Content-Type: application/json' \
+  -d '{"limit": 50, "dry_run": false, "filter_domain_prefix": "AUTH"}'
+```
+
+!!! info "Performance"
+    Die QA-Stufe nutzt das lokale Ollama-Modell (kostenlos, ~2s/Control).
+    Sie wird nur bei Disagreement zwischen LLM und Keyword getriggert (~10-15% der Controls),
+    sodass der Overhead minimal bleibt.
+
+### Stufe 6: Harmonisierung (Embedding-basiert)
 
 Prueft per bge-m3 Embeddings (Cosine Similarity > 0.85), ob ein aehnliches Control existiert.
 Embeddings werden in Batches vorgeladen (32 Texte/Request) fuer maximale Performance.
 
-### Stufe 6-8: Anchor Search, Store, Mark Processed
+### Stufe 7-9: Anchor Search, Store, Mark Processed
 
 - **Anchor Search:** Findet Open-Source-Referenzen (OWASP, NIST, ENISA)
 - **Store:** Persistiert Control mit `verification_method` und `category`
@@ -358,6 +423,12 @@ Embeddings werden in Batches vorgeladen (32 Texte/Request) fuer maximale Perform
 
 Bei der Generierung werden automatisch zugewiesen:
 
+**Category** wird seit 2026-03-16 **dreigleisig** bestimmt:
+
+1. **LLM-Klassifikation (primaer):** Anthropic liefert `category` im JSON-Response
+2. **Keyword-Detection (fallback):** Falls LLM keine Category liefert, greift `_detect_category()`
+3. **QA-Arbitrierung (bei Mismatch):** Lokales LLM entscheidet bei Widerspruch
+
 **Verification Method** (Nachweis-Methode):
 
 | Methode | Beschreibung |
@@ -367,10 +438,33 @@ Bei der Generierung werden automatisch zugewiesen:
 | `tool` | Tool-basierte Pruefung |
 | `hybrid` | Kombination mehrerer Methoden |
 
-**Category** (17 thematische Kategorien):
-encryption, authentication, network, data_protection, logging, incident,
-continuity, compliance, supply_chain, physical, personnel, application,
-system, risk, governance, hardware, identity
+**Category** (22 thematische Kategorien):
+
+| Kategorie | Beschreibung |
+|-----------|-------------|
+| `encryption` | Verschluesselung, Kryptographie |
+| `authentication` | Authentifizierung, Login, MFA |
+| `network` | Netzwerk, Firewall, VPN |
+| `data_protection` | Datenschutz, DSGVO |
+| `logging` | Protokollierung, Monitoring |
+| `incident` | Vorfallmanagement |
+| `continuity` | Business Continuity, Backup |
+| `compliance` | Konformitaet, Audit, Zertifizierung |
+| `supply_chain` | Lieferkette, Dienstleister |
+| `physical` | Physische Sicherheit |
+| `personnel` | Schulung, Mitarbeiter |
+| `application` | Software, Code Review, API |
+| `system` | Haertung, Patch, Konfiguration |
+| `risk` | Risikobewertung, -management |
+| `governance` | Sicherheitsorganisation, Richtlinien |
+| `hardware` | Hardware, Firmware, TPM |
+| `identity` | IAM, SSO, Verzeichnisdienste |
+| `public_administration` | Behoerden, Verwaltung |
+| `labor_law` | Arbeitsrecht, Arbeitsschutz |
+| `finance` | Finanzregulierung, Rechnungslegung |
+| `trade_regulation` | Gewerbe, Handelsrecht |
+| `environmental` | Umweltschutz, Nachhaltigkeit |
+| `health` | Gesundheit, Medizinprodukte |
 
 ### Konfiguration
 
@@ -379,7 +473,7 @@ system, risk, governance, hardware, identity
 | `ANTHROPIC_API_KEY` | — | API-Key fuer Anthropic Claude |
 | `CONTROL_GEN_ANTHROPIC_MODEL` | `claude-sonnet-4-6` | Anthropic-Modell fuer Formulierung |
 | `OLLAMA_URL` | `http://host.docker.internal:11434` | Lokaler Ollama-Server (Vorfilter) |
-| `CONTROL_GEN_OLLAMA_MODEL` | `qwen3:30b-a3b` | Lokales LLM fuer Vorfilter |
+| `CONTROL_GEN_OLLAMA_MODEL` | `qwen3.5:35b-a3b` | Lokales LLM fuer Vorfilter + QA |
 | `CONTROL_GEN_LLM_TIMEOUT` | `180` | Timeout in Sekunden (erhoet fuer Batch-Calls) |
 
 **Pipeline-Konfiguration (via `GeneratorConfig`):**
@@ -388,6 +482,7 @@ system, risk, governance, hardware, identity
 |-----------|---------|-------------|
 | `batch_size` | `5` | Chunks pro Anthropic-API-Call |
 | `max_controls` | `0` | Limit (0 = alle Chunks verarbeiten) |
+| `max_chunks` | `1000` | Max Chunks pro Job (respektiert Dokumentgrenzen) |
 | `skip_processed` | `true` | Bereits verarbeitete Chunks ueberspringen |
 | `dry_run` | `false` | Trockenlauf ohne DB-Schreibzugriffe |
 | `skip_web_search` | `false` | Web-Suche fuer Anchor-Finder ueberspringen |
@@ -423,12 +518,16 @@ curl https://macmini:8002/api/compliance/v1/canonical/generate/jobs \
 | Collection | Inhalte | Erwartete Regel |
 |-----------|---------|----------------|
 | `bp_compliance_gesetze` | Deutsche Gesetze (BDSG, TTDSG, TKG etc.) | Rule 1 |
-| `bp_compliance_recht` | EU-Verordnungen (DSGVO, NIS2, AI Act etc.) | Rule 1 |
-| `bp_compliance_datenschutz` | Datenschutz-Leitlinien | Rule 1/2 |
+| `bp_compliance_datenschutz` | Datenschutz-Leitlinien + EU-Verordnungen | Rule 1/2 |
 | `bp_compliance_ce` | CE/Sicherheitsstandards | Rule 1/2/3 |
 | `bp_dsfa_corpus` | DSFA-Korpus | Rule 1/2 |
 | `bp_legal_templates` | Rechtsvorlagen | Rule 1 |
 
+!!! warning "bp_compliance_recht entfernt (2026-03-16)"
+    Die Collection `bp_compliance_recht` wurde geloescht, da sie mit `bp_compliance_datenschutz`
+    ueberlappte (~20.000 Duplikat-Chunks). Alle relevanten EU-Verordnungen sind in den anderen
+    Collections enthalten.
+
 ---
 
 ## Processed Chunks Tracking
@@ -514,10 +613,10 @@ curl -s https://macmini:8002/api/compliance/v1/canonical/generate/processed-stat
 
 | Metrik | Wert |
 |--------|------|
-| RAG-Chunks gesamt | ~183.000 |
-| Verarbeitete Chunks | ~183.000 (vollstaendig) |
-| Generierte Controls | **~2.120** |
-| Konversionsrate | ~1,2% (nur sicherheitsrelevante Chunks erzeugen Controls) |
+| RAG-Chunks gesamt | ~105.000 (nach Dedup 2026-03-16) |
+| Verarbeitete Chunks | ~105.000 |
+| Generierte Controls | **~4.738** |
+| Konversionsrate | ~4,5% (nur sicherheitsrelevante Chunks erzeugen Controls) |
 
 !!! info "Warum so wenige Controls?"
     Die meisten RAG-Chunks sind Definitionen, Begriffsbestimmungen, Inhaltsverzeichnisse oder

docs-src/services/sdk-modules/training.md

@@ -1,22 +1,27 @@
 # Training Engine (CP-TRAIN)
 
-KI-generierte Schulungsinhalte, Rollenmatrix, Quiz-Engine und Zertifikatsverwaltung für Compliance-Schulungen.
+KI-generierte Schulungsinhalte, Rollenmatrix, Quiz-Engine, Zertifikate und Training Blocks fuer Compliance-Schulungen.
 
 **Prefix:** `CP-TRAIN` · **seq:** 4800 · **Frontend:** `https://macmini:3007/sdk/training`
+**Learner-Portal:** `https://macmini:3007/sdk/training/learner`
 **Service:** `ai-compliance-sdk` (Go/Gin, Port 8093)
 **Proxy:** `/api/sdk/v1/training/[[...path]]` → `ai-compliance-sdk:8090/sdk/v1/training/...`
+**Developer Portal:** `https://macmini:3006/api/training`
 
 ---
 
 ## Features
 
-- Rollenbasierte Schulungsmatrix (Wer muss was absolvieren?)
+- Rollenbasierte Schulungsmatrix (CTM) — 10 Rollen (R1–R10)
 - KI-generierte Schulungsinhalte (Text, Audio, Video via TTS-Service)
-- Quiz-Engine mit automatischer Auswertung
-- Deadline-Tracking und Eskalation bei Überziehung
+- Quiz-Engine mit automatischer Auswertung und Bestehensgrenze
+- Deadline-Tracking und 4-stufige Eskalation (7/14/30/45 Tage)
 - Aufgabenzuweisung (Assignments) mit Fortschrittstracking
-- Unveränderliches Audit-Log für Compliance-Nachweise
-- Bulk-Content-Generierung für alle Module auf einmal
+- PDF-Zertifikate nach erfolgreichem Abschluss
+- Training Blocks — automatische Modul-Erstellung aus Canonical Controls
+- Learner-Portal fuer Mitarbeiter (Schulung absolvieren, Quiz, Zertifikat)
+- Unveraenderliches Audit-Log fuer Compliance-Nachweise
+- Bulk-Content-Generierung fuer alle Module auf einmal
 
 ---
 
@@ -25,13 +30,15 @@ KI-generierte Schulungsinhalte, Rollenmatrix, Quiz-Engine und Zertifikatsverwalt
 | Artikel | Bezug |
 |---------|-------|
 | Art. 39 Abs. 1b DSGVO | DSB-Aufgabe: Sensibilisierung und Schulung |
-| Art. 5 AI Act | Schulungspflicht für verbotene KI-Praktiken |
-| Art. 4 Abs. 2 AI Act | Schulung für KI-Alphabetisierung |
+| Art. 5 AI Act | Schulungspflicht fuer verbotene KI-Praktiken |
+| Art. 4 Abs. 2 AI Act | Schulung fuer KI-Alphabetisierung |
 
 ---
 
 ## Tabs / Ansichten
 
+### Admin-Frontend (`/sdk/training`)
+
 | Tab | Inhalt |
 |-----|--------|
 | `overview` | Statistiken, Deadline-Warnung, Eskalation-Check |
@@ -39,7 +46,23 @@ KI-generierte Schulungsinhalte, Rollenmatrix, Quiz-Engine und Zertifikatsverwalt
 | `matrix` | Rollen-Modul-Matrix — wer muss welche Schulung absolvieren |
 | `assignments` | Zugewiesene Schulungen mit Fortschritt und Deadline |
 | `content` | KI-generierter Inhalt pro Modul + Audio/Video-Player |
-| `audit` | Unveränderliches Audit-Log aller Schulungsaktivitäten |
+| `audit` | Unveraenderliches Audit-Log aller Schulungsaktivitaeten |
+
+### Learner-Portal (`/sdk/training/learner`)
+
+| Tab | Inhalt |
+|-----|--------|
+| Meine Schulungen | Zuweisungsliste mit Status-Badges, Fortschrittsbalken, Deadline |
+| Schulungsinhalt | Modul-Content (Markdown), AudioPlayer, VideoPlayer |
+| Quiz | Fragen mit Antwortauswahl, Timer, Ergebnis-Anzeige |
+| Zertifikate | Grid mit abgeschlossenen Schulungen, PDF-Download |
+
+**Learner-Workflow:**
+
+1. Mitarbeiter sieht seine Zuweisungen
+2. Klickt "Schulung starten" → Content lesen, Audio/Video anhoeren
+3. "Quiz starten" → Fragen beantworten
+4. Bei Bestehen: "Zertifikat generieren" → PDF-Download
 
 ---
 
@@ -49,65 +72,122 @@ KI-generierte Schulungsinhalte, Rollenmatrix, Quiz-Engine und Zertifikatsverwalt
 
 | Methode | Pfad | Beschreibung |
 |---------|------|--------------|
-| `GET` | `/sdk/v1/training/modules` | Alle Module (`status`, `regulation` Filter) |
-| `GET` | `/sdk/v1/training/modules/:id` | Modul-Detail |
+| `GET` | `/sdk/v1/training/modules` | Alle Module (`regulation_area`, `frequency_type`, `search` Filter) |
+| `GET` | `/sdk/v1/training/modules/:id` | Modul-Detail mit Content und Quiz-Fragen |
 | `POST` | `/sdk/v1/training/modules` | Modul erstellen |
 | `PUT` | `/sdk/v1/training/modules/:id` | Modul aktualisieren |
-| `DELETE` | `/sdk/v1/training/modules/:id` | Modul löschen |
+| `DELETE` | `/sdk/v1/training/modules/:id` | Modul loeschen |
 
-### Rollenmatrix
+### Rollenmatrix (CTM)
 
 | Methode | Pfad | Beschreibung |
 |---------|------|--------------|
-| `GET` | `/sdk/v1/training/matrix` | Vollständige Rollenmatrix |
-| `GET` | `/sdk/v1/training/matrix/role/:role` | Matrix für eine Rolle |
-| `POST` | `/sdk/v1/training/matrix` | Eintrag hinzufügen |
+| `GET` | `/sdk/v1/training/matrix` | Vollstaendige Rollenmatrix |
+| `GET` | `/sdk/v1/training/matrix/:role` | Matrix fuer eine Rolle |
+| `POST` | `/sdk/v1/training/matrix` | Eintrag hinzufuegen |
 | `DELETE` | `/sdk/v1/training/matrix/:role/:moduleId` | Eintrag entfernen |
 
+**Rollen:** R1 Geschaeftsfuehrung, R2 IT-Leitung, R3 DSB, R4 ISB, R5 HR, R6 Einkauf, R7 Fachabteilung, R8 IT-Admin, R9 Alle Mitarbeiter, R10 Behoerden
+
 ### Assignments
 
 | Methode | Pfad | Beschreibung |
 |---------|------|--------------|
-| `GET` | `/sdk/v1/training/assignments` | Alle Zuweisungen (Filter: `status`, `role`, `moduleId`) |
+| `GET` | `/sdk/v1/training/assignments` | Alle Zuweisungen (Filter: `user_id`, `module_id`, `role`, `status`) |
 | `GET` | `/sdk/v1/training/assignments/:id` | Zuweisung-Detail |
 | `POST` | `/sdk/v1/training/assignments/compute` | Zuweisungen aus Matrix berechnen |
 | `POST` | `/sdk/v1/training/assignments/:id/start` | Schulung starten |
+| `POST` | `/sdk/v1/training/assignments/:id/progress` | Fortschritt aktualisieren |
+| `POST` | `/sdk/v1/training/assignments/:id/complete` | Schulung abschliessen |
 | `PUT` | `/sdk/v1/training/assignments/:id` | Deadline aktualisieren |
-| `POST` | `/sdk/v1/training/assignments/:id/complete` | Schulung abschließen |
 
-### KI-Inhalt
+### KI-Content-Generierung
 
 | Methode | Pfad | Beschreibung |
 |---------|------|--------------|
-| `GET` | `/sdk/v1/training/modules/:id/content` | Aktueller Inhalt |
-| `POST` | `/sdk/v1/training/modules/:id/generate` | Inhalt KI-generieren (Skript, Audio, Video) |
+| `POST` | `/sdk/v1/training/content/generate` | Inhalt KI-generieren (Markdown) |
+| `POST` | `/sdk/v1/training/content/generate-quiz` | Quiz-Fragen KI-generieren |
+| `GET` | `/sdk/v1/training/content/:moduleId` | Veroeffentlichten Content laden |
+| `POST` | `/sdk/v1/training/content/:contentId/publish` | Inhalt freigeben |
 | `POST` | `/sdk/v1/training/content/generate-all` | Alle Module bulk-generieren |
-| `POST` | `/sdk/v1/training/content/:id/publish` | Inhalt freigeben |
+| `POST` | `/sdk/v1/training/content/generate-all-quiz` | Alle Quizzes bulk-generieren |
 
 ### Quiz
 
 | Methode | Pfad | Beschreibung |
 |---------|------|--------------|
-| `GET` | `/sdk/v1/training/modules/:id/quiz` | Quiz-Fragen |
-| `POST` | `/sdk/v1/training/modules/:id/quiz/generate` | Quiz KI-generieren |
-| `POST` | `/sdk/v1/training/modules/:id/quiz/generate-all` | Alle Quizzes bulk-generieren |
-| `POST` | `/sdk/v1/training/modules/:id/quiz/submit` | Antworten einreichen |
-| `GET` | `/sdk/v1/training/assignments/:id/attempts` | Quiz-Versuche |
+| `GET` | `/sdk/v1/training/quiz/:moduleId` | Quiz-Fragen fuer ein Modul |
+| `POST` | `/sdk/v1/training/quiz/:moduleId/submit` | Antworten einreichen |
+| `GET` | `/sdk/v1/training/quiz/attempts/:assignmentId` | Quiz-Versuche anzeigen |
+
+### Media (Audio/Video)
+
+| Methode | Pfad | Beschreibung |
+|---------|------|--------------|
+| `POST` | `/sdk/v1/training/content/:moduleId/generate-audio` | Audio generieren (Piper TTS) |
+| `POST` | `/sdk/v1/training/content/:moduleId/generate-video` | Video generieren (TTS + Folien) |
+| `POST` | `/sdk/v1/training/content/:moduleId/preview-script` | Video-Script Vorschau (JSON) |
+| `GET` | `/sdk/v1/training/media/module/:moduleId` | Alle Medien eines Moduls |
+| `GET` | `/sdk/v1/training/media/:mediaId/url` | Metadaten (Bucket, Object Key) |
+| `POST` | `/sdk/v1/training/media/:mediaId/publish` | Media veroeffentlichen |
+| `GET` | `/sdk/v1/training/media/:mediaId/stream` | **Media streamen** (307 → Presigned URL) |
+
+**Media-Streaming:** Der `/stream`-Endpoint liefert einen `307 Temporary Redirect` zu einer zeitlich begrenzten Presigned URL (MinIO/S3). Browser und Player folgen dem Redirect automatisch. Der Next.js-Proxy leitet den Redirect transparent weiter.
 
 ### Deadlines & Eskalation
 
 | Methode | Pfad | Beschreibung |
 |---------|------|--------------|
 | `GET` | `/sdk/v1/training/deadlines` | Bevorstehende Deadlines |
-| `GET` | `/sdk/v1/training/deadlines/overdue` | Überfällige Deadlines |
-| `POST` | `/sdk/v1/training/escalations/check` | Eskalation auslösen |
+| `GET` | `/sdk/v1/training/deadlines/overdue` | Ueberfaellige Deadlines |
+| `POST` | `/sdk/v1/training/escalation/check` | Eskalation ausfuehren |
+
+**Eskalationsstufen:**
+
+| Stufe | Tage ueberfaellig | Aktion |
+|-------|-------------------|--------|
+| 1 | 7 Tage | Erinnerung an Mitarbeiter |
+| 2 | 14 Tage | Benachrichtigung Teamleitung |
+| 3 | 30 Tage | Benachrichtigung Management |
+| 4 | 45 Tage | Benachrichtigung Compliance Officer |
+
+### Zertifikate
+
+| Methode | Pfad | Beschreibung |
+|---------|------|--------------|
+| `POST` | `/sdk/v1/training/certificates/generate/:assignmentId` | Zertifikat generieren |
+| `GET` | `/sdk/v1/training/certificates` | Alle Zertifikate des Tenants |
+| `GET` | `/sdk/v1/training/certificates/:id/pdf` | Zertifikat als PDF herunterladen |
+| `GET` | `/sdk/v1/training/certificates/:id/verify` | Zertifikat verifizieren |
+
+**Voraussetzungen:** Status `completed` UND `quiz_passed = true`. Das PDF wird im Querformat (A4 Landscape) generiert und enthaelt Modul-Titel, Benutzer-Name, Datum und eine eindeutige Zertifikats-ID.
+
+### Training Blocks (Controls → Module)
+
+| Methode | Pfad | Beschreibung |
+|---------|------|--------------|
+| `GET` | `/sdk/v1/training/blocks` | Alle Block-Konfigurationen |
+| `POST` | `/sdk/v1/training/blocks` | Block-Konfiguration erstellen |
+| `GET` | `/sdk/v1/training/blocks/:id` | Block-Konfiguration laden |
+| `PUT` | `/sdk/v1/training/blocks/:id` | Block-Konfiguration aktualisieren |
+| `DELETE` | `/sdk/v1/training/blocks/:id` | Block-Konfiguration loeschen |
+| `POST` | `/sdk/v1/training/blocks/:id/preview` | Vorschau: Welche Controls/Module? |
+| `POST` | `/sdk/v1/training/blocks/:id/generate` | Module generieren (Content + CTM) |
+| `GET` | `/sdk/v1/training/blocks/:id/controls` | Verlinkte Controls anzeigen |
+
+### Canonical Controls
+
+| Methode | Pfad | Beschreibung |
+|---------|------|--------------|
+| `GET` | `/sdk/v1/training/canonical/controls` | Controls auflisten (Filter: domain, category, severity, target_audience) |
+| `GET` | `/sdk/v1/training/canonical/meta` | Metadaten (Domains, Kategorien, Audiences mit Counts) |
 
 ### Statistiken & Audit
 
 | Methode | Pfad | Beschreibung |
 |---------|------|--------------|
-| `GET` | `/sdk/v1/training/stats` | Überblick-Statistiken |
-| `GET` | `/sdk/v1/training/audit` | Audit-Log (Filter: `action`, `moduleId`, `userId`) |
+| `GET` | `/sdk/v1/training/stats` | Ueberblick-Statistiken |
+| `GET` | `/sdk/v1/training/audit-log` | Audit-Log (Filter: `action`, `entity_type`, `limit`, `offset`) |
 
 ---
 
@@ -118,7 +198,7 @@ seq 4700: Academy (Compliance Academy — manuelle Schulungen)
 seq 4800: Training Engine (KI-generierte Schulungen, Matrix, Quiz)
 ```
 
-Das Training-Modul erweitert die Academy um KI-generierte Inhalte. Während die Academy einfache Schulungseinheiten verwaltet, bietet die Training Engine automatische Inhaltsgenerierung, eine Rollenmatrix und eine vollständige Quiz-Engine.
+Das Training-Modul erweitert die Academy um KI-generierte Inhalte. Waehrend die Academy einfache Schulungseinheiten verwaltet, bietet die Training Engine automatische Inhaltsgenerierung, eine Rollenmatrix und eine vollstaendige Quiz-Engine.
 
 ---
 
@@ -128,25 +208,39 @@ KI-generierte Inhalte werden via `compliance-tts-service` (Port 8095) in Audio u
 
 - **Audio:** Piper TTS → MP3 (Modell: `de_DE-thorsten-high.onnx`)
 - **Video:** FFmpeg → MP4 (Skript + Stimme + Untertitel)
-- **Storage:** S3-kompatibles Object Storage (TLS)
+- **Storage:** S3-kompatibles Object Storage (Hetzner, TLS)
+- **Streaming:** `/media/:id/stream` → 307 Redirect zu MinIO Presigned URL
 
 ```
-AudioPlayer → /sdk/v1/training/modules/:id/media (audio)
-VideoPlayer → /sdk/v1/training/modules/:id/media (video)
+AudioPlayer → /sdk/v1/training/media/:mediaId/stream
+VideoPlayer → /sdk/v1/training/media/:mediaId/stream
+TTS Service → POST /presigned-url (returns pre-signed MinIO URL)
 ```
 
 ---
 
 ## Frontend
 
+### Admin-Frontend
+
 **URL:** `https://macmini:3007/sdk/training`
 
-6-Tab-Oberfläche mit:
+6-Tab-Oberflaeche mit:
 - Statistik-Dashboard (Abschlussquote, offene Schulungen, Deadlines)
-- Modul-CRUD mit Regulierungs-Badges
+- Modul-CRUD mit Regulierungs-Badges und Loeschfunktion
 - Interaktive Rollenmatrix (Checkboxen)
 - Fortschritts-Balken pro Assignment
-- Eingebetteter Audio/Video-Player für KI-generierte Inhalte
+- Eingebetteter Audio/Video-Player fuer KI-generierte Inhalte
+
+### Learner-Portal
+
+**URL:** `https://macmini:3007/sdk/training/learner`
+
+4-Tab-Oberflaeche fuer Mitarbeiter:
+- Meine Schulungen: Zuweisungsliste mit Status, Fortschritt, Deadline
+- Schulungsinhalt: Markdown-Rendering, Audio-Player, Video-Player
+- Quiz: Multiple-Choice mit Timer, Ergebnis-Anzeige, Bestehens-Logik
+- Zertifikate: Uebersicht abgeschlossener Schulungen, PDF-Download
 
 ---
 
@@ -155,11 +249,29 @@ VideoPlayer → /sdk/v1/training/modules/:id/media (video)
 Die Training Engine verwendet eigene Tabellen im `compliance` Schema:
 
 ```sql
-training_modules       -- Schulungsmodule (title, regulation, frequency, ...)
-training_matrix        -- Rollen-Modul-Zuordnungen
-training_assignments   -- Zuweisungen (user, module, status, progress, deadline)
-training_content       -- KI-generierter Inhalt (script, audio_url, video_url, ...)
-training_quiz          -- Quiz-Fragen pro Modul
-training_quiz_attempts -- Eingereichter Antworten + Score
-training_audit_log     -- Unveränderliches Audit-Log
+training_modules           -- Schulungsmodule (title, regulation, frequency, ...)
+training_matrix            -- Rollen-Modul-Zuordnungen (CTM)
+training_assignments       -- Zuweisungen (user, module, status, progress, deadline, certificate_id)
+training_content           -- KI-generierter Inhalt (markdown, summary, llm_model)
+training_quiz_questions    -- Quiz-Fragen pro Modul (options JSONB, correct_index)
+training_quiz_attempts     -- Eingereichte Antworten + Score
+training_media             -- Audio/Video-Dateien (bucket, object_key, status)
+training_audit_log         -- Unveraenderliches Audit-Log
+training_block_configs     -- Block-Konfigurationen (Filter, Prefix, Frequenz)
+training_block_controls    -- Verlinkte Canonical Controls pro Block
+```
+
+---
+
+## Tests
+
+```bash
+# Handler-Tests (47 Tests)
+cd ai-compliance-sdk && go test -v ./internal/api/handlers/ -run "TestGet|TestCreate|TestUpdate|TestDelete|..."
+
+# Escalation + Content Generator Tests (43 Tests)
+cd ai-compliance-sdk && go test -v ./internal/training/ -run "TestEscalation|TestBuildContent|TestParseQuiz|..."
+
+# Block Generator Tests (14 Tests)
+cd ai-compliance-sdk && go test -v ./internal/training/ -run "TestBlock"
 ```