122 lines
8.5 KiB
Markdown
122 lines
8.5 KiB
Markdown
# 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 <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.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`
|