teqo-backup/docs/plans/wizard-voltar-passo-anterior-cadeia-impl.md
Cursor Agent 28525aab4b
B135 — Voltar no wizard usa passo lógico anterior na cadeia (#289)
- wizardPreviousHref em wizardActionChain para todos os elos B98
- Avanço encadeado com router.push; Voltar no chrome com replace
- Testes unitários para href anterior e navegação pending

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-08-02 23:04:26 +00:00

61 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Impl: Wizard — Voltar = passo imediatamente anterior (também na cadeia)
Status: aprovado
Atualizado em: 2026-08-02
Issue: #289
Intenção: docs/plans/wizard-voltar-passo-anterior-cadeia.md
Appetite restante: herdado (~0,5–1d)
## Leitura da intenção
- **Outcome:** Voltar (header + back do SO) no wizard `/campanha/acoes/*` navega ao passo lógico imediatamente anterior — na cadeia B98, do 1º passo de um elo encadeado volta ao passo principal do elo anterior no mesmo município, nunca à busca de município.
- **O que NÃO negociar:** staff only; sem migration; leader lockdown; `returnPath` (B110) intacto; Registrar pedido (A5) fora — só contrato plugável.
- **O que reavaliar:** hipótese de “history replace no avanço” — confirmado como causa do back cego; corrigir com `push` no avanço + `replace` no Voltar.
## Abordagem recomendada
```mermaid
flowchart LR
Steps["Wizard steps"] --> Prev["wizardPreviousHref"]
Prev --> Chain["wizardActionChain"]
Forward["Salvar / encadear"] --> Push["router.push"]
Voltar["Header Voltar"] --> Replace["router.replace(previousHref)"]
SOBack["SO back"] --> History["history stack coerente"]
```
**Opções consideradas:** A) só corrigir `previousHref` | B) `previousHref` + push/replace | C) popstate interceptor global
**Recomendação:** **B** — dono único de passo anterior em `wizardActionChain`; avanço empilha histórico; Voltar substitui entrada atual para não duplicar.
**Rejeitadas:** C (explode appetite); A sem push (back do SO continua mentindo).
### Componentes / mudanças
- **`wizardPreviousHref`** (`src/lib/wizardActionChain.ts`): `WizardStepKind` + href do passo anterior (interno, principal, elo encadeado).
- **Steps** (`Wizard*Step.tsx`): trocar `previousHref` ad hoc pelo helper.
- **`CampaignWizardNavLink`**: prop `replace` para Voltar.
- **`CampaignMobileTopBar`**: Voltar com `replace={true}`.
- **Chain continues** (`WizardExpectedVotesStep`, `WizardTrendNoteStep`, `WizardSignalBodyStep`, `WizardLeadershipStep`): `router.push` em vez de `replace`.
- **Migration:** sem migration.
- **Testes:** unit em `wizardActionChain.unit.spec.ts`; ajuste em `wizardExpectedVotesStep`, `wizardNavigationPending`.
## Fases verificáveis
1. **Tracer** — `wizardPreviousHref` + unit tests.
2. **UI** — steps + nav semantics (push/replace).
3. **Gates** — `pnpm gate:fast`; entrega `pnpm push`.
## Rabbit holes / Não escopo (engenharia)
- Implementar A5 / registrar-pedido.
- Popstate handler global fora do wizard.
- Desfazer saves ao voltar.
## Riscos e mitigação
- **Histórico duplicado se Voltar usa push** — mitigado com `replace` no chrome Voltar.
- **Leadership form vs grid** — `previousHref` dinâmico por `mode`.
## Aceite de engenharia
- [x] Aceite de produto da intenção coberto
- [x] Invariantes AGENTS/engineering-standards
- [x] Testes unit previstos