Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VR-P31.md
T

78 lines
7.6 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)
- [ ] **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
### KWP-Vermerk aus VEXT-1/VR-P32a (übernommen 2026-07-12)
- HiveGrid speichert KWP-Client-Metadaten und Refresh-Token per-Tenant-DEK verschlüsselt in der Cloud;
die alte Aussage „KWP-Credentials verlassen das Kundennetz nie" gilt für den offiziellen API-Weg nicht.
- API-Aufrufe laufen über den KWP-Relay im Namen eines bnWin-Benutzers; dessen Rechte begrenzen die Daten.
- Archivdateien werden temporär über den von KWP dokumentierten Azure-Blob-Austausch übertragen
(`exchangeFileUri`; automatische Löschung laut KWP nach 24 Stunden) und anschließend in HiveGrids eigenem
Storage abgelegt.
- Für AVV/Subprozessoren sind deshalb KWP-Relay, temporärer Azure-Austausch, Datenkategorien, Region,
Aufbewahrung und KWP-Vertragsrolle ausdrücklich zu bewerten. Die fachliche VR-P31-DoD bleibt bis zur
finalen AVV-/Subprozessor-Veröffentlichung offen.
- **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
- Historische Milestone-Zuordnung: 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)
## Dev-Nachzug (nach Davids `D-P31`/`D-DSGVO`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/ROADMAP nachgezogen
- [ ] Plane-Ticket `VR-P31` aktualisiert