# 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).