fsolla/teqo-backup
1
0
Fork 0
mirror of https://github.com/fsolla/teqo.git synced 2026-11-13 06:43:06 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
teqo-backup/docs/research/README.md
Francisco Solla fa79e4da75 feat(C161): relatório Solla × Ceuci com votos por bairro (seções e locais de votação) 
A camada de bairro desce à seção eleitoral: votos por seção (votacao_secao_2022_BA),
cadastro seção → local → bairro (eleitorado_local_votacao_2022), aferição por seção
(detalhe_votacao_secao_2022_BA) e candidaturas válidas (votacao_candidato_munzona_2022);
133 coordenadas ausentes preenchidas pelo cadastro atual pelo número do local.

- JSON commitado: 138 bairros, 474 locais, 5.023 seções; Solla 27.264 e Ceuci 19.776
  conferidos zona a zona contra o recorte C157.
- Extrator scripts/build-solla-ceuci-salvador-bairros.mjs (--download cacheia em
  data/tse-2022/, gitignored; sem banco).
- Gerador revisado: mapas por bairro com dados reais, quadrantes de LQ, tabela de
  138 bairros e filas de ação por bairro.
- Personas refeitas com a base granular: sobreposição 62,9% nos bairros (vs 67,8%
  nas zonas); Ceuci supera Solla em 25 bairros com 61,6% do voto dela; redutos
  compartilhados Pituba/Brotas/Itaigara/Ondina/Graça/Imbuí/STIEP/Pituaçu; pontes
  Rio Vermelho/Cabula/Federação/Jardim Armação.
- Métricas puras de bairro + 9 unit tests; README e changelog atualizados.

Closes #992
2026-09-14 04:36:17 -03:00

15 KiB
Raw Permalink 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 + C161, 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, 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. A revisão C161 desceu à seção eleitoral e ao cadastro de locais de votação: cada bairro agora tem votos reais dos locais de votação que contém (138 bairros com votação, 474 locais, 5.023 seções), e não mais a zona pintada no centroide; a análise das personas foi refeita sobre a base granular.

Artefato O quê Status
analise-sobreposicao-solla-ceuci-salvador-2022.pdf Relatório final em PDF (20 páginas) — mapas por bairro, tabelas, leitura da ciência política e plano revisado 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) revisado 2026-09-14
solla-ceuci-salvador-2022-dados.json Entrada do gerador: votos e tallies por ZE, com proveniência e conferências cruzadas (camada congelada C157) congelado
solla-ceuci-salvador-2022-bairros-dados.json Camada de bairro (C161): 138 bairros, 474 locais e 5.023 seções com votos, coordenadas e hashes dos arquivos entregue 2026-09-14
../../scripts/build-solla-ceuci-salvador-bairros.mjs Extrator da camada de bairro (TSE → seção → local → bairro; --download cacheia os arquivos) entregue 2026-09-14
../plans/relatorio-sobreposicao-solla-ceuci-salvador.md Plano de intenção (+ impl) executado