# Auto-save do Status de apoio na lista de lideranças Status: entregue Atualizado em: 2026-07-26 Item do roadmap: [docs/roadmap.md](../roadmap.md) (Trilha B, item B32) Impeccable: B — encaixe em `LeadershipsPage` / `CampaignTable` de `/campanha/liderancas` (coluna "Status"); sem rota nova de UI Appetite: ~0,4–0,5 dia eng; 1 componente novo + 1 route handler JSON espelhando `expected-votes/`; extração do guard CSRF compartilhado; sem migration Responsável: — ## Revisão na entrega (2026-07-26) Implementado como planejado, com duas defasagens (o repo andou desde o rascunho — menos trabalho, não mais): `isSameOriginRequest` já tinha sido extraído para `src/utilities/sameOriginRequest.ts` pelo B24/B27 (este item é o 3º consumidor, não o 2º) e o shell genérico `src/utilities/campaignJsonMutationRoute.ts` (`parseCampaignJsonRequestBody`/`campaignJsonMutationErrorResponse`) já existia — o route novo reusa os dois em vez de reescrever parsing/erro do zero. A verificação de "unit do parse/erro do route" foi trocada por e2e (nenhum dos routes irmãos — `political-trend`/`advisors`/`expected-votes` — tem esse unit; a cobertura real da família é e2e). Extração adicional não prevista no plano: `src/utilities/leadershipLabels.ts` (`supportStatusLabels`), por já ter 3 call sites (`LeadershipInternalForm`, `LeadershipForm`, o novo controle). Gate completo (tsc/lint/format/knip/check:cycles/unit/int/e2e/Aikido) verde; 2 falhas isoladas em `campaignMunicipalities.e2e.spec.ts` (B24/B27) na suíte cheia com 1 worker foram reproduzidas como contenção de outra sessão de agente concorrente no mesmo Postgres local — passam limpo isoladas, não relacionadas a este item. ## Design (Impeccable) Âncoras: `PRODUCT.md` (princípio 3 **Edit where you see**, princípio 4 **Auto-save, no Save button**, princípio 8 **Feel the action**) / `DESIGN.md` (register `product` — Field Desk) · tema `data-theme='campaign'` · regras `.agents/rules/campanha-edit-where-you-see.mdc` e `.agents/rules/campanha-action-feedback.mdc` · precedente vivo: [`MunicipalityListExpectedVotesControl.tsx`](../../src/components/campaign/municipality/MunicipalityListExpectedVotesControl.tsx) (máquina de auto-save com rollback) e o [`MunicipalityListTrendControl.tsx`](../../src/components/campaign/municipality/MunicipalityListTrendControl.tsx) atual (Popover + select — o que este item **não** deve repetir é o botão "Salvar" dele, hoje ainda sem o passe do B24). Na implementação (`implement-roadmap-item`): craft compacto → critique → polish (sem shape — é um único select sobre um campo que já existe, na mesma família visual dos outros popovers de lista). Brief compacto: - **Persona / contexto:** Alex (Coordenador Geral / Assessor) varrendo `/campanha/liderancas` durante o onboarding, marcando quem já engajou ou quem ainda precisa ser abordado, uma linha após a outra. - **Job principal:** trocar o Status de apoio sem sair da lista, sem clicar em um botão "Editar" da tela inteira antes, e sem confirmar a gravação — o clique na célula **é** a edição. - **Estratégia de cor:** Restrained (inalterada) — a única cor da superfície continua sendo a `SupportStatusBadge`. - **Edit where you see:** sim — a affordance já está no contexto (a célula já mostra o Badge); falta só tornar essa mesma célula editável, sem gate de "modo de edição" na tela. - **Anti-goals:** botão "Salvar" no popover; **modo de edição** da tela inteira (padrão `AdvisorsTable`/B19 — pedido explícito do produto para **não** repetir aqui); spreadsheet/data-grid mode; editar qualquer outro campo da liderança nesta célula (Setor, Observações, Municípios continuam em `/liderancas/[id]`). ## Dados → decisão → apresentação Dados: N/A — o item é affordance de **escrita** sobre um campo que já existe e já é lido na lista (`leadership.supportStatus`, hoje um `Badge` estático). Nenhuma métrica, contagem, série ou ranking novo; a leitura da coluna "Status" (badge, e o futuro filtro/sort do B29) não muda. ## Contexto Em `/campanha/liderancas` ([`page.tsx`](<../../src/app/(campaign)/campanha/(app)/liderancas/page.tsx>), linhas 49–54), a coluna "Status" é **somente leitura**: `row.supportStatus ? : '—'`. O campo em si já é editável em outro lugar — `LeadershipInternalForm` ([`LeadershipInternalForm.tsx`](../../src/components/campaign/leadership/LeadershipInternalForm.tsx), linhas 108–123) tem um `NativeSelect` de `supportStatus` dentro do formulário multi-campo de `/campanha/liderancas/[id]` (municípios, organizações, dobradinhas, setor, status, observações, consentimento — tudo com um único botão "Salvar", correto para um formulário longo). Editar apenas o status hoje exige abrir a ficha inteira. O campo já está pronto para escrita pontual: `leadershipInternalUpdateSchema` ([`schemas/leadership.ts`](../../src/lib/schemas/leadership.ts), linha 79) trata `supportStatus` como **opcional** — enviar só `{ id, supportStatus }` não toca municípios/organizações/dobradinhas/notas. `updateLeadershipInternalRecord` ([`actions/leadership.ts`](<../../src/app/(campaign)/campanha/actions/leadership.ts>), linhas 163–197) já faz o `findByID` de escopo (o registro precisa estar no alcance do ator) e o `payload.update` com `user`/`overrideAccess: false`; o access de campo (`canManageCampaignStaffField` em `Leadership.ts`, linha 143) já restringe quem pode escrever o status. Dois precedentes vizinhos mostram os dois caminhos possíveis e por que um serve melhor aqui: 1. **`/campanha/municipios`** (B9 → B24 em rascunho): cada célula editável é um Popover sempre montado, sem "modo de edição" — `MunicipalityListExpectedVotesControl` já grava por debounce + endpoint JSON dedicado, sem `revalidatePath`, com rollback e live region; `MunicipalityListTrendControl` ainda usa `
` + botão "Salvar" (o alvo do B24, ainda não implementado). 2. **`/campanha/assessores`** (B19): `AdvisorsTable` só revela células editáveis depois que o coordenador clica em "Editar" (um botão que alterna `editing` para a tabela inteira) — é o padrão que o pedido de produto (2026-07-25) nomeia explicitamente para **não** repetir aqui ("não precisa estar com o modo de edição ativado"). Pedido de produto (2026-07-25): editar o Status de apoio clicando na própria célula, com auto-save e sem o gate de "modo de edição". Isso é exatamente o gatilho que o **B29** ([ordenacao-filtros-lista-liderancas.md](ordenacao-filtros-lista-liderancas.md), seção "Adiado com gatilho") já havia registrado: _"Edição rápida de `supportStatus` na célula (Popover + auto-save, padrão B9/B24). Revisitar quando: a mesa reportar que abre a ficha só para mudar o status, ou ≥1 pedido em sessão/R6."_ — o pedido chegou. ## Objetivos - Clicar na célula "Status" de `/campanha/liderancas` abre um controle de edição (Popover + select) **sempre disponível**, sem depender de nenhum toggle de "modo de edição" da tela. - Trocar o valor grava sozinho — sem botão "Salvar", sem confirmação. - Feedback honesto na própria célula (princípio 8): pendente (`aria-busy` + spinner), erro com mensagem + rollback para o último valor confirmado, live region `sr-only`. - Guardrails: **sem migration**, sem collection, sem Consent; access inalterado (mesma `updateLeadershipInternal`, `overrideAccess: false`, `canManageCampaignStaffField`); `leader` continua sem acesso à rota (`isCampaignStaff` já bloqueia); `/liderancas/[id]` continua com submit explícito (formulário multi-campo). ## Decisões travadas - **Popover + `NativeSelect` sempre montado na célula, sem gate de "modo de edição".** Mirroring `MunicipalityListExpectedVotesControl` (máquina de estado com rollback/live region), não `AdvisorsTable` (toggle "Editar" da tabela inteira). Fonte: pedido de produto 2026-07-25, que nomeia explicitamente o anti-goal ("não precisa estar com o modo de edição ativado"). **Rejeitado:** reproduzir o toggle "Editar" do B19/`AdvisorsTable` (é literalmente o padrão que o pedido pede para não usar); select inline sem Popover, no estilo `AdvisorDebouncedTextCell` (perde a chrome de spinner/erro/live region já padronizada nos popovers de lista; e cores de Badge dentro de um `