mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-18 05:53:05 +00:00
Matriz B98 confirmada (cadeia completa nos 4 entries). Cabeçalhos dos planos com Issue # e status registrado.
120 lines
5.9 KiB
Markdown
120 lines
5.9 KiB
Markdown
# Bug — Salvar tendência fecha o wizard (não volta ao começo)
|
||
|
||
Status: registrado
|
||
Atualizado em: 2026-08-01
|
||
Issue: #105
|
||
Priority: P0
|
||
Model: composer-2.5
|
||
Impeccable: B — pós-submit de `WizardTrendNoteStep`
|
||
Appetite: ~0,5d eng; race revalidate×redirect; sem migration
|
||
Responsável: —
|
||
|
||
## Design (Impeccable)
|
||
|
||
Âncoras: `PRODUCT.md` (Feel the action; commit óbvio) · tema `campaign`.
|
||
|
||
Na implementação: craft compacto → critique → polish (toast + navegação).
|
||
|
||
Brief:
|
||
|
||
- **Persona:** CG salvou a justificativa de tendência.
|
||
- **Job principal:** sair do ritual com feedback de sucesso — **não** reabrir a grade de tendências.
|
||
- **Anti-goals:** loop escolha↔nota; sumir sem toast.
|
||
|
||
### Wireframe (texto)
|
||
|
||
```text
|
||
Antes (bug):
|
||
Nota → [Salvar] → (revalidate) página vê status==atual → redirect escolha
|
||
→ “volta ao começo”
|
||
|
||
Depois:
|
||
Nota → [Salvar] → toast “Tendência política registrada.” → Início
|
||
(ou, com B98: próximo encadeado / tela de sucesso)
|
||
```
|
||
|
||
## Dados → decisão → apresentação
|
||
|
||
Dados: N/A — navegação pós-write; mensagem de toast já existe (`WIZARD_TREND_SAVED_MESSAGE`).
|
||
|
||
## Contexto
|
||
|
||
`WizardTrendNoteStep` grava via `setMunicipalityPoliticalTrendFormAction` e, no sucesso client, `useCampaignFormSuccessToast` → `router.push(CAMPAIGN_HOME)`.
|
||
|
||
A action também chama `revalidateMunicipalityListPaths`. A página RSC (`acoes/[slug]/page.tsx`) para `change-trend`, quando `trendStatus` query **igual** ao `currentStatus` do município (já persistido), faz `redirect(...)` **de volta à etapa de escolha** (sem `tendencia=`).
|
||
|
||
Ordem típica do bug:
|
||
|
||
1. Usuário salva nota com `?tendencia=favoravel` (atual era outra).
|
||
2. Write OK + revalidate; RSC refresha com `politicalTrend.status === favoravel`.
|
||
3. Branch `trendStatus === currentStatus` → **redirect para a escolha**.
|
||
4. Client `router.push(HOME)` perde a corrida ou é sobrescrito → sensação de “Salvar volta ao começo”.
|
||
|
||
Pedido (2026-08-01): Salvar **fecha** o wizard.
|
||
|
||
## Objetivos
|
||
|
||
- Após Salvar bem-sucedido na nota de tendência, o usuário **não** permanece/reentra na grade de escolha do mesmo município.
|
||
- Destino v1: **Início** (toast intacto). Quando **B98** existir, o destino pode ser o próximo da cadeia — este item deixa um único ponto de navegação pós-sucesso.
|
||
- Eliminar a corrida revalidate → `redirect` de “status já atual” enquanto o client ainda está no passo nota **ou** tornar o redirect inofensivo (não mandar de volta à escolha após save).
|
||
- Unit/int ou e2e smoke: save → URL final ≠ escolha do mesmo fluxo.
|
||
|
||
## Decisões travadas
|
||
|
||
- **Fechar = navegar para fora do passo nota com sucesso explícito (Início v1).** Fonte: produto 2026-08-01. **Rejeitado:** ficar na nota com banner; voltar à escolha “para confirmar”.
|
||
- **Corrigir a race no server redirect e/ou no success path — não só `router.push` mais agressivo.** O `redirect` quando `trendStatus === currentStatus` é legítimo para deep-link stale **antes** do save; pós-save ele vira armadilha. **Rejeitado:** só `router.replace(HOME)` sem mudar o redirect (continua flash/loop em rede lenta).
|
||
- **Preferência de implementação (barata):** success path da form action (ou wrapper do wizard) usa `redirect(CAMPAIGN_HOME)` server-side **ou** a página deixa de redirecionar à escolha quando o doc já reflete o query (tratar como “já aplicado” → home / success). **Recomendação no craft:** `runCampaignRedirectFormAction` / redirect no success do wizard trend (precedente outros forms) **ou** client navigation + não revalidar a rota do wizard antes do push. Pin a opção no as-built.
|
||
- **i18n:** `WIZARD_TREND_SAVED_MESSAGE` intacto.
|
||
|
||
## Questões em aberto
|
||
|
||
- **Redirect server na action vs client toast+push?** **Opções:** A `redirect` na action (fecha cedo; toast via query `?saved=1`) | B manter toast client mas impedir redirect RSC à escolha (ex. não revalidate path do wizard; ou branch “same status” → home). **Recomendação:** **B com revalidate seletivo + push**, ou A se B ainda correr — Feel the action prefere toast; redirect puro sem toast é pior. _(assumido)_
|
||
|
||
## Abordagem proposta
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
Save["POST trend note"] --> Write["setMunicipalityPoliticalTrend"]
|
||
Write --> Reval["revalidate listas"]
|
||
Write --> Success["status success"]
|
||
Success --> Nav["navigate HOME (sem passar pela escolha)"]
|
||
Page["RSC change-trend"] -->|"stale deep-link only"| Choice["redirect escolha"]
|
||
Page -->|"post-save same status"| NotChoice["não empurrar escolha"]
|
||
```
|
||
|
||
Componentes:
|
||
|
||
- **`WizardTrendNoteStep.tsx`** + **`municipalityStaffFormActions.ts`** / página `acoes/[slug]`: quebrar a corrida (detalhe no craft).
|
||
- **`acoes/[slug]/page.tsx`**: revisitar branch `trendStatus === currentStatus` — distinguir deep-link inválido vs “já salvo”.
|
||
- **Teste:** unit do helper de resolução de destino; e2e smoke se barato.
|
||
- **Migration:** Sem migration.
|
||
|
||
## Dependências
|
||
|
||
- Nenhuma dura. Soft: B64 ✓. Compatível com **B96** (X no standalone). Destino encadeado futuro: **B98**.
|
||
|
||
## Não escopo
|
||
|
||
- Encadear tendência após votos → **B98**.
|
||
- Mudar tiles/nota UI.
|
||
- Autosave da lista (B24) — outro path.
|
||
|
||
## Rabbit holes
|
||
|
||
- **Optimistic UI da tendência no wizard.** **Mitigação:** fix de navegação só.
|
||
- **Remover o guard `trendStatus === currentStatus` por completo.** Pode reabrir deep-links lixo; mitigar com destino home ou mensagem, não loop.
|
||
|
||
## Adiado com gatilho
|
||
|
||
- **Pós-sucesso → próximo da cadeia.** **B98**.
|
||
|
||
## Referências
|
||
|
||
- `src/components/campaign/municipality/WizardTrendNoteStep.tsx`
|
||
- `src/app/(campaign)/campanha/(app)/acoes/[slug]/page.tsx` (branch change-trend)
|
||
- `src/app/(campaign)/campanha/(app)/municipios/municipalityStaffFormActions.ts`
|
||
- `src/components/campaign/shared/useCampaignFormSuccessToast.ts`
|
||
- [wizard-mudar-tendencia.md](wizard-mudar-tendencia.md)
|
||
- AGENTS.md — Feel the action / form actions
|
||
|
||
Qualidade de decisão: 5/5
|