검증과 릴리스
기본 CI, 전체 로컬·수동 검사와 배포 사이트 핵심 검사의 범위를 설명합니다.
소스 규칙
npm run lint --prefix registry
npm run build --prefix registry
npm run sync:docs --prefix registry
npm test --prefix registry
npm run check:generated --prefix registry
npm run lint --prefix docs
npm run typecheck:site --prefix docs
npm run build:site --prefix docs브라우저 검사 전에 레지스트리 테스트로 의존성 구성, 문서 예제, 테마 규칙과 생성 소스의 전제를 확인합니다.
생성 일치
- 레지스트리 목록, 두 공개 엔드포인트 복사본, 테마 CSS와 초기화 스크립트는 소스에서 생성합니다.
- check:generated는 생성 결과의 바이트 일치와 항목 목록 일치를 확인합니다.
- CI의 최종 생성 검사는 추적 파일 변경과 예상하지 못한 미추적 파일을 거부합니다.
기본 CI
- main 푸시, 풀 리퀘스트와 comprehensive를 켜지 않은 수동 실행은 레지스트리 린트·빌드·규칙 검사, 문서 린트·타입·빌드와 생성 일치를 확인합니다.
- 문서 상호작용은 Chromium의 데스크톱 라이트·모바일 다크에서 검사합니다. 대표 Vite·Next.js 소비자 설치는 consumer:verify --smoke로 검사합니다.
- 개발 도구를 포함한 의존성 감사에서 높음 또는 심각 수준의 취약점이 발견되면 CI를 차단합니다.
전체 로컬·수동 검사
- 넓은 범위의 릴리스 전에는 전체 소비자·독립 항목 검사를 로컬에서 실행하거나 Verify 워크플로를 comprehensive 옵션으로 수동 실행합니다.
- 독립 설치 대상은 빌드된 목록에서 파일을 포함하는 모든 항목으로 정합니다.
- 템플릿은 새 Next.js 프로젝트에서, 나머지 항목은 Next.js와 Vite에서 각각 독립 빌드합니다.
- 수동 워크플로는 독립 설치 대상을 세 작업으로 나누고 Firefox·WebKit 소비자 검사와 detail·material 화면 검사를 추가합니다.
배포 사이트 핵심 검사
- Published registry 워크플로는 build-info.json이 실행을 유발한 main 커밋과 일치할 때까지 기다립니다.
- 배포 사이트에서는 Chromium 핵심 시나리오 세 개와 대표 레지스트리 엔드포인트 세 개만 검사합니다. 전체 설치·브라우저 조합은 로컬 또는 수동 전체 검증에서 실행합니다.
- 실패 근거는 CI 아티팩트에 보관하며 로컬 브라우저 근거는 docs/test-results에 기록합니다.
릴리스 범위
- 로컬이나 CI 빌드가 통과해도 shadcn 디렉터리 승인이나 실제 배포 도메인과의 동등성을 뜻하지 않습니다.
- 실제 도메인 검사는 정확한 배포 커밋과 공개 레지스트리 엔드포인트가 일치해야 합니다.
- 라이선스와 출처 표시는 별도 릴리스 조건이며 저장소 소유권만으로 충족됐다고 판단하지 않습니다.