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 inpackages/db/prisma/schema.prismaist zu generisch — keineactorIp, keinregulatoryScope, keine Tamper-Evidence-Hash-Chain. - React-Email: Aktuelle Transactional-Templates in
packages/mail/src/templates/transactional.tssind handgeschriebenes HTML mit manuellenescapeHtml-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.mdfür Auth-Flows, nicht ganzheitlich). Vuln-Disclosure-Policy, Pen-Test-Scope, IR-Runbook fehlen oder sind nicht extern verlinkbar. - Lighthouse-Targets:
.lighthouserc.jsonläuft mit niedrigen Thresholds und nur public-route-Coverage; interne App-Routes werden nicht audited. - Bundle-Budgets:
scripts/verify-bundle-size.mjshat 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-emailkann 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-exportmuss vor#68 dsgvo-bulk-opsabgeschlossen sein, weil beide amAuditEvent-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.#69bis#73sind 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-coverageist 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
completedinPROGRESS.md pnpm lint,pnpm typecheck,pnpm testglobal 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.tsist 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 <id>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.mdalle vollständig;SECURITY.mdverlinkt sie /.well-known/security.txtdeployed auf Staging und liefert die Vuln-Disclosure-Policy ausgsd-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