Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/AK-P21.md
T
2026-07-08 16:15:37 +02:00

12 KiB

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.
  • 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 — blockiert: finale Screen-Integration wartet auf D-P21; statische FAQ ist responsive.
  • 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.