Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VR-P31.md
T
2026-07-08 16:15:37 +02:00

6.8 KiB

VR-P31 · DSGVO-Vollausbau: AVV/Subprozessoren/Auskunft (M166)

⚠️ KI→MCP-Pivot (AD-26): Die pgvector-TenantEmbedding-Löschung beim Hard-Delete wird ein No-op — TenantEmbedding wird nie befüllt (RAG entfällt; HiveGrid wird MCP-Server, VR-MCP). Der restliche DSGVO-Lösch-Workflow ist unverändert. Embedding-Stellen unten als No-op markiert.

Typ Dev (Code)
Owner Raffael
Phase Phase 31 (v2-P11, NUR DSGVO-Teil) — DSGVO-Vollausbau
Cycle/Fenster v2-W3 — Admin/Help/Dashboard/v2-Launch · fällig 2026-07-31
Status geplant

⚠ Risiko: Der AVV-PDF-Inhalt muss anwaltlich finalisiert werden (in v1 EXT-03 beauftragt) — das Engineering (Versionierung/Akzeptanz/PDF-Generierung) ist davon unabhängig baubar; nur der finale Vertragstext fehlt ggf. zum Launch.

Abhängigkeiten & Parallelität

  • Blocked by: AK-P21 (v1-DSGVO-Fundament: Export-/Lösch-Basis, ersetzt das manuelle v1-Playbook), VR-P28a (Admin-Legal-Verwaltung braucht AdminUser-Identität + cross-tenant AdminAuditLog)
  • Blocks: — (Phase-Ende, v2-Launch)
  • Läuft parallel zu: VR-P33 (HalloPetra, eigene Phase 33 — die ROADMAP-V2-Phase v2-P11 bündelt beide, dieses Doc deckt ausschließlich DSGVO ab). VA-P29/VA-P30 (Help/Dashboard, Akeshan) in W3. Eigene prisma/schema/dsgvo.prisma (AD-21); Admin-Legal-Tabellen sind global/admin-seitig.
  • Konflikt-Risiko: gering — gemeinsame Admin-Legal-Verwaltung mit der Admin-Welt (VR-P28a), sonst isoliert.

Was wir bauen

Den DSGVO-Vollausbau (M166): aus dem manuellen v1-Playbook werden echte Self-Service-Workflows. Tenants akzeptieren eine versionierte AVV (dynamisches PDF, elektronische Akzeptanz); bei Updates ist Re-Akzeptanz innerhalb 14 Tagen erzwungen (danach Read-Only). Eine Subprozessoren-Liste mit Drittland-Warnung führt einen 14-Tage-Widerspruchs-Workflow. User exportieren ihre Daten (Art. 15/20); Tenants ziehen einen asynchronen Voll-Export (ZIP, 7-Tage-Download-Window) und durchlaufen einen Tenant-Lösch-Workflow (30-Tage-Grace + Hard-Delete-Cron, inkl. pgvector-Embedding-Löschung beim Hard-Delete → No-op: TenantEmbedding nie befüllt, RAG entfällt AD-26). Admin-Legal-Verwaltung (Subprozessoren + AVV-Versionen) mit AdminAuditLog.

Benötigte Screens (Backend bedient — Design liefert D-P31/D-DSGVO)

Screen [Route] Kern-Inhalt
DSGVO/Privacy-Hub [/settings/privacy] Übersicht: Export-Jobs, AVV-Status/-Download, Subprozessoren, Tenant-Lösch-Einstieg
AVV-Download & History [/settings/privacy/dpa] Aktuelle AVV als dynamisches PDF, Akzeptanz-Status, Versions-Historie, Re-Akzeptanz (14-Tage-Frist → Read-Only)
Subprozessoren-Liste [/settings/privacy/subprocessors] Liste mit Drittland-Warnung, 14-Tage-Widerspruchs-Workflow
Tenant-Voll-Export [/settings/privacy/export] Async-Export-Job (ZIP), Job-Status, 7-Tage-Download-Window
Tenant-Lösch-Workflow [/settings/privacy/delete] Multi-Step-Lösch-Flow mit Slug-Confirm, 30-Tage-Grace-Hinweis, Hard-Delete-Folgen
User-Daten-Export / Account-Löschung [/profile/privacy] Eigener Daten-Export (Art. 15/20), Account-Löschung erreichbar
Admin: Subprozessoren-Verwaltung [admin.hivegrid.de/legal/subprocessors] Anlegen/ändern, Drittland-Flag, Benachrichtigung auslösen
Admin: AVV-Versions-Verwaltung [admin.hivegrid.de/legal/dpa] AVV-Versionen pflegen, Veröffentlichung, Akzeptanz-Übersicht je Tenant

Definition of Done

  • AVV-Versionierung + dynamisches PDF + elektronische Akzeptanz + Re-Akzeptanz-Frist (14 Tage → Read-Only)
  • Subprozessoren-Liste + Drittland-Warnung + 14-Tage-Widerspruchs-Workflow
  • User-Daten-Export (Art. 15/20)
  • Tenant-Voll-Export (ZIP, async, 7-Tage-Download-Window)
  • Tenant-Lösch-Workflow (30-Tage-Grace + Hard-Delete-Cron, inkl. pgvector-Embedding-Löschung beim Hard-Delete → No-op (AD-26: TenantEmbedding nie befüllt))
  • Admin-Legal-Verwaltung (Subprozessoren + AVV-Versionen) mit AdminAuditLog
  • KWP-Subprozessor-Vermerk übernommen (Creds liegen ab v2-P5 verschlüsselt in der Cloud — aus VR-P32a)
  • Lösch-Strategien der offenen USER_FK_MAP-Einträge fachlich/rechtlich bestätigt — AdminTenantNote.authorUserId + SupportTicket.assignedToUserId + SupportTicketMessage.authorUserId → retain-tombstone/Export-Ausschluss abnehmen. Code-Strategie ist gewählt + begründet (packages/db/src/dsgvo/user-fk-map.ts); offen ist nur das DSGVO-Confirm — verlagert aus dem dortigen TODO.

Technische Bausteine

  • Entities (eigene prisma/schema/dsgvo.prisma, AD-21): AvvAcceptance (v1: avv_version, accepted_by, pdf_file_id, signer_name, [RLS]) + AVV-Versions-Entity (global/admin-seitig: Versionen + Veröffentlichung), Subprocessor (v1/global: name, country, is_eu_eea, data_categories, dpa_url) + Widerspruchs-Entity (Tenant-bezogen, 14-Tage-Frist), TenantDeletionRequest (v1: reason, grace_period_ends_at (+30d), status, [RLS], Slug-Confirm), Export-Job-Entity (async, ZIP, 7-Tage-Window).
  • AVV: dynamisches PDF aus Template + Tenant-Daten; elektronische Akzeptanz speichert avv_version + accepted_by + signer_name + pdf_file_id; Re-Akzeptanz-Resolver setzt Tenant nach 14 Tagen auf Read-Only.
  • Hard-Delete-Cron: nach 30-Tage-Grace löscht der Cron alle Tenant-Daten. inkl. pgvector-TenantEmbedding (Andockpunkt an alten VR-P25-Scope) → TenantEmbedding-Löschung = No-op (AD-26: nie befüllt, alter VR-P25-Scope zurückgestellt).
  • RLS: Tenant-bezogene DSGVO-Daten mit app.tenant_id; Subprocessor/AVV-Versionen global; Admin-Legal-Verwaltung via AdminAuditLog (VR-P28a, kein BYPASSRLS).
  • Wiederverwendung: v1-DSGVO-Export/-Lösch-Fundament (AK-P21), v1-Files (Export-ZIP, AVV-PDF), BullMQ-Worker (async Export), v1-Frozen→Deletion.
  • is_demo_data: nicht relevant (Compliance-Daten).

Quellen (granular)

  • ROADMAP-V2.md → §v2-P11 (NUR DSGVO-Teil: Success-Criteria 3/4/5, DSGVO/Privacy-Hub + Admin-Legal-Screens) — Hauptquelle
  • ROADMAP.md → Phase 31
  • PHASE-SOURCES.md → Phase 31 (M166; v1: M166 → manuelles Playbook, v2: echte Workflows)
  • ENTITY-MODEL.md → Domäne 13 DSGVO (AvvAcceptance, Subprocessor, TenantDeletionRequest) , TenantEmbedding [v2] (Embedding-Löschung) → entfällt (AD-26: TenantEmbedding zurückgestellt)
  • designer-briefs/P31-dsgvo-vollausbau.md (alle Screens, AVV/Subprozessoren/Export/Lösch-Workflow, AVV-PDF-Risiko)
  • _bmad-output/specs/M35-dsgvo-export.md

Dev-Nachzug (nach Davids D-P31/D-DSGVO-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket VR-P31 aktualisiert