README

Native Barrierefreiheits-Prüfung, Reparatur und Überwachung direkt im Contao-Backend. Kein aufgesetztes Overlay-Pflaster, sondern im CMS verankert: prüfen → erzeugen → absichern → überwachen, plus Pflichtdokumente. Datenhoheit beim Kunden, lauffähig von Contao 4.13 bis 5.7+, PHP 8.1+, auch auf Plesk / Shared-Hosting ohne SSH.

Kurz gesagt: Ein Backend-Modul „Barrierefreiheit" findet die a11y-Probleme deiner Seite (Datenbank und echtes Frontend via axe-core), schlägt Reparaturen vor (u. a. KI-Alt-Texte, KI-Untertitel, Einfache/Leichte Sprache), liefert die BFSG-Pflichtdokumente (Erklärung + Meldekanal) und überwacht den Zustand fortlaufend mit einem ehrlichen Score.

Wichtiger Hinweis: Das Bundle ist ein Werkzeug zur Verbesserung der Barrierefreiheit. Es trifft keine Aussage über Rechts- oder BFSG/BITV-Konformität und ersetzt keine fachliche/menschliche Prüfung. KI-Inhalte sind stets Entwürfe und gehen nie automatisch live. Das Komfort-Overlay ist eine ehrliche Beigabe, kein Ersatz für echte Barrierefreiheit.

Feature-Überblick

Ein Backend-Hub „Barrierefreiheit" mit Tabs bündelt alles:

Bereich	Was es tut
Dashboard	Score-Ring (0–100, severity-gewichtet), Statistik-Karten, 3-Spalten-Trage (Erledigt / Ein-Klick / Manuell), Verlauf & Trend ▲▼, ein „Voll-Scan starten" (Datenbank + Frontend, mit Fortschrittsbalken)
Bericht	Alle Befunde mit deutscher Erklärung, konkretem Fix-Hinweis, „Auf der Seite zeigen" (Live-Highlight) und „Jetzt fixen" (Deep-Link in die Contao-Bearbeitungsmaske)
Datenbank-Linter	6 regelbasierte Checks ohne Rendering: fehlende Alt-Texte, Überschriften-Hierarchie, nichtssagende Linktexte, fehlende Formular-Labels, Seitensprache, PDF-Referenzen
Frontend-Scan	axe-core 4.10 (lokal gebündelt, kein Remote-Loader) prüft die echten, veröffentlichten Seiten im Same-Origin-iframe — findet Kontrast-, Landmark- und DOM-Probleme, die die DB nie sieht. Nur gesetzliche Pflicht (WCAG 2.x A + AA)
KI-Alt-Texte	Vision-KI erzeugt Alt-Text-Vorschläge je Sprache nur für verwendete Bilder; Redakteur bearbeitet & übernimmt; schreibt nur in leere Meta-Slots (nie überschreiben), voll rückgängig-fähig
KI-Untertitel	Whisper-Transkription von Audio/Video → VTT-Entwurf → Freigabe schreibt `.vtt` neben die Quelle und verkabelt `<track>` im Frontend automatisch
Einfache / Leichte Sprache	KI-Entwurf je Register (Einfache Sprache ~B1, Leichte Sprache ~A1); In-Place-Umschaltung im Frontend per Umschalter/Overlay; strenger Review, Sperren gegen Neu-Generierung, nie auto-live
Overlay	Optionales Komfort-Widget (~30 Funktionen: Kontrastmodi, Schriftgröße, Lese-Font/OpenDyslexic, Lesehilfe, Vorlesen, Bionic, Animationen stoppen …), jede Funktion im Backend abschaltbar
Erklärung & Meldekanal	Editor für die Barrierefreiheits-Erklärung (Pflichtdokument) + Frontend-Feedbackformular mit Backend-Posteingang und E-Mail-Benachrichtigung
PDF-Prüfung	Erkennt fehlenden Titel / fehlende Sprache / fehlende Tags in PDFs (Detektion + Anleitung, ohne die Datei zu verändern)
Monitoring	Wiederholt Prüfungen automatisch: CLI-Command, Contao-Cron (täglich) und optionaler Hook beim Speichern von Inhalten — gedrosselt, mit Score-Trend
Audit & Undo	Jede automatische Änderung wird protokolliert (wer/wann/vorher/nachher) und ist rückgängig machbar
Lizenz	Pro-Domain-Lizenzierung (eTLD+1); mehrere Domains je eigene Lizenz hinterlegbar; alle Features im Free-Tier

Installation

Composer / Contao Manager

composer require vtinnovations/a11y

Anschließend im Contao Manager bzw. per CLI die Migrationen ausführen:

vendor/bin/contao-console contao:migrate

Das legt die Tabellen tl_vta11y_* an und installiert die Frontend-Assets (vendor/bin/contao-console assets:install, vom Manager automatisch).

Ohne --with-deletes migrieren, wenn im Manager DROP-Statements anderer Pakete angezeigt werden, die du nicht ausführen willst — die 7 CREATE-Statements dieses Bundles laufen auch ohne.

Voraussetzungen

Contao 4.13 oder 5.3–5.7+
PHP 8.1+
Für KI-Funktionen: ein OpenAI- oder OpenAI-kompatibler API-Zugang (eigene Basis-URL möglich). Ohne Key/Freigabe laufen alle Nicht-KI-Funktionen.

Erste Schritte

Backend → Barrierefreiheit → Einstellungen: Lizenz-Domain + Schlüssel hinterlegen. Bei KI-Nutzung API-Key eintragen und den Schalter „Keine externen Aufrufe" deaktivieren (Standard: AN = kein Egress).
Verbindungstest ausführen (Probe-Call, respektiert den Egress-Schalter).
Dashboard → „Voll-Scan starten": Datenbank-Analyse + Frontend-Scan laufen nacheinander, der Score erscheint.
Im Bericht die Befunde abarbeiten — Ein-Klick-Fixes übernehmen, manuelle per „Jetzt fixen" in der Contao-Maske korrigieren.
Erklärung & Meldekanal ausfüllen und die beiden Frontend-Module (Erklärung + Feedback) in einer Seite einbinden.

Sicherheit & Datenschutz

Keine Klartext-Keys. API-Schlüssel verschlüsselt at rest (defuse); Encryption-Key in separater Datei (0600), nie in DB/VCS/Log/Frontend.
Egress-Kill-Switch „Keine externen Aufrufe" — standardmäßig AN. Solange aktiv verlässt kein Datenpaket den Server. Mehrschichtig erzwungen.
Keine mutierende GET-Route. Alle Schreibaktionen via POST + Request-Token, Backend-Firewall.
Datenminimierung & maskiertes Logging bei externen Aufrufen; SSRF-Guards auf Basis-URLs.
KI-Inhalte nie auto-live — Redakteur prüft und gibt frei; Meta-Daten werden nie überschrieben; alles auditiert und rückgängig machbar.

Technischer Rahmen

Package vtinnovations/a11y, Namespace VTInnovations\A11y\, DB-Prefix tl_vta11y_, Zustand in var/vta11y/.
Versions-Weichen ausschließlich über Compatibility\Compat (kein verstreutes version_compare).
KI-Provider über Ai\*-Abstraktion: OpenAI + OpenAI-kompatibel.
axe-core lokal gebündelt (MPL-2.0), kein externer Loader/Tracker.

Qualitäts-Gates

composer install
vendor/bin/phpstan analyse        # Level 8
vendor/bin/ecs --fix              # Contao Coding Standard
vendor/bin/phpunit                # Unit-Tests (gemockt, kein Netz)

Lizenz

Code: LGPL-3.0-or-later. Nutzungslizenz (Laufzeit) pro Domain über contao-plugins.de — alle Features im Free-Tier verfügbar.

Ausführliche Bedien- und Admin-Anleitung: siehe DOKUMENTATION.md.

vtinnovations/a11y

包简介

关键字：

README 文档