Replace all project-local .cursor/ path references with .agents/ across rules, skills, environment config, hooks, and ignore files. Keep Cursor editor paths (~/.cursor/, window.cursor, CURSOR_API_KEY) and vendored Impeccable editor-hook paths unchanged.
29 KiB
Coluna de dobradinhas na lista de lideranças
Status: entregue
Atualizado em: 2026-07-26
Item do roadmap: docs/roadmap.md (Trilha B, item B31)
Impeccable: B — encaixe em /campanha/liderancas (coluna + célula editável no CampaignTable existente); sem rota nova
Appetite: ~1 dia eng (0,75–1,25); coluna + célula de chips com busca e gravação por delta + action nova + provider de opções; sem migration
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (princípio 3 Edit where you see, 4 Auto-save, no Save button, 8 Feel the action; anti-goals "spreadsheet mode" e "always-mounted inputs on every row") / DESIGN.md (register product; Field Desk) · tema data-theme='campaign' · precedentes de interação AdvisorMunicipalityCell.tsx (B19 ✓ — chips removíveis + typeahead + otimista) e o popover de edição rápida da lista de municípios (B9 ✓ / B27) · shells CampaignTable / CampaignPageShell · regras .agents/rules/campanha-edit-where-you-see.mdc e campanha-action-feedback.mdc.
Na implementação (implement-roadmap-item): craft compacto → critique → polish. harden/optimize só sob gatilho do Passo 8.
Brief compacto:
- Persona / contexto: CG / Assessor no onboarding da rede, varrendo
/campanha/liderancaspara amarrar cada liderança à(s) dobradinha(s) — hoje o único caminho é abrir 1 ficha por vez, rolar até oRelationMultiSelecte clicar "Salvar". - Job principal: ver e alterar as dobradinhas de uma liderança sem sair da lista, no mesmo gesto com que se lê a linha.
- Estratégia de cor: Restrained — chips
secondarycomo nas demais relações; sem badge de status, sem cor semântica por partido. - Edit where you see: sim — o campo é mutável pelo papel que está olhando (
canManageLeadership: irrestrito ou assessor no escopo) e hoje é readout morto na lista. Gravação automática por chip (sem botão "Salvar"), com otimismo no controle e refresh honesto do resultado. - Anti-goals: modo "Editar" de tabela inteira (spreadsheet — anti-goal explícito do princípio 3 e do B28); inputs montados em todas as linhas; segundo design system de célula editável; chip colorido por partido.
Dados → decisão → apresentação
- Vou apresentar dados? Sim, superfície neste item — relação categórica
leadership.stateDeputies(já persistida, já no view model comostateDeputyNames, hoje não renderizada). - Decisões desbloqueadas:
- Coordenador / Assessor: "esta liderança já está amarrada a alguma dobradinha — e a qual?" (evita prometer a mesma perna duas vezes; é o flanco de fogo amigo intra-campo nomeado em CUSTOMER.md, 2026-07-23).
- Coordenador: "ao montar o giro/estrutura deste município, quais lideranças já andam com qual candidato a estadual?" (insumo de E13 e da leitura de A6).
- Assessor: "quais das minhas fichas ainda estão sem dobradinha e precisam ser preenchidas agora?" (o seed do E4R ✓ trouxe dobradinha só no município, não na liderança).
- Forma escolhida: tabela/lista — coluna com chips nomeados (link para
/campanha/dobradinhas/<slug>), igual ao tratamento de Municípios/Organizações da mesma tabela. Rejeitado: contagem ("3 dobradinhas") — esconde justamente o nome que decide; KPI "% de lideranças com dobradinha" (vaidade sem fila associada); chart/mapa (dado é nominal e categórico, a pergunta é "quem", não "onde" nem "quanto"). - Profile: categórico; granularidade
leadership×stateDeputy; tamanho típico 0–3 chips por linha (teto de schema 20), catálogo de dezenas de dobradinhas; absoluto (o nome em si), sem leitura eleitoral relativa. - Anti-goals de dado: sem métrica eleitoral derivada nesta célula; sem ranking de lideranças por dobradinha; sem inferir dobradinha da liderança a partir de
municipality.stateDeputies(união automática mascararia o que é sabido do que é suposto).
Self-check dados: 5/5.
Contexto
/campanha/liderancas (page.tsx) renderiza um CampaignTable com Nome · Status · Municípios · Organizações · Acesso ao app. O loader leadershipData.ts já resolve stateDeputyNames em LeadershipRowViewModel (mesmo namesForIds de municípios e organizações) — o dado chega na lista e é descartado, como aconteceu com sector/updatedAt (B29) e phone (B28).
Editar dobradinha de liderança hoje = abrir /campanha/liderancas/[id], usar o RelationMultiSelect do LeadershipInternalForm (select nativo + chips) e submeter o formulário inteiro. O E4R ✓ (2026-07-24) importou DOBRADINHAS para municipality.stateDeputies e criou as lideranças name-only — ou seja, leadership.stateDeputies está praticamente vazio e o preenchimento é trabalho de mesa em lote, exatamente durante o onboarding (Onda 0 §4).
Em /campanha/assessores (B19 ✓), a coluna "Municípios" da AdvisorsTable já resolve esse tipo de trabalho: chips clicáveis no modo leitura, chips removíveis + campo de busca (typeahead com agrupamentos por TI/ZE) no modo edição, gravação por delta (setAdvisorMunicipalityMembership) com lock e estado otimista, "Ver mais…" quando a carteira não cabe em 3 linhas.
Pedido de produto (2026-07-25): a mesma funcionalidade, na lista de lideranças, para dobradinhas.
Duas diferenças estruturais que o plano precisa resolver: (1) a AdvisorsTable é uma tabela cliente própria com toggle "Editar" de tabela inteira — a lista de lideranças usa o sistema de listas do Pass 2 W1 (CampaignTable, colunas como dado, servidor) e o toggle full-row é anti-goal declarado no B28 e no princípio 3; (2) dobradinha não tem agrupamento análogo a território/ZE, então some a metade "batch" do widget do assessor.
Objetivos
- Coluna Dobradinhas em
/campanha/liderancas, entre "Organizações" e "Acesso ao app", com chips nomeados que linkam para/campanha/dobradinhas/<slug>e "—" quando vazio. - Adicionar/remover dobradinha na própria linha, com busca acento-insensível por nome (e partido) sobre o catálogo, sem botão "Salvar": cada chip grava sozinho, com chip otimista, erro revertido + toast e refresh do resultado.
- Gravação por delta (
leadershipId+stateDeputyId+assigned), transacional, com lock consultivo por liderança e teto deMAX_LEADERSHIP_STATE_DEPUTIES(20) respeitado no caminho novo. LeadershipRowViewModelpassa a carregarstateDeputies: StateDeputySummary[](id/nome/slug/partido) no lugar de sóstateDeputyNames, sem query extra por linha (mesmo lote já existente).- Contadores derivados de
/campanha/dobradinhas(leadershipCount) e a ficha/campanha/dobradinhas/[slug]não ficam obsoletos após a edição. - Guardrails: sem migration, sem collection, sem Consent, sem mudança de contrato de URL da lista; access inalterado (
canManageLeadershippara escrever,canReadStateDeputypara o catálogo;overrideAccess: falsenas leituras comuser);leadercontinua fora da rota.
Decisões travadas
- Item de trilha B31, não absorvido em B28/B29/B30. B28 é leitura de contato (
Contact) com anti-goal explícito de edição in-list; B29 é ordenação/filtro do header; B30 é uma ação de linha (convite) que não escreve na ficha. Este item é escrita de relação própria daleadership— outro caminho de código (action + lock + provider), outro appetite. (2026-07-25, classificação roadmap-item.) Rejeitado: fase do B28 (contamina um slice de leitura com uma action de escrita e dobra o appetite dele); fill-in (não é rename — tem action, lock e access); esperar B29 (nenhuma dependência dura; B29 mexe no head, este item na célula). - Edição por célula, nunca por modo de tabela. A paridade pedida é a da coluna (chips + busca + auto-save + link), não o toggle "Editar" da tela de assessores, que existe lá porque todas as colunas daquela tabela são editáveis (nome/e-mail/celular/carteira). Trazer o modo para lideranças ligaria inputs em todas as linhas e todas as colunas — anti-goal literal do princípio 3 do
PRODUCT.mde do B28. Rejeitado: toggle "Editar" na lista de lideranças (spreadsheet; colide com a reforma de header do B29 e dobraria o appetite); célula sempre em edição (inputs montados em 25 linhas). - Escrita por delta com lock, não replace do array.
updateLeadershipInternalRecordgrava o array inteiro vialeadershipInternalUpdateSchema— sob auto-save por chip, dois atores na mesma ficha se sobrescrevem (mesmo argumento do B27 para a carteira do assessor). Novo par record/actionsetLeadershipStateDeputyMembershipdentro dewithPayloadTransaction, comacquireTextAdvisoryLocks(['leadership-state-deputies:{id}']), leitura comuser+overrideAccess: false(o row access é a checagem de escopo do assessor) e cálculo do próximo array espelhandonextAdvisorIdsAfterMembership. Rejeitado: reusar o update do formulário interno (replace + campos irrelevantes no mesmo schema); escrever pelo lado dostateDeputy(a relação mora naleadership). - Server action +
revalidatePath, não endpoint JSON. B24/B27 escolheram endpoint sem revalidar porque a lista de municípios tem 435 linhas; aqui a página tem 25 e há derivados a jusante —leadershipCountda lista de dobradinhas e a lista de lideranças da ficha/campanha/dobradinhas/[slug]— que envelheceriam em silêncio. Revalidar/campanha/liderancas,/campanha/liderancas/[id],/campanha/dobradinhase a ficha do deputado tocado. Rejeitado: endpoint JSON espelho doexpected-votes/(barato aqui, mas deixa dois readouts derivados mentindo); sórouter.refresh()sem revalidate (não limpa as outras rotas). - Catálogo de opções entregue uma vez por tabela, via provider cliente. Passar o índice de dobradinhas por célula duplicaria o payload RSC em cada uma das 25 linhas. Um provider cliente fino em volta do
CampaignTable(precedente: o provider de cenário de estimativa da lista de municípios, escopado no Pass 2 W4) entrega o catálogo às ilhas. Rejeitado: props por célula (payload × linhas); transformar a lista inteira em ilha cliente (abandona o sistema de listas e o streaming do servidor); buscar no servidor a cada tecla (catálogo é de dezenas, cabe no cliente). - i18n e naming seguem o AGENTS.md: identificadores em inglês (
LeadershipStateDeputiesCell,setLeadershipStateDeputyMembership,nextStateDeputyIdsAfterMembership,StateDeputyOptionsProvider), strings visíveis em pt-BR ("Dobradinhas", "Adicionar dobradinha…", "Remover …").
Questões em aberto
- Container da edição: Popover ou typeahead inline na célula (paridade literal com assessores)? Opções: A) Popover disparado pela célula, com chips removíveis + combobox
Commanddentro | B) inline, edição ao focar a célula (input aparece ao lado dos chips, como no assessor) | C) toggle de tabela. Recomendação: A — é o contrato de edição in-list de todo o/campanha(B9 ✓, B24, B26, B27), o Radix Popover porta para fora do container que rola horizontalmente (a tabela de lideranças vai a 8–10 colunas com B28/B29, contra 5 fixas em assessores) e resolve toque sem gesto ambíguo; a leitura da célula continua sendo os chips, então a "funcionalidade da coluna" é a mesma — muda o container. C rejeitado acima. (assumido — validar com produto; se a mesa quiser o gesto literal do assessor, B é troca de container no craft, não de contrato de dados.) - Chip com partido ("Fulano (PT)") ou só nome? Opções: A) só nome na célula, partido no resultado da busca | B) nome + partido sempre. Recomendação: A — a coluna divide largura com Municípios e Organizações; a desambiguação necessária acontece na hora de escolher. (assumido)
- Adicionar filtro por dobradinha no header (B29)? Opções: A) fora deste item | B) junto. Recomendação: A — o B29 adiou o facet de dobradinha por falta de decisão nomeada; esta coluna cria a decisão ("quem já está amarrado"), então vira gatilho registrado no B29, não escopo aqui.
- Deve existir "Ver mais…" quando houver muitos chips? Opções: A) não — teto prático é 2–3 por liderança,
whitespace-normalresolve | B) portar a medição doAdvisorMunicipalityCell. Recomendação: A; a medição porResizeObserveré a parte cara daquele componente e não se justifica sem evidência de linha estourada.
Abordagem proposta
flowchart LR
loader["loadLeadershipListPageData<br/>+ stateDeputies (id/nome/slug)"] --> page["liderancas/page.tsx<br/>coluna Dobradinhas"]
options["loadStateDeputyOptions<br/>(catálogo staff)"] --> provider["StateDeputyOptionsProvider<br/>(1× por tabela)"]
provider --> cell["LeadershipStateDeputiesCell<br/>chips + Popover + combobox"]
page --> cell
cell -->|delta assigned| action["setLeadershipStateDeputyMembership<br/>tx + lock + access"]
action --> revalidate["revalidatePath<br/>liderancas · dobradinhas"]
Componentes:
leadershipData.ts:LeadershipRowViewModel.stateDeputies: StateDeputySummary[]substituistateDeputyNames(onamesForIdsdostateDeputypassa a selecionarslug/party, ou o lote reusaloadStateDeputySummaries); consumidores atuais (dossiê E16 ✓, painel do município) acompanham o rename — sem query nova por linha.liderancas/page.tsx: definição de colunastateDeputies(id estável,cellClassNamemax-w-56 whitespace-normalcomo as relações vizinhas) +loadStateDeputyOptions(payload, user)no mesmoPromise.alldo loader da lista; a tabela passa a ser envolvida pelo provider.components/campaign/leadership/LeadershipStateDeputiesCell.tsx(ilha cliente): chips (Badge+Linkpara/campanha/dobradinhas/<slug>) no repouso; Popover com chips removíveis +Command(busca viamatchesAtWordStart/normalizeSearchPhrasedesrc/lib/wordStartFilter.ts) para adicionar;useTransition+ estado otimista +toast.errorcom reversão;disabledquando o ator não pode gerenciar a ficha.components/campaign/stateDeputy/StateDeputyOptionsProvider.tsx: contexto cliente com o catálogo (RelationOption+slug); montado uma vez em volta doCampaignTable.actions/leadership.ts:setLeadershipStateDeputyMembershipRecord(payload, actor, input)+ wrappersetLeadershipStateDeputyMembership—getFreshStaffActor,withPayloadTransaction,acquireTextAdvisoryLocks([\leadership-state-deputies:${id}`]), leitura da ficha comuser/overrideAccess: false,nextStateDeputyIdsAfterMembership(teto 20, no-op quando já está no estado desejado), update comuser/overrideAccess: false,revalidatePath` das 4 rotas (slug do deputado lido na mesma transação).liderancas/formActions.ts(novo arquivo na rota da lista): casca sobrerunCampaignFormAction, no padrão do Pass 2 W4d; zod novo emsrc/lib/schemas/leadership.ts(leadershipStateDeputyMembershipSchema) reusandopositiveRelationshipId.- Testes: unit de
nextStateDeputyIdsAfterMembership(adiciona/remove/no-op/teto) e da busca do catálogo; int do action — assessor fora do escopo é recusado, assessor no escopo grava,leaderrecusado, teto de 20 respeitado, delta concorrente serializado pelo lock. - Migration: sem migration, sem collection, sem server action de leitura nova (o catálogo já existe).
Depth check: reusa CampaignTable, Popover/Command/Badge do kit, wordStartFilter, withPayloadTransaction, acquireTextAdvisoryLocks, runCampaignFormAction, loadStateDeputyOptions, campaignAccess. Não extrai primitivo genérico de "célula de relação" agora — ver Adiado com gatilho.
Dependências
- Nenhuma dura. Soft: B27 (mesma peça — chips + combobox + auto-save por delta em popover de célula; quem entrar depois consome o que o primeiro deixou), B19 ✓ (padrão de interação e o cálculo
nextAdvisorIdsAfterMembershipcomo espelho), B28/B29/B30 (mesma tabela — ordem/quantidade de colunas, reforma do header e a coluna de ação de linha), B17 (com esta coluna a tabela chega a 8–10 colunas; o seletor fica mais valioso), E4R ✓ (criou o catálogo de dobradinhas e as fichas vazias que este item preenche). - Reusa do código existente:
leadershipData.ts,campaignRelationOptions.ts,actions/leadership.ts,utilities/access/leaderships.ts,utilities/postgresTransactionLocks.ts,lib/schemas/leadership.ts,components/campaign/shared/CampaignTable.tsx.
Não escopo
- Coluna/edição de dobradinhas no painel de lideranças do município e no dossiê (E16 ✓) — só a leitura já existente.
- Filtro e ordenação por dobradinha no header — gatilho registrado no B29.
- Editar Municípios e Organizações in-list pelo mesmo gesto — item próprio se a mesa pedir (aqui só a relação pedida; municípios têm regra extra de escopo do assessor).
- Criar dobradinha nova a partir da célula ("adicionar e cadastrar") —
/campanha/dobradinhas/novacontinua sendo o caminho. - Toggle "Editar" / edição de e-mail·celular na lista — B28 (adiado lá).
- Seletor de colunas — B17.
- Insight de dobradinha 2026 (TSE) — A6.
Rabbit holes
- "Igual ao assessores" interpretado como portar a
AdvisorsTableinteira. Traria toggle de modo, células de texto com debounce e a medição porResizeObserver— e abandonaria o sistema de listas do Pass 2 W1. Mitigação: paridade travada na coluna (chips + busca + auto-save + link), container decidido no craft. - Extrair já um
CampaignRelationChipsCellgenérico. Com B27 ainda não entregue, o "genérico" seria desenhado a partir de um caso e meio, e as duas metades caras do widget do assessor (agrupamento TI/ZE e medição de linhas) não existem aqui. Mitigação: construir a célula do domínio; extração só com o 3º call site (ver Adiado). - Unir dobradinha do município com a da liderança "para a coluna não ficar vazia". Apagaria a diferença entre vínculo sabido e suposto e envenenaria E13/A6. Mitigação: a célula mostra só
leadership.stateDeputies; "—" é informação verdadeira. - Catálogo grande no cliente. Se o registro de dobradinhas crescer muito (centenas), o provider vira payload. Mitigação: medir na entrega; acima de ~200 opções, busca no servidor com debounce (gatilho abaixo).
Adiado com gatilho
- Extrair a célula de relação (chips + busca + auto-save por delta) para
shared/. Revisitar quando existir o 3º call site — hoje seriam este item e B27 (a carteira do assessor na lista de municípios); oAdvisorMunicipalityCellsó entra na conta se o agrupamento TI/ZE couber na abstração sem vazar. - Busca de dobradinha no servidor. Revisitar quando o catálogo passar de ~200 registros (pós-15/08, quando o TSE publicar candidaturas e A6 entrar).
- "Ver mais…" / colapso de chips na célula. Revisitar quando aparecer liderança com >4 dobradinhas em uso real (o teto de schema é 20).
Referências
docs/roadmap.md(Trilha B / Janela 1–2 — B30; grafo e paralelizáveis)AdvisorMunicipalityCell.tsx/AdvisorsTable.tsx— o padrão pedido (chips, typeahead, otimista, delta)liderancas/page.tsx— colunas atuais e shells da listaleadershipData.ts—stateDeputyNamesjá resolvido no view modelactions/leadership.ts/actions/advisor.ts— escopo do assessor; espelho do delta com lockstateDeputyData.ts—StateDeputySummary,leadershipCount(derivado a revalidar)campaignRelationOptions.ts—loadStateDeputyOptionscombobox-assessores-lista-municipios.md(B27) ·email-celular-lista-liderancas.md(B28) ·ordenacao-filtros-lista-liderancas.md(B29) ·convite-whatsapp-lista-liderancas.md(B30) ·gerenciar-assessores.md(B19 ✓)- AGENTS.md — Campaign auth, naming,
overrideAccess: false, escrita transacional,Contactjoin PRODUCT.md/DESIGN.md— princípios 3, 4 e 8; Field Desk ·.agents/rules/campanha-edit-where-you-see.mdc
Revisão na entrega (2026-07-26)
O plano acima executou como escrito, com as 5 defasagens já sinalizadas na auditoria pré-implementação corrigidas no código, não no texto deste plano (preservado como histórico):
- Ordem de colunas. B28 ✓ já tinha inserido E-mail/Celular e a coluna Ações antes deste item chegar; "Dobradinhas" entrou entre Organizações e Acesso ao app como previsto, só a vizinhança mudou (Nome · E-mail · Celular · Status · Municípios · Organizações · Dobradinhas · Acesso ao app · Ações).
- B27 já entregue. A questão em aberto sobre "Popover ou inline" ficou resolvida por precedente direto, não por suposição:
LeadershipStateDeputiesCellusa a mesma mecânica Popover+Command+chips deMunicipalityListAdvisorsControl(B27), mas grava por server action chamada direto do cliente viauseTransition(padrão deAdvisorMunicipalityCell/B19), não pelo endpoint JSON que o B27 usou — a diferença existe porque esta célula tem derivados a revalidar (leadershipCount, a ficha do deputado) e o B27 não tinha. MAX_LEADERSHIP_STATE_DEPUTIESexportado,loadStateDeputyOptionsestendido complainName/party/slug(não sóslug) para a célula montar o chip otimista sem 2ª busca, e a chamada duplicada deloadStateDeputySummariesemloadLeadershipDetailremovida —LeadershipDetailViewModelderivastateDeputyIDsderow.stateDeputies.- Extração de célula genérica continua adiada. Este é o 2º call site do padrão Popover+Command+chips (depois de B27); a extração para
shared/segue esperando o 3º (candidatos: B34/B36/B37). - Questões em aberto resolvidas: Popover (não inline) confirmado pelo precedente B27; chip só com nome na célula, partido no resultado da busca (A); sem filtro por dobradinha no header (gatilho no B29, ainda não entregue); sem "Ver mais…" (A).
Gate verde (tsc, lint, format, knip — P3 pré-existente, check:cycles, unit+int, e2e smoke, build); Aikido 0 achados nos 9 arquivos novos/editados.
/simplify (2026-07-26)
Três revisores paralelos (qualidade, performance, reuso) sobre o diff completo. Corrigidos:
- Bug de revert otimista.
LeadershipStateDeputiesCelldesfazia a falha de um toggle voltando paralastPropsRef.current(o snapshot pré-edição inteiro), o que apagava um toggle anterior já salvo com sucesso na mesma sessão de popover. Agora desfaz só o delta que falhou (mesma garantia queMunicipalityListAdvisorsControl/B27 tem viarevertDelta, sem herdar sua complexidade derequestSeq/latestConfirmed— a action daqui não devolve a lista "fonte da verdade" do servidor, então não há o que reconciliar). - Fallback silencioso na adição.
toggleconstruía o chip otimista comoption?.plainName ?? 'Dobradinha'/slug: option?.slug ?? ''— nunca deveria disparar (a opção sempre vem defilteredOptions), mas escondia um bug e podia gerar um link/campanha/dobradinhas/quebrado. Agora exige a opção e sai sem efeito se ela não existir. sameIdSetduplicado byte a byte entre este arquivo eMunicipalityListAdvisorsControl.tsx(B27) — extraído parasrc/lib/sameIdSet.ts, importado pelos dois.- No-op ainda pagava uma leitura + revalidação.
setLeadershipStateDeputyMembershipRecordbuscava oslugdo deputado antes de checarnextStateDeputyIDs === null, e o wrapper sempre chamavarevalidateLeadershipStateDeputyPathsmesmo sem escrita. Agora o no-op retorna antes da busca do slug, e o wrapper só revalida quando algo foi de fato escrito.
Adiados (achados reais, mas fora do apetite deste item — ver também o "2º call site" acima):
- Unificar
nextStateDeputyIdsAfterMembership/nextAdvisorIdsAfterMembershipnum helper genérico parametrizado — casa com a extração adiada para o 3º call site (B34/B36/B37), não antes. — revertido na 2ª rodada (ver abaixo): a evidência que faltava nesta 1ª rodada (o precedenteStateDeputyOptionsProvidercomo Context vs. props diretasmunicipalityListColumns) apareceu na 2ª.- Query duplicada de
stateDeputyna página da lista (catálogo completo para o Popover + subconjunto por IDs emtoLeadershipRows) —toLeadershipRowsé compartilhado com rotas que não carregam o catálogo, então não pode simplesmente consumi-lo; ficaria como uma otimização condicional só para esta rota.
Gate verde novamente após os ajustes (tsc, lint, format:check, unit 526/526, int 406/406 incl. os 6 do B31, build); Aikido 0 achados nos 4 arquivos tocados pelo /simplify.
/simplify — segunda rodada, pós-rebase (2026-07-26)
Mesmos três revisores paralelos sobre o diff (já rebaseado em origin/main). Corrigidos:
StateDeputyOptionsProviderrevertido para prop direta. A primeira rodada tinha decidido manter o Context; esta rodada trouxe a evidência concreta que faltava —MunicipalityList.tsxjá resolve exatamente o mesmo problema ("colunas estáticas + uma coluna que precisa de opções por request") com uma columns factory (municipalityListColumns(props), chamada dentro do componente, fechando sobreadvisorOptions), sem Context. Adotar esse precedente em vez de divergir dele:leadershipColumnsvirouleadershipColumns(stateDeputyOptions),LeadershipStateDeputiesCellrecebeoptionscomo prop comum, eStateDeputyOptionsProvider.tsxfoi deletado. Zero comportamento mudado, um arquivo e uma camada de Context a menos.revalidatePathmais largo que o necessário.revalidateLeadershipStateDeputyPathschamavarevalidatePath('/campanha/liderancas/[id]', 'page')— a forma de padrão dinâmico, que invalida a entrada de cache de toda ficha de liderança a cada toggle, não só a tocada — mesmo com oleadershipIdjá em escopo. Contrasta com o precedente já estabelecido (revalidateAdvisorPaths/revalidateMunicipalityListPaths), que sempre usa o id/slug concreto quando ele é conhecido. Corrigido pararevalidatePath(/campanha/liderancas/${leadershipId}, 'page').- Non-null assertion evitável.
optionById.get(stateDeputyId)!dentro dosetCurrentupdater dependia de uma guarda feita fora do updater (if (assigned && !optionById.has(...)) return) — correto hoje, mas as duas partes podiam se separar numa edição futura sem o TypeScript avisar. Movida a checagem para dentro do próprio updater (if (!option) return previous), sem asserção.
Adiados (achados reais desta rodada, registrados para quem tocar este código de novo):
- Round-trip de DB só para resolver o
slugdo deputado a revalidar.setLeadershipStateDeputyMembershipRecordfaz umfindByID('stateDeputy', ..., select: { slug })extra dentro da transação, e o cliente já tem esse slug (vem emStateDeputyRelationOption/StateDeputySummary). Passar o slug peloFormData/schema evitaria a leitura, mas move a fonte de verdade do slug para o cliente só para fins de cache — a escrita em si continua validada pelo Payload (overrideAccess: false+ FK); pior caso de um slug incorreto é invalidar a página errada, não uma falha de segurança. Ainda assim é uma mudança de superfície de confiança maior que o achado justifica isolado — fica para quando o 3º call site (B34/B36/B37) tocar esta mesma action. - Query duplicada de
stateDeputy(catálogo completo + subconjunto por IDs emtoLeadershipRows) — mesmo adiado da primeira rodada, ainda válido. optionByIdrecomputado uma vez por linha (célula) em vez de uma vez por tabela —useMemojá evita recomputar em cada render, só recomputa por linha no mount; moveria para o provider/hook compartilhado se algum dia importar na prática (catálogo de dobradinhas é pequeno).
Gate verde novamente (tsc, lint --max-warnings=0, format:check, unit 530/530, int 406/406 incl. os 6 do B31, knip com o P3 pré-existente do payload.config.ts); Aikido 0 achados nos 3 arquivos editados.