11 KiB
Post-mortem: fixture B196 com data fixa vencida bloqueia o verify do deploy
Template do
/bug-fix. Preencha com fatos apurados; o que não for apurado fica "não apurado" — nunca invente.
Registro
| Campo | Valor |
|---|---|
| Data do post-mortem | 2026-09-12 |
| Severidade | alta (bloqueou o deploy; nenhum dado/PII afetado; produção seguiu no build anterior) |
| Ambiente | CI |
| Issue(s) | sem Issue (fluxo /bug-fix; relacionada: #882, flake B176 — não é este bug) |
| PR do fix | #943 |
| Detectado por | teste (E2E do job verify do deploy.yml) |
Timeline
| Momento | Data/hora | Evento |
|---|---|---|
| Início provável | 2026-08-11 | commit 02abd7de (B196) cria a fixture com startAt: '2026-09-01T13:00:00.000Z' hardcoded; o PR CI de agosto era verde porque 01/09 ainda era futuro — a data venceu em 02/09/2026 |
| Detecção | 2026-09-11 22:04–22:24 UTC | run 34652323456 do deploy.yml (job verify, main 3aad110e): o E2E tests/e2e/campaignMunicipalities.e2e.spec.ts:1492 falha nas 3 tentativas (11.8s / 19.4s / 18.4s) em :1529 (Expected: > 0, Received: 0) e o job deploy homeserver (teqo-1313) fica skipped — o main não vai para produção nesse dispatch |
| Correção mergeada | 2026-09-12 | commit e846c916 no PR #943 — CI verde (run 34673571340); merge pelo auto-merge nativo após este documento |
| Deploy | pendente | dispatch manual do deploy.yml pelo humano após o merge |
| Verificado em prod | pendente | confirmação do humano após o deploy |
O bug
O deploy manual de 2026-09-11 não chegou a produção: o job verify do deploy.yml falhou no E2E e o job deploy homeserver (teqo-1313) foi skipped — o código de main (3aad110e) não foi para produção nesse dispatch. A falha foi o teste [campaign] tests/e2e/campaignMunicipalities.e2e.spec.ts:1492 "chassis elsewhere: the actions row keeps its breathing room and the bar glues on scroll (atividades)", que falhou nas 3 tentativas (11.8s / 19.4s / 18.4s) em :1529 com expect(received).toBeGreaterThan(expected), Expected: > 0, Received: 0 ("Timeout 10000ms exceeded while waiting on the predicate"). No cenário do teste, /campanha/atividades renderizava "Nenhuma atividade encontrada", o scrollport não tinha overflow e a asserção nunca passava. Dos demais testes E2E, 198 passaram e 6 ficaram flaky (campaignActivity:131, campaignLeaderships:59, campaignMunicipalities:650, campaignPeople:27, campaignPeople:53, campaignSollinhaContext:115), todos aprovados no retry — classe de latência sob 4 workers, sem relação com este bug. Sintoma — não a causa.
Causa-raiz
A fixture do teste B196 (commit 02abd7de, 2026-08-11) criava 5 atividades com startAt: '2026-09-01T13:00:00.000Z' hardcoded. A aba default proximos filtra status = confirmado e startAt >= now (src/utilities/activityUi.ts:408-409 e o where em :442-444), com now = new Date() injetado pela página (src/app/(campaign)/campanha/(app)/atividades/page.tsx:57,65). A partir de 02/09/2026 os fixtures ficaram no passado → result.docs = [] → empty state → scrollport sem overflow → a asserção scrollHeight - clientHeight > 0 recebia 0. O deploy de 27/08 (run 33074305879) passou porque 01/09 ainda era futuro, e o PR CI de agosto também era verde no instante da autoria.
5-whys:
- Por que o teste falhou? A lista de atividades veio vazia e o scrollport não rolava — a data fixa da fixture venceu.
- Por que a data venceu? A fixture tratava o relógio como dado estático:
2026-09-01hardcoded, sem derivar denow. - Por que o verde do PR não pegou? O resultado refletia o instante da execução (agosto), não uma invariante temporal — o teste só passava enquanto a data estivesse no futuro.
- Por que não havia proteção? Não existia helper/convenção de "start futuro" no fixture layer E2E nem gate de lint contra ISO literal em fixtures.
- Por que a classe inteira não estava coberta? Faltava um contrato de fixture invariante no tempo — o padrão relativo a
nowjá existia em specs de agenda (tests/e2e/campaignActivity.e2e.spec.ts:136-137), mas não era exigido.
Evidência: RED reproduzido localmente em 2026-09-12 (mesma linha :1529, Received: 0) e também pelo verificador independente via stash; GREEN com o fix (3 passed = 2 setups + alvo).
Correção
- Commit
e846c916(PR #943), emtests/e2e/campaignMunicipalities.e2e.spec.ts: ostartAtda fixture B196 passa a derivar de hoje +7 dias no tempo civil da Bahia (civilDatePlusDays(formatBahiaCivilDate(new Date()), 7)+parseBahiaDateTimeInput, mesmo padrão detests/e2e/campaignActivity.e2e.spec.ts:136-137). - O poll do scrollport ganha
{ timeout: 30_000 }— orçamento da classe de latência B196 já documentada no arquivo sob 4 workers. - Prevenção barata: regra
no-restricted-syntaxemeslint.config.mjs(escopotests/e2e/**/*.{ts,tsx}, selector em propriedadesstart*/end*/date*com literal/20\d\d-\d\d-\d\dT/) e teste emtests/unit/eslintConventions.unit.spec.ts(RED sem a regra / GREEN com; 13 testes).
Resolve a causa: a fixture deixa de depender de uma data absoluta e o guard pega a classe inteira na autoria. Sem migration, sem mudança de access.
Verificação
- Teste de regressão:
tests/e2e/campaignMunicipalities.e2e.spec.ts:1492"chassis elsewhere… (atividades)" — falha sem o fix (RED local em 2026-09-12, mesma linha:1529,Received: 0; reproduzido também pelo verificador independente via stash) e passa com o fix (GREEN 3 passed = 2 setups + alvo) - Suíte:
pnpm gate:fastverde (lint + typecheck + 2687 unit);pnpm lintcompleto verde (zero falso positivo da regra nova); spec completocampaignMunicipalities.e2e.spec.ts27 passed / 2 failed — B176 (flake conhecido, Issue #882) e B200 (falha determinística só em dev local,87 > 48, reproduzida também no estado pré-fix e aprovada no verify real de 2026-09-11 em prod-mode) - CI: verde no PR #943 (run 34673571340, job
checks) - Prod: pendente — deploy manual pendente de dispatch do humano após o merge; confirmação do humano pendente
Prevenção
| Estratégia | Custo | Estado |
|---|---|---|
Fixture B196 deriva startAt de hoje +7 dias no tempo civil da Bahia + poll do scrollport com 30s |
barata | implementada agora (commit e846c916, PR #943) |
Regra ESLint no-restricted-syntax banindo ISO literal em propriedades start*/end*/date* de tests/e2e + teste unit RED/GREEN |
barata | implementada agora (commit e846c916, PR #943) |
Injeção de relógio no fixture layer E2E (Playwright clock ou now do server) para fixtures determinísticas no tempo |
cara | documentada — não implementada neste fluxo |
Canário periódico da aba default proximos |
cara | documentada — não implementada neste fluxo |
Regra ampla "zero ISO literal em tests/e2e" com allowlist por arquivo |
cara | documentada — não implementada neste fluxo; candidata a Issue futura |
Estratégia implementada: fixture deriva o startAt de now (fim da data absoluta), poll do scrollport com o orçamento de 30s da classe de latência B196 e guard ESLint escopado a tests/e2e que bane ISO literal em campos de data, pinado por teste unit RED/GREEN — a classe inteira passa a ser barrada na autoria, não no calendário.
Estratégia documentada (cara): injeção de relógio no fixture layer E2E (Playwright clock ou now do server) para fixtures determinísticas no tempo; canário periódico da aba default proximos; regra ampla "zero ISO literal em tests/e2e" com allowlist por arquivo. Candidatas a Issue futura — não implementadas neste fluxo.
Lições
- "Verde no instante" ≠ invariante no tempo: o PR de agosto e o deploy de 27/08 passaram; ambos só provavam que a data ainda era futura naquele dia. Teste com data absoluta tem prazo de validade embutido.
- Fixture relativa ao relógio precisa derivar de
now: o padrão já existia nos specs de agenda — a fixture B196 ficou para trás. O conserto não foi "atualizar a data", foi remover a data absoluta. - Guard de autoria barato pega a classe inteira: a regra ESLint escopada a
tests/e2ebane ISO literal em campos de data no momento de escrever o teste, sem esperar o calendário virar.