Приёмка функциональности часто буксует на этапе верификации. Тестировщик открывает форму, видит сообщение об ошибке, но не понимает, является ли это ожидаемым поведением или багом. Аналогично с API: клиент получает код 400, но спецификация не уточняет, какой именно параметр нарушает контракт. В фоновых задачах ситуация хуже: если воркер упал, нет явного критерия, который позволил бы сказать «система работает корректно, несмотря на ошибку».
Критерии приёмки — это набор однозначных, проверяемых условий, которые определяют, когда функция считается завершённой. Они должны быть независимы от реализации: тестировщик не должен читать исходный код, чтобы понять, что считать успехом. Хороший критерий отвечает на вопрос: «Какое наблюдаемое поведение подтверждает, что требование выполнено?».Принципы формулирования
Критерии приёмки отличаются от пользовательских историй. История описывает ценность («Я хочу восстановить пароль, чтобы получить доступ»), а критерии описывают механику проверки. Три основных принципа:
- Наблюдаемость: условие должно проверяться через интерфейс, сетевой запрос или логи. Нельзя требовать проверки внутренней переменной класса.
- Двоичность: каждый критерий имеет только два исхода: пройден или не пройден. Формулировки вроде «быстро» или «удобно» непригодны без количественных порогов.
- Независимость: критерий проверяет один аспект. Если условие объединяет проверку формата email и проверку длины пароля, невозможно локализовать причину отказа.
Для системного аналитика важно разделять функциональные критерии (что делает система) и нефункциональные (как она это делает). Например, «валидация email» — функциональный критерий, а «ответ на запрос занимает меньше 200 мс» — нефункциональный. Смешение этих типов в одном списке затрудняет приоритизацию тестов.
Веб-формы: клиентская и серверная валидация
Типичная ошибка — путать клиентскую валидацию (JS в браузере) с серверной (backend). Клиентская валидация улучшает UX, но не является гарантией безопасности. Критерии приёмки должны фокусироваться на серверном результате, так как клиентский JS можно обойти.
Рассмотрим форму регистрации. Вместо расплывчатого «пользователь регистрируется успешно», формулируем конкретные состояния:| Сценарий | Действие пользователя | Ожидаемый результат (сервер) | Ожидаемый результат (клиент) |
|---|---|---|---|
| Успех | Email: valid@example.com, Пароль: Str0ng!Pass | HTTP 201, создан объект User | Переход на страницу профиля |
| Email занят | Email: existing@example.com | HTTP 409, тело содержит "email_taken" | Ошибка под полем email |
| Слабый пароль | Пароль: 123456 | HTTP 422, поле errors[password] | Сообщение о сложности |
| Невалидный email | Email: not-an-email | HTTP 422, поле errors[email] | Ошибка формата |
Серверный и пользовательский результаты проверяют отдельно. Ответ 409 подтверждает выбранный отказ в API только вместе с отсутствием нежелательного сохранения. Если интерфейс показывает белый экран, пользовательский критерий не выполнен, хотя данные могли сохраниться корректно. Приёмку всего сценария нельзя считать завершённой по одному серверному коду.
REST API: контракты и идемпотентность
Для API критерии приёмки тесно связаны с контрактом (OpenAPI/Swagger). Но контракт описывает структуру, а не семантику действий. Нужно дополнить его behavioral-требованиями.
Важнейший аспект — идемпотентность. Метод POST обычно не идемпотентен: повторная отправка создаёт дубликаты. Однако в финансовых операциях или создании заказов повторный запрос из-за таймаута клиента не должен создавать вторую запись. Критерий: «При повторении POST /orders с тем же Idempotency-Key возвращается тот же ресурс с кодом 200, а не 201». Также необходимо чётко определить обработку частичных ошибок. Если эндпоинт принимает массив объектов, и второй элемент невалиден, что делать с первым?- All-or-nothing: весь запрос откатывается, HTTP 422. Подходит для транзакционных операций.
- Partial success: валидные объекты обрабатываются, невалидные возвращаются в отчете, HTTP 207 Multi-Status. Подходит для пакетной загрузки данных.
Выбор стратегии должен быть зафиксирован в критериях. Без этого тестировщик будет считать оба варианта багами. Пример критерия для batch-загрузки: «Если хотя бы одна запись в массиве items не проходит валидацию, сервер возвращает HTTP 422 и не сохраняет ни одной записи из пакета».
Фоновые задачи: обработка ошибок и ретраи
Фоновые задачи (worker'ы, cron'ы) сложнее в верификации, так как их выполнение асинхронно. Критерии приёмки здесь должны включать не только успешное завершение, но и поведение при сбоях.
Ключевые аспекты:- Атомарность единицы работы: если задача обрабатывает 1000 элементов, падение на 500-м не должно потерять первые 499. Обычно это реализуется через чекпоинты или транзакции на уровне элемента.
- Экспоненциальный бэкофф: при ошибке сети задача должна повторяться с увеличивающимся интервалом. Критерий: «После первой неудачи следующий retry через 1 сек, после второй — через 5 сек, после третьей — через 30 сек».
- Dead Letter Queue (DLQ): после N неудачных попыток задача перемещается в очередь ошибок. Критерий: «После 5 неудачных попыток сообщение попадает в топик dead_letters и удаляется из основной очереди».
Частая ошибка — считать, что «задача завершилась» означает успех. Необходимо явно указывать, что считается состоянием успеха. Для отправки письма это успешное подтверждение SMTP-сервером, а не просто добавление письма в очередь. Критерий: «Email считается доставленным только после получения кода 250 от SMTP-сервера».
Учебный пример: создание заказа
Рассмотрим полный набор критериев приёмки для функции «Создание заказа» в учебной e-commerce системе. Этот пример демонстрирует, как связать UI, API и backend-логику.
### Критерии приёмки: Создание заказа (Order Creation)
#### 1. Валидация входа (Client & Server)
- [ ] Клиентская валидация: поле 'quantity' не допускает значение <= 0.
- [ ] Серверная валидация: запрос с quantity=0 возвращает HTTP 422.
- [ ] Серверная валидация: запрос с несуществующим product_id возвращает HTTP 404.
#### 2. Бизнес-логика (Backend)
- [ ] При наличии скидки в корзине итоговая сумма рассчитывается с учётом налога.
- [ ] Если остатка товара на складе недостаточно, заказ не создаётся (HTTP 409).
- [ ] Остаток на складе уменьшается атомарно с созданием записи в БД.
#### 3. Идемпотентность
- [ ] Повторный POST /api/v1/orders с тем же header 'Idempotency-Key'
возвращает существующий Order с HTTP 200.
- [ ] Повторный POST с другим 'Idempotency-Key' создаёт новый Order.
#### 4. Наблюдаемость
- [ ] При успешном создании в логах появляется entry с уровнем INFO,
содержащий order_id и total_amount.
- [ ] При ошибке валидации в логах появляется entry с уровнем WARN,
содержащий details ошибки.
#### 5. Интеграция
- [ ] После создания заказа публикуется событие 'order.created'
в message broker с payload, содержащим order_id, user_id, timestamp.
Этот список позволяет тестировщику составить матрицу тестов. Каждый пункт — отдельный test case. Заметьте, что пункт 2.3 («остаток уменьшается атомарно») требует проверки состояния БД, а не только HTTP-ответа. Это пример критерия, который нельзя проверить только через API — нужен доступ к данным или mock'а.
Типичные ошибки в спецификациях
Даже опытные аналитики допускают ошибки, которые приводят к бесконечным дискуссиям на этапах разработки и тестирования.
- Отсутствие негативных сценариев: описан только happy path. Нужно явно указать, что происходит при превышении лимита, при дублях, при отсутствии прав доступа.
- Зависимость от реализации: критерий «система использует Redis для кэша» — неверный. Правильно: «повторный запрос к тому же URL обслуживается из кэша, время ответа < 50 мс». Технология не важна, важно поведение.
- Неопределённые пороги: «система должна работать быстро». Непроверяемо. Правильно: «P95 latency для GET /products составляет не более 200 мс при нагрузке 100 RPS».
- Смешение уровней абстракции: в одном документе описаны и детали SQL-запросов, и UX-паттерны. Лучше разделить: функциональные критерии для backend, usability-критерии для frontend.
Особняком стоят проблемы с nullability. В OpenAPI 3.0 поле может быть optional (не передано) или nullable (передано как null). Эти состояния требуют разной обработки. Критерий должен различать их: «Если поле phone отсутствует в теле запроса, он считается валидным. Если поле phone = null, возвращается ошибка 422».
Инструменты и верификация
Хранить критерии приёмки лучше в том же формате, что и остальная документация проекта. Для большинства команд это Markdown. Структурированный текст легко конвертировать в тест-кейсы в Jira, TestRail или Allure.
Процесс верификации выглядит так:- Аналитик пишет критерии в Markdown-файле, привязывая их к конкретной задаче (Story ID).
- Разработчик реализует функцию, отмечая в комментарии к коду ссылки на критерии.
- Тестировщик пишет автотесты, где каждый assert соответствует одному пункту списка.
- При сбое теста команда анализирует: это баг в коде или неточность в критериях? Если критерий был неоднозначен, он уточняется, а не переписывается целиком.
В helper-sa можно открыть редактор Markdown, вставить шаблон критериев и доработать его под свою систему. Это позволяет держать требования рядом с другими артефактами проекта, сохраняя историю изменений через версию документа.
Ограничения подхода
Критерии приёмки не заменяют полноценную спецификацию. Они не описывают архитектуру, схемы БД или алгоритмы. Их цель — дать четкую границу между «сделано» и «не сделано».
Кроме того, критерии не могут покрыть все возможные комбинации ввода. Они должны охватывать основные сценарии использования и критические edge cases. Покрытие 100% возможных состояний системы невозможно и нецелесообразно. Стратегия состоит в выборе наиболее вероятных и опасных сценариев.Итог
Качество критериев приёмки напрямую влияет на скорость выпуска релизов. Однозначные, наблюдаемые условия позволяют автоматизировать проверку и снижают количество ложных багов. Для форм фокусируйтесь на серверном ответе, для API — на контрактах и идемпотентности, для фоновых задач — на обработке ошибок и DLQ. Используйте таблицы для структурирования сценариев и избегайте зависимостей от конкретной технологии. Такой подход превращает приёмку из субъективного обсуждения в объективный процесс проверки.
