docs(testing): 시각 회귀 13.4절을 실제 기준선 5장에 맞춘다 (11-04)
문제: 테스트 전략 문서 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
This commit is contained in:
@@ -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 대표
|
||||
|
||||
결정성 규칙:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user