HeuJung
0f0ef8fa8d
레이아웃 편집기 spec 중 저장(PUT)까지 수행하는 것들이 제품 화면에 편집 결과를 영속시켜, 실행할 때마다 개발 사이트에 노드가 누적됐다(home 에 빈 표 7개, 관리자 대시보드에 빈 차트 5개). spec 안에 "추가한 노드 삭제 후 재저장" 원복을 넣어도 소용이 없었다 — 원복 후에도 레이아웃이 오염 시점과 정확히 같은 크기로 되돌아왔다. 원복에 기대는 대신 저장 대상 자체를 E2E 전용 시드 화면으로 분리한다. 시드 화면은 활성 템플릿 디렉토리에만 설치되므로 배포 원본과 릴리스 산출물은 변하지 않는다. globalSetup 이 매 실행 fixture 원본으로 덮어써 회차 간 누적이 성립하지 않으므로 저장 spec 에 원복 절차가 필요 없다. 설치는 레이아웃 파일과 라우트, DB 행 세 가지를 함께 다루되 시드 행만 건드린다 — 전체 재동기화를 쓰면 편집기로 저장한(파일에 없는) 변경이 실행할 때마다 사라지기 때문이다. 전수 실행에서 드러난 기존 실패도 함께 처리했다. 35건 중 27건은 절전·부하 아티팩트였고 나머지는 원인을 확정해 고쳤다. 템플릿 식별자 자리에 모듈 id 를 넣어 라우트 트리가 비어 있었고, "캔버스 텍스트가 길어진다"는 대리 지표가 렌더 여부와 무관했으며(정상 렌더에도 짧아진다), 팔레트 삽입 위치가 잠금 서브트리 안이면 선택이 조상으로 밀려 노드를 지목할 수 없었고, 상태 개수 단언이 상태 추가로 낡았고, if 게이트상 그 탭에 등록되지 않는 소스를 refetch 하고 있었고, 무통신 구간이 오지 않는 관리자 화면에 networkidle 을 기다렸고, 테스트 종료 후 도착한 route 콜백이 워커를 중단시켰고, 같은 설정 화면에 저장하는 테스트들이 병렬로 충돌했다. 측정 방법에서 반복해 틀린 지점들은 E2E 가이드에 표로 남겼다 — 가림은 가시성 판정으로 잡히지 않고, 길이 증감은 렌더 신호가 아니며, 총 개수 단언은 스펙이 늘면 깨지고, networkidle 은 실시간 연결이 있는 화면에서 오지 않는다.
92 lines
4.0 KiB
TypeScript
92 lines
4.0 KiB
TypeScript
/**
|
|
* 레이아웃 편집기 E2E 전용 시드 화면 — 상수 + provisioning 헬퍼.
|
|
*
|
|
* 편집기 spec 중 **저장(PUT)까지 수행하는** 것들은 편집 결과가 그대로 영속된다. 그 대상이
|
|
* 제품 화면(`home` / `admin_dashboard`)이면 실행할 때마다 빈 표·차트가 누적돼 개발 사이트가
|
|
* 오염된다(실측: `home` 20,321 → 33,696 bytes, 빈 표 7개). spec 안에 "추가한 노드 삭제 후
|
|
* 재저장" 원복을 넣어도 편집기가 캐시한 문서를 다시 밀어 넣어 오염 시점 크기로 되돌아왔다.
|
|
*
|
|
* 그래서 저장 spec 은 제품 화면 대신 전용 시드 화면(`e2e_sandbox`)을 대상으로 한다. 설치/제거는
|
|
* `php artisan playwright:seed-layout` 에 위임하며, globalSetup/globalTeardown 이 호출한다.
|
|
*
|
|
* 시드 화면은 **활성 템플릿 디렉토리에만** 설치된다 — `_bundled`(배포 원본)은 변경되지 않고,
|
|
* 활성 디렉토리는 Git 무시 대상이라 릴리스 산출물에도 포함되지 않는다.
|
|
*
|
|
* 저장하지 않는(읽기 전용) spec 은 계속 제품 화면을 대상으로 둔다 — 오염 위험이 없고,
|
|
* 실제 제품 레이아웃에 대한 검증이 유지되는 편이 낫다.
|
|
*/
|
|
import { execFileSync } from 'node:child_process';
|
|
import { dirname, resolve } from 'node:path';
|
|
import { fileURLToPath } from 'node:url';
|
|
|
|
// ESM 환경(package.json "type": "module")에서는 __dirname 이 정의되지 않으므로
|
|
// import.meta.url 로 재구성한다.
|
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
|
|
/**
|
|
* 시드 화면의 라우트 경로 (URL 인코딩 전 원문).
|
|
*
|
|
* `PlaywrightSeedLayout::DEFAULT_TARGETS` 와 동일해야 한다 — 한쪽만 바꾸면 시드는 설치되는데
|
|
* spec 이 그 경로를 못 찾아 라우트 트리 매칭이 실패한다.
|
|
*/
|
|
export const SANDBOX_ROUTE = {
|
|
'sirsoft-basic': '/e2e-sandbox',
|
|
'sirsoft-admin_basic': '*/admin/e2e-sandbox',
|
|
} as const;
|
|
|
|
/**
|
|
* 시드 화면 본문 컨테이너의 노드 id — `editorPath(page, rel, SANDBOX_ROOT_ID)` 의 기준점.
|
|
*
|
|
* 제품 화면에서는 어느 Div 가 선택 가능한지 정해져 있지 않아 spec 이 후보를 순회하거나
|
|
* `children.5.children.0...` 같은 인덱스 체인을 써야 했다. 시드 화면은 이 id 를 고정하므로
|
|
* 컨테이너를 곧바로 지목할 수 있다.
|
|
*/
|
|
export const SANDBOX_ROOT_ID = 'e2e_sandbox_root';
|
|
|
|
/**
|
|
* 편집기 진입 URL 의 `?route=` 에 넣을 인코딩된 시드 라우트를 반환한다.
|
|
*
|
|
* spec 의 `gotoEditor(page, route)` 가 `?route=${route}` 로 조립하므로 인코딩된 값을 넘긴다.
|
|
*
|
|
* @param template 편집 대상 템플릿 identifier (기본값: 사용자 템플릿)
|
|
* @returns URL 인코딩된 시드 라우트 경로
|
|
*/
|
|
export function sandboxRouteParam(
|
|
template: keyof typeof SANDBOX_ROUTE = 'sirsoft-basic',
|
|
): string {
|
|
return encodeURIComponent(SANDBOX_ROUTE[template]);
|
|
}
|
|
|
|
/**
|
|
* `php artisan` 을 실행할 코어 루트를 결정한다.
|
|
*
|
|
* 확장(모듈/플러그인/템플릿) 은 자기 디렉토리의 config 로 Playwright 를 띄우므로 `process.cwd()`
|
|
* 가 확장 디렉토리다 — 그 위치에는 artisan 이 없다. 본 파일은 항상
|
|
* `<코어루트>/tests/Playwright/fixtures/` 에 있으므로 자기 위치에서 코어 루트를 역산한다.
|
|
*/
|
|
function resolveCoreRoot(): string {
|
|
return process.env.G7_ROOT || resolve(__dirname, '../../../');
|
|
}
|
|
|
|
/**
|
|
* `playwright:seed-layout` 커맨드를 실행한다.
|
|
*
|
|
* @param remove true 면 시드 화면 제거, false 면 설치
|
|
*/
|
|
export function runSeedLayoutCommand(remove: boolean): void {
|
|
const args = ['artisan', 'playwright:seed-layout'];
|
|
if (remove) args.push('--remove');
|
|
|
|
execFileSync('php', args, {
|
|
cwd: resolveCoreRoot(),
|
|
encoding: 'utf-8',
|
|
stdio: 'inherit',
|
|
env: {
|
|
...process.env,
|
|
// PlaywrightSeedLayout 의 옵트인 가드를 통과시킨다.
|
|
// .env 영구 수정 없이 자식 프로세스에만 부여 — 운영 환경 격리 보존.
|
|
G7_PLAYWRIGHT_BYPASS: '1',
|
|
},
|
|
});
|
|
}
|