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

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

К предварительным сборкам, результатам сканирования, показателям покрытия и тестам, прикреплённым к описываемому ими 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 у поставщика.

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

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

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

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

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

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

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

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

Доказательства рецензирования описывают pull request. Это Релиз Оценивает именно тот коммит, выбранный для развертывания в окружении, с помощью отдельного запуска Quality Graph, чек-листа и закрепленных разрешений. Возможно, он ссылается на действительные доказательства рецензирования, но успешная проверка pull request не гарантирует его развертывание. Развертывание фиксируется через обратные вызовы провайдера или ручную аттестацию; состояние здоровья системы отслеживается при помощи пост-деплоя канари.

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

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

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

  • предварительный просмотр — всегда, когда изменение видно пользователю; его можно запустить прямо из рецензирования задачи. Запустить предварительный просмотр из рецензирования задачи
  • Покрытие — если изменение влияет на показатели покрытия.
  • Сканирование безопасности — для всего, что затрагивает обработку ввода, аутентификацию или зависимости.
  • Визуальные различия — для работы с системой дизайна и компонентами.