Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/AK-P21.md
T

390 lines
40 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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ßlich `deletion_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 in `AdminSupportTicket` (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
- [x] **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 fuer `gdpr_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 (`markGdprExportProgress` hatte null Aufrufer), und die „Export bereit"-Mail ist nicht mehr auf `importQueueRuntimeMode === "full"` beschränkt.*
- [x] **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 via `destroyTenantDek` (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.*
- [x] **DSGVO-Auskunft als dokumentiertes Playbook** (Suche → Kontakt-Detail → CSV → Anwalts-Vorlage → Frist-Task +25 Tage) — kein automatisches Tooling
- [x] **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 vereinbarten `source_kind: in_app_feedback_widget`. — Nachzug 2026-07-21 (2): Quelle auf `in_app_feedback_widget` umgestellt (Rate-Limit zählt beide Werte). **Screenshot-Häkchen durch Datei-Upload ersetzt** (User-Entscheidung 2026-07-21, siehe Umsetzungsnotiz + `docs/data-retention.md`).*
- [x] **Minimal-FAQ**-Seite (statisch)
- [x] 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 = getrackter `design-nachzug` (nicht Done-blockierend).*
- [x] **Hot-Swap-Drill** (AGENTS.md DoD 20) für die Privacy-Screens — *nachgetragen aus Audit 2026-07-21: `scripts/verify-ui-hot-swap.ts` kennt AK-P21 nicht, der Drill läuft für diese Screens nicht.*
- [x] **Breadcrumbs** für die Privacy-Detail-Routen (AGENTS.md DoD B9) — *nachgetragen aus Audit 2026-07-21: kein `handle`-Export; Vorbild `customer-portal/domain.tsx:478`.*
- [x] **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 über `sendEmailMailjet` (`privacy.tsx:41,251`).*
- [x] **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 in `rls-live.integration.test.ts`.*
- [x] Permissions: `privacy.user_export.self` (implizit jeder User), `privacy.tenant_export`/`privacy.tenant_deletion`/`privacy.avv.*`/`privacy.subprocessors.read` (über `tenant.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 in `AdminSupportTicket` (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_data` n/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-P21` aktualisiert
**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 von
`hivegrid_detach_default_tenant_users` — `hivegrid_purge_tenant_guarded_rows` (6 Modelle in FK-Reihenfolge)
und `hivegrid_minimize_tenant_support_pii`. Neuer Orchestrator-Schritt `tenant.minimize-retained-pii` vor dem
Row-Purge. Migration `20260721090000_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_definer` brauchte eigene, eng gefasste Grants;
(b) der Guard `p_tenant_id <> current_setting(...)` greift bei **ungebundenem** Kontext nicht (SQL-Dreiwertlogik:
`'x' <> NULL` ist NULL, nicht TRUE) → auf `IS DISTINCT FROM` umgestellt. 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 über `includeInactive` auch bereits gelöschte Skelette.
Migration `20260721093000_ak_p21_support_retention_purge`.
- **Billing-Cancel produktiv** (`07ef574dc`): DoD 2 galt als extern blockiert („kein Terminate-Wrapper"), das ist
widerlegt — `terminateSubscription` existiert seit BILL-03 und wird anderswo produktiv genutzt. Die Löschung
terminiert jetzt die Lago-Subscriptions **vor** dem Row-Purge (danach ist `lagoSubscriptionId` weg).
- **Fehlende Leitplanke ergänzt:** `privacy-tenant-deletion-grant-parity.test.ts` kreuzt `TENANT_LIFECYCLE_MODELS`
gegen 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.ts` lä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 nach `markGdprExportReady` (Best-Effort, Mail-Fehler failt den Export nie); Wiring in `index.ts` über die email-Queue (`buildTransactionalMailJob`), Deep-Link via `APP_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 (Produkte `cancelledAt/endsAt`), S3-Prefix-Delete `tenants/{id}/` (paginierend), Meili-Purge via `deleteByFilter` über `ALL_SEARCH_INDEXES`, Crypto-Shredding `destroyTenantDek`, Rows-Delete über `TENANT_SCOPED_MODELS` reverse (Retention: `TenantDeletionRequest`, `AuditEvent`, Audit-Chain-Modelle; Tenant-Row wird anonymisiertes Skelett `deleted-<id>`, User-`defaultTenantId` genullt). Handler-Branch + `privacyTenantDeletionService`-Dep in `handlers.ts`; neuer Task-Typ in `@hivegrid/queue` payloads/producers; neuer Subpath-Export `@hivegrid/cli/tenant-models` (+ vitest-Alias, Registry-Gate beachtet). 5 Bootstrap-Tests.
- **Read-Only-Hook (deletion_pending):** `tenantDeletionStatusService.ts` + Erweiterung von `assertTenantWritableForRequest` (PermissionsService) — Mutationen liefern 423 mit Klartext-Key `settings.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`, Commit `feat(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, danach `200`-Attachment; Ownership self/tenant und 404/410-Klartext bleiben.
- Screens (AD-28, `~/ui`, VM als Prop): `apps/web/app/components/screens/privacy/` — Hub (bestehende `ui.settings.privacy.*`-Form-Selektoren erhalten), Export-Jobliste mit Start-Dialog (S 560) + Progress + Download, Lösch-Bereich nach Davids `S01/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.tsx` auf echten `~/ui`-Dialog (XS 420) mit Kategorie-Select (Bug/Feature/Frage, Präfix in Message serverseitig) umgestellt, mobil sichtbar; `nav-actions.tsx` nutzt den geteilten Dialog.
- i18n: alle neuen Keys de+en chirurgisch gespliced (`verify:i18n` Exit 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-Spec `tests/e2e/privacy-interim.smoke.spec.ts` (nicht-mutierend, 320px+axe).
Verifikation:
- `pnpm --filter @hivegrid/web typecheck` grün · `pnpm --filter @hivegrid/view-models typecheck` grün
- `pnpm run verify:i18n` Exit 0 · `pnpm run verify:cross-cutting-models` 181/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.server` fuer Export-Limits, 72h-Expiry, Tenant-Deletion-Grace/Cancel, AVV-Akzeptanz und Subprozessoren; `createWidgetSupportTicket` fuer 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.read` in Seed, DefaultPermissions, Rollenanzeige und i18n.
Verifikation:
- `pnpm typecheck` gruen
- `pnpm lint` gruen
- `pnpm exec prisma validate` gruen
- `pnpm run verify:tenant-isolation-report` gruen
- `pnpm run verify:security-gdpr-docs` gruen
- 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-matrix` scheitert auf Windows mit `spawn pnpm ENOENT`.
- Breites `pnpm test` timed 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 als `isNotificationEnabled()` in `packages/foundation`. Eine veraltete
> `critical`-Preference-Zeile hätte damit genau die Benachrichtigungen unterdrückt, die nicht
> unterdrückbar sein dürfen. Ohne diesen Fix wäre die Umstellung auf `notify()` eine Verschlechterung
> gewesen, deshalb kein separates Ticket. Regressionstest in `apps/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:
- `FileEntityType` um `support_ticket` erweitert (additiver Cross-Modul-Touch von `files.prisma`, AD-21
wie `chat_message`); Merge-Migration `20260721140000_ak_p21_feedback_attachment` mit 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=pending` bis der Worker freigibt) + `FileEntityLink`.
Der Anhang wird **nach** dem Ticket gespeichert, damit ein abgelehnter Upload nie den geschriebenen
Text kostet. Ohne Tenant kein Anhang, weil `File.tenantId` NOT 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, …)`,
weil `FileEntityLink` — anders als `SupportTicket` — **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.ts` erzeugt ZIPs mit README/manifest/data-Dateien; `apps/worker/src/jobs/privacy-gdpr-export.ts` baut GDPR-Export-Artefakte; `apps/worker/src/handlers.ts` routet `gdpr_user_self`/`gdpr_tenant_full` in den GDPR-Statuspfad.
- Web-Queue: `apps/web/app/utils/privacy/gdprExportQueue.server.ts`; `/app/:tenant/settings/privacy` legt bei Self-Service-Export jetzt `GdprExportJob` an und enqueue't den Export.
- Tenant-Löschung: `apps/worker/src/jobs/privacy-tenant-deletion.ts` definiert 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.ts` bootstrapped den GDPR-Export-Service produktiv mit S3-`PutObjectCommand` und konservativen User-Self/Tenant-Full-Bundle-Loadern (User/Tenant/TenantUser/AuditEvent/NotificationPreference/NotificationDelivery).
Verifikation:
- `pnpm typecheck` gruen
- `pnpm --filter @hivegrid/exports typecheck` gruen
- `pnpm --filter @hivegrid/worker typecheck` gruen
- `pnpm lint` gruen
- `pnpm exec prisma validate` gruen
- `pnpm run verify:tenant-isolation-report` gruen
- `pnpm run verify:security-gdpr-docs` gruen
- 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 ENOENT` ein 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-foundation` gepusht.
- Implementierungs-Commit `4a02238a6` (`feat: add AK-P21 GDPR launch foundation`).
- Plane-Kommentar `4a56b8c9-6254-4987-bd3d-2b78945b4786` am 2026-07-02 gesetzt; Ticket bleibt bewusst `Blocked / On Hold`, nicht `Done`.
### 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.