🏛️ Painel de Assembleia VIS — Guia do Operador

1 O que é o painel

O Painel de Assembleia é uma página web que a equipe de apoio usa durante a assembleia para acompanhar o quórum e as votações, conversar com os votantes pelo chat, enviar avisos e emitir os relatórios. Ele não precisa de instalação: abre no navegador e conversa direto com o sistema VIS.

• ⚖️ Quórum por peso (aba Dados): cadastrados, unidades, representantes, peso total e presença — sempre com o peso efetivo.
• 💬 Chat um-a-um com cada votante, em tempo real, e aviso para todos de uma vez.
• 👥 Participantes: quem acessou, quem está online, quanto cada um votou — com busca em todas as colunas, filtros combináveis e visão representante ↔ unidades.
• 📊 Votações: resultado de cada pergunta por grupo (unidades, representantes…) e referencial (todos, presentes, acessaram, votaram), com limiares de quórum e destaque de alternativas aprovadas.
• 📄 Relatórios: Resumo, Extrato de Votos (aberto e secreto), Voto Aberto, Voto Secreto e os relatórios nativos do servidor.
• 🌗 Tema claro ou escuro: o botão ☀️/🌙 (no cabeçalho e na tela de login) alterna o visual — a escolha fica salva no navegador.

2 Entrar (login)

Ao abrir o painel você vê a tela de login. Por padrão ele já vem configurado para o servidor XVote (produção) — na maioria das vezes você só precisa digitar seu e-mail e senha de operador.

• 1 Digite seu e-mail de operador.
• 2 Digite sua senha (pode apertar Enter para entrar).
• 3 Clique em Entrar.
• 4 A engrenagem (⚙) só é usada se precisar trocar de servidor — veja a próxima seção.

3 Trocar de servidor

Se a sua assembleia está em outro servidor (Voto Remoto/SIP, Easyvote, Staging ou um endereço próprio), clique na engrenagem (⚙) no canto inferior direito para exibir a lista de servidores.

• 1 Escolha um dos servidores prontos.
• 2 Ou selecione “Outro servidor…” para digitar um endereço próprio (ex.: https://api.seucliente.com.br/api/v1/).
• 3 Clique na engrenagem de novo para esconder — depois é só logar normalmente.

Definir o servidor pela URL

Dá para abrir o painel já apontando para um servidor, sem mexer na engrenagem — útil para mandar o link certo para cada equipe. Funciona pela rota ou por parâmetro:

Exemplo: https://painel.ajudanaassembleia.com.br/sip abre o login já no Voto Remoto/SIP (a linha “Servidor” indica definido pela URL). Também vale ?server=sip. A URL manda: se havia uma sessão aberta em outro servidor nesta aba, o painel volta ao login para você entrar no servidor indicado.

4 Escolher projeto, evento e sessão

Depois de entrar, use os três seletores no topo, da esquerda para a direita: primeiro o Projeto, depois o Evento e por fim a Sessão que você vai apoiar. Só a partir da sessão escolhida o painel carrega os dados.

• 1 Projeto — o cliente/conta.
• 2 Evento — opcional; filtra as sessões daquele evento (deixe em “todos” se preferir ver tudo).
• 3 Sessão — a sala de votação. ● = aberta, ○ = fechada. O estado aparece ao lado (ABERTA · slide atual).

5 A tela por dentro

Com a sessão escolhida, o cabeçalho passa a mostrar indicadores úteis e as cinco abas de trabalho: Dados (quórum), 💬 Chats, Participantes, Votações e Relatórios.

• A ⚡ ao vivo = conexão em tempo real ativa (mensagens e “online” instantâneos). Se aparecer ⚡ off, o painel usa atualização periódica — veja a seção Carregamento e tempo real.
• B Pill azul ⟳ — progresso da carga em andamento (ex.: ⟳ sessão 5/12). O ✕ dentro dela interrompe o carregamento.
• C 👥 acessaram / total e 🟢 online — quantos votantes já entraram no sistema e quantos estão conectados agora.
• D Badge vermelho na aba Chats = total de mensagens não lidas.

Atualizar recarrega os dados na hora. Sair encerra a sessão do navegador. O ❓ no cabeçalho abre este tutorial.

6 Aba Dados: quórum da assembleia

É a primeira aba e a visão geral do quórum. Mostra os totais da sessão em cartões (KPIs) e uma tabela de presença — tudo calculado com o peso efetivo de cada participante.

A tabela de presença separa três categorias, cada uma com usuários, unidades e peso efetivo:

• Presentes 6h — teve atividade nas últimas 6 horas (a régua de “presente” do painel).
• Check-in — já acessou o sistema em algum momento.
• Nunca acessou — nunca entrou no sistema.

7 Aba Chats: atender conversas

Esta é a tela principal do atendimento. À esquerda ficam as conversas; à direita, a conversa aberta.

• 1 Filtros de conversa: Ativas, Arquivadas ou Todas — e uma busca por nome/keypad.
• 2 + Nova conversa: inicia um chat com um votante que ainda não escreveu.
• 3 Barra de ações: mensagem a todos, snippets e exportar (detalhados adiante).

Na lista, a bolinha ao lado do nome indica ● online / ● offline; o número vermelho é a quantidade de mensagens não lidas daquela conversa; o 👁 abre o detalhe do participante sem abrir a conversa. Clique em qualquer conversa para abri-la.

8 Responder um votante

1. Clique na conversa na lista à esquerda. Ao abrir, as mensagens são marcadas como lidas automaticamente (o contador zera).
2. Escreva no campo inferior e clique em Enviar (ou aperte Enter). Para quebrar linha, use Shift+Enter.
3. Suas mensagens aparecem à direita, em azul; as do votante à esquerda. Se a conexão está ⚡ ao vivo, as respostas do votante chegam sozinhas.

9 Mensagens prontas (snippets)

Snippets são textos que você salva uma vez e reaproveita nas conversas — por exemplo “Como votar” ou “Horário de encerramento”. Ficam guardados neste navegador.

1. Na barra de ações, clique em ✂️ Snippets.
2. Digite um título e o texto, e clique em Salvar snippet. Repita para quantos quiser.
3. Numa conversa, use o menu ✂️ ao lado do campo de texto para inserir o snippet — depois é só ajustar e enviar.
4. Para levar seus snippets a outro computador, use Exportar JSON num e Importar JSON no outro.

10 Mensagem para todos

Para avisar todos os votantes de uma vez, clique em 📣 Mensagem a todos. Há dois modos:

11 Arquivar conversas

Depois de resolver um atendimento, você pode arquivar a conversa para tirá-la da lista de ativas sem perder o histórico.

1. Abra a conversa e clique em 🗄 Arquivar no cabeçalho dela.
2. Ela sai de Ativas e passa para Arquivadas (use o filtro no topo para vê-la).
3. Para reabrir, entre em Arquivadas, abra a conversa e clique em ↩ Desarquivar.

12 Exportar chats

O botão ⬇ Exportar oferece três formas de salvar as conversas:

Você também pode exportar a conversa atual pelos botões XLSX/PDF no cabeçalho dela. O PDF é gerado pela janela de impressão do navegador (escolha “Salvar como PDF”).

13 Aba Participantes

Mostra todos os votantes da sessão e o estado de cada um: se acessou o sistema, se está online agora e quanto já votou — com busca total, filtros combináveis e a visão representante ↔ unidades.

• 1 Busca total: procura em todas as colunas — nome, login, keypad, papel, grupo, e-mail, peso, último acesso, as colunas extras importadas (nomes e valores) e até os textos exibidos, como “presente (6h)”, “4/8” ou “online”.
• 2 Votou N questões: escolha o operador (≥, = ou ≤) e digite o número — ex.: “votou ≥ 2 questões”. Deixe qualquer um dos dois vazio para desligar.
• 3 colunas ▾: oculta/exibe qualquer coluna da tabela. O XLSX exporta só as colunas visíveis; pelo menos uma coluna fica sempre ativa.
• 4 Resumir: unifica representante + unidades (veja abaixo). Só aparece quando a sessão tem representantes e unidades.

Filtros combináveis

Todos os filtros somam-se entre si e com a busca — o contador ao lado do XLSX mostra quantos participantes restam. limpar filtros zera busca, papel, voto, “votou N questões” e as caixas de uma vez (a visão Resumir e as colunas escolhidas ficam como estão).

Marcas na lista

• ⚠ amarelo antes do nome = peso desabilitado (não conta no quórum).
• 🔒 depois do nome = participante bloqueado.
• Em cada linha: 👁 abre o detalhe do participante; 💬 abre (ou cria) a conversa dele no chat. Numa unidade com representante, o 💬 abre o chat do representante — é ele quem conversa pela unidade.

Representantes e unidades

• O botão +/− à esquerda do nome do representante expande/recolhe as unidades dele como sublinhas (↳) logo abaixo. As sublinhas mostram todas as unidades do representante (mesmo as que os filtros esconderiam) e a unidade some da listagem normal para não aparecer duas vezes.
• A caixa Resumir unifica os dados dos dois lados:
  • o acesso/online/último acesso do representante passam a valer para as unidades dele (quem entra no sistema é ele);
  • os totais de voto do representante viram a soma dos das unidades (é por elas que ele vota);
  • a busca cruza os dados de um pelo outro: buscar o nome da unidade encontra o representante, e vice-versa.

O botão XLSX exporta a lista já filtrada, só com as colunas visíveis, na mesma ordem da tela. A tabela exibe até 1500 linhas — use a busca/filtros para refinar (a exportação sai completa).

14 Detalhe do participante

Clicando no 👁 (na lista de participantes ou numa conversa) abre uma janela com todos os dados daquele votante — nome, login, keypad, papel, grupo, e-mail, peso, peso habilitado, bloqueado, online agora, último acesso e data de cadastro — além das colunas extras importadas para a sessão.

• Para representantes, a janela lista as unidades representadas — com o peso total delas no título (só as com peso habilitado contam) e uma coluna Desabilitada indicando as que não contam no quórum. O nome de cada unidade é um link: clique para abrir o detalhe dela.
• Para unidades com representante, a linha Representante mostra o nome dele como link — clique (ou use o botão 👁 Ver representante) para navegar direto ao detalhe do representante.
• As colunas extras (bloco, CPF, unidade etc., conforme a importação) aparecem no fim.
• O botão 💬 Abrir conversa leva direto ao chat da pessoa. Numa unidade com representante, ele abre o chat do representante (o botão indica isso).

15 Aba Votações

Acompanhe o resultado de cada pergunta da sessão, com contagem por alternativa e por peso — e recorte o resultado por grupo e referencial, com limiares de quórum e destaque das alternativas aprovadas. Ao entrar na aba, os números são recarregados para refletir o estado atual (aberta/fechada e votos); trocar os seletores abaixo é instantâneo (não refaz a busca).

• 1 Exibir — o grupo cujos votos são mostrados.
• 2 Referencial — a população considerada (todos, presentes, quem acessou ou quem votou na questão).
• 3 Destacar — o limiar que pinta as alternativas aprovadas de amarelo.
• 4 ordenar — a ordem das alternativas dentro de cada votação (vale também para os exports).
• 5 Chip “referencial” — aparece quando o referencial não é “Todos”, lembrando que os números são só daquele subconjunto.
• 6 Limiares do recorte atual — 50%+1 e 2/3, em participantes e em peso.
• 7 Alternativa destacada em amarelo = atingiu o limiar escolhido em “Destacar”.

Exibir (grupo)

Recorta os votos pelo papel do votante — os totais e os percentuais passam a ser relativos ao grupo:

Referencial (população)

Restringe os votos contados E os denominadores do quórum a uma população — útil para regras do tipo “2/3 do peso das unidades que acessaram”:

Com referencial diferente de “Todos”, o chip referencial: … aparece no header de quórum para deixar claro que todos os números e limiares da tela valem só para aquele subconjunto.

Header de quórum e limiares

O cartão acima das votações resume o recorte grupo × referencial atual: Participantes e Peso (quantos são e quanto pesam), Presentes (6h) e Votaram (com o peso de cada um). Abaixo, os limiares calculados sobre os participantes do recorte (não sobre os votos):

Destacar (limiar de aprovação)

Pinta de amarelo as alternativas que atingem o limiar escolhido — a leitura visual de “passou/não passou” (a cor forte funciona nos dois temas):

Customizado… abre quatro controles na mesma linha: Perfil (Geral / Votante Unificado / Unidades / Representantes), Referencial (Total / Acessaram / Presentes (6h)), Dado (Participantes ou Peso) e Valor. O painel localiza a mesma alternativa nesse outro recorte e a destaca se o dado escolhido atingir o valor digitado — que aceita vírgula ou ponto decimal (ex.: 13,33 ou 13.33). Com o valor vazio ou inválido, nada é destacado. Exemplo: exibir o resultado Geral e destacar quem atingiu peso 13,33 entre os presentes.

Ordenar as alternativas

Exportar

Os botões XLSX e PDF no topo exportam todas as votações respeitando o grupo, o referencial e a ordenação selecionados — o nome do arquivo e o título do relatório indicam o recorte (ex.: votacoes_unidades_acessaram_123.xlsx, “Votações (Unidades · Acessaram)”). No recorte padrão (Geral · Todos) o arquivo sai sem sufixo.

16 Aba Relatórios

Reúne os relatórios da assembleia. Os quatro primeiros são gerados no navegador (XLSX/CSV na hora; o PDF sai pela janela de impressão — escolha “Salvar como PDF”); os nativos são os arquivos oficiais do servidor VIS.

17 Carregamento e tempo real

A pill azul de carregamento (⟳)

Sempre que o painel está buscando dados, uma pill azul aparece no cabeçalho com o progresso: ⟳ sessão 5/12, ⟳ Votações 3/8, ⟳ atualizando 2/4… O x/y conta as etapas da carga (por exemplo, a busca de votos de cada votação); quando o total ainda não é conhecido aparece só “x…”.

• O ✕ dentro da pill interrompe o carregamento — os números parciais são descartados e a aba mostra “Carga interrompida.”; clique em Atualizar para refazer.
• Trocar de projeto, evento ou sessão também cancela automaticamente as cargas antigas — respostas velhas nunca poluem a nova seleção.
• Na carga inicial da sessão, abas e seletores ficam travados até o primeiro desenho; ao trocar de aba, só os seletores travam; a atualização de fundo nunca trava nada.

Atualização automática

Com uma sessão aberta, o painel se atualiza sozinho em segundo plano (a cada ~30 s nas abas de dados; o chat mais rápido quando não há tempo real). Essa atualização foi feita para não atrapalhar:

• a tela não pisca e a sua busca, filtros, scroll e cursor são preservados — pode digitar no meio de uma atualização;
• com uma janela (modal) aberta — detalhe de participante, snippets etc. — a atualização de fundo pausa (o chat em tempo real continua chegando pelo socket).

Conexão em tempo real

O painel tenta se conectar ao sistema em tempo real. O indicador no cabeçalho mostra o estado:

18 Segurança e boas práticas

• 🔑 Login por operador: use sua própria credencial. O acesso fica só neste navegador e some ao fechar.
• 🚨 Mensagem a todos dispara push real — confirme o texto e o número de destinatários antes de enviar.
• 🧪 Treine no Staging: para aprender ou testar, entre pela engrenagem e escolha Staging (quase.online). Nunca teste em produção.
• 👁 Dados dos votantes (CPF, colunas extras) e os relatórios de voto aberto são sensíveis — evite exportar/compartilhar sem necessidade.
• ⚖️ Antes de anunciar um resultado, confira o recorte da aba Votações (chip “referencial”, grupo em “Exibir”) — os números mudam conforme o recorte.
• 🚪 Ao terminar, clique em Sair, principalmente em computadores compartilhados.

19 Problemas comuns