mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-13 15:13:07 +00:00
fa6933c1cd
Spike de viabilidade da fonte (sem DB/Payload): script + lib pura + unit tests; 3 discursos (55ª/56ª/57ª) processados ponta a ponta com segmentos ASR; relatório em docs/research/.
59 lines
12 KiB
Markdown
59 lines
12 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 |
|