Extract dashboard cards into focused components (queues, upcoming plans, leadership status, recently visited, choropleth legend), compile the roadmap for outcome-oriented tracking, document the customer job and improve-app journey, and tighten roadmap skills with decision-quality gates.
7.6 KiB
Escala e DRY pós-Field Desk
Status: registrado no roadmap (fases pendentes)
Atualizado em: 2026-07-20
Item do roadmap: docs/roadmap.md (FD+, fill-in de engenharia pós-polish Impeccable /campanha)
Responsável: —
Contexto
Em 2026-07-19 a vertical /campanha passou por um ciclo Impeccable (critique 28→32, quieter/layout/distill/clarify/harden/polish) alinhado ao North Star Field Desk (PRODUCT.md / DESIGN.md). Entregas locais incluem CampaignPageShell, CampaignMetricStrip, CampaignDataFreshness, filas-first no dashboard, NucleusFilters com “Mais filtros”, empties de liderança/coordenador esclarecidos, freshness request-time, tipografia font-semibold e loadings alinhados.
A passagem /simplify (2026-07-19) aplicou cleanup pontual (freshness sem ramo relativo morto, strip sem métricas duplicadas do card de prioridade, hidden único nos filtros avançados, wrappers de data inlined, Badge simplificado). Os revisores (quality / reuse / performance) deixaram débitos maiores que cleanup — registrados aqui.
Já resolvido no simplify (não reabrir): formatCampaignDataFreshness morto removido; CampaignDataFreshness só asOf + “Atualizado agora”; overview sem Gap/série no strip (ficam no card); MetricStrip sem bg-card interno em células quietas; hidden={!advancedOpen} sem className duplicado; relativeDate* inlined em overview/feed; comments de shell/strip.
Já resolvido no ciclo dashboard (2026-07-19/20 — parcial; não reabrir): formatElectionNumber no dashboard geral (CampaignDashboard, LeadershipStatusCard) em vez de Intl.NumberFormat local — overlap parcial com objetivo “datas/números canônicos”; VR+ F2 (formatRelativeAge variants) e FD+ F4 (listagens) permanecem pendentes.
Adiado com gatilho (triage capture-review-debts 2026-07-20): fundir dois CampaignMetricStrip do dashboard em grid 2×3 — só quando houver terceira strip no home ou na Fase 3 VoteGoals→MetricStrip.
Overlap com VR+: VR+ Fase 2 ainda cita migrar lastUpdateLabel / feed — o feed já usa formatRelativeAge; o restante de VR+ F2 (variante floor-dias no dashboard) permanece em escala-dry-pos-visitados-recentemente.md, não aqui.
Objetivos
- Um único shell de página (
CampaignPageShell+ variantes de largura) para listas, detalhe e forms de/campanha. - Um token de tipografia de página (
campaignPageHeadingClassName) sem repetirtext-2xl font-semibold tracking-tightem ~15 h1s. - Datas absolutas/relativas de superfície de campanha passam pelos helpers canônicos (
formatRelativeAge/formatBahiaDateTimeLabel), não porIntllocal. NucleusVoteGoalsreutilizaCampaignMetricStriponde o layout for equivalente.NucleusFiltersdeixa de carregar baghandlers+ listaprimaryFilterNamessó para concatenar nomes.- Guardrails: sem migration, sem collection, sem Consent; só DRY/composição UI.
Decisões travadas
- Um plano FD+, fases ordenadas. Precedente VR+/RS+/O0+: um registro no roadmap, PRs por fase.
- Dependência suave do polish Field Desk (branch local / merge pendente). Não bloqueia uso da vertical.
- Cortável: Fases 3–5 (VoteGoals strip, filtros bag, datas em listagens fora do core polish) se o prazo apertar; Fases 1–2 (shell size + heading class) são as de maior ROI de consistência.
- i18n e naming (AGENTS.md): identificadores em inglês (
campaignPageHeadingClassName,size: 'form' | 'detail' | 'list'), strings visíveis em pt-BR.
Questões em aberto
sizeno shell vsclassNamead-hoc? Forms usammax-w-3xl/4xl, detalhemax-w-6xl, listasmax-w-screen-2xl. Recomendação: propsize: 'list' | 'form' | 'detail'mapeando para classes já usadas; permitirclassNamesó para exceções (ex. perfilmax-w-2xl).- Heading class no shell ou export solto? Recomendação: exportar
campaignPageHeadingClassNameao lado decampaignPageShellClassNameemCampaignPageShell.tsx— mesmo padrão de discovery. - VoteGoals → MetricStrip agora? Só 3 métricas + Progress separado. Recomendação: Fase 3 só se o Progress “vs meta regular” couber no strip (
progressna meta regular) sem perder o card de contexto do detalhe.
Abordagem proposta
flowchart TD
FD["Field Desk polish ✓ (local)"] --> F1
F1["Fase 1 — CampaignPageShell size<br/>list / form / detail"]
F1 --> F2["Fase 2 — campaignPageHeadingClassName"]
F2 --> F3["Fase 3 — NucleusVoteGoals → MetricStrip"]
F3 --> F4["Fase 4 — Datas canônicas<br/>NucleusList / detalhe / ActionPlanUpdateFeed"]
F4 --> F5["Fase 5 — NucleusFilters handlers<br/>+ filterNames flat"]
Fase 1 — Shell com size
- Estender
CampaignPageShell(src/components/campaign/CampaignPageShell.tsx) comsize?: 'list' | 'form' | 'detail'(default'list'=campaignPageShellClassNameatual). - Migrar páginas que ainda usam
mx-auto flex w-full max-w-{3xl,4xl,6xl} flex-col gap-6:nucleos/novo,nucleos/[slug],nucleos/[slug]/editar,apoiadores/novo|importar|[id],planos/novo|[slug]|editar, e alinharCampaignProfileSettings(max-w-2xlviaclassNameou sizeform+ override). - Loadings já no shell — sem mudança.
Fase 2 — Heading class compartilhada
- Exportar
campaignPageHeadingClassName = 'text-2xl font-semibold tracking-tight'. - Aplicar nos h1 de páginas de campanha + títulos de dashboard (
CampaignDashboard) + perfil.
Fase 3 — NucleusVoteGoals → CampaignMetricStrip
- Refatorar
NucleusVoteGoalspara emitir as três metas viaCampaignMetricStrip; manter Progress de “vs meta regular” abaixo ou comoprogressna métrica regular. - Não alterar domínio/loaders de
voteGoals.
Fase 4 — Datas canônicas fora do core polish
NucleusList.tsx:lastUpdateAt→formatRelativeAge(paridade com dashboard) ouformatBahiaDateTimeLabelse produto quiser absoluto — Recomendação: relativo, como dashboard.nucleos/[slug]/page.tsx: timestamps de estimativa →formatBahiaDateTimeLabel.ActionPlanUpdateFeed.tsx: alinhar aformatRelativeAge+nowdo servidor (paridade comNucleusUpdateFeed).
Fase 5 — NucleusFilters bag
- Remover objeto
handlers: SharedFilterHandlerse espalhar props; colapsarprimaryFilterNames+advancedFilterNamesnuma única listafilterNamescom marcação advanced se ainda precisar do count.
Dependências
- Soft: polish Field Desk mergeado (shell/strip/freshness já no branch).
- Soft overlap: VR+ F2 (relative age no dashboard cards) — coordenar para não duplicar PRs.
- Sem migration, sem Consent.
Não escopo
- Triagem em lote das filas, glossário/tooltips, outline h1→h2, empty de coordenador com CTA, motion do Sidebar — item FD2 (field-desk-ux-pos-critique.md).
- Reabrir quieter/layout/distill já entregues (KPI strips, Mais filtros, side-tab).
- Saved filter views / bulk além da fila de prioridade — produto em FD2 Fase 1; escopo além disso fica para item futuro.
Referências
docs/roadmap.md(Fill-ins FD+).impeccable/critique/2026-07-19T11-03-23Z__src-app-campaign-campanha.md— score 32; minor “detail/form max-w”src/components/campaign/CampaignPageShell.tsx,CampaignMetricStrip.tsx,NucleusFilters.tsx,NucleusVoteGoals.tsx,NucleusList.tsx,ActionPlanUpdateFeed.tsx- escala-dry-pos-visitados-recentemente.md — VR+ (overlap tempo relativo)
- AGENTS.md — naming inglês; tema
campaign