Files
HiveGrid-Wireframes/hivegrid-cloud/docs/boilerplate-mapping/M35-dsgvo-export.md
T

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_at auf Tenant (oder via TenantDeletionRequest). Aktuell nur Boolean active.
  • GdprExportJob-Erweiterung — scope-Enum, target_user_id, progress_percent, download_count, last_downloaded_at, result_size_bytes, FK auf File (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 KEINE TENANT_FK_MAP-Analogie zur USER_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/renderer ist 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.tsx muss 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 im permissions-seed.server.ts (nur „account deletion"-Bezug im Admin-Role-Kommentar). Neu in packages/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 rufen sendEmailMailerSend/sendExportReadyEmail direkt; 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-templates gefunden.
  • 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):

  1. packages/exports als Export-Framework übernehmen (Streamer + S3-Multipart-Sink + Row-Caps + Audit-PDF). Basis für beide Scopes.
  2. packages/storage/src/signed (Signed-URL) + utils/dsgvo/deletionToken.server.ts (Confirm-Token) + packages/db/src/dsgvo/pseudonymize.ts 1:1 übernehmen.
  3. ExportJob-Modell aus imports.prisma zu HiveGrid-GdprExportJob erweitern (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).