Проверка сборок

Правила и тесты говорят, что проверять. Вкладка «Проверка» показывает, что из этого получилось: какие сборки прошли, где нашлись отличия и что из этого уже разобрал человек. Это главный экран визуального слоя — сюда ведут счётчики с главной страницы продукта.

Список сборок

Вкладка открывается списком сборок — от новых к старым. Сверху три отбора: ветка, режим и состояние ревью. В строке сборки сразу видно, сколько снимков изменилось, сколько появилось новых и сколько было снято всего.

Если проект только начали настраивать и сборок ещё нет, вкладка предложит запустить первую — кнопкой «Запустить тест».

Режимы сборки

Режим решает, сколько проверок прогнать. Их три:

  • Полная сборка — прогоняет все объявленные проверки. Самый честный и самый долгий режим; его имеет смысл ставить перед выпуском или по расписанию ночью.
  • Умная сборка — прогоняет только затронутые проверки. Подходит для повседневной работы: меньше времени, меньше шума.
  • Сравнительная сборка — сравнивает две среды между собой, например тестовую и рабочую. Полезна, когда нужно убедиться, что на рабочем сайте всё выглядит так же, как на тестовом.

Состояния ревью

У сборки одно из пяти состояний:

  • Непросмотрено — отличия никто ещё не смотрел.
  • Изменения запрошены — ревьюер посмотрел и вернул на доработку.
  • Одобрено — отличия приняты, эталоны обновлены.
  • Отклонено — изменения признаны лишними или ошибочными.
  • Слито — сборка влита в основную ветку.

Рядом с состоянием всегда написана причина — почему оно именно такое. Например: «Снимки ждут ревью», «Все снимки были одобрены ранее», «Автоодобрено правилом ветки», «Отклонено ревьюером», «Визуальных изменений нет», «Некоторые снимки не удалось сравнить», «Некоторые снимки не загрузились». Так видно не только что решили, но и на каком основании.

Страница сборки

Внутри сборки — шаги с метками и строки снимков. У каждой строки свой статус:

  • ожидает — снимок ещё делается;
  • без изменений — совпал с эталоном;
  • изменён — есть отличие, которое нужно посмотреть;
  • новый — эталона ещё не было, он создан автоматически;
  • удалён — места, которое снимали раньше, больше нет;
  • отсутствует — снимок не доехал (например, оборвалась связь с исполнителем);
  • пропущен — шаг не выполнялся в этом режиме.

Пока сборка идёт, страница обновляется сама: видно «Выполняется», какой это шаг из скольких и какой браузер удерживает исполнитель. Имя исполнителя указано на странице — чтобы было понятно, на какой машине всё происходило.

Что можно сделать со сборкой:

  • Повторить проваленные — перезапустить только те шаги, которые не прошли.
  • Поставить новую сборку — запустить этот же тест заново.
  • Пометить проваленной — с обязательной причиной: нестабильный прогон, проблема окружения, сбой инфраструктуры, известная регрессия. Это нужно, чтобы неудачный прогон не выдавали за находку.
  • Удалить сборку — вместе с её шагами, проверками и снимками. Эталоны при этом не трогаются.

Вердикт и массовое принятие

Сверху — строка вердикта: «Визуально: успех», «Визуально: требуется ревью», «Визуально: провал» или «Визуально: нет данных». Рядом счётчик «сколько решений ещё не сохранено».

Через счётчик открывается кнопка «Принять все безопасные». Массово принимаются только те отличия, безопасность которых доказали строгие правила: например, сдвиг на несколько пикселей внутри области, закрытой маской. Всё спорное остаётся на построчный просмотр — массовое действие не может протащить незамеченную регрессию. Сколько именно отличий безопасно и сколько осталось на человека, показано прямо в окне подтверждения.

Доказательства

После сборки от каждого шага остаётся снимок и результаты проверок. Поэтому, когда что-то сломалось, видно не только «упало», но и на каком именно шаге и как выглядела страница в тот момент. Эти же доказательства прикладываются к задаче на исправление и попадают в отчёт.

Дальше: как посмотреть само отличие и решить его судьбу — в разделе Просмотр различий.

← Оглавление документации