POC - Auditoria Continua de Acessibilidade Web

POC funcional em Node.js + TypeScript para validar viabilidade tecnica de auditoria automatizada de acessibilidade.

O que faz

• Recebe uma URL via CLI.
• Executa auditoria com:
  • Lighthouse (categoria accessibility)
  • axe-core via Playwright
  • W3C Nu Validator (opcional, quando a API estiver acessivel)
  • W3C CSS Validator (opcional, quando a API estiver acessivel)
• Detecta tecnologias assistivas brasileiras:
  • VLibras
  • Hand Talk
• Consolida achados em um unico objeto estruturado com:
  • severidade normalizada
  • mapeamento simplificado eMAG
  • recomendacoes resumidas
• Gera saida:
  • JSON (report.json)
  • HTML simples (report.html)
  • resumo legivel no terminal

Requisitos

• Node.js 20+

Instalacao

npm install
npx playwright install chromium

Uso

npm run audit -- https://www.gov.br

Opcoes:

• --no-w3c desativa validacao W3C
• --json ./saida/meu-relatorio.json altera caminho do JSON
• --html ./saida/meu-relatorio.html altera caminho do HTML

Exemplo completo:

npm run audit -- https://www.gov.br --json ./reports/report-gov.json --html ./reports/report-gov.html

Estrutura

src/
  auditors/
    axe-auditor.ts
    lighthouse-auditor.ts
    w3c-auditor.ts
  config/
    emag-mapping.ts
    enrichment.ts
  handlers/
    auth-handler.ts
  mappers/
    emag-mapper.ts
  reporters/
    html-reporter.ts
    json-reporter.ts
    report-generator.ts
    terminal-reporter.ts
  consolidator.ts
  index.ts
  types.ts

Observacoes

• O mapeamento eMAG desta POC e simplificado por palavras-chave.
• Para uso produtivo, recomenda-se evoluir para mapeamento formal por regra WCAG/eMAG e incorporar historico para auditoria continua.