> For the complete documentation index, see [llms.txt](https://kaze.gitbook.io/qa-theory/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kaze.gitbook.io/qa-theory/ci/kakuyu-informaciyu-dolzhen-soderzhat-otchet-o-vypolnenii-avtomaticheskikh-testov.md).

# Какую информацию должен содержать отчет о выполнении автоматических тестов?

Отчёт о выполнении автоматических тестов — это ключевой инструмент для анализа качества кода и результатов CI/CD. Он должен содержать **достаточно информации, чтобы понять, что прошло успешно, что упало, и где искать проблему**.

***

#### **Основные элементы отчёта**

1. **Общая статистика**
   * Количество выполненных тестов.
   * Количество успешных тестов (`passed`).
   * Количество упавших тестов (`failed`).
   * Количество пропущенных тестов (`skipped`).
   * Время выполнения всех тестов.
2. **Подробная информация о тестах**
   * Имена тестов или идентификаторы.
   * Статус каждого теста (pass/fail/skip).
   * При падении теста — **трассировка ошибки** (stack trace).
   * Лог сообщений из теста (stdout/stderr).
3. **Ошибки и исключения**
   * Тип ошибки (`AssertionError`, `TypeError` и т. п.).
   * Сообщение об ошибке и контекст выполнения.
   * Файл и строка, где произошёл сбой.
4. **Скриншоты и артефакты (для UI/E2E тестов)**
   * Скриншоты, если тест упал.
   * Логи браузера или сервера.
   * Файлы данных, использованных в тесте.
5. **Метрики покрытия (Coverage)**
   * Процент кода, покрытого тестами.
   * Отдельные файлы с отметками покрытия.
   * Несколько популярных форматов: HTML, XML, JSON.
6. **Контекст окружения**
   * Версия приложения, ветка, commit hash.
   * Используемая ОС и версия Python/Java/Node и т. п.
   * Версии библиотек и зависимостей.
7. **Итоговая оценка**
   * Пройден ли pipeline (CI/CD).
   * Рекомендации: «нужен фикс», «готово к деплою».

***

#### **Форматы отчётов**

* Текстовые: stdout от `pytest` или `unittest`.
* HTML: читаемые визуально, с цветовой маркировкой.
* JUnit XML: для интеграции с CI-системами (Jenkins, GitLab, GitHub Actions).
* Allure Report: подробный интерактивный отчёт с логами, скриншотами и шагами тестов.

***

Итог: **отчёт должен показывать, какие тесты прошли, какие упали, почему и в каком окружении**, чтобы команда могла быстро локализовать и исправить проблему.