teqo-backup/docs/plans/pinagem-superficies-lista.md
2026-07-25 13:15:30 -03:00

2.1 KiB

Pinagem das superfícies de lista (Pass 2 — W0)

Status: aprovado (Pass 2, 2026-07-25) Atualizado em: 2026-07-25 Item pai: IMPROVE-CODE-QUALITY-PLAN.md — Pass 2, W0 (GATE de W1) Appetite: ~1 dia; sem migration, sem UI

Contexto

W1 vai generalizar o sistema de listas e migrar todas as superfícies. A auditoria de safety net (2026-07-25) mostrou que só a lista de municípios está fortemente pinada (municipalityUi unit + municipalityPageData int). Os parsers de URL e loaders de apoiadores, planos, assessores, lideranças, organizações, dobradinhas e demandas estão fracos ou sem pin — refatorá-los sem pin é mudar comportamento sem rede.

Escopo (conjunto mínimo de pinagem)

Unit (parsers/href — contrato de URL byte-idêntico):

  • campaignListUrl.ts — canonicalização, param desconhecido ignorado, clamp de página, geração de href.
  • supporterUi.ts — parse de URL (intenção de voto, território, busca) + hrefs.
  • actionPlanUi.ts — default de tab, matriz tab→where, parse de filtros (kind/municipality).
  • Um spec compartilhado para os 5 parsers simples de lista (advisor / leadership / organization / stateDeputy / demand) — hoje cada página tem um parser local de first/page/q.

Int (5 smokes finos de loader — escopo, q vazia, shape da paginação):

  • advisorData.ts, leadershipData.ts, organizationData.ts, stateDeputyData.ts, campaignDemandData.ts.

Truth-up de documentação (mesma entrega):

  • TESTING.md: contagens reais (41 unit / 46 int / 7 e2e), item do backlog do artefato eleitoral (entregue no Pass 1 fase 2) marcado, novo mapa de pin das listas.
  • TECH-DEBT.md: "Praça" ~96 hits em 53 arquivos (não ~15); e2e 7 specs (não 5); resolver o conflito de status do C8 F4 (ledger diz "partially done", plano diz remainder aberto — o remainder É o W4d).

Regras

  • Bug achado durante a pinagem é ledgerado, nunca corrigido silenciosamente (o pin registra o comportamento atual).
  • Sem refactor nesta entrega — só testes + docs.

Impacto no roadmap

Nenhum item bloqueado; é o gate de W1 (que precisa terminar antes da janela 3, ~16/08).