O cleanup do campaignE2EFixtures estava completo em runs normais (proxy auto-own cobre contact/stateDeputy); o lixo vinha de runs crashados, cujo cleanup nunca roda. O claim e2e agora purga resíduo como o int já fazia, e a purga ganhou a classe dobradinha (stateDeputy vinculados via municipality.stateDeputies + fichas órfãs com ref-check incluindo stateDeputy — FK ON DELETE RESTRICT). peopleList.int.spec.ts passa a varrer todas as páginas (lista global de 25/pág) com dedupe; personDelete/peopleList usam personName() nos nomes fixos, imunes ao invariante global de nome de dobradinha.
7.9 KiB
7.9 KiB
Impl: e2e — campaignE2EFixtures deixa lixo no banco de teste (contamina int specs sob resíduo)
Status: aprovado
Atualizado em: 2026-08-13
Issue: #723
Intenção: body da Issue (sem Plano: linkado — o body é a spec)
Appetite restante: herdado (chore P2 — cleanup + robustez de specs)
Leitura da intenção
- Outcome: runs e2e (E2E_PROD) não podem deixar lixo que quebre int specs
pré-existentes; o cleanup do
campaignE2EFixturesdeve ser investigado e, se necessário, os nomes fixos dos int specs viram únicos por run. - O que NÃO negociar: nenhum produto aqui — infra de teste. Invariantes a
manter: nunca tocar prod, allocator de município (sequência Postgres) como
contrato de exclusividade, regra de referência LGPD para deletar ficha
órfã (mesma do
removeSupporterData/ D10 F1), nomes de spec continuam schema-válidos (letters+spaces/hyphens —personNameexiste para isso). - O que reavaliar: a hipótese do body "owned de stateDeputy/contact via
fixtures.payload.create?" — investigada e falsa: contact/stateDeputy
criados pelo proxy SÃO auto-owned e descobertos pelo runID no cleanup
normal. O vazamento real é de runs crashados (cleanup nunca roda), a
mesma classe que os fixtures int já defendem com
purgeMunicipalityResidueno claim — que oclaimMunicipalitye2e não faz.
Diagnóstico (investigação da Issue)
- Cleanup e2e em run normal está completo — proxy auto-own de
stateDeputy/contact(isOwnedCollection+discoverOwnedRowspor runID em name/email + derivação de stateDeputy viacontact in). Resíduo observado ('Ciclo Liderança-', 'Coordenadora C128-', 'deputado-') só nasce quando o run morre antes dofinallydo fixture (timeout/worker morto). - Classes de resíduo e2e (verificado nas specs): dobradinhas + fichas
vinculadas a município claimado (
campaignPeople183–237, 457–559 —municipality.stateDeputies), contas staff + fichas ('Coordenadora C128'), e lideranças/supporters/etc. (já purgáveis por município). - Mecanismo do
peopleList.int.spec.ts: a lista de pessoas é GLOBAL e paginada (25/página, ordenada por nome); o advisor nasce como 'Usuário advisor-' (ordena tarde). Com ≥25 linhas residuais, a ficha do advisor cai da página 1 → "advisorRow não achado" (maria/ana, que ordenam cedo, seguem visíveis — exatamente o sintoma descrito). - Mecanismo do
personDelete.int.spec.ts: nome fixo 'Maria de Jesus' + invariante global de nome de dobradinha (assertStateDeputyNameAvailable,src/utilities/stateDeputy/nameInvariant.ts) — dobradinha residual com o mesmo nome bloqueia o create do spec.
Abordagem recomendada
flowchart LR
A[claimMunicipality e2e] --> B[purgeMunicipalityResidue<br/>+ classe dobradinha]
C[peopleList.int] --> D[presença via todas as páginas]
E[personDelete + peopleList] --> F[personName p/ nomes fixos]
B --> G[resíduo e2e não acumula<br/>nem para int nem para e2e]
Opções consideradas:
- A — purge no claim (espelhar int) + estender
purgeMunicipalityResiduepara a classe dobradinha + robustez dos 2 int specs. O resíduo e2e desaparece no próximo claim (contrato do allocator garante dono único), os int specs deixam de depender de estado global. - B — só nomes únicos nos int specs. Não resolve o peopleList (a poluição de página não é por nome, é por volume) nem a acumulação do resíduo e2e.
- C — sweep global por padrão de nome no setup e2e. Fragil e perigoso:
contas staff usam emails
@example.comcomo os runs vivos — mataria runs paralelos.
Recomendação: A — porque ataca a fonte (resíduo some no claim,
mesmo precedente do getMunicipality int), e a robustez dos specs fecha o
resto (resíduo não-purgeável: contas staff de run crashado — ~1–2 linhas por
crash, sem âncora de município e sem padrão seguro). A classe dobradinha é
purgeável porque SEMPRE está vinculada ao município claimado pelo próprio run.
Rejeitadas: B sozinha (não cobre peopleList nem a acumulação); C (perigosa — padrões coincidem com runs vivos).
Componentes / mudanças
purgeMunicipalityResidue(tests/helpers/campaignFixtures.ts): estende a purga para a classe dobradinha — lêmunicipality.stateDeputiesdo município claimado, deleta osstateDeputyresiduais, deleta as fichas órfãs (mesma checagem de referências do D10 F1: leadership/signature/ subscription/supporter +campaignUser.contact— resíduo C99) e limpa o campostateDeputies: []. Seguro pelo contrato do allocator: nenhum run vivo opera o município claimado (guardtestMunicipalityAllocatorConventions).CampaignE2EOwnership.claimMunicipality(tests/e2e/fixtures/campaignE2EFixtures.ts): chamapurgeMunicipalityResidue(this.rootPayload, municipality.id)após o find — espelhagetMunicipalityint (mesma sequência, mesmo contrato).peopleList.int.spec.ts: helper localloadAllPeopleRows(páginas 1..totalPages) para as asserções de presença; facets seguem globais na página 1 (já são calculadas sobre o conjunto scoped, pré-paginação).personDelete.int.spec.ts/peopleList.int.spec.ts: nomes fixos →fixtures.personName(prefix)(schema-válido, único por run), vinculando o nome nas asserções que o usam (manifest?.contact.name,toMatchObject).- Migration: sem migration (teste/helpers apenas).
- Access / Consent: nenhum — fixture/helpers de teste; a checagem de órfã usa o mesmo critério do fluxo de produção (fail-closed).
- UI: não há.
Dados → forma
N/A (sem UI).
Fases verificáveis
- Purga + claim e2e — estender
purgeMunicipalityResidue; ligar noclaimMunicipalitye2e;pnpm test:int -- campaignFixtures(a spec de invariante de contagem usa DB próprio) + gate unit (testMunicipalityAllocatorConventions). - Int specs robustos —
loadAllPeopleRowsem peopleList;personNameem personDelete + peopleList;pnpm test:int(arquivos-alvo). - Gates —
pnpm gate:fast; e2e docampaignPeopleem dev para provar o purge no claim;pnpm push(débitos via capture-review-debts autônomo).
Rabbit holes / Não escopo (engenharia)
- Sweep de contas staff residuais (sem âncora; padrão coincide com runs vivos) — registrado como débito, não corrigido aqui.
- Migrar os outros specs com nomes fixos de liderança ('Maria da Silva' etc. em campaignInvite/campaignLeadership) — liderança não tem invariante de nome; o resíduo não as quebra (fora de escopo).
campaignFixturesRowCountsusa DB dedicado — não afetado.- Ambiente da máquina (registrado como débito): a coleção e2e local
quebra no load de
src/utilities/documents.ts(Cannot find module 'next/cache'— ESM nativo não resolve subpath sem exports;next/cache.jsexiste,next/cachenão). Reproduz no main repo e sob Node 20/24.14/24.18 — pré-existente ao OPS45, fora de escopo; a verificação e2e fica para o CI do PR.
Riscos e mitigação
- Purga deletar linha de run vivo: mitigado pelo contrato do allocator (nenhum claim por slug fixo — guard unit existente) + checagem de referências antes de deletar ficha órfã.
- peopleList mais lento (paginação): 25 linhas/página, poucos reads — custo desprezível; semanticamente idêntico (presença global).
purgeMunicipalityResiduecompartilhada int+e2e: o e2e passa a pagar a mesma purga que o int já paga; sem mudança de comportamento para o int além da nova classe dobradinha (resíduo, por definição não referenciado).
Aceite de engenharia
- Aceite de produto da intenção coberto (cleanup investigado + nomes fixos únicos + resíduo não acumula)
- Invariantes AGENTS/engineering-standards (allocator, D10 F1, personName)
- Testes previstos: unit do allocator (já existente), int dos dois specs, e2e campaignPeople