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.
9.7 KiB
UX Field Desk pós-critique
Status: registrado no roadmap (fases pendentes)
Atualizado em: 2026-07-20
Item do roadmap: docs/roadmap.md (FD2, fill-in de design/produto pós-critique Impeccable /campanha)
Responsável: —
Contexto
O re-critique de /campanha (2026-07-19, dual-agent) subiu o score de 28 → 32/40 após o ciclo quieter → polish. Em 2026-07-19/20, um segundo ciclo (layout dashboard geral, /simplify, re-critique) manteve 32/40 e fechou os P1 visuais do dashboard isolado (27→32 no eixo home). Os P1 do baseline anterior (parede de filtros, grade de KPI cards, side-tab) já estavam fechados. Permanecem débitos de design/produto registrados nas fases abaixo.
Fontes: .impeccable/critique/2026-07-19T11-03-23Z__src-app-campaign-campanha.md, .impeccable/critique/2026-07-20T00-01-43Z__src-app-campaign-campanha.md e triage capture-review-debts (2026-07-20).
Objetivos
- Alex (geral/coordenador) consegue tratar a fila Prioridade · Sem coordenador com multi-select + ação em lote (atribuir coordenador), sem N navegações.
- Lia e first-timers encontram definição inline de jargão recorrente (
engajado, estimativa confirmada vs proposta, status de apoio) sem sair da tela. - Outline do dashboard
geralnão pula deh1parah3(detectorskipped-heading; Sam/a11y). - Empty do coordenador sem núcleos espelha o padrão de liderança (CTA + próximo passo).
- Guardrails: sem migration obrigatória na v1 da triagem (reusa designação de coordenador existente); sem Consent novo; touch
min-h-11preservado.
Já resolvido nesta sessão (dashboard + simplify, 2026-07-19/20 — não reabrir)
Registrado via capture-review-debts após layout dashboard + /simplify + re-critique Impeccable.
GeneralDashboardTopRow— grid desktop 3:2:1 (Filas | Próximos eventos | Recentes); reflow 4:2 quando sem visitas.ActionQueuesCard— subseções vazias omitidas; estado único “Tudo em dia” (CheckCircle2Icon+Empty).ChoroplethLegend— barra rose→vermelho com rótulos 0/máx (formatElectionNumber).LeadershipStatusCard— título, descrição, CTA “Ver núcleos”, grid com ênfase emengajado, empty dedicado.RecentlyVisitedCard— dedup comRecentlyVisited;aria-labelno limpar;list-none; modocompact/labeled.CampaignPageShell—mx-auto(centro em ultra-wide).formatElectionNumberno dashboard (CampaignDashboard,LeadershipStatusCard) em vez deIntllocal.buildDashboardQueueItemHref— import direto deActionQueuesCard(sem re-export emCampaignDashboard).- Props
emptymortas removidas deQueueSection;useCallbackestável emonVisitCountChange; hidratação SSR do painel recentes (useEffect+useState([])).
Decisões travadas
- Um plano FD2, fases por severidade do critique. P2 antes de P3. Ordem: triagem em lote (impacto Alex) → glossário inline (Help) → outline a11y → empty coordenador → chrome motion (cortável).
- Bulk só na fila de prioridade na v1. As filas “sem atualização” e “estimativas pendentes” continuam one-by-one até haver evidência de volume — evita escopo de “saved views” genérico.
- Glossário = affordance inline, não página de docs. Tooltip/
Popover/?emSupportStatusBadgee labels de estimativa; uma frase Núcleo/ZE já existe na lista. - P3 mobile red bar vs rail permanece documentado em
DESIGN.mdcomo field-mode intencional — fora deste plano (escolha explícita no ciclo Impeccable). - i18n e naming: identificadores em inglês (
bulkAssignCoordinators,CampaignGlossaryHint), copy em pt-BR.
Questões em aberto
- Bulk assign: mesmo sheet de designação ou fluxo novo? Recomendação: reusar o shell/lazy de
assignCoordinatorspor núcleo em sequência sob uma txn ou N actions com progresso — não inventar multi-núcleo no Payload sem necessidade; UX é checklist + um coordenador aplicado a N slugs. - Quem pode bulk? Recomendação: só
geral(já é quem designa coordenadores em massa conceitualmente);coordenadornão aparece na fila “Sem coordenador”. - Primeiro glossário: tooltip Radix ou texto expandido? Recomendação:
Popover/HoverCardcommin-h-11no gatilho?— funciona em touch melhor que hover-only. - Ícone AlertTriangle no empty de liderança? Critique minor: tom alarmista. Recomendação: trocar para
UsersIcon/InboxIconna mesma passagem do empty do coordenador (Fase 4).
Abordagem proposta
flowchart TD
CR["Critique 32/40"] --> F1
F1["Fase 1 — Triagem em lote<br/>fila Sem coordenador"]
F1 --> F2["Fase 2 — Glossário inline<br/>engajado / estimativa / apoio"]
F2 --> F3["Fase 3 — Outline h2 Filas<br/>dashboard geral"]
F3 --> F4["Fase 4 — Empty coordenador + CTA<br/>(+ ícone liderança)"]
F4 --> F5["Fase 5 — Sidebar layout-transition<br/>(cortável)"]
Fase 1 — Triagem em lote (P2)
- Em
ActionQueuesCard/QueueSectioncomopenCoordinatorAssignment: modo multi-select (checkbox por linha) + barra “Atribuir coordenador (N)”. - Server action (ou extensão da existente de assign) recebe
nucleusSlugs[]+coordinatorIds[]; accessgeral;overrideAccess: false; txn se multi-write. - Reusa padrões de
CoordinatorAssignment/ shell lazy do detalhe do núcleo — extrair só o necessário para não puxar o editor completo N vezes no client. - Opcional (critique h1=3): exibir idade relativa na linha da fila (“sem atualização há X dias”) quando o item vier de
withoutRecentUpdate— só metadado de leitura; não bloqueia bulk.
Fase 2 — Glossário inline (P2)
CampaignGlossaryHint(novo, pequeno): propstermKey, children trigger.- Ligar em
SupportStatusBadge, cartão de estimativa (VoteEstimateCard/ labels no dashboard de liderança), e opcionalmente chip de ZE se ainda houver dúvida após a frase da lista. - Copy curta aprovável por produto (sem inventar doutrina eleitoral).
Fase 3 — Outline do dashboard (P2 a11y)
- Em
CampaignDashboard(GeneralDashboard): promover “Filas de ação” ah2visível (hoje sóCardTitleemdiv); manter títulos de cada fila comoh3. - Verificar ordem DOM: h1 → h2 Filas → h3s → h2 Indicadores.
Fase 4 — Empty coordenador + polish P3 (P3)
- Espelhar
LeadershipDashboardempty:EmptyMedia+ CTA (Ver meu perfile/ou texto “peça à coordenação geral…”). - Suavizar ícone do empty de liderança (
AlertTriangle→UsersIcon/InboxIcon). RecentlyVisitedCardcompact: mostrarformatRelativeAgevisível (text-xs text-muted-foreground, truncado) — hoje sósr-only(critique Alex).UpcomingActionPlansCard: empty com componenteEmpty(hoje<p>solto) + link opcional “Criar plano” parageral.
Fase 5 — Motion do Sidebar (P3, cortável)
- Em
Sidebar.tsx(ou wrapper campaign): evitartransition-[width,height,padding]em favor detransform/opacityonde o detector marcoulayout-transition. - Só se profiling/UX mostrar jank; caso contrário cortar.
Dependências
- Soft: polish Field Desk (filas, empties base) mergeado.
- Soft: FD+ (shell/heading) melhora consistência mas não bloqueia FD2.
- Reusa
CampaignDashboard.tsx, access de designação de coordenador,SupportStatusBadge, tema campaign. - Sem migration na v1; sem Consent.
Não escopo
- DRY de shell/heading/datas/VoteGoals/filters bag — FD+ (escala-dry-pos-field-desk.md).
- Saved views genéricas de filtros de lista (além do bulk da fila).
- Quiet da barra vermelha mobile (field-mode documentado).
- Bulk nas filas secundárias do dashboard.
- Push/offline ambient cue no shell (Casey) — candidato a D1/D2 follow-up, não este plano.
- Mapa clicável para filtrar núcleos (pergunta de produto; read-only em v1).
max-w-screen-2xl/ margem ultra-wide — cap intencional do Field Desk.- Cadeia de wrappers do mapa /
CardHeaderno mapa — polish cosmético descartado no triage. - Top-row 3:2:1 no dashboard coordenador — adiado até produto pedir paridade com
geral.
Explicitamente fora (triage capture-review-debts 2026-07-20)
- VR+ F1 (
pageshow/storageem recentes) — permanece em escala-dry-pos-visitados-recentemente.md. - VR+ F3 (
CampaignLinkListRow) — defer: gatilho 3º painel de atalhos ou drift visual. - VR+ F4 (shell por role) — defer:
GeneralDashboardTopRowcobregeral; coord/liderança pendem. - FD+ merge de dois
CampaignMetricStripem grid 2×3 — defer: gatilho terceira strip ou refactor VoteGoals F3. - Re-export cleanup
SupportStatus; reuseNucleusListOverview→UpcomingActionPlansCard— pureza/DRY descartados.
Referências
.impeccable/critique/2026-07-19T11-03-23Z__src-app-campaign-campanha.md.impeccable/critique/2026-07-20T00-01-43Z__src-app-campaign-campanha.mddocs/roadmap.md(Fill-ins FD2)PRODUCT.md/DESIGN.md— Field Desk, Signal Red, personas Alex/Casey/Liasrc/components/campaign/ActionQueuesCard.tsx,GeneralDashboardTopRow.tsx,RecentlyVisitedCard.tsx,LeadershipStatusCard.tsx,ChoroplethLegend.tsx,CampaignDashboard.tsx,SupportStatusBadge.tsx, shells de assign de coordenador- AGENTS.md — campaign auth,
overrideAccess: false, naming