From 1604ef132e0144aa0ded2eb5270cc7f1f0c7ae5d Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 1 Nov 2026 22:43:04 +0900 Subject: [PATCH] =?UTF-8?q?docs(testing):=20=EC=8B=9C=EA=B0=81=20=ED=9A=8C?= =?UTF-8?q?=EA=B7=80=2013.4=EC=A0=88=EC=9D=84=20=EC=8B=A4=EC=A0=9C=20?= =?UTF-8?q?=EA=B8=B0=EC=A4=80=EC=84=A0=205=EC=9E=A5=EC=97=90=20=EB=A7=9E?= =?UTF-8?q?=EC=B6=98=EB=8B=A4=20(11-04)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 테스트 전략 문서 13.4절은 "필수 baseline"으로 각 page template, 모든 primitive group, invalid form, 열린 dialog·drawer·menu, pseudo-locale·RTL 등을 적는다. 실제 기준선은 tests/visual/platform.visual.spec.ts의 5장이다. invalid form, 열린 dialog·menu, RTL, page template별 기준선은 없다. check-test-evidence는 기준선이 4장 이상인지만 본다. 다운스트림이 이 목록을 보고 보호되지 않는 화면을 보호된다고 믿을 수 있다. 고른 방법: 리뷰 최소 개선안대로 목록을 "현재 기준선 5장"과 "제품이 늘릴 후보"로 나눈다. 5장마다 경로, viewport·테마·locale, 덮는 상태를 적고, VD-08 5항의 최초 기준선 4장에 플랫폼 개요가 더해진 범위라고 밝힌다. 검사가 장 수만 본다는 것도 적는다. VD-08은 "최초 기준선은 … 포함한다"는 결정 기록이라 고치지 않았다(5장과 모순되지 않는다). 버린 대안: 기준선을 문서 목록만큼 늘리기. 골든이 늘고 11-03의 골든 재촬영과 겹친다. 리뷰도 기준선 확장은 11-02·11-03 뒤로 미뤘다. 위험·한계: check-test-evidence가 각 화면의 존재를 검사하게 바꾸지는 않았다. 문서만 고친다. 검증(문서와 코드 대조, RED 대신): - 수정 전: 13.4절 목록 8항목 중 invalid form, open dialog/menu, RTL, page template은 platform.visual.spec.ts의 5개 toHaveScreenshot과 __snapshots__ PNG 5장 어디에도 없다. - 수정 뒤: 문서의 5장 이름이 __snapshots__ 파일 이름(-chromium-visual-linux 앞부분)과 일치. state 기준선이 401·403·404를 담는 것은 src/presentation/examples/state-gallery-page.tsx의 AuthRequired· Forbidden·NotFound 표면으로 확인. - verify-documentation-readiness PASS_SCOPED. Refs: docs/reviews/2026-11-01-maturity-review/11-tests-browser-release-scale.md 11-04 --- .../frontend-platform-testing-strategy.md | 25 +++++++++++++------ 1 file changed, 18 insertions(+), 7 deletions(-) diff --git a/docs/testing/frontend-platform-testing-strategy.md b/docs/testing/frontend-platform-testing-strategy.md index cf00ec96..e23f0999 100644 --- a/docs/testing/frontend-platform-testing-strategy.md +++ b/docs/testing/frontend-platform-testing-strategy.md @@ -920,16 +920,27 @@ device descriptor는 browser/device 특성을 흉내 내지만 실제 기기를 Playwright `toHaveScreenshot()`을 사용한다. -필수 baseline: +현재 기준선은 5장이다(`tests/visual/platform.visual.spec.ts`, 골든은 +`tests/visual/__snapshots__/`). VD-08 5항의 최초 기준선 4장에 플랫폼 개요를 +더한 범위다. + +- `app-shell-wide-light`: `/`, 1440×900, light, 전체 페이지 — wide app shell +- `app-shell-compact-pseudo-drawer`: `/`, 390×844, en-XA, 메뉴 서랍 열림 — + compact app shell, pseudo-locale, 열린 drawer +- `design-system-gallery-dark`: `/examples/ui`, dark — design-system 갤러리 +- `state-surfaces-light`: `/examples/states` — loading, background refresh, + empty, error, 401, 403, 404 +- `platform-overview-light`: `/examples/platform` — 플랫폼 구성 개요 + +`check-test-evidence`는 기준선 PNG가 4장 이상인지만 본다. 위 목록의 각 +화면이 있는지는 검사하지 않는다. + +아직 기준선이 없고, 제품이 화면을 늘릴 때 추가할 후보: -- app shell compact/wide - 각 page template -- 모든 design-system primitive group -- loading/empty/error/401/403/404 - invalid form -- open dialog/drawer/menu -- light/dark -- pseudo-locale/RTL 대표 +- 열린 dialog·menu +- RTL 대표 결정성 규칙: