# Impl: Assessores — menu do picker de colunas derivado da mesma fonte do AdvisorsTable
Status: concluído (executado 2026-08-11)
Atualizado em: 2026-08-11
Issue: #642
Intenção: docs/plans/escala-dry-pos-b197.md
Appetite restante: ~0,5 dia (herdado)
## Leitura da intenção
- **Outcome:** o menu do picker de colunas de assessores nasce da mesma fonte
que os `
` da tabela — adicionar coluna num lugar atualiza o outro de
graça. Zero mudança de comportamento.
- **O que NÃO negociar:** mesmos ids (`name` mandatory, `email`, `phone`,
`municipalities`, `actions` — contrato do cookie `campaign_columns`), mesmos
labels pt-BR, mesma ordem, exceção do draft intacta (input de e-mail na
linha-draft mesmo com a coluna oculta), e o não-escopo travado de não portar
o `AdvisorsTable` para `CampaignTable`.
- **O que reavaliar:** o plano de intenção já recomenda a Opção A (fonte única
no módulo da tabela); a reavaliação aqui é de engenharia fina — onde a
constante vive, como o ` | ` consome, como o `emailHidden` deriva.
## Abordagem recomendada
```mermaid
flowchart LR
S[advisorTableColumns AdvisorsTable.tsx] --> H[ | via resolveVisibleColumns]
S --> P[advisorPickerColumns = toCampaignColumnPickerColumns]
P --> T[CampaignColumnPickerTrailing assessores/page.tsx]
```
**Opções consideradas:** A | B | C | D
**Recomendação:** A — porque segue o precedente em produção
(`supporterColumns`/`supporterPickerColumns` em `SupporterList.tsx` — o RSC de
`apoiadores` importa a constante serializável do módulo do componente),
reusa os helpers B17 (`toCampaignColumnPickerColumns`, `resolveVisibleColumns`)
e mantém o diff em 2 arquivos.
**Rejeitadas:**
- **B — lib nova (`src/lib/advisorTableColumns.ts`):** só há dois consumidores
e um é o mesmo módulo que renderiza; módulo lib com 1 call site real é
camada sem volatilidade (depth check — pass-through).
- **C — status quo (comentário):** o achado que originou a Issue é exatamente
que o comentário é insuficiente; rejeitada pela intenção.
- **D — extrair só id/label/mandatory e manter widths/sr-only no JSX:** deixa
dois lugares para tocar ao adicionar coluna (layout do header) e obrigaria
exceção manual no map para o caso `Ações`; a classe de header é propriedade
da coluna, declarada junto.
### Decisões de engenharia
1. **Fonte única em `AdvisorsTable.tsx` (client).** Novo tipo local
`AdvisorTableColumn { id, label, mandatory?, headerClassName?,
visuallyHiddenLabel? }` e constante `advisorTableColumns` com as 5 colunas
atuais (incluindo `w-[20%]`/`w-[24%]`/`w-[14%]`/`w-28 text-right` e
`visuallyHiddenLabel: true` em `Ações`, que preserva o ``).
2. **` | ` consomem `resolveVisibleColumns(advisorTableColumns,
columnVisibility.hiddenColumnIds)`** — o mesmo helper B17 das outras listas:
filtra por cookie respeitando `mandatory`, e `emailHidden` passa a derivar
de `visibleColumns.some(id === 'email')`. **Descoberta do /simplify (fix
incorporado):** o corpo renderiza as células incondicionalmente (só `email`
tem ` | ` condicional + exceção do draft), então `phone`/`municipalities`/
`actions` são `mandatory: true` — um id escondido por cookie velho derruba
o ` | ` sobre um corpo de 5 células (table-fixed) se não for; o checkbox
do picker vira "sempre visível" (honesto em vez do toggle inerte do B197).
O corpo (células + exceção do draft) fica intocado.
3. \*\*`export const advisorPickerColumns = toCampaignColumnPickerColumns(advisorTableColumns)`
no módulo da tabela — mesma forma de `supporterPickerColumns`.
4. **`assessores/page.tsx` importa `advisorPickerColumns`** e passa direto ao
`CampaignColumnPickerTrailing`; removidos o array local, o comentário do
espelho e os imports órfãos (`toCampaignColumnPickerColumns`,
`CampaignColumnPickerColumn`).
5. **e2e `campaignColumnPicker` (assessores):** asserts novos pinando o
contrato mandatory — `Nome`/`Celular` "sempre visível" (checked + disabled).
### Componentes / mudanças
- **`AdvisorsTable.tsx`** (`src/components/campaign/advisor/`): declara a
fonte única, exporta `advisorPickerColumns`, header por map; corpo intacto.
- **`assessores/page.tsx`** (`src/app/(campaign)/campanha/(app)/assessores/`):
consome a fonte exportada.
- **Migration:** sem migration.
- **Access / Consent:** sem mudança (acesso já gateado no page).
- **UI:** Impeccable A — sem superfície nova; refactor estrutura que preserva
DOM/aria (sr-only de `Ações` mantido).
### Dados → forma
- Forma escolhida: colunas como dados serializáveis no módulo do componente,
convertidas na fonte via helper B17. Alternativas rejeitadas: lib separada
(sem call site extra) e manutenção do espelho (o próprio defeito).
## Fases verificáveis
1. **Fonte única + header** — `AdvisorsTable.tsx`: tipo + constante + export +
map do header com `resolveVisibleColumns`; `emailHidden` derivado.
2. **Consumo no page** — `assessores/page.tsx`: import + remoção do array
local e imports órfãos.
3. **Gates** — `pnpm exec tsc --noEmit`, `pnpm lint`, `pnpm format:check`,
`pnpm test` (unit: `campaignColumnVisibility` — lib intacta), e2e
`campaignColumnPicker` (spec de assessores cobre exatamente os comportamentos
preservados: default oculto, draft com input, religar, persistência);
`pnpm exec knip` (removidos imports órfãos), `pnpm check:cycles`.
4. **Fechamento** — status do plano de intenção → concluído; entrada curta em
`docs/CHANGELOG-AGENTS.md`.
## Rabbit holes / Não escopo (engenharia)
- Não portar `AdvisorsTable` para `CampaignTable` (decisão travada do B197).
- Não mexer em labels/ordem/ids — contrato do cookie `campaign_columns`.
- Não criar coluna nova, não tocar células do corpo além de `emailHidden`
derivado.
- Sem novo unit test: o comportamento é idêntico e coberto pelo e2e existente;
testar a constante exigiria importar o módulo client inteiro (lucide/next/
sonner) — custo sem retorno para um espelho que deixou de existir.
## Riscos e mitigação
- **Import de client module em RSC:** precedente em produção
(`supporterPickerColumns` em `apoiadores/page.tsx`); valor serializável
(array de `{id,label,mandatory}`).
- **Layout `table-fixed`:** classes de largura movem para o mesmo ` | `, na
mesma ordem — DOM e classes idênticos, só que gerados por map com `key`.
- **`emailHidden` divergente do header:** eliminado por construção — deriva do
mesmo `visibleColumns` que renderiza o header.
## Aceite de engenharia
- [x] Aceite de produto da intenção ainda coberto (mesma fonte, zero mudança)
- [x] Invariantes AGENTS/engineering-standards (edit the owner: a tabela já
possui o concern do menu; reusa lib B17)
- [x] Testes de domínio: sem mudança de access/write path; e2e existente é o
guard do comportamento
|