Перейти к основному содержимому

2026-09-04 — Подход к интеграционным тестам бека

Статус: В работе

Источник: Олег

Эпик: ITR-2944

Документ — договорённость, на которую опираемся при переписывании тестов. Код пишет агент, проверяют два разработчика.

Эталон готов: живой путь задач заказа покупателя и корректировки. Дальше тот же подход — контур за контуром, по порядку в реестре. Не переписывать все тесты бека одним заходом. Нарезку сценариев следующего контура не делать заранее: сначала разбор, когда контур берём в работу.

Цель​

Сделать интеграционные тесты бека понятными при падении, устойчивыми к мелким правкам ответа и пригодными как эталон для следующих контуров. Эталон снят с задач процесса заказа покупателя; корректировки уже переписаны тем же подходом. Остальные контуры — отдельно, в согласованном порядке.

Не меняем продуктовую логику. Меняем как фиксируем поведение системы.

Идея «проверить систему так, как с ней работает пользователь» остаётся. Отказ от пользовательских сценариев не планируется.

Для кого​

КтоЗачем документ
ЗаказчикПонять подход, плюсы/минусы, что меняется и что нет
Разработчики на ревьюОдинаковые критерии: что принять, что вернуть на доработку
Агент при реализацииНе импровизировать нарезку: сначала этот файл, потом код

При сомнении «этот сценарий сюда или в соседний тест» — смотреть разделы Как должно быть и Правило нарезки. Не плодить новый стиль «на всякий случай».

Контекст (как сейчас)​

Интеграционные тесты бека ходят в систему как клиент: логин, роли, создание данных, смена статусов задач, проверки ответов. Это правильный уровень для процесса: пользователь закрыл задачу → система создала следующую и сменила состояние заказа.

На практике накопилось другое:

  • Один тест часто смешивает сквозной путь, валидации («нельзя без товаров / цены / ссылки») и снимок почти всего ответа.
  • Самый большой пример — процесс заказа покупателя через задачи: внутри одного сценария спрятаны десятки отдельных вопросов.
  • Подготовка данных копируется (сотрудники, наша организация, заказ). Тестовые сюиты вызывают друг друга как заготовки.
  • Тесты делят одну базу. Часть проверок завязана на глобальные счётчики и «в списке ровно эти строки» — это хрупко, если гонять сюиты вместе.
  • Случайные данные затрудняют повтор падения.
  • Контуры задач и корректировок разобраны и переписаны. Следующий к разбору — заказ покупателя вне задач (карточка, товары, документы). Платежи, изделия и прочее — позже, не смешивать с карточкой заказа.
  • Есть экраны и действия, которые не покрыты тестами. Их полная инвентаризация — не цель каждого контура: пробелы берём только внутри текущего.

Падение такого теста плохо отвечает на вопрос «что сломалось для пользователя». Добавлять новые сценарии в том же стиле будет всё дороже.

Как должно быть​

Два слоя, не выбор одного​

  1. Сквозной путь — пользователь проходит живой процесс до конца (для заказа: от первой задачи до сопровождения и завершённого заказа). Таких тестов мало: один–два на процесс. Проверяют, что цепочка жива, а не все поля каждого ответа.
  2. Сценарий одной задачи или одного действия — тот же вход через систему, но один вопрос: нельзя закрыть шаг без товаров; после расчёта суммы следующая задача у менеджера; смена сопровождающего меняет исполнителя. Валидации статусов живут здесь, не внутри сквозного пути.
  3. Пробелы — отдельные сценарии на то, чего сейчас нет в тестах. Сначала приоритет (риск для процесса), потом покрытие. Не цель «покрыть все эндпоинты ради списка».

Точечные проверки домена без HTTP (правила переходов статусов сами по себе) — дополнение там, где правило уже ясно и гонять весь заказ каждый раз дорого. Они не заменяют пользовательские интеграционные сценарии.

Что проверяем в сценарии​

Проверяем исход для пользователя и процесса:

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

Не проверяем в каждом шаге процесса:

  • полный снимок строки списка / карточки (все поля ответа);
  • сквозной номер задачи по всей базе;
  • «в таблице ровно N строк», если выборка не ограничена текущим пользователем или текущим процессом;
  • случайные значения там, где достаточно фиксированных;
  • выключенные и устаревшие ветки процесса (пока их нет в живом пути).

Контракт списка и карточки (какие поля отдаём) — один–два теста на сущность, не на каждом шаге заказа.

Объёмные данные (несколько изделий, магниты) — только если сам вопрос про объём: «на каждое изделие создался заказ на производство». Для сквозного дыма достаточно минимума, с которым процесс вообще идёт.

Правило нарезки​

Единица валидации — задача процесса (или одно пользовательское действие в другом контуре), не «каждое поле × каждый статус».

На одной задаче пользователь несколько раз жмёт «дальше» без данных. Это один сценарий: пройти плохие переходы статусов этой задачи, затем заполнить минимум и пройти. Не плодить Fact на каждое поле.

Отдельный сценарий, только если:

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

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

Как компоновать​

Не один огромный набор «всё про задачи». Группы:

ГруппаЧто внутри
Сквозной путь процессаОдин–два дымовых сценария
Одна задача процессаВалидации этой задачи + редкие регрессы по ней
Другой контурТо же после анализа: платежи, изделия, склад…

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

Пока тесты делят одну базу — не гонять классы параллельно. Изоляция сценария — новые пользователи и поиск «моей» задачи по типу, а не глобальные счётчики. Отдельную базу-контейнер не внедряем.

Как идти по контуру​

  1. Разбор: что видит пользователь, что смешано в старых крупных сценариях.
  2. Нарезка в чате (дым + сценарии «один вопрос»). Не копировать структуру файлов задач на другой контур.
  3. Общая заготовка контура. Сквозной путь и валидации зовут её же.
  4. Дым → отдельные сценарии → прогон новой сюиты и уже переписанного живого пути заказа.
  5. Старые крупные сценарии не удалять, пока новый контур не зелёный и не принят на ревью.

Не переписывать «все тесты бека» одним заходом.

Реестр контуров​

Статус обновлять по мере разбора. «Не разобран» — нельзя слепо копировать нарезку задач: сначала тот же анализ.

КонтурСтатусЗаметка
Задачи процесса заказа покупателяПереписан (эталон)Сквозной живой путь + валидации по задачам. Ветка чертежа и устаревшее назначение сопровождающего — не в дыме
Корректировки задачПереписанОтдельные сквозные: приняли / отклонили; не смешивать со дымом основного пути
Заказ покупателя вне задач (карточка, товары, документы)СледующийЕсть старые тесты; нарезку не копировать с задач без разбора. Не тащить сюда оплаты, партнёров, заказ на производство
Платежи, счета, план оплат, банковские выгрузкиНе разобранПосле карточки заказа. Отдельный контур, высокий риск
Изделия и номенклатура складаНе разобранПосле оплат. Другой процесс, не путать с заказом покупателя
Склад (остальное)Не разобранВ т.ч. заказ на производство и синхронизация Google по нему
Сотрудники, пользователи, праваНе разобран
Прочие экраны и справочникиНе разобранКонтрагенты и словари — не «заказ вне задач»
Не покрыто тестамиНе инвентаризировано целикомПробелы — только внутри текущего контура

Трекер и фронтовые тесты не входят. Полный разбор всех контуров заранее не делаем: отличаются сильно; путаница. Порядок в таблице — согласованный план, не детальная нарезка сценариев.

Как выглядит эталон на задачах заказа​

Не дублировать здесь построчный разбор кода. Смысл:

Оставить один сквозной путь живого заказа (после предоплаты и согласования) до сопровождения и состояния «завершён». Шаги только ведут процесс: минимум данных → закрыть задачу → следующая задача у нужного человека / нужное состояние заказа.

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

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

Типичный объём валидаций живого пути: примерно один сценарий на тип задачи (все плохие переходы статусов внутри него) плюс редкие регрессы. Не десятки тестов на каждое поле.

Как выглядит эталон на корректировках​

Единица вопроса — действие (создать запрос, принять, отклонить, пропустить, продолжить), не тип задачи процесса.

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

Следующие контуры повторяют правила этого файла, а не структуру файлов задач. Детальную нарезку сценариев писать когда контур берём в работу.

Плюсы и минусы​

Плюсы​

  • Падение указывает на конкретный вопрос (нет товаров / нет оплаты / сломалась цепочка), а не на «что-то в середине длинного прохода».
  • Сквозной путь остаётся страховкой, что процесс целиком жив.
  • Новый функционал добавляется понятным сценарием, а не ещё одним блоком в гигантский тест.
  • Ревью единообразное: документ задаёт, что считать хорошим тестом.
  • Пробелы покрытия становятся видимыми (реестр), а не «потом когда-нибудь».

Минусы и цена​

  • Тестов по числу станет больше, чем сейчас крупных сценариев. Зато каждый короче. Без группировки по задаче/контуру ориентироваться будет так же плохо — группировка обязательна.
  • Сначала нужно вложить время в общую подготовку (заказ до задачи T). Пока её нет, нарезка только размножит копипасту.
  • Пока общая база — сюиты лучше не параллелить; полный прогон может стать не быстрее, пока не улучшим инфраструктуру.
  • Переписывание одного контура не закрывает пробелы остальных: их берём по очереди из реестра.
  • Эталон снят с задач. Следующие контуры будут отличаться; правила нарезки уточнять когда возьмём контур в работу, а не заранее десятками сценариев в этом же документе.

Чего не обещаем​

  • Не ускорение разработки фич на первом контуре: сначала медленнее из‑за переноса.
  • Не стопроцентное покрытие всех методов.
  • Не отказ от проверки валидаций: их переносят, а не выкидывают.

Принятые решения​

ТемаРешение
Пользовательские сценарииОставляем. Меняем размер вопроса и жёсткость проверки, не идею
Сквозной путьОдин–два на процесс, без валидаций и полного снимка ответа на каждом шаге
Валидации статусовОдин сценарий на задачу (все её плохие переходы), не Fact на каждое поле
Снимок всего ответаТолько в отдельных тестах контракта списка/карточки
Случайные данныеПо умолчанию фиксированные
Параллельный прогонНа общей базе — выключен
Отдельная база (контейнер)Не делаем в этом эпике. Хватает общей тестовой базы + без параллелизма + изоляция сценария по пользователю
ОбъёмЭталон — задачи и корректировки. Дальше контур за контуром по реестру, не «все тесты бека сразу»
ПорядокИнфраструктура → задачи → корректировки → заказ вне задач → платежи → изделия / склад → остальное
Следующий контурЗаказ покупателя вне задач: карточка, товары, документы. Не оплаты, не партнёры, не заказ на производство
Кто пишет / кто принимаетАгент пишет по этому документу; два разработчика ревьюят на соответствие документу и здравому смыслу процесса
Продуктовый кодНе менять «заодно», кроме явной ошибки, без которой тест нельзя честно написать — тогда отдельным решением

Порядок дальнейших работ​

Согласован 29 сентября 2026. Детальную нарезку сценариев контура 4 и далее не фиксируем здесь заранее — только границы и очередь.

Контур 4. Заказ покупателя вне задач (следующий). Карточка заказа, товары, документы и ссылки, пауза и отмена, смена ответственного / сопровождающего, если это ещё не закрыто задачами. Разделение заказа — только если всплывёт при разборе.

Не входит: счета, план оплат, выписки; контрагенты; импорт списка заказов; заказ на производство; изделия. То, что уже есть в сценариях задач (нельзя без товаров, помощник создаёт заказ, смена сопровождающего на сопровождении), не дублировать.

Старый крупный сценарий «всё про заказ» резать, не копировать. Контракт списка и карточки — один–два теста на сущность.

Контур 5. Платежи. Счета, план оплат, банковские выгрузки. Высокий риск. Нужен живой заказ, но это не карточка.

Контур 6. Изделия и номенклатура склада. Другой процесс.

Контур 7–8. Склад (остальное) и заказ на производство; затем сотрудники, контрагенты, справочники.

Изделия раньше оплат — только если явно решим взять маленький изолированный кусок.

Задачи эпика​

Задача 1. Документация. Подход к интеграционным тестам

Этот файл: правила нарезки, плюсы/минусы, реестр и порядок контуров. Нарезка сценариев — когда контур в работе, не заранее на все контуры.

Задача 2. Бек. Инфраструктура тестов

Общая подготовка данных, изоляция сценариев, запрет параллельного прогона на общей базе, заготовки отдельно от сценариев.

Задача 3. Бек. Эталон: задачи процесса заказа покупателя

Сквозной живой путь; сценарии по задачам; вынести валидации и регрессы из дыма; не включать выключенные ветки.

Задача 4. Бек. Пробелы внутри контура задач

Только то, что всплыло при переписывании задач (пропущенные живые сценарии этого контура).

Задача 5. Бек. Корректировки задач

Сквозные принятие и отклонение; отдельные действия (пропуск приёмника, принятие в работу, вложенный запрос, цепочка через «не требуется»). Не смешивать со дымом основного пути.

Задача 6. Бек. Заказ покупателя вне задач

Карточка, товары, документы. Границы — в разделе «Порядок дальнейших работ». Разбор и нарезка — перед кодом.

Критерии приёмки​

  • Документ задаёт критерии ревью: не прежний стиль «один большой сценарий на всё».
  • Для процесса заказа покупателя: есть сквозной дым живого пути; валидации задач не спрятаны внутри него; падение теста читается как вопрос пользователя.
  • Подготовка данных не копируется сюитами друг через друга; сквозной путь и валидации используют общую заготовку.
  • Сюиты на общей базе не гоняются параллельно.
  • Отдельная база-контейнер не внедрена.
  • Корректировки вынесены из дыма основного пути: сквозные принятие/отклонение и отдельные действия.
  • Контур «заказ покупателя вне задач» разобран, нарезан и переписан в том же подходе (карточка / товары / документы; без оплат и партнёров).

Вне scope​

  • Смена поведения продукта «чтобы тесты проще писались»
  • Покрытие 100% методов и экранов одним заходом
  • Тесты фронта и трекера
  • Отдельная база-контейнер на прогон (не делаем)
  • Воскрешение выключенных веток процесса в дымовом пути
  • Смешивать в контур 4 оплаты, выписки, контрагентов, заказ на производство, изделия
  • Удалять старые крупные сценарии до приёмки нового контура
  • Детальная нарезка сценариев контуров 5+ в этом файле заранее

Открытые вопросы​

  • Нужны ли точечные проверки домена без HTTP уже на эталоне задач или только если сквозные тесты станут слишком медленными?

Связанные материалы​