Playwright 프론트엔드 UI 스모크 패턴 (백엔드 없이)

제품 프론트만으로 UI 회귀를 잡는 재사용 패턴. SQL EX/exec_result 품질 게이트(Spider2-Quality-Gate-nl2sql.md)와 축이 다름(UI vs 실행 결과).

레지스트리·실행

에이전트 팩토리형 레포에서는 quality 레지스트리에 e2e를 명시한다.

  • 레지스트리 예: .factory/quality.yaml → e2e: → frontend/e2e/*.spec.ts
  • 실행 예:
cd frontend && npm run test:e2e
  • Vite webServer로 프론트만 기동; backend/LLM 불필요.

Mock 패턴

목록/메타 API는 page.route로 mock한다 (Playwright best practices).

// 예: 메타데이터 목록
await page.route("**/api/metadata/fs", async (route) => {
  await route.fulfill({ json: { /* fixture */ } });
});

Pod / CDN IPv6 회피

Pod에서 Playwright 브라우저 CDN이 IPv6 ENETUNREACH일 때 apt chromium + 다운로드 스킵:

PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
PLAYWRIGHT_CHROMIUM_PATH=/usr/bin/chromium

Chromium 설치·다운로드가 불가하면 동일 템플릿의 HTMX/SSR partial + 배포 아티팩트 정적 검증으로 UI-equivalent 증거를 남긴다(브라우저 E2E 대체, 별 축 명시).

적용 팁

  • frontend-only 변경이면 e2e 축만 게이트하고, 미터치 백엔드 CI red는 별 축으로 다룬다.
  • playwright.config가 127.0.0.1:5173 + webServer로 고정된 Vite+route-mock 스위트면 클러스터 Ingress E2E를 발명하지 않는다. E2E_BASE_URL 배선 전까지 local mock이 정본이다.
  • 제품 예시(nl2sql): 동일 패턴을 frontend/e2e에 적용. 팩토리 맥락: Agentic-Software-Factory.md.

스코프 경계

UI Playwright는 shell/nav/list 스모크다. backend SSE 필드(예: tool_result.ok) 행위는 **unit/test_chat*.py**가 정본 — E2E green만으로 SSE 계약 완료로 보지 않는다.

🔗 관련 문서