QA-08: Barrierefreiheits-Audit (Mail, stackt auf PR #298 UX-01) #304

Closed
patrick wants to merge 0 commits from feature/qa-08-barrierefreiheits-audit into main
pull from: feature/qa-08-barrierefreiheits-audit
Owner

Barrierefreiheits-Audit der Postfach-Oberflaeche (web/mail-postfach). Baut auf UX-01s offenem Branch auf (PR #298, noch nicht gemergt) - enthaelt daher UX-01s Commits mit.

2 echte a11y-Bugs gefunden+gefixt: scrollable-region-focusable (axe, serious, fehlendes tabIndex an scrollbarem Container) und Ordnerbaum-Treeitems nicht per Tastatur aktivierbar (onClick ohne onKeyDown fuer Enter/Space).

AC1: 1 serious Verstoss -> 0 (axe, vorher/nachher, beide Themes). AC2: Tastatur real im Browser getestet (9/9), Screenreader-Stichprobe nicht moeglich (kein NVDA/VoiceOver, keine zweite Person) - dokumentierte Luecke, selbes Muster wie UX-06/UX-07. AC3: Pruefprotokoll mit priorisierten offenen Punkten.

WICHTIG fuer Merge-Reihenfolge: dieser Branch zweigt von UX-01 ab, nicht main - wer UX-01 mergt muss diese Fixes mitnehmen (diesen PR vorher/parallel mergen oder cherry-picken).

Siehe mail/docs/QA-08-PRUEFPROTOKOLL.md.

🤖 Generated with Claude Code

Barrierefreiheits-Audit der Postfach-Oberflaeche (web/mail-postfach). Baut auf UX-01s offenem Branch auf (PR #298, noch nicht gemergt) - enthaelt daher UX-01s Commits mit. 2 echte a11y-Bugs gefunden+gefixt: scrollable-region-focusable (axe, serious, fehlendes tabIndex an scrollbarem Container) und Ordnerbaum-Treeitems nicht per Tastatur aktivierbar (onClick ohne onKeyDown fuer Enter/Space). AC1: 1 serious Verstoss -> 0 (axe, vorher/nachher, beide Themes). AC2: Tastatur real im Browser getestet (9/9), Screenreader-Stichprobe nicht moeglich (kein NVDA/VoiceOver, keine zweite Person) - dokumentierte Luecke, selbes Muster wie UX-06/UX-07. AC3: Pruefprotokoll mit priorisierten offenen Punkten. WICHTIG fuer Merge-Reihenfolge: dieser Branch zweigt von UX-01 ab, nicht main - wer UX-01 mergt muss diese Fixes mitnehmen (diesen PR vorher/parallel mergen oder cherry-picken). Siehe mail/docs/QA-08-PRUEFPROTOKOLL.md. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
patrick added 7 commits 2026-10-16 09:19:28 +02:00
Erweitert mail/internal/mailapi (INT-01) um die fuer die Postfach-/
Ordneransicht noetigen Daten, die die bestehende API noch nicht lieferte:
GET /mailboxes (Ordnerbaum aus der mailbox-Facette), mailbox-Filter auf
GET /messages, sowie sender/mailbox in der Listenantwort (Grundlage fuer
Sortierung nach Absender). Reines Durchreichen bereits fertiger
mail/internal/search-Funktionen (Facets/ListByMailbox/SearchWithFilters),
keine neue Suchlogik.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Testinfrastruktur: startet den echten mailapi.Server (echte moduleauth-
Signaturpruefung) als eigenen Prozess auf einem echten TCP-Port, mit
In-Memory-Suchpersistenz und zwei synthetischen Mandanten (einer davon
mit 3000 Nachrichten fuer den Performance-Nachweis). Grundlage fuer den
Frontend-Integrationstest gegen eine echte Backend-API statt eines
fetch()-Mocks. Kein Produktivpfad.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Postfach- und Ordneransicht fuer archivierte Mails (Next.js/React/TS,
@nexarch/shl). Ordnerbaum (aus der flachen Postfachliste der Mail-API
clientseitig aufgebaut), virtualisierte Nachrichtenliste mit Sortierung
nach Datum/Absender/Betreff, Grundsuche. Aufbau nach etabliertem Muster
(web/mail-search fuer die App-Struktur, web/dms-browser fuer Ordnerbaum/
virtualisierte Liste), bewusst schlicht gehalten (Mailpit/MailHog als
Vorbild, nicht die Komplexitaet eines nativen Mailprogramms).

Automatisierte Tests je Akzeptanzkriterium, inkl. eines echten
Backend-Integrationstests (e2e/ux01.e2e.test.ts) gegen den echten
mailapi.Server (mail/cmd/mailpostfach-fixture) mit zwei Mandanten und
einem gleichnamigen Ordner — keine Mandanten-Isolationslogik wird
gemockt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
UX-01: postfach-ordneransicht
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (pull_request) Canceled after 0s
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (push) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (push) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (push) Canceled after 0s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (push) Canceled after 0s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (push) Canceled after 0s
CI / Web (dms-browser) (push) Canceled after 0s
CI / Web (pdf-viewer) (push) Canceled after 0s
CI / Web (shl) (push) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (pull_request) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (pull_request) Canceled after 0s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (pull_request) Canceled after 0s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (pull_request) Canceled after 0s
CI / Web (dms-browser) (pull_request) Canceled after 0s
CI / Web (pdf-viewer) (pull_request) Canceled after 0s
CI / Web (shl) (pull_request) Canceled after 0s
Core-Schnittstellen-Vertragstests / contract-tests (pull_request) Canceled after 0s
Supply-Chain-Scan (Go) / govulncheck (pull_request) Canceled after 0s
Mail-Pflichttest-Gate / pflichttest-gate (pull_request) Canceled after 0s
Supply-Chain-Scan (npm) / npm-audit (pull_request) Canceled after 0s
Core-Pflichttest-Gate / pflichttest-gate (pull_request) Canceled after 0s
RBAC-Rollenhierarchie-Pflichtgate / rbac-policy-invariant (pull_request) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (push) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (pull_request) Canceled after 0s
a1c9be8e6d
Pruefprotokoll: Zielwerte und Ergebnisse je Akzeptanzkriterium und
Pruefung, inkl. Abgrenzung zur Ausgangslage (Backend-API musste fuer
Ordnerbaum/Absender-Sortierung minimal erweitert werden) und offener
Einschraenkung beim manuellen Test (keine Browser-Automatisierung/kein
laufender Core-Server auf dem Entwicklungshost, daher Ersatzpruefung
ueber den echten Backend-Integrationstest).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Zwei echte a11y-Befunde aus dem Audit von web/mail-postfach behoben:
Ordnerbaum-Treeitems waren per Tastatur erreichbar, aber ohne
onKeyDown-Handler nicht per Enter/Leertaste aktivierbar; die
scrollbare Nachrichtenliste hatte keinen tabIndex (axe:
scrollable-region-focusable, serious).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Audit-Infrastruktur fuer web/mail-postfach nach dem Muster von
web/a11y-audit (mail-search-run.sh/connect-status-run.sh): neue
Testfixture mit echtem mailapi.Server + Platzhalter fuer den
Core-Modul-Token-Endpunkt (kein echter NEXARCH-Core auf dem
Testhost), Runner-Skript, echter Tastaturfluss im Browser nach dem
keyboard-flow-check.mjs-Muster aus UX-08.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
QA-08: barrierefreiheits-audit
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (push) Canceled after 0s
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (pull_request) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (push) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (push) Canceled after 0s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (push) Canceled after 0s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (push) Canceled after 0s
CI / Web (dms-browser) (push) Canceled after 0s
CI / Web (pdf-viewer) (push) Canceled after 0s
CI / Web (shl) (push) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (pull_request) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (pull_request) Canceled after 0s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (pull_request) Canceled after 0s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (pull_request) Canceled after 0s
CI / Web (dms-browser) (pull_request) Canceled after 0s
CI / Web (pdf-viewer) (pull_request) Canceled after 0s
CI / Web (shl) (pull_request) Canceled after 0s
Core-Schnittstellen-Vertragstests / contract-tests (pull_request) Canceled after 0s
Supply-Chain-Scan (Go) / govulncheck (pull_request) Canceled after 0s
Mail-Pflichttest-Gate / pflichttest-gate (pull_request) Canceled after 0s
Supply-Chain-Scan (npm) / npm-audit (pull_request) Canceled after 0s
Core-Pflichttest-Gate / pflichttest-gate (pull_request) Canceled after 0s
RBAC-Rollenhierarchie-Pflichtgate / rbac-policy-invariant (pull_request) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (push) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (pull_request) Canceled after 0s
af33c5337b
Pruefprotokoll mit Vorher/Nachher-Vergleich, Basis-Entscheidung
(Branch feature/ux-01-postfach-ordneransicht statt main), und
priorisierten offenen Punkten.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Author
Owner

Konflikt additiv geloest, 59/59 Tests gruen, direkt in main gemergt und gepusht.

Konflikt additiv geloest, 59/59 Tests gruen, direkt in main gemergt und gepusht.
patrick closed this pull request 2026-10-19 12:44:00 +02:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: scripte/nexarch#304