teqo-backup/docs/plans/escala-dry-pos-acoes-rapidas.md
2026-08-03 21:03:13 -03:00

75 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Escala/DRY pós-B86 — normalização de pathname de lista nas ações rápidas
Status: rascunho
Atualizado em: 2026-08-03
Issue: —
Prioridade: P2
Item do roadmap: débito do lote B80–B90 (colhido no `/simplify` de B86, triage aprovada)
Model: composer-2.5
Impeccable: A — refactor só-backend (client-safe), sem mudança de comportamento
Appetite: ~0,25–0,5 dia eng; sem migration
## Problema
O conhecimento de "normalizar pathname de lista (match exato + trailing slash)" está
duplicado em **6+ módulos** da família de ações rápidas:
- `isAdvisorsListPath` (`src/lib/campaignAdvisorQuickActions.ts`)
- `isDemandsListPath` (`src/lib/campaignQuickActionDemands.ts`)
- `isStateDeputyListPath` (`src/lib/campaignQuickActionDobradinhas.ts`)
- `isConceptsPath` / `isProfilePath` (`src/lib/campaignReferenceQuickActions.ts`)
- `isLeadershipListPath` (`src/lib/campaignQuickActionLeadership.ts`)
- `isSupportersListPath` (`src/lib/supporterQuickActions.ts` — B86)
E `src/lib/campaignQuickActionPaths.ts` já existe como home da família de path helpers
client-safe, com um `normalizePathname` **privado** fazendo exatamente o mesmo trabalho
(só usado pelos parsers de superfície activity/organization).
## Escopo
- Extrair helper compartilhado (ex. `isListPath(pathname, home)` e/ou
`normalizePathname` exportado) em `src/lib/campaignQuickActionPaths.ts`.
- Migrar os 6+ call sites acima para o helper; manter exports públicos de cada módulo
(`isXListPath`) para não quebrar specs/registry — os wrappers delegam.
- Se natural, derivar as regex de detalhe numérico da constante de home
(`escapeRegExp`) — só se o diff ficar limpo; caso contrário, registrar como fase 2
com gatilho (3º vertical com `[id]` numérico — hoje são 2: advisor + supporter).
- **Não** mexer nos parsers de superfície activity/organization além de reusar o
`normalizePathname` exportado (mesma lógica, menos duplicação).
## Já resolvido no simplify (não reabrir)
- Pins de teste do B86 (trailing-slash no registry, `/abc` → `[]`, mount staff em
`/apoiadores` e não-leader) — aplicados na sessão B86.
## Explicitamente fora (deste lote)
- **S2** naming polarity `import-supporters` × `SUPPORTER_IMPORT_HREF` — descartado
(batch plural intencional; score 2).
- **S3** regex aceita `042` — descartado (espelha `parseAdvisorDetailId`; consistência).
- **S4** caso advisor direto no spec do módulo — descartado (coberto via registry).
- **S5** quirks de regex (nested tail, dígitos ilimitados, id≤0) — descartados
(espelham siblings).
- **S6** extrair regex numérica em 2 sites — **defer com gatilho**: 3º vertical com
`[id]` numérico.
- **S7** cache `Map<CampaignRole>` em 3 sites — **defer com gatilho**: 4º site com
shape compatível (advisor/supporter/home divergem em gate e construção).
- **S8** id `register-supporter` sobrecarregado (leader × staff) — **defer com
gatilho**: se algo agregar catálogos ou assert de unicidade global de id.
## Fases verificáveis
1. Helper compartilhado em `campaignQuickActionPaths.ts` + migração dos 6+ call sites.
2. `pnpm gate:fast` (unit cobre todos os módulos tocados) + `pnpm push`.
## Rabbit holes
- Renomear `isXListPath` nos specs — os wrappers mantêm o contrato, specs intactos.
- Tocar comportamento (ex. normalizar pathname em vez de comparar os dois spelling) —
refactor é puramente estrutural; comportamento idêntico.
## Riscos e mitigação
- 6+ call sites = risco de diff ruidoso — wrappers delegando mantêm o diff mínimo.
- Algum matcher depende da ordem exata dos `===` — unit specs existentes pinam cada
módulo; rodar `test:unit` completo no gate.