docs: defer loader dedup note in B150 impl plan

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>

2026-08-03 00:28:47 +00:00

3.3 KiB

Raw Blame History

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

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

Schema/server — summary helper, loader, next-steps route, revalidation fix.
UI — section + control + wire v2 page.
Gates — pnpm gate:fast; push via pnpm push.

Rabbit holes / Não escopo (engenharia)

FAB B151; Conta/Rede B148–B149; compositor completo.
Defer: unificar resolveAccessibleMunicipalityContext entre loadMunicipalityV2StatusData e loadMunicipalityV2AgoraData quando B148–B149 compuserem um loader de página único.

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

Aceite de produto da intenção ainda coberto
Invariantes AGENTS/engineering-standards
Testes de domínio previstos (unit summary visit)

3.3 KiB Raw Blame History Unescape Escape