6.3 KiB
Sollinha: municípios sem dobradinha (cobertura de parcerias)
Status: plano — registrado (blocked até plano em main) Atualizado em: 2026-08-09 Issue: #527 Priority: P2 Model: composer-2.5 Model-local: deepseek-v4-flash-high Impeccable: A — N/A (resposta em texto no chat existente; nenhuma superfície nova) Canvas UI: N/A — sem UI Appetite: ~0,5–1 dia eng; uma tool nova read-only + testes; sem migration/collection/Consent
Intenção
O pedido original de gestão cobre três domínios — municípios, lideranças e dobradinhas — e o Sollinha ainda não enxerga a cobertura de parcerias: "em quais municípios ainda não temos dobradinha?" Um município sem dobradinha é uma frentes de mobilização a explorar (o deputado estadual parceiro puxa voto para a chapa); saber onde a parceria não existe é o primeiro passo para decidir onde buscá-la. O mesmo vale no sentido inverso: dobradinhas cadastradas sem município vinculado são parceiros órfãos que o coordenador pode estar esquecendo de usar.
Persona e fluxo
- Persona / contexto: coordenador em
/campanha, no chat, planejando onde ativar/formalizar dobradinhas; assessor conferindo o próprio escopo. - Job principal: saber, em linguagem natural, quais municípios do escopo estão sem dobradinha (ou quais dobradinhas estão órfãs), com contagem e links para agir.
- Fluxo desejado:
- "Em quais municípios ainda não temos dobradinha?" → o Sollinha cruza o catálogo de municípios do escopo com os vínculos
municipality.stateDeputiese responde lista + contagem, com link para cada município. - "Quais dobradinhas estão sem município?" → responde os parceiros órfãos, com link.
- O usuário refina por região/cidade; liderança nunca vê nada (fail-closed).
- "Em quais municípios ainda não temos dobradinha?" → o Sollinha cruza o catálogo de municípios do escopo com os vínculos
- Anti-goals de produto: não qualificar/ranquear dobradinhas existentes; não sugerir deputados estaduais-alvo para abordar (depende de dado de candidato estadual que não está garantido no escopo do app); não virar consulta eleitoral.
Objetivo e aceite
- O Sollinha responde "quais municípios estão sem dobradinha" no escopo do usuário, com contagem e um item por município, ordenável por região/cidade.
- Responde "quais dobradinhas estão sem município vinculado" (órfãs), com contagem e links.
- Salvador aparece agrupada por cidade por padrão (19 ZE como uma unidade), com opção de detalhar por ZE.
- Links de navegação para o detalhe de cada município/dobradinha (precedente B162).
- Assessor vê apenas o próprio escopo; leader recebe acesso negado (fail-closed, sem dados).
Dados (intenção)
- Vou apresentar dados? Sim — lista de cobertura de parcerias, como superfície deste item (no chat).
- Decisões desbloqueadas: coordenador decide onde buscar/formalizar dobradinha; assessor identifica parceria faltando no seu território.
- Forma: adiada ao plano de implementação. Restrições de produto: lista exaustiva com contagem (cobertura, não top N); leitura relativa ao escopo do usuário; sem % estadual.
Direção no codebase (hipótese)
- Áreas prováveis: nova tool em
src/utilities/ai/tools/(família degetDobradinhas), registrada noindex.ts; fonte:municipality.stateDeputies(hasMany) e a coleçãostateDeputy(municípios vinculados); reuso debuildCampaignLinks(destinationsmunicipality/dobradinha). - Precedente a olhar:
src/utilities/ai/tools/getDobradinhas.ts(leitura atual de dobradinhas por município);docs/plans/sollinha-liderancas-pendentes-abordagem.md(B185 — fonte da semântica compartilhada da família);docs/plans/sollinha-tools-eleitorais-leader-lockdown.md(B180 — gate fail-closed por papel). - Risco de acoplamento: dobradinhas são dados de campanha (staff-only por RBAC) — gate por papel igual à família; não tocar dados eleitorais (lockdown B180 intacto).
Dependências
- Soft: B185/B186/B189 (família de gestão — mesma convenção de escopo e gate por papel; sem ordem obrigatória).
Fora de escopo
- Sugerir quais deputados estaduais abordar em municípios sem dobradinha (exigiria catálogo de candidatos estaduais — não garantido no escopo de dados atual; registrar como candidato futuro se o dado existir).
- Avaliar qualidade/potencial das dobradinhas existentes.
- Dashboard/mapa de cobertura de parcerias.
Rabbit holes de produto
- Virar consulta de candidatos estaduais. Se alguém "só completar", o item cresce para "monte a chapa ideal por município". Corte: só a cobertura (tem/não tem), sem ranking de quem abordar.
- Salvador vira 19 linhas. Listar os ZE separados polui a leitura de cobertura. Corte: agrupar por cidade; detalhar por ZE só quando pedido.
- Confundir "sem dobradinha" com "sem dado". Município sem vínculo pode ser dado faltando no cadastro. Corte: a resposta declara que a leitura é sobre o cadastro atual ("não há dobradinha vinculada no sistema").
Questões em aberto (produto)
- Dobradinhas órfãs entram no mesmo aceite? Opções: (A) sim — mesma tool, dois modos de saída (recomendado no menu do gate); (B) só municípios sem dobradinha. Recomendação: (A) — o parceiro órfão é a mesma lacuna vista pelo outro lado. (assumido — validar)
- Salvador agrupada por cidade? Opções: (A) agrupar (recomendado); (B) 19 ZE individualizados por padrão. Recomendação: (A) — cobertura é leitura por unidade operacional (cidade), com drill-down opcional. (assumido — validar)
- Incluir "sem liderança" e "sem dobradinha" num mesmo modo de cobertura do município? Opções: (A) não — domínios separados (liderança é B185, dobradinha é este item); (B) sim, um modo "raios-X do município". Recomendação: (A) — cada lacuna tem dono e aceite próprios; combo vira dashboard (anti-goal). (assumido — validar)
Referências
src/utilities/ai/tools/getDobradinhas.ts— leitura atual de dobradinhas (precedente)src/collections/StateDeputy.ts+Municipality.ts(campostateDeputies) — vínculossrc/utilities/ai/tools/buildCampaignLinks.ts— links na resposta (B162)docs/plans/sollinha-liderancas-pendentes-abordagem.md(B185) — família de gestão (escopo/gate)docs/plans/ai-chat-sollinha.md— arquitetura do chat (imutável,in-prod)