6.3 KiB
Desfazer o encadeamento automático das ações rápidas do wizard
Status: registrado Atualizado em: 2026-08-08 Issue: #422 Priority: P1 Model: composer-2.5 Model-local: deepseek-v4-flash-high Impeccable: B — encaixe no header do wizard (remover “Pular”) + navegação pós-save Canvas UI: /home/fsolla/.cursor/projects/home-fsolla-Code-teqo/canvases/plan-b168-ui-draft.canvas.tsx Appetite: ~0,5–1 dia eng; remover navegação de cadeia e skip; sem migration Responsável: —
Intenção
Durante a verificação em campo com o coordenador geral, o encadeamento automático das ações rápidas (B98) confundiu o usuário. Ao tocar “Ajustar votos”, ajustar e salvar, a tela avançava sozinha para “Mudar tendência” e depois para as próximas ações — sem que ele tivesse pedido. A expectativa de quem clica numa ação rápida é performar exatamente aquela ação e voltar. Existe aqui evidência de produto em campo (não suposição): o vereador/comando testou e rejeitou.
Persona e fluxo
- Persona / contexto: staff (coordenador/assessor) no celular, no meio da operação, dispare a ação rápida de um município na página em que está ou no Início.
- Job principal: fazer um ajuste específico e voltar ao ponto de origem com a confirmação de que funcionou — sem ser levado para outra ação.
- Fluxo desejado: toca a ação → wizard daquela ação → ajusta → salva → toast de sucesso → volta à origem (página de onde tocou ou Início). Header sempre com “X” (sair), nunca “Pular”.
- Anti-goals de produto: fluxos que abrem outros fluxos sozinhos; “continuidade” disfarçada de sugestão automática pós-save; segunda tela de sucesso; mexer no catálogo/strip das ações.
Esboço de fluxo (B)
Hoje (B98): ação A → ajuste A → save → [automático] ação B [Pular] → ação C [Pular] → … → Início
Desejado: ação A → ajuste A → save → toast → volta à origem (Início ou página de origem)
Objetivo e aceite
- Ao concluir qualquer ação rápida de ajuste (votos, tendência, atualização, liderança), o usuário volta à origem — nunca avança sozinho para outro wizard.
- O chrome do wizard não exibe mais “Pular” (nem “Pular mudança de tendência”, etc.) em etapa nenhuma; “X” (sair da ação) existe em todas as etapas e retorna à origem.
- Não existe mais fila encadeada,
entryActionde cadeia nem “próxima etapa sugerida” pós-save. - Guardrails que valem: retorno à origem via
fromallowlist (B110 — manter); wizards standalone intactos; liderança continua fora (já gateada); sem migration.
Dados (intenção)
- Vou apresentar dados? Não — fluxo de navegação, sem métrica superfície.
Direção no codebase (hipótese)
- Áreas prováveis:
src/lib/wizardActionChain.ts(matrizWIZARD_CHAIN_AFTER+ continue/end),src/lib/campaignWizardCopy.ts/wizardUpdateUi.ts/politicalTrendWizardUi.ts/wizardLeadershipContract.ts(skip resolvers +WIZARD_CHAIN_SKIP_LABEL), pontas de sucesso desrc/components/campaign/{shared,municipality,leadership}/*Wizard*Step.tsx(chamamwizardChainContinueHref), avanço da cadeia emsrc/app/(campaign)/campanha/(app)/acoes/[slug]/page.tsx(chamada emchange-trend),src/lib/campaignActionRoutes.ts(queryentryAction). - Precedente a olhar: B98
encadear-ajustes-wizard.md(#106) é o que este item inverte;wizard-retorno-pagina-origem.md(#149) — retorno à origem, manter;wizard-header-x-vs-pular.md(#104) ewizard-pular-curto-encadeadas.md(#131) — chrome X/Pular;wizard-voltar-passo-anterior-cadeia.md(#289) — “voltar” de elo encadeado perde sentido. - Risco de acoplamento:
entryActiontambém alimenta skip e prefill de nota de tendência; deep-links de demanda/atividade passamreturnPath. A profundidade da remoção (mínima vs limpeza total do plumbing/código morto) é decisão de implementação — nunca quebrar retorno à origem nem wizards standalone.
Dependências
- Nenhuma dura. Item é sucessor de intenção de B98 (#106, done/in-prod) — plano/Issue novos; B98 e demais antecedentes ficam imutáveis.
Fora de escopo
- Redesenho do chassis/header do wizard; nova tela de “concluído” (o toast basta).
- Alterar a strip/FAB de ações rápidas ou o catálogo do Início.
- Comportamento de “continuar/voltar ao passo anterior” fora do contexto de cadeia (B135 genérico).
- Decidir profundidade da limpeza de código — fica com
work-issue/agent-work-issue.
Rabbit holes de produto
- “Continuidade” como sugestão passiva. Se alguém “só completar” o desejo: reintroduz um segundo encadeamento (link automático pós-save) que o campo rejeitou. Corte neste item: nenhuma sugestão pós-save; só toast + retorno.
- Remover menos do que o necessário e deixar dois sistemas de navegação. Corte: o executor
decide, mas o resultado não pode ter
Pular/fila morta aparente para o usuário.
Questões em aberto (produto)
- Pós-save: retorno direto ou tela curta de confirmação? Opções: A) retorno direto à origem + toast (toast já existe) | B) tela “ação concluída” antes de voltar. Recomendação: A — o coordenador quer performar a ação e voltar; toast já confirma. (assumido)
- Oferecer “continuar para a próxima” como link opcional (não automático)? Opções: A) não oferecer nada | B) link discreto pós-save (ex. “Ajustar a tendência também”). Recomendação: A — o pedido em campo foi “cada ação performa exatamente a ação”; link pós-save é encadeamento disfarçado. (assumido)
Referências
- GitHub Issue #106 (B98 — o que se inverte) · #104 (B96) · #131 (B104) · #149 (B110 — manter retorno à origem) · #289 (B135)
- Canvas UI (gate): /home/fsolla/.cursor/projects/home-fsolla-Code-teqo/canvases/plan-b168-ui-draft.canvas.tsx
src/lib/wizardActionChain.ts·src/lib/campaignWizardCopy.ts·src/lib/campaignActionRoutes.ts·src/components/campaign/shared/WizardExpectedVotesStep.tsx(ponta de sucesso de exemplo) ·src/app/(campaign)/campanha/(app)/acoes/[slug]/page.tsx- AGENTS.md — naming / deletes (
knip) / convention de rotas pt-BR