mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-21 11:43:11 +00:00
6.3 KiB
6.3 KiB
Impl: Restaurar pin de visibilidade CSS das colunas de rede em Territórios
Status: aprovado Atualizado em: 2026-08-10 Issue: #616 Intenção: docs/plans/restaurar-pin-visibilidade-colunas-territorios.md Appetite restante: herdado (~0,25 dia eng)
Leitura da intenção
- Outcome: um spec de browser mínimo pina que, a 2200px, os columnheaders de rede (Assessor / Liderança / Dobradinha) e o restante do contrato (sortables) de
/campanha/territoriosestão visíveis — visibilidade CSS real via container queries (@min-[Nrem]/territory-list:table-cell) — e Cobertura permanece oculta; verde no job e2e existente. - O que NÃO negociar: nada de re-migrar a família; não duplicar asserções do
campaignTerritoriesHttp(presença no HTML + classes de rung continuam lá); zero mudança de CSS/UI; spec mínimo (só este comportamento). - O que reavaliar: a letra do manifesto
e2e-affectedda intenção ("rotaterritorios→ specs['campaignTerritoriesHttp', 'campaignTerritoriesColumns']") — o prefixo de rota não acorda o spec quando o arquivo das rungs muda (ver D2; as rungs vivem emsrc/components/campaign/municipality/TerritoryListColumns.tsx, hoje mapeado para specs de municípios).
Abordagem recomendada
flowchart LR
Spec[campaignTerritoriesColumns.e2e.spec.ts<br/>1 teste — corpo do antigo teste 3] --> Login[campaign.login<br/>viewport 2200x1000 antes do login]
Login --> Goto[goto /campanha/territorios]
Goto --> Sort[sortables visíveis<br/>Ordenar por 2022/Captura/2026/Classe/Assessoria]
Sort --> Net[rede visível<br/>Assessor/Liderança/Dobradinha exact]
Net --> Cobertura[Cobertura count 0]
Manifest[e2e-affected: territórios<br/>+campaignTerritoriesColumns<br/>+prefixo TerritoryListColumns] --> Spec
Opções consideradas: D1 (corpo do spec) A | B · D2 (manifesto) A | B Recomendação: corpo exato do antigo teste 3 (D1-A) + manifesto com o spec e o prefixo do arquivo das rungs (D2-B) — porque o corpo restaurado já foi aceito por produto (B175) e o prefixo extra é o que faz o pin acordar exatamente quando o CSS que ele protege muda. Rejeitadas: D1-B (versão enxuta só com as 3 colunas de rede) porque perde o pin de "Cobertura oculta" e dos sortables sem ganho de custo; D2-A (só a letra da intenção) porque deixa o spec mudo exatamente para a regressão que o motivou.
Componentes / mudanças
tests/e2e/campaignTerritoriesColumns.e2e.spec.ts(novo, projetocampaign— casa/campaign.*\.e2e\.spec\.ts/): um teste que restaura o corpo do teste 3 do spec deletado (campaignTerritories.e2e.spec.tsem1f31d1b6^), com o mesmo comentário B175 e a mesma ordem:page.setViewportSize({ width: 2200, height: 1000 })→campaign.login(page, email, password)→page.goto('/campanha/territorios')→ loop de sortables (getByRole('columnheader', { name: new RegExp(\^Ordenar por ${header}`) })visível para['2022', 'Captura', '2026', 'Classe', 'Assessoria']) → loop da rede (columnheaderexact['Assessor', 'Liderança', 'Dobradinha']visível) →columnheader'Cobertura'comtoHaveCount(0)`. Cabeçalho do arquivo documenta a divisão de trabalho com o spec HTTP (presença + rungs no HTML são do HTTP; visibilidade em viewport é browser) e por que ele existe (OPS35+).scripts/lib/e2e-affected-manifest.mjs(entrada territórios):specs: ['campaignTerritoriesHttp']→['campaignTerritoriesHttp', 'campaignTerritoriesColumns']eprefixesganhasrc/components/campaign/municipality/TerritoryListColumns(arquivo das rungs; startsWith prefixo-de-arquivo é válido no contrato do manifesto — mesmos checks unit dee2eAffectedManifest.unit.spec.tsseguem passando).- Migration: sem migration.
- Access / Consent: sem mudança.
- UI: Impeccable A — N/A (infra de testes; sem UI nova).
Fases verificáveis
- Spec + manifesto — criar o spec novo e a entrada do manifesto. Prova de não-vazio (muta): com
@min-[60rem]/territory-listdeadvisortemporariamente alterado para@min-[200rem], o spec deve falhar emAssessor; reverter. Depois rodar os pins unit afetados:pnpm test:unit tests/unit/e2eAffectedManifest.unit.spec.ts tests/unit/ciSkipInvariants.unit.spec.ts tests/unit/testAffected.unit.spec.ts. - E2e local —
pnpm test:e2e tests/e2e/campaignTerritoriesColumns.e2e.spec.ts(dev, worktree:teqo_wt35_test, porta 3135) verde; conferir que o job CI continua verde no PR (o spec novo entra nocampaignproject). - Gates —
pnpm gate:fast(lint + tsc + unit),pnpm format:check,pnpm exec knip,pnpm check:cycles; entrega viapnpm push.
Rabbit holes / Não escopo (engenharia)
- Re-migrar famílias ou tocar o
campaignTerritoriesHttp— fora de escopo; a equivalência HTTP continua como está. - Pinar rungs das outras listas (municípios, lideranças…) — rabbit hole de produto já catalogado na intenção; o pin de municípios já existe (
campaignMunicipalityResponsiveColumns). - Cobrir mudanças de
tailwind.config/globals.cssno manifesto — gap do OPS5 conhecido, não desta issue; uma regressão de container-query Tailwind que quebre a rung também quebra o pin viaTerritoryListColumns.tsxquando o arquivo mudar.
Riscos e mitigação
- Flake de viewport/container: o corpo é exatamente o que passou em CI por semanas antes do OPS35 (2200px com sidebar expandida deixa o container acima de 72rem). Sem estado novo, sem interação — risco baixo.
- Custo do job e2e: +1 teste browser (~5–10 s dev; <1 s prod) — o trade do OPS35 foi explícito: viewports continuam em browser.
- Prefixo novo no manifesto muda o alcance do
selectE2eSpecs: mudanças emTerritoryListColumns.tsxpassam a rodar os 2 specs de territórios além dos specs de municípios (o seletor faz união de entradas) — é o comportamento desejado (a regressão de CSS de territórios acorda o pin de territórios).
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (corpo do teste 3 restaurado; nada de CSS/HTTP tocado)
- Invariantes AGENTS/engineering-standards (spec novo mapeado no manifesto; unit pins verdes; sem twin de fixtures —
campaign.loginreusado) - Testes de domínio previstos: spec e2e novo + prova de não-vazio (mutação revertida) + pins unit do manifesto