teqo-backup/docs/plans/migrar-chat-painel-drawer-resize.md
Francisco Solla 73f4a18d42 docs(plans): B167 — migrar o chat Sollinha entre painel e drawer no resize
Plano de intenção: migração bidirecional painel<->drawer com chat aberto,
conversa durando a sessão do site (nova aba reinicia). Related #416.
2026-08-08 10:36:27 -03:00

84 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Migrar o chat Sollinha entre painel e drawer ao redimensionar
Status: rascunho
Atualizado em: 2026-08-07
Issue: #416
Priority: P2
Model: composer-2.5 / deepseek-v4-flash-high
Impeccable: B — correção de comportamento na abertura/fechamento existente do chat (desktop ↔ mobile)
Canvas UI: /home/fsolla/.cursor/projects/home-fsolla-Code-teqo/canvases/plan-b167-ui-draft.canvas.tsx
Appetite: ~1–1,5 dia eng; reação a viewport + estado de conversa; sem migration
Responsável: —
## Intenção
No vertical `/campanha`, o chat Sollinha tem duas superfícies: **painel lateral** (desktop) e **drawer full-screen** (mobile). Hoje, redimensionar a janela entre os dois tamanhos com o chat aberto deixa um estado quebrado — no mobile o painel continua "aberto" mas sem conteúdo. O esperado é uma **migração limpa**: se o chat está aberto ao cruzar a borda, ele continua aberto na superfície do novo tamanho (painel → drawer no desktop→mobile; drawer → painel no mobile→desktop). Se estava fechado, permanece fechado.
Além disso, a **conversa acompanha a sessão do site**: sobrevive à navegação interna, a abrir/fechar o chat e a redimensionar — só reinicia quando a sessão termina (nova aba).
## Persona e fluxo
- **Persona / contexto:** assessor/coordenador em `/campanha` conversando com a Sollinha; navega entre telas, redimensiona a janela (arrastou, trocou de monitor, dev tools) e espera que a conversa continue onde parou.
- **Job principal:** o chat acompanha a janela e a navegação — aberto continua aberto na superfície certa, fechado continua fechado, e a conversa não se perde a cada troca de superfície.
- **Fluxo desejado:**
- Chat aberto no desktop (painel) → janela encolhe para mobile → painel fecha e o **drawer abre** com o chat **e a conversa atual**.
- Chat aberto no mobile (drawer) → janela cresce para desktop → drawer fecha e o **painel abre** com o chat **e a conversa atual**.
- Chat fechado → resize em qualquer direção → continua fechado.
- Conversa iniciada → navegar entre páginas de `/campanha`, abrir/fechar o chat, redimensionar → a conversa continua.
- Nova aba (nova sessão do site) → conversa reinicia vazia.
- **Anti-goals de produto:** não manter estados fantasma (aberto-sem-conteúdo, meio-aberto); não fechar um chat que estava aberto (migra, não descarta); não abrir o chat se ele estava fechado antes do resize; não afetar o fluxo normal de abrir/fechar em tela fixa; não persistir conversas além da sessão do site (sem histórico entre sessões).
## Objetivo e aceite
- **Desktop → mobile com painel aberto:** o painel fecha e o drawer mobile abre com o chat **e a conversa atual** — sem conteúdo perdido nem painel fantasma.
- **Mobile → desktop com drawer aberto:** o drawer fecha e o painel desktop abre com o chat **e a conversa atual**.
- **Chat fechado antes do resize (qualquer direção):** continua fechado depois.
- **Conversa persiste durante toda a sessão do site:** navegação interna entre páginas de `/campanha`, abrir/fechar o chat (FAB/botão/X) e redimensionar não a perdem.
- **Nova sessão (nova aba) reinicia a conversa:** começa vazia, como hoje.
- Reabrir/fechar depois (FAB no mobile, botão no desktop) funciona normalmente.
- Abrir/fechar em tamanho de tela fixo (só desktop ou só mobile) permanece como está hoje.
## Dados (intenção)
- **Vou apresentar dados?** **Não** — N/A: correção de estado de UI + ciclo de vida de conversa, sem número novo.
## Direção no codebase (hipótese)
- **Áreas prováveis:** `src/components/campaign/shell/ai/CampaignAISidebarShell.tsx` (o `Panel` do chat é `hidden` no mobile — é ele que "esconde" o conteúdo), `src/components/campaign/shell/ai/CampaignAISidebar.tsx` (decide Drawer vs painel desktop via `useIsMobile`), o estado `open` em `src/components/campaign/shell/ai/CampaignAISidebarContext.tsx` e o `useChat` em `src/components/campaign/shell/ai/CampaignAIChat.tsx` (hoje sem identificador estável — a conversa morre quando o componente desmonta).
- **Precedente a olhar:** `docs/plans/ai-chat-sollinha.md` (entrega original — `in-prod`, não editar; ela definiu "sessão nova a cada abertura" — **este item muda essa decisão de produto**); `docs/plans/largura-padrao-chat-sollinha.md` (B166, item irmão no mesmo painel — se B166 ainda estiver em `ready`, o executor pode olhar os dois juntos, mas são entregas separadas).
- **Risco de acoplamento:** o mesmo estado `open` controla o `Panel` (desktop) e o `Drawer` (mobile); a migração precisa coordenar as duas faces ao cruzar a borda; a conversa precisa de identidade estável com escopo de **sessão da aba** (não localStorage compartilhado entre abas, que vazaria entre sessões). `useIsMobile` já reage a resize — é o gatilho natural.
## Dependências
- Nenhuma dura. Soft: B166 (mesmo painel do chat — se B166 introduzir persistência de tamanho, a migração não deve conflitar; ordem de implementação livre, mas vale olhar os dois juntos).
## Fora de escopo
- Histórico de conversas entre sessões (persistir no servidor/DB, listar conversas antigas) — v2 não pedida.
- Abrir o chat automaticamente se ele estava fechado (resize não é convite).
- Redesenhar o Drawer mobile ou o painel desktop.
- O item irmão de largura padrão (B166) — teto de 360 px e resize livre.
## Rabbit holes de produto
- **"Fecho o chat no resize."** Versão anterior do pedido; migrar é o comportamento certo (o chat está em uso — descartar seria perda). **Corte:** migra aberto → aberto na outra superfície; só fecha se já estava fechado.
- **"Persisto conversas no servidor."** Se alguém "só completar": banco de conversas, histórico, limpeza — explodiria o escopo e toca LGPD (conteúdo de assessor). **Corte:** escopo = sessão da aba (memória com escopo de sessão), nada entre sessões.
- **"Abro o chat em qualquer resize."** Se alguém "só completar": abrir o chat quando a janela muda de tamanho, mesmo com ele fechado, seria intrusivo. **Corte:** só migra um estado já aberto.
- **"Vou criar flag nova de estado."** Uma terceira flag de estado paralela a `open` duplicaria o controle do painel e do drawer. **Corte:** reusar o estado `open` existente como fonte da verdade.
## Questões em aberto (produto)
- **A conversa em andamento sobrevive ao resize?** **Opções:** A) sim — o chat migra aberto com a conversa | B) não — cada troca de superfície reinicia. **Recomendação:** A — decidido pelo produto (2026-08-07): migrar aberto sem a conversa seria o bug atual de novo. _(resolvido)_
- **Recarregar a página na mesma aba mantém a conversa?** **Opções:** A) sim — mesma aba = mesma sessão do site | B) não — reload reinicia. **Recomendação:** A — coerente com "a conversa dura a sessão do site"; nova aba continua sendo o corte. _(assumido — validar com produto)_
- **Resize rápido/frequente (ex.: dev tools) pode abrir-fechar-abrir o drawer?** **Opções:** A) aceitar — é o comportamento natural de migrar estado | B) debounce para evitar piscar. **Recomendação:** A — decidido pelo produto (2026-08-07): aceitar. _(resolvido)_
## Referências
- GitHub Issue #B167 (após registro)
- Canvas UI (gate): [plan-b167-ui-draft.canvas.tsx](/home/fsolla/.cursor/projects/home-fsolla-Code-teqo/canvases/plan-b167-ui-draft.canvas.tsx)
- `src/components/campaign/shell/ai/CampaignAISidebarShell.tsx` (painel `hidden md:block`)
- `src/components/campaign/shell/ai/CampaignAISidebar.tsx` (Drawer mobile vs painel desktop)
- `src/components/campaign/shell/ai/CampaignAISidebarContext.tsx` (estado `open`)
- `src/components/campaign/shell/ai/CampaignAIChat.tsx` (`useChat` sem identidade estável)
- `src/hooks/use-mobile.ts` (gatilho de viewport)
- Precedente (imutável): `docs/plans/ai-chat-sollinha.md`; irmão: `docs/plans/largura-padrao-chat-sollinha.md` (B166)