Capture field evidence from the anchor session, update CUSTOMER/roadmap plans, and add vote-scenario and internal WhatsApp bridge specs with interview audio and transcripts.
22 KiB
Inteligência de campanha — do relatório de discovery ao produto (programa E8–E15 + B13 + C12)
Status: rascunho (plano-mestre; itens fatiados individualmente) Atualizado em: 2026-07-21 Item do roadmap: docs/roadmap.md (seção "Inteligência de campanha"; trilhas E/B/C) Impeccable: misto por item — E15 = A; E8/E9/C12/E10/B13/E14/E12 = B; E11/E13 = C (classe final no plano de cada fatia) Appetite: programa ~2–3 semanas eng no total, fatiado em slices de ~1–3 dias; nenhuma fatia bloqueia deploy da remodelagem Responsável: —
Fonte de produto: docs/research/relatorio-entrevista-persona-campanha.md (aprovado 2026-07-21) — kernel §2, playbook §6 (25 padrões P/T/I/J/K), OST §7 (O-A…O-K), anti-goals §8. Compêndio: docs/research/literatura-campanha-deputado-federal-ba.md.
Contexto
O discovery (literatura → persona → entrevista sintética, 2026-07-21) fixou o diagnóstico: a disputa de DF na Bahia é uma conta de quociente fragmentada (cadeira ~80–150 mil votos; topo estadual 4,71% dos válidos), o gargalo é converter lealdade de campo em voto nominal praça a praça via rede de mediação, e a informação dessa rede hoje é oral e sem série. O Teqo já tem o sistema de registro (Praças, lideranças, pledges, planos, demandas, baseline TSE 2014–2022 com brancos/nulos/abstenção por cargo). O que falta é a camada de inteligência: metas derivadas dos dados, leitura relativa do território, fila de decisão priorizada, sugestões dado→decisão com humano no loop, e o registro ex-ante que torna tudo auditável (backtest). Anti-goal do programa inteiro: "planilha chique" — KPI absoluto, cadastro bruto, mapa 0–100%.
Gaps de estrutura de dados (o que não estamos preparados para coletar/usar)
Auditoria relatório × schema atual (2026-07-21). O que já existe e cobre: electionTally tem aptos/comparecimento/abstencoes/votosValidos/votosBranco/votosNulo por cargo×ano×cidade×zona (roll-off e válidos projetados são deriváveis); electionCandidate tem party/coalition/runningAgain2026 (P3/herança aberta); plaza tem voteGoals (bom/regular/mínimo), expectedVotes, priority, politicalTrend, dobradinhaNotes, advisors, lastUpdateAt; votePledge tem declarado×estimado com autores/datas; plazaUpdate é imutável; bahiaTerritories.ts já mapeia município→Território de Identidade; actionPlan registra eventos com Praça/status/presença do deputado.
| # | Gap | Hoje | Como fechar | Fatia |
|---|---|---|---|---|
| G1 | Trajetória de pledge ("o que sabíamos em 15/08") — valor atual sobrescreve o anterior | votePledge guarda só o corrente |
versions: true (sem drafts) em votePledge + leitura da série; nunca sobrescrever vira garantia de plataforma |
C12 |
| G2 | Sinal qualitativo de rede tipado (invasão, esfriamento, visita de adversário, proposta a broker; fonte; triangulação) | plazaUpdate.kind = semanal/urgente/nota, texto livre |
Novo kind sinal + campos signalType, signalSource, triangulated (staff-only) |
C12 |
| G3 | Esforço/agenda por praça (o lado privado que evapora: dias de candidato, origem da visita, recurso) | actionPlan tem evento+status; sem origem nem custo |
actionPlan.origin (dado | pedido_broker | obrigacao_politica — J-B) + resourceCost staff-only opcional |
C12 |
| G4 | Decisão registrada ex-ante (sugestão dada, aceita/descartada, leitura alternativa, foto da classificação no momento) | Nada | Nova collection allocationDecision (plaza, patternId, suggestion, decision aceita|descartada|adiada, alternativeReading, snapshot, decidedBy/At) — também registra mudanças de nível N0–N4 |
C12 |
| G5 | Meta estadual e decomposição derivada (QE projetado, faixa da cadeira, potencial por praça) | plaza.voteGoals manual, sem conta de cima para baixo nem cobertura |
Global campaignGoals (meta estadual, margem, ano-base) + utilities de potencial (válidos projetados, captura, headroom) e cobertura Σpledges÷meta |
E8 |
| G6 | Definição de "campo" por ano (share intracampo, teto do campo) | electionCandidate.party existe; não há lista de partidos do campo por eleição |
Lib estática curada src/lib/campoParties.ts (ano → siglas/números) — dado de configuração, não collection |
E8 |
| G7 | Nível de envolvimento N0–N4 com regras de movimento e sinais de reversão | plaza.priority = alta/normal |
plaza.engagementLevel (n0…n4) + levelNote/levelChangedAt; mudança de nível registrada como allocationDecision; priority mapeado e aposentado |
E14 |
| G8 | Frescor como sinal de 1ª classe | derivável (declaredAt, lastUpdateAt) mas não exposto/normatizado |
Utilities de frescor + exposição na fila/lista ("coluna da vergonha": praça priorizada sem responsável/sem sinal) — sem migration | E9 |
| G9 | Perfil de abstenção por município (sexo/idade/escolaridade, TSE Eleitorado) | não importado | Adiado com gatilho (só se I-C virar prática): extensão do seed TSE | — |
| G10 | Malha Regiões Imediatas IBGE (teste de sensibilidade MAUP) | só TI (bahiaTerritories.ts) |
Adiado com gatilho (decisão cara sustentada por análise regional divergente): variante do build:geometries |
— |
Migrations do programa: uma consolidada por fatia que toca schema (C12: versions+kinds+origin+allocationDecision; E8: global campaignGoals; E14: engagementLevel). Todas antes do congelamento (~20/09).
A fila de prioridade do coordenador (desenho canônico)
Uma única fila ordena "todos" heterogêneos (gatilhos do playbook, demandas, praças sem responsável, sinais não triangulados, pledges velhos) pela hierarquia do relatório (§6.2), estendida aos objetos do produto:
- Estoque em risco confirmado — P1 ameaçado/P8 triangulado em praça de defesa relevante; demanda
escaladade praça N3/N4. - Falha de canal — P4 (broker único ≥ limiar), liderança-hub esfriando, praça priorizada cujo responsável saiu.
- Cobertura zero onde a meta exige — P6 priorizada, praça N2+ sem responsável/lideranças ("coluna da vergonha"), metas sem dono.
- Oportunidade com janela — P3 herança aberta (
runningAgain2026 = false), P5 expansão quente, convites pendentes de liderança nova, J-A (elegível madura com giro passando perto). - Otimização/higiene — T4 benchmark, T5 agenda dispersa, pledges sem atualização há N semanas, planos
realizadosem resultado, K-C metas implausíveis.
Regras transversais (de §6.2/§6.4, viram comportamento do produto): barato-antes-de-caro (todo gatilho gera primeiro a checagem de 48h para o assessor; só gatilho persistente/triangulado sobe para a reunião de realocação); desempate por votos em jogo; histerese (realocação cara exige 2 semanas de persistência; nível 1 fura a fila); gatilho de ausência dispara auditoria de registro, nunca ação de campo. A fila tem duas visões: do assessor (checagens e tarefas das suas Praças) e do coordenador (decisões de recurso caro, pauta da reunião quinzenal).
Fatias (funcionalidades faltantes)
| ID | Fatia (plano) | Entrega | OST | Classe | Appetite | Janela |
|---|---|---|---|---|---|---|
| E8 | Conta da cadeira | Global campaignGoals; potencial por praça (válidos projetados, captura do campo, share intracampo via campoParties.ts, roll-off, headroom); decomposição meta estadual→praça com sanity por TI; cobertura Σ(estimativa do cenário — default média via A10)÷meta no dashboard/lista; denominadores sempre válidos projetados (I-B) |
O-A | B | ~2d | 2 |
| E9 | Fila de alocação | Lista de decisão com as 7 colunas (§5.2 do relatório: votos em jogo, meta/cobertura/delta, classe, LQ/captura, rede+frescor, competição, tendência); ordenação default por déficit descoberto; ordenação de risco (defesa por frescor); "coluna da vergonha" | O-B, O-F | B | ~1,5d | 2 |
| C12 | Registro-fundação | Versions em votePledge; sinais tipados no plazaUpdate; actionPlan.origin+resourceCost; collection allocationDecision; garantia "nunca sobrescrever" |
O-E, O-G(base) | B | ~2d | 2 |
| E10 | Classificação territorial relativa | Recalibra defesa/ataque/indecisa/perdida com âncoras relativas (LQ vs. share estadual próprio; múltiplos do share da cadeira marginal), multi-eixo (dominância+importância+competição+teto do campo); substitui limiares 35/20/10 de electionInsights.ts para DF |
O-D | B | ~1d | 3 |
| B13 | Escala relativa no mapa | Modo de escala novo: quantis do próprio candidato (5 classes) default, LQ e rank na praça; símbolo proporcional por votos em jogo sobre o polígono; % dos válidos mantido como opção; roll-off como métrica adicional | O-C | B | ~2d | 3 |
| E14 | Níveis de envolvimento N0–N4 | engagementLevel com critérios, promoção/rebaixamento com histerese e sinais de reversão (via allocationDecision); vocabulário duplo (nível nunca exposto fora do staff — access) |
O-K | B | ~1d | 3 |
| E11 | Motor de sugestões v1 | Computa subconjunto dos padrões (P1, P2, P3, P5, P6, P7, K-A/K-B; demais por fase 2) por praça; sugestão com menu/estatuto/leitura-alternativa; aceitar/descartar grava allocationDecision; triagem 1–5 + histerese; "pauta do silêncio" mensal |
O-H | C | ~3d | 3 |
| E12 | Camada TI | Rollups por Território de Identidade com salvaguardas MAUP (razão de agregados, mediana+amplitude+praça crítica, Metropolitano decomposto); benchmark intra-TI (T4); gatilhos T1–T3/T5 no motor = fase 2 de E11 | O-I | B | ~1,5d | 3 |
| E13 | Planejador de presença/giros | Elegibilidade (5 condições ✓/—), fase do calendário (construção/consolidação/ativação), compositor de giro (J-C âncora+satélites+semente), visita pedida×justificada (J-B, usa actionPlan.origin) |
O-J | C | ~1,5d | 3 |
| E15 | Backtest pós-eleição | Pledge (trajetória) vs. voto realizado por zona; calibração de limiares E10/E14; relatório de aprendizado | O-G | A | ~1d | pós-04/10 |
Decisões travadas
- Sugestão nunca decide; staff decide. O motor detecta e faz diagnóstico diferencial estrutural; escolher/executar é humano, e a decisão (com leitura descartada) é registrada (relatório §6.3; anti-goal 8). Rejeitado: automação de ações (erro sem dono, custo político invisível ao dado); estimar probabilidades/elasticidades sem dado (falsa precisão).
- Denominadores: válidos projetados do cargo, nunca aptos (I-B; abstenção estrutural >35% em praças pequenas infla potencial). Rejeitado: aptos (viés sistemático pró-praça vazia); válidos da majoritária (cargo errado).
- Histórico por versions do Payload, não collection paralela de snapshots (G1). Menos código, mesma garantia, admin de graça. Rejeitado: collection
pledgeSnapshot(duplicaria access/hooks); sobrescrever comupdatedAt(destrói o backtest). - Nível N0–N4 é campo staff-only com access negando
leader— vocabulário duplo é requisito de produto, não polimento (relatório §6.8/anti-goal 11). Rejeitado: derivar nível só depriorityexistente (semântica insuficiente); expor nível na visão da liderança. - "Campo" por ano é lib estática curada (
campoParties.ts), editável por PR. Rejeitado: collection administrável (federações mudam raramente; curadoria exige contexto político, não CRUD). - i18n e naming seguem AGENTS.md: identificadores em inglês (
campaignGoals,engagementLevel,allocationDecision,signalType,origin), strings pt-BR; valores de enum expostos em URL/dado em pt quando forem dado (não é o caso aqui — enums internos ficam em inglês:n0…n4,aceita|descartada|adiadasão… valores de dado exibidos; manter pt para paridade com enums existentes tipoalta|normal).
Questões em aberto
- Quais padrões entram no motor v1? Opções: todos os 25 | subconjunto de maior confiança. Recomendação: os 8 listados em E11 (dados 100% disponíveis pós-E8/C12, menor risco de falso positivo); T/I/J na fase 2 após 2 semanas de uso real.
- Meta estadual inicial? Opções: QE cheio | faixa da cadeira 2022 (~80–150 mil) com margem. Recomendação: faixa da cadeira + margem definida pelo coordenador no global
campaignGoals(validar com produto na sessão Wed). - Limiar de broker único (P4)? Recomendação: iniciar em 50% dos pledges da praça / top-3 ≥ 40% do total, marcado calibrável; revisar no primeiro mês.
Abordagem proposta (visão de programa)
flowchart TD
C12["C12 Registro-fundação<br/>(versions, sinais, origin, decisões)"]
E8["E8 Conta da cadeira<br/>(metas derivadas, captura, roll-off)"]
E9["E9 Fila de alocação"]
E10["E10 Classificação relativa"]
B13["B13 Escala relativa no mapa"]
E14["E14 Níveis N0–N4"]
E11["E11 Motor de sugestões v1"]
E12["E12 Camada TI"]
E13["E13 Planejador de giros"]
E15["E15 Backtest pós-eleição"]
E8 --> E9 --> E11
C12 --> E11
C12 --> E14
C12 --> E15
E8 --> E10 --> B13
E10 -.classes.-> E9
E10 -.classes.-> E11
E8 --> E12
E8 -.metas.-> E14
E14 -.níveis.-> E11
C12 --> E13
E8 --> E13
E11 -.decisões acumuladas.-> E15
Reuso obrigatório (depth check): plazaElectoralBaseline.ts/plazaElectionGeography.ts (células cidade×zona), votePledgeData.ts (agregação por cenário pós-A10 — cenarios-estimativa-votos.md; default central), aggregatePledgesByPlaza/loadPlazaListPageBundle (A9+), BahiaMap+bahiaMapStyle.ts (B6/B11/B12), bahiaTerritories.ts (TI), electionInsights.ts (substituição E10), CampaignPageShell/CampaignMetricStrip, campaignAccess.ts, withPayloadTransaction.
Dependências
- Duras: deploy da remodelagem (schema
plaza/votePledgeem produção); A10→E8 (faixa pessimista/média/otimista antes da cobertura); E8→E9/E10/E12/E13; C12→E11/E15. Suaves: A6 dobradinha (melhora J-B/E13); dados reais da Onda 0 (o motor roda com dados fictícios no smoke, mas só vale com rede real); A10→C12 (versions capturam o group). - Nenhuma dependência de site público/admin.
Não escopo
- Previsão estatística de votos e elasticidades (fora de escopo do ciclo — roadmap "Fora de escopo"; E15 só compara ex-ante×resultado).
- Perfil de abstenção TSE e malha IBGE Imediatas (G9/G10 — adiados com gatilho acima).
- Polígonos de Praças-zona (B8) e qualquer mudança de geografia.
- Automação de mensagens/disparo (Res. TSE 23.610 art. 33; anti-goal).
- Import de planilhas de projeção (decisão E4 mantida).
Rabbit holes
- Motor v1 tentando cobrir os 25 padrões. Se alguém "só adicionar mais um": cada padrão exige dado confiável + descartes + calibração; metade dos 25 depende de sinais que só existirão com C12 rodando semanas. Mitigação: subconjunto fixo em E11; fase 2 com gatilho (2 semanas de uso + primeiros
allocationDecision). - Score de elegibilidade virar otimizador de rota. Roteirização (TSP, mapas de estrada) é produto inteiro. Mitigação: E13 ordena e agrupa por contiguidade de TI; rota fina é humana.
- Fila única virar segundo sistema de tarefas. Já existem demandas/planos/tasks. Mitigação: a fila REFERENCIA objetos existentes (demanda, plano, praça), não cria tarefa própria fora de
allocationDecision. - Rollup TI sem salvaguardas (média que mente). Mitigação: salvaguardas MAUP são requisito de aceite de E12, não polimento.
Adiado com gatilho
- G9 perfil de abstenção TSE. Revisitar quando I-C (ativação de núcleo) entrar no motor e o time pedir segmentação.
- G10 malha Regiões Imediatas. Revisitar quando uma decisão cara for sustentada por análise regional que diverge entre malhas (teste de sensibilidade §6.5).
- Padrões T/I/J no motor (fase 2). Gatilho: 2 semanas de E11 em uso + primeiras decisões registradas.
- Push de sugestões (D2). Gatilho: sino in-app entregue e fila com uso semanal real.
Referências
docs/research/relatorio-entrevista-persona-campanha.md— §2 kernel, §5 análises, §6 playbook completo, §7 OST, §8 anti-goalsdocs/research/literatura-campanha-deputado-federal-ba.md— fontes e implicações (§9)src/collections/Plaza.ts,src/collections/VotePledge.ts,src/collections/PlazaUpdate.ts,src/collections/ActionPlan.ts,src/collections/ElectionTally.ts,src/collections/ElectionCandidate.ts— schema auditado nos gapssrc/utilities/plazaElectoralBaseline.ts,src/utilities/votePledgeData.ts,src/utilities/plazaMapData.ts,src/lib/electionInsights.ts,src/lib/bahiaTerritories.ts— pontos de encaixedocs/plans/remodelagem-pracas.md— precedente de plano-mestre;docs/plans/escala-percentual-mapa-pracas.md— precedente do mapa- AGENTS.md — migrations (
pnpm migrate:create), access (overrideAccess: false), transações, naming