Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,124 @@
|
||||
# WCAG-2.2-AA Externe Zertifizierung
|
||||
|
||||
**Status:** `backlog: Enterprise-Sales-Pipeline besteht auf zertifizierter Accessibility-Compliance (z.B. öffentlicher Sektor, EU-Public-Body-Tender, Konzern-Procurement mit BITV-Pflicht)`
|
||||
**Task-ID:** #74
|
||||
**Phase:** 11 (Backlog)
|
||||
**Estimated Effort:** 3-4 Wochen Fix-Sprint + €5-15k externe Audit-Kosten wenn aktiviert
|
||||
**Owner:** unassigned
|
||||
|
||||
## Problem
|
||||
|
||||
`wcag-internal.md` aus Phase 10 stellt sicher, dass die Boilerplate technisch WCAG-2.2-AA-konform ist (axe-CI, Storybook-A11y-Addon, eigene Audits). Das reicht für die meisten Sales-Situationen. Sobald ein Kunde aber eine **formale WCAG-Konformitätserklärung** oder einen **VPAT-Report** (Voluntary Product Accessibility Template) verlangt — typisch bei Behörden, EU-Public-Body-Tendern oder Konzern-Procurement — braucht es einen externen, zertifizierten Audit.
|
||||
|
||||
Vorab-Aktivierung lohnt nicht, weil:
|
||||
|
||||
- Externe Audits sind teuer (€5-15k)
|
||||
- Sie müssen jährlich reauditiert werden (laufende Kosten)
|
||||
- Ohne konkreten Kunden-Anker ist der ROI negativ
|
||||
|
||||
## Depends on
|
||||
|
||||
- `../10-compliance-polish/wcag-internal.md` — **harte Pre-Work-Voraussetzung**: interner Audit muss durch sein, sonst werden ~€10k externe Audit-Kosten für Findings verbrannt, die wir vorher selber hätten fixen können
|
||||
- `../10-compliance-polish/i18n-foundation.md` — Sprach-Attribute (`lang="..."`) müssen korrekt gesetzt sein (WCAG-Erfolgskriterium 3.1.1/3.1.2)
|
||||
- `../10-compliance-polish/lighthouse.md` — A11y-Score 100 als CI-Gate ist schon erzwungen
|
||||
|
||||
## Blocks
|
||||
|
||||
- nichts (Backlog-Item, blockt keine aktive Roadmap)
|
||||
|
||||
## Approach
|
||||
|
||||
**Externer Audit-Provider + Fix-Sprint + Re-Test + Certificate.** Begründung gegen Alternativen:
|
||||
|
||||
- *Selbstdeklarierte WCAG-Konformitätserklärung*: für viele Behörden + Konzern-Procurement nicht ausreichend, sie verlangen externe Bestätigung. Verworfen für diesen Use-Case.
|
||||
- *Nur Lighthouse-Score reportieren*: deckt nur ein Subset von WCAG ab (~30%), nicht ausreichend als „WCAG-AA-zertifiziert". Verworfen.
|
||||
|
||||
**Provider-Optionen (Auswahl beim Aktivieren):**
|
||||
|
||||
- **BFW Würzburg** (DE, BITV-Erfahrung, Deutsch + Englisch)
|
||||
- **Inclusive Strategies** (UK/EU, gute Brand)
|
||||
- **Deque Systems** (US/global, axe-Maintainer, höchste Preise aber höchste Brand-Anerkennung)
|
||||
|
||||
**Deliverables eines Audits:**
|
||||
|
||||
- VPAT 2.4 Report (für US-Customer-Relevanz, „Section 508-konform"-Sprache)
|
||||
- WCAG-2.2-AA-Conformance-Report
|
||||
- Liste aller Issues mit Severity + Remediation-Empfehlung
|
||||
- nach Fix-Sprint: Re-Test mit aktualisiertem Report
|
||||
- Certificate (Audit-Provider-spezifisches Dokument, kein offizielles Siegel — WCAG hat keine staatlich anerkannte Zertifizierung, nur Audit-Berichte)
|
||||
|
||||
**Re-Audit-Zyklus:** jährlich, weil größere App-Änderungen die Konformität brechen können. Pflicht zur Aufnahme in jährliche Compliance-Roadmap.
|
||||
|
||||
## Implementation Steps
|
||||
|
||||
1. **Pre-Work-Verify** — sicherstellen dass `wcag-internal.md` `completed`, axe-CI 0 Errors für 30 Tage stabil, Lighthouse-A11y-Score 100 in PROD. Commit: `11-backlog/wcag-external-cert: pre-audit baseline verification`
|
||||
2. **Provider-Auswahl + Beauftragung** — Angebote einholen, Scope definieren (welche Seiten/Flows werden auditiert: Marketing-Site + Auth-Flow + App-Hauptpfade + Admin-Panel?), Vertrag. Commit: `11-backlog/wcag-external-cert: audit scope definition`
|
||||
3. **Audit-Durchlauf vorbereiten** — Test-Tenant + Test-Accounts für Auditoren bereitstellen, Demo-Daten seeden, Audit-Account-Credentials sicher übergeben. Commit: `11-backlog/wcag-external-cert: audit test environment`
|
||||
4. **Externe Audit-Phase abwarten** (1-2 Wochen) — keine App-Änderungen am audited Scope, Auditoren stellen Rückfragen
|
||||
5. **Findings-Triage** — Initial-Audit-Report bekommen, Findings nach Severity klassifizieren (Critical/Major/Minor), Fix-Plan aufstellen. Commit: `11-backlog/wcag-external-cert: findings triage`
|
||||
6. **Fix-Sprint** — Critical + Major in 2-3 Wochen fixen, Minor priorisieren. Pro Fix: dedizierter Commit `11-backlog/wcag-external-cert: fix <issue-id> <kurzbeschreibung>`
|
||||
7. **Re-Test-Audit** — Auditor verifiziert Fixes, finaler Report. Commit: `11-backlog/wcag-external-cert: incorporate re-audit findings`
|
||||
8. **Doku + Veröffentlichung** — `docs/compliance/accessibility-statement.md` (öffentliche Erklärung mit Audit-Datum, Provider, Scope, Ausnahmen), VPAT-Report als PDF im Repo + auf Website downloadbar. Commit: `11-backlog/wcag-external-cert: accessibility statement + vpat publication`
|
||||
9. **Jahres-Re-Audit-Reminder** — Calendar-Reminder + Issue-Template für `re-audit-YYYY` in 11 Monaten. Commit: `11-backlog/wcag-external-cert: re-audit reminder`
|
||||
|
||||
## Test Requirements
|
||||
|
||||
- **Pre-Audit-Tests:** axe-CI 0 Errors, Lighthouse-A11y 100, Storybook-A11y-Addon 0 Errors auf allen Komponenten — alles aus `wcag-internal.md` schon erzwungen
|
||||
- **Fix-Sprint-Tests:** pro Fix entsprechender Regression-Test (oft RTL/Playwright mit `@axe-core/playwright` assertion auf der betroffenen Seite)
|
||||
- **Re-Audit-Verifikation:** alle Major+Critical-Issues vom Audit-Report müssen mit verlinktem Fix-Commit + Test geschlossen sein
|
||||
- **Coverage-Target:** keine % — qualitativ: jedes Audit-Finding hat einen verlinkten Fix + Regression-Test
|
||||
- **Test-Files:** neben Source, plus `apps/web/playwright/accessibility/` für audit-driven E2E-Tests
|
||||
|
||||
**NICHT als completed markieren bevor Re-Audit-Report sauber ist.**
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [ ] Pre-Work-Voraussetzungen verifiziert: `wcag-internal.md` `completed`, axe-CI clean
|
||||
- [ ] Externer Audit von zertifiziertem Provider durchgeführt, Initial-Report vorhanden
|
||||
- [ ] Alle Critical + Major Findings im Fix-Sprint behoben, mit verlinkten Commits + Regression-Tests
|
||||
- [ ] Re-Audit-Report bestätigt WCAG-2.2-AA-Konformität für definierten Scope
|
||||
- [ ] VPAT-2.4-Report als PDF im Repo (`docs/compliance/vpat-YYYY.pdf`) + auf Website downloadbar
|
||||
- [ ] `docs/compliance/accessibility-statement.md` mit Audit-Datum, Provider, Scope, dokumentierten Ausnahmen
|
||||
- [ ] Jahres-Re-Audit als Reminder-Issue im Backlog
|
||||
- [ ] Tests grün (alle Audit-driven Regression-Tests dauerhaft im CI)
|
||||
- [ ] Progress-Log + PROGRESS.md aktualisiert
|
||||
|
||||
## Rollback Strategy
|
||||
|
||||
- Externer Audit ist nicht rollbackbar (Report existiert), aber:
|
||||
- Wenn nach Audit größere App-Änderungen die Konformität brechen, muss `accessibility-statement.md` ehrlich aktualisiert werden („Konformität gilt für Stand DD.MM.YYYY, neue Features X/Y werden im nächsten Re-Audit YYYY+1 erfasst")
|
||||
- VPAT-Report bleibt mit Datum versehen — keine nachträgliche Manipulation
|
||||
- Im Notfall (entdeckter kritischer A11y-Regress nach Veröffentlichung): VPAT-Report mit „Bekannte Issues"-Anhang ergänzen, Fix-Sprint starten, kein Re-Audit nötig wenn Provider zustimmt
|
||||
|
||||
## Security Notes
|
||||
|
||||
- Audit-Account-Credentials sicher übergeben (Bitwarden-Share, kein Email)
|
||||
- Audit-Test-Tenant nach Audit löschen (kann Demo-Daten enthalten, die mit echten Customer-Daten verwechselbar sind)
|
||||
- VPAT-Report öffentlich publishen ist OK — enthält keine sicherheitsrelevanten Details
|
||||
- Audit-Provider-Vertrag sollte NDA-Klauseln enthalten (Audit-Findings sind temporäre Schwächen — public Disclosure vor Fix wäre suboptimal)
|
||||
|
||||
## Subagent Recommendations
|
||||
|
||||
- **Planning:** `Plan`-Subagent mit Wahl des Audit-Providers (Vergleich Preise/Reputation/Region)
|
||||
- **Research:** `Explore`-Subagent für VPAT-2.4-Template-Best-Practices und Beispiel-Accessibility-Statements anderer SaaS
|
||||
- **Implementation (Fix-Sprint):** ein `general-purpose`-Subagent pro Finding-Severity-Block
|
||||
- **Tests:** separater `general-purpose`-Subagent für `@axe-core/playwright`-Regression-Tests
|
||||
- **Verification:** Re-Audit ist die externe Verifikation — kein interner Verifier-Subagent nötig
|
||||
- **Code-Review:** `gsd-code-reviewer` nach jedem Fix-Sprint-Block
|
||||
|
||||
## Staging-Deployment-Steps
|
||||
|
||||
1. Branch `agent/11-backlog-wcag-external-cert` pushen
|
||||
2. Audit-Test-Tenant auf Staging anlegen mit repräsentativen Demo-Daten
|
||||
3. Audit-Account-Credentials an Provider übergeben
|
||||
4. Während Audit: Staging-Branch eingefroren, keine Deploys außer kritische Security-Fixes
|
||||
5. Nach Fix-Sprint: Re-Audit-Run auf gleichem Staging-Branch
|
||||
6. Nach Re-Audit-Confirm: Merge auf main, Production-Deploy, VPAT auf Website veröffentlichen
|
||||
|
||||
## Deviations from Plan
|
||||
|
||||
_(Wird vom ausführenden Agent gefüllt.)_
|
||||
|
||||
## Progress Log
|
||||
|
||||
_(Wird vom ausführenden Agent gefüllt.)_
|
||||
Reference in new issue
Block a user