Files
HiveGrid-Wireframes/hivegrid-cloud/docs/improvement-plan/10-compliance-polish/README.md
T

8.5 KiB

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