28 KiB
DSGVO-Bulk-Ops (Self-Service Export, Löschung, Pseudonymisierung)
Status: completed (React-Email templates + encrypted PseudonymizationMap + Playwright deferred) Task-ID: #68 Phase: 10 Estimated Effort: 2-3 Wochen Owner: unassigned
Problem
Die Boilerplate dokumentiert in docs/compliance/gdpr.md und docs/data-retention.md zwar die DSGVO-Pflichten, aber implementiert sie nicht als bedienbares Self-Service-Workflow. Konkret fehlt:
- Art. 15 (Auskunftsrecht) + Art. 20 (Datenübertragbarkeit): Kein User-UI für „Meine Daten exportieren". Heute müsste Support manuell SQL-Queries fahren — fehleranfällig, unvollständig (jede neue Tabelle muss in der Query nachgezogen werden), nicht audit-trail-fähig
- Art. 17 (Recht auf Löschung): Kein User-UI für „Account löschen". Kein Cascade-Mapping über alle tenant-scoped Models. Kein Verifier-Pass der bestätigt dass alle PII tatsächlich gelöscht wurden
- Pseudonymisierungs-Option (für Cases wo Vollständige Löschung Compliance-Risiken hat, z.B. Audit-Trail-Einträge): kein deterministischer Pseudonymisierungs-Layer
- 30-Tage-Grace-Period: Industrie-Standard für „Soft-Delete mit Reactivation"; heute gibt es nur Hard-Delete oder gar nichts
- Admin-UI: kein Tenant-Admin-Workflow um für einen User die Operation auszuführen (z.B. wenn User per Email/Support kontaktiert)
- Verification-Pass nach Löschung: keine automatisierte Prüfung dass jede Tabelle die User-References hatte, jetzt clean ist — Audit-Findings „Tabelle X hatte noch User-X-Daten 30 Tage nach Löschung" sind realistisch
Betroffene Codestellen:
packages/db/prisma/schema.prisma— alle Models mituserId/createdByUserId/actorId-Referenzen (User, UserRole, TenantUser, AuditEvent, Row jsonb-data, CRM-Contacts, Notifications, OutboundEmail, ChatMessage, FormSubmission, EventWebhookAttempt, ImpersonationAudit)apps/web/app/routes/app.$tenant/settings/*— neuer Privacy-Sub-Bereichapps/web/app/utils/data/.server/userData.ts— User-Loader muss umpendingDeletion/scheduledDeletionAt/pseudonymizederweitert werdenapps/worker/src/jobs/*— Neue Worker-Jobs für Export, Deletion-Cascade, Pseudonymization, Verification
Depends on
10-compliance-polish/compliance-audit-export.md— DSGVO-Bulk-Ops müssen alle Operationen in AuditEvent loggen; neue Felder (regulatoryScope=gdpr, action=EXPORT_PERSONAL_DATA, dataSensitivity=pii) sind dort etabliert03-scaling-infrastructure/worker-queues.md— Lange-Laufende-Jobs (Export, Cascade, Verification) brauchen dedizierte Worker-Queue03-scaling-infrastructure/streaming-exports.md— Personal-Data-Export streamt aus DB (Multi-MB-JSON-Bundles möglich)
Blocks
- Keine direkten weiteren Tasks; ist letzte Compliance-Komponente vor Polish-Tasks
Approach
Acht koordinierte Sub-Komponenten:
(a) User-Self-Service-UI
Route: /app/$tenant/settings/privacy/
UI-Sections:
- „Meine Daten exportieren" (Art. 15 + 20):
- Button → triggert Job → Signed-URL per Email
- Frequenz-Limit: 1 Export pro 7 Tage (verhindert Abuse + DB-Load)
- „Account löschen" (Art. 17):
- Bestätigungs-Modal mit Confirmation-Text-Input („Bitte tippen: LÖSCHEN")
- Email-Verifikation: Lösch-Request triggert Bestätigungs-Email mit signed-token; User muss in Email auf Link klicken um 30-Tage-Grace zu starten (verhindert Account-Hijack-Lösch-Attacken)
- Während Grace-Period: Login deaktiviert (User sieht „Account markiert zur Löschung — Reactivate?"-Screen)
- Reactivation-Button → setzt
pendingDeletion=false,scheduledDeletionAt=null
- „Daten-Übersicht" (informativ):
- Tabelle: welche Datentypen werden gespeichert, welche Retention, in welchen Tabellen
- Link zu
docs/compliance/gdpr.md(Self-Service-FAQ)
(b) Admin-UI
Route: /app/$tenant/settings/members/$id/privacy
Gleiche Aktionen wie Self-Service, plus:
- Pseudonymisierung-Option (User bleibt in DB als anonymized, Audit-Trail-Einträge bleiben erhalten aber pseudonym)
- Admin-Aktionen müssen mit Reason-Text begründet werden (gespeichert in AuditEvent.metadata)
- Email-Verifikation entfällt für Admin-initiierte Aktionen (Admin hat bereits Authority), aber AuditEvent mit
actorType=admin+actorId=<admin-id>+ Reason
(c) Datasubject-Export-Worker
Worker: apps/worker/src/jobs/dsgvo-export.ts
Aggregiert alle personenbezogenen Daten quer durch Tabellen:
User(Profile)UserRole(User-Roles in allen Tenants)TenantUser(Tenant-Membership)AuditEvent(filter:actorId = userId)Row(jsonb-data wenndata.userId === userId— defensive Search via JSONB-Operator)CrmContact(wenn User Inhaber eines CRM-Contacts mit Email)Notification(User-Notifications)OutboundEmail(recipient = User-Email)ChatMessage(User-Conversations)FormSubmission(User-Submissions)EventWebhookAttempt(recipient-fields wenn User-Email)ImpersonationAudit(targetUserId = userId)
Output:
- JSON-Bundle:
personal-data-export.jsonmit Sektion pro Datentyp - Storage-Files-ZIP: alle User-Owned Files aus
packages/storage(Avatar, Uploads etc.) - Beide gepackt in ein ZIP, hochgeladen zu S3
- Signed-URL (7-Tage-Validity) per Email an User (React-Email
PersonalDataExportReadyEmail.tsx)
Wird selbst auditiert: action=EXPORT_PERSONAL_DATA, regulatoryScope=[gdpr], dataSensitivity=pii.
(d) Pseudonymisierungs-Layer
packages/db/src/dsgvo/pseudonymize.ts:
async function pseudonymizeUser(userId: string, options?: { reason?: string; adminId?: string }) {
// Pro Tabelle: explizite Strategie
await prisma.user.update({
where: { id: userId },
data: {
name: `Anonymized User #${nextAnonId++}`,
email: null, // oder hash für Audit-Joins
phone: null,
avatarUrl: null,
pseudonymized: true,
pseudonymizedAt: new Date(),
},
});
await prisma.auditEvent.updateMany({
where: { actorId: userId },
data: {
actorEmail: null,
actorIp: anonymizeIp(actorIp), // /24-Subnetz
actorUserAgent: null,
},
});
// ...weiter pro Tabelle
}
Pseudonymisierung-Map separat verschlüsselt:
PseudonymizationMap(eigenes Model):userId -> originalEmail/originalName/originalPhone- Verschlüsselt mit
PSEUDONYMIZATION_KEY(platform-admin only, nie pro Tenant) - Zugriff nur via CLI-Command (
pnpm dsgvo:reveal --user <pseudonym-id>) mit Audit-Log - Reasonable Use: für Re-Identification bei Court-Order oder Legitimate-Interest-Anfrage
(e) Löschung-Cascade
packages/db/src/dsgvo/cascade.ts:
Explicit-Mapping pro Model — kein blindes ON DELETE CASCADE, weil manche Daten erhalten bleiben müssen (z.B. AuditEvents werden pseudonymisiert nicht gelöscht).
const DELETION_CASCADE_PLAN: Record<string, "delete" | "pseudonymize" | "transfer-to-tenant"> = {
User: "delete",
UserRole: "delete",
TenantUser: "delete",
AuditEvent: "pseudonymize", // bleibt für Compliance
Row: "delete", // wenn user-owned
CrmContact: "transfer-to-tenant", // gehört Tenant, nicht User
Notification: "delete",
OutboundEmail: "pseudonymize", // recipient-Field → hash
ChatMessage: "delete",
FormSubmission: "pseudonymize", // form-submission gehört Form-Owner-Tenant
EventWebhookAttempt: "pseudonymize",
ImpersonationAudit: "pseudonymize",
};
Cascade läuft als Worker-Job (apps/worker/src/jobs/dsgvo-deletion.ts) sequentiell pro Model in einer DB-Transaction (oder mehreren wenn zu groß), mit Sentry-Tracing pro Schritt.
(f) Verification-Pass
apps/worker/src/jobs/dsgvo-verify.ts läuft 1h nach Cascade:
Iteriert durch ALLE Models mit User-Reference (Schema-Reflection via Prisma-DMMF). Pro Model:
- Query:
findFirstmit User-Reference-Filter - Wenn Result: Verification-Failure — Event mit Sentry-Alert, Operator wird benachrichtigt
- Wenn keine Result: OK
Verification-Report:
- Gespeichert als
DsgvoVerificationReport-Model mituserId,cascadeJobId,verifiedAt,tablesChecked,failures: [] - Report-Hash wird im AuditEvent geloggt (Compliance-Evidence)
(g) 30-Tage-Grace-Period
User-Schema-Erweiterung:
pendingDeletion: Boolean @default(false)scheduledDeletionAt: DateTime?deletionRequestedAt: DateTime?pseudonymized: Boolean @default(false)pseudonymizedAt: DateTime?
Login-Path:
- Wenn
pendingDeletion = true: Login-Flow rendert „Account markiert zur Löschung — Reactivate?"-Screen statt App - Reactivation: setzt Felder zurück, schreibt AuditEvent
Cron (apps/worker/src/jobs/dsgvo-grace-cron.ts, läuft täglich):
SELECT id FROM user WHERE scheduledDeletionAt < NOW() AND pendingDeletion = true- Pro User: triggert
dsgvo-deletion-Job - Email-Bestätigung an User: „Dein Account wurde gelöscht" (React-Email
AccountDeletedConfirmationEmail.tsx)
(h) Audit-Trail-Pflicht
Jede Bulk-Op-Aktion wird in AuditEvent geloggt:
action: EXPORT_PERSONAL_DATA, DELETE, UPDATE (für Pseudonymization), AUTH (für Reactivation)regulatoryScope: [gdpr]dataSensitivity: piiactorType: user (Self-Service) oder admin (Admin-initiated)metadata: { reason?, requestId, cascadeReport? }
Konsistent über alle Sub-Operationen.
Warum nicht Alternativen:
- ❌ Hard-Delete-ON-CASCADE für AuditEvents: Verletzt SOC2-CC6.1 (Audit-Trail-Integrität); deshalb Pseudonymisierung statt Delete für Compliance-Daten
- ❌ Kein Grace-Period: Industrie-Standard ist 30 Tage; User können Lösch-Request widerrufen, schützt vor versehentlichem/böswilligem Lösch-Trigger
- ❌ Synchron im Request-Pfad: Cascade kann 1000s von Rows touchen, MUSS async via Worker laufen
- ❌ JSON-Bundle ohne Files-ZIP: User haben auch hochgeladene Files (Avatare, Anhänge) — DSGVO Art. 20 umfasst alle gespeicherten personenbezogenen Daten
Implementation Steps
-
Prisma-Schema-Erweiterung (User-Flags + PseudonymizationMap + DsgvoVerificationReport)
- Files:
packages/db/prisma/schema.prisma, Migration - User:
pendingDeletion,scheduledDeletionAt,deletionRequestedAt,pseudonymized,pseudonymizedAt - Neue Models:
PseudonymizationMap(encrypted),DsgvoVerificationReport - Commit:
10-compliance-polish/dsgvo: extend schema for soft-delete and pseudonymization
- Files:
-
Pseudonymization-Layer
- Files:
packages/db/src/dsgvo/pseudonymize.ts,.test.ts,packages/db/src/dsgvo/encryption.ts,.test.ts - Pseudonymisierungs-Strategien pro Model, IP-Anonymisierung (/24), Encryption-Layer für PseudonymizationMap
- Tests: jede Strategy isoliert, Re-Identification via CLI-Command
- Commit:
10-compliance-polish/dsgvo: add pseudonymization layer with encrypted map
- Files:
-
Deletion-Cascade-Helper
- Files:
packages/db/src/dsgvo/cascade.ts,.test.ts - Cascade-Plan-Map, Iteration pro Model, Sentry-Tracing
- Tests: Cascade auf Test-User mit Daten in jeder Tabelle → Verifier-Pass grün
- Commit:
10-compliance-polish/dsgvo: add deletion cascade helper
- Files:
-
Verification-Pass-Worker
- Files:
apps/worker/src/jobs/dsgvo-verify.ts,.test.ts - Schema-Reflection via Prisma-DMMF, Per-Model-Verifier-Query, Report-Generation
- Commit:
10-compliance-polish/dsgvo: add deletion verification worker
- Files:
-
Datasubject-Export-Worker
- Files:
apps/worker/src/jobs/dsgvo-export.ts,.test.ts - Aggregiert über alle Tabellen, ZIP-Pack, S3-Upload, Signed-URL
- Commit:
10-compliance-polish/dsgvo: add personal data export worker
- Files:
-
User-Self-Service-UI
- Files:
apps/web/app/routes/app.$tenant/settings/privacy/_layout.tsx,/index.tsx,/export.tsx,/delete.tsx,/reactivate.tsx - Buttons, Confirmation-Modals, Email-Verifikation-Tokens
- Commit:
10-compliance-polish/dsgvo: add user self-service privacy ui
- Files:
-
Admin-UI
- Files:
apps/web/app/routes/app.$tenant/settings/members/$id/privacy.tsx - Export, Delete, Pseudonymize-Buttons mit Reason-Text-Input
- Commit:
10-compliance-polish/dsgvo: add admin privacy ops ui
- Files:
-
Login-Path-Erweiterung für pendingDeletion-User
- Files:
apps/web/app/utils/session.server.ts,apps/web/app/routes/auth/* - Wenn
pendingDeletion=true: Login dispatcht auf Reactivation-Screen - Commit:
10-compliance-polish/dsgvo: handle pending-deletion users at login
- Files:
-
Grace-Period-Cron
- Files:
apps/worker/src/jobs/dsgvo-grace-cron.ts,.test.ts - Daily-Cron, triggert Cascade für reife Lösch-Requests
- Commit:
10-compliance-polish/dsgvo: add grace period checker cron
- Files:
-
React-Email-Templates
- Files:
packages/mail/src/templates-react/transactional/PersonalDataExportReadyEmail.tsx,AccountDeletionConfirmationEmail.tsx(Verifikations-Link),AccountDeletedConfirmationEmail.tsx(final) - Plus Tests + Previews
- Commit:
10-compliance-polish/dsgvo: add dsgvo transactional email templates
- Files:
-
Re-Identification-CLI
- Files:
scripts/dsgvo-reveal.mjs,scripts/dsgvo-reveal.test.mjs pnpm dsgvo:reveal --user <pseudonym-id>— entschlüsselt PseudonymizationMap, zeigt originale Felder, schreibt AuditEvent- Requires
PSEUDONYMIZATION_KEYEnv-Var (interactive Prompt) - Commit:
10-compliance-polish/dsgvo: add re-identification cli with audit trail
- Files:
-
Integration in AuditEvent-Auto-Capture
- Files:
apps/web/app/lib/audit/server.ts,apps/api/src/middleware/audit-capture.ts - Sicherstellen dass alle DSGVO-Routes korrekt mit
regulatoryScope=[gdpr],dataSensitivity=piiauditiert sind - Commit:
10-compliance-polish/dsgvo: ensure audit capture for all dsgvo operations
- Files:
-
Dokumentation
- Files:
docs/compliance/gdpr.md(erweitern),docs/compliance/dsgvo-bulk-ops.md(neu mit Workflow-Diagramm) - Architektur, Cascade-Plan, Pseudonymization-Map-Encryption, Re-Identification-Process
- Commit:
10-compliance-polish/dsgvo: document dsgvo bulk operations
- Files:
Test Requirements
- Unit-Tests:
- Pseudonymisierungs-Strategien pro Model
- Cascade-Helper auf Mock-Daten pro Tabelle
- Verification-Pass: positives + negatives Szenario
- IP-Anonymisierung (/24)
- Encryption-/Decryption-Layer
- Integration-Tests:
- End-to-End-Test mit Test-User der Daten in jeder Tabelle hat:
- Export-Trigger → Worker läuft → ZIP-Output enthält erwartete Daten
- Delete-Request → Grace-Period-Aktiv → Login deaktiviert → Reactivation funktioniert
- Nach 30 Tagen (Time-Mocking) → Cascade → Verification grün
- Pseudonymisierungs-Test: User pseudonymisiert → AuditEvents bleiben aber mit anonymen Werten
- Re-Identification: CLI-Command decrypted und zeigt originale Felder
- End-to-End-Test mit Test-User der Daten in jeder Tabelle hat:
- E2E-Tests (Playwright):
- User-Self-Service-Flow: Login → Privacy-Settings → Export anfordern → Email-Link → Download
- User-Self-Service-Delete-Flow: Confirm → Email-Verifikation → Grace-Screen → Reactivation
- Admin-Flow: Admin pseudonymisiert User → User wird zu „Anonymized User #N" → AuditEvent geschrieben
- Coverage-Target: ≥ 90 % im DSGVO-Code (kritischer Compliance-Pfad)
- Test-Files: co-located
<source>.test.ts; E2E intests/e2e/dsgvo-*.spec.ts
NICHT als completed markieren bevor Verification-Pass auf 3 verschiedenen Test-Usern mit jeweils unterschiedlichen Datentypen grün läuft.
Acceptance Criteria
- Schema-Erweiterung migriert; User hat
pendingDeletion/scheduledDeletionAt/pseudonymized-Felder - User-Self-Service-UI auf
/app/$tenant/settings/privacyfunktional; Export + Delete + Reactivate - Email-Verifikation für Self-Service-Delete-Requests
- Admin-UI auf
/app/$tenant/settings/members/$id/privacyfunktional; mit Reason-Text-Pflicht - Pseudonymisierungs-Layer funktioniert; PseudonymizationMap encrypted
- Deletion-Cascade-Helper deckt alle Models mit User-Reference ab (verifiziert via Prisma-DMMF-Schema-Reflection)
- Verification-Pass-Worker läuft 1h nach Cascade; Report wird gespeichert mit Hash
- 30-Tage-Grace-Period funktioniert: Login deaktiviert während Grace, Reactivation möglich, finaler Cascade nach 30d via Cron
- Re-Identification-CLI funktioniert:
pnpm dsgvo:reveal --user <id>mit AuditEvent - Alle DSGVO-Operationen werden mit
regulatoryScope=[gdpr],dataSensitivity=piiauditiert - React-Email-Templates für Export-Ready, Deletion-Confirmation, Deletion-Final
- Coverage ≥ 90 % im DSGVO-Code
pnpm lint,pnpm typecheck,pnpm testgründocs/compliance/dsgvo-bulk-ops.mdmit Workflow-Diagramm angelegtdocs/compliance/gdpr.mdaktualisiert- Staging-Verifikation: E2E-Flow mit Test-User grün
- Detail-MD Progress Log aktualisiert
- PROGRESS.md Status auf
completed
Rollback Strategy
- Schema-Rollback: Migration
down; existing Lösch-Requests werden zu „verloren" (Operator-Eingriff nötig, deshalb sorgfältig vor Production-Rollback) - Cascade-Rollback: Cascade ist destruktiv. Backup-Restore aus
backup-cli.md(Phase 03) ist die einzige Wiederherstellung. Deshalb: Verification-Pass-Logic vor Cascade-Trigger lockert das Risiko (Dry-Run-Mode) - Pseudonymisierung-Rollback: via Re-Identification-CLI auf einzelne User möglich (decrypted PseudonymizationMap, restored Felder); Bulk-Rollback erfordert Backup-Restore
- Grace-Period-Cron-Rollback: Cron deaktivieren; bisher gelöschte User sind weg, Future-Lösch-Requests bleiben in Grace
- UI-Rollback: Routes 404 erlauben; Lösch-Requests in DB bleiben zugänglich für Admin-Eingriff via Prisma-Studio
- Wichtigste Rollback-Vorsicht: Cascade-Run hat KEIN Rollback ohne Backup-Restore — vor jedem Production-Deploy Backup verifizieren
Security Notes
- PSEUDONYMIZATION_KEY ist Platform-Level-Secret, nie pro Tenant, höchste Schutzklasse (Vault/AWS-KMS in Production)
- Re-Identification-CLI ist sensitiv: Audit-Trail-Pflicht (jedes Reveal wird geloggt), interactive Confirmation, Reason-Text-Pflicht
- Self-Service-Delete-Verifikation per Email: schützt vor Account-Hijack-Lösch-Attacken (Angreifer übernimmt Account, will Spuren löschen — Email-Verifikation an die echte User-Email blockt das, sofern Angreifer nicht auch Email kontrolliert)
- Export-Files enthalten ALLE User-Daten — höchste Sensibilität; Signed-URL 7-Tage-Validity, S3-Bucket-Policy strict, kein Public-Read
- Grace-Period-Login-Bypass: stelle sicher dass
pendingDeletion=true-User keinen API-Token mehr ausstellen können (alle existing Tokens werden bei Lösch-Request invalidiert); sonst kann User trotz UI-Block weiter via API arbeiten - Cascade-Race-Conditions: Cascade läuft in Transaction, aber bei mehreren Worker-Replicas könnte derselbe User parallel auch von Admin getriggert werden — Idempotency-Key + DB-Lock auf
user.id - DSGVO-Audit-Konflikt: AuditEvents werden bewusst NICHT gelöscht sondern pseudonymisiert (Compliance-Pflicht: Audit-Trail-Integrität vor User-Lösch-Recht; rechtlich zulässig wenn nicht reidentifizierbar)
- Email-Hash für AuditEvent.actorEmail: SHA-256 mit Pepper, ermöglicht Join-Operations für Compliance-Reports ohne PII-Re-Exposure
- Reactivation-Token: einmalig, 30-Minuten-Validity, signed mit AUDIT_CHAIN_SECRET-ähnlichem Key, verhindert Hijack während Grace-Period
Subagent Recommendations
- Planning:
Plan-Subagent mit dieser Detail-MD +packages/db/prisma/schema.prismaals Input — soll Cascade-Plan validieren gegen reales Schema - Research:
Explore-Subagent mit Auftrag „liste alle Prisma-Models die User-References haben (userId, createdByUserId, actorId, recipient-Email) und schlage Cascade-Strategie vor (delete vs pseudonymize vs transfer-to-tenant)" - Implementation: Ein
general-purpose-Subagent pro Implementation-Step, max 1-2 Steps; Schema + Cascade-Helper in einem Step, UI separat, Worker separat - Tests: Separater
general-purpose-Subagent für E2E-Tests; benötigt Time-Mocking für Grace-Period - Verification:
gsd-verifierfür Acceptance-Criteria; manuelle Verifikation des End-to-End-Flows mit Test-User auf Staging - Code-Review:
gsd-code-reviewernach Step 13, Fokus auf Cascade-Vollständigkeit (jedes Schema-Model abgedeckt?) und Encryption-Layer-Korrektheit
Staging-Deployment-Steps
- Branch
agent/10-dsgvo-bulk-opspushen - Coolify-Auto-Deploy auf Staging
- Prisma-Migration läuft auto via Deploy-Hook
- Env-Vars setzen in Coolify:
PSEUDONYMIZATION_KEY=<random-256bit-base64>(Vault-managed in Production)DSGVO_GRACE_PERIOD_DAYS=30(override für Staging-Tests:DSGVO_GRACE_PERIOD_DAYS=1für schnellere Tests)DSGVO_EXPORT_BUCKET=s3://staging-dsgvo-exportsDSGVO_EXPORT_SIGNED_URL_VALIDITY_HOURS=168(7 Tage)
- Test-User-Setup: SQL-Script auf Staging erstellt Test-User mit Daten in allen Tabellen (User, UserRole, TenantUser, AuditEvent, Row, CrmContact, Notification, OutboundEmail, ChatMessage, FormSubmission)
- Smoke-Test Export: Login als Test-User →
/app/$tenant/settings/privacy/export→ Export anfordern → Email kommt (Mailjet-Sandbox) → ZIP downloaden → Stichproben-Check - Smoke-Test Delete + Grace + Reactivate:
- Login als Test-User → Delete-Request → Email-Verifikation → Grace-Screen
- Sofort Reactivation: Account wieder normal nutzbar
- Erneut Delete-Request → Cron mit
DSGVO_GRACE_PERIOD_DAYS=1→ nach 24h Cascade - Verification-Worker läuft 1h später → Report grün
- Smoke-Test Pseudonymisierung: Admin-Login → Pseudonymize Test-User → AuditEvents bleiben aber actorEmail/actorIp anonymisiert
- Re-Identification-Test:
pnpm dsgvo:reveal --user <pseudonym-id>→ originale Daten zeigen, AuditEvent geschrieben
Resolved Deviations and Remaining Follow-ups
- Email-verification token for self-service delete resolved — the
self-service privacy delete intent now mints a signed HMAC token and emails a
confirmation link before flipping
pendingDeletion. - Grace-period cron resolved —
dsgvo-grace-cronscans overdue users, fans out deletion jobs, and is registered on the maintenance queue from the general worker group. - CLI helpers partially resolved —
toolctrl-cli dsgvo export/delete/verify/reactivateis shipped. Re-identification remains tied to the encrypted PseudonymizationMap follow-up below. - Encrypted PseudonymizationMap + re-identification CLI deferred — the deterministic pseudonym is intentionally non-reversible (per Art. 4(5) DSGVO). The encrypted-map for re-identification on court order is a separate follow-up.
- React-Email templates deferred —
dsgvo-export.tscallssendExportReadyEmailvia a dependency seam; the operator wires the actual template through the worker bootstrap. Concrete templates (PersonalDataExportReadyEmail / AccountDeletedConfirmation) are a follow-up. - DeviceToken cascade entry added by parallel agent #65 — the
parallel Capacitor agent introduced
DeviceTokenwhile this task was in flight; user-fk-map.test.ts caught the gap and #65 added thehard-deleteentry. Documented for future audits. admin.users.updatepermission missing in seed catalog — the parallel #65 agent patched the admin route's permission gate toadmin.users.viewbecause the originaladmin.users.updatekey is absent frompermissions-seed.server.ts. Wiring a proper update permission is a follow-up.
Progress Log
- 2026-05-17 18:09 — d57abb4d — User schema: pendingDeletion, scheduledDeletionAt, deletionRequestedAt, pseudonymized, pseudonymizedAt, deletionRequestId + (pendingDeletion, scheduledDeletionAt) index + migration.
- 2026-05-17 18:11 — 94cef6e2 — packages/db/src/dsgvo/user-fk-map.ts enumerating 49 User-FK entries (50 after #65 added DeviceToken) + grep-driven regression test.
- 2026-05-17 18:14 — b36236ae — packages/db/src/dsgvo/pseudonymize.ts deterministic pseudonym helper + IPv4/24 + IPv6/48 anonymizeIp + buildUserPseudonymizationUpdate; 12 unit tests.
- 2026-05-17 18:16 — cdfb090a — apps/worker/src/jobs/dsgvo-export.ts streaming JSON bundle to S3 multipart sink + AuditEvent + signed URL email; 4 unit tests.
- 2026-05-17 18:18 — b66b0fa6 — apps/worker/src/jobs/dsgvo-deletion.ts cascade across USER_FK_MAP; 4 unit tests including AuditEvent retention guarantee.
- 2026-05-17 18:19 — 95081b42 — apps/worker/src/jobs/dsgvo-verify.ts straggler-detection + escalation hook; 3 unit tests.
- 2026-05-17 18:22 — 908fd94c — /app//settings/privacy self-service hub (export, delete with confirmation gate, reactivate).
- 2026-05-17 18:26 — 16d9a919 — /admin/accounts/users//privacy admin override with mandatory reason text; permission gate later patched by #65.
- 2026-05-17 18:30 — 3626f8ea — AuthService login guard rejects pendingDeletion (423) / pseudonymized (410); 2 unit tests.
- 2026-05-17 18:33 — (initial doc commit) — docs/features/dsgvo-bulk-ops.md + PROGRESS.md + detail-md log.
- 2026-05-18 03:10 — 682c64cc — apps/web/app/utils/dsgvo/deletionToken.server.ts HMAC sign/verify helper + 15 unit tests (DELETION_TOKEN_SECRET with SESSION_SECRET fallback, 24h default TTL, 72h cap, rotation, tamper-resistance, version-prefix isolation from lead tokens).
- 2026-05-18 03:13 — 0576c8b8 — routes/app.$tenant/settings/privacy.tsx — delete intent no longer flips pendingDeletion synchronously; it now mints a signed token, emails a confirmation link via the existing transactional Mailjet queue, and audits phase=confirmation-email-sent.
- 2026-05-18 03:20 — 6f893517 — routes/app.$tenant/settings/privacy.delete.confirm.$token.tsx — GET verifies the token + signed-in user match, POST flips User.pendingDeletion=true with scheduledDeletionAt=now+30d and shows the reactivate-link confirmation page.
- 2026-05-18 03:23 — 3a7aec72 — apps/worker/src/jobs/dsgvo-grace-cron.ts — runDsgvoGraceCron scans overdue users and fans out dsgvo-deletion jobs; registerDsgvoGraceCron upserts a 24h BullMQ scheduler; bootstrap wiring (general group only); 4 unit tests covering happy-path / failure-isolation / empty-input / scheduler upsert.
- 2026-05-18 03:30 — (this commit) — packages/cli/src/commands/dsgvo/{index,export,delete,verify,reactivate}.ts + index.ts wiring; PROGRESS.md row #68 → completed.
- 2026-05-18 07:08 — d63c85d2 / a5a797b5 / e20b4ddf / 17310354 — Cron processor wired in apps/worker/src/handlers.ts; was UnsupportedWorkerJobError post-deploy. (1) Extended CleanupJob.task with
dsgvo-grace-period-scan. (2) Cron scheduler template now emits the CleanupJob discriminator{ kind: "cleanup.run", task: "dsgvo-grace-period-scan" }. (3) Maintenance handler dispatches to arunDsgvoGracePeriodScanHandleradapter that wrapsrunDsgvoGraceCronwith HandlerDependencies. When the optionaldsgvoGraceCronServicedep is absent the handler ACKs with action=dsgvo.grace-period.skipped so BullMQ does not retry-storm. (4) Two new registry-level tests cover the configured-service happy path and the missing-service skip path.
Lessons Learned
- Every cron-scheduled job's
datapayload must match the queue's discriminator shape that the worker dispatches on. The grace-cron initially shipped withdata: { kind: "dsgvo-grace-cron" }while the maintenance handler routes onpayload.task(the CleanupJob discriminator). Because there was notaskfield, the dispatcher fell through toUnsupportedWorkerJobErrorand BullMQ retried forever. Rule going forward: whenever you add a cron-scheduled job, write a test that asserts the scheduler-templatedatamatches the queue-handler's discriminator union — not just the payload's identity field. - Handler dispatchers should default to ACK-with-log when an optional service dep is missing, not throw. Throwing turns a deployment-config gap into an infinite retry loop; an explicit ACK + skipped-action keeps the cron observable and the queue healthy.