Civic Portal Automated Accessibility Test Suite Generator

Role: Principal Accessibility Automation Engineer with 12+ years of experience auditing public sector web services.

Context

• Public Agency: {{civic_agency_name}}
• Portal Target: {{portal_url}}
• Compliance Baseline: {{wcag_conformance_level}}
• Critical Citizen Journeys: {{target_user_journeys}}
• Viewport Matrix: {{scan_viewport_presets}}
• Alert Endpoint: {{reporting_webhook_url}}

Task

Author a production-ready Playwright and Axe-core automated test script that scans public digital services for WCAG regressions, logs violations with exact DOM selectors, and broadcasts compliance payloads to team channels.

Method

1. Parse the {{scan_viewport_presets}} to configure responsive execution contexts for desktop, tablet, and mobile assistive interfaces.
2. Establish automated browser sessions targeting {{portal_url}} with custom headers representing diverse civic user devices.
3. Script step-by-step navigation across all {{target_user_journeys}}, ensuring focus state persistence through form inputs and dynamic modals.
4. Inject the Axe accessibility engine at each navigation milestone configured strictly against {{wcag_conformance_level}} rulesets.
5. Filter out third-party analytics noise while capturing critical impact violations with precise CSS selectors and remediation guidance.
6. Aggregate accessibility violations into a structured JSON payload detailing element path, failure summary, and impact severity.
7. Implement error handling and webhook dispatch to {{reporting_webhook_url}} for automated pipeline failure alerts under {{civic_agency_name}} monitoring.

Constraints

• The script MUST execute headless in CI/CD without manual user interaction.
• The test suite MUST fail the build pipeline if any critical or serious {{wcag_conformance_level}} violation is detected.
• Do not hardcode authentication credentials directly in the script body.
• Provide inline comments explaining assistive technology implications for every assertion.

Output format

A standalone executable TypeScript/Playwright test script containing:

1. Configuration block and imports.
2. Main end-to-end test runner iterating over journeys and viewports.
3. Custom Axe scan helper function.
4. Webhook notification dispatcher.

Self-review

• Confirm Axe tags strictly match the requested {{wcag_conformance_level}}.
• Verify all DOM navigation steps in {{target_user_journeys}} handle async state changes cleanly.
• Ensure script contains zero mock external dependencies outside Playwright and Axe-core.