문서

리뷰 증거

pull request에 첨부된 미리보기 배포본, 스캔 결과, 커버리지 데이터 및 테스트 결과를 확인할 수 있습니다.

리뷰 증거리뷰 증거는 해당 pull request에 연결된 검증 증명 자료입니다. 여기에는 열어볼 수 있는 미리보기 화면, 스캔 결과, 커버리지 변화량, 브라우저 실행 기록 등이 포함됩니다.

원칙은 간단합니다. 증거와 그에 해당하는 코드는 함께 제공되어야 합니다. 아무도 열어보지 않는 별도 대시보드의 스캔 결과는 증거가 아니라 단순한 과제일 뿐입니다.

첨부 가능한 항목

Coroid는 여러 범주에 속하는 공급자들과 연동됩니다:

범주공급자
Git 기반GitHub Actions 환경 및 GitLab 리뷰 앱
정적 호스팅Vercel, Netlify, Cloudflare Pages, AWS Amplify
풀스택 미리보기Render, Railway, Heroku Review Apps, Fly.io, Northflank, Qovery, Porter
모바일 배포Expo EAS, TestFlight, Google Play 내부 테스트
리뷰 및 스캐닝CodeRabbit, Qodo / PR-Agent, Greptile, Cursor Bugbot, SonarQube Cloud, Snyk, Semgrep
커버리지 및 시각적 데이터Codecov, Chromatic, Percy
엔드투엔드 테스트 및 모니터링Cypress Cloud, Checkly, Maestro, BrowserStack
사용자 정의사용자 정의 증거 웹훅

총 31개의 공급자가 지원되며, 목록에 없는 항목은 사용자 정의 증거 웹훅을 통해 처리할 수 있습니다.

각 공급자는 생성 가능한 증거 유형(웹 미리보기, 모바일 빌드, AI 리뷰, 보안 스캔, 커버리지, 시각적 리뷰, 엔드투엔드 테스트 및 성능 데이터)과 Coroid가 이를 수집하는 방식(Git 인터페이스, CI 출력 또는 API 직접 호출)을 명시합니다.

대부분의 기능은 이미 사용 중일 가능성이 높습니다.

바로 그 점이 핵심입니다. Coroid를 도입하는 팀은 대개 이미 미리보기 배포, 스캐너 및 커버리지 보고 기능을 갖추고 있습니다. 리뷰 증거는 기존 도구들을 연결해 주는 역할을 할 뿐, 이를 대체하지는 않습니다.

조직의 연결 설정에서 공급자를 구성하면, Coroid가 생성하는 풀 요청에 증거가 자동으로 첨부됩니다.

증거와 게이트

증거와게이트는 관련 있지만 서로 다른 개념입니다:

  • 증거는 사람이 참고할 수 있도록 첨부되는 정보입니다.
  • 게이트는 시스템이 강제로 적용하는 결정입니다.

증거가 게이트의 입력이 될 수 있습니다. 예를 들어 커버리지 임계값 게이트는 커버리지 증거를 참조하죠. 하지만 대부분의 증거는 단순한 참고 자료일 뿐입니다. 반드시 확인해야 할 사항이 모두 승인을 막는 요소가 되는 것은 아닙니다.

첨부할 항목 선택하기

증거가 많다고 해서 반드시 좋은 것은 아닙니다. 각 항목은 리뷰어의 주의를 끌기 위해 경쟁하며, 15개의 아티팩트가 첨부된 pull request와 3개만 첨부된 pull request가 받는 관심도는 비슷합니다.

결정에 영향을 주는 항목만 첨부하세요:

  • a미리보기변경 사항이 사용자에게 직접 노출될 경우
  • 커버리지커버리지 변화가 중요한 경우
  • 보안 스캐닝입력 처리, 인증 또는 의존성과 관련된 부분에 변경이 있을 때
  • 시각적 차이디자인 시스템 및 컴포넌트 작업 시