HMDesign/docs/org-chart/browser-verification.md

OrgChart 브라우저 검증 실행 환경

검증 시나리오·기대값과 과거 test-results는 보존한다. 과거 전체 suite는 이번 수정의 필수 재실행 대상이 아니다.

examples/org-chart/verify*.mjs와 React 브라우저 runner는 공통 scripts/orgchart-browser-runtime.mjs를 사용한다.

• 기본: 프로젝트의 표준 Node 모듈 탐색으로 playwright를 불러오고 해당 설치의 관리 Chromium을 실행한다.
• ORGCHART_PLAYWRIGHT_MODULE: 선택형. 기존 외부 Playwright 설치의 entry 파일 절대경로 또는 실행 디렉터리 기준 상대경로.
• ORGCHART_CHROME: 선택형. 기존 Chromium/Chrome 실행 파일 절대경로 또는 실행 디렉터리 기준 상대경로.
• 지정한 모듈을 불러올 수 없거나 브라우저가 없으면 실행을 실패시키고 해결 방법 및 원래 오류를 출력한다. 자동 설치·버전 업그레이드·특정 PC fallback은 없다.

저장소 루트에서 실행한다. 기존 프로젝트 의존성에 Playwright가 없다면 이미 설치된 외부 entry를 환경변수로 지정한다. 환경변수 없이 실행하려면 해당 프로젝트 환경에서 Playwright 및 그 관리 Chromium이 제공되어야 한다. 실제 새 PC의 의존성 설치는 별도 확인 사항이다.

# 기본 모듈을 사용할 수 있는 환경
node examples/org-chart/verify-p2.mjs

# 기존 외부 도구 설치를 재사용하는 환경(실제 경로로 지정)
$env:ORGCHART_PLAYWRIGHT_MODULE = '<existing-playwright-entry>'
$env:ORGCHART_CHROME = '<existing-browser-executable>'
node examples/org-chart/verify-p2.mjs

각 suite의 준비된 example build, baseline dist, Storybook/서버 origin 등의 전제는 그대로 유지된다. 도구 경로가 이식 가능해졌다는 것이 과거 fixture/baseline을 자동 생성하거나 모든 suite가 새 PC에서 검증되었다는 뜻은 아니다.