3.8 KiB
Impl: Prewarm e2e: adicionar /campanha/home-search (POST) e /campanha/acoes/mudar-tendencia (GET) ao setup spec
Status: aprovado Atualizado em: 2026-08-11 Issue: #645 Intenção: docs/plans/prewarm-rotas-home-search-mudar-tendencia.md Appetite restante: ~1 hora eng (herdado)
Leitura da intenção
- Outcome: o
setup.e2e.spec.tspreaquece as duas rotas que ficaram de fora, para o 1º hit em dev não compilar no meio de um journey (B48/B97 flakearam 2/2 sob load ≥40 na sessão OPS36). - O que NÃO negociar: setup continua em dev-mode-only, sem mudança de
asserções ou de CI; POST sem auth com
.catch(() => undefined)— padrão das entradas existentes. - O que reavaliar: nada material — as rotas existem e o padrão do setup é uniforme.
Abordagem recomendada
flowchart LR
A[setup.e2e.spec.ts] --> B[GET /campanha/acoes/mudar-tendencia]
A --> C[POST /campanha/home-search]
Opções consideradas: A — duas linhas nas listas existentes | B — subir um
webServer waitOn prewarm
Recomendação: A — o setup spec já é o dono do prewarm dev; a intenção diz
"seguindo o padrão das entradas existentes". Custo ~2 linhas, zero risco.
Rejeitadas: B — duplica o mecanismo, fora do appetite.
Componentes / mudanças
tests/e2e/setup.e2e.spec.ts: na lista de GETs, adicionar/campanha/acoes/mudar-tendenciaao lado de/campanha/acoes/atualizar-votos(mesma família de wizard; GET anônimo → 307 para/campanha/login, seguido pelo client →response.ok()true — mesmo contrato das entradas vizinhas). Na lista de POSTs, adicionar/campanha/home-search(route handler emsrc/app/(campaign)/campanha/(app)/home-search/route.ts; POST anônimo falha,.catch(() => undefined)absorve — compila o handler, que é o objetivo).- Migration: sem migration.
- Access / Consent: sem mudança — as rotas não são tocadas.
Fases verificáveis
- Setup spec — 2 linhas; gate rápido local.
- Gates —
pnpm gate:fast(ou lint/tsc); e2e direcionado: rodar o projetosetup+ B48 (campaignMunicipalitieshome-search) e B97 (campaignHomeActionsmudar-tendencia) em dev a load ≥40, primeiro hit verde.
Rabbit holes / Não escopo (engenharia)
- Hardening geral do prewarm em dev é dono da OPS30 (#586) — não reabrir aqui.
- Flakes de render sob carga em geral (B24, B176, demand) — fora.
Riscos e mitigação
- GET
mudar-tendenciasem auth poderia não compilar o bundle da página se o redirect pular o render: mitigação — o GET segue o redirect (login), mas o compile da rota[slug]acontece no primeiro match de rota, independente do redirect; mesma família queatualizar-votosjá prewarms com sucesso. - Medição sob load ≥40 é cara: mitigação — verificação local direcionada (workers ≥2, setup primeiro), sem CI novo.
Desvio da intenção (aprovado 2026-08-11)
A intenção dizia "sem mudança de asserções ou de CI", mas o gate:ci falhou com
"No tests found" — falha pré-existente do classificador (OPS39 é a primeira
PR setup-only): o setup só existe em dev mode (projeto dropado sob CI=1,
playwright.config.ts OPS34), e selectE2eSpecs o selecionava sozinho para o
e2e prod-mode. Fix no dono (scripts/lib/test-affected-core.mjs): seleção
contendo apenas setup → mode: 'none' (spec dev-only; sets mistos seguem
inalterados — o spec simplesmente não casa projeto). 2 testes de unidade novos
em tests/unit/testAffected.unit.spec.ts.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto
- Invariantes AGENTS/engineering-standards (nenhum código runtime tocado)
- Testes de domínio previstos (unit/int): 2 unit novos no classificador
(
testAffected.unit.spec.ts); runtime intocado