mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-16 03:03: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>
2.8 KiB
2.8 KiB
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
pushno avanço +replaceno Voltar.
Abordagem recomendada
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): trocarpreviousHrefad hoc pelo helper. CampaignWizardNavLink: propreplacepara Voltar.CampaignMobileTopBar: Voltar comreplace={true}.- Chain continues (
WizardExpectedVotesStep,WizardTrendNoteStep,WizardSignalBodyStep,WizardLeadershipStep):router.pushem vez dereplace. - Migration: sem migration.
- Testes: unit em
wizardActionChain.unit.spec.ts; ajuste emwizardExpectedVotesStep,wizardNavigationPending.
Fases verificáveis
- Tracer —
wizardPreviousHref+ unit tests. - UI — steps + nav semantics (push/replace).
- Gates —
pnpm gate:fast; entregapnpm 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
replaceno chrome Voltar. - Leadership form vs grid —
previousHrefdinâmico pormode.
Aceite de engenharia
- Aceite de produto da intenção coberto
- Invariantes AGENTS/engineering-standards
- Testes unit previstos