teqo/docs/plans/sollinha-acoes-rapidas-chat.md

7.1 KiB
Raw Blame History

Sollinha: ações rápidas de abertura no chat (chips de pergunta)

Status: rascunho Atualizado em: 2026-08-09 Issue: #532 Priority: P2 Model: composer-2.5 Model-local: deepseek-v4-flash-high Impeccable: B — encaixe na superfície existente do chat (painel desktop / drawer mobile) Canvas UI: /home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-plans-plan-issue-18/canvases/plan-b191-ui-draft.canvas.tsx Appetite: ~0,5–1 dia eng; chips acima do input + envio como mensagem do usuário; sem migration/schema/Consent

Intenção

O Sollinha abre com uma tela em branco: o usuário precisa inventar a primeira pergunta do zero. Para quem está conhecendo o assistente (ou voltando com pressa), isso é atrito — o chat existe justamente para economizar tempo. Queremos que o chat abra com sugestões de próxima ação prontas: chips logo acima do input, com perguntas como "Quais as prioridades da campanha agora?", "Alguma demanda em aberta?" ou "Como está o município de X?". O clique dispara a pergunta diretamente no chat — o chip não navega para lugar nenhum, apenas vira a mensagem do usuário, como se tivesse sido digitada.

Persona e fluxo

  • Persona / contexto: assessor/coordenador abrindo o chat pela primeira vez na sessão ou após uma pausa; não sabe o que o Sollinha sabe fazer, ou sabe mas não quer digitar.
  • Job principal: fazer a primeira pergunta útil em um clique, descobrindo de relance o que dá para perguntar.
  • Fluxo desejado:
    1. Abre o chat (painel desktop ou drawer mobile) — conversa vazia.
    2. Acima do input aparecem 3–4 chips com perguntas prontas.
    3. Usuário toca num chip → o texto vira a mensagem e é enviada como se digitada; os chips de abertura somem (a conversa começou).
  • Anti-goals de produto: chips que navegam (isso é busca/FAB, não chat); chips que persistem depois que a conversa começou; lista infinita de sugestões; personalização por histórico de uso no v1.

Objetivo e aceite

  • Com a conversa vazia, o chat mostra chips de pergunta acima do input, em vez de só o placeholder vazio.
  • Tocar num chip envia aquela pergunta como mensagem do usuário e remove os chips de abertura.
  • Cada chip sugere uma pergunta que o Sollinha consegue responder bem hoje (nada de sugerir o que o assistente não tem ferramenta para responder).
  • Chips respeitam o papel: um leader não vê chip que aciona ferramenta eleitoral travada para ele (fail-closed, precedente B180).
  • Funciona no painel desktop e no drawer mobile; tema claro e escuro.

Dados (intenção)

  • Vou apresentar dados? Não — chips são textos; nenhuma métrica ou superfície de dados nova.
  • Decisões desbloqueadas: nenhuma nova. A curadoria de chips segue a capacidade real das ferramentas do Sollinha (a lista vive como dado de configuração, não em código espalhado).

Direção no codebase (hipótese)

  • Áreas prováveis: src/components/campaign/shell/ai/CampaignAIChat.tsx (área do input — o slot de chips fica acima do InputGroup, ocupado pelos chips de abertura quando messages.length === 0 e status === 'ready'); a lista de perguntas como catálogo estático (molde: src/lib/sollinhaChatPanelWidth.ts para persistência local / catálogos em src/lib/). O slot é compartilhado com o B192 (follow-ups da última resposta ocupam o mesmo lugar acima do input) — o componente de chips nasce aqui e o B192 o reusa.
  • Precedente a olhar: docs/plans/ai-chat-sollinha.md (v1 — in-prod, imutável); docs/plans/sollinha-tools-eleitorais-leader-lockdown.md (B180 — leader não acessa ferramentas eleitorais; a curadoria dos chips herda essa regra); docs/plans/sollinha-contexto-sessao-janela.md (B188 — irmão na mesma superfície).
  • Risco de acoplamento: mesma área de render de B187 (links) e B188 (sessão) — os três mudam CampaignAIChat.tsx; feitos em sequência, sem conflito. B192 (follow-ups) reusará o primitivo de chip deste item.

Dependências

  • Nenhuma dura. Soft: B188 (se o estado vazio sobreviver à navegação, os chips aparecem de novo no mesmo estado — sem conflito).

Fora de escopo

  • Follow-ups após cada resposta (item irmão B192).
  • Sugestões personalizadas por histórico/uso do usuário; chips que navegam para telas.
  • Adicionar chips que dependem de ferramentas ainda não entregues (ex.: "prioridades do momento" e "demandas em aberto" entram quando B186 e uma ferramenta de demandas existirem — ver Questões em aberto).

Rabbit holes de produto

  • Chip que sugere pergunta sem resposta. Se um chip disparar "Quais as prioridades agora?" e o Sollinha não tiver ferramenta para isso, a primeira impressão do produto vira frustração. Corte: curadoria por capacidade real das ferramentas; chips questionáveis só entram junto com a ferramenta.
  • Virar um gerador de sugestões complexo. Personalização, ML, ordenação por frequência — tudo isso custa caro para pouco ganho. Corte: lista estática curada de ~4 chips, em configuração, sem inteligência no v1.
  • Chips atrapalhando quem já sabe o que quer. Corte: aparecem só com conversa vazia; somem no primeiro envio; não roubam altura do input.

Questões em aberto (produto)

  • Qual o conjunto de chips do v1? As três perguntas do pedido ("Qual minha próxima ação de maior valor?", "Alguma demanda em aberta?", "Quais as prioridades da campanha agora?") dependem de ferramentas ainda não entregues (B186 + uma tool de demandas não existe). Opções: (A) v1 só com perguntas que o Sollinha responde bem hoje (votos por município, deputado mais votado, dobradinhas, lideranças, situação do município), com a lista em configuração para crescer; (B) incluir as três do pedido mesmo assim, aceitando respostas fracas; (C) travar este item até B186/tool de demandas. Recomendação: (A) — entrega valor imediato sem queimar a primeira impressão; as três do pedido entram no catálogo assim que as ferramentas existirem. (assumido — validar)
  • Um conjunto para todos os papéis? Opções: (A) mesma lista para todo mundo; (B) lista filtrada por papel (coordinator/candidate: conjunto cheio; advisor: conjunto cheio do seu escopo; leader: conjunto mínimo seguro, sem eleitoral). Recomendação: (B) — é a leitura da regra de lockdown existente (B180) aplicada ao que se sugere, não só ao que se responde. (assumido — validar)
  • 3 ou 4 chips? Opções: (A) 3, sempre; (B) 4 no desktop e 3 no mobile (largura). Recomendação: (B) — o drawer mobile é estreito; o catálogo decide por viewport. (assumido — validar)

Referências

  • src/components/campaign/shell/ai/CampaignAIChat.tsx — área do input (estado vazio + envio)
  • src/components/campaign/shell/ai/CampaignAISidebarContext.tsx — messages/status/sendMessage (chips usam exatamente sendMessage({ text }))
  • docs/plans/sollinha-tools-eleitorais-leader-lockdown.md (B180) — regra de papel que a curadoria herda
  • Canvas UI (gate): /home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-plans-plan-issue-18/canvases/plan-b191-ui-draft.canvas.tsx