mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-18 14:13:06 +00:00
- 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>
61 lines
2.8 KiB
Markdown
61 lines
2.8 KiB
Markdown
# 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
|