390 lines
40 KiB
Markdown
390 lines
40 KiB
Markdown
# 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.
|