Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VR-P31.md
T

65 lines
6.4 KiB
Markdown

# 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)
## 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 VR-P25)~~ → **`TenantEmbedding`-Löschung = No-op ([[AD-26]]: nie befüllt, VR-P25 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