teqo-backup/docs/research/README.md

14 KiB
Raw Blame History

docs/research — embasamento de produto (campanha DF-BA)

Artefatos do ciclo de discovery "literatura → persona → entrevista → docs de produto" (2026-07-21). Servem de embasamento teórico para decisões de produto do /campanha — em especial métricas territoriais, o Mapa das Praças e o programa de inteligência.

Artefato O quê Status
literatura-campanha-deputado-federal-ba.md Compêndio da literatura (5 eixos + cartografia/métricas + agregações + alienação eleitoral), ~67 fontes e implicações aprovado 2026-07-21
persona-cientista-politico-campanha-ba.md Persona especialista sintética (Prof. Helena Rocha) grounded no compêndio aprovado 2026-07-21
roteiro-entrevista-persona-campanha.md Roteiro Mom Test/JTBD/Lean Analytics para a entrevista sintética aprovado 2026-07-21
relatorio-entrevista-persona-campanha.md Relatório da entrevista (6 rodadas): kernel, rankings, playbook dado→decisão (25 padrões), OST, anti-goals + transcrição aprovado 2026-07-21 — canônico
sources/README.md Fila pause-and-fetch de obras sem acesso aberto (depósito legal de PDFs/EPUBs, gitignored) ativa

Consumo pelo produto: o relatório alimentou o programa Inteligência de campanha (E8–E15, B13, C12) — plano-mestre em docs/plans/inteligencia-campanha.md, itens no roadmap.

Limitação metodológica: a entrevista é sintética (persona construída a partir da literatura). Achados são hipóteses de literatura/persona, não fato de campo. A validação empírica é a sessão com o coordenador real (ver docs/CUSTOMER.md).

Ciclo 2 — Discovery de finanças de campanha (2026-07-28)

Mesmo método (literatura → personas → entrevistas sintéticas → relatório → validação real), aplicado à gestão financeira de uma campanha de DF na Bahia, sob três ângulos (financeiro-operacional, jurídico, político). Notebook do projeto: .agents/rules/projects/financas-campanha.mdc.

Artefato O quê Status
literatura-financas-campanha-df-ba.md Compêndio dos 3 eixos (regras 2026: Res. 23.752/2026, Conta+JE, FEFC/cotas; operação do dinheiro; economia política), 48 fontes rascunho 2026-07-28
persona-financas-contadora-eleitoral.md Persona sintética "Márcia Anunciação" — contadora eleitoral (ângulo financeiro-operacional) rascunho 2026-07-28
persona-financas-advogado-eleitoral.md Persona sintética "Dr. Rafael Guimarães" — advogado eleitoralista (ângulo jurídico) rascunho 2026-07-28
persona-financas-tesoureiro-politico.md Persona sintética "Tonho Bastos" — tesoureiro político de campanha (ângulo político) rascunho 2026-07-28
roteiro-entrevista-financas-personas.md Roteiro Mom Test adaptado (blocos A–F + sondas por persona), aplicado às 3 personas em subagents isolados rascunho 2026-07-28
relatorio-entrevistas-financas-personas.md Relatório consolidado: kernel (2 gargalos em série), 12 dores ranqueadas, spec do "registro seguro", OST draft, anti-goals, 12 apostas + transcrições rascunho 2026-07-28 — a validar
roteiro-entrevista-gestora-financeira-real.md Roteiro Mom Test da sessão real com a gestora financeira da campanha (confirmar/derrubar as apostas; artefato-first) agendada — 2026-07-29

Limitação metodológica (ciclo 2): as três personas bebem do MESMO compêndio — convergência entre elas não é evidência independente. Nada entra no roadmap antes da entrevista real com a gestora e da revisão do advogado da campanha (o compêndio não é parecer jurídico).

Decisão 2026-07-28 (origem do discovery: pedido do candidato): não complicar o Teqo sem uma dificuldade real validada — módulo financeiro completo descartado para o ciclo 2026; a avaliação pré-validação (P0–P2 + condições de morte/vida da trilha) está no notebook do projeto e será confrontada com a entrevista real de 2026-07-29.

Ciclo 3 — Discovery de emendas parlamentares (mandato/comunicação) (2026-07-28)

Mesmo método (literatura → personas → entrevistas sintéticas em subagents isolados, 2 rodadas com acareação → relatório → roteiro para a sessão real), aplicado ao registro e acompanhamento das emendas parlamentares do mandato — a visão de produto por trás (contexto, NÃO decisão): um ledger de emendas numa vertical nova /mandato, consumido pela campanha (/campanha, ex.: dossiê de município — pedido real O6) e por uma vertical de comunicação (/comunicacao). Quatro ângulos: o deputado (dono político), a assessoria de orçamento (operadora da planilha), a comunicação do mandato (transforma execução em anúncio) e o coordenador de campanha (consumidor — persona ancorada na evidência real de 2026-07-23, campos [R]/[S]). Notebook do projeto: .agents/rules/projects/emendas-mandato.mdc.

Artefato O quê Status
literatura-emendas-mandato-df.md Compêndio dos 4 eixos (A ciclo operacional-orçamentário 2025–2026; B jurídico-eleitoral do ano; C emenda como moeda/credit claiming; D dados públicos e APIs) rascunho 2026-07-28
persona-emendas-parlamentar.md Persona sintética "Almerindo Vasconcelos" — deputado federal, 3º mandato (o principal) rascunho 2026-07-28
persona-emendas-assessor-orcamento.md Persona sintética "Cristiane Damasceno" — assessora de orçamento, a operadora da planilha rascunho 2026-07-28
persona-emendas-coordenador-comunicacao.md Persona sintética "Soraia Meirelles" — coordenadora de comunicação do mandato (eixos B/C) rascunho 2026-07-28
persona-emendas-coordenador-campanha.md Persona sintética "Nivaldo Cerqueira" — coordenador-geral de campanha, consumidor de dados de emenda (ancorada em evidência real [R] de 2026-07-23) rascunho 2026-07-28
roteiro-entrevista-emendas-personas.md Roteiro Mom Test adaptado (blocos A–F + sondas por persona + protocolo da rodada 2/acareação) rascunho 2026-07-28
relatorio-entrevistas-emendas-personas.md Relatório consolidado: kernel, 12 dores ranqueadas (matriz 4 personas), fluxo as-is, 7 tensões resolvidas na acareação, OST mapeado às 3 verticais, anti-goals, 14 apostas + transcrições integrais rascunho 2026-07-28 — a validar
roteiro-entrevista-emendas-responsavel-real.md Roteiro Mom Test da sessão real com a pessoa do gabinete que mantém a planilha de emendas (artefato-first; não é auditoria) aguardando agendamento

Limitação metodológica (ciclo 3): as quatro personas bebem do MESMO compêndio — convergência é consistência de leitura, não evidência independente; o que informa é a divergência entre lentes de papel. Exceção parcial: a persona 4 ancora os campos [R] na entrevista real de 2026-07-23 (docs/CUSTOMER.md). Nada entra no roadmap nem vira código antes da validação com a pessoa real do gabinete — inclusive a criação das verticais /mandato e /comunicacao. O eixo B do compêndio não é parecer jurídico; qualquer registro novo da camada política passa pelo advogado antes de existir.

Piloto de fonte — acervo de falas da Câmara (C152, 2026-09-12)

Viabilidade da fonte do acervo de falas (Issue #954): 2–3 discursos de legislaturas diferentes processados ponta a ponta (evento → trecho → VOD → transcrição ASR com segmentos). Não é discovery de produto — é relatório de engenharia que destrava C153/C154/C155.

Artefato O quê Status
piloto-fonte-videos-camara.md Respostas às 4 incógnitas da fonte (permanência do link, trechos em 55ª/56ª, segmentos Deep Infra, casamento antigo), custos e fallbacks concluído 2026-09-12
piloto-fonte-videos-camara-impl.md Plano de implementação do piloto (script + lib pura + unit tests) executado

Relatório — sobreposição Solla × Ceuci em Salvador (C157, 2026-09-14)

Comparação da votação de 2022 de Jorge Solla (federal, nº 1313) e Ceuci Nunes (estadual, nº 13192) nas 19 zonas eleitorais de Salvador e nos bairros: mapas por ZE e por bairro, tabelas de sobreposição e plano de campanha para acionar a rede e a memória de Ceuci (apoiadora do mandato, sem candidatura em 2026). Dados públicos TSE 2022; o limite "não existe voto por bairro" está documentado no próprio relatório.

Artefato O quê Status
analise-sobreposicao-solla-ceuci-salvador-2022.pdf Relatório final em PDF (15 páginas) — mapas, tabelas, leitura da ciência política e plano entregue 2026-09-14
analise-sobreposicao-solla-ceuci-salvador-2022.md Companion em Markdown com os números e a proveniência (os mapas vivem no PDF) entregue 2026-09-14
solla-ceuci-salvador-2022-dados.json Entrada do gerador: votos e tallies por ZE, com proveniência e conferências cruzadas congelado
../plans/relatorio-sobreposicao-solla-ceuci-salvador.md Plano de intenção (+ impl) executado