# Phase 10 — Compliance + Polish **Dauer:** 8-9 Wochen (parallel-arbeitend deutlich kürzbar) **Tasks:** 9 **Ziel:** Boilerplate compliance-ready (DSGVO, SOC2-Evidence, HIPAA-Spuren) und auf production-grade Politur bringen — Email-System auf React-Email, Lighthouse-/Bundle-/i18n-/WCAG-Sweeps, dokumentierte Threat-Models und harte Test-Coverage-Gates. Diese Phase macht die Boilerplate „audit-fähig" für Enterprise-Kunden. ## Warum diese Phase Bis Phase 09 ist die Boilerplate funktional komplett (Skalierung, Search/RAG, Business-Features, Plugin-System, Chatbot, Mobile/CLI/Storybook/SDK, Authentik) — aber sie ist nicht bereit für regulierte Industrien oder Enterprise-Procurement. Konkret fehlt: - **DSGVO-konforme Bulk-Operationen** für User-Self-Service (Art. 15 Auskunft, Art. 17 Löschung, Art. 20 Portabilität). Heute gibt es lediglich Stubs in `docs/data-retention.md`. - **Standardisierte Audit-Events** für SOC2-CC6-/HIPAA-Sec-Rule-/GDPR-Art-30-Evidence. `AuditEvent`-Schema in `packages/db/prisma/schema.prisma` ist zu generisch — keine `actorIp`, kein `regulatoryScope`, keine Tamper-Evidence-Hash-Chain. - **React-Email**: Aktuelle Transactional-Templates in `packages/mail/src/templates/transactional.ts` sind handgeschriebenes HTML mit manuellen `escapeHtml`-Aufrufen — Audit-Findings und Maintenance-Nightmare. Marketing-Funnel-Phase-3 (Phase 05) braucht React-Email für Email-Sequences, dieser Task kann also **früher gezogen werden**. - **Security-Dokumentation**: Threat-Model existiert nur fragmentarisch (`docs/security/threat-model.md` für Auth-Flows, nicht ganzheitlich). Vuln-Disclosure-Policy, Pen-Test-Scope, IR-Runbook fehlen oder sind nicht extern verlinkbar. - **Lighthouse-Targets**: `.lighthouserc.json` läuft mit niedrigen Thresholds und nur public-route-Coverage; interne App-Routes werden nicht audited. - **Bundle-Budgets**: `scripts/verify-bundle-size.mjs` hat ein globales Limit, keine per-Route-Limits — Dashboard-Route schleicht still über 500 KB. - **i18n-Foundation**: `packages/i18n/src/` hat nur einen Stub. ICU-Plurals, Intl-Helpers, RTL-Layout sind nicht etabliert. - **WCAG-Coverage**: Es gibt sporadische axe-Tests aber keine Coverage-Pflicht, keine Color-Contrast-Audits, kein Skip-to-Content-Link in Layouts. - **Test-Coverage**: Coverage-Tooling fehlt komplett für viele Module. Auth-/Billing-/Tenant-Isolation-Helpers sind kritisch, aber nicht durch Threshold-Gates geschützt. Ohne diese Phase kann die Boilerplate keinen Enterprise-Sales-Process bestehen (kein SOC2-Evidence, keine GDPR-Bulk-Ops), keine RFP für regulierte Industrien gewinnen, und brennt sich technische Schulden in die Email- und Frontend-Layer ein, die später teurer zu beheben sind. ## Task-Reihenfolge | Reihenfolge | Task-ID | Datei | Parallelisierbar mit | Subagent-Slot | |---|---|---|---|---| | 1 (vorgezogen) | #75 | `react-email.md` | alle anderen Phase-10-Tasks | Email-Subagent (ggf. parallel zu Phase 05) | | 2 | #67 | `compliance-audit-export.md` | #69, #70, #71, #72, #73 | Compliance-Subagent | | 3 | #68 | `dsgvo-bulk-ops.md` | #69, #70, #71, #72, #73 | Compliance-Subagent (sequenziell nach #67 wegen Schema-Updates) | | 4 | #69 | `security-docs.md` | #67, #68, #70, #71, #72, #73 | Docs-Subagent | | 5 | #70 | `lighthouse.md` | #67, #68, #69, #71, #72, #73 | Polish-Subagent | | 6 | #71 | `bundle-budget.md` | #67, #68, #69, #70, #72, #73 | Polish-Subagent | | 7 | #72 | `i18n-foundation.md` | #67, #68, #69, #70, #71, #73 | Polish-Subagent | | 8 | #73 | `wcag-internal.md` | #67, #68, #69, #70, #71, #72 | Polish-Subagent | | 9 (am Ende) | #76 | `test-coverage.md` | — (braucht alle anderen Tasks für stabile Module-Baseline) | QA-Subagent | ## Dependency-Graph (intern) ``` ┌── (kann früh gezogen werden, Phase 05 Marketing-Funnel-Phase-3 nutzt es) #75 react-email ────────────────────┤ │ #67 compliance-audit-export ──► #68 dsgvo-bulk-ops │ │ │ (gemeinsame Prisma-Schema- │ │ Updates an AuditEvent) │ ▼ ▼ └──────────────► (Audit-Events landen in DSGVO-Bulk-Ops-Operationen) #69 security-docs ◄── parallel ──┐ #70 lighthouse ◄── parallel ──┤ #71 bundle-budget ◄── parallel ──┤ #72 i18n-foundation ◄── parallel ──┤ #73 wcag-internal ◄── parallel ──┘ #76 test-coverage ──► am Ende, prüft Coverage über alle Phase-1-9-Module + Phase-10-Module ``` **Wichtige Reihenfolge-Regeln:** - **`#75 react-email` kann sofort starten** (sobald Phase 01 + 02 stehen) und sollte vor Phase-05-Marketing-Funnel-Phase-3 fertig sein. Wenn ein paralleler Email-Subagent verfügbar ist: vorziehen. - **`#67 compliance-audit-export` muss vor `#68 dsgvo-bulk-ops`** abgeschlossen sein, weil beide am `AuditEvent`-Schema arbeiten. #67 etabliert die neuen Felder (`actorIp`, `regulatoryScope`, `dataSensitivity`, Hash-Chain). #68 nutzt diese Felder, um Bulk-Op-Operationen audit-trail-pflichtig zu loggen. - **`#69` bis `#73` sind voneinander unabhängig** und können von einem Polish-/Docs-Subagent parallel abgearbeitet werden. Sie touchen unterschiedliche Bereiche (Docs, Lighthouse-Config, Vite-Config, i18n-Package, axe-Tests). - **`#76 test-coverage` ist hartes Letztes**: Coverage-Sprint macht nur Sinn nachdem alle anderen Module gebaut sind, sonst veralten die Targets sofort wieder. ## Sub-Phasen-Verteilung **Email-Subagent (kann ab Phase 02 starten, parallel zu allem anderen):** - #75 React-Email Migration **Compliance-Subagent (nach Phase 09 oder parallel zur zweiten Hälfte von Phase 09):** - #67 Compliance-Audit-Export - #68 DSGVO-Bulk-Ops **Docs-/Polish-Subagent (parallel zu Compliance-Subagent):** - #69 Security-Docs - #70 Lighthouse - #71 Bundle-Budget - #72 i18n-Foundation - #73 WCAG-Internal **QA-Subagent (am Ende der Phase):** - #76 Test-Coverage ## Phase Done-Definition Diese Phase ist `completed` wenn: - [ ] Alle 9 Tasks `completed` in `PROGRESS.md` - [ ] `pnpm lint`, `pnpm typecheck`, `pnpm test` global grün; alle neuen Tests (React-Email-Snapshot, Compliance-Audit-Hash-Chain, DSGVO-Bulk-Op-Verifier, axe-Suite, Coverage-Gates) laufen in CI - [ ] React-Email-Templates ersetzen 100 % der existing transactional-Templates; `packages/mail/src/templates/transactional.ts` ist gelöscht oder reduziert auf Re-Export - [ ] AuditEvent-Schema enthält alle SOC2/HIPAA/GDPR-Felder; Hash-Chain-Verifier CLI-Command `pnpm audit:verify-chain --tenant ` grün - [ ] Per-Tenant-DSGVO-Self-Service-UI funktioniert auf Staging: Test-User exportiert eigene Daten + initiiert Lösch-Request → 30-Tage-Grace + Reactivation + finale Cascade verifiziert - [ ] Lighthouse-CI ≥ 0.95 in allen 5 Categories für die Top-10-Routes (auf Staging gemessen) - [ ] Bundle-Size-CI postet PR-Comment mit Per-Route-Sizes; alle Routes innerhalb ihrer Budgets oder bewusst dokumentierte Ausnahmen in `docs/architecture/bundle-budgets.md` - [ ] i18n-Foundation: Locale-Picker funktioniert (DE/EN umschaltbar), ICU-Plurals laufen in Storybook-Story, RTL-Smoketest passiert für 2 Test-Komponenten - [ ] axe-Coverage ≥ 80 % der Komponenten in `packages/ui-app` + `packages/ui-subframe`; keine WCAG-AA-Violations in Lighthouse-Audit - [ ] Coverage-Gates aktiv: Critical-Paths ≥ 90 %, Module ≥ 70 %, Subframe ≥ 50 %; CI fail-on-drop > 2 % - [ ] Security-Docs: `docs/security/threat-model.md`, `pen-test-scope.md`, `vulnerability-disclosure.md`, `bug-bounty.md`, `incident-response.md`, `sbom.md` alle vollständig; `SECURITY.md` verlinkt sie - [ ] `/.well-known/security.txt` deployed auf Staging und liefert die Vuln-Disclosure-Policy aus - [ ] `gsd-code-reviewer`-Subagent hat alle 9 Tasks-Commits reviewed; Findings adressiert - [ ] Phase-Summary in dieser README.md ergänzt (siehe unten) ## Phase Summary _(Wird nach Abschluss der Phase vom ausführenden Agent ergänzt.)_ ### Lessons Learned _(Wird nach Abschluss ergänzt.)_ ## Verweise - Detail-MD-Template: `../DETAIL-MD-TEMPLATE.md` - Agent-Workflow: `../AGENT-INSTRUCTIONS.md` - Execution-Order: `../00-execution-order.md` - Live-Status: `../PROGRESS.md` - Vorgänger-Phase (Authentik + Admin-SSO): `../09-authentik-admin-sso/README.md` - Nachfolge-Phase (Backlog): `../11-backlog/README.md` - Existierende Compliance-Doku: `../../compliance/gdpr.md`, `../../data-retention.md` - Existierende Security-Doku: `../../security/threat-model.md`, `../../security/runbook.md`