mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 12:43:05 +00:00
67 lines
4.7 KiB
Markdown
67 lines
4.7 KiB
Markdown
# Sollinha: links com aparência de link nas respostas
|
|
|
|
Status: plano — registrado (blocked até plano em main)
|
|
Atualizado em: 2026-08-09
|
|
Issue: #528
|
|
Priority: P2
|
|
Model: composer-2.5
|
|
Model-local: deepseek-v4-flash-high
|
|
Impeccable: B — encaixe no bubble do chat (estilo de links nas respostas do assistente)
|
|
Canvas UI: /home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-plans-plan-issue-18/canvases/plan-b187-ui-draft.canvas.tsx
|
|
Appetite: ~0,5 dia eng; estilo de render de markdown + testes e2e de aparência; sem migration/schema
|
|
|
|
## Intenção
|
|
|
|
Quando o Sollinha oferece um link (ex.: "[Ilhéus](/campanha/municipios/ilheus)", via B162), ele não **parece** um link: sai igual a texto comum. O usuário quer que todo link nas respostas seja visualmente um link — no mínimo sublinhado e com cor de destaque, como um link normal em texto — e que continue clicável para navegar (ver B188).
|
|
|
|
## Persona e fluxo
|
|
|
|
- **Persona / contexto:** assessor/coordenador lendo a resposta do Sollinha no painel/drawer; precisa **perceber** que há um link sem passar o mouse.
|
|
- **Job principal:** identificar de relance onde a resposta tem atalhos clicáveis e usá-los com confiança.
|
|
- **Fluxo desejado:** a resposta chega com o link visivelmente destacado (sublinhado + cor) → o usuário reconhece → clica e navega (a navegação sem perder contexto é o item B188; aqui só a aparência).
|
|
- **Anti-goals de produto:** não redesenhar o bubble/chat; não trocar o sistema de markdown; não estilizar apenas links internos — qualquer link conta.
|
|
|
|
## Objetivo e aceite
|
|
|
|
- Todo link emitido pelo Sollinha numa resposta aparece **sublinhado e com cor de destaque** (primária do tema), distinguível do texto corrido, no tema claro **e** escuro.
|
|
- Estados de **hover e foco visíveis** (acessibilidade: foco por teclado deve aparecer).
|
|
- O resto da formatação de markdown (títulos, listas, tabelas) permanece como está.
|
|
- Links externos (se um dia existirem) abrem em nova aba; links internos `/campanha/...` continuam navegando no app.
|
|
|
|
## Dados (intenção)
|
|
|
|
- Dados: N/A — aparência apenas; nenhuma decisão de dado/agregação.
|
|
|
|
## Direção no codebase (hipótese)
|
|
|
|
- **Áreas prováveis:** `src/components/campaign/shell/ai/CampaignAIChat.tsx` — a renderização das mensagens do assistente usa `ReactMarkdown` com classes `prose` que **não têm efeito** (o plugin `@tailwindcss/typography` não está instalado no projeto — confirmado no CSS entry `src/app/(frontend)/styles.css`); os `<a>` do markdown ficam sem estilo. Ajustar o render de links (underline + cor primária + hover/focus, claro/escuro) mantendo o restante do markdown intacto.
|
|
- **Precedente a olhar:** `docs/plans/sollinha-tool-urls-navegacao.md` (B162 — como os links entram na resposta); `docs/plans/sollinha-contexto-sessao-janela.md` (B188 — o comportamento de clique/estado do chat é vizinho).
|
|
- **Risco de acoplamento:** mesma área de render tocada por B188 (navegação/clique) — pequeno, mas os dois itens devem ser feitos sem pisar um no outro (ou em sequência).
|
|
|
|
## Dependências
|
|
|
|
- Nenhuma dura. Nota: navegação preservando contexto é B188 (separado).
|
|
|
|
## Fora de escopo
|
|
|
|
- Mudar comportamento de navegação dos links (isso é B188).
|
|
- Estilo de mensagens do usuário (não há markdown nelas hoje).
|
|
- Instalar plugin de tipografia para o app inteiro — o escopo é o chat.
|
|
|
|
## Rabbit holes de produto
|
|
|
|
- **"Ficou bonito demais".** Se alguém "só completar", vira um polimento geral do bubble. **Corte:** só a aparência de links; nada de mudar padding/bubble/cores de fundo.
|
|
- **Alvo do link errado.** Abrir link interno em aba nova quebra a colaboração com o chat (contexto some). **Corte:** interno navega no app (comportamento atual), externo em aba nova; a navegação sem perder contexto é do B188.
|
|
|
|
## Questões em aberto (produto)
|
|
|
|
- **Cor do link:** cor primária do tema ou outra de destaque no bubble? **Recomendação:** primária do tema (é a "cor de link" padrão do app) com contraste garantido no claro e escuro. _(assumido — validar)_
|
|
- **Sublinhado em hover só ou sempre visível?** **Recomendação:** sublinhado **sempre** visível (o usuário pediu "pelo menos sublinhado"), com hover reforçando (muda cor/intensidade). _(assumido — validar)_
|
|
|
|
## Referências
|
|
|
|
- Canvas UI (gate): `/home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-plans-plan-issue-18/canvases/plan-b187-ui-draft.canvas.tsx`
|
|
- `src/components/campaign/shell/ai/CampaignAIChat.tsx` — render de markdown das respostas
|
|
- `src/app/(frontend)/styles.css` — entry CSS (prose sem plugin)
|
|
- `docs/plans/sollinha-tool-urls-navegacao.md` (B162) — origem dos links nas respostas
|
|
- `docs/plans/sollinha-contexto-sessao-janela.md` (B188) — irmão no mesmo render
|