Manual de implantação e uso

1. Visão geral

O AcessaWeb é um serviço em nuvem (SaaS) com dois componentes:

• Widget de acessibilidade: um botão no site que abre um menu de ajustes de visualização, leitura e navegação. Ele é carregado por uma única linha de código e não altera o conteúdo das páginas.
• Painel de gestão (/admin/): configuração de cada site, acompanhamento do uso, diagnóstico de acessibilidade das páginas (eMAG/WCAG), relatórios, chamados de suporte e níveis de serviço.

Cada site contratado tem uma chave própria e só funciona nos domínios cadastrados para ela. O widget é um recurso complementar: não substitui as correções de acessibilidade no código das páginas, que o diagnóstico ajuda a encontrar.

2. Implantação no site

1. Entre no painel, abra Sites e widgets e escolha o site.
2. Copie o código da seção Instalação. Ele tem este formato: <script src="https://acessaweb.nabram.com.br/widget.js" data-site="CHAVE_DO_SITE" defer></script>
3. Cole a linha antes do fechamento da tag </body> no modelo (template) comum a todas as páginas. Em gerenciadores de conteúdo, use o campo de scripts do rodapé ou o arquivo de tema do rodapé.
4. Publique e abra o site: o botão de acessibilidade aparece no canto definido na configuração. Use o botão Testar widget do painel para ver o comportamento antes de publicar.

Domínios autorizados

Informe um domínio por linha. tce.ms.gov.br autoriza só esse endereço; *.tce.ms.gov.br autoriza também todos os subdomínios (www, portal etc.). Em qualquer outro endereço o widget não é exibido.

Política de segurança de conteúdo (CSP)

Se o site envia o cabeçalho Content-Security-Policy, autorize https://acessaweb.nabram.com.br em script-src, connect-src e font-src.

Botão próprio do site

Para abrir o menu a partir de um botão do próprio site, adicione o atributo data-acessaweb-open ao elemento. Se quiser esconder o botão flutuante, marque Ocultar botão flutuante na configuração. Também estão disponíveis as funções AcessaWeb.open(), AcessaWeb.close() e AcessaWeb.reset().

Navegadores

Testado nas versões atuais de Chrome, Edge e Firefox, em computador e em celular. Em telas pequenas, o menu abre como painel inferior em tela cheia.

3. Configuração do widget

Em Sites e widgets › Configurar, o administrador define:

• posição do botão (seis opções), distância das bordas, tamanho e cor principal;
• idioma da interface (português, inglês ou espanhol);
• quais recursos ficam disponíveis aos visitantes;
• atalho de teclado Alt+Shift+A para abrir e fechar o menu;
• link para a declaração de acessibilidade do órgão;
• percentual de visitas em que o diagnóstico automático é executado;
• ativação ou desativação do widget.

As alterações chegam aos sites em até 5 minutos, sem mexer no código das páginas.

4. Recursos para o visitante

As escolhas ficam salvas só no navegador do visitante e valem em todas as páginas do site. O botão Redefinir volta tudo ao padrão. O menu é um diálogo acessível: abre com foco no conteúdo, fecha com Esc e funciona com leitores de tela.

5. Uso, diagnóstico e relatórios

• Uso: carregamentos do widget, aberturas do menu, sessões com recursos ativos, recursos e perfis mais usados, dispositivos e páginas mais acessadas, por período (7, 30, 90 ou 365 dias).
• Diagnóstico: 15 verificações automáticas com referência WCAG e eMAG (idioma, título, texto alternativo, rótulos de formulário, contraste, hierarquia de títulos, entre outras), com pontuação por página, lista de problemas e evolução.
• Evidências: todos os relatórios podem ser impressos ou salvos em PDF pelo botão Imprimir relatório e exportados em CSV. O Registro de atividades guarda quem fez cada alteração no painel.

6. Usuários e perfis

• Leitor: consulta relatórios e abre chamados (indicado para fiscais técnicos).
• Administrador: também altera configurações e usuários. Administradores do órgão fazem a fiscalização: autorizam janelas de manutenção e decidem exclusões do indicador de prazo.
• Equipe de suporte: perfil da fornecedora; atende os chamados e registra manutenções.

Senhas têm no mínimo 10 caracteres, com letras e números, e cada usuário pode alterá-la em Minha conta.

7. Suporte técnico e chamados

Abra chamados em Suporte › Abrir chamado. Cada chamado recebe um protocolo (CH-AAAA-NNNNN) e guarda todo o histórico de mensagens, mudanças de situação, responsável e prazos. Quando o problema é resolvido, o solicitante confirma o encerramento ou reabre o chamado e avalia o atendimento de 1 a 5.

Prazos em horas são corridos. Prazos em dias úteis vencem na mesma hora do dia útil correspondente, sem contar fins de semana e feriados nacionais, de Mato Grosso do Sul e de Campo Grande. Outros canais: WhatsApp (35) 99871-1538, de segunda a sexta, das 8h às 18h (horário de Brasília); incidentes críticos são atendidos 24 horas por dia.

8. Níveis de serviço e disponibilidade

Um monitor verifica a cada minuto, pelo endereço público, se o widget, a API e o painel respondem corretamente. A situação atual e o histórico de 90 dias ficam na página pública Status do serviço.

Em Níveis de serviço, o relatório mensal mostra:

• Disponibilidade = 100 × (minutos medidos − minutos indisponíveis) ÷ minutos medidos. Meta: 99,5% ao mês.
• Chamados no prazo = percentual de chamados com início do atendimento e solução dentro dos prazos. Meta: 90% ao mês.
• tempos médios de atendimento e de solução, satisfação média, ocorrências de indisponibilidade e janelas de manutenção.

Janelas de manutenção são registradas pela fornecedora com antecedência, mas só deixam de contar como indisponibilidade depois de autorizadas por um administrador do órgão.

9. Privacidade (LGPD) e segurança

• O widget não usa cookies e não grava IP, identificadores ou dados pessoais dos visitantes. O servidor guarda apenas contagens diárias agregadas e o caminho das páginas; trechos que parecem identificadores são agrupados.
• O diagnóstico envia só seletores técnicos dos elementos com problema, nunca o texto das páginas.
• Dados agregados são apagados automaticamente após 24 meses.
• Painel com senhas protegidas por scrypt, sessão em cookie seguro, proteção contra requisições forjadas, limite de tentativas de login, política de segurança de conteúdo e registro de atividades.
• Cópia de segurança diária do banco de dados.

10. Encerramento e reversibilidade

Para retirar a solução, basta remover a linha do script do modelo do site: nenhuma página fica alterada. Antes do encerramento, use Sites e widgets › Exportar dados completos (JSON) para obter a configuração e todo o histórico de uso e de diagnóstico, e Níveis de serviço › Exportar chamados (CSV) para o histórico de suporte.