Files
HiveGrid-Wireframes/hivegrid-cloud/docs/improvement-plan/11-backlog/wcag-external-cert.md
T

8.2 KiB

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.)