Сборку не всегда удобно показывать прямо в продукте: коллеге нужен документ, заказчику — ссылка, а конвейеру — файл. Для этого есть два пути — печатаемый отчёт и общая ссылка, которая открывается без входа.
Оба пути показывают ровно то, что доказала сборка. Ни отчёт, ни ссылка не превращают проверку в разрешение на выпуск — это разные вещи, и продукт их не смешивает.
Отчёт о сборке
Отчёт печатается прямо со страницы сборки. В шапке — вердикт прогона и состояние проверки, время начала и завершения, ветка и коммит, движок сравнения, среда, размеры окна и исполнитель. Дальше идут разделы по проблемным шагам: картинки «до», «после» и отличие, текстовые сравнения, строки журнала и упавшие проверки.
Здоровые шаги в отчёт не попадают. Он остаётся доказательством, а не перечислением: в нём только то, что требует внимания.
Границы этого отчёта
В любом отчёте — напечатанном, выгруженном или по зелёной сборке — всегда печатается блок границ. Его нельзя убрать настройкой, и это сделано намеренно:
- Визуальная проверка — это не проверка бизнес-логики.
- Отличие не объясняет, почему страница отрисовалась иначе.
- Снимок структуры не поймает ошибку вида, а снимок экрана — проблему доступности: слои видят разное.
- Проверка даёт доказательства, а не разрешение на выпуск.
Выгрузка для конвейера
Отчёт выгружается в виде, который понимают сборочные системы: обычная страница и файл данных. Есть и формат JUnit — привычный для сборочных серверов отчёт о проверках, который они умеют показывать наряду с остальными результатами. Каждая выгрузка записывается в журнал аудита: видно, кто и когда забрал отчёт.
В общую ссылку встраиваются миниатюры только первых проблемных снимков (до пятидесяти) — остальные остаются в продукте. Так ссылка не превращается в файл на десятки мегабайт, а получатель всё равно видит главное.
Общие ссылки
Общая ссылка даёт анонимный просмотр только для чтения: ни вердиктов, ни комментариев, ни учётных данных наружу не уходит. Страница несёт диагональный водяной знак с названием продукта и сегодняшней датой — по ней всегда видно, что это опубликованное доказательство, а не рабочий экран.
Опубликовать можно всю сборку или один снимок. Срок действия задаётся от 1 до 90 дней, по умолчанию — две недели. Повторная публикация в течение суток отдаёт ту же ссылку, поэтому адреса не «прыгают» в переписке. Отозвать ссылку можно в любой момент, а истёкшая честно отвечает, что больше недоступна, — вместо пустой страницы или утекшей картинки.
Дальше: как конвейер сам понимает, можно ли двигаться дальше, — в разделе CI и уведомления.