# AK-P21 · P21 DSGVO (Export + Lösch-Workflow) + Feedback-Widget > ⚠️ **Billing-Recut 2026-07-04 ([[AD-27]]):** Tenant-Löschung storniert kuenftig den Billing-State ueber die > Lago/Mollie/HiveGrid-Billing-Gateways aus `BILL-*`, nicht ueber Legacy-Provider. Historische Legacy-Provider-Cancel-Erwaehnungen sind > als alter Adaptervertrag zu lesen und duerfen nicht als neue Legacy-Provider-Dependency weitergebaut werden. | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Akeshan | | **Phase** | P21 — DSGVO & Launch-Reife | | **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-09 · **Gate W4 (FREEZE)** | | **Status** | Blocked / On Hold, Teilumsetzung Backend/Fundament | ## Abhängigkeiten & Parallelität - **Blocked by:** `AK-P20`/`BILL-05` (Billing-Read-only/Frozen-State und Billing-Cancel-Vertrag; Feedback-Widget speist Admin-Support-Inbox aus AK-P19), `D-P21` (finale Privacy-/FAQ-/Feedback-Screens) - **Blocks:** **FREEZE** (letzte v1-Phase, macht den Big-Bang-Launch AD-19 auslösbar) - **Läuft parallel zu:** Raffaels Härtung/Launch-Tickets. Eigene `prisma/schema/gdpr.prisma` (AD-21); Feedback-Widget schreibt in `AdminSupportTicket` (AK-P19, generische Quelle); Export liest tenant-weit über RLS. - **Konflikt-Risiko:** gering — additive Tabellen + asynchrone BullMQ-Jobs; Crypto-Shredding berührt per-Tenant-DEK (AD-8), keine Schema-Änderung an Fach-Modulen. ## Was wir bauen Den **DSGVO-Lebenszyklus + Launch-Reife** (letzte v1-Phase): tenant- und user-weiter **DSGVO-ZIP-Export** (asynchroner BullMQ-Job mit Progress, **72h-signed-URL**, Rate-Limit), den **Tenant-Lösch-Workflow** (**Crypto-Shredding** per-Tenant-DEK, **Billing-Cancel ueber Lago/Mollie/HiveGrid-Gateway**, Storage/Cache/Index-Bereinigung, 30-Tage-Grace mit Read-Only + Abbruch, **Slug als Confirm-Phrase**), die **AVV-/Subprozessoren-Sichtbarkeit** im Privacy-Hub, ein **In-App-Feedback-Widget** (speist die Admin-Support-Inbox aus AK-P19) und eine **Minimal-FAQ**-Seite. **DSGVO-Auskunft = manuelles Playbook v1** (Suche → Kontakt-Detail → CSV → Anwalts-Vorlage → Frist-Task +25 Tage), **kein** Auskunfts-Wizard. PWA-only (AD-17): alle Screens mobil tauglich, kein nativer Client. ## Benötigte Screens (Backend bedient — Design liefert `D-P21`) | Screen [Route] | Kern-Inhalt | |---|---| | Privacy-Hub [`/admin/privacy`] | Übersicht Export/Löschung/Subprozessoren/AVV/Privacy-Manifest-Link, Einstieg in Sub-Bereiche | | Tenant-Daten-Export [`/admin/privacy/export`, `/new`, `/:jobId`] | Job-Liste mit Status/Progress/Download (72h-Link); Anstoßen mit Klartext (was, Größe/Dauer, 7-Tage-Window) | | Tenant-Löschung [`/admin/privacy/deletion`, `/:requestId`] | Multi-Step-Wizard: Erklärung (30-Tage-Grace, Read-Only, Hard-Delete) → Export-Angebot → Billing-/Zahlungs-Hinweis → Passwort+2FA → **Slug als Confirm-Phrase**; Grace-Countdown + Abbruch | | Subprozessoren [`/admin/privacy/subprocessors`] · AVV [`/admin/privacy/avv`] | Subprozessor-Tabelle (Land/EU-Marker/DPA-Link/Export); AVV-PDF-Download + Akzeptanz-History + Re-Akzeptanz-Modal | | User-Daten-Export [`/settings/account/data-export`, `/:jobId`] · Account-Löschung [`/settings/account/delete`] | User-Self-Export (signed-URL, Rate-Limit); Account-Lösch-Wizard (Passwort+2FA, 24h-Reverse-Window, M27 D.3) | | Feedback-Widget [global, klein] | Schwebender Button → Mini-Form (Bug/Feature/Frage, Text, Screenshot-Häkchen, Rate-Limit) → **Admin-Support-Inbox (AK-P19)** | | Minimal-FAQ [`/help`] | Statische FAQ (gruppierte Fragen/Antworten, Markdown), Suchfeld optional (kein Help-Center-Ausbau → v2) | ## Definition of Done - [ ] **DSGVO-ZIP-Export** (User-Self **und** Tenant-Full): asynchroner BullMQ-Job mit Progress, **72h-signed-URL**, Rate-Limit (max. 3 User-Self/24h, max. 1 Tenant-Full aktiv); README + manifest.json im ZIP — *teilweise 2026-07-02: `GdprExportJob` + Service-Regeln fuer Rate-Limit, Status/Progress und 72h-Expiry gebaut; ZIP-Builder + Worker-Runner mit README/manifest und Handler-Branch fuer `gdpr_user_self`/`gdpr_tenant_full`; Self-Service-Export legt Job an und enqueue't; Worker-Bootstrap + konservative Daten-Bundle-Loader fuer User/Tenant/Audit/Notifications gebaut. Offen: signierte Download-Route/E-Mail und breiteres Fachmodul-Inventar.* - [ ] **Tenant-Löschung**: **Crypto-Shredding** (per-Tenant-DEK) + **Billing-Cancel ueber Lago/Mollie/HiveGrid-Gateway** + Storage/Cache/Index-Bereinigung (AD-8); 30-Tage-Grace Read-Only + Abbruch; **Slug als Confirm-Phrase**; Billing-Cancel erst beim Hard-Delete-Cron — *teilweise 2026-07-02: `TenantDeletionRequest` + Service-Regeln fuer Slug-Confirm, 30-Tage-Grace, Abbruch und Cron-Liste gebaut; getesteter Hard-Delete-Orchestrierungsvertrag fuer Billing-Cancel, Storage, Search, Crypto-Shredding und Tenant-Row-Delete. Offen: produktive Bootstrap-Anbindung/Cron, AK-P20-/BILL-05-Read-Only-Hook, echte Adapter-Implementierungen.* - [ ] **AVV-Download** + Akzeptanz-History + Re-Akzeptanz (14-Tage-Frist, danach Read-Only-Sperre); **Subprozessoren-Liste** mit Drittland-Klartext (v1 EU-only) — *teilweise 2026-07-02: `AvvAcceptance`/`Subprocessor` + Service-Lese-/Akzeptanzpfad gebaut; PDF-Download/Re-Akzeptanz-Read-Only/finale Screens offen.* - [x] **DSGVO-Auskunft als dokumentiertes Playbook** (Suche → Kontakt-Detail → CSV → Anwalts-Vorlage → Frist-Task +25 Tage) — kein automatisches Tooling - [x] **In-App-Feedback-Widget** → speist Admin-Support-Inbox (AK-P19, generische Quelle) - [x] **Minimal-FAQ**-Seite (statisch) - [ ] Alle Screens **mobil tauglich** (PWA/responsive, AD-17); kein nativer Client; PWA-Installierbarkeit/Web-Push → v2 — *blockiert: finale Screen-Integration wartet auf `D-P21`; statische FAQ ist responsive.* - [x] Permissions: `privacy.user_export.self` (implizit jeder User), `privacy.tenant_export`/`privacy.tenant_deletion`/`privacy.avv.*`/`privacy.subprocessors.read` (über `tenant.admin`) ## Technische Bausteine - **Entities** (eigene `prisma/schema/gdpr.prisma`): `GdprExportJob` (scope user_self/tenant_full, status, result_file_id ZIP, result_expires_at), `TenantDeletionRequest` (reason, grace_period_ends_at +30d, status — Slug-Confirm), `AvvAcceptance` (avv_version, accepted_by, pdf_file_id, signer_name), `Subprocessor` (name, country, is_eu_eea, data_categories, dpa_url — global). Feedback schreibt in `AdminSupportTicket` (AK-P19). `core.prisma` über Tenant-Relation (AD-21). - **Export-Worker** (BullMQ): tenant-weiter/user-weiter Sammel-Export → ZIP (S3-kompatibel, Hetzner) mit 72h-signed-URL + README/manifest.json; Rate-Limit. - **Crypto-Shredding** (AD-8): per-Tenant-DEK löschen → Daten kryptographisch unlesbar; Billing-Cancel ueber Lago/Mollie/HiveGrid-Gateway + Storage/Cache/Index-Cleanup beim Hard-Delete-Cron; 30-Tage-Grace Read-Only-Middleware (Reuse aus AK-P20/BILL-05 Frozen-Modus). - **Feedback-Widget**: Rate-Limit + Screenshot via Files → `AdminSupportTicket` (source_kind in_app_feedback_widget). - **RLS** auf allen Tenant-Tabellen (Subprocessor global); `is_demo_data` n/a (kein Seed-Bedarf). ## Quellen (granular) - `ENTITY-MODEL.md` → **Domäne 13: Onboarding/Branding/DSGVO** (GdprExportJob, TenantDeletionRequest, AvvAcceptance, Subprocessor) + **Domäne 11** (AdminSupportTicket-Quelle) - `REQUIREMENTS.md` → `REQ-dsgvo-export`, `REQ-dsgvo-tenant-deletion`, `REQ-feedback-widget` (DSGVO-Auskunft/Help-Center → v2) - `ROADMAP.md` → Phase 21 · `PHASE-SOURCES.md` → Phase 21 (M164-daten-export, M165-loesch-workflow; Auskunft-Playbook M166, Feedback-Widget bleibt v1; Public-API/Mobile-Native/Help-Center → v2) - `designer-briefs/P21-dsgvo-launch.md` (Export, Lösch-Wizard, Feedback-Widget, Minimal-FAQ, kein Auskunfts-Wizard, PWA-only) - `_bmad-output/specs/M35-dsgvo-export.md` ## Dev-Nachzug (nach Davids `D-P21`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen - [ ] Plane-Ticket `AK-P21` aktualisiert ## Umsetzungsnotiz ### 2026-07-02 — Teilumsetzung Backend/Fundament Proof: - Prisma/Isolation: `prisma/schema/gdpr.prisma`, `prisma/rls/gdpr-isolation.sql`, Tenant-Snapshot-Registry und generierter Prisma-Client. - Services: `@hivegrid/db/privacy-gdpr.server` fuer Export-Limits, 72h-Expiry, Tenant-Deletion-Grace/Cancel, AVV-Akzeptanz und Subprozessoren; `createWidgetSupportTicket` fuer Widget → Support-Inbox. - UI/Doku: statische `/help`-FAQ, `docs/compliance/dsgvo-auskunft-playbook.md`, GDPR-Doku-Verweis. - Permissions: `privacy.user_export.self`, `privacy.tenant_export`, `privacy.tenant_deletion`, `privacy.avv.read`, `privacy.avv.accept`, `privacy.subprocessors.read` in Seed, DefaultPermissions, Rollenanzeige und i18n. Verifikation: - `pnpm typecheck` gruen - `pnpm lint` gruen - `pnpm exec prisma validate` gruen - `pnpm run verify:tenant-isolation-report` gruen - `pnpm run verify:security-gdpr-docs` gruen - Fokus-Tests: 55/55 gruen (`privacy-gdpr`, `support-tickets`, `Feedback.server`, `roleDisplay`, `permissions-seed`, Tenant-Models, routes/i18n/disabled-plugin-links) - Permission-Matrix-Einzeltests: 22/22 gruen; Wrapper `pnpm run verify:permission-matrix` scheitert auf Windows mit `spawn pnpm ENOENT`. - Breites `pnpm test` timed auf Windows nach 302s ohne sichtbare Assertion-Failures aus; Ausgabe nur bekannte Stderr-Faelle (Session-Cookie-Warnung, Admin-SSO db-down Mock, Notification Redis Mock, i18next-Warnung). DoD-Stand: **4/8 = 50 % done**. Offen: ZIP-Worker/README/manifest/Download, Hard-Delete-Cron inkl. Crypto-Shredding/Billing-Cancel/Storage/Cache/Search, AVV-PDF/Re-Akzeptanz-Read-Only/Subprozessor-Screen, finale mobile Screens aus `D-P21`. ### 2026-07-02 — Nachzug selbst machbarer Worker-/Queue-Aspekte Proof: - Export: `packages/exports/src/zip.ts` erzeugt ZIPs mit README/manifest/data-Dateien; `apps/worker/src/jobs/privacy-gdpr-export.ts` baut GDPR-Export-Artefakte; `apps/worker/src/handlers.ts` routet `gdpr_user_self`/`gdpr_tenant_full` in den GDPR-Statuspfad. - Web-Queue: `apps/web/app/utils/privacy/gdprExportQueue.server.ts`; `/app/:tenant/settings/privacy` legt bei Self-Service-Export jetzt `GdprExportJob` an und enqueue't den Export. - Tenant-Löschung: `apps/worker/src/jobs/privacy-tenant-deletion.ts` definiert und testet die Hard-Delete-Reihenfolge Billing-Cancel → Storage-Prefix → Search-Dokumente → Crypto-Shredding → Tenant-Rows. - Nachzug: `apps/worker/src/jobs/privacy-gdpr-export-bootstrap.ts` bootstrapped den GDPR-Export-Service produktiv mit S3-`PutObjectCommand` und konservativen User-Self/Tenant-Full-Bundle-Loadern (User/Tenant/TenantUser/AuditEvent/NotificationPreference/NotificationDelivery). Verifikation: - `pnpm typecheck` gruen - `pnpm --filter @hivegrid/exports typecheck` gruen - `pnpm --filter @hivegrid/worker typecheck` gruen - `pnpm lint` gruen - `pnpm exec prisma validate` gruen - `pnpm run verify:tenant-isolation-report` gruen - `pnpm run verify:security-gdpr-docs` gruen - Fokus-Tests: 141/141 gruen (AK-P21 DB/Web/Worker/Queue/ZIP/Feedback/Permissions/i18n) - Nachzug-Fokus: 97/97 gruen (`privacy-gdpr`, GDPR-Export-Bootstrap/-Runner, Tenant-Deletion-Runner, Handler, Web-Queue) - Permission-Matrix-Einzeltests: 22/22 gruen; Wrapper bleibt auf Windows mit `spawn pnpm ENOENT` ein bekanntes lokales Skriptproblem. - `git diff --check -- . ':(exclude)packages/db/generated/prisma/client/**'` gruen. DoD-Stand: **4/8 = 50 % done**. Selbst machbarer Backend-/Worker-Nachzug ist erledigt; offen bleiben signed Download/E-Mail, breiteres Fachmodul-Inventar fuer Tenant-Full, produktive Tenant-Deletion-Bootstrap-Anbindung/Read-Only-Hook, AVV-PDF/Re-Akzeptanz-Read-Only/Subprozessor-Screen und finale mobile Screens aus `D-P21`. Repo/Plane: - Branch `ak-p21-gdpr-launch-foundation` gepusht. - Implementierungs-Commit `4a02238a6` (`feat: add AK-P21 GDPR launch foundation`). - Plane-Kommentar `4a56b8c9-6254-4987-bd3d-2b78945b4786` am 2026-07-02 gesetzt; Ticket bleibt bewusst `Blocked / On Hold`, nicht `Done`.