A seção deixa de truncar seis prioritárias sem critério; amostra oito por cobertura central, mostra o total e linka ?priority=alta alinhado à fila de alocação.
12 KiB
Municípios prioritários no Início
Status: entregue (2026-07-25)
Atualizado em: 2026-07-25
Revisão 2026-07-25: implementado — dashboardPriorityMunicipalities.ts, loader + CampaignDashboard (Badge, Ver todas, list-none); auditoria corrigiu coverageByMunicipalityID no texto do plano.
Item do roadmap: docs/roadmap.md (Demais itens abertos, B20)
Impeccable: B — encaixe na seção existente do dashboard staff (CampaignDashboard em /campanha); sem rota nova
Appetite: ~0,5 dia eng; semântica da seção + ordenação + link “Ver todas” + markup sem bullets; sem migration
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (princípios 2 clareza sob pressão + 6 inteligência serve organização) / DESIGN.md (register product; Field Desk; chips de escopo) · tema data-theme='campaign' · shell CampaignPageShell + padrão de chip-strip já usado em assessores/[id] e RecentlyVisitedCard.
Na implementação (implement-roadmap-item): craft compacto → critique → polish (só a seção prioritários + loader; sem redesign do Início).
Brief compacto:
- Persona / contexto: CG/candidato (e assessor no próprio escopo) abrem
/campanhasob pressão; precisam de atalho para onde atacar agora entre as prioritárias da mesa — não do inventário completo. - Job principal: ver um recorte acionável das prioritárias, entender que o conjunto total é maior, e cair na lista filtrada com um toque.
- Estratégia de cor: Restrained; chips outline/secondary existentes, sem segundo sistema de badges.
- Edit where you see: não — seção só-leitura / navegação; mutação de
prioritycontinua no form de estratégia. - Anti-goals: inventário de ~50 chips no Início; “top 6” sem critérios; hero-metric SaaS de “prioritários”; lista com bullets visíveis.
Dados → decisão → apresentação
- Vou apresentar dados? Sim, superfície neste item — lista curta de municípios (nome + link) + contagem do conjunto
priority=altano escopo. - Decisões desbloqueadas: Staff: “dentre as prioritárias da mesa, quais abro agora (maior buraco de cobertura)?”; “quero o inventário completo → lista filtrada”.
- Forma escolhida: lista/chip-strip ranqueada (≤8) + contagem + CTA “Ver todas (N)” — por quê: o Início é atalho (E9 já é a fila completa). Rejeitado: mostrar os ~50 chips (polui o Início; E4R seedou ~50
alta); só KPI numérico sem nomes (perde o atalho de um toque); chart/mapa de prioritárias (vaidade; mapa já está acima). - Profile: categórico (município) + ordenação por déficit numérico derivado (E8/E9, cenário
central); granularidade município; tamanho típico amostra 6–8 de um conjunto ~50 (coordenador) ou ≤N do escopo (advisor); relativo (déficit de cobertura), não % estadual. - Anti-goals de dado: sem % estadual; sem reorder inventado paralelo a E9; sem inventar segundo campo de “prioridade do dashboard”.
Contexto
No dashboard staff (/campanha), CampaignDashboard renderiza a seção “Municípios prioritários” a partir de StaffDashboardView.priorityMunicipalities (src/utilities/campaignDashboardData.ts):
priorityMunicipalities: municipalities.docs
.filter((m) => m.priority === 'alta')
.slice(0, 6)
.map((m) => ({ name: m.name, slug: m.slug }))
Problemas observados (pedido de produto 2026-07-25):
- Semântica opaca. Após E4R, ~50 municípios têm
priority=alta(aba PRIORITÁRIAS da planilha). A seção mostra no máximo 6, na ordem do escopo (não ranqueada), sem dizer que há mais. O usuário lê como “estes são os prioritários” — mentira por omissão.highPriorityCountjá é calculado no loader e não é usado na UI (campo morto no view model). - Markup com bullets. A strip usa
<ul className="flex flex-wrap gap-2">semlist-none/ reset de margem — ao contrário deRecentlyVisitedCarde da strip de municípios em/campanha/assessores/[id]. Resultado: marcadores de lista visíveis nos chips.
A fila canônica de alocação já é /campanha/municipios (E9, default ?sort=deficit); o filtro ?priority=alta e o link da “coluna da vergonha” (?priority=alta&coverage=sem_assessor) já existem. O Início deve ser atalho, não segundo inventário.
Objetivos
- Redefinir a seção como atalho acionável sobre o conjunto
priority === 'alta'do escopo do ator (não como inventário truncado). - Ordenar a amostra pelo mesmo critério E9: déficit de cobertura da meta no cenário
central(maior buraco primeiro); municípios sem meta/goal=0no fim. - Limite da amostra: 8 (ou todos se o escopo tiver menos); header com contagem total
highPriorityCounte link “Ver todas” →buildMunicipalityListHref({ priority: 'alta', …defaults }). - Corrigir markup:
list-none m-0 p-0(e[&>li]:mt-0se necessário), espelhando o padrão de assessores/recentes — zero bullets. - Guardrails: sem migration, sem collection, sem Consent, sem server action;
leadernunca vê o dashboard; advisor continua no próprio escopo (loadMunicipalityScope).
Decisões travadas
- Semântica = atalho ranqueado + inventário na lista, não “os 6 prioritários”. A seção responde “quais prioritárias atacar agora?”; o conjunto completo vive em
/campanha/municipios?priority=alta. Rejeitado: mostrar ~50 chips no Início (polui; contradiz Field Desk); manter.slice(0, 6)sem sort nem contagem (status quo mentiroso); trocar a seção só por KPI sem nomes (perde o job de um toque); restringir a “sem assessor” só (já coberto pela coluna da vergonha no overview da lista — aqui o critério é déficit entre asalta). - Ordenação = déficit E9 (
central), reuso do bundle de cobertura já carregado.getCampaignDashboardDatajá chamaloadMunicipalityGoalCoverageBundle; ordenar asaltaporcoverage.deficitdesc antes do slice. Rejeitado: ordem alfabética / ordem do escopo; sort por votos 2022 (A11) nesta seção (a lente de alocação pós-E9 é cobertura); segundo loader só para prioritários. - Limite amostral = 8; CTA sempre que
highPriorityCount > amostra. Número alinhado a caps de dossiê/filas curtas; não expor constante mágica sem nome (DASHBOARD_PRIORITY_SAMPLE_LIMIT). Rejeitado: 6 sem copy de “há mais”; paginação no Início; “mostrar tudo” abaixo de um fold. - Markup:
ulcomlist-none(não trocar pordiv). Preserva lista acessível; precedentassessores/[id]+RecentlyVisitedCard. Rejeitado: deixar bullets; reinventar componente de chip-strip genérico (<3 call sites além destes). - i18n e naming (AGENTS.md): identificadores ingleses (
priorityMunicipalities,highPriorityCount,DASHBOARD_PRIORITY_SAMPLE_LIMIT); strings pt-BR (“Municípios prioritários”, “Ver todas”).
Questões em aberto
- Copy do subtítulo / CTA? Opções: A) só título + Badge com N + link “Ver todas”; B) linha “N prioritários · mostrando as 8 com maior déficit de cobertura”. Recomendação: A (clareza sob pressão; o sort é implícito pelo contexto pós-E9; B é didático demais para o Início). (assumido — validar com produto na primeira demo)
- Incluir chip “sem responsável” na amostra? Opções: A) não neste item (E9 já sinaliza na lista); B) priorizar
altasem assessor antes do sort por déficit. Recomendação: A — rabbit hole de segunda fila; se a mesa pedir, fill-in.
Abordagem proposta
flowchart LR
Scope["loadMunicipalityScope"]
Bundle["loadMunicipalityGoalCoverageBundle<br/>(já no dashboard)"]
Filter["filter priority=alta"]
Sort["sort by deficit central desc"]
Sample["slice(0, SAMPLE_LIMIT)"]
UI["CampaignDashboard section<br/>chips list-none + Ver todas"]
List["/campanha/municipios?priority=alta"]
Scope --> Filter
Bundle --> Sort
Filter --> Sort --> Sample --> UI
UI -->|"Ver todas"| List
Componentes:
getCampaignDashboardData(src/utilities/campaignDashboardData.ts): após o bundle E8, filtrarpriority === 'alta', ordenar porgoalCoverageBundle.coverageByMunicipalityIDno cenáriocentral— maiordeficitprimeiro;null/sem meta no fim;slice(0, DASHBOARD_PRIORITY_SAMPLE_LIMIT); continuar populandohighPriorityCount(agora consumido na UI). Helper puropickDashboardPriorityMunicipalitiesemsrc/utilities/dashboardPriorityMunicipalities.ts.CampaignDashboard(src/components/campaign/dashboard/CampaignDashboard.tsx): header da seção com título +Badge/spancomhighPriorityCount;ulcomm-0 flex list-none flex-wrap gap-2 p-0 [&>li]:mt-0; chipsButton outline+Linkcomo hoje; CTALink“Ver todas” viabuildMunicipalityListHrefcompriority: 'alta'(defaults de sort da lista —deficitdesc — alinhados a E9). Esconder CTA sehighPriorityCount <= amostra.- Unit test do helper de pick/sort (fixture 10 municipíos, assert ordem e limite).
- Migration: Sem migration, sem collection, sem server action.
Dependências
- Duras: nenhuma de item aberto — E4R ✓ (seed de
priority), E8 ✓ / E9 ✓ (cobertura + sortdeficit), filtro URLpriorityemmunicipalityListUrl.ts. - Reuso:
loadMunicipalityScope,loadMunicipalityGoalCoverageBundle,buildMunicipalityListHref, padrãolist-nonede assessores/recentes.
Não escopo
- Ícone Flag na lista de municípios → fill-in icone-prioridade-lista-municipios.md.
- Substituir
prioritypor níveis N0–N4 → E14. - Segunda fila “só sem assessor” no Início → já coberto por E9 (“coluna da vergonha”); não duplicar.
- Redesign do restante do dashboard / mapa / tabela TI (E17).
highPriorityCountnoCampaignMetricStrip(KPI vaidade; a seção + lista bastam).
Rabbit holes
- “Mostrar todos” com scroll interno. Vira inventário no Início e compete com a lista. Mitigação: amostra fixa + CTA.
- Sort paralelo inventado (votos, frescor, alfabetic). Diverge de E9 e confunde. Mitigação: só déficit
central. - Componente genérico
CampaignChipStrip. 2–3 call sites com markup trivial. Mitigação: copiar classes do precedente; abstrair só no 3º copy-paste futuro (gatilho).
Adiado com gatilho
- Priorizar “alta sem assessor” na amostra. Revisitar quando: CG pedir explicitamente no Início ou a coluna da vergonha deixar de ser descoberta na lista (evidência de sessão/R6).
- Expor
highPriorityCountno metric strip. Revisitar quando: houver 2º consumidor além do header da seção (hoje seria vaidade). - Extrair
sortByNullableValueparalib/. Revisitar no 3º call site de ordenação por valor nullable (E9 lista + B20 já compartilhamcentralDeficitSortValueemgoalCoverage.ts). - Paralelizar
loadMunicipalityGoalCoverageBundlecom os finds de pledge/update no loader do Início. Revisitar se TTFB medido do/campanhastaff virar gargalo.
Referências
docs/roadmap.md(B20; E9 fila; E4R seed ~50 alta)src/utilities/campaignDashboardData.ts—pickDashboardPriorityMunicipalities+highPriorityCountsrc/components/campaign/dashboard/CampaignDashboard.tsx— Badge, “Ver todas”,list-nonesrc/utilities/dashboardPriorityMunicipalities.ts— pick/sort (E9centraldéficit)src/utilities/municipalityListUrl.ts—buildMunicipalityListHref/ filtroprioritysrc/utilities/municipalityPageData.ts—applyDerivedMunicipalitySort(precedente déficit)src/app/(campaign)/campanha/(app)/assessores/[id]/page.tsx— striplist-nonede referênciasrc/components/campaign/dashboard/RecentlyVisitedCard.tsx—list-nonede referência- fila-de-alocacao.md (E9) · import-planilha-projecao.md (E4R, ~50 alta)
PRODUCT.md/DESIGN.md— Field Desk; anti dashboard SaaS- AGENTS.md — naming, access por escopo, staff-only dashboard