mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-19 07:45:18 +00:00
109 lines
6.3 KiB
Markdown
109 lines
6.3 KiB
Markdown
# 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)
|
||
|
||
```text
|
||
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, `entryAction` de cadeia nem “próxima etapa sugerida” pós-save.
|
||
- Guardrails que valem: retorno à origem via `from` allowlist (**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` (matriz `WIZARD_CHAIN_AFTER` + continue/end),
|
||
`src/lib/campaignWizardCopy.ts` / `wizardUpdateUi.ts` / `politicalTrendWizardUi.ts` /
|
||
`wizardLeadershipContract.ts` (skip resolvers + `WIZARD_CHAIN_SKIP_LABEL`), pontas de sucesso de
|
||
`src/components/campaign/{shared,municipality,leadership}/*Wizard*Step.tsx` (chamam
|
||
`wizardChainContinueHref`), avanço da cadeia em `src/app/(campaign)/campanha/(app)/acoes/[slug]/page.tsx`
|
||
(chamada em `change-trend`), `src/lib/campaignActionRoutes.ts` (query `entryAction`).
|
||
- **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) e `wizard-pular-curto-encadeadas.md` (#131) — chrome X/Pular; `wizard-voltar-passo-anterior-cadeia.md`
|
||
(#289) — “voltar” de elo encadeado perde sentido.
|
||
- **Risco de acoplamento:** `entryAction` também alimenta skip e prefill de nota de tendência; deep-links
|
||
de demanda/atividade passam `returnPath`. 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
|