teqo-backup/docs/plans/pinagem-superficies-lista.md
Francisco Ignácio Fontoura Solla e8a440b837 Pass 2 W5: close-out de documentacao
- AGENTS.md: Known Gap #2 resolvido (D3), arvore de estrutura (+AllocationDecision, PrivacyPolicy, CampaignGoals; components por dominio), URLs novas (/campanha/assessores|conceitos|perfil), entrada 'Recently resolved' do Pass 2
- tracker: todos os workstreams done; secao de achados de drift de docs de produto (PRODUCT/DESIGN/CUSTOMER - reportados, nao aplicados)
- TESTING.md: 46/48/7 + linhas do safety net (formActions wrapper, voteTrend, submitWhatsapp)
- TECH-DEBT: smells fechados (municipalityUi split, detail RSCs, formActions, components subpastas, electionInsights)
- planos: status entregue nos 5 do Pass 2; escala-dry-pos-b16 absorvido; C8 F3/F4 fechados em escala-dry-pos-c6; notas de costura em B17/B18/cenario-junto; nota de conflito E4R em mapa-projecao
- roadmap: entrada Pass 2 no 'Ja entregue', B17/B18 marcados como triviais, B16+ riscado, header atualizado
- notebook do projeto: entrada Pass 2
- DESIGN.md: secao do sistema de listas (unico drift aplicado, conforme plano)
2026-07-25 16:08:38 -03:00

2.1 KiB

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

Status: entregue (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).