Declaração de acessibilidade
O Alcometer.org compromete-se a tornar a calculadora de alcoolemia e as ferramentas de ressaca, linha de recuperação e hidratação acessíveis ao maior número possível de pessoas, incluindo pessoas com diferenças visuais, motoras, auditivas, cognitivas ou neurológicas.
Objetivo de conformidade
O objetivo é cumprir as Web Content Accessibility Guidelines (WCAG) 2.2 no nível AA, publicadas pelo W3C. Este objetivo é coerente com a norma EN 301 549 e com o European Accessibility Act, mantendo WCAG 2.1 AA como patamar mínimo de compatibilidade.
O repositório inclui uma baseline executável com axe-core e Puppeteer sobre as principais páginas da ferramenta Alcometer. Esta baseline ajuda a identificar regressões e a documentar correções antes do gate final de lançamento.
As limitações conhecidas são indicadas abaixo e estão a ser corrigidas antes de o gate de acessibilidade passar de informativo a bloqueante.
Cobertura dos testes automatizados
O projeto executa npm run test:alcometer:a11y: constrói o site, inicia Astro preview, abre o conjunto principal de páginas em inglês, injeta axe-core através de @axe-core/puppeteer e verifica as tags wcag2aa e wcag22aa.
A baseline atual está guardada em test/a11y-baseline.json; o relatório mais recente é escrito em reports/a11y-run.json. A baseline acompanha problemas sérios e críticos para que commits posteriores possam demonstrar ausência de regressões.
O job de acessibilidade no GitHub Actions é intencionalmente não bloqueante até à fase final de lançamento e carrega a baseline e os relatórios como artefactos de revisão.
O que isto significa na prática
• Os controlos interativos devem usar elementos HTML nativos sempre que possível, com indicadores de foco visíveis e operação por teclado.
• Gráficos SVG, canvas ou visualizações equivalentes devem oferecer texto ou tabela alternativa quando transportam informação.
• Diálogos devem preservar a ordem de foco e oferecer um caminho claro para quem não pretende continuar.
• A língua do documento é declarada em cada página gerada através do atributo <html lang>.
Limitações conhecidas
A primeira baseline axe-core pode ainda conter problemas sérios ou críticos já documentados e tratados em commits posteriores. Antes da fase final, o runner bloqueia regressões contra a baseline em vez de declarar ausência total de problemas.
Algumas visualizações de dados incluem tabelas para leitores de ecrã, mas certas etiquetas de gráficos e a paridade entre idiomas ainda exigem revisão manual com tecnologias assistivas.
As línguas da direita para a esquerda ainda não têm layouts RTL dedicados; quando necessário, o conteúdo usa a estrutura LTR disponível.
Como testamos
• Testes automáticos: axe-core via @axe-core/puppeteer em Astro preview, com escopo nas tags wcag2aa e wcag22aa.
• Relatório de regressão: reports/a11y-run.json.
• Baseline congelada: test/a11y-baseline.json.
• A revisão manual continua necessária para fluxo por teclado, texto para leitores de ecrã, clareza cognitiva, zoom e regressões visuais.
As ferramentas automáticas detetam apenas parte da conformidade WCAG. Antes do lançamento é necessária revisão humana, em especial na calculadora, no gate de conformidade e nas páginas ricas em gráficos.
Comentários e contacto
Se encontrar uma barreira de acessibilidade — texto alternativo em falta, bloqueio por teclado, problema de contraste, ordem de foco pouco clara ou outro obstáculo — contacte-nos.
Email: alcometer@wp.pl
Morada: Piotr Zieminski, Kalonka 71a, Polónia
Inclua, se possível: (1) o URL onde ocorre o problema, (2) uma breve descrição da barreira, (3) a tecnologia assistiva utilizada, se aplicável.
Aplicação e reclamações
Se a resposta não for satisfatória, pode contactar a autoridade nacional competente ao abrigo do European Accessibility Act. Na Polónia, a autoridade competente é o Urząd Komunikacji Elektronicznej (UKE, https://www.uke.gov.pl/).
Preparação da declaração
Esta declaração foi atualizada em 25 de abril de 2026, após a introdução da baseline axe-core e do job CI de acessibilidade não bloqueante.
Próxima revisão prevista: 25 de abril de 2027, ou antes se houver alterações materiais aos templates, à interface da calculadora ou às ferramentas de acessibilidade.