teqo-backup/docs/plans/municipio-v2-agora-impl.md
Cursor Agent 6955cccc6b
B150 — Município v2 bloco Agora (encaminhamento + sugestão + visita)
- Loader e seção Agora na rota /campanha/municipio/[slug]/v2
- Encaminhamento editável com auto-save via POST /municipios/next-steps
- Até 2 sugestões E11 com resolve/dispensa existente; silêncio explícito
- Visita E13 condensada em uma linha + link ao compositor de giros
- Revalidação v2 ao resolver sugestão; helper compartilhado de empty state E11

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-08-03 00:28:47 +00:00

67 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Impl: Município v2 — Agora (encaminhamento + sugestão + visita)
Status: aprovado
Atualizado em: 2026-08-03
Issue: #333
Intenção: docs/plans/municipio-v2-agora.md
Appetite restante: herdado (~0,5–1 dia eng)
## Leitura da intenção
- **Outcome:** Bloco “Agora” na rota v2 com encaminhamento editável no lugar, até duas sugestões acionáveis (ou silêncio explícito) e visita condensada em uma linha.
- **O que NÃO negociar:** um só motor E11; resolve/dispensa existente; `nextSteps` como fonte única; sem checklist E13 expandida; staff only (`noLeader`); silêncio explícito.
- **O que reavaliar:** hipótese de componente monolítico — separar loader server, controle client de `nextSteps` e seção RSC; JSON route (precedente political-trend) vs form action (precedente AdvisorDebouncedTextCell).
## Abordagem recomendada
```mermaid
flowchart TB
page[v2/page.tsx] --> loader[loadMunicipalityV2AgoraData]
loader --> VM[strategy.nextSteps + E11 slice 0-2 + E13 summary]
page --> section[MunicipalityV2AgoraSection RSC]
section --> next[MunicipalityV2NextStepsControl]
section --> cards[SuggestionCard × 0-2]
section --> visit[formatVisitEligibilitySummary + link giros]
next -->|POST /municipios/next-steps| action[updateMunicipalityStrategy partial]
cards -->|resolveSuggestionFormAction| E11[resolveSuggestion]
```
**Opções consideradas:** A) reutilizar `SuggestionsPanel` inteiro | B) compor loader + peças novas enxutas | C) novo motor de sugestão v2
**Recomendação:** B — mesmos loaders/ações; UI condensada sem statute/card E13.
**Rejeitadas:** A (torre de chrome do dashboard); C (twin motor).
### Componentes / mudanças
- **`formatVisitEligibilitySummary`** (`src/utilities/visit/visitEligibility.ts`): headline + frase curta; teste unitário.
- **`loadMunicipalityV2AgoraData`** (`src/utilities/municipality/municipalityV2AgoraData.ts`): `Promise.all` detail VM + suggestions + visit.
- **`MunicipalityV2NextStepsControl`** + **`/municipios/next-steps/route.ts`**: autosave debounced (precedente political-trend JSON).
- **`MunicipalityV2AgoraSection`**: RSC que monta os três sub-blocos.
- **`resolveSuggestion`**: `revalidateMunicipalityListPaths` inclui v2.
- **Migration:** sem migration.
### Dados → forma
- Encaminhamento: textarea auto-save (edit where you see).
- Sugestões: 0–2 `SuggestionCard` compactos; silêncio copiado do OverviewTab.
- Visita: uma linha “Elegível|Não elegível · motivo” + link compositor.
## Fases verificáveis
1. **Schema/server** — summary helper, loader, next-steps route, revalidation fix.
2. **UI** — section + control + wire v2 page.
3. **Gates** — `pnpm gate:fast`; push via `pnpm push`.
## Rabbit holes / Não escopo (engenharia)
- FAB B151; Conta/Rede B148–B149; compositor completo.
## Riscos e mitigação
- Partial strategy update sobrescrever outros campos → action só envia `nextSteps`.
- Sugestão stale na v2 → revalidate v2 no resolve.
## Aceite de engenharia
- [x] Aceite de produto da intenção ainda coberto
- [x] Invariantes AGENTS/engineering-standards
- [x] Testes de domínio previstos (unit summary visit)