Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-P21.md
T

6.2 KiB

AK-P21 · P21 DSGVO (Export + Lösch-Workflow) + Feedback-Widget

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 geplant

Abhängigkeiten & Parallelität

  • Blocked by: AK-P20 (Billing — Tenant-Löschung ruft Stripe-Cancel; Feedback-Widget speist Admin-Support-Inbox aus AK-P19)
  • 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, Stripe-Cancel, 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 → Stripe-Hinweis (Pro-rata) → 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
  • Tenant-Löschung: Crypto-Shredding (per-Tenant-DEK) + Stripe-Cancel + Storage/Cache/Index-Bereinigung (AD-8); 30-Tage-Grace Read-Only + Abbruch; Slug als Confirm-Phrase; Stripe-Cancel erst beim Hard-Delete-Cron
  • AVV-Download + Akzeptanz-History + Re-Akzeptanz (14-Tage-Frist, danach Read-Only-Sperre); Subprozessoren-Liste mit Drittland-Klartext (v1 EU-only)
  • DSGVO-Auskunft als dokumentiertes Playbook (Suche → Kontakt-Detail → CSV → Anwalts-Vorlage → Frist-Task +25 Tage) — kein automatisches Tooling
  • In-App-Feedback-Widget → speist Admin-Support-Inbox (AK-P19, generische Quelle)
  • Minimal-FAQ-Seite (statisch)
  • Alle Screens mobil tauglich (PWA/responsive, AD-17); kein nativer Client; PWA-Installierbarkeit/Web-Push → v2
  • 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; Stripe-Cancel + Storage/Cache/Index-Cleanup beim Hard-Delete-Cron; 30-Tage-Grace Read-Only-Middleware (Reuse aus AK-P20 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