test(visual): 갤러리를 Storybook story로 옮기고 골든 대상을 바꾼다
예제 화면 /examples/ui·/examples/states가 visual 골든 2장과 갤러리
브라우저 시험의 대상이다. 2026-11-07 소유자 결정으로 예제 화면을
지우므로 그 역할을 먼저 옮긴다(design-docs repo-structure/
04-frontend-layout.md 9.2절 2단계 (1)).
두 갤러리 화면을 그대로 src/presentation/design-system/
galleries.stories.tsx로 옮겼다. 화면 단위 story(parameters.page)는
preview가 여백을 더하지 않아 앱 안과 같은 폭으로 그려진다. visual
설정은 Storybook 정적 빌드를 두 번째 web server로 띄우고
(TEST_VISUAL_WORKSHOP_PORT, 빌드 명령은 workshop 설정과 같은
scripts/lib/storybook-static.ts), 골든 2장은 그 story를 찍는다. 어두운
골든은 테마 선택기가 없어 시스템 dark(colorScheme)로 그린다. e2e의
갤러리 상호작용(텍스트 필드, 모달 포커스, 메뉴·탭·토스트, 열린 대화
상자 axe, 320px 리플로)은 tests/storybook/galleries.spec.ts로 옮겼다.
위험: 골든의 픽셀 색 허용치(threshold 0.2)는 그대로다. 미세한 토큰
변화는 옛 골든처럼 새 골든도 잡지 못한다.
검증(desktop): test:storybook 6 passed, test:visual 7 passed,
playwright-run-isolation 단위 시험 통과. 변이 확인: --color-action을
파랑→빨강으로 바꾸면 새 골든이 어두운 쪽 42,313px, 밝은 쪽 22,359px
차이로 실패했다. 옛 골든(main f33e4778)도 40,238px, 22,511px로 실패했다.
미세 변이(어두운 --color-danger red-500→600, 밝은 --color-danger-surface
색상각 25→145)는 옛·새 골든 모두 통과했다. 변이는 되돌렸다.
This commit is contained in:
@@ -808,8 +808,10 @@ production runtime config에 `MOCK_MODE`, `SCENARIO`, fake token 같은 key를
|
||||
## 12. Storybook 테스트
|
||||
|
||||
Storybook은 component를 격리해 state를 열거하고 실제 브라우저 interaction과
|
||||
접근성을 검사하는 개발·CI surface다. `/examples/ui`는 앱 통합 smoke로 유지하되
|
||||
Storybook을 대신하지 않는다.
|
||||
접근성을 검사하는 개발·CI surface다. 디자인 시스템 갤러리와 화면 상태 갤러리도
|
||||
story다(`src/presentation/design-system/galleries.stories.tsx`). 갤러리의 브라우저
|
||||
상호작용 검사는 `tests/storybook/galleries.spec.ts`가, 앱 셸 안의 통합 확인은
|
||||
`/`와 `/examples/platform`을 여는 e2e가 맡는다.
|
||||
|
||||
### 12.1 Global decorator
|
||||
|
||||
@@ -945,9 +947,10 @@ Playwright `toHaveScreenshot()`을 사용한다.
|
||||
- `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
|
||||
- `design-system-gallery-dark`: Storybook 정적 빌드의 갤러리 story
|
||||
`platform-galleries--design-system`, 1280×900, 시스템 dark — design-system 갤러리
|
||||
- `state-surfaces-light`: Storybook 정적 빌드의 `platform-galleries--screen-states`,
|
||||
1280×1100 — loading, background refresh, empty, error, 401, 403, 404
|
||||
- `platform-overview-light`: `/examples/platform` — 플랫폼 구성 개요
|
||||
|
||||
`check-test-evidence`는 기준선 PNG가 4장 이상인지만 본다. 위 목록의 각
|
||||
@@ -1034,7 +1037,7 @@ TEST_RUN_ID=a playwright test
|
||||
|---|---|---|
|
||||
| `TEST_RUN_ID` | 다섯 Playwright 설정, `tests/e2e/preload-use.spec.ts` | `dist`, `artifacts/tests/<이름>/` |
|
||||
| `RUN_OUTPUT_ROOT` | 빌드 단계 전부(`scripts/build-frontend.ts`가 부르는 것), `vite.config.ts`. 설정이 web server에만 넘긴다. 빌드 뒤 검사(`scripts/generate-supply-chain.ts`, `scripts/check-bundle.ts`)는 `.`이 아니면 멈춘다 | `.` |
|
||||
| `TEST_E2E_PORT`, `TEST_VISUAL_PORT`, `TEST_CAPABILITIES_PORT`, `TEST_STORYBOOK_PORT`, `TEST_DEV_PORT` | 각 설정 | 빈 포트 |
|
||||
| `TEST_E2E_PORT`, `TEST_VISUAL_PORT`, `TEST_VISUAL_WORKSHOP_PORT`, `TEST_CAPABILITIES_PORT`, `TEST_STORYBOOK_PORT`, `TEST_DEV_PORT` | 각 설정(`TEST_VISUAL_WORKSHOP_PORT`는 visual 설정의 두 번째 서버, 갤러리 골든이 여는 Storybook 정적 빌드) | 빈 포트 |
|
||||
|
||||
- run ID는 글자·숫자·`.`·`_`·`-` 64자 이하이고 글자나 숫자로 시작한다.
|
||||
- 포트 변수를 주면 그 포트를 쓴다. 디버깅할 때 고정하는 용도다.
|
||||
|
||||
Reference in New Issue
Block a user