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:
DongHyeonka
2026-11-01 23:18:45 +09:00
parent ba98048b29
commit 1604ef132e
@@ -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 대표
결정성 규칙: