← Все статьи
QA · 8 мин чтения

Баг-репорты, которые любят разработчики: шаблон и реальные примеры

Хороший баг-репорт исправляют быстрее. Вот наш шаблон, пример плохого и хорошего репорта и то, как мы определяем серьёзность и приоритет.

Баг, который невозможно воспроизвести, не исправляют. Баг-репорт, на понимание которого разработчик тратит двадцать минут, откладывают. Качество баг-репортов напрямую влияет на скорость команды, поэтому мы считаем их написание ключевым навыком QA, а не бюрократией.

Анатомия хорошего репорта

ПолеЧто писать
ЗаголовокЧто сломано, где и при каком условии. Коротко и так, чтобы легко найти поиском
ОкружениеСборка/версия, URL, устройство, ОС, браузер, тип аккаунта
ПредусловияДанные или состояние, нужные до шага 1
Шаги воспроизведенияПронумерованные, минимальные, одно действие на шаг
Ожидаемый результатЧто должно произойти, желательно со ссылкой на требование
Фактический результатЧто происходит вместо этого, включая текст ошибки
ДоказательстваСкриншот, видео, логи, сетевой запрос (HAR), ошибки в консоли
Серьёзность / ПриоритетВлияние на продукт / срочность исправления
ЧастотаВсегда, иногда (3 из 10), один раз

Плохой и хороший

Плохой репорт:

Оформление заказа не работает. Я попробовал что-то купить, и ничего не получилось. Исправьте срочно!!!

Тот же баг, описанный хорошо:

Заголовок: Оформление – кнопка «Оплатить» остаётся неактивной после применения промокода в мобильном Safari

Окружение: staging build 1.4.2 (#1287), iPhone 13, iOS 17.5, Safari
Аккаунт: зарегистрированный пользователь test.buyer+12@…, корзина из 2 товаров ($64.00)

Шаги:
1. Открыть /cart
2. Ввести промокод SPRING10 и нажать «Применить»
3. Нажать «Оформить» и заполнить корректный адрес
4. Выбрать «Карта» как способ оплаты

Ожидается: кнопка «Оплатить $57.60» активна
Фактически: кнопка неактивна; в консоли
        TypeError: total.toFixed is not a function (checkout.js:214)

Частота: 5/5 в iOS Safari; не воспроизводится в Chrome на десктопе
Доказательства: video.mp4, console.log, HAR-файл приложены
Серьёзность: Critical (пользователи не могут оплатить)  Приоритет: High

Вторую версию можно исправить без единого уточняющего вопроса. Ошибка в консоли даже указывает разработчику на строку кода.

Серьёзность и приоритет

Серьёзность описывает влияние дефекта на систему. Приоритет — как быстро его нужно исправить. Обычно они связаны, но не всегда, и эта разница важна при планировании.

Приоритет →Серьёзность →Низкая серьёзность · Высокий приоритетОпечатка в названии бренда на главной;Неверный формат цены в рекламеВысокая серьёзность · Высокий приоритетПользователи не могут оплатить;Потеря данных, уязвимость
Серьёзность и приоритет — разные оси. Примеры из реальных проектов.

Наш чек-лист перед нажатием «Создать»

  1. Воспроизведено как минимум дважды, желательно в чистой сессии
  2. Проверено, нет ли дубликата
  3. Шаги минимальны: убрано всё, что не нужно для воспроизведения
  4. Один баг — один репорт
  5. Заголовок понятен без открытия тикета
  6. Доказательства приложены, чувствительные данные скрыты
  7. Без эмоций и обвинений, только факты

После репорта

Когда баг исправлен, QA проверяет исправление в том же окружении и делает короткую регрессию вокруг него. Для повторяющихся багов мы проводим анализ первопричин: почему это произошло и какой тест, ревью или проверка поймали бы это раньше? Именно этот вопрос помогает командам не видеть один и тот же тип бага дважды.