Índice

1. O que é o PolíticaBA
2. Conceitos fundamentais
3. Quem vê o quê — perfis de acesso
4. Primeiros passos
5. Navegação e interface
6. Dashboard
7. Mapa Eleitoral
8. Deputados
9. Emendas & Legislação
10. Radar ALBA
11. Minha campanha — visão geral
12. Minha campanha — módulo a módulo
13. Anotações
14. Equipe, papéis e convites
15. Configurações
16. Período de teste e assinatura
17. Compliance, IA e limites eleitorais
18. Fluxo de trabalho sugerido para a equipe
19. Glossário
20. Perguntas frequentes
21. Administração da plataforma (operadores)

---

1. O que é o PolíticaBA

O PolíticaBA é uma plataforma de inteligência política da Bahia. Integra dados públicos oficiais — TSE, IBGE, Câmara dos Deputados, ALBA, CGU (emendas federais), SEFAZ-BA (emendas estaduais) — em ferramentas de monitoramento, diagnóstico territorial e planejamento de campanha.

O que a plataforma faz

O que a plataforma não é

• Não é pesquisa de opinião nem instituto de tracking.
• Não garante vitória eleitoral.
• Não substitui advogado eleitoral.
• Narrativas factuais e projeções com IA são rascunhos orientativos — revisão humana obrigatória.

Dois mundos de dados

┌─────────────────────────────────────────────────────────────┐
│  DADOS PÚBLICOS (Bahia inteira)                             │
│  Mesmos para todos: votos, deputados, emendas, proposições    │
└───────────────────────────┬─────────────────────────────────┘
                            │ leitura + filtros pelo escopo
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  DADOS DA SUA CAMPANHA (privados)                           │
│  Escopo, anotações, preferências e rascunhos — só sua equipe │
└─────────────────────────────────────────────────────────────┘

Os dados eleitorais e legislativos não são copiados por campanha. O que é privado é o que sua equipe cria: escopo territorial, notas, configurações e rascunhos de IA.

---

2. Conceitos fundamentais

Campanha

Unidade de trabalho no PolíticaBA. Cada campanha tem:

• Nome (ex.: “Campanha João Silva”)
• Status: Período de teste · Campanha ativa · Teste encerrado · Campanha suspensa
• Membros com papéis diferentes
• Escopo territorial — define onde a campanha “olha”
• Dados privados — anotações e preferências

Regra: uma pessoa = uma campanha por conta (não é possível pertencer a duas campanhas ao mesmo tempo).

Escopo territorial

Configuração que personaliza as ferramentas da campanha:

Sem escopo configurado, as ferramentas de campanha mostram a Bahia inteira ou ficam genéricas.

Pleito / ano eleitoral

Eleição de referência nos mapas e diagnósticos. Hoje: 2018 e 2022 (deputados federais e estaduais). O seletor de pleito aparece no Mapa e no Diagnóstico.

Deputado em destaque

Candidato ou mandatário que a campanha acompanha. Pode ser federal, estadual ou ambos. Quando há os dois, o Diagnóstico exibe abas para alternar o cargo.

Caminho da vitória

Módulo dentro do Diagnóstico que compara o desempenho histórico do deputado em destaque com o corte do último eleito (39.º lugar federal / 63.º estadual em 2022) e sugere meta incremental de votos por município no escopo.

Referência histórica de 2022 — orientação para planejamento, sem garantia de resultado em 2026.

Sensor de pauta

Agregação de temas em alta (Trends, diários oficiais, imprensa, YouTube, Meta). Mostra assuntos, não pessoas — sem perfilamento de eleitores.

Convite cortesia vs. convite de equipe

---

3. Quem vê o quê — perfis de acesso

Visitante (sem login)

• Acessa o Dashboard (/) com indicadores reais da Bahia e o Guia da plataforma (/guia).
• Menu lateral visível, mas Mapa, Deputados, Radar, Minha campanha etc. aparecem bloqueados (cadeado).
• Rodapé da sidebar: botões Entrar e Criar campanha (7 dias).

Usuário logado — etapas de liberação

Papéis na campanha

Operador da plataforma

Papel interno da equipe PolíticaBA (is_platform_admin), distinto dos papéis da campanha (Responsável, Coordenador, etc.).

Usuários de campanha não têm esse acesso. Detalhes na §21.

---

4. Primeiros passos

4.1 Criar campanha (7 dias de teste gratuito)

1. Acesse Criar campanha (/criar) ou o botão na sidebar.
2. Informe nome, e-mail e senha (mínimo 8 caracteres, letras e números).
3. Opcional: login com Google ou Microsoft.
4. Se houver captcha (Turnstile), confirme antes de enviar.
5. A plataforma cria sua conta + campanha + período de teste de 7 dias.

4.2 Verificar e-mail

1. Após o cadastro, vá para Verificar e-mail (/verificar-email).
2. Abra o link recebido (serviço Resend).
3. Sem verificação, Mapa, Diagnóstico e demais ferramentas permanecem bloqueados.
4. Após clicar no link, a sessão é atualizada automaticamente — em geral não é necessário sair e entrar de novo.
5. Botão Reenviar e-mail — intervalo mínimo de 2 minutos entre envios.

4.3 Onboarding (configuração inicial)

Disponível para Responsável e Coordenador na primeira entrada (/onboarding):

Botões:

• Salvar e ver diagnóstico — recomendado; vai para /minha-campanha/diagnostico.
• Pular por agora — libera o mapa; escopo pode ser configurado depois em Escopo territorial.

Analistas e perfis de Leitura não passam pelo onboarding — vão direto ao mapa.

4.4 Entrar com conta existente

1. Entrar (/login).
2. E-mail/senha ou OAuth.
3. Se já logado, redireciona para Mapa ou Onboarding (se pendente).
4. Para alterar a senha (contas e-mail/senha): Configurações → Conta (/configuracoes/conta).

4.5 Aceitar convite

1. Abra o link recebido: /convite/[token].
2. A tela mostra: tipo (cortesia ou equipe), nome da campanha, papel e e-mail do convite.
3. Conta nova: defina nome e senha → aceitar.
4. Conta existente: faça login com o mesmo e-mail do convite → aceitar.
5. Cortesia → onboarding; equipe → Minha campanha.

---

5. Navegação e interface

Menu lateral (sidebar)

Guia da plataforma (/guia)

Manual completo dentro do PolíticaBA, com busca e índice navegável. Disponível para visitantes e usuários logados — não exige campanha ativa.

• Busca: prioriza títulos de capítulos e subseções; ignora acentos; mínimo 2 caracteres por palavra.
• Resultados: só trechos relevantes; menções soltas no texto não poluem a lista.

Flyout “Minha campanha”

Visão geral · Diagnóstico · Calendário 2026 · Contexto territorial · Narrativas factuais IA · Projeção · Escopo territorial · Equipe · Assinatura · Anotações

Flyout “Deputados”

Galeria de fotos · Raio-x comparativo · Raio-x individual

Cabeçalho (barra superior)

• Título da página atual (ex.: “Mapa Eleitoral”, “Minha campanha”).
• Descrição contextual abaixo do título.
• Usuário logado: nome/e-mail; alerta âmbar se e-mail pendente.
• Tema claro/escuro e Sair.

Páginas sem sidebar

Login, Criar campanha e Aceitar convite usam layout centralizado (cartão de autenticação).

---

6. Dashboard

Rota: /
Acesso: público (visitante e logado).

KPIs (quatro cartões)

Últimas proposições ALBA

Até três proposições recentes: tipo, número/ano e assunto.

Acesso rápido

Três atalhos para Mapa, Deputados e Radar. Visitantes veem cadeado; logados com acesso válido navegam direto.

Faixa “Atualização dos dados”

Painel retrátil no rodapé do Dashboard (fechado por padrão). Ao expandir, mostra a idade de cada fonte (TSE, ALBA, Câmara, IBGE, CGU, emendas BA) com data e hora. Indica quando os dados foram importados — não necessariamente eventos do dia.

Estado vazio

Se os dados ainda não foram carregados: mensagem “Painel em preparação” — os indicadores aparecem após a atualização automática das fontes públicas.

---

7. Mapa Eleitoral

Rota: /mapa
Parâmetro: ?ano=2018 ou ?ano=2022 (pleito).

Para que serve

Visualizar padrões territoriais de votação em todos os municípios da Bahia. É a ferramenta central de exploração eleitoral — útil para reuniões de estratégia, identificação de redutos e comparação entre pleitos.

Métricas disponíveis

Controles

• Seletor de pleito (2018 / 2022).
• Legenda dinâmica conforme a métrica.
• No mobile, métricas em menu suspenso; no desktop, botões.

Mensagens especiais

• Mapa indisponível — mapa municipal ainda em preparação.
• Indicador territorial — se ainda não houver dados, o seletor exibe “Indicadores em preparação” (atualização automática das fontes).
• Avisos quando votos por partido/deputado ou indicador não existem no banco.

Uso pela equipe

Dica: combine o mapa com o Escopo — municípios fora da mesorregião de foco ainda aparecem no mapa global, mas o Diagnóstico e Oportunidades respeitam o escopo.

---

8. Deputados

8.1 Galeria de fotos (/deputados/galeria)

• Abas Federal e Estadual.
• Cards com foto, nome (link para raio-x), partido.
• Federais: e-mail institucional quando disponível.
• Estaduais: situação na ALBA, cargo na mesa, presenças/faltas e proposições em 2025.

Uso: visão rápida da bancada; ponto de partida para aprofundar no dossiê.

8.2 Raio-x individual (/deputados/raio-x-individual)

Dossiê completo de um deputado. Seções (conforme dados disponíveis):

Parâmetros: ?cargo=federal|estadual&id=[id do deputado]

Uso pela equipe: monitorar adversários e aliados; registrar impressões em Anotações (visíveis só na sua campanha). Monitorar adversário é permitido — são dados públicos; o privado é o que vocês escrevem.

Emendas federais — leitura dos valores: a tabela exibe o valor pago importado do Portal da Transparência (última atualização automática). Emendas com destino MÚLTIPLO referem-se a vários estados/municípios — o valor na tela é o total da emenda, não a parcela de um município. Para conferência detalhada, use o link do Portal da Transparência na seção de emendas.

8.3 Raio-x comparativo (/deputados/raio-x-comparativo)

Tabela ordenável comparando toda a bancada:

Federal: Deputado, Partido, Votos 2022, Municípios com voto, Proposições, Emendas, Empenhado, Liquidado, Pago.

Estadual: + Mesa, Presenças, % presença.

Uso: ranquear desempenho legislativo e eleitoral; identificar quem entrega emendas no território da campanha.

---

9. Emendas & Legislação

Rota: /legislacao

Abas

1. Emendas — emendas parlamentares com valores empenhados, liquidados e pagos.
2. Projetos de Lei — proposições por deputado ou partido.

Filtros

• Esfera: Deputado Federal ou Deputado Estadual.
• Filtrar por: deputado específico ou partido.

KPIs (aba Emendas)

Emendas · Empenhado · Liquidado · Pago — totais conforme filtros.

• Link externo para o Painel Transparência Bahia.

Campanhas consultam emendas e projetos. A atualização dos dados é automática e periódica.

Uso pela equipe

• Verificar entrega de recursos no escopo (municípios da mesorregião).
• Cruzar com Radar → Oportunidades (emendas com baixa execução).
• Preparar argumentos de “presença fiscal” do deputado em destaque.

---

10. Radar ALBA

Rota: /radar
Parâmetros: ?aba=alba|pauta|oportunidades · ?cargo=federal|estadual (oportunidades).

Aba ALBA (padrão)

Lista de proposições recentes na Assembleia Legislativa da Bahia. Filtros por tema, autor e tipo.

Uso: acompanhar atividade legislativa estadual no dia a dia.

Aba Pauta (?aba=pauta)

Sensor de pauta — temas em evidência:

• Google Trends (Bahia)
• Diários oficiais (DOE, DOOL)
• Imprensa
• YouTube e Meta (temas agregados)

Camada orientativa — não substitui pesquisa qualitativa. Mostra temas, não pessoas. Sem perfilamento de eleitores.

Uso: reunião de comunicação — “o que está no ar esta semana?”

Aba Oportunidades (?aba=oportunidades)

Exige campanha ativa com escopo configurado. Se não houver, a aba redireciona para ALBA com CTA para entrar.

KPIs

Tabelas detalhadas

Municípios subexplorados · Alta abstenção · Emendas federais/estaduais paradas · Pauta ALBA do deputado estadual em destaque.

Dados históricos e agregados — não são previsão eleitoral.

Uso: priorizar agenda de campo — “onde ir primeiro?”

---

11. Minha campanha — visão geral

Rota: /minha-campanha

Painel-resumo da campanha. Exige login, e-mail verificado e vínculo com campanha.

O que aparece

1. Cabeçalho — nome da campanha, seu papel, status (ex.: Período de teste até DD/MM/AAAA).
2. Quatro cartões de atalho:
   • Calendário 2026 — contagem regressiva.
   • Diagnóstico — abstenção média no escopo.
   • Escopo — “Configurado” ou “—”.
   • Anotações — quantidade de notas.
3. Resumo do escopo — mesorregião, destaques, partidos.
4. Notas recentes — últimas cinco anotações.
5. Link para Configurações → Aparência.

Papel de cada membro nesta tela

---

12. Minha campanha — módulo a módulo

12.1 Escopo territorial (/minha-campanha/escopo)

Quem edita: Responsável e Coordenador.
Quem só lê: Analista e Leitura (formulário desabilitado com mensagem explicativa).

Campos — mesmos do onboarding (ver §4.3).

Botão: Salvar alterações.

Efeito em cascata: ao salvar, atualizam-se Diagnóstico, Oportunidades, Narrativas factuais, Projeção e resumos em Minha campanha.

Uso em equipe:

1. Responsável define escopo na semana 1.
2. Coordenador ajusta destaques após convenção partidária.
3. Analistas não alteram escopo — evita divergência de números entre relatórios.

---

12.2 Diagnóstico territorial (/minha-campanha/diagnostico)

O módulo mais importante para planejamento de campo.

Cabeçalho e abas

• Se houver deputado federal e estadual no escopo: abas Federal / Estadual (?cargo=).
• Referência: pleito TSE (2022 por padrão).

KPIs

Tabelas analíticas

1. Onde a campanha é forte — municípios com melhor desempenho relativo.
2. Onde precisa avançar — municípios fracos ou abaixo da média.
3. Onde muita gente não votou — alta abstenção.
4. Ranking no território — ordenação completa.

Ação: link Ver no mapa → abre o Mapa com contexto.

Exportar: botão leva a /minha-campanha/diagnostico/export — relatório imprimível / Salvar como PDF (navegador).

Números da urna de 2022 — orientação para planejamento, sem garantia de resultado.

Caminho da vitória (seção no final do Diagnóstico)

Aparece quando há deputado em destaque configurado.

Tabela “Por município — onde buscar votos”

Uso em equipe (exemplo semanal):

---

12.3 Calendário 2026 (/minha-campanha/calendario)

Contagem regressiva até o 1º turno (outubro/2026).

Fase atual — pré-campanha, propaganda, pleito etc. (base TSE Res. 23.760/2026).

Marcos — datas futuras, passadas e “hoje”, com categorias:

• Prazos de filiação e registro
• Propaganda eleitoral
• Debates e mediação
• Silêncio eleitoral
• Dias de votação

Uso: pauta fixa na reunião de coordenação; alinhar Narrativas factuais IA com janelas regulatórias (ver §17).

---

12.4 Contexto territorial (/minha-campanha/contexto-territorial)

Cruzamentos voto × indicador no escopo:

Cada seção traz metodologia explícita (fontes IBGE SIDRA, TSE, CGU).

KPIs: Municípios no escopo · Com indicadores · Cruzamentos ativos.

Indicadores agregados — não identificam pessoas. Uso orientativo para priorização de agenda.

Uso: narrativa factual de “território esquecido”; subsídio para discursos e propostas (sempre com revisão humana).

---

12.5 Narrativas factuais IA (/minha-campanha/narrativas)

Gera rascunhos de texto em primeira pessoa (como se o próprio deputado estivesse falando), assistidos por inteligência artificial e ancorados em evidências reais — dados eleitorais, emendas, proposições, sensor de pauta e, opcionalmente, notícias recentes da região.

O que o módulo faz

Antes de redigir, a plataforma coleta e ranqueia evidências sobre o tema no território da campanha:

O texto gerado cita dados de forma natural; as citações com link (notícias, pauta) aparecem abaixo do rascunho para conferência.

Como usar

1. Informe o Tema do rascunho (ex.: “obras paradas no interior”, “saúde no sertão”, “entrega de emendas”).
2. Escolha o Formato:
   • Fala em evento — tom oral, 2–3 parágrafos
   • Post redes sociais — frases curtas e diretas
   • Release / nota — texto institucional contido
3. Escolha o Tom: Institucional · Popular · Técnico.
4. Marque ou desmarque “Incluir notícias recentes” sobre o tema na região do escopo.
5. Clique Gerar rascunho (a tela mostra etapas: coleta de evidências → redação).
6. Confira Fontes consultadas, o texto em 1ª pessoa, citações/evidências (com link quando houver) e o checklist TSE.
7. Marque “Revisei o rascunho e o checklist” antes de Copiar.

Limites

Bloqueios automáticos

Em 72 horas antes do 1º turno e 24 horas antes do 2º turno, a geração é suspensa (Res. TSE 23.760/2026).

Conteúdo assistido por IA — rascunho orientativo. Revisão humana obrigatória antes de qualquer uso em campanha. Notícias devem ser confirmadas na matéria original. Não constitui promessa de resultado eleitoral.

Uso em equipe:

Fluxo sugerido (comunicação):

Qua — Radar Pauta: identificar tema da semana
Qui — Narrativas factuais IA: gerar rascunho (fala ou post) com notícias ligadas
Sex — Responsável aprova após checklist; equipe adapta para canais

---

12.6 Projeção exploratória (/minha-campanha/projecao)

Três cenários para o deputado em destaque no escopo:

Cada cenário mostra votos projetados e premissas textuais.

Tabela municípios-chave — metas incrementais por município no cenário base.

Exportar relatório (PDF) → /minha-campanha/projecao/export

Projeção exploratória com base em dados históricos (TSE 2022). Não é previsão eleitoral nem garantia de vitória. Cenários ilustrativos para planejamento interno.

Uso: workshop de planejamento; não usar números como promessa pública.

---

12.7 Equipe (/minha-campanha/equipe)

Quem gerencia: apenas Responsável.

Membros atuais

Lista com nome/e-mail e papel (Coordenador, Analista, Leitura).

Convidar

1. Informe e-mail e papel.
2. Enviar convite — e-mail via Resend com link /convite/[token].
3. Convites pendentes: copiar link ou Revogar.

Regras:

• Um e-mail = uma campanha.
• Não convide quem já está em outra campanha.
• Convite expira em 14 dias.

Uso: estruturar equipe conforme tabela §14.

---

12.8 Assinatura (/minha-campanha/assinatura)

Quem contrata: apenas Responsável.

Plano: PolíticaBA Starter — mapa, diagnóstico, radar e ferramentas de campanha.

Formas de pagamento:

• Cartão (Stripe) — assinatura recorrente.
• PIX (Asaas) — pagamento via QR/código.

Acessível mesmo com o período de teste encerrado — é o caminho para reativar a campanha.

Após confirmação do pagamento, o status da campanha passa para Campanha ativa.

---

12.9 Anotações (/minha-campanha/anotacoes)

Lista completa de notas da campanha. Ver também §13 Anotações.

---

13. Anotações

Ferramenta de inteligência privada da campanha.

Onde criar notas

1. Raio-x individual — seção “Anotações da campanha” no dossiê.
2. Lista em Minha campanha — /minha-campanha/anotacoes.

Entidades suportadas

• Município
• Deputado federal
• Deputado estadual

Permissões

Uso em equipe

• Reunião de terreno: Analista anota impressões do município X.
• Monitoramento de adversário: nota no dossiê — “votou contra PL Y”.
• Handoff: Coordenador lê notas recentes na Visão geral antes de viagem.

As notas nunca são públicas nem compartilhadas entre campanhas.

---

14. Equipe, papéis e convites

Matriz de responsabilidades sugerida

O que cada papel faz na prática

Responsável

• Cria a campanha ou aceita convite cortesia.
• Define escopo e contrata assinatura.
• Convida equipe.
• Aprova narrativas factuais e projeções antes de uso externo.

Coordenador

• Mantém escopo atualizado.
• Lidera uso do Diagnóstico e Oportunidades.
• Edita anotações de qualquer membro.
• Não envia convites nem paga assinatura.

Analista

• Opera mapa, radar, legislação, contexto territorial.
• Produz rascunhos IA e exportações PDF.
• Mantém anotações de campo.

Leitura

• Acompanha dashboards e relatórios.
• Ideal para candidato que quer visibilidade sem risco de alterar dados.

Convite cortesia

Convite enviado pela equipe PolíticaBA a parceiros ou mandatários em avaliação:

1. Você recebe um link por e-mail.
2. Ao aceitar, cria-se uma nova campanha e você vira Responsável.
3. Acesso ativo imediato (sem período de teste de 7 dias).

---

15. Configurações

Rota: /configuracoes (redireciona para /configuracoes/aparencia)

Abas: Aparência · Conta

Aparência (/configuracoes/aparencia)

• Tema claro ou escuro.
• Preferência salva no navegador (local), não na nuvem.

Conta (/configuracoes/conta)

Segurança e método de acesso da sua conta.

Contas com e-mail e senha

Formulário Alterar senha:

1. Informe a senha atual.
2. Defina a nova senha e confirme (mesmas regras do cadastro: mínimo 8 caracteres, letras e números).
3. Salvar nova senha.

A nova senha deve ser diferente da atual. Mensagem de sucesso: “Senha alterada com sucesso.”

Contas OAuth (Google ou Microsoft)

A tela explica que o acesso é pelo provedor — não há senha local para alterar no PolíticaBA. A senha é gerenciada no painel Google ou Microsoft.

Escopo e anotações

Movidos para Minha campanha — /configuracoes/campanha redireciona para Escopo territorial.

---

16. Período de teste e assinatura

Período de teste de 7 dias

• Inicia no Criar campanha (self-service).
• Sem cartão no cadastro.
• Ao expirar: status Teste encerrado → bloqueio das ferramentas → /trial-expirado.

Acesso com período de teste encerrado

• /trial-expirado — explicação e contato.
• /minha-campanha/assinatura — checkout.
• /login, /criar, /verificar-email.

Contato

E-mail de suporte exibido quando o teste expira: rcrprojects10@gmail.com

Após assinatura

Status Campanha ativa — acesso irrestrito às ferramentas pelo ciclo pago.

---

17. Compliance, IA e limites eleitorais

Narrativas factuais IA — checklist TSE (obrigatório na tela)

1. Revisar fatos citados contra fontes oficiais (TSE, IBGE, CGU).
2. Confirmar notícias na matéria original (link nas citações) antes de publicar.
3. Evitar promessa de vitória, comparação depreciativa ou desinformação.
4. Conferir limites de propaganda conforme calendário TSE 2026.
5. Rotular material publicado como conteúdo de campanha quando aplicável.
6. Não usar para microtargeting ou perfilamento de eleitores.

Janelas de bloqueio IA

Disclaimers por módulo

LGPD e dados públicos

• A plataforma trabalha com dados agregados e oficiais.
• Anotações são dados da campanha — responsabilidade do Responsável quanto ao conteúdo digitado.
• Não há perfilamento de eleitores individuais.

Documentação jurídica complementar: evolution/compliance-ia-eleitoral.md · evolution/compliance-resumo.md.

---

18. Fluxo de trabalho sugerido para a equipe

Semana 0 — Configuração

Responsável: Criar campanha → Verificar e-mail → Onboarding (escopo)
           → Convidar Coordenador + Analistas em /equipe
Coordenador: Revisar escopo → Validar deputado(s) em destaque

Semana 1 — Diagnóstico

Analista:    Diagnóstico + Contexto territorial + Mapa (pleito 2022)
Coordenador: Radar → Oportunidades → lista de municípios prioritários
Responsável: Reunião com export PDF do Diagnóstico

Rotina semanal (campanha em andamento)

Comunicação e dados

Analista:    Radar Pauta + Oportunidades → tema; Narrativas factuais IA (formato + notícias)
Coordenador: Confere fontes consultadas e links; revisa checklist TSE
Responsável: Aprova versão final (nunca publicar rascunho bruto)

Planejamento numérico (interno)

Analista:    Projeção exploratória (3 cenários)
Coordenador: Cruza com Caminho da vitória
Responsável: Define metas de campo — sem divulgar projeção como promessa

Monitoramento de adversários

Analista:    Raio-x individual + anotações
Coordenador: Raio-x comparativo para benchmarking
Leitura:     Galeria e radar para acompanhamento passivo

---

19. Glossário

---

20. Perguntas frequentes

Posso ver dados de outra campanha?

Não. Anotações, escopo e configurações ficam restritos à sua campanha — outras equipes não têm acesso.

Posso monitorar um adversário?

Sim. Dossiê, mapa e emendas são dados públicos. Suas anotações sobre ele são privadas.

Por que o mapa mostra a Bahia inteira se meu escopo é uma mesorregião?

O Mapa é ferramenta global. Diagnóstico, Oportunidades e Contexto territorial respeitam o escopo.

E-mail verificado é obrigatório?

Sim, para Mapa e ferramentas de campanha.

Quantas campanhas posso ter?

Uma por usuário. Para nova campanha, use outro e-mail ou convite cortesia em conta nova.

Os dados estão atualizados?

Expanda a faixa Atualização dos dados no rodapé do Dashboard (fechada por padrão). Algumas fontes (TSE, ALBA) são atualizadas periodicamente e podem ter defasagem de alguns dias.

A IA pode publicar sozinha?

Não. Narrativas factuais exigem checkbox de revisão. Projeção é só export interno. Há bloqueio em vésperas de eleição.

Quantos rascunhos de narrativa factual posso gerar?

10 por semana por campanha (contador reinicia na segunda-feira, horário da Bahia). Cada rascunho tem no máximo 15.000 caracteres.

As narrativas factuais usam notícias da internet?

Sim, se a opção estiver marcada. A busca cruza o tema com municípios do seu escopo em notícias recentes. As matérias aparecem nas citações com link — confirme na fonte original antes de publicar.

Quem atualiza os dados públicos?

A equipe PolíticaBA mantém as fontes oficiais atualizadas automaticamente. Não é função da sua campanha.

Como alterar minha senha?

Configurações → Conta (/configuracoes/conta). Disponível para contas criadas com e-mail e senha. Contas Google/Microsoft gerenciam a senha no provedor.

Esqueci a senha — como recuperar?

Recuperação automática (link “esqueci minha senha” por e-mail) ainda não está disponível. Enquanto isso: contate o suporte (rcrprojects10@gmail.com) ou use login Google/Microsoft se a conta estiver vinculada a um desses provedores.

---

21. Administração da plataforma (operadores)

Público: equipe interna PolíticaBA com flag is_platform_admin. Usuários de campanha não veem estes menus.

Acesso

• Link Administração na sidebar → /admin
• Atualização de dados → /atualizacao (sync manual das fontes públicas; link também no rodapé do painel admin)

Após conceder operador a um e-mail, a pessoa deve sair e entrar de novo para o menu aparecer.

Rotas principais

Atualização de dados (/atualizacao)

Dispara importação batch para o PostgreSQL (IBGE, Câmara, ALBA, TSE, emendas federais CGU, emendas BA). Indicadores territoriais (sync:onda3) e sensor de pauta (sync:onda4) exigem comandos CLI no servidor — ver documentação operacional.

Em produção, a atualização rotineira é feita por cron; a UI pode estar restrita no servidor.

Documentação técnica: fase-admin-plataforma.md · dados-e-sincronizacao.md.

---

Manual do usuário PolíticaBA — atualizado 2026-08-23. Se algum detalhe diferir da tela, siga o que a aplicação exibe.