mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-13 15:13:07 +00:00
fa79e4da75
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
72 lines
15 KiB
Markdown
72 lines
15 KiB
Markdown
# 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`](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-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-entrevista-persona-campanha.md) | Roteiro Mom Test/JTBD/Lean Analytics para a entrevista sintética | aprovado 2026-07-21 |
|
||
| [`relatorio-entrevista-persona-campanha.md`](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`](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`](../plans/inteligencia-campanha.md), itens no [roadmap](../roadmap.md).
|
||
|
||
**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`](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-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-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-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-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`](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-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`](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-emendas-parlamentar.md) | Persona sintética "Almerindo Vasconcelos" — deputado federal, 3º mandato (o principal) | rascunho 2026-07-28 |
|
||
| [`persona-emendas-assessor-orcamento.md`](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-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-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-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`](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-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`](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`](../plans/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`](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`](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`](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`](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`](../../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`](../plans/relatorio-sobreposicao-solla-ceuci-salvador.md) | Plano de intenção (+ [`impl`](../plans/relatorio-sobreposicao-solla-ceuci-salvador-impl.md)) | executado |
|