VotaCerta CRM

1. Abra Território e compare Intel por região para decidir reforço do dia.
2. Em Comparativo diário entre equipes, identifique equipe com backlog crítico mais alto.
3. Na aba Tarefas, priorize atrasadas e vencendo hoje no Kanban.
4. Faça 5-15 atribuições claras (responsável + prazo) e acompanhe conclusão no fim do expediente.
5. Registre toda conversa-chave como Comunicação e sempre preencha Próximos passos.

• Backlog crítico subindo por 2 dias seguidos na mesma equipe.
• RA com interações altas, mas conversões para SIM estagnadas.
• Volume de tarefas concluídas caindo sem redução de pendências.

• Confirme a janela (7/14/30/60 dias) e limpe filtros de RA/equipe.
• Clique em Atualizar e recarregue a página (Ctrl+Shift+R).
• Se persistir, reporte horário exato + usuário para checagem em log.

• Centraliza eleitores, lideranças, comunicações e tarefas em um só lugar.
• Organiza o campo: cada contato vira histórico e pode virar follow-up (tarefas).
• Dá visão territorial: mapas (ArcGIS), metas por RA e painel de território por equipe.
• Apoia estratégia: filtros robustos e IA para perguntas rápidas e insights.

• RA: Região Administrativa (escopo de acesso e recorte de metas).
• Intenção: SIM, TALVEZ, INDEFINIDO, NÃO, SEM_CONTATO.
• Probabilidade: 0 a 100 (ajuda a priorizar).
• Liderança: pessoa que influencia uma rede (também é um eleitor no sistema).
• Equipe: grupo operacional (normalmente de cabos) vinculado a uma RA.
• Comunicação: registro de contato (WhatsApp, visita, telefone, evento etc.).
• Tarefa: próximo passo com responsável e prazo (controle de execução).

1. Login com email e senha.
2. Vá em Usuários (Admin) e confirme seu papel e suas RAs.
3. No painel Território, configure equipes e membros (Admin/Coord).
4. Vá em Eleitores e cadastre alguns eleitores com endereço (para ver pontos no mapa).
5. Abra 1 eleitor e registre 1 Comunicação com Próximos passos para gerar uma tarefa automaticamente.
6. Vá em Tarefas, filtre por Minhas e conclua a tarefa.
7. Vá em Dark Voters e rode o recálculo para gerar a primeira leitura territorial.
8. Valide mapa/score de zonas com maior oportunidade e ajuste o plano de campo.
9. Volte ao Dashboard para conferir ritmo geral e prioridades do dia.

1. No Telegram, use /ra para definir sua RA padrão.
2. Cadastre no modo rápido: /novo Nome;Telefone (reaproveita RA) ou /novo Nome;Telefone;RA.
3. Quando possível, envie uma Localização no chat para registrar coordenadas automaticamente.
4. No fim do dia, abra o CRM e feche tarefas e comunicações pendentes.

1. Use Importação CSV em Dry run para validar uma base antes de gravar.
2. Importe e confira duplicados (telefone/CPF).
3. Valide mapas: porcentagem com coordenadas, concentração por RA, e anomalias (ex: muitos pontos fora do DF).
4. Use IA para responder perguntas do coordenador com recorte (RA + período).

• Preencha Email e Senha.
• Código 2FA (6 dígitos) só é necessário quando seu usuário tiver 2FA exigido/ativado.

• Mínimo: 7 caracteres.
• Recomendação operacional: use frase curta + número (ex: campanha2026).

• O Admin pode marcar Exigir 2FA ao criar o usuário.
• Quando exigido, o usuário faz o setup com app autenticador (Google Authenticator, 1Password etc.).

1. Na tela de login, clique em Esqueci minha senha.
2. Digite seu email e envie.
3. Você receberá um link por email para definir uma nova senha.
4. Ao trocar a senha, suas sessões antigas são invalidadas.

Se não chegar, verifique SPAM. Se ainda falhar, peça ao Admin para conferir o envio (Resend).

• O CRM usa papéis (roles) e escopo por RA.
• Se você tentar cadastrar/editar em uma RA fora do seu escopo, verá erro de acesso.

• Administrador: cria usuários, define RAs, vê auditoria completa, configura 2FA.
• Coordenador regional: opera 1 a 3 RAs, acompanha metas, atribui tarefas, gerencia equipes da sua RA e cobra execução.
• Cabo eleitoral: captura eleitores e comunicações, executa tarefas de follow-up e visualiza o próprio território/equipe.
• Analista de dados: importa CSV, valida dados, segmenta e usa IA.
• Candidato / Observador: leitura de alto nível (podem ter restrições de dados sensíveis).

• Super Admin / Administrador: cria, edita, ativa/desativa equipes e define membros em qualquer RA.
• Coordenador regional: mesmas ações, mas apenas nas RAs do próprio escopo.
• Demais papéis: sem permissão de gestão de equipes.

• Cards: volume total e distribuição por intenção.
• Minhas tarefas: sua fila de execução.
• Ritmo vs meta (RAs): onde está atrasado (precisa reforço) e onde está ok.
• Mapa / Heatmap: concentração de eleitores (filtro por intenção).
• Tendência: evolução nos últimos 30 dias.
• Atividade recente: o que entrou/mudou agora.

• Use o seletor Heatmap por intenção para ver apenas SIM, TALVEZ, INDEFINIDO etc.
• Se o mapa estiver pesado no celular, filtre por uma intenção e clique em Atualizar Heatmap.

• O sistema cruza seções eleitorais importadas (boundaries) com eleitorado por seção (rolls CSV).
• Cada seção recebe score de oportunidade considerando penetração, SIM ratio, probabilidade média e (quando disponível) vulnerabilidade IBGE.
• Os modelos de comunidades e lookalikes também incorporam sinais IBGE (subdistrito e vulnerabilidade).
• Use a camada Oportunidade para priorizar campo e a camada Vulnerabilidade socioeconômica (IBGE) para leitura de contexto.
• Use filtros de RA, score mínimo e tier para montar a operação do dia.
• HIGH tende a ser o primeiro alvo de campo quando há capacidade limitada.

1. Importe Boundaries (GeoJSON) com as geometrias das seções.
2. Importe Rolls (CSV) com zona, seção e eleitorado.
3. Se presentes no arquivo, os campos ibge_* (subdistrito, renda, alfabetização, saneamento, vulnerabilidade) são absorvidos automaticamente.
4. Mantenha Recalcular após importar ligado para atualizar score e mapa automaticamente.
5. Valide no topo da aba o status espacial: total de seções, cobertura geométrica e modo ativo.

• Script oficial: build_module_b_open_data_pipeline.py (gera boundaries + rolls + histórico por seção + enriquecimento IBGE).
• Timer ativo no servidor: votacerta-crm-open-data-refresh.timer (segunda 01:40 UTC).
• O pipeline importa os arquivos no CRM e recalcula o Módulo B automaticamente.
• O cache é renovado por idade configurável (--max-cache-age-hours) para não travar em arquivo antigo.

• TSE: eleitorado atual por seção, perfil por seção, resultados históricos e comparecimento/abstenção.
• IBGE Malhas (WFS): setor censitário 2022 para harmonização espacial seção -> setor/subdistrito.
• IBGE SIDRA: renda (2010), alfabetização (2010), água/rede, esgoto/rede e coleta de lixo (2000).
• O ETL calcula ibge_socio_vulnerability (0-100) por subdistrito e projeta para cada seção.

• Resumo: pendências, tarefas críticas, tarefas concluídas, interações e taxa de conversão.
• Tarefas críticas: fila priorizada para ação imediata.
• Drill-down por RA e equipe: leitura detalhada por recorte territorial e operacional.
• Intel por região: agregação por RA para decisão rápida de reforço.
• Comparativo diário entre equipes: execução diária (interações, conversões, concluídas, backlog crítico).

• Janela: define período de análise (7, 14, 30, 60 dias).
• RA: restringe o painel para uma região específica.
• Equipe: foca em uma equipe da RA selecionada.
• Se mudar RA, recarregue o filtro de equipe e clique em Atualizar.

1. Na seção Gestão de equipes, crie a equipe com nome + RA.
2. Selecione a equipe e marque os membros (cabos) para salvar composição.
3. Use Editar para renomear a equipe.
4. Use Ativar/Desativar para pausar operação sem apagar histórico.

A associação de membros é exclusiva por usuário: cada cabo pertence a uma equipe por vez.

1. Abra Dashboard e confira Ritmo vs meta: quais RAs estão atrasadas.
2. Abra Território e veja Intel por região + Comparativo diário entre equipes.
3. Abra Tarefas e filtre Atrasadas: quem está com backlog (e onde).
4. Abra Regiões e compare: Cadastros vs SIM (onde tem volume mas pouca conversão).
5. Abra Lideranças: foque em lideranças com rede grande e pouca taxa SIM (precisam de ação).
6. Crie/atribua 5 a 15 tarefas claras para o dia (com prazo) e acompanhe conclusão.

1. Use IA para perguntas como: conversão por RA, volume de mudanças INDEFINIDO->SIM, e evolução de TALVEZ.
2. Escolha 2 a 3 micro-alvos por semana: 1 RA crítica, 1 liderança-chave, 1 tema (demanda) recorrente.
3. Ajuste execução: reforçar cabos onde a densidade e maior (mapa/heatmap) e a conversão está baixa.

• Obrigatório: Nome, Telefone e RA.
• Telefone: use com DDD (10/11 dígitos) ou com +55.
• Endereço (opcional, mas recomendado): quando preenchido, o sistema tenta geocodificar e gerar coordenadas.
• Liderança: selecione quem indicou/influencia este eleitor (quando aplicável).
• Notas: contexto de campo em texto livre (histórico político, demandas, restrições, etc.).

• Busca: nome, telefone, RA.
• Filtros: RA, intenção, engajamento, probabilidade min/max, profissão, igreja/templo, interesse, fonte, cabo, liderança, período e custom_fields.
• Ordenação: updated_at/created_at/probabilidade/intenção/nome/RA.

Exemplos úteis: "INDEFINIDO em Samambaia", "TALVEZ com prob>70", "Rede de uma liderança".

• Clique em Mapa ArcGIS para ver os pontos.
• Use Somente com coordenadas para exibir apenas quem tem endereço geocodificado (ou coordenadas via Telegram).
• Se um eleitor tem endereço mas não aparece: revise o texto do endereço e salve novamente.

O geocoding é priorizado para Brasília/DF. Endereço incompleto pode falhar.

• Na tabela de eleitores, clique na linha para abrir o painel do perfil.
• Edite endereço, notas e liderança.
• Ao salvar um endereço, o sistema tenta atualizar coordenadas automaticamente (se ArcGIS estiver configurado).

• No formulário de cadastro do eleitor (ou no perfil), selecione a Liderança.
• Se preferir, use o formulário Atualizar Liderança informando o ID do eleitor.
• Isso alimenta a rede (mapa e lista) da liderança.

• Toda mudança de intenção (antes/depois) aparece no Histórico de intenção.
• Isso permite medir conversão (ex: INDEFINIDO -> SIM) por semana/RA/cabo.

• No perfil do eleitor, escolha o tipo (WhatsApp, visita, telefone, evento etc.).
• Preencha Resumo com o essencial (1 a 3 linhas).
• Se houve mudança, preencha Intenção após contato e, se quiser, Sentimento.
• Use Demandas (separadas por vírgula) para capturar temas: asfalto, creche, segurança etc.

• Ao preencher Próximos passos, o CRM cria uma tarefa automaticamente (prazo: amanhã).
• Regra operacional: toda conversa que pede retorno vira tarefa.

• Use Anexar arquivos para enviar áudio, foto, PDF etc junto da comunicação.
• Os links aparecem em Links de anexos (1 por linha) e ficam no histórico do eleitor.

• Transformar o CRM em execução: quem faz o quê, até quando.
• Evitar perder follow-up (principalmente TALVEZ/INDEFINIDO).
• Dar visibilidade: tarefas concluídas vs atrasadas por pessoa/equipe.

• Crie tarefa pela aba Tarefas (precisa do Voter ID) ou dentro do Perfil do eleitor.
• Use títulos diretos: "Retornar ligação", "Confirmar voto", "Enviar material".
• Marque como CONCLUÍDA quando finalizar e registre o resultado nas notas.

• Use o botão Kanban para ver colunas: Não iniciadas, Em andamento, Concluídas.
• Você pode mover por botões de ação ou arrastar no quadro.
• Fluxo padrão: ABERTA -> EM_ANDAMENTO -> CONCLUIDA.
• Também é possível voltar status quando necessário (ex: reabrir tarefa concluída).

• Admin/Candidato podem atribuir para qualquer perfil operacional.
• Coordenador regional pode atribuir para cabo eleitoral e analista de dados.
• Demais perfis não podem reatribuir para outras pessoas.
• O responsável precisa ter acesso à RA do eleitor.
• Ao atribuir para cabo eleitoral, o eleitor precisa estar vinculado ao cabo (o sistema pode vincular automaticamente quando estiver vazio).

• Liderança é uma pessoa com capacidade de influenciar votos (líder comunitário, religioso, político, etc.).
• Uma liderança sempre referencia um eleitor (ela também é um eleitor no cadastro).
• A rede é formada pelos eleitores que têm o campo Liderança preenchido.

1. Cadastre (ou encontre) o eleitor que será a liderança.
2. Copie o Voter ID desse eleitor.
3. Na aba Lideranças, crie com tipo/compromisso/alcance (opcional).
4. Depois, vincule a rede: no cadastro de cada eleitor, selecione essa liderança.

• No modo Mapa ArcGIS, clique em um ponto para focar a liderança.
• O mapa pode mostrar também os eleitores influenciados (rede).
• Use Ver rede no mapa no perfil da liderança para isolar apenas ela e sua rede.
• Use Voltar (todas) para retornar ao mapa completo.

• A página Regiões é focada em mapa e ranking.
• Use Tamanho por para alternar a métrica (Meta de votos, SIM, Cadastros).
• Clique em uma RA no mapa para ver detalhes e comparar no ranking.

O CSV deve ter cabeçalho. Mínimo obrigatório:

nome,telefone,ra

Use o botão Baixar modelo CSV na própria página de importação.

• Dry run: valida e mostra preview sem gravar.
• Duplicados: por telefone/CPF (e combinação nome+telefone). Ação:
• Pular (skip): ignora duplicados.
• Atualizar (update): atualiza campos principais do cadastro existente.
• Criar novo (create_new): cria um registro adicional.

• Inclua RA e período: "na última semana", "nos últimos 30 dias" etc.
• Peça contagens, tendências e comparações simples.

Quantos eleitores em Samambaia mudaram de INDEFINIDO para SIM nos últimos 7 dias?
Qual RA teve mais cadastros ontem?
Quantos TALVEZ existem hoje em Ceilândia e quantos têm probabilidade acima de 70?

• Por segurança, o CRM bloqueia SQL perigoso (comandos de escrita, múltiplas queries, etc.).
• Reescreva a pergunta para algo que resulte em apenas SELECT (contagens e filtros).
• Evite colar SQL manualmente. Faça a pergunta em português.

• As respostas respeitam o seu papel e seu escopo de RAs.
• Se você não tem acesso a uma RA, a IA não deve retornar dados dessa RA.

1. Entre como Administrador.
2. Vá em Usuários.
3. Preencha nome, email, senha temporária e papel (role).
4. Selecione as RAs que o usuário pode acessar.
5. Opcional: marque Exigir 2FA.

• Logins, criações/edições, importações e ações relevantes ficam registradas.
• Por privacidade, apenas Admin vê endereços IP no log de auditoria.

/help
/whoami
/link TOKEN
/novo
/novo Nome;Telefone
/novo Nome;Telefone;RA
/novo Nome;Telefone;RA;INTENCAO;PROB;ENDERECO;NOTAS
/lideranca
/lideranca VOTER_ID;TIPO;COMPROMISSO;NIVEL;ALCANCE;NOTAS
/ra
/endereco ENDERECO
/endereco VOTER_ID ENDERECO
/buscar termo
/atualizar VOTER_ID campo=valor
/responsaveis
/tarefa VOTER_ID;TITULO;PRAZO;PRIORIDADE;RESPONSAVEL_ID;NOTAS
/ia SUA_PERGUNTA
/gemini SUA_PERGUNTA
/cancelar

/novo Rodrigo Roriz;99853333;Lago Sul;SIM;100%;SHIS QI 11 Conj 08 Casa 20;Encontrei no evento

O bot aceita telefone com DDD (ex: 61998533333) ou +55. Se você enviar apenas 8/9 dígitos, ele tenta assumir DDD 61.

• Use /ra e selecione sua RA uma vez.
• Depois use /novo Nome;Telefone e o bot reaproveita a RA (e abre seletor de intenção).
• Avançado: para mandar tudo em uma linha usando RA padrão, você pode pular a RA deixando vazio:

/novo Nome;Telefone;;SIM;90

• Envie uma Localização durante ou logo após salvar um eleitor para registrar coordenadas automaticamente.

1. Comece por tarefas atrasadas e vencem hoje.
2. Registre toda comunicação relevante (não confie em memória/WhatsApp).
3. Todo pedido de retorno vira Próximos passos (gera tarefa).
4. No fim do dia: revise TALVEZ/INDEFINIDO e programe follow-ups.

• Inclua rua/quadra + número + bairro/RA quando souber.
• Exemplos: "QS 308 Conj 2 Casa 10, Samambaia"; "SHIS QI 11 Conj 08 Casa 20, Lago Sul".
• Evite: "perto do mercado" (não geocodifica).

• Seu usuário não tem permissão para a RA escolhida.
• Um Admin deve ir em Usuários e adicionar a RA ao seu escopo.
• Se veio do Telegram: confirme se o texto da RA está correto (ex: "Samambaia" ou "RA-XII").

• Sem endereço/coords: o eleitor pode não aparecer no mapa.
• Ative Somente com coordenadas para confirmar quantos estão geocodificados.
• Revise endereços com pouca informação e salve novamente.

• Reescreva como pergunta de contagem/consulta.
• Inclua RA e período.
• Evite ponto e vírgula e qualquer comando de escrita.

• Clique em Atualizar na própria aba Território.
• Se persistir, faça recarga forçada do navegador (Ctrl+Shift+R).
• Confira se o período não está muito restrito para seu escopo.
• Como Super Admin, se continuar vazio, reporte horário exato + usuário para análise de logs.