Verifique a acessibilidade estrutural no NextPDF Connect (Pro)

Visão geral

Execute uma análise de acessibilidade estrutural no NextPDF Connect. Use check_accessibility, verificado no provedor de ferramentas Pro, que registra new CheckAccessibilityTool() com o nome de protocolo check_accessibility. A descrição da ferramenta delimita seu escopo: ela analisa a acessibilidade estrutural de um PDF — títulos, tabelas, imagens e indicadores de ordem de leitura. A ferramenta retorna indicadores e dicas de correção. Ela não certifica conformidade com Portable Document Format/Universal Accessibility (PDF/UA) nem com Web Content Accessibility Guidelines (WCAG). Essa determinação cabe a um verificador de conformidade, como o veraPDF ou uma ferramenta de teste PDF/UA. check_accessibility é uma ferramenta de nível Pro. O NextPDF faz essa verificação com class_exists() na inicialização e a registra somente quando o pacote Pro está instalado.

Instalação

composer require nextpdf/server
composer require nextpdf/pro

Vincule um transporte e, em seguida, confirme a disponibilidade da ferramenta com diagnostic.capabilities.

Visão conceitual

Uma estrutura acessível depende de dois pontos: uma árvore de estrutura lógica de elementos de estrutura (ISO 32000-2 §14.7) e um idioma do documento declarado, definido por meio da entrada Lang do catálogo (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4). check_accessibility inspeciona esses indicadores estruturais e retorna achados com severidade e orientação de correção. Trate qualquer pontuação numérica ou valor pass/fail no relatório como um resumo de indicadores, não uma certificação. Use o relatório para triagem.

Superfície da API

Ferramenta	Nível	Função	Nível de risco
`create_pdf`, `add_text`	Core	Construir o conteúdo que será inspecionado	Seguro / Cuidado
`check_accessibility`	Pro	Análise de acessibilidade estrutural	Seguro
`output_pdf`	Core	Renderizar e retornar o PDF	Aprovação obrigatória / Revisão (base64)

Os nomes das ferramentas são os nomes de protocolo no registro. O catálogo de ferramentas é o catálogo oficial. O nível instalado determina quais ferramentas ficam disponíveis.

Exemplo de código — Início rápido

create_pdf → adicione conteúdo com add_text.
check_accessibility com o document_id.
Revise os achados: a severidade, o indicador, a página afetada e a dica de correção.
Opcionalmente, use output_pdf (base64) para revisão manual junto com o relatório.

Exemplo de código — Produção

Trate o relatório como entrada de triagem, não como veredito. Mapeie cada achado para uma correção concreta: ative a saída marcada, defina o idioma do documento e adicione estrutura de títulos. Para um portão de conformidade, execute um verificador externo. Considere esse veredito como autoritativo, não a pontuação desta ferramenta. Execute a verificação antes de chamar output_pdf com destroy: true; caso contrário, a verificação não conseguirá acessar o documento.

Casos extremos e pegadinhas

Sem conteúdo. Um documento em branco retorna um achado de ausência de conteúdo, não uma certificação.
Documento grande. Um timeout limita a análise; divida entradas grandes ou restrinja a faixa analisada.
Sessão destruída. Execute a verificação antes que a saída destrua a sessão.
Origem criptografada. Forneça a senha.
Pro ausente. Com apenas o Core, check_accessibility não é registrado.

Desempenho

O timeout definido no orçamento limita a análise. O perfil é semantic: o relatório é a saída da análise estrutural, então compare achados, não a saída em bytes.

Notas de segurança

O relatório descreve a estrutura, não informações confidenciais do conteúdo. O documento sob análise ainda pode ser sensível, então mantenha-o dentro do limite de confiança. O fluxo de análise não grava no sistema de arquivos.

Conformidade

Declaração	Especificação	Cláusula
A estrutura lógica é uma árvore de elementos de estrutura.	ISO 32000-2	§14.7
O idioma do documento é declarado por meio da entrada `Lang`.	ISO 32000-2	§14.9
O idioma natural deve ser especificado para a criação acessível.	PDF/UA-2	§8.4.4

check_accessibility relata indicadores estruturais que apoiam a criação acessível. A ferramenta não afirma conformidade com PDF/UA nem com WCAG. Essa determinação cabe a um verificador independente.

Contexto comercial

check_accessibility é uma ferramenta de nível Pro. O NextPDF a registra somente quando o pacote Pro é resolvido durante a inicialização do servidor.

Mapeamento de PDF/UA-2

Os indicadores estruturais que esta ferramenta inspeciona se alinham às necessidades de criação do PDF/UA-2: uma árvore de estrutura marcada (ISO 32000-2 §14.7) e um idioma do documento declarado (PDF/UA-2 §8.4.4). A ferramenta relata se esses indicadores estão presentes ou ausentes. Quem determina a conformidade com PDF/UA-2 é um verificador PDF/UA, não o relatório da ferramenta.

Referência cruzada de tag → ISO 32000-2 §14

Os achados de títulos e tabelas correspondem a elementos de estrutura lógica na árvore de estrutura da ISO 32000-2 §14.7. O achado de idioma corresponde à entrada Lang da §14.9. A ferramenta relata se essas âncoras estruturais estão presentes. Ela não valida todas as regras de tag da §14; essa tarefa cabe a um verificador.

Mapeamento de WCAG 2.2

Os achados de contraste e de ordem de leitura se relacionam a critérios de sucesso do WCAG, como contraste e sequência significativa. A ferramenta relata valores de indicadores, como uma relação de contraste medida. Uma alegação de conformidade com WCAG exige uma avaliação WCAG completa, que esta ferramenta não realiza nem afirma.

Disponibilidade de transporte

Transporte	Disponível	Notas
MCP (stdio)	Sim (Pro)	O relatório é um resultado de ferramenta.
REST	Sim (Pro)	O relatório é o corpo da resposta.
gRPC	Sim (Pro)	Unário; relatório na mensagem de resposta.

Nível de risco HITL

check_accessibility é Seguro (análise somente leitura) e nunca bloqueia. output_pdf para um arquivo exige Aprovação obrigatória, e o modo base64 é Revisão (níveis de risco HITL).

Envelope JSON do portão de confirmação

A análise nunca bloqueia:

{ "allowed": true }