文档

审核依据

预览部署、扫描结果、覆盖率数据和测试结果会附加到对应的pull request上。

审核证据审核证据是附属于对应pull request的验证证明:可以是可打开的预览链接、扫描结果、覆盖率差异数据,或是录制的浏览器运行记录。

原理很简单——证据和它所描述的代码应当一同呈现。如果扫描结果存放在没人会查看的独立仪表盘中,那它不算证据,只是额外的工作而已。

可附加的内容

Coroid集成了多类提供商:

类别提供商
Git原生GitHub Actions环境、GitLab Review Apps
静态托管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创建的拉取请求中。

证据与关卡

证据和关卡二者相关但各有区别:

  • 证据是供人参考的信息。
  • 关卡是系统强制执行的决策。

证据可以为关卡提供依据——比如覆盖率阈值关卡会读取覆盖率证据——但多数证据仅作为参考信息。并非所有值得查看的内容都值得用来作为阻塞条件。

合并后的证据

审核证据描述的是一种 pull request。这种版本发布它会针对指定环境所选的精确提交,执行独立的质量 图谱运行、检查清单以及绑定审批流程。它可能会引用有效的审核证据,但拉取请求检查通过并不等同于该提交已被部署。部署过程会通过供应商回调或手动 attestation 记录;部署后的金丝雀实例会记录运行状态。

选择要附加的内容

证据越多并非越好。每个条目都会占用审核人员的注意力,携带十五个工件的 pull request 与携带三个工件的所受到的关注程度并无差别。

附加能影响决策的内容:

  • 一个预览只要变更涉及用户可见内容,便可从任务的审核页面启动预览。 从任务审核页面启动预览
  • 覆盖率当覆盖率差异具有参考价值时再附加。
  • 安全扫描涉及输入处理、身份验证或依赖项的内容需附加安全扫描结果。
  • 视觉差异设计系统和组件相关的工作需附加视觉差异结果。