40 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 | In Arbeit — Stand 2026-07-21 (2): 10/11 DoD (~91 %). Tenant-Löschung war produktiv nicht durchführbar und ist repariert. Keine echten Blocker mehr: AK-P20 = Done, D-P21 nach AD-28 nicht Done-blockierend, Billing-Gateway verfügbar. |
🎨 design-nachzug: offen (seit 2026-07-12) — Interim-UI aus ~/ui steht; finale Subframe-Optik aus D-P21 ausstehend.
Abhängigkeiten & Parallelität
- Blocked by:
D-P21(finale Privacy-/FAQ-/Feedback-Screens einschließlichdeletion_pending-Shell-Aktion) sowie die eigenen offenen Export-, Lösch-, AVV- und Adapter-Nachzüge. Die AK-P20-/BILL-05-Verträge für Read-only/Frozen und Billing-Cancel sind verfügbar; die Admin-Support-Inbox aus AK-P19 steht. - 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, authentifizierter und bis zu 72 h verfügbarer Download, 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 (authentifizierte App-Route, maximal 72 h); Anstoßen mit Klartext (was, Größe/Dauer, Retention) |
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 (authentifizierter App-Download, 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, authentifizierter, ablaufender
200-Download, Rate-Limit (max. 3 User-Self/24h, max. 1 Tenant-Full aktiv); README + manifest.json im ZIP — erfüllt 2026-07-12: Tenant-Full-Bundle enthält jetzt das Fachmodul-Inventar (Kontakte inkl. E-Mails/Telefone, Projekte, Tasks, Activity-Stream, File-Metadaten) und der Worker verschickt eine Best-Effort-„Export bereit"-Mail an den Anfragenden. Historie: 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. — Der am 2026-07-12 gebaute signed Redirect wurde am 2026-07-20 wegen Hetzner-SSE-C durch einen serverseitigen Download-Proxy ersetzt; direkter Zugriff ohne Customer-Key und jeder Plaintext-Fallback bleiben verboten. — Nachzug 2026-07-21 (2): der im Screen gerenderte Progress wird jetzt tatsächlich geschrieben (markGdprExportProgresshatte null Aufrufer), und die „Export bereit"-Mail ist nicht mehr aufimportQueueRuntimeMode === "full"beschränkt. - 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. Die AK-P20-/BILL-05-Providerverträge stehen; offen sind deren produktive AK-P21-Verdrahtung, Bootstrap/Cron und echte Cleanup-Adapter. — Nachzug 2026-07-12: Lösch-Wizard (Erklärung → Export-Angebot → Billing-Hinweis → Passwort+2FA → Slug-Confirm) + Grace-Countdown mit Abbruch in der UI gebaut; Request-Anlage/-Abbruch produktiv verdrahtet. — Nachzug 2 (2026-07-12): Hard-Delete-Cron produktiv registriert (24h, general-Group) mit echten Adaptern: Storage-Prefix (tenants/{id}/), Search-Purge über alle Indizes, Crypto-Shredding viadestroyTenantDek(AD-8), Tenant-Rows in umgekehrter Registry-Reihenfolge (Audit-Trail + Lösch-Request-Historie bleiben, Tenant-Row wird anonymisiertes Skelett);deletion_pending-Read-Only-Hook über den zentralen AK-P20-Write-Guard (Privacy-Bereich bleibt beschreibbar). Offen NUR noch die provider-seitige Gateway-Kündigung (Lago/Mollie-Terminate-Wrapper + Sync-Consumer existieren noch nicht, BILL--Territorium) — der Cron kündigt konservativ DB-seitig.* - 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. — Nachzug 2026-07-12: AVV-Screen (Version, Akzeptanz-History, Re-Akzeptanz-Dialog) + Subprozessoren-Screen (EU/Drittland-Marker, DPA-Links, CSV-Export, EU-Filter) als Interim-UI gebaut. Offen: AVV-Quell-PDF (Download interim-deaktiviert mit Klartext-Hinweis) und die 14-Tage-Re-Akzeptanz-Read-Only-Sperre. - 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) — Audit 2026-07-21: zu Unrecht abgehakt. Dialog, Rate-Limit (3/24h) und Inbox-Anbindung stehen, aber das in der Screens-Tabelle geforderte Screenshot-Häkchen fehlt vollständig, und die Quelle ist
source: "widget"statt des vereinbartensource_kind: in_app_feedback_widget. — Nachzug 2026-07-21 (2): Quelle aufin_app_feedback_widgetumgestellt (Rate-Limit zählt beide Werte). Screenshot-Häkchen durch Datei-Upload ersetzt (User-Entscheidung 2026-07-21, siehe Umsetzungsnotiz +docs/data-retention.md). - Minimal-FAQ-Seite (statisch)
- Alle Screens mobil tauglich (PWA/responsive, AD-17); kein nativer Client; PWA-Installierbarkeit/Web-Push → v2 — 2026-07-12: erfüllt über Interim-UI (AD-28): alle Privacy-Screens responsive aus
~/ui(mobile:-Fallbacks, 320px-Smoke inkl. axe), Feedback-Widget mobil sichtbar; finale Subframe-Optik = getrackterdesign-nachzug(nicht Done-blockierend). - Hot-Swap-Drill (AGENTS.md DoD 20) für die Privacy-Screens — nachgetragen aus Audit 2026-07-21:
scripts/verify-ui-hot-swap.tskennt AK-P21 nicht, der Drill läuft für diese Screens nicht. - Breadcrumbs für die Privacy-Detail-Routen (AGENTS.md DoD B9) — nachgetragen aus Audit 2026-07-21: kein
handle-Export; Vorbildcustomer-portal/domain.tsx:478. - Notifications über
notify()statt Direktversand (AGENTS.md DoD C15) — nachgetragen aus Audit 2026-07-21: Export-fertig-Mail geht direkt auf die email-Queue, Lösch-Bestätigungsmail direkt übersendEmailMailjet(privacy.tsx:41,251). - Worker-Rechte-Vertrag für den Lösch-Pfad + Live-RLS-Test — nachgetragen aus Audit 2026-07-21, erfüllt: Paritäts-Test
privacy-tenant-deletion-grant-parity.test.ts+ Live-Fälle inrls-live.integration.test.ts. - 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 → SSE-C-verschlüsseltes ZIP (S3-kompatibel, Hetzner) mit bis zu 72 h Retention + README/manifest.json; Download nur über die authentifizierte
200-App-Route, 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 · Milestones: (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)
Dev-Nachzug (nach Davids D-P21-Delta)
- Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- REQUIREMENTS/ROADMAP nachgezogen
- Plane-Ticket
AK-P21aktualisiert
Interim-UI (Vorschau, Stand 2026-07-12): Screens aus ~/ui gebaut —
apps/web/app/components/screens/privacy/{PrivacyHubPage,GdprExportJobsPage,TenantDeletionPage,TenantDeletionWizardDialog,SubprocessorsPage,AvvPage}.tsx.
Lösch-Strecke nach Davids Subframe-Vorlagen S01 Settings Workspaces Loeschbereich + M01 Loeschung anfragen
(Flow WF-P2 Konto loeschen) und M01 Identitaet bestaetigen (Re-Auth); Copy auf App-du-Form angepasst.
Proof: Smoke tests/e2e/privacy-interim.smoke.spec.ts (+ bestehender privacy-self-service.mobile-a11y.spec.ts,
Selektoren erhalten), Contract-Test PrivacyInterimPages.test.ts, Interim-Visual-Baseline
apps/web/app/components/screens/__snapshots__/ak-p21-interim.visual.test.tsx.snap (als interim markiert,
Re-Baseline-Pflicht beim Nachzug). Refactor-Nachzug offen: finale Subframe-Optik aus D-P21
(Plane-Label design-nachzug); dabei InputOtp statt TextInput im 2FA-Schritt prüfen.
Umsetzungsnotiz
2026-07-21 — Stand-Audit + DSGVO-Konformität der Tenant-Löschung
Audit-Befund: der gemeldete Stand (6/8 = 75 %) war zu hoch — real 4/8 = 50 %. Der schwerste Fund ist ein
Produktions-Blocker, der seit dem RLS-Cutover bestand und in keiner Quelle vermerkt war: Der Hard-Delete-Cron
läuft die Lifecycle-Registry durch und ruft deleteMany auf jedem Eintrag, aber der RLS-Vertrag hält
hivegrid_worker bei 9 von 253 Modellen das DELETE vor. Der Cron scheiterte deterministisch bei
FeatureFlagAudit — nachdem Storage, Suchindex und der Tenant-DEK bereits vernichtet waren. Der Antrag blieb
failed und wurde alle 24 h erneut versucht: kein Mandant konnte je vollständig gelöscht werden. Auf Staging
per has_table_privilege gegen die echte DB verifiziert (9/9 bestätigt); TenantDeletionRequest dort leer, es
gab also noch keine beschädigten Mandanten.
Entscheidung (User, 2026-07-21): Rollentrennung statt Rechte-Ausweitung. Auftragsverarbeiter-Daten (Art. 28 Abs. 3 lit. g) werden gelöscht; Daten, für die HiveGrid selbst Verantwortlicher ist, bleiben minimiert erhalten. Frist für Support/Feedback 3 Jahre, ImpersonationAudit dauerhaft.
Proof:
- Lösch-Blocker behoben (
1f4f87575): zwei worker-only SECURITY-DEFINER-Capabilities nach dem Muster vonhivegrid_detach_default_tenant_users—hivegrid_purge_tenant_guarded_rows(6 Modelle in FK-Reihenfolge) undhivegrid_minimize_tenant_support_pii. Neuer Orchestrator-Schritttenant.minimize-retained-piivor dem Row-Purge. Migration20260721090000_ak_p21_tenant_deletion_capabilities. - Zwei Fehler beim Bau selbst gefunden und gefixt: (a) SECURITY DEFINER läuft mit den Rechten des Owners und
BYPASSRLS umgeht nur Policies, nicht Grants —
hivegrid_rls_definerbrauchte eigene, eng gefasste Grants; (b) der Guardp_tenant_id <> current_setting(...)greift bei ungebundenem Kontext nicht (SQL-Dreiwertlogik:'x' <> NULList NULL, nicht TRUE) → aufIS DISTINCT FROMumgestellt. Alle vier Guard-Fälle lokal gegen echte Rollen verifiziert. - Retention-Purge (
362250368):hivegrid_purge_tenant_retained_support+GDPR_SUPPORT_RETENTION_DAYS(3 Jahre); der tägliche Sweep erfasst überincludeInactiveauch bereits gelöschte Skelette. Migration20260721093000_ak_p21_support_retention_purge. - Billing-Cancel produktiv (
07ef574dc): DoD 2 galt als extern blockiert („kein Terminate-Wrapper"), das ist widerlegt —terminateSubscriptionexistiert seit BILL-03 und wird anderswo produktiv genutzt. Die Löschung terminiert jetzt die Lago-Subscriptions vor dem Row-Purge (danach istlagoSubscriptionIdweg). - Fehlende Leitplanke ergänzt:
privacy-tenant-deletion-grant-parity.test.tskreuztTENANT_LIFECYCLE_MODELSgegen den generierten Runtime-Vertrag. Genau dieser Test hätte den Blocker statisch gefangen. - Doku:
docs/data-retention.md§Tenant hard-delete — Zweck, Rechtsgrundlage, Frist je behaltener Tabelle.
Verifikation: worker/db-Typecheck grün · Fokus-Tests 30/30 (Deletion, Bootstrap, Parität) · privacy-gdpr.server
23/23 · geteilte Suiten handlers/index/runtime 234/234 · ESLint 0 Warnings · beide Migrationen lokal gegen
echte RLS-Rollen angewandt und funktional geprüft · lefthook pre-commit grün.
DoD-Stand: 5/11 = ~45 % done (DoD-Liste um 4 im Audit gefundene Pflichtpunkte erweitert, daher der optisch
niedrigere Wert bei real deutlich mehr Substanz). Neu erfüllt: DoD 2 (Tenant-Löschung, jetzt erstmals
durchführbar), Worker-Rechte-Vertrag. Zurückgesetzt: DoD 1 (Progress fehlt komplett — markGdprExportProgress
hat null Aufrufer, die Fortschrittsanzeige springt nur 5 → 100), DoD 5 (Screenshot-Häkchen fehlt).
Offen (selbst machbar, nicht gebaut): Export-Progress · Ready-Mail-Verdrahtung außerhalb full-Mode ·
Feedback-Screenshot · Hot-Swap-Drill · Breadcrumbs · notify()-Umstellung (braucht Freigabe).
Offen (extern): AVV-Quell-PDF + 14-Tage-Re-Akzeptanz-Sperre (Legal-/Produkt-Input), Subprozessor-Inhalte
(Pflegefläche gehört AK-P19).
Sicherheits-Hinweis außerhalb dieses Tickets: Die bestehende hivegrid_detach_default_tenant_users hat
denselben NULL-Vergleichsfehler und läuft ohne gebundenen Kontext durch, statt abzulehnen. Lokal reproduziert.
Nicht mitgefixt (fremder Ticket-Scope) — gehört als eigenes Ticket nachgezogen.
2026-07-13 — CI-Fix PR #94: initial_payload_js-Budget-Anhebung
Der einzige rote CI-Job (Quality Build and Bundle) riss das harte initial_payload_js-Raw-Budget um +0,2 %
(1.703.691 / 1.700.000). Lokaler Build-Diff gegen main (6d352d050) belegt: das Wachstum ist fast vollständig
das React-Router-Manifest (+30,7 KB durch die neuen Privacy-Routen) plus zwei Mini-Icon-Chunks — keine neuen
statischen Imports im Boot-Graph (kein Screen-/Dialog-Code in der Closure; dialog/portal/transition lagen schon
vorher drin). Gemäß der dokumentierten Konvention im Skript-Header (current-build + ~10 %) wurde nur die
Raw-Gruppe angehoben: 1_700_000 → 1_875_000. Die Transport-Budgets (gzip 370k / brotli 320k) bleiben
unangetastet und sind grün (−8,6 % / −12,2 %). Datei: scripts/verify-bundle-size.mjs.
2026-07-12 (Nachzug 2) — Backend-Rest: Inventar, Ready-Mail, Hard-Delete-Cron, Read-Only-Hook
Proof:
- Export-Inventar (DoD 1 → erfüllt):
apps/worker/src/jobs/privacy-gdpr-export-bootstrap.tslädt im Tenant-Full-Bundle jetzt Kontakte (+E-Mails/Telefone), Projekte, Tasks, Activity-Stream und File-Metadaten (paginiert, Byte-Budget); Test deckt Inventar-Pfade ab. - Export-fertig-E-Mail:
createGdprExportReadyMailer(gleiche Datei) + Handler-Hook nachmarkGdprExportReady(Best-Effort, Mail-Fehler failt den Export nie); Wiring inindex.tsüber die email-Queue (buildTransactionalMailJob), Deep-Link viaAPP_URL. Copy fix Deutsch (Worker hat kein i18n; v1 ist DE-only). - Hard-Delete-Cron (DoD 2, Kern erfüllt):
apps/worker/src/jobs/privacy-tenant-deletion-bootstrap.ts— 24h-Scheduler (privacy-tenant-deletion-scan, general-Group, neben dsgvo-grace-cron) + Service mit Adaptern: DB-seitiger Billing-Cancel (ProduktecancelledAt/endsAt), S3-Prefix-Deletetenants/{id}/(paginierend), Meili-Purge viadeleteByFilterüberALL_SEARCH_INDEXES, Crypto-ShreddingdestroyTenantDek, Rows-Delete überTENANT_SCOPED_MODELSreverse (Retention:TenantDeletionRequest,AuditEvent, Audit-Chain-Modelle; Tenant-Row wird anonymisiertes Skelettdeleted-<id>, User-defaultTenantIdgenullt). Handler-Branch +privacyTenantDeletionService-Dep inhandlers.ts; neuer Task-Typ in@hivegrid/queuepayloads/producers; neuer Subpath-Export@hivegrid/cli/tenant-models(+ vitest-Alias, Registry-Gate beachtet). 5 Bootstrap-Tests. - Read-Only-Hook (deletion_pending):
tenantDeletionStatusService.ts+ Erweiterung vonassertTenantWritableForRequest(PermissionsService) — Mutationen liefern 423 mit Klartext-Keysettings.privacy.deletion.readOnly(de/en),/settings/privacy*bleibt als Bypass beschreibbar (Abbruch + Export müssen möglich bleiben). Reuse des AK-P20-Frozen-Mechanismus, 3 neue Guard-Tests.
Verifikation: worker/web/queue-Typecheck grün · Fokus-Tests 23/23 (Export-Bootstrap+Mailer, Deletion-Bootstrap) · geteilte Suiten handlers.test/runtime.test/packages/queue 621/621 grün · PermissionsService-Suiten 163/163 grün · verify:i18n Exit 0 · pnpm lint komplett grün.
Bewusst offen/extern: provider-seitige Billing-Gateway-Kündigung (BILL-*), AVV-Quell-PDF + 14-Tage-Re-Akzeptanz-Sperre (keine Vertragsdatei/Versions-Metadaten vorhanden — Design-/Legal-Input nötig), finale D-P21-Optik (design-nachzug).
DoD-Stand: 6/8 = 75 % done (neu: DoD 1 voll; DoD 7 via AD-28). Offen: DoD 2 nur Gateway-Terminate (extern), DoD 3 AVV-PDF/Frist-Sperre (blockiert).
2026-07-12 — Interim-UI (AD-28) + Signed-Download + Minimal-Wiring (historisch, Download-Vertrag am 2026-07-20 abgelöst)
Routen-Entscheid (Abweichung von der Screens-Tabelle oben): Die Admin-Privacy-Screens leben unter
/app/:tenant/settings/privacy/* (Hub, export, deletion, subprocessors, avv) statt /admin/privacy —
die privacy.*-Permissions sind Tenant-Rollen (SuperUser/Admin), der Slug-Confirm/Passwort+2FA-Flow gehört dem
Tenant-Admin, und der /admin-Host ist Plattform-Admin (host-aware Routing). Die /admin/privacy-Angabe in der
Tabelle ist pre-Host-Split-Wording. User-Self-Export + Account-Löschung bleiben im selben Hub (statt
/settings/account/data-export).
Proof:
- Branch
akeshan/ak-p21-privacy-interim-ui, Commitfeat(ak-p21): privacy interim UI (AD-28) + signed export download. - VMs:
packages/view-models/src/privacy/(privacy-hub, gdpr-export, tenant-deletion, avv, subprocessors) + 25 Unit-Tests. - Historischer Signed-Download:
apps/web/app/routes/app.$tenant/settings/privacy.export.$jobId.download.ts+~/utils/privacy/gdprExportDownload.server.ts(damals SigV4-Presign). Seit 2026-07-20 ersetzt: SSE-C-GET nur serverseitig, vollständige Größen-/Streamprüfung vor Downloadcount/Audit, danach200-Attachment; Ownership self/tenant und 404/410-Klartext bleiben. - Screens (AD-28,
~/ui, VM als Prop):apps/web/app/components/screens/privacy/— Hub (bestehendeui.settings.privacy.*-Form-Selektoren erhalten), Export-Jobliste mit Start-Dialog (S 560) + Progress + Download, Lösch-Bereich nach DavidsS01/M01-Vorlagen + Wizard (M 720, StepperHorizontal, 5 Schritte, Slug-Confirm-Gate), Subprozessoren (EU-Filter, CSV), AVV (History + Re-Akzeptanz-Dialog). - Routen:
privacy.tsx(Hub-Umbau),privacy.export.tsx(Self+Tenant-Full-Anstoss, Rate-Limit-Fehler in Klartext),privacy.deletion.tsx(Passwort-Verify + TOTP + Slug-Check →createTenantDeletionRequest/cancel…, Audit),privacy.subprocessors.tsx,privacy.avv.tsx(acceptAvv, Audit).privacy.*-Permissions werden jetzt in Loadern/Actions durchgesetzt (Denied = 404); Settings-Tab „Datenschutz" ergänzt (Reachability B6). - Feedback-Widget:
AddFeedbackButton.tsxauf echten~/ui-Dialog (XS 420) mit Kategorie-Select (Bug/Feature/Frage, Präfix in Message serverseitig) umgestellt, mobil sichtbar;nav-actions.tsxnutzt den geteilten Dialog. - i18n: alle neuen Keys de+en chirurgisch gespliced (
verify:i18nExit 0). - Tests: Fokus 54/54 (VM-Units,
PrivacyInterimPages.test.ts-Contract, Download-Route 5/5, Interim-Visual-Baselines P20+P21), Nachbar-Suiten (subscription-Route, delete-mail, Feedback.server, nav-actions, session-csrf-sweep) grün; neue Smoke-Spectests/e2e/privacy-interim.smoke.spec.ts(nicht-mutierend, 320px+axe).
Verifikation:
pnpm --filter @hivegrid/web typecheckgrün ·pnpm --filter @hivegrid/view-models typecheckgrünpnpm run verify:i18nExit 0 ·pnpm run verify:cross-cutting-models181/181 ·verify:sidebar-routes(echte Repo-Suiten grün; Fails nur in.codex/worktrees-Kopien, bekanntes lokales Sammelproblem)- ESLint 0 Warnings auf allen angefassten Dateien; kein Prisma-Touch (keine Migration nötig)
DoD-Stand: 5/8 = ~63 % done (neu abgehakt: „Alle Screens mobil tauglich" via AD-28-Interim). Offen (selbst machbar):
DoD 1 Fachmodul-Inventar Tenant-Full + optionale Export-E-Mail; DoD 2 Hard-Delete-Cron-Registrierung +
Cleanup-/Crypto-Shredding-Adapter + deletion_pending-Read-Only-Hook; DoD 3 AVV-Quell-PDF + 14-Tage-Read-Only-Sperre.
Extern blockiert: finale Subframe-Optik aus D-P21 (getrackter design-nachzug, nicht Done-blockierend).
Aktuelle AVV-Version ist Konfiguration (AVV_CURRENT_VERSION, Default 1.0).
2026-07-12 — Dependency-Impact aus AK-P20
AK-P20 hat die Customer-UI-/VM-Schicht sowie die Billing-Banner-Präsentation in Shell und App-Loader auf
die Interim-Screens ausgerichtet. Die bestehenden Read-only-/Frozen- und Billing-Cancel-Serviceverträge
wurden nicht geändert; AK-P21 kann sie weiterhin konsumieren. deletion_pending und dessen Shell-Aktion
bleiben ausdrücklich AK-P21-/D-P21-Arbeit und sind kein AK-P20-100%-Proof.
Der Provider-Blocker ist damit entfallen. AK-P21 bleibt wegen seiner eigenen offenen Export-, Lösch-,
AVV-/Subprozessor- und D-P21-Arbeit bei 4/8 DoD = 50 % done auf Blocked / On Hold.
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-21 (2) — Restwork-Slices S3–S8
Fortsetzung des Stand-Audits. Alle im Plan freigegebenen Slices ausser dem Screenshot-Teil von S5 umgesetzt.
S3 — Export-Progress (DoD 1). markGdprExportProgress hatte null Aufrufer; der Job sprang 5 → 100,
die Fortschrittsanzeige im Export-Screen war faktisch tot. Der Bundle-Loader meldet jetzt einen Schritt je
geladener Tabelle (Band 10..60), der Runner die Meilensteine Bundle/Archiv/Upload (70/80/90);
markGdprExportReady schreibt weiterhin die 100. Progress ist bewusst advisory: ein fehlgeschlagener
Progress-Write wird geschluckt und kann einen erfolgreichen Export nie kippen.
Proof: apps/worker/src/jobs/privacy-gdpr-export.ts, …/privacy-gdpr-export-bootstrap.ts;
Tests privacy-gdpr-export.test.ts (Meilensteine + failing reporter), privacy-gdpr-export-bootstrap.test.ts
(8 steigende Schritte, markProgress mit persistierter Job-Identität). Commit 42f94b112.
S4 — Ready-Mail (DoD 1). Der Mailer hing an importQueueRuntimeMode === "full", obwohl beide
Import-Runtime-Modi den GDPR-Export-Handler besitzen. Im Modus portal-gdpr-export lief derselbe Job
durch, ohne den Anfragenden je zu benachrichtigen. Gate entfernt; der Test in apps/worker/src/index.test.ts
hatte die alte (fehlerhafte) Erwartung festgeschrieben und wurde mitgezogen. Commit 42f94b112.
S7 — Breadcrumbs (DoD B9, nachgetragener Punkt). Die vier Screens unter dem Hub hatten keinen
Breadcrumb und gar keinen Weg zurück. Neu: apps/web/app/components/screens/privacy/PrivacyBreadcrumbs.tsx,
eingehängt in ExportJobs/Deletion/Subprocessors/Avv. Das Hub-Ziel wird als Prop injiziert statt im Screen
aus Router-Daten abgeleitet — Screens bleiben reine VM-Konsumenten (DoD A5). Interim-Visual-Baseline neu
aufgenommen (AD-28, beim D-P21-Delta erneut re-baseline-pflichtig). Commit 5e5326af7.
S6 — Hot-Swap-Drill (DoD 20, nachgetragener Punkt). scripts/verify-ui-hot-swap.ts kannte AK-P21
überhaupt nicht. Neu: createP21InterimFixturePage in packages/ui-mock/src/index.ts (Form wie AK-P20)
plus Registrierung im Drill; die fünf Privacy-Routen sind damit über die Mock-Registry adressierbar und
renderbar. i18n-Keys unter mock.p21.* in de+en. pnpm run verify:ui-hot-swap grün. Commit 70468a401.
S8 — notify() statt Direktversand (DoD C15, nachgetragener Punkt). Zwei Verstösse behoben: die
Lösch-Bestätigung ging per sendEmailMailjet direkt aus der Route, die Export-fertig-Mail auf die rohe
Transaktions-Mail-Queue. Beide enqueuen jetzt einen Notification-Job (neu:
apps/web/app/utils/privacy/privacyNotificationQueue.server.ts), damit der M011-Handler Preference-Check,
NotificationDelivery und Provider-Call besitzt. Beide laufen auf der gesperrten Kategorie critical:
ein Lösch-Link hat eine harte Frist, eine Auskunfts-Benachrichtigung ist eine Rechtspflicht.
Dabei gefunden und mitgefixt (Begründung): Der Queue-Pfad hat die
critical-Ausnahme nicht respektiert — anders alsisNotificationEnabled()inpackages/foundation. Eine veraltetecritical-Preference-Zeile hätte damit genau die Benachrichtigungen unterdrückt, die nicht unterdrückbar sein dürfen. Ohne diesen Fix wäre die Umstellung aufnotify()eine Verschlechterung gewesen, deshalb kein separates Ticket. Regressionstest inapps/worker/src/handlers.test.ts.
Die Lösch-Route meldet weiterhin hart (502 + Audit), wenn die Queue nicht verfügbar ist, statt dem Nutzer
eine Mail zu versprechen, die nie kommt. Commit 98599d94c.
S5 — Feedback-Widget: nur der source-Teil. Das Widget schrieb das generische source: "widget"
statt des vereinbarten in_app_feedback_widget; die Support-Inbox konnte Widget-Feedback nicht von
anderem Widget-Intake unterscheiden. Umbenannt, wobei die Rate-Limit-Abfrage beide Werte zählt —
sonst bekäme beim Deploy jeder Nutzer ein frisches 3/24h-Kontingent. Commit 11645fe69.
Der Screenshot-Teil ist bewusst NICHT gebaut — siehe Rückfrage unten.
Verifikation: apps/worker/src 1549/1549 grün · packages/db|ui-mock|foundation 1133/1133 grün ·
betroffene Web-Suiten 338/338 grün · verify:i18n, verify:cross-cutting-models,
verify:sidebar-routes, verify:ui-hot-swap Exit 0 · Worker-/Web-Typecheck grün (die 57 offenen
customer-portal-Typfehler bestehen unverändert auch ohne diese Änderungen — vorher/nachher verglichen).
DoD-Stand: 10/11 = ~91 % done (vorher 5/11 ≈ 45 %). Offen:
- DoD 3 (AVV/Subprozessoren): AVV-Quell-PDF fehlt weiterhin, 14-Tage-Re-Akzeptanz-Sperre ungebaut — blockiert durch offene Fragen (PDF-Quelle, Fristanker).
S5 abgeschlossen — Screenshot-Häkchen durch Datei-Upload ersetzt (User-Entscheidung 2026-07-21). Statt dass die App die Seite selbst aufnimmt, hängt der Melder ein Bild bewusst selbst an.
Begründung (auch in docs/data-retention.md festgehalten): Eine clientseitige Aufnahme der aktuellen
Seite enthält regelmäßig personenbezogene Daten Dritter (Kontakte, Projekte), die der Melder nie
bewusst ausgewählt hat, und trägt sie vom Verantwortlichen zum Plattform-Betreiber. Die Dateiauswahl macht
die Weitergabe zu einem bewussten Akt und erfüllt die Datenminimierung (Art. 5(1)(c)). Zusätzlich entfällt
damit die Entscheidung über eine neue Screenshot-Abhängigkeit.
Umsetzung:
FileEntityTypeumsupport_ticketerweitert (additiver Cross-Modul-Touch vonfiles.prisma, AD-21 wiechat_message); Merge-Migration20260721140000_ak_p21_feedback_attachmentmit Inverse-SQL.- Widget: Datei-Feld (PNG/JPEG/WebP/GIF, max. 5 MB, ein Bild) statt Häkchen,
multipart/form-data, clientseitige Vorprüfung mit Klartext-Fehler; der Server prüft dieselben Grenzen erneut. - Server:
createFileFromBytes(fail-closed Magic-Bytes-Allow-List vor dem Storage-PUT, danach ClamAV über die File-Scan-Queue,scanStatus=pendingbis der Worker freigibt) +FileEntityLink. Der Anhang wird nach dem Ticket gespeichert, damit ein abgelehnter Upload nie den geschriebenen Text kostet. Ohne Tenant kein Anhang, weilFile.tenantIdNOT NULL ist. - Rate-Limit bleibt das bestehende 3/24h des Widgets.
- Admin-Inbox zeigt Name, Typ, Größe und Scan-Verdikt. Gelesen wird über
withTenantRLS(ticket.tenantId, …), weilFileEntityLink— anders alsSupportTicket— keine Operator-Ausnahme in der Policy hat.
Proof: apps/web/app/modules/helpDesk/services/Feedback.server.ts (+ 6 neue Tests),
AddFeedbackButton.tsx, routes/app.$tenant.tsx, routes/admin/support/$id.tsx,
AdminSupportTicketPage.tsx, prisma/schema/files.prisma.
Nachgezogen 2026-07-21 (3) — Operator-Download. Der oben als offen vermerkte Nachzug ist auf
ausdrücklichen Auftrag des Users gebaut: apps/web/app/routes/admin/support/attachments.$ticketId.$fileId.ts.
Der Tenant-Medien-Proxy kann das nicht leisten, weil ein Plattform-Operator kein Mitglied des besitzenden
Tenants sein muss. Die Route ist deshalb bewusst enger als ein allgemeiner Operator-Datei-Proxy: sie
liefert ausschließlich eine Datei, die am genannten Support-Ticket hängt. Reihenfolge der Prüfungen ist der
Sicherheitsvertrag, fail-closed an jeder Stufe: Admin-Identität → Ticket tenant-gebunden → Datei am Ticket
verlinkt → nicht archiviert → Scan-Verdikt explizit clean → Storage-Key gehört dem Tenant → Audit →
302 auf eine kurzlebige signierte URL. Das Audit läuft vor der Signatur: ein Operator-Zugriff auf
kundenseitig hochgeladenes Material, der nicht protokolliert werden kann, findet nicht statt. Jede Ablehnung
antwortet 404 mit leerem Body (nie 403). Proof: 12 neue Tests in
attachments.$ticketId.$fileId.test.ts (überwiegend Ablehnungspfade) + Gating-Test in $id.test.ts;
Vertrag dokumentiert in docs/data-retention.md §„Operator access to an attachment".
Produktions-Defekt in der eigenen Migration gefunden und behoben. pnpm run verify:migrations-parity
(Replay gegen eine leere DB) deckte auf, dass 20260721090000_ak_p21_tenant_deletion_capabilities
und 20260721093000_ak_p21_support_retention_purge mit 42501 permission denied for schema public
scheitern: Der Cutover erteilt hivegrid_rls_definer CREATE auf public und entzieht es am Ende
wieder (20260713190000_appwide_rls_cutover Zeilen 159/1486). Ein ALTER FUNCTION … OWNER TO verlangt
aber CREATE beim neuen Eigentümer. Auf einer inkrementell gewachsenen DB lief es durch, auf einer frischen
nicht — exakt der Footgun aus infra/LESSONS.md §9. Beide Migrationen klammern den Eigentümerwechsel
jetzt in ein temporäres GRANT/REVOKE, analog zum Cutover selbst. Parity-Gate danach grün.
2026-07-21 (3) — Sicherheits-Fix außerhalb des Ticket-Scopes (auf Auftrag)
Auf ausdrücklichen Auftrag des Users, nicht aus der AK-P21-DoD abgeleitet — hier nur dokumentiert, weil der Befund im AK-P21-Audit entstand.
public.hivegrid_detach_default_tenant_users(text) ist die SECURITY-DEFINER-Kapselung, mit der der
Tenant-Hard-Delete "User"."defaultTenantId" fremder Tenants leert (unter RLS für den Worker sonst
unsichtbar). Ihr Guard verglich den angefragten Tenant per <> mit dem gebundenen Kontext. In SQL ist
't_1' <> NULL aber NULL, nicht TRUE: bei ungesetztem app.tenant_id ergab die gesamte OR-Kette
NULL, das IF feuerte nicht, und die Funktion detachte die User jedes genannten Tenants — genau der Fall,
den der Guard abweisen soll. Lokal am DB-Objekt belegt: alte Bedingung NULL → IF feuert nicht; neue
Bedingung true → 42501.
Fix: IS DISTINCT FROM (NULL-sicher), wie es die Schwester-Capabilities schon verwenden. Geändert wird
die Generator-Quelle scripts/generate-tenant-policy-contract.mjs (der Vertrag ist generiert), der
Vertrag neu erzeugt, plus Nachzugs-Migration 20260721160000_ak_p21_detach_guard_null_safety (der
Cutover selbst ist eingefroren). Regressions-Test: der Generator-Test behauptete bisher den fehlerhaften
Vergleich als Soll — korrigiert, plus neue Zusicherung, dass <> NULLIF(current_setting( im gesamten
gerenderten SQL nie vorkommt (in einem Guard ist die Logik invertiert, NULL heißt dort fail-open).
Zweiter Migrations-Defekt, wieder vom Parity-Gate gefunden. Erste Fassung der Migration scheiterte auf
leerer DB mit 42501 must be owner of function: CREATE OR REPLACE prüft Eigentum, und die Funktion
gehört hivegrid_rls_definer. Der Migrator ist zwar Mitglied dieser Rolle (er führt im Cutover
ALTER FUNCTION … OWNER TO aus), Mitgliedschaft allein verleiht die Eigentümerrechte aber nicht — es
braucht ein explizites SET LOCAL ROLE, und als diese Rolle dann wieder das temporäre CREATE-Bracket auf
public. Eigentümer und EXECUTE-Grant des Workers bleiben unverändert. Parity-Gate danach grün.
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.
Pilot-Readiness-Nachzug 2026-07-29
Das globale Feedback-/Support-Widget gibt unbekannte Servicefehler nicht mehr als rohe
Error.message an den Browser zurück. Damit bleiben DB-, Queue-, Storage- und Konfigurationsdetails
serverseitig. Erwartete Eingabefehler und das 3/24h-Limit behalten eigene übersetzte 400-/429-Zustände;
unerwartete Fehler liefern einen neutralen übersetzten 503-Zustand. Leerer Support-Text wird vor dem
Serviceaufruf abgefangen. Proof: 30 fokussierte Route-/Feedback-/Support-Tests, ESLint,
verify:i18n und git diff --check grün.
AK-P21 bleibt 10/11 DoD = ~91 % done. Offen bleibt unverändert der AVV-/Re-Akzeptanz-Punkt; dieser Hardening-Nachzug ändert den fachlichen DoD-Zähler nicht.