🎧 Painel de Suporte VIS — Guia do Operador

1 O que é o painel

O Painel de Suporte é uma página web que a equipe de apoio usa durante a assembleia para conversar com os votantes pelo chat, enviar avisos e acompanhar quem entrou, quem está online e como estão as votações. Ele não precisa de instalação: abre no navegador e conversa direto com o sistema VIS.

• 💬 Chat um-a-um com cada votante, em tempo real.
• 📣 Aviso para todos os participantes de uma vez.
• 👥 Presença: quantos acessaram, quantos estão online agora e quanto cada um votou.
• 📊 Votações: resultado de cada pergunta, com exportação.
• 🌗 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. O botão trava em ⏳ Entrando… enquanto o servidor confere a credencial — cliques (ou Enter) repetidos não disparam outro login, e ele sempre volta ao normal, com a mensagem de erro se algo falhar.
• 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://suporte.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).

Os seletores funcionam em cascata: Evento e Sessão nascem desabilitados e só liberam quando o passo anterior termina — ao escolher o projeto, os dois ficam cinza por um instante enquanto o painel busca os eventos e as sessões. Ao escolher a sessão, começa a carga inicial: a pill azul ⟳ sessão 3/12 acende no cabeçalho e as abas, os seletores e o botão Atualizar ficam travados até a primeira tela aparecer.

5 A tela por dentro

Com a sessão escolhida, o cabeçalho passa a mostrar indicadores úteis e as três abas de trabalho.

• 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 Tempo real.
• B 👥 acessaram / total — quantos votantes já entraram no sistema.
• C 🟢 online — quantos estão conectados neste momento.
• D Badge vermelho na aba Chats = total de mensagens não lidas.
• E Pill azul ⟳ = o painel está sincronizando com o servidor. Mostra o que está carregando e o progresso (“sessão 4/12”) e tem um ✕ para interromper — veja a seção Tempo real.

Atualizar recarrega os dados na hora. Sair encerra a sessão do navegador.

6 Aba Chats: atender conversas

Esta é a tela principal do suporte. À 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.

7 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.

8 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.

9 Mensagem para todos

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

10 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.

11 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”).

12 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.

Os cartões no topo resumem: cadastrados, acessaram, online agora, votaram e nunca acessaram. A barra de filtros combina vários critérios ao mesmo tempo — o contador ao lado do XLSX mostra quantos participantes restam:

• Y Papel: mostra só um papel (votante, unidade ou representante). A lista de papéis é montada conforme a sessão.
• Z Voto: votaram ou não votaram (ou “todos”). Combine com o Papel para, por ex., ver “representantes que não votaram”.
• W Limpar filtros: zera busca, papel, voto e as caixas de uma vez.

• 🔎 A busca vale para todas as colunas: nome, login, keypad, papel, grupo, e-mail, peso e último acesso, mais os textos que aparecem na tela (“nunca acessou”, “presente (6h)”, “4/12”, “online”) e até as colunas extras importadas — tanto o nome da coluna quanto o conteúdo. Digite “bloco B” ou um CPF e o painel encontra.
• Complementam a busca as caixas “só quem acessou” e “só online” (esta última só com o tempo real ativo).
• 💾 Busca e filtros não se perdem: a atualização automática redesenha a lista mantendo o que você digitou/escolheu — inclusive a posição do cursor no campo de busca.
• Em cada linha: 👁 abre o detalhe do participante; 💬 abre (ou cria) a conversa dele no chat. Numa unidade que tem representante, o 💬 abre direto a conversa do representante — é ele quem responde pela unidade (a dica do botão avisa).
• ⚠ antes do nome = o peso deste participante está desabilitado no cadastro. É um aviso apenas informativo — passe o mouse para ver a dica.
• XLSX X exporta a lista já filtrada para planilha.

13 Detalhe do participante

Clicando no 👁 (na lista de participantes ou numa conversa) abre uma janela com todos os dados daquele votante — inclusive as colunas extras importadas para a sessão.

Para representantes, a janela lista as unidades representadas — o nome de cada unidade é um link que abre o detalhe dela. Numa unidade com representante, a linha Representante traz o nome dele como link (e 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, e a linha “Peso habilitado” diz se o peso do participante está ativo. O botão 💬 Abrir conversa leva direto ao chat da pessoa — e, numa unidade que tem representante, ele vira “💬 Abrir conversa (representante)” e abre o chat de quem de fato responde por ela.

14 Aba Votações

Acompanhe o resultado de cada pergunta da sessão, com contagem por alternativa e por peso.

S O seletor ordenar muda a ordem das alternativas dentro de cada votação:

Trocar a ordenação reorganiza os cartões na hora, sem nova consulta ao servidor — e a ordem escolhida também vale para os arquivos exportados. Use XLSX ou PDF no topo para salvar todos os resultados. Ao entrar na aba, os números são recarregados para refletir o estado atual (aberta/fechada e votos) — enquanto as perguntas são conferidas, a pill azul mostra ⟳ Votações 3/12.

15 Tempo real, atualização e a pill ⟳

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

A pill azul ⟳ — o que está carregando

Sempre que o painel busca dados no servidor, uma pill azul acende no cabeçalho com o rótulo do que está sendo carregado e o progresso x/y (perguntas já conferidas / total). O ✕ na ponta interrompe o carregamento.

O ✕ interrompe só as leituras: os dados parciais são descartados e um clique em Atualizar refaz a busca do zero. O envio de mensagens e os avisos do chat nunca são interrompidos. A interrupção também acontece sozinha ao trocar de projeto/evento/sessão ou ao sair — leituras antigas não “vazam” para a seleção nova.

Atualização de fundo sem piscar

• 🖼️ A tela nova é montada nos bastidores e trocada de uma só vez — a lista não pisca nem “some” durante a atualização automática.
• ⌨️ O que você estava fazendo é preservado: a rolagem da página, o campo em foco, a posição exata do cursor e a busca/filtros dos Participantes continuam onde estavam.
• 🪟 Com uma janela aberta (detalhe do participante, snippets, mensagem a todos), a atualização de fundo pausa — nada muda embaixo de você; ela volta ao fechar. As mensagens do chat continuam chegando pelo tempo real.
• 💬 A aba Chats tem atualização própria e incremental: conversas e contadores se renovam sem mexer no texto que você está digitando.

16 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) são sensíveis — evite exportar/compartilhar sem necessidade.
• 🚪 Ao terminar, clique em Sair, principalmente em computadores compartilhados.

17 Problemas comuns