fsolla/teqo-backup
1
0
Fork 0
mirror of https://github.com/fsolla/teqo.git synced 2026-11-14 17:43:04 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
teqo-backup/docs/plans/municipio-v2-agora-impl.md
Cursor Agent 0638efb2fb
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

  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.
  • 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)