Matriz B98 confirmada (cadeia completa nos 4 entries). Cabeçalhos dos planos com Issue # e status registrado.
5.9 KiB
Bug — Salvar tendência fecha o wizard (não volta ao começo)
Status: registrado
Atualizado em: 2026-08-01
Issue: #105
Priority: P0
Model: composer-2.5
Impeccable: B — pós-submit de WizardTrendNoteStep
Appetite: ~0,5d eng; race revalidate×redirect; sem migration
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (Feel the action; commit óbvio) · tema campaign.
Na implementação: craft compacto → critique → polish (toast + navegação).
Brief:
- Persona: CG salvou a justificativa de tendência.
- Job principal: sair do ritual com feedback de sucesso — não reabrir a grade de tendências.
- Anti-goals: loop escolha↔nota; sumir sem toast.
Wireframe (texto)
Antes (bug):
Nota → [Salvar] → (revalidate) página vê status==atual → redirect escolha
→ “volta ao começo”
Depois:
Nota → [Salvar] → toast “Tendência política registrada.” → Início
(ou, com B98: próximo encadeado / tela de sucesso)
Dados → decisão → apresentação
Dados: N/A — navegação pós-write; mensagem de toast já existe (WIZARD_TREND_SAVED_MESSAGE).
Contexto
WizardTrendNoteStep grava via setMunicipalityPoliticalTrendFormAction e, no sucesso client, useCampaignFormSuccessToast → router.push(CAMPAIGN_HOME).
A action também chama revalidateMunicipalityListPaths. A página RSC (acoes/[slug]/page.tsx) para change-trend, quando trendStatus query igual ao currentStatus do município (já persistido), faz redirect(...) de volta à etapa de escolha (sem tendencia=).
Ordem típica do bug:
- Usuário salva nota com
?tendencia=favoravel(atual era outra). - Write OK + revalidate; RSC refresha com
politicalTrend.status === favoravel. - Branch
trendStatus === currentStatus→ redirect para a escolha. - Client
router.push(HOME)perde a corrida ou é sobrescrito → sensação de “Salvar volta ao começo”.
Pedido (2026-08-01): Salvar fecha o wizard.
Objetivos
- Após Salvar bem-sucedido na nota de tendência, o usuário não permanece/reentra na grade de escolha do mesmo município.
- Destino v1: Início (toast intacto). Quando B98 existir, o destino pode ser o próximo da cadeia — este item deixa um único ponto de navegação pós-sucesso.
- Eliminar a corrida revalidate →
redirectde “status já atual” enquanto o client ainda está no passo nota ou tornar o redirect inofensivo (não mandar de volta à escolha após save). - Unit/int ou e2e smoke: save → URL final ≠ escolha do mesmo fluxo.
Decisões travadas
- Fechar = navegar para fora do passo nota com sucesso explícito (Início v1). Fonte: produto 2026-08-01. Rejeitado: ficar na nota com banner; voltar à escolha “para confirmar”.
- Corrigir a race no server redirect e/ou no success path — não só
router.pushmais agressivo. OredirectquandotrendStatus === currentStatusé legítimo para deep-link stale antes do save; pós-save ele vira armadilha. Rejeitado: sórouter.replace(HOME)sem mudar o redirect (continua flash/loop em rede lenta). - Preferência de implementação (barata): success path da form action (ou wrapper do wizard) usa
redirect(CAMPAIGN_HOME)server-side ou a página deixa de redirecionar à escolha quando o doc já reflete o query (tratar como “já aplicado” → home / success). Recomendação no craft:runCampaignRedirectFormAction/ redirect no success do wizard trend (precedente outros forms) ou client navigation + não revalidar a rota do wizard antes do push. Pin a opção no as-built. - i18n:
WIZARD_TREND_SAVED_MESSAGEintacto.
Questões em aberto
- Redirect server na action vs client toast+push? Opções: A
redirectna action (fecha cedo; toast via query?saved=1) | B manter toast client mas impedir redirect RSC à escolha (ex. não revalidate path do wizard; ou branch “same status” → home). Recomendação: B com revalidate seletivo + push, ou A se B ainda correr — Feel the action prefere toast; redirect puro sem toast é pior. (assumido)
Abordagem proposta
flowchart TD
Save["POST trend note"] --> Write["setMunicipalityPoliticalTrend"]
Write --> Reval["revalidate listas"]
Write --> Success["status success"]
Success --> Nav["navigate HOME (sem passar pela escolha)"]
Page["RSC change-trend"] -->|"stale deep-link only"| Choice["redirect escolha"]
Page -->|"post-save same status"| NotChoice["não empurrar escolha"]
Componentes:
WizardTrendNoteStep.tsx+municipalityStaffFormActions.ts/ páginaacoes/[slug]: quebrar a corrida (detalhe no craft).acoes/[slug]/page.tsx: revisitar branchtrendStatus === currentStatus— distinguir deep-link inválido vs “já salvo”.- Teste: unit do helper de resolução de destino; e2e smoke se barato.
- Migration: Sem migration.
Dependências
- Nenhuma dura. Soft: B64 ✓. Compatível com B96 (X no standalone). Destino encadeado futuro: B98.
Não escopo
- Encadear tendência após votos → B98.
- Mudar tiles/nota UI.
- Autosave da lista (B24) — outro path.
Rabbit holes
- Optimistic UI da tendência no wizard. Mitigação: fix de navegação só.
- Remover o guard
trendStatus === currentStatuspor completo. Pode reabrir deep-links lixo; mitigar com destino home ou mensagem, não loop.
Adiado com gatilho
- Pós-sucesso → próximo da cadeia. B98.
Referências
src/components/campaign/municipality/WizardTrendNoteStep.tsxsrc/app/(campaign)/campanha/(app)/acoes/[slug]/page.tsx(branch change-trend)src/app/(campaign)/campanha/(app)/municipios/municipalityStaffFormActions.tssrc/components/campaign/shared/useCampaignFormSuccessToast.ts- wizard-mudar-tendencia.md
- AGENTS.md — Feel the action / form actions
Qualidade de decisão: 5/5