mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-19 08:03:06 +00:00
7.1 KiB
7.1 KiB
Assessores — editor de permissão em modal central (desktop) + bottom drawer (mobile) no lugar do popover
Status: rascunho
Atualizado em: 2026-08-23
Issue: #813
Priority: P2
Impeccable: B — encaixe na superfície existente do C141
Rascunho UI: docs/plans/permissao-assessores-modal-central-ui-draft.html
Appetite: ~0,5–1 dia eng
Responsável: —
Intenção
Na lista de assessores (/campanha/assessores), a célula "Permissão" é um badge que abre o editor Visão × Edição num popover ancorado — e a tabela é larga (min-w-[56rem], com scroll horizontal), então o popover estoura o viewport com frequência. Quem está configurando o assessor precisa ver e salvar a permissão sem brigar com a janela: no desktop, um modal central (Dialog); no celular, um bottom drawer. Só o invólucro muda — o editor e as regras do C141 ficam intactos.
Persona e fluxo
- Persona / contexto: coordenador(a) (ou candidato(a)) na tela de assessores, configurando o que cada assessor vê e edita; mesa com listas longas, celular ou notebook.
- Job principal: abrir a permissão de um assessor e definir Visão × Edição com o conteúdo sempre à vista.
- Fluxo desejado: toca no badge "Permissão" → abre modal centralizado (desktop) ou bottom drawer (mobile) com o editor → ajusta Visão/Edição → Salvar → overlay fecha e o badge reflete o novo perfil.
- Anti-goals de produto: não virar uma campanha geral de popover→modal (outras superfícies mantêm seus contêineres); não mexer no conteúdo, combos, nota ou regras de coerência do editor; não criar um segundo componente de editor.
Esboço de fluxo (B/C/D)
[badge "Permissão" na linha do assessor]
→ toque/clique
→ desktop: Dialog central (visor fixo) | mobile: bottom drawer (polegares na base)
→ editor Visão × Edição (mesmos combos, mesma nota, regras de coerência)
→ Salvar (ou Cancelar)
→ overlay fecha, badge atualizado
Rascunho UI (gate)
- Rascunho UI (gate):
docs/plans/permissao-assessores-modal-central-ui-draft.html— duas cenas estáticas: dialog central desktop (~1280px) e bottom drawer mobile (~390px), tema zinc do draft C141.
Objetivo e aceite
- A permissão de qualquer assessor é editada num overlay centralizado que nunca estoura o viewport, no desktop e no celular.
- O editor continua sendo o mesmo do C141: mesmos combos Visão/Edição, mesma nota, Cancelar/Salvar, regras de coerência (edição 'tudo' ⇒ visão 'tudo'; visão 'carteira' ⇒ edição cai para 'carteira').
- Ao salvar, o overlay fecha e o badge mostra o perfil novo; a linha de assessor em rascunho continua usando
onDraftChangelocal (não salva no servidor). - O
aria-labeldo badge e os ids dos selects (advisor-permission-visibility/advisor-permission-editing) são preservados. - O editor embutido na página de detalhe do assessor segue exatamente como está — não participa desta entrega.
Dados (intenção)
- Vou apresentar dados? Não.
- Decisões desbloqueadas: N/A — sem métrica e sem decisão de dados; é re-superfície do editor existente, server actions e escrita em banco intactas.
- Forma: N/A.
Direção no codebase (hipótese)
- Áreas prováveis:
src/components/campaign/advisor/(AdvisorPermissionBadge.tsxé o único ponto de troca de invólucro;AdvisorsTable.tsxnão muda além do que o badge já expõe),src/components/ui/Dialog.tsxesrc/components/ui/Drawer.tsx,src/hooks/use-mobile.ts(useNarrowMeasured(640)). - Precedente a olhar: C123 —
docs/plans/agenda-criacao-modal-central-impl.md(Dialog desktop + Drawer mobile selecionados poruseNarrowMeasured); célula "Carteira do assessor" da mesma tabela já abre sheet compartilhada em ponteiros grossos (RelationChipCellvariant="sheet" →CampaignListSheetProvider); drawer default desrc/components/ui/Drawer.tsxjá é bottom-anchored. - Risco de acoplamento: troca de contêiner só dentro do
AdvisorPermissionBadge— o badge é usado em dois pontos (linha de dados comadvisorId+formAction, linha de rascunho semadvisorIdcomonDraftChange); o editor do detalhe não pode herdar a troca; a tabela continua com scroll horizontal e o overlay não depende do layout da tabela.
Dependências
- Nenhuma (C141 entregue — badge + editor; C142 entregue — e2e
campaignPermissionProfilenão toca o badge, sem risco de seletor).
Fora de escopo
- Outros popovers do
/campanha(mantêm seus contêineres atuais). - Editor embutido na página de detalhe do assessor.
- Conteúdo, combos, nota e regras de permissão do C141.
- Cards mobile da tabela de assessores.
Rabbit holes de produto
- Cascata de troca de popovers. Se alguém "só completar": converter todas as superfícies com popover do
/campanha. Corte neste item: só o badge de permissão; outras superfícies decidem em itens próprios. - Editor embutido no badge. Se alguém "só completar": o badge abrir um editor inline na célula. Corte neste item: overlay central/drawer, sempre.
- Breakpoint na tabela. Se alguém "só completar": introduzir estado responsivo na
AdvisorsTable. Corte neste item: o sinaluseNarrowMeasured(640)vive no badge/overlay, não na tabela.
Questões em aberto (produto)
- Bottom vs top drawer? Opções: bottom (default do primitivo) | top (como C123 usou para a agenda). Recomendação: bottom — o editor é curto, o botão Salvar fica perto dos polegares e o
max-hdo drawer mantém tudo na tela; o top do C123 era um quirk do C103, não um padrão. (assumido — validar com produto) - Salvar fecha o overlay? Opções: fecha | mantém aberto com feedback. Recomendação: fecha, como o popover atual já faz (
onSaved→ fecha); o badge atualizado é o feedback. (assumido — validar com produto) - Footer Cancelar/Salvar no modal? Opções: mantém o footer do editor (Cancelar condicional) | só Salvar. Recomendação: mantém o footer exatamente como está — o conteúdo do editor é intocável.
Referências
- Rascunho UI (gate):
docs/plans/permissao-assessores-modal-central-ui-draft.html(novo; tema dodocs/plans/permissao-granular-assessores-ui-draft.htmldo C141) src/components/campaign/advisor/AdvisorPermissionBadge.tsx— ponto único da troca de invólucrosrc/components/campaign/advisor/AdvisorPermissionEditor.tsx— conteúdo intocadosrc/components/campaign/advisor/AdvisorsTable.tsx— usos do badge (linha de dados ~473, rascunho ~351)src/app/(campaign)/campanha/(app)/assessores/[id]/page.tsx— editor embutido no detalhe (fora de escopo)src/hooks/use-mobile.ts(useNarrowMeasured(640)) +src/components/ui/Dialog.tsx+src/components/ui/Drawer.tsx(default bottom-anchored)- Precedente C123:
docs/plans/agenda-criacao-modal-central-impl.md - Célula "Carteira do assessor" da mesma tabela (
RelationChipCellvariant="sheet" →CampaignListSheetProvider)

