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:

Aprovações ativas Em andamento ou publicadas

Total de votos Registrados nas aprovações ativas

Administradores Total de contas de gestão

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
Selecione as categorias de sócios elegíveis (Titular, Aspirante, etc.)
Defina a data limite da votação (opcional)
Clique em Salvar

Status da aprovação

Status	Descrição
Rascunho	Recém-criada. Não visível para votantes. Pode ser editada livremente.
Publicada	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

Na aprovação (status Rascunho), clique em Pautas → Adicionar
Preencha o título da pauta
Adicione uma descrição detalhada (opcional)
Defina a ordem de exibição
Clique em Salvar

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.

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 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 aprovação publicada, clique na ação Notificar
Selecione o canal: WhatsApp ou E-mail
O sistema busca automaticamente os associados elegíveis que ainda não votaram
As mensagens são enviadas de forma assíncrona via fila (Messenger)

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 Votos Registrados

No menu Auditoria → Votos Registrados, 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.