teqo-backup/docs/plans/bug-salvar-tendencia-fecha-wizard.md
Cursor Agent 746030d253
docs: registra OPS11 + B95–B99 (#102–#107) pós-gate
Matriz B98 confirmada (cadeia completa nos 4 entries). Cabeçalhos
dos planos com Issue # e status registrado.
2026-08-01 10:48:04 +00:00

5.9 KiB
Raw Blame History

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:

  1. Usuário salva nota com ?tendencia=favoravel (atual era outra).
  2. Write OK + revalidate; RSC refresha com politicalTrend.status === favoravel.
  3. Branch trendStatus === currentStatus → redirect para a escolha.
  4. 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 → redirect de “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.push mais agressivo. O redirect quando trendStatus === 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_MESSAGE intacto.

Questões em aberto

  • Redirect server na action vs client toast+push? Opções: A redirect na 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ágina acoes/[slug]: quebrar a corrida (detalhe no craft).
  • acoes/[slug]/page.tsx: revisitar branch trendStatus === 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 === currentStatus por 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.tsx
  • src/app/(campaign)/campanha/(app)/acoes/[slug]/page.tsx (branch change-trend)
  • src/app/(campaign)/campanha/(app)/municipios/municipalityStaffFormActions.ts
  • src/components/campaign/shared/useCampaignFormSuccessToast.ts
  • wizard-mudar-tendencia.md
  • AGENTS.md — Feel the action / form actions

Qualidade de decisão: 5/5