Palestra / Aula / Workshop

Quality Gate de Acessibilidade: Garantindo a WCAG 2.2 com IA Generativa e Cypress no CI/CD

Por Prof/Facilitador/Palestrante Angelo Dias - Analista e Professor

Objetivo

Construir uma jornada prática e aplicada de validação de acessibilidade digital focada em automatizar a pipeline de CI/CD assistida por IA.

Introdução

Bom dia, boa tarde e boa noite MEU POVO!
Nesta prática, vamos entender como auditar acessibilidade de forma estática na pipeline e dinâmica no DOM, com apoio de automações e inteligência artificial.

O fluxo combina validação técnica, testes BDD e análise contextual do conteúdo renderizado para aumentar a confiança na qualidade de produtos digitais acessíveis sem a necessidade de ação humana.

Pré-requisitos

Ferramentas necessárias

  • Node.js (v20+)
  • Git / GitHub(Actions)
  • VSCode
  • Antigravity IDE

Preparação sugerida

Tenha o ambiente configurado com dependências instaladas e acesso ao repositório de exemplos para acompanhar cada etapa da demonstração.

Links e repositórios

Repositório: QaFé Academy - Lab qafeally

Repositório do Laboratório de Acessibilidade "qafeally" do QaFé Academy.

Acessar qafeally.git (GitHub)

Repositório do Motor de auditoria - Cypress/Cucumber com IA

Fluxo com Cypress, BDD e integração com IA para auditoria dinâmica da interface.

Acessar a11y-cypress-ia.git (GitHub)

Material de apoio

PDF da apresentação para acompanhar a palestra com mais contexto.

Scripts importantes

Prompt da auditoria

Atue como um Auditor Sênior de Acessibilidade Digital (WCAG 2.2).
Avalie o seguinte código HTML e verifique rigorosamente:
1. Elementos interativos: Se existirem <div> ou <span> atuando como botões (com onclick) no lugar de tags <button>, isso é uma violação crítica.
2. Imagens: Imagens devem ter atributos 'alt' descritivos e úteis.
3. Contraste: Textos em tons muito claros sobre fundos brancos (ex: #cccccc sobre #ffffff) são violações críticas.

Regras de Saída (Siga rigorosamente):
- Se encontrar ALGUMA das violações acima, inicie sua resposta EXATAMENTE com a string: [VIOLAÇÃO CRÍTICA]. Depois, explique brevemente o porquê.
- Se o código estiver semanticamente correto, com bom contraste e estruturado, inicie sua resposta EXATAMENTE com a string: [ACESSÍVEL]. Depois, elogie a estrutura.

Código HTML:
${htmlContent}

Script da esteira

name: Gemini A11y Auditor

on:
  pull_request:
    branches:
      - main

jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout do código
        uses: actions/checkout@v3

      - name: Configurar Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '20'

      - name: Instalar Dependências
        run: npm install

      - name: Executar Auditoria com Gemini API
        env:
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
        run: npm run test:a11y