Manual do Gestor — Aprovações ABN

Acesso ao Painel Administrativo

Acesse /admin/login no navegador
Informe seu e-mail e senha de administrador
Clique em Entrar

O primeiro administrador é criado via linha de comando. Administradores subsequentes podem ser criados no próprio painel.

Dashboard

Ao entrar no painel, o dashboard exibe um resumo geral e a lista de aprovações abertas no momento:

Abertas Aprovações em andamento

Rascunhos Aprovações não publicadas

Encerradas Votações já finalizadas

Votos hoje Votos registrados no dia

Abaixo dos contadores, o painel lista todas as aprovações abertas com o número de participantes. O menu lateral dá acesso rápido a todas as funcionalidades.

Criar uma Aprovação

No menu, clique em Aprovações → Criar
Preencha o título da aprovação
Adicione uma descrição com instruções para os votantes
Defina a data limite da votação (opcional)
Configure a visibilidade dos resultados (padrão: após encerrar)
Adicione as pautas diretamente no formulário (seção inferior)
Clique em Salvar alterações

Status da aprovação

Status	Descrição
Rascunho	Recém-criada. Não visível para votantes. Pode ser editada livremente.
Aberta	Aberta para votação. Não pode ser editada (exceto data limite).
Encerrada	Votação finalizada. Resultados disponíveis.
Cancelada	Aprovação cancelada. Votos registrados são mantidos como registro.

Uma aprovação só pode ser publicada se possuir pelo menos uma pauta.

Gerenciar Pautas

Pautas são os itens que serão votados dentro de uma aprovação.

Adicionar pautas

Pautas podem ser adicionadas de duas formas:

Dentro do formulário da aprovação — ao criar ou editar uma aprovação em Rascunho, role até a seção Pautas no final do formulário e clique em Adicionar item
Via menu Pautas — no menu lateral clique em Pautas → Adicionar Pauta e selecione a aprovação relacionada

Em ambos os casos, preencha o título, a descrição e a ordem de exibição de cada pauta.

Opções de voto

Cada pauta oferece as seguintes opções de voto:

Aprovado Rejeitado Abstenção

Publicar uma Aprovação

Certifique-se de que a aprovação possui pelo menos uma pauta
Na lista de aprovações, clique na ação Publicar
Confirme a publicação
O sistema gera automaticamente o link de votação e o QR Code

Após a publicação

A aprovação passa para o status Publicada
Os títulos e descrições de pautas não podem mais ser editados
A data limite ainda pode ser ajustada
Use o link ou QR Code para divulgar a votação aos associados

Dica: Copie o link curto gerado ou baixe o QR Code para enviar via e-mail, WhatsApp ou redes sociais.

QR Code e Link de Votação

Após publicar uma aprovação, o sistema gera automaticamente um link curto e um QR Code para facilitar o acesso dos votantes. Você os encontra na tela de Resultados da aprovação.

Como acessar

Na lista de aprovações, clique no botão Resultados da aprovação publicada
No topo da tela de resultados, você verá o link curto (ex.: /a/xK9p3M) e o QR Code no canto superior direito
Clique em Copiar Link para copiar o endereço completo para a área de transferência
Para salvar o QR Code como imagem PNG, acesse diretamente a URL /admin/aprovacao/{id}/qrcode.png ou clique com o botão direito na imagem e escolha Salvar imagem

Onde está o QR Code na tela

O QR Code fica no quarto card do painel de resumo, no canto superior direito da tela de Resultados. Ele só aparece quando a aprovação possui um link curto gerado (ou seja, após a publicação).

Como usar para divulgar

Link curto
Copie e envie por e-mail, WhatsApp ou publique nas redes sociais

QR Code
Salve a imagem e projete em telão, imprima em cartazes ou envie por WhatsApp

Dica para assembleias presenciais: projete o QR Code em uma tela grande para que todos os presentes possam escanear com o celular e votar na hora.

Acompanhar Resultados

Os resultados podem ser acompanhados em tempo real no painel administrativo.

Visualização

No menu, clique em Resultados
Selecione a aprovação desejada
Veja os votos por pauta: barra de progresso, contagem e percentuais

Informações disponíveis

Dado	Descrição
Votos por opção	Contagem e percentual de cada opção
Total de votos	Número de associados que já votaram
Gráfico de barras	Representação visual dos resultados
Status	Opção vencedora destacada

Os resultados públicos só ficam acessíveis para votantes após o encerramento da aprovação.

Exportar Dados

Os dados de votação podem ser exportados para análise ou arquivamento.

Formatos disponíveis

PDF
Relatório formatado para impressão

CSV
Dados tabulares para planilhas

Como exportar

Na tela de Resultados, selecione uma aprovação
Clique no botão Exportar PDF ou Exportar CSV
O arquivo será gerado e baixado automaticamente

Conteúdo do relatório

Dados da aprovação (título, descrição, período)
Resultados consolidados por pauta
Lista de votantes com nome e categoria (no CSV)
Data e hora de cada voto

Os CPFs dos votantes não são exportados. O sistema armazena apenas o hash do CPF, garantindo a privacidade.

Notificações

O sistema permite enviar notificações individuais aos associados sobre aprovações disponíveis.

Canais de notificação

WhatsApp
Via Twilio API (template aprovado)

E-mail
Via Symfony Mailer (SMTP)

Enviar notificação

Na tela de Resultados da aprovação publicada, role até o painel Enviar Notificação
Selecione o canal: E-mail ou WhatsApp
Informe o endereço de e-mail ou o número de telefone do destinatário
Clique em Enviar

Para WhatsApp, é necessário ter um template de mensagem aprovado na conta Twilio e configurar as variáveis de ambiente TWILIO_SID, TWILIO_TOKEN e TWILIO_WHATSAPP_FROM.

Encerrar ou Cancelar

Encerrar uma aprovação

Na lista de aprovações, clique na ação Encerrar
Confirme o encerramento
A aprovação muda para Encerrada
Os resultados ficam disponíveis publicamente

Cancelar uma aprovação

Na lista de aprovações, clique na ação Cancelar
Confirme o cancelamento
A aprovação muda para Cancelada

Encerrar publica os resultados. Cancelar invalida a aprovação. Ambas as ações são irreversíveis.

Gerenciar Administradores

Administradores são os usuários com acesso ao painel de gestão.

Criar novo administrador

No menu, clique em Administradores → Criar
Preencha o e-mail e a senha
Clique em Salvar

Via linha de comando

                php bin/console app:create-admin admin@example.com senha123
            

Útil para criar o primeiro administrador ou scripts de deploy.

Auditoria

O sistema mantém um registro completo de cada voto para fins de auditoria.

Dados registrados por voto

Campo	Descrição
CPF (hash)	Hash SHA-256 do CPF — irreversível
Nome	Nome do associado no momento do voto
Categoria	Categoria do sócio (Titular, Aspirante, etc.)
Data/hora	Timestamp da confirmação do voto
Respostas	Opção escolhida para cada pauta

Menu Respostas

No menu Auditoria → Respostas, o administrador pode:

Listar todos os votos registrados
Filtrar por aprovação, nome ou categoria
Visualizar os detalhes de cada voto (respostas individuais)

Perguntas Frequentes

Posso editar uma aprovação após publicá-la?

Apenas a data limite pode ser alterada após a publicação. Títulos, descrições e pautas ficam bloqueados para garantir a integridade da votação.

Como sei se um associado é elegível?

O sistema consulta a API do Associatec no momento do login do votante. São verificados: status do cadastro, situação financeira e categoria do sócio em relação às categorias habilitadas na aprovação.

O que acontece se a sessão do admin expirar?

O sistema redireciona automaticamente para a página de login. Nenhum dado é perdido — as alterações já salvas permanecem intactas.

Como recupero minha senha de administrador?

Atualmente, a recuperação de senha de admin deve ser feita via linha de comando ou solicitando que outro administrador altere suas credenciais no painel.

É possível reabrir uma aprovação encerrada?

Não. Após o encerramento, a aprovação é permanentemente fechada. Caso necessário, uma nova aprovação deve ser criada.

Posso ter múltiplas aprovações ativas ao mesmo tempo?

Sim. Não há limite de aprovações simultâneas. Cada aprovação funciona de forma independente.