Audit-Workflow

Diese Seite beschreibt den vollständigen Arbeitsablauf für eine Barrierefreiheitsprüfung mit dem Auditor — von der Eingabe bis zum Export der Ergebnisse.

Voraussetzungen

Bevor Sie ein Audit starten:

• Die zu prüfende Seite muss über HTTP oder HTTPS erreichbar sein
• Für geschützte Seiten: Zugangsdaten als Variablen hinterlegen
• Gewünschten Standard auswählen: BFSG oder WCAG

INFO

Der Auditor kann auch lokale Entwicklungsumgebungen prüfen (http://localhost:3000). Stellen Sie sicher, dass der Server läuft, bevor Sie das Audit starten.

Schritt-für-Schritt

1. URL eingeben

Tragen Sie die vollständige URL der zu prüfenden Seite ein. Der Auditor unterstützt:

• Einzelne Seiten (z. B. https://example.com/login)
• Seiten mit Anker-Navigation (z. B. https://example.com/docs#section)

2. Standard wählen

Wählen Sie aus dem Dropdown:

• BFSG — deutsches Barrierefreiheitsstärkungsgesetz
• WCAG 2.1 AA — internationaler Standard

3. Audit starten

Klicken Sie auf Audit starten. xyva führt folgende Schritte aus:

1. Seite im Headless-Browser laden
2. DOM und gerenderten Zustand analysieren
3. KI-gestützte Compliance-Engine ausführen
4. Ergebnisse nach Schweregrad gruppieren

Die Analyse dauert je nach Seitenkomplexität zwischen 5 und 30 Sekunden.

Ergebnisse lesen

Schweregrade

Schweregrad	Bedeutung	Handlungsbedarf
Kritisch	Zugang blockiert	Sofort beheben
Warnung	Nutzung beeinträchtigt	Vor nächstem Release beheben
Info	Best Practice	Bei Gelegenheit umsetzen

Finding-Details

Jedes Finding zeigt:

• Regel — z. B. WCAG 1.4.3 (Mindestkontrast)
• Element — das betroffene HTML-Element mit CSS-Selektor
• Empfehlung — konkreter Vorschlag (z. B. "Kontrast von 2,8:1 auf mindestens 4,5:1 erhöhen")

TIP

Klicken Sie auf den CSS-Selektor, um das Element in der Seitenvorschau hervorzuheben. So finden Sie die betroffene Stelle schneller.

Ergebnisse exportieren

Die Audit-Ergebnisse können in verschiedenen Formaten exportiert werden:

• PDF-Bericht — formatierter Bericht für Stakeholder und Compliance-Dokumentation
• JSON — maschinenlesbar für Weiterverarbeitung oder CI-Integration
• YouTrack-Issues — Findings direkt als Issues in YouTrack anlegen

WARNING

Speichern Sie den Bericht als Nachweis Ihrer Barrierefreiheitsprüfung. Bei behördlichen Anfragen kann dies als Dokumentation dienen.

CI-Integration

Barrierefreiheitsaudits können automatisch in Ihrer CI-Pipeline ausgeführt werden:

accessibility-audit:
  stage: test
  script:
    - npx xyva audit --url $BASE_URL --standard bfsg
  artifacts:
    paths:
      - accessibility-report.json

Bei kritischen Findings kann die Pipeline so konfiguriert werden, dass sie den Build blockiert.

Weiterführende Seiten

• Barrierefreiheit — Übersicht des Auditors
• BFSG-Konformität — Gesetzliche Anforderungen
• WCAG-Standards — Technische Grundlagen