Escala e DRY pós-E12 (camada TI)

Status: rascunho Atualizado em: 2026-07-26 Item do roadmap: docs/roadmap.md (Fill-ins abertos, E12+, fill-in de engenharia) Impeccable: A — N/A (higiene de loaders/utilities; sem superfície nova) Appetite: ~0,25–0,5 dia eng; duas fases opcionais, nenhuma com migration Responsável: —

Dados → decisão → apresentação

Vou apresentar dados? Não (N/A).

Contexto

E12 (camada-territorios-identidade.md, entregue 2026-07-26) estendeu E17/B21 com rollups MAUP, colunas Cobertura/Captura/Classe em /campanha/territorios e benchmark intra-TI no card Conta da cadeira. O /simplify da entrega (duas rodadas, 2026-07-26) aplicou o cleanup barato (medianOf, territorialClassSortWeight em lib/, constantes Metropolitano exportadas de territoryOverview.ts) e deixou achados maiores que cleanup, registrados aqui.

Já resolvido no simplify (não reabrir): medianOf compartilhado (src/lib/median.ts) e usado no classificador E10; pesos de sort de classe em src/lib/territorialClassSortWeight.ts; METROPOLITANO_REGION / SALVADOR_CITY / METROPOLITANO_SALVADOR_SUB_ROW_LABEL exportados de territoryOverview.ts e consumidos por loadTerritoryOverview e territoryIntraCaptureBenchmark.

Objetivos

Um módulo client-safe para regras de peers/sub-linhas do Metropolitano (quando valer o custo de extrair).
Evitar recomputar o mapa de captura por TI no detalhe do município se medição mostrar custo.

Decisões travadas

F1 só extrai quando o 3º consumidor dedicado aparecer ou a regra de peers crescer. Hoje são três imports de constantes + lógica espelhada em territoryIntraCaptureBenchmark — ainda cabe em territoryOverview.ts. Rejeitado: lib/metropolitanoTerritoryPeers.ts prematuro com uma função por arquivo (YAGNI).
F2 memo de peer-group só com evidência. O benchmark T4 roda uma vez por request de detalhe; cache de processo só se profiling mostrar duplicação dentro da mesma árvore RSC.

Abordagem proposta

F1 — metropolitanoTerritoryPeers (condicional). Extrair helpers puros (isSalvadorSubRow, peerSlugsForMunicipality, labels) quando um quarto call site surgir (ex. mapa TI ou agrupamento na lista de municípios) ou quando testes de peers precisarem de fixture isolada.
F2 — memo opcional. cache() ou mapa por request em territoryIntraCaptureBenchmark apenas se o loader do detalhe passar a chamar o benchmark mais de uma vez.

Não escopo

Bundle E8 só central em /campanha/territorios — adiado até cenário na URL ou perf medido no loader (loadMunicipalityGoalCoverageBundle hoje carrega os três cenários).
Célula compartilhada de classe territorial entre lista de municípios e lista de TIs — cosmético (2 surfaces); extrair só com 3º call site.
UI de sanityCheckSuggestedGoalsByTerritory — continua fora do E12 v1 (plano-pai).

Explicitamente fora (triage close-delivery 2026-07-26)

Achado	Destino	Gatilho / racional
Módulo Metropolitano peers	defer → F1	4º call site ou regra de peers mais complexa
E8 bundle escopado a `central`	defer	`?scenario=` na lista de TIs ou perf
Célula classe compartilhada	descartar	score 2; 2 surfaces
Memo peer-group T4	defer → F2	profiling no detalhe

3.6 KiB Raw Blame History Unescape Escape