Документация

Доказательства для рецензирования

К предварительным сборкам, результатам сканирования, показателям покрытия и тестам, прикреплённым к описываемому ими 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, Greptile, Cursor Bugbot, SonarQube Cloud, Snyk, Semgrep
Показатели покрытия и визуальный контрольCodecov, Chromatic, Percy
Тестирование на уровне всего приложения и мониторингCypress Cloud, Checkly, Maestro, BrowserStack
НастраиваемыеНастраиваемый вебхук для доказательств

Всего тридцать один провайдер. Настраиваемый вебхук для доказательств охватывает всё, чего нет в этом списке.

Каждый провайдер указывает, какие типы доказательств он может генерировать — веб-предпросмотр, мобильную сборку, отчёт AI по рецензированию, результаты сканирования на наличие уязвимостей, показатели покрытия, визуальный контроль, тестирование на уровне всего приложения и проверку производительности — а также то, как Coroid их обрабатывает: через интерфейс Git, вывод CI или напрямую через API провайдера API.

Скорее всего, у вас уже есть большая часть этих инструментов.

В этом и заключается суть. Команды, внедряющие Coroid, обычно уже используют предварительные сборки, средства сканирования и отчёты о покрытии. Функция доказательств рецензирования объединяет уже существующие решения, не заменяя их.

Настройте провайдеров в параметрах подключения организации; после этого доказательства будут автоматически прикрепляться к открываемым Coroid запросам на рецензирование.

Доказательства и условия

Доказательства и условия связаны между собой, но являются разными понятиями:

  • Доказательства — это информация, прикреплённая для ознакомления человеком.
  • Условие — это правило, которое система применяет при принятии решения.

Доказательства могут служить основой для условий — например, условие по порогу покрытия опирается на соответствующие данные — но большинство доказательств представляют собой лишь справочную информацию. Не всё, что стоит увидеть, обязательно должно блокировать процесс.

Выбор того, что прикреплять

Больше доказательств — не значит лучше. Каждый элемент конкурирует за внимание рецензента, и pull request, содержащий пятнадцать артефактов, получит столько же внимания, сколько и тот, что содержит три.

Прикрепляйте только то, что влияет на решение:

  • предварительный предпросмотр всякий раз, когда изменение затрагивает пользовательский интерфейс
  • показатели покрытия если изменение существенно влияет на покрытие кода
  • сканирование на наличие уязвимостей для всех участков кода, обрабатывающих ввод данных, аутентификацию или зависимости
  • визуальные отличия при работе с системой дизайна и компонентами