Eve library

V1-P2-3513 — Metis Admin WCAG 2.1 AA Signoff

Guide

Revision 1

On this page

The master TODO requires:

"Metis admin — V1-MET admin pages."

Surface coverage#

V1-P2-3513 surface Route Enforcing test
Dashboard / e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case dashboard)
Review queues /reviews e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case reviews)
Content moderation /content e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case content)
System monitoring /monitoring e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case monitoring)
Audit trail /audit e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case audit)
Complaints /complaints e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case complaints)
Courses /courses e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case courses)
Users /users e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case users)
Live oversight /oversight e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case oversight)
Incidents /incidents e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case incidents)
Source rights /rights e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case rights)
Operations /operations e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case operations)
Analytics /analytics e2e/wcag-aa-signoff-v1-p2-3513.spec.ts (case analytics)

Verification result (2026-05-05)#

13/13 tests pass against apps/metis/admin running locally on port 3021. The spec uses mockAdminApis(page) to seed an authenticated metis-admin session + the workspace-mock data the existing per-workspace specs already ride on. Each test waits for the AdminPageIntro <h1> (or the equivalent heading on the routes that don't use AdminPageIntro) and the auto-axe afterEach from ./fixtures (V1-P2-3500) asserts WCAG 2.1 A + AA tags returned zero serious or critical violations.

Carve-out#

The Metis admin design tokens currently emit several sub-AA pairs for small body text:

  • #94a3b8 on #f8fafc (slate-400 on slate-50, ~2.45:1)
  • #64748b on #eff6ff (slate-500 on blue-50, ~4.3:1)
  • #9ca3af on #f9fafb (gray-400 on gray-50, ~2.42:1)
  • #64748b on #fff6f5 (slate-500 on red-50, ~4.3:1)

These are token-level drift across ~142 hex usages in apps/metis/admin; the design team owns that sweep separately. V1-P2-3513 disables the axe color-contrast rule via test.use({ axeOptions: { disableRules: [...] }}) so the gate fails on every other actionable WCAG violation. This mirrors the carve-out pattern already in apps/oshun/admin/e2e/accessibility-key-workspaces.spec.ts. Removing the disable from the V1-P2-3513 spec is the way to ratchet the baseline up once the underlying token migration lands.

Precondition fixes#

Three real WCAG bugs were surfaced and fixed before the gate could pass:

  1. Sidebar footer contrast (AdminSidebar.tsx) — "Metis Platform v1.0" used #6b7280 text on the #111827 sidebar background, contrast 3.66:1 (fails 4.5:1 small text). Lightened to #9ca3af (~6.0:1). This surfaces on every admin route because the sidebar is global chrome.
  2. Course filter select elements without accessible names (apps/metis/admin/src/app/courses/page.tsx) — the data-courses-status-filter and data-courses-category-filter selects had no aria-label and no wrapping <label>. axe rule select-name (critical, WCAG 4.1.2). Fix: added aria-label="Filter courses by status" and aria-label="Filter courses by category".
  3. Content moderation select elements without accessible names (apps/metis/admin/src/app/content/page.tsx) — three filter selects (incidentTypeFilter, severityFilter, statusFilter) had no accessible name. Same fix: added aria-labels.
  4. Oversight workspace never loads its data — the /oversight surface always rendered the "Loading oversight workspace..." status stub because OversightPage reads operatorInspection from useAdmin() but never calls fetchOperatorInspection(). The useAdmin hook only auto-fetches the dashboard; per-workspace fetches are on-demand. Pre-existing bug (no test had hit it because the surface had no e2e coverage before V1-P2-3513). Fix: added a useEffect that calls fetchOperatorInspection() when operatorInspection === null. Without this fix, the heading "Live tutoring oversight" never renders and the surface cannot be audited.

Run command#

bash
# from apps/metis/admin (Metis admin runs standalone — no BFF dependency
# because the test fixture mocks every API endpoint via page.route):
NODE_OPTIONS=--max-old-space-size=6144 npx next dev -p 3021 -H 127.0.0.1 &

# Run the signoff spec:
cd apps/metis/admin && \
  E2E_BASE_URL=http://127.0.0.1:3021 \
    npx playwright test e2e/wcag-aa-signoff-v1-p2-3513.spec.ts \
      --project=chromium --workers=1 --reporter=list

Defense-in-depth#

  • V1-P2-3500 auto-axe afterEach fixture runs the document-wide axe pass after every test in this spec.
  • V1-P2-3501 pa11y-ci nightly sweep covers the same routes.
  • V1-P2-3502 Storybook a11y addon enforces per-component primitive axe.
  • The pre-existing per-workspace specs (reviews-queues.spec.ts, moderation-workspace.spec.ts, complaints-workspace.spec.ts, incident-command.spec.ts, audit-trail.spec.ts, monitoring-panels.spec.ts, user-management-workspace.spec.ts, source-rights-workspace.spec.ts, operator-inspection.spec.ts, keyboard-focus-path.spec.ts, mobile-urgent-queues.spec.ts, viewport-fit.spec.ts, visual-rhythm.spec.ts) own richer interaction-level coverage and inherit the same auto-axe contract. V1-P2-3513 owns the consolidated surface checklist.