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 inAdminSupportTicket(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 fuergdpr_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(übertenant.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 inAdminSupportTicket(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_datan/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-P21aktualisiert
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.serverfuer Export-Limits, 72h-Expiry, Tenant-Deletion-Grace/Cancel, AVV-Akzeptanz und Subprozessoren;createWidgetSupportTicketfuer 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.readin Seed, DefaultPermissions, Rollenanzeige und i18n.
Verifikation:
pnpm typecheckgruenpnpm lintgruenpnpm exec prisma validategruenpnpm run verify:tenant-isolation-reportgruenpnpm run verify:security-gdpr-docsgruen- 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-matrixscheitert auf Windows mitspawn pnpm ENOENT. - Breites
pnpm testtimed 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.tserzeugt ZIPs mit README/manifest/data-Dateien;apps/worker/src/jobs/privacy-gdpr-export.tsbaut GDPR-Export-Artefakte;apps/worker/src/handlers.tsroutetgdpr_user_self/gdpr_tenant_fullin den GDPR-Statuspfad. - Web-Queue:
apps/web/app/utils/privacy/gdprExportQueue.server.ts;/app/:tenant/settings/privacylegt bei Self-Service-Export jetztGdprExportJoban und enqueue't den Export. - Tenant-Löschung:
apps/worker/src/jobs/privacy-tenant-deletion.tsdefiniert 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.tsbootstrapped den GDPR-Export-Service produktiv mit S3-PutObjectCommandund konservativen User-Self/Tenant-Full-Bundle-Loadern (User/Tenant/TenantUser/AuditEvent/NotificationPreference/NotificationDelivery).
Verifikation:
pnpm typecheckgruenpnpm --filter @hivegrid/exports typecheckgruenpnpm --filter @hivegrid/worker typecheckgruenpnpm lintgruenpnpm exec prisma validategruenpnpm run verify:tenant-isolation-reportgruenpnpm run verify:security-gdpr-docsgruen- 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 ENOENTein 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-foundationgepusht. - Implementierungs-Commit
4a02238a6(feat: add AK-P21 GDPR launch foundation). - Plane-Kommentar
4a56b8c9-6254-4987-bd3d-2b78945b4786am 2026-07-02 gesetzt; Ticket bleibt bewusstBlocked / On Hold, nichtDone.