Skip to content

millersantosbr/AcessaBR

Repository files navigation

AcessaBR

AcessaBR — A internet precisa funcionar para todo mundo

Radar aberto e comunitário de barreiras de acessibilidade digital.

Abrir o radar · Ler a metodologia · Sugerir um portal · Contribuir

Por que este projeto existe

Serviços digitais públicos e essenciais fazem parte do acesso a direitos. Uma barreira de contraste, navegação, formulário ou semântica pode impedir alguém de obter informação ou concluir uma tarefa.

O AcessaBR transforma verificações técnicas reproduzíveis em explicações humanas. O objetivo não é criar um ranking ou constranger equipes: é tornar problemas visíveis, facilitar correções e abrir espaço para validação por quem vive essas barreiras.

Coleta atual

A versão 0.2.0 monitora dez portais públicos de Alagoas:

  • Prefeitura de Maceió;
  • Portal de Serviços de Maceió;
  • Alagoas Digital;
  • Portal Alagoas;
  • Portal da Transparência de Alagoas;
  • Secretaria de Saúde de Alagoas;
  • Detran Alagoas;
  • Secretaria de Educação de Alagoas;
  • Defensoria Pública de Alagoas;
  • Tribunal de Justiça de Alagoas.

Na coleta atual, o mecanismo registrou 498 ocorrências automatizadas: 157 críticas e 341 sérias. O aumento absoluto em relação à primeira rodada acompanha a ampliação de seis para dez portais e não deve ser interpretado como piora. Esses números são indícios em páginas selecionadas, não uma declaração de conformidade do portal inteiro.

O que já funciona

  • painel público filtrável;
  • relatórios por portal em linguagem simples;
  • dados abertos em JSON e CSV;
  • histórico público das rodadas e do escopo;
  • coletor reproduzível com axe-core e Playwright;
  • execução semanal pelo GitHub Actions;
  • registro de versão, data, mecanismo e limitações;
  • fluxo para sugerir portais, validar barreiras e informar correções;
  • página pública de metodologia;
  • experiência responsiva, navegável por teclado e com redução de movimento.

O que o AcessaBR não faz

  • não concede selo de acessibilidade;
  • não calcula uma porcentagem de “site acessível”;
  • não substitui auditoria manual;
  • não afirma que zero achados automáticos significa ausência de barreiras;
  • não tenta contornar autenticação, CAPTCHA ou proteção de acesso;
  • não coleta credenciais ou dados pessoais de usuários.

Executar localmente

Requisitos:

  • Node.js 22.13 ou superior;
  • npm.
npm ci
npm run dev

O endereço local será exibido no terminal.

Executar uma nova coleta

npx playwright install chromium
npm run audit

Os arquivos site/data/audits.json e site/data/audits.csv serão atualizados. A rodada anterior será preservada em site/data/history/. Revise os resultados antes de publicar.

Validar e preparar o site

npm test

Como contribuir

Há trabalho útil para diferentes experiências:

  • pessoas com deficiência e usuárias de tecnologias assistivas: validar jornadas e linguagem;
  • comunidades locais: sugerir serviços relevantes;
  • desenvolvedores: melhorar o coletor, painel, testes e automações;
  • designers e especialistas em conteúdo: revisar visualização e explicações;
  • tradutores: ampliar o acesso ao projeto e à documentação;
  • mantenedores de portais: informar correções e ajudar a reproduzir resultados.

Leia o guia de contribuição e procure tarefas marcadas como good first issue.

Estrutura

.
├── site/                  # dashboard publicado no GitHub Pages
│   ├── data/              # JSON, CSV e rodadas anteriores
│   ├── index.html
│   ├── metodologia.html
│   ├── app.js
│   └── styles.css
├── scripts/
│   ├── audit.mjs          # coleta automatizada
│   ├── build.mjs
│   └── validate.mjs
├── docs/
│   └── METHODOLOGY.md
└── .github/workflows/     # qualidade, coleta e publicação

Metodologia e referências

A metodologia combina:

  • WCAG 2.2;
  • WCAG-EM 2.0;
  • eMAG 3.1;
  • regras automatizadas do axe-core;
  • futura validação humana documentada.

Leia docs/METHODOLOGY.md para conhecer escopo, interpretação, limitações e processo de correção.

Para comunicar o projeto sem reduzir pessoas a números, consulte as histórias por trás dos dados. O kit de lançamento reúne posts e convites prontos para redes sociais, coletivos e equipes responsáveis por portais.

O relatório da rodada está em docs/COLLECTIONS/2026-07-24-v0.2.md.

Governança e segurança

Licenças

O código é distribuído sob a Licença MIT. A base de resultados e a documentação pública são disponibilizadas sob CC BY 4.0.

Autoria

Iniciado por Miller Santos em Maceió, Alagoas.

O AcessaBR é um projeto independente e não representa os órgãos monitorados.

About

Radar aberto e comunitário de barreiras de acessibilidade digital em serviços públicos brasileiros.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages