Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,121 @@
# 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`