14 KiB
Boilerplate-Abgleich — M35 DSGVO-Export / Account-Löschung
| Feld | Wert |
|---|---|
| Modul-ID | M35 |
| Name | DSGVO-Export / Account-Löschung / Tenant-Daten-Portabilität |
| Milestones | M164 (Daten-Export), M165 (Lösch-Workflow), M166 (AVV/Auskunft) |
| Block | Block 7 — Plattform-Außenseite |
| Reuse-Level | medium |
Zusammenfassung
Die Boilerplate hat ein vollständiges, getestetes USER-Level-DSGVO-Subsystem (Phase 10 Task #68):
Personal-Data-Export-Worker, Lösch-Cascade-Worker, Grace-Period-Cron, Pseudonymisierung, eine
zentrale USER_FK_MAP über alle User-FKs, ein Selbst-Service-Privacy-Hub im Web (Export/Delete/Reactivate
mit Email-Confirm-Token + 30-Tage-Grace), CLI-Commands und ein generisches Streaming-Export-Framework
(packages/exports: CSV/JSON/XLSX/PDF + S3-Multipart-Sink + Row-Caps + Audit-PDF). Das deckt M165
(Account-Löschung) und einen Großteil von M164 (User-Daten-Export) als hochwertige Vorlage ab.
Komplett fehlend ist die gesamte TENANT-Ebene: Tenant-Voll-Export (scope=tenant_full),
Tenant-Lösch-Workflow + Hard-Delete-Cron (Storage/Embeddings/Queues/Webhooks/DB in FK-Reihenfolge),
Tenant-Lifecycle-Status (deletion_pending/deleted/frozen/past_due als Enum), AVV-Vertrag
(PDF-Generator, AvvAcceptance, Re-Akzeptanz-Flow), Subprozessoren-Liste (Subprocessor-Modell +
UI + Widerspruchs-Frist) und ZIP-mit-Binär-Dateien-Bundling (Boilerplate exportiert nur ein
JSON-Bundle, keine .zip mit Original-Files). Die HiveGrid-spezifischen DSGVO-Modelle (GdprExportJob,
TenantDeletionRequest, AvvAcceptance, Subprocessor) existieren nicht.
Übernehmbar aus Boilerplate
| Boilerplate-Pfad | Was | Wie nutzbar |
|---|---|---|
packages/exports/src/index.ts (+ csv/, json/, pdf/, xlsx/, types.ts, limits.ts, sinks/s3-multipart.ts, format-caps.ts, spreadsheet-safety.ts, audit-pdf.ts) |
Streaming-Export-Framework: Format-Serializer (Stream + Buffer), createS3MultipartUploadSink (8 MB Parts, Auto-Abort), Plan-/Format-Row-Caps, Injection-Safety, Compliance-Audit-PDF-Renderer |
1:1 als Fundament für beide Export-Scopes |
apps/worker/src/jobs/dsgvo-export.ts |
User-Personal-Data-Export-Worker: iteriert USER_FK_MAP.includeInExport, streamt JSON-Bundle zu S3, mintet Signed-URL, sendet Ready-Email, schreibt AuditEvent (action=EXPORT_PERSONAL_DATA, scope=gdpr, sensitivity=pii). Host-agnostisch (DI über DsgvoExportDependencies) |
anpassen — Basis für M164 User-Export; ZIP-statt-JSON + README/manifest.json + Binär-Files ergänzen |
apps/worker/src/jobs/dsgvo-deletion.ts |
User-Lösch-Cascade: pro USER_FK_MAP-Eintrag hard-delete/pseudonymize/retain-tombstone, User-Row löschen oder pseudonymisieren, Audit. Idempotent, DI-fähig |
anpassen — deckt M165 Account-Löschung (35.2.4 „PII überschrieben, Audit behält User-ID") direkt ab |
apps/worker/src/jobs/dsgvo-grace-cron.ts |
24h-Cron: scannt User.pendingDeletion && scheduledDeletionAt<=now, dispatcht Lösch-Jobs. Idempotenter upsertJobScheduler |
als-vorlage — Muster 1:1 übertragbar auf Tenant-Hard-Delete-Cron (35.3.4) |
packages/db/src/dsgvo/user-fk-map.ts |
Zentrale Karte ALLER Modelle mit User-FK + Cascade-Strategie + includeInExport. CI-Test (user-fk-map.test.ts) erzwingt Vollständigkeit gegen Schema |
anpassen — Pflicht-Referenz; jedes neue HiveGrid-Modell mit User-FK muss ergänzt werden. Vorlage für eine analoge TENANT_FK_MAP (Tenant-Hard-Delete) |
packages/db/src/dsgvo/pseudonymize.ts |
Deterministische Pseudonymisierungs-Helfer (pseudonymize, buildUserPseudonymizationUpdate) |
1:1 für 35.2.4 Anonymisierungs-Strategie |
apps/web/app/routes/app.$tenant/settings/privacy.tsx + privacy.delete.confirm.$token.tsx + privacy.delete-mail.test.tsx |
Selbst-Service-Privacy-Hub: Export-Anstoß, Lösch-Anforderung mit Confirm-Phrase, Email-Confirm-Link, Reactivate, CSRF, Audit pro Intent. Route liegt bereits unter app.$tenant/settings/privacy |
als-vorlage — entspricht Spec-Route /{tenant}/settings/account/delete + .../data-export; Multi-Step-Flow (35.2.3) + 1.5-Export-Angebot ergänzen. Achtung: verstößt noch gegen HiveGrid-Layer-Trennung (Prisma im Loader, kein VM, Inline-Styles statt i18n-VM) → muss in VM/ui-hivegrid/Adapter umgebaut werden |
apps/web/app/utils/dsgvo/deletionToken.server.ts |
HMAC-signierter Lösch-Confirm-Token (24h, fail-closed, eigene Version gegen Replay) | 1:1 für 35.2.5 24h-Reverse-Window (Magic-Link gegen Auth-Bypass) |
packages/storage/src/signed/index.ts |
S3-Signed-URL-Adapter (PUT/GET, Expiry-Clamp, Key-Validierung, Secret-Redaction) | 1:1 für 7-Tage-Download-Window-Signed-URLs (35.1.5) |
prisma/schema/imports.prisma (ExportJob-Modell, Migration 20260508000000_export_jobs + ..._export_job_hard_delete) |
ExportJob: tenantId, requestedByUserId, exportType, format, status (ExportJobStatus), requestId, artifactBucket/Key, rowCount, expiresAt/deletedAt/hardDeletedAt (Retention), error-Felder, Timestamps. Indizes inkl. (expiresAt) für Cleanup-Cron |
anpassen — sehr nah an Spec-GdprExportJob; es fehlen scope-Enum, target_user_id, progress_percent, download_count, last_downloaded_at, result_size_bytes |
apps/worker/src/jobs/export.ts |
Generischer Export-Job: Plan-Resolution, Row-Cap-Enforcement, Format-Streamer-Registry, Progress-Publish via SharedStore, S3-Multipart. Liest ExportJob-Queue-Payload |
als-vorlage — Progress-Update-Muster (alle N Rows, 35.1.4) + Tenant-Plan-Auflösung direkt übernehmbar |
packages/queue/src/payloads.ts |
Queue-Payloads: CleanupJob.task enthält bereits 'expired-export-artifacts' + 'dsgvo-grace-period-scan'; ExportJob (kind: "export.run"); queueNames.exports |
anpassen — Cleanup-Task für ZIP-Ablauf (7 Tage) bereits vorgesehen; neue Tenant-Lösch-/Export-Tasks ergänzen |
apps/worker/src/jobs/dsgvo-verify.ts + audit-retention.ts |
Verify-/Retention-Muster für DSGVO-Jobs | als-vorlage |
packages/cli/src/commands/dsgvo/{export,delete,verify,reactivate,index}.ts + commands/tenant/anonymize.ts |
Operator-CLI für DSGVO-Aktionen (für Plattform-Admin-initiierte Löschung, 35.3.5) | als-vorlage für M37-Plattform-Admin-Pfad (admin_initiated, suspended_violation) |
apps/web/app/routes/app.$tenant/settings.tsx + settings/account.tsx |
Tenant-Settings-Shell + Account-Settings-Page-Muster | als-vorlage für Privacy-Hub-Routes /{tenant}/admin/privacy/* und /{tenant}/settings/account/* |
packages/db/src/audit-events.server.ts (createAuditEvent) |
Audit-Schreiber mit regulatoryScope/dataSensitivity |
1:1 — entspricht Querschnitt AV #6 (alle Privacy-Aktionen geloggt) |
Vorhandene Daten-Modelle (konkret)
| Modell | Pfad | Deckt M35-Bedarf |
|---|---|---|
ExportJob (+ Enum ExportJobStatus) |
prisma/schema/imports.prisma |
~70 % von GdprExportJob: Retention (expiresAt/deletedAt/hardDeletedAt), requestId, artifactBucket/Key, rowCount, Status, Indizes. Fehlt: scope-Enum (user_self/tenant_full), target_user_id, progress_percent, download_count, last_downloaded_at, result_size_bytes, FK auf File |
User (DSGVO-Felder) |
prisma/schema/accounts.prisma (Z. 33-38, 95) |
pendingDeletion, scheduledDeletionAt, deletionRequestedAt, pseudonymized, pseudonymizedAt, deletionRequestId (unique) + Index user_pending_deletion_due_idx. Deckt 35.2 Account-Löschung-State vollständig |
Tenant |
prisma/schema/accounts.prisma (Z. 129-200) |
Nur active: Boolean + deactivatedReason: String?. KEIN Lifecycle-Status-Enum (frozen/past_due/deletion_pending/deleted). Kein Grace-Period-Feld |
ImportJob (+ Enum) |
prisma/schema/imports.prisma |
Nur Import-Seite — als Form-Vorlage für GdprExportJob-Felder nutzbar |
AuditEvent |
prisma/schema/core.prisma (logisch, via user-fk-map) |
actorId/regulatoryScope/dataSensitivity — Plattform-Audit-Metadata nach Hard-Delete (35.3.4) bereits vorgesehen |
Nicht vorhanden (komplett neu): GdprExportJob (HiveGrid-spezifisch mit scope), TenantDeletionRequest,
AvvAcceptance, Subprocessor.
Lücken / komplett neu zu bauen
Daten-Layer (neu)
TenantDeletionRequest-Modell — reason-Enum (voluntary/non_payment/suspended_violation/admin_initiated),grace_period_ends_at, status, cancel-Felder, Unique-Constraint „max 1 aktive". Cron-Index(grace_period_ends_at, status).AvvAcceptance-Modell — version, IP/User-Agent, Signer-Name/Rolle,pdf_file_id, Unique(tenant_id, avv_version).Subprocessor-Modell — plattform-global (kein RLS), name/purpose/country/is_eu_eea/data_categories[]/dpa_url/active_since/archived_at.- Tenant-Lifecycle-Status — Enum (
active|frozen|past_due|deletion_pending|deleted) +grace_period_ends_ataufTenant(oder viaTenantDeletionRequest). Aktuell nur Booleanactive. GdprExportJob-Erweiterung —scope-Enum,target_user_id,progress_percent,download_count,last_downloaded_at,result_size_bytes, FK aufFile(Modul 23).
Domänen-Logik / Worker (neu)
- Tenant-Voll-Export-Worker (
scope=tenant_full) — aggregiert ALLE tenant-scoped Entitäten je JSONL-File (CRM/Deals/Projects/HR/… laut Spec Block D) + Original-Files. Es gibt KEINETENANT_FK_MAP-Analogie zurUSER_FK_MAP. - ZIP-mit-Binär-Bundling — Boilerplate streamt nur ein flaches JSON-Bundle. Es gibt keine
archiver/yazl/jszip-Nutzung. Spec verlangt ZIP mit README.md, manifest.json, Unterordnern, JSONL + Original-Binär-Files +schema/+ Multi-Part-ZIP. - Tenant-Hard-Delete-Cron + Cascade — FK-konforme Reihenfolge inkl. Storage rekursiv, Embeddings (pgvector), Worker-Queues purgen, Webhook-Subscriptions, Redis-Cache (
tenant:{id}:*). User-Cascade existiert, Tenant-Cascade nicht. - AVV-PDF-Generator — dynamisches PDF mit Tenant-Stamm + Subprozessor-Snapshot.
@react-pdf/rendererist verfügbar (für Audit-PDF), aber kein AVV-Template. - AVV-Re-Akzeptanz-Cron (14-Tage → Read-Only) + Subprozessor-Widerspruchs-Frist-Cron (14-Tage).
- Rate-Limit-Logik — max 3 user_self/24h, max 1 tenant_full aktiv (Spec-Constraint; nicht in Boilerplate).
- Resume/Checkpoint-Mode für großen Tenant-Export (Block D Edge-Case) — nicht vorhanden.
UI (neu / Umbau)
- Privacy-Hub Tenant-Admin (
/{tenant}/admin/privacy/*: export, deletion, subprocessors, avv) — existiert nicht. - Multi-Step-Tenant-Kündigung (5 Steps mit Slug-Confirm-Phrase, Stripe-Hinweis) — nur einfacher User-Delete vorhanden.
- Subprozessoren-Tabelle (Filter EU/alle, Suche, CSV/PDF-Export, Drittland-Klartext-Warnung) — neu.
- AVV-Download + Akzeptanz-History + Re-Akzeptanz-Modal — neu.
- Bestehende
privacy.tsxmuss auf HiveGrid-Layer-Trennung umgebaut werden (VM-Builder,packages/ui-hivegrid, Subframe-Adapter, i18n-Keys statt Inline-Strings/Tailwind) — siehe AGENTS.md Anti-Patterns.
Querschnitt-Wiring (neu)
- Permissions
privacy.user_export.self,privacy.tenant_export,privacy.tenant_deletion,privacy.subprocessors.read,privacy.avv.read,privacy.avv.accept— nicht impermissions-seed.server.ts(nur „account deletion"-Bezug im Admin-Role-Kommentar). Neu inpackages/entitlements. - Sidebar-Eintrag „DSGVO / Datenschutz" Gruppe EINSTELLUNGEN (INTEGRATION-CONTRACTS §1 → M164-M166) in
packages/ui-hivegrid/src/app-shell/sidebar.config.ts— neu (HiveGrid-Sidebar-Config existiert in Boilerplate nicht, nur ToolCTRL-application/sidebar). - Notifications via M011
notify()— Boilerplate-Worker rufensendEmailMailerSend/sendExportReadyEmaildirekt; muss auf HiveGrid-notify()-Service umgestellt werden. - Mail-Templates für Export-Ready / Lösch-Bestätigung / AVV-Re-Akzeptanz / Subprozessor-Notification — keine dedizierten DSGVO-Templates in
packages/email-templatesgefunden. - Privacy-Manifest (Apple) — Block I; gehört zu Modul 36, Inhalt-Quelle hier. Keinerlei Boilerplate-Asset.
Empfohlenes Vorgehen
Phase 1 — Fundament aus BP übernehmen (1:1 / leichte Anpassung):
packages/exportsals Export-Framework übernehmen (Streamer + S3-Multipart-Sink + Row-Caps + Audit-PDF). Basis für beide Scopes.packages/storage/src/signed(Signed-URL) +utils/dsgvo/deletionToken.server.ts(Confirm-Token) +packages/db/src/dsgvo/pseudonymize.ts1:1 übernehmen.ExportJob-Modell ausimports.prismazu HiveGrid-GdprExportJoberweitern (scope,target_user_id,progress_percent,download_count,result_size_bytes,File-FK). Forward-Only-Migration.
Phase 2 — M165 Account-Löschung (höchste BP-Deckung):
4. dsgvo-deletion.ts + dsgvo-grace-cron.ts + user-fk-map.ts als Cascade-Basis nutzen; USER_FK_MAP um alle neuen HiveGrid-Modelle ergänzen (CI-Test erzwingt das).
5. privacy.tsx-Route auf HiveGrid-Layer-Trennung umbauen (VM + ui-hivegrid + Subframe-Adapter + i18n) und Multi-Step + Step-1.5-Export-Angebot ergänzen.
Phase 3 — M164 User-Export, dann Tenant-Export (neu auf BP-Fundament):
6. dsgvo-export.ts zu ZIP-Bundle ausbauen: ZIP-Lib (archiver/yazl) einführen, README.md/manifest.json + Unterordner-Struktur (Spec Block C) + Original-Binär-Files aus Storage. Progress-Muster aus export.ts.
7. Tenant-Voll-Export NEU bauen: TENANT_FK_MAP-Analogie + JSONL-pro-Entität + Files + Multi-Part-ZIP + Resume-Checkpoint.
Phase 4 — M165 Tenant-Lösch-Workflow (neu):
8. TenantDeletionRequest-Modell + Tenant-Lifecycle-Status-Enum + Multi-Step-Kündigung (Slug-Confirm-Phrase, Stripe-Hinweis aus M153) + 30-Tage-Grace-Banner + Cancel.
9. Tenant-Hard-Delete-Cron (Cron-Muster aus dsgvo-grace-cron.ts): Storage rekursiv → Embeddings → Queues → Webhooks → DB (FK-Reihenfolge) → Redis-Cache → Plattform-Audit-Metadata.
Phase 5 — M166 AVV + Subprozessoren (komplett neu):
10. AvvAcceptance + Subprocessor-Modelle, AVV-PDF-Generator (@react-pdf/renderer ist da), Signup-Checkbox-Hook (M157), Re-Akzeptanz-Cron, Subprozessoren-Tabelle-UI + Widerspruchs-Frist-Cron + Notification-Templates.
Querschnitt durchgängig: Permissions in entitlements definieren, Sidebar-Eintrag (Gruppe EINSTELLUNGEN), notify() statt Direkt-Email, Mail-Templates, alle Aktionen auditieren (BP-createAuditEvent ist da).