breakpilot-compliance/docs-src/services/sdk-modules/requirements.md

Anforderungen (CP-ANF)

Verwaltet regulatorische Anforderungen aus DSGVO, AI Act, CRA, NIS2 und weiteren Regulierungen.

Prefix: CP-ANF · Frontend: https://macmini:3007/sdk/anforderungen Proxy: /api/sdk/v1/compliance/[[...path]] → backend-compliance:8002/compliance/...

---

Features

• Paginierte Anforderungsliste mit Freitextsuche
• Filtert nach Regulierung, Anwendbarkeit und Implementierungsstatus
• Verknüpfung mit Controls und Audit-Tracking
• RAG-Rechtskontext: Holt passende Gesetzestexte aus dem Vector-Store

---

Rechtsgrundlage

Regulierung	Beispielartikel
DSGVO	Art. 5, Art. 24, Art. 32
AI Act	Art. 9, Art. 13
NIS2	Art. 21
CRA	Art. 13

---

API Endpoints

Methode	Pfad	Beschreibung
GET	/compliance/requirements	Paginierte Liste (page, page_size, search, is_applicable)
GET	/compliance/requirements/{id}	Einzelne Anforderung + optionaler RAG-Rechtskontext
GET	/compliance/regulations/{code}/requirements	Alle Anforderungen einer Regulierung
POST	/compliance/requirements	Neue Anforderung anlegen
PUT	/compliance/requirements/{id}	Implementierungsstatus, Audit-Notizen aktualisieren
DELETE	/compliance/requirements/{id}	Anforderung löschen

RAG-Rechtskontext

GET /compliance/requirements/{id}?include_legal_context=true

Gibt zusätzlich legal_context[] mit RAG-Ergebnissen zurück:

{
  "legal_context": [
    {
      "text": "...",
      "regulation_code": "GDPR",
      "article": "Art. 32",
      "score": 0.92,
      "source_url": "https://eur-lex.europa.eu/..."
    }
  ]
}

RAG-Extraktion: Anforderungen automatisch aus Corpus erstellen

POST /compliance/extract-requirements-from-rag

Durchsucht alle RAG-Collections parallel nach Prüfaspekten / Audit-Kriterien und legt automatisch Requirement-Einträge in der DB an.

Request:

{
  "collections": null,
  "search_queries": null,
  "regulation_codes": ["BSI-TR-03161-1", "GDPR"],
  "max_per_query": 20,
  "dry_run": true
}

Feld	Typ	Standard	Beschreibung
collections	string[]?	alle	RAG-Collections durchsuchen (bp_compliance_ce, bp_compliance_recht, ...)
search_queries	string[]?	5 Standard-Queries	Suchbegriffe (MUSS/SOLL-Prüfaspekte etc.)
regulation_codes	string[]?	alle	Nur bestimmte Regulierungen einschließen
max_per_query	int	20	top_k pro Suchquery
dry_run	bool	false	true = Vorschau ohne DB-Schreibzugriff

Response:

{
  "created": 47,
  "skipped_duplicates": 12,
  "skipped_no_article": 3,
  "failed": 0,
  "collections_searched": ["bp_compliance_ce", "bp_compliance_recht"],
  "queries_used": ["Prüfaspekt Anforderung MUSS SOLL", "..."],
  "dry_run": false,
  "message": "Erstellt: 47, Duplikate übersprungen: 12, ...",
  "requirements": [
    {
      "regulation_code": "BSI-TR-03161-1",
      "article": "M.Zugriffsschutz_01",
      "title": "Implementierung einer Zugangskontrolle",
      "requirement_text": "...",
      "source_url": "...",
      "score": 0.91,
      "action": "created"
    }
  ]
}

Deduplication: Bereits vorhandene (regulation_code, article) Kombinationen werden übersprungen — sicheres Mehrfachaufrufen.

Auto-Regulation-Stubs: Für unbekannte Regulierungscodes werden automatisch Regulation-Stubs angelegt.

---

Request-Beispiel (POST)

{
  "regulation_id": "uuid-der-regulierung",
  "article": "Art. 32",
  "title": "Sicherheit der Verarbeitung",
  "is_applicable": true,
  "priority": 1
}

Response-Felder (RequirementResponse)

Feld	Typ	Beschreibung
id	string	UUID
regulation_code	string	z.B. "GDPR", "AI_ACT"
article	string	Artikel-Referenz
implementation_status	string	not_started / implemented / partial
audit_status	string	pending / passed / failed
last_audit_date	datetime?	Letztes Audit-Datum

---

Frontend

URL: https://macmini:3007/sdk/anforderungen

Zeigt eine filterbare Tabelle aller Anforderungen. Detailansicht öffnet sich per Klick und zeigt neben Metadaten optional den RAG-Rechtskontext mit Quellenangabe.

---

Datenbankschema

compliance_requirements (
  id                    UUID PRIMARY KEY,
  regulation_id         UUID REFERENCES compliance_regulations(id),
  article               VARCHAR,
  title                 TEXT,
  description           TEXT,
  is_applicable         BOOLEAN DEFAULT true,
  priority              INTEGER,
  implementation_status VARCHAR DEFAULT 'not_started',
  audit_status          VARCHAR DEFAULT 'pending',
  last_audit_date       TIMESTAMP,
  audit_notes           TEXT,
  created_at            TIMESTAMP,
  updated_at            TIMESTAMP
)

---

Tests

Testdatei: backend-compliance/tests/test_requirement_routes.py Anzahl Tests: 18 · Status: ✅ alle bestanden (Stand 2026-03-05)

cd backend-compliance
python3 -m pytest tests/test_requirement_routes.py -v