Three debts, no new ID. The fifth JSON control and route arrived without touching F1 — the level movement is an explicit submit, not a debounce — which is exactly the escape clause F2/F3 were parked behind, so they stop being conditional. F2 also changes character: the same-origin check that `isSameOriginRequest` documents itself as owning is copied into five routes, so the one that forgets the line fails open. That is not boilerplate and is not cuttable by appetite. F5 is B42's own deferred trigger firing: it parked the footer slot on "a second control needing explicit submit in a Drawer", and this is that control. What the deferral could not know is that the shell pins "Fechar" while "Registrar movimento" sits below the fold, so the action that discards a typed rationale is the reachable one. Discarded with reasons in the triage: `new Date()` during render (the server re-runs the rules and a 409 is a designed state), and `levelNote` in the 435-row select, already written down in E14's own plan next to `politicalTrend.note`, which has the same shape and must be fixed with it.
22 KiB
Polimento mobile da lista de municípios (drawers + card compacto)
Status: entregue em código (2026-07-27) — ver "As-built" no fim
Atualizado em: 2026-07-27
Item do roadmap: docs/roadmap.md (Trilha B, item B42)
Impeccable: B — encaixe nos cards md:hidden + controles Tendência/Assessores; sem rota nova
Appetite: ~1 dia eng; Drawer nos dois controles (padrão B26) + densificar card + tap-to-open
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (Edit where you see, Feel the action, Clarity under pressure) / DESIGN.md · regras campanha-edit-where-you-see / campanha-action-feedback · precedente B26 ✓ (MunicipalityListSignalControl: Popover desktop / Drawer mobile).
Na implementação: craft compacto → critique → polish.
Brief compacto:
- Persona / contexto: Assessor em campo no celular, varrendo a fila; o card está alto demais e os popovers de Tendência/Assessores competem com o teclado (o Sinal já abre em Drawer).
- Job principal: editar tendência/assessores no mesmo gesto confortável do sinal; varrer mais municípios por viewport; abrir o detalhe com um toque no card.
- Estratégia de cor: Restrained — sem novo chrome; Drawer do kit (
src/components/ui/Drawer). - Edit where you see: sim — mantém edição in-card; só muda o container mobile.
- Anti-goals: Popover genérico "sempre Drawer"; spreadsheet; segundo botão "Abrir" depois do card inteiro ser clicável; perder stopPropagation nos controles editáveis.
Dados → decisão → apresentação
- Vou apresentar dados? Sim, só reapresentação do que o card já mostra (classe E10, cobertura E8).
- Decisões desbloqueadas: Assessor/CG — "este município merece abrir agora?" com menos scroll; edição de tendência/assessores sem luta com teclado.
- Forma escolhida: badge de classe sem prosa; cobertura em layout
compact(número + déficit curto, como desktop). Rejeitado: tirar Classe/Cobertura do card (ainda informam a fila); chart/KPI novo.
Contexto
Cards mobile em MunicipalityList.tsx (data-view="mobile-cards", md:hidden):
- Classe usa
TerritorialClassReadoutlayout="card"— mostra o "por quê" em texto (text-xs); na tabela o mesmo texto ésr-only+ tooltip B23. - Cobertura da meta usa
MunicipalityListGoalCoverageCellsemlayout="compact"— soletra déficit + cenário; desktop passacompact. - Botão outline "Abrir município" no rodapé do card.
- Tendência (
MunicipalityListTrendControl) e Assessores (MunicipalityListAdvisorsControl) abrem Popover em qualquer viewport. - Último sinal (
MunicipalityListSignalControl) já distinguevariant: 'popover' | 'sheet'— mobile usa Drawer (B26 ✓).
Pedido de produto (2026-07-26), agrupado neste item (mesma superfície mobile):
- Tendência → Drawer no mobile, Popover no desktop.
- Assessores → idem.
- Card menor: sem descrição da classe; cobertura só no formato número (compact); sem botão "Abrir município"; toque no card abre o município.
Objetivos
MunicipalityListTrendControleMunicipalityListAdvisorsControl: Popover emmd+, Drawer (bottom sheet) abaixo demd, espelhando o contrato visual/a11y do sinal (título + nome do município no header do Drawer).- Auto-save / endpoints JSON de B24/B27 inalterados — só o container muda.
- Card mobile: Classe como na tabela (badge +
sr-onlywhy); Cobertura comlayout="compact"; remover oButton"Abrir município"; o<article>(ou região equivalente) navega para/campanha/municipios/[slug]no toque/clique fora dos controles interativos. - Controles internos (tendência, votos, sinal, assessores,
TerritoryLink) não disparam a navegação (stopPropagation/pointer-events/ link overlay com buracos — escolher o padrão mais simples no craft). - Guardrails: sem migration/action/Consent; desktop table fora (exceto se o controle compartilhado ganhar o branch de viewport); access inalterado.
Decisões travadas
- Um item só para drawers + card (lote 2026-07-26). Mesma viewport, mesmos arquivos, appetite cabe em ~1 d. Rejeitado: três fill-ins separados (custo de coordenação > ganho); absorver em R6 (atrasa quick win de campo).
- Mesmo breakpoint do sinal / cards (
md= 768) via padrão já usado (md:hiddencards,useIsMobilese o controle precisar montar um único tree). Rejeitado: breakpoint diferente por controle. - Card inteiro como hit target de navegação, não botão extra. Rejeitado: manter o botão "Abrir" + card clicável (dois affordances); só remover o botão sem tornar o card clicável (regressão de descoberta).
- Classe no card = paridade com tabela (
layout="table"ou flaghideWhy). O research §6.4 ("nunca só o label") continua viasr-only+ eventual tooltip/tap no badge se B23 já cobre — no card mobile,sr-onlybasta no v1 (paridade pedida). Rejeitado: tirar a Classe do card. - i18n/naming: reusar
variant: 'popover' | 'sheet'do sinal ou extrair helperuseCampaignOverlayMode()no 3º call site — depth: se Trend+Advisors+Signal forem o 3º, extrair; senão copiar o branch uma vez.
Questões em aberto
- Extrair shell Popover|Drawer compartilhado agora? Opções: A) branch local nos dois controles (copiar B26) | B) extrair
CampaignResponsiveOverlayjá. Recomendação: A na primeira PR; se o diff duplicar >~40 linhas iguais, extrair no/simplifydo mesmo item (3º call site = sinal + estes dois). (assumido.)
Abordagem proposta
flowchart TB
subgraph desktop [md+]
T1[Trend Popover]
A1[Advisors Popover]
end
subgraph mobile [lt md]
T2[Trend Drawer]
A2[Advisors Drawer]
Card[Card compacto<br/>tap → detalhe]
end
Signal[SignalControl sheet] -.padrão.-> T2
Signal -.padrão.-> A2
Componentes:
MunicipalityListTrendControl.tsx: espelhar estrutura deMunicipalityListSignalControl(conteúdo do form numa função; Popover vs Drawer).MunicipalityListAdvisorsControl.tsx: idem (chips + Command dentro do Drawer; cuidado com foco/teclado virtual).MunicipalityList.tsx(cards):TerritorialClassReadoutsem why visível;GoalCoverageCell layout="compact"; removerButton/Link"Abrir município"; navegação no card com exclusão dos controles.- Testes: unit/e2e leves — no mobile viewport, trigger de tendência abre dialog/sheet (role); tap no título navega; tap no controle não navega.
- Migration: nenhuma.
Depth check: reusa Drawer shadcn + padrão B26; não cria design system de overlay novo até o simplify provar duplicação.
Dependências
- Duras: nenhuma. Consome B24 ✓ / B27 ✓ / B26 ✓.
- Soft: B41 (scroll desktop) — paralelo; não bloqueia.
Não escopo
- Scroll horizontal / sticky da tabela desktop → B41.
- Mudar auto-save, endpoints, ou schema de tendência/assessores.
- Paridade Drawer em outras listas (lideranças) — Adiado.
- Seletor de colunas / filtros salvos.
Rabbit holes
- Card clicável + botões internos = navegação acidental. Mitigação: testes e2e do gesto;
stopPropagationnos triggers; critique em device real. - Command dentro de Drawer (foco trap / teclado). Mitigação: espelhar padrões Radix já usados no Sheet do sidebar; testar Android Chrome.
- Extrair overlay genérico cedo demais. Mitigação: decisão A acima + simplify.
Adiado com gatilho
Tooltip/tap da Classe no card mobile— fechado no critique da própria sessão (ver As-built): osr-onlysozinho deixava o veredito inalcançável no toque, o que contrariaDESIGN.md.Drawer para votos estimados no card— entrou nesta entrega por decisão do usuário; foi o 3º call site que justificou extrair a casca.SlotGatilho disparado em 2026-07-27, na triage de fechamento do E14 ✓:footer+formIdna casca, para o Sinal (B26) migrar.MunicipalityListLevelControlé o 2º controle de submit explícito e migrou para a casca sem o slot, o que na folha pina "Fechar" e empurra "Registrar movimento" para baixo da dobra — a ação que descarta uma justificativa digitada ficou mais alcançável que a que a registra. Virou F5 do B32+ (escala-dry-pos-b32.md), junto do F4 desta mesma casca, e não um ID novo.- Montar o Drawer só no primeiro
open(everOpened, nãoopen). Gatilho: a lista mobile aparecer num profile de render, ou o caminhopagination: false(435 linhas × 4 overlays) passar a ser rota quente. Números medidos no As-built. prefers-reduced-motionnoDrawer. ODialog/Sheetdo kit também não respeita; a animação de entrada é do base-ui e vem do kit, então a correção é do componenteui/, não deste item. Gatilho: qualquer trabalho de acessibilidade de movimento no kit.DrawerVirtualKeyboardProvider. Sem ele, o teclado do Android pode cobrir os inputs de votos dentro da folha; hoje mitigado por não focar campo na abertura. Gatilho: relato de campo em Android.- A ficha do município mantém Popover em qualquer viewport.
MunicipalityGoalAccountCardpassa semprevariant="popover", então no celular aquela edição rápida ainda briga com o teclado — o problema que este item resolveu uma rota ao lado. Não é esquecimento: a ficha é uma árvore (não o parmd:hidden/hidden md:blockdas listas), então escolher o container ali exigeuseIsMobile, que este plano rejeitou por trocar o container depois da hidratação. Gatilho: queixa de campo sobre editar votos na ficha pelo celular — e aí a decisão a tomar éuseIsMobilena ficha, não copiar o branch. DrawerBodyno kit.Drawer.tsxexporta header/footer/title/description mas nenhum corpo, então há dois containers de scroll escritos à mão (a casca e o Sinal) que já divergem emgap-3/pt-3. AdicionarDrawerBodyresolve, mas põe uma peça não-upstream no kit (shadcn addnão a recoloca). Gatilho: o 3º corpo à mão.- Stub de
ResizeObserver/scrollIntoViewcompartilhado. Duas cópias (este spec ecampaignCompositionCleanup.unit.spec.ts), abaixo da barra de 3 do repo;vitest.unit.config.mtsnão declarasetupFiles, então não existe casa para mover hoje. Gatilho: o 3º spec jsdom que precise deles →setupFiles: ['./tests/helpers/jsdomStubs.ts'], não uma terceira cópia.
As-built (2026-07-27)
Escopo ampliado por decisão do usuário na sessão: Votos estimados entrou no mesmo tratamento (estava em "Adiado com gatilho" acima). Isso levou o item de 2 para 3 controles com a mesma casca — que é o critério de extração do repo —, então a questão em aberto foi resolvida ao contrário da recomendação: src/components/campaign/shared/CampaignCellEditOverlay.tsx nasceu já nesta entrega, não no /simplify. Appetite ~1d → ~1,25d.
CampaignCellEditOverlaycarrega só o container:variant(popover|sheet),open/onOpenChange,title/description,trigger/triggerLabel,tooltipContent(B23, só no popover — não há hover no toque) epreventPopoverAutoFocus. Cada controle continua dono do seu auto-save (debounce, abort, flush no fechamento): fechar o Drawer grava exatamente como dispensar o Popover, porque ohandleOpenChangede cada um passa direto paraonOpenChange.- O Sinal (B26) não migrou — mas o motivo registrado antes estava errado. O
/simplifyderrubou a alegação de que "a casca não expressa isso sem virar genérica": o<form>não precisa envolver oDrawerHeader(um título não é campo) e um submit fora do form é HTML padrão viaform="<id>". O que falta é um slotfooter(mais umformIddo chamador) — adiado com gatilho abaixo, não impossível. O Sinal segue sendo o precedente visual e agora consome a classe de trigger da casca (campaignCellEditTriggerClassName) e os três atributos ARIA que lhe faltavam (aria-expanded/aria-haspopup/aria-busy). useIsMobiledescartado: os cards (md:hidden) e a tabela (hidden md:block) são árvores irmãs, então o call site já sabe em que viewport está. Uma media query aqui trocaria o container depois da hidratação.- Navegação do card = link esticado, zero JS:
<Link>dentro do<h3>comafter:absolute after:inset-0sobre o<article className="relative">. Quem érelativeé o controle, não a célula — a primeira versão posicionou os seis<div>do<dl>, o que levantou também os rótulos e o padding de cada célula acima do overlay e transformou metade do card em toque que não editava nem navegava (P0 do critique). Hoje orelativemora na classe compartilhada do trigger; nada mais dentro do card pode ser posicionado.MunicipalityListcontinua Server Component e o foco/teclado seguem nativos. O botão "Abrir município" saiu. - Dois props
layoutmorreram com a paridade pedida:TerritorialClassReadout(badge +sr-onlydo porquê, como na tabela — E10 nunca entrega veredito nu) eMunicipalityListGoalCoverageCell(semprecompact). Com um único comportamento cada, o prop e o branch órfão foram deletados. autoFocusScenariosuprimido nosheet: no desktop o Popover é transitório e digitar é o ponto; no toque, focar uminputna abertura subiria o teclado virtual antes de o número ser lido.municipalityNameé obrigatório exatamente onde há Drawer: os props de Votos estimados são uma união discriminada —sheetexige o nome (uma folha sempre nomeia seu assunto, e isso é erro de compilação, não nota de revisão),popovero deixa opcional, porque o 3º call site (MunicipalityGoalAccountCard, na ficha do município) já está sob o título do próprio município. A primeira versão proibia o nome nopopover(?: never), o que criou uma assimetria na mesma linha da tabela: Tendência e Assessores anunciavam "… em Feira de Santana — …" e Votos estimados não. Resolvido para o lado de incluir depois de verificar que a célula do nome é um<td>comum, não um<th scope="row">— não existe associação de cabeçalho de linha para o leitor de tela suprir o contexto quando o foco entra num trigger. Custo medido do nome nos dois variants: 0,22 KiB gzip na página de 25 linhas (2,9 KiB no caminhopagination: falsede 435).
Testes: tests/unit/campaignCellEditOverlay.unit.spec.ts (jsdom, 6 casos = 3 controles × 2 variants: sheet abre role="dialog" com título + nome do município e botão "Fechar"; popover mantém popover-content e não repete o nome) — precisou dos stubs de ResizeObserver e Element.prototype.scrollIntoView que o cmdk do combobox de assessores exige. E2e novo test.describe com viewport: { width: 390, height: 844 } em campaignMunicipalities.e2e.spec.ts: abrir Tendência no card não navega, e o toque fora dos controles abre /campanha/municipios/<slug>.
Gate: tsc, lint --max-warnings=0, format:check, knip (só o erro pré-existente de payload.config.ts, P3), check:cycles, 592 unit / 420 int, build (/campanha/municipios 13,4 kB / 320 kB First Load JS) e Aikido sem achados. O e2e mobile passou; as falhas rotativas da suíte cheia foram reproduzidas piores na árvore limpa (4 falhas contra 3, o mesmo teste de demanda falhando na mesma linha) sob contenção de outra sessão Playwright no mesmo host — mesmo padrão de ambiente já registrado no B27 ✓/B32 ✓, não regressão.
Critique + /simplify (mesma sessão, depois do gate)
O critique rodou sobre o código, não sobre a tela: a coleta de evidência visual em viewport 390×844 falhou por falta de automação de browser nesta sessão, então nada aqui foi confirmado em device real — os alvos de toque são checados por classe (min-h-11), não medidos. Mesmo assim achou um P0 de correção no gesto central, e os revisores paralelos (qualidade, performance, reuso) convergiram no resto. O que entrou:
- P0 — zonas mortas do link esticado. Descrito no bullet de navegação acima. O e2e passou a tocar num rótulo
dtdentro da grade de métricas (não mais no canto do card), que é exatamente a área que o bug engolia. - O Drawer abre com foco no título, nunca num campo.
initialFocus={titleRef}numDrawerTitlecomtabIndex={-1}: o default do base-ui (primeiro tabbable) subia o teclado virtual sobre a folha antes de ela ser lida — e opreventContentAutoFocusque devia mitigar isso era inerte no branchsheet, um prop que mentia. Renomeado parapreventPopoverAutoFocus(é só do Popover) e o comportamento do Drawer virou incondicional. Pinado no unit spec, porque é o ponto mais frágil da entrega. - Rótulo acessível carrega o valor. Um
aria-labelsubstitui o conteúdo do trigger: as quatro células de edição anunciavam o verbo e engoliam justamente o valor que todo mundo lê no pill/no avatar/no número. Agora seguem a forma que o Sinal (B26) já usava — "Editar tendência política em Feira de Santana — Favorável". Isso resolveu o achado de payload do revisor de performance ao contrário do que ele propôs: ele mediumunicipalityNamecomo payload RSC morto no desktop (27,9 KiB crus / 2,9 KiB gzip em 435 linhas) e sugeriu proibi-lo nopopovernos três controles; com o nome dentro do rótulo ele deixou de ser morto, e a célula do nome ser um<td>semscope="row"é o que diz que ninguém mais fornece esse contexto (ver o bullet domunicipalityNameacima). - Falha silenciosa depois do fechamento. Fechar é o que commita o rascunho e também o que desmonta o
Alerte a regiãoaria-liveque carregariam o erro: uma gravação que falhava na saída revertia o badge sem avisar ninguém. Os três controles de auto-save por debounce (+ o de lideranças) ganharamtoast.errorapenas quando já estão fechados; abertos, oAlertinline continua sendo o canal mais próximo. - Alvos de toque dentro do Drawer. Os três inputs compactos de votos passam a 44px abaixo de
mde continuam 36px nomd+(única call site do variantcompact); o chip de remover assessor e cada linha doCommandganhammin-h-11só nosheet. - A explicação voltou a ser alcançável no toque. A Classe no card ganhou
CampaignHoverTooltip(o canal tap-to-open que a tabela já tem viacellTooltip) —DESIGN.mdexige que a classe nunca chegue como veredito nu, e no card ela só tinhasr-only; a Cobertura ganhou a frase completa emsr-only, porquetitlenão é anunciado nem alcançado por toque. Isso fecha o "Adiado com gatilho: tooltip/tap da Classe no card mobile". - Reuso — o 4º call site migrou.
LeadershipListSupportStatusControl(B32) era o branch Popover da casca redigitado à mão, classe de trigger byte-a-byte inclusive: migrado comvariant="popover", ~25 linhas a menos e nenhum prop novo.MunicipalityListSignalControlpassou a importarCampaignCellEditOverlayVariantem vez de re-escrever a união. A string de trigger, que estava em três arquivos, viroucampaignCellEditTriggerClassName(precedente:campaignHoverExplanationClassName). - API da casca: o
<button>do trigger era escrito duas vezes (só oonClickdiferia) → uma vez;sheetBodyClassNameera o único prop de classe que substituía em vez de compor, o que obrigava o chamador de assessores a re-espalharpx-4por seção → agora compõe (px-0 pt-2no chamador) e osectionPaddingClassNamecondicional morreu;titleera obrigatório e morto no Popover → virou oaria-labeldorole="dialog", que o Radix não nomeia; o docblock estava colado notypedo variant (hover do IDE mostrava a doc errada) e os props agora estão agrupados em blocos// Popover only/// Sheet only.
Medido e não feito (o revisor de performance mediu; a decisão é não pagar agora): cada Drawer fechado ainda executa o corpo de DrawerContent, e o cn() do popup roda tailwind-merge sobre 4.068 caracteres — 6,2 µs contra 0,8 µs do Popover que ele substituiu, ou +0,40 ms em 25 linhas e +7 ms no caminho pagination: false de 435. Não é adição, é troca (o número de overlays por página não mudou), e a correção é montar o Drawer no primeiro open ({everOpened && …}, não {open && …}, senão o data-starting-style perde a animação de entrada). Registrado como débito com gatilho. Bundle: zero delta nas duas rotas — a lista já importava ui/Drawer pelo Sinal, e a ficha do município (que ganhou uma aresta nova via MunicipalityGoalAccountCard) já o tinha no grafo porque InstallPwaToast, no layout de (app), o importa. Vale saber: se o InstallPwaToast sair do layout, a rota de detalhe passa a pagar a subárvore do Drawer só por essa aresta.
Cuidado operacional aprendido aqui: git stash é compartilhado entre worktrees do mesmo repositório. Fazer stash para medir uma baseline enquanto outra sessão trabalha em paralelo faz o pop trazer o WIP alheio (e o índice do drop deslizar) — aconteceu nesta sessão e foi revertido com git stash store <hash>. Para baseline com sessões concorrentes, prefira patch local (git diff > /tmp/… + git checkout --) a git stash.
Referências
docs/roadmap.md(Trilha B · B42)src/components/campaign/municipality/MunicipalityList.tsxsrc/components/campaign/shared/CampaignCellEditOverlay.tsx(cascapopover|sheet+campaignCellEditTriggerClassName)MunicipalityListTrendControl.tsx,MunicipalityListAdvisorsControl.tsx,MunicipalityListExpectedVotesControl.tsx,MunicipalityListSignalControl.tsxMunicipalityListGoalCoverageCell.tsx,TerritorialClassReadout.tsxsrc/components/campaign/leadership/LeadershipListSupportStatusControl.tsx(4º call site da casca)docs/plans/registrar-sinal-lista-municipios.md(B26)docs/plans/autosave-tendencia-lista-municipios.md(B24)docs/plans/combobox-assessores-lista-municipios.md(B27)PRODUCT.md/DESIGN.md