# Acessibilidade - PappAI

> O PappAI foi concebido para ser utilizável por todos. Eis o que suportamos e como comunicar eventuais problemas.

Source: https://pappai.it/pt/accessibility

## 1. Aplicação móvel (iOS e Android)

A aplicação para pacientes do PappAI é desenvolvida com SwiftUI (iOS) e Jetpack Compose (Android), frameworks que proporcionam integração nativa com os serviços de acessibilidade da plataforma.

- **VoiceOver (iOS) / TalkBack (Android)**: todos os ecrãs principais são navegáveis com o leitor de ecrã do sistema. Os elementos interativos têm rótulos descritivos.
- **Texto Dinâmico / Tamanho da Letra**: a aplicação respeita a definição de tamanho do texto do sistema, incluindo os maiores tamanhos de acessibilidade. Os esquemas adaptam-se sem cortar o texto.
- **Texto a Negrito**: a aplicação respeita a opção de acessibilidade Texto a Negrito no iOS.
- **Reduzir Movimento**: as animações de entrada e as transições são suprimidas quando a opção Reduzir Movimento está ativada nas definições do sistema.
- **Modo Escuro**: suporte total para o modo escuro com contraste suficiente tanto nos esquemas claros como escuros.
- **Controlo por Voz (iOS)**: os elementos interativos têm rótulos únicos e descritivos que permitem uma navegação fiável por voz.

Algumas funcionalidades complexas (captura de fotografias de refeições, visualização de planos em PDF) podem ter suporte de acessibilidade reduzido. Estamos a trabalhar para melhorar a cobertura em futuras atualizações.

## 2. Painel web (app.pappai.it)

O painel web do nutricionista é desenvolvido com React e componentes shadcn/ui, que seguem as normas WAI-ARIA.

- **Navegação por teclado**: todos os fluxos de trabalho essenciais são acessíveis através do teclado (Tab, Enter, teclas de seta). Os indicadores de foco estão sempre visíveis.
- **Leitores de ecrã**: os títulos, marcos (landmarks) e rótulos ARIA são utilizados de forma consistente em todos os ecrãs principais.
- **Contraste de cor**: o texto e os elementos interativos cumprem ou excedem os rácios de contraste do WCAG 2.1 Nível AA.
- **Modo Escuro**: o painel suporta a preferência de modo escuro ao nível do sistema.
- **Design responsivo**: a interface adapta-se a diferentes tamanhos de janela de visualização e a níveis de zoom do navegador até 200%.

## 3. Website público (pappai.it)

Este website público utiliza HTML semântico e é navegável com teclado e leitores de ecrã. Todas as imagens têm texto alternativo descritivo. O banner de consentimento de cookies e todos os formulários são acessíveis através do teclado.

- **Link para saltar para o conteúdo**: quem navega por teclado ou leitor de ecrã pode saltar diretamente o cabeçalho e a navegação repetidos em cada página.
- **Contraste de cor**: o texto e os elementos interativos foram verificados para cumprir ou exceder os rácios de contraste WCAG 2.1 Nível AA.
- **Estrutura semântica**: as sequências de passos usam listas ordenadas e as tabelas de dados têm cabeçalhos de linha/coluna corretos, para que um leitor de ecrã anuncie corretamente a sua estrutura.
- **Anúncios em tempo real**: conteúdo dinâmico como respostas do chat e erros de formulário é anunciado automaticamente aos leitores de ecrã.
- **Total operabilidade por teclado**: todos os controlos interativos, incluindo o widget de chat e os interruptores, podem ser utilizados e fechados sem rato.

## 4. Limitações conhecidas

Temos consciência das seguintes áreas que necessitam de melhorias:

- Os gráficos e tabelas nutricionais na aplicação móvel ainda não dispõem de descrições completas para VoiceOver/TalkBack.
- Alguns conteúdos incorporados de terceiros (visualizador de PDF) podem não ser totalmente acessíveis.
- O suporte de legendas para conteúdos de vídeo na aplicação ainda não foi implementado.

Estamos empenhados em melhorar a acessibilidade a cada versão. Se encontrar uma barreira não listada aqui, agradecemos que nos informe.

## 5. Contacte-nos

Se encontrar barreiras de acessibilidade ao utilizar o PappAI, ou se tiver sugestões de melhoria, contacte-nos:

- E-mail: [support@pappai.it](mailto:support@pappai.it): inclua "Acessibilidade" no assunto.
- Procuramos responder no prazo de 5 dias úteis e resolver as barreiras comunicadas com a maior brevidade possível.

## 6. Feedback e melhoria contínua

A acessibilidade é um compromisso permanente. Revemos e atualizamos regularmente a nossa aplicação e o nosso website com o objetivo de cumprir o WCAG 2.1 Nível AA em todas as funcionalidades. O feedback dos utilizadores é o nosso contributo mais valioso. Obrigado por nos ajudar a melhorar o PappAI para todos.