Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/designer-briefs/P21-dsgvo-launch.md
T

6.7 KiB

Designer-Brief · P21 — DSGVO & Launch-Reife

Phase: 21/21 · Modul: M35 (+ M27 D.3 User-Lösch-Verweis) · Owner-Dev: Akeshan (AK-P21) · Designer: David Quellen: ROADMAP.md §Phase 21 · ENTITY-MODEL.md Domäne 13 (Onboarding/Branding/DSGVO) · SCREEN-MAP.md §6 (DSGVO-Compose) · _bmad-output/specs/M35-dsgvo-export.md Subframe: Pflicht je Route. Archetypen aus D0 (A2 Liste, A5 Modal/Wizard, A6 Settings, A7 Zustände).

🟡 Letzte v1-Phase — macht den Big-Bang-Launch (AD-19) auslösbar. Schnitte (verbindlich):

  • DSGVO-Auskunft = manuelles Playbook v1: Suche → Kontakt-Detail (Activity-Stream) → CSV-Export → Anwalts-Vorlage → Frist-Task (+25 Tage). Es wird KEIN automatisches Auskunfts-/Voll-Export-Tooling pro betroffener Person gebaut (das ist v2, M34/M36/M38/M39). Bitte keinen Auskunfts-Wizard designen — das Playbook nutzt bestehende Screens (Cmd+K, Kontakt-Detail, CSV).
  • v1 baut: DSGVO-ZIP-Export (User-Self + Tenant-Full, 72h-signed-URL), Tenant-Lösch-Workflow (Crypto-Shredding, 30-Tage-Grace, Slug-Confirm-Phrase), Feedback-Widget (speist Admin-Support-Inbox P19), Minimal-FAQ-Seite. AVV/Subprozessoren-Anzeige im Privacy-Hub.
  • PWA-Hinweis: Monteure arbeiten mobil über die PWA/responsive Web-App (mobile-first Screens + P9-Offline). Der PWA-Ausbau (Installierbarkeit/Web-Push, M27) folgt v2; kein nativer Client (AD-17, PWA-only). Für P21 heißt das: alle hier neuen Screens auch mobil tauglich, kein App-Store-/Native-Screen.

Was dieses Modul tut (Kurzfassung)

Deckt den DSGVO-Lebenszyklus ab und macht die Plattform launch-fertig: tenant- und user-weiter DSGVO-ZIP-Export (asynchron, signierte Download-URL), Tenant-Lösch-Workflow mit Crypto-Shredding und Grace-Period, AVV-/Subprozessoren-Sichtbarkeit, ein In-App-Feedback-Widget, das die Admin-Support-Inbox speist, und eine Minimal-FAQ-Seite.

Benötigte Screens

Screen [Route] Kern-Inhalt Archetyp
Privacy-Hub [/admin/privacy] Übersicht: Export, Löschung, Subprozessoren, AVV, Privacy-Manifest-Link · Einstieg in die Sub-Bereiche A6 + KPI
Tenant-Daten-Export [/admin/privacy/export, /new, /:jobId] Job-Liste mit Status/Progress/Download (72h-Link) · Anstoßen mit Klartext (was, geschätzte Größe/Dauer, 7-Tage-Window) · Job-Status mit Progress A2 + A5
Tenant-Löschung [/admin/privacy/deletion, /:requestId] Multi-Step: Erklärung (30-Tage-Grace, Read-Only, Hard-Delete) → Export-Angebot → Stripe-Hinweis (Pro-rata) → Passwort + 2FA → Slug als Confirm-Phrase · Grace-Countdown mit Abbruch-Button A5 (Wizard)
Subprozessoren [/admin/privacy/subprocessors] Tabelle: Name, Land, EU/EEA-Marker, Zweck, Datenkategorien, DPA-Link, „aktiv seit" · Filter (EU/alle, Kategorie) · Export CSV/PDF A2
AVV [/admin/privacy/avv] Aktuelle Version als PDF-Download + Akzeptanz-History (Version, Datum, Signer) · Re-Akzeptanz-Modal bei Update (Klartext-Änderungen) A2 + A5
User-Daten-Export [/settings/account/data-export, /:jobId] Klartext was exportiert wird, Start-Button, Rate-Limit-Hinweis, Job-Status mit Download (signed-URL) A6
Account-Löschung [/settings/account/delete] Multi-Step: Erklärung → optional Daten-Export-Angebot → Passwort + 2FA → Countdown-Bestätigung (24h-Reverse-Window) · (Detail-Logik M27 D.3) A5 (Wizard)
Feedback-Widget [global, klein] Schwebender Button → Mini-Form (Kategorie Bug/Feature/Frage, Text, Screenshot-Häkchen, Rate-Limit) → landet in Admin-Support-Inbox (P19) · Erfolgs-/Fehler-Zustand A5-klein
Minimal-FAQ [/help o.ä.] Statische FAQ-Seite mit gruppierten Fragen/Antworten (Markdown), Suchfeld optional · kein Help-Center-Ausbau (→ v2) A6 / statisch

(Kein DSGVO-Auskunfts-Wizard v1 — Playbook nutzt Cmd+K-Suche + Kontakt-Detail-Activity-Stream + CSV-Export + Task aus P6/P4/P11. Admin-Support-Inbox + Subprozessor-/AVV-Verwaltung → P19. Privacy-Manifest-Inhalt = Marketing-Site.)

Geplante Features (muss abgedeckt sein)

  • Nutzer kann DSGVO-ZIP-Export anstoßen (User-Self und Tenant-Full); asynchroner BullMQ-Job mit Progress, 72h-signed-URL-Download, Rate-Limit (max. 3 User-Self/24h, max. 1 Tenant-Full aktiv); README + manifest.json im ZIP
  • Tenant-Löschung führt Crypto-Shredding (Per-Tenant-DEK), Stripe-Cancel und Storage/Cache/Index-Bereinigung durch (AD-8); 30-Tage-Grace mit Read-Only + Abbruch-Möglichkeit; Slug als Confirm-Phrase; Stripe-Cancel erst beim Hard-Delete-Cron
  • DSGVO-Auskunft als dokumentiertes manuelles Playbook (Suche → Kontakt-Detail → CSV → Anwalts-Vorlage → Frist-Task +25 Tage); AVV-Vorlage liegt vor (Externals E6) — kein automatisches Tooling v1
  • AVV-Download + Akzeptanz-History + Re-Akzeptanz-Flow bei Updates (14-Tage-Frist, Read-Only-Sperre danach); Subprozessoren-Liste mit Drittland-Klartext-Warnung (v1 EU-only)
  • In-App-Feedback-Widget (Bug/Feature/Frage, Screenshot, Rate-Limit) live → speist Admin-Support-Inbox (P19, generische Quelle)
  • Minimal-FAQ-Seite existiert (statisch, kein Help-Center-Ausbau)
  • Monteure arbeiten mobil über die PWA/responsive Web-App (mobile-first + P9-Offline) — alle neuen Screens mobil tauglich; PWA-Installierbarkeit/Web-Push → v2; kein nativer Client (AD-17)
  • Permissions: privacy.user_export.self (implizit jeder User), privacy.tenant_export / privacy.tenant_deletion / privacy.avv.* / privacy.subprocessors.read (über tenant.admin)

Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)

Export-Job-Liste mit Progress-Balken + Status-Badge + Download-Button (signed-URL, Ablauf-Hinweis), Export-Anstoß-Dialog mit Klartext-Größen-/Dauer-Schätzung, Multi-Step-Lösch-Wizard mit Progress, Slug-Confirm-Phrase-Eingabe (Tippen statt Knopf), Grace-Countdown-Banner mit Abbruch-Button, Passwort-+2FA-Bestätigungsschritt, Subprozessor-Tabelle mit EU/Drittland-Marker + DPA-Link + CSV/PDF-Export, AVV-PDF-Download + Akzeptanz-History-Liste + Re-Akzeptanz-Modal mit Änderungs-Klartext, Drittland-Warn-Badge, schwebender Feedback-Button + Mini-Form (Kategorie-Select, Textarea, Screenshot-Häkchen) mit Rate-Limit-Hinweis, FAQ-Akkordeon (gruppierte Fragen/Antworten, Markdown) + optionales Suchfeld, Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext mit Lösungs-Knopf), mobile-first-Varianten aller Screens.

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev:

Dev-Nachzug (wir nach Davids Delta)

  • Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
  • REQUIREMENTS/PHASE-SOURCES nachgezogen:
  • Plane-Ticket (AK-P21) aktualisiert: