2026-09-04 — Подход к интеграционным тестам бека
Статус: В работе
Источник: Олег
Эпик: ITR-2944
Документ — договорённость, на которую опираемся при переписывании тестов. Код пишет агент, проверяют два разработчика.
Эталон готов: живой путь задач заказа покупателя и корректировки. Дальше тот же подход — контур за контуром, по порядку в реестре. Не переписывать все тесты бека одним заходом. Нарезку сценариев следующего контура не делать заранее: сначала разбор, когда контур берём в работу.
Цель
Сделать интеграционные тесты бека понятными при падении, устойчивыми к мелким правкам ответа и пригодными как эталон для следующих контуров. Эталон снят с задач процесса заказа покупателя; корректировки уже переписаны тем же подходом. Остальные контуры — отдельно, в согласованном порядке.
Не меняем продуктовую логику. Меняем как фиксируем поведение системы.
Идея «проверить систему так, как с ней работает пользователь» остаётся. Отказ от пользовательских сценариев не планируется.
Для кого
| Кто | Зачем документ |
|---|---|
| Заказчик | Понять подход, плюсы/минусы, что меняется и что нет |
| Разработчики на ревью | Одинаковые критерии: что принять, что вернуть на доработку |
| Агент при реализации | Не импровизировать нарезку: сначала этот файл, потом код |
При сомнении «этот сценарий сюда или в соседний тест» — смотреть разделы Как должно быть и Правило нарезки. Не плодить новый стиль «на всякий случай».
Контекст (как сейчас)
Интеграционные тесты бека ходят в систему как клиент: логин, роли, создание данных, смена статусов задач, проверки ответов. Это правильный уровень для процесса: пользователь закрыл задачу → система создала следующую и сменила состояние заказа.
На практике накопилось другое:
- Один тест часто смешивает сквозной путь, валидации («нельзя без товаров / цены / ссылки») и снимок почти всего ответа.
- Самый большой пример — процесс заказа покупателя через задачи: внутри одного сценария спрятаны десятки отдельных вопросов.
- Подготовка данных копируется (сотрудники, наша организация, заказ). Тестовые сюиты вызывают друг друга как заготовки.
- Тесты делят одну базу. Часть проверок завязана на глобальные счётчики и «в списке ровно эти строки» — это хрупко, если гонять сюиты вместе.
- Случайные данные затрудняют повтор падения.
- Контуры задач и корректировок разобраны и переписаны. Следующий к разбору — заказ покупателя вне задач (карточка, товары, документы). Платежи, изделия и прочее — позже, не смешивать с карточкой заказа.
- Есть экраны и действия, которые не покрыты тестами. Их полная инвентаризация — не цель каждого контура: пробелы берём только внутри текущего.
Падение такого теста плохо отвечает на вопрос «что сломалось для пользователя». Добавлять новые сценарии в том же стиле будет всё дороже.
Как должно быть
Два слоя, не выбор одного
- Сквозной путь — пользователь проходит живой процесс до конца (для заказа: от первой задачи до сопровождения и завершённого заказа). Таких тестов мало: один–два на процесс. Проверяют, что цепочка жива, а не все поля каждого ответа.
- Сценарий одной задачи или одного действия — тот же вход через систему, но один вопрос: нельзя закрыть шаг без товаров; после расчёта суммы следующая задача у менеджера; смена сопровождающего меняет исполнителя. Валидации статусов живут здесь, не внутри сквозного пути.
- Пробелы — отдельные сценарии на то, чего сейчас нет в тестах. Сначала приоритет (риск для процесса), потом покрытие. Не цель «покрыть все эндпоинты ради списка».
Точечные проверки домена без HTTP (правила переходов статусов сами по себе) — дополнение там, где правило уже ясно и гонять весь заказ каждый раз дорого. Они не заменяют пользовательские интеграционные сценарии.
Что проверяем в сценарии
Проверяем исход для пользователя и процесса:
- появилась нужная задача у нужной роли;
- статус и состояние заказа (или другой сущности) такие, как задумано;
- система не пускает дальше и говорит понятную ошибку;
- побочный эффект, ради которого сценарий писали (заказы на производство по изделиям, исполнитель после смены сопровождающего).
Не проверяем в каждом шаге процесса:
- полный снимок строки списка / карточки (все поля ответа);
- сквозной номер задачи по всей базе;
- «в таблице ровно N строк», если выборка не ограничена текущим пользователем или текущим процессом;
- случайные значения там, где достаточно фиксированных;
- выключенные и устаревшие ветки процесса (пока их нет в живом пути).
Контракт списка и карточки (какие поля отдаём) — один–два теста на сущность, не на каждом шаге заказа.
Объёмные данные (несколько изделий, магниты) — только если сам вопрос про объём: «на каждое изделие создался заказ на производство». Для сквозного дыма достаточно минимума, с которым процесс вообще идёт.
Правило нарезки
Единица валидации — задача процесса (или одно пользовательское действие в другом контуре), не «каждое поле × каждый статус».
На одной задаче пользователь несколько раз жмёт «дальше» без данных. Это один сценарий: пройти плохие переходы статусов этой задачи, затем заполнить минимум и пройти. Не плодить Fact на каждое поле.
Отдельный сценарий, только если:
- другой исполнитель или другой сетап;
- другой смысл (регресс «ответственный не сбросился» — не то же самое, что «нельзя без товаров»);
- тест перестаёт читаться с одного экрана.
Имена тестов — вопрос пользователя, не технический метод: «нельзя завершить без товаров», «блокирует, пока не заполнены обязательные данные».
Как компоновать
Не один огромный набор «всё про задачи». Группы:
| Группа | Что внутри |
|---|---|
| Сквозной путь процесса | Один–два дымовых сценария |
| Одна задача процесса | Валидации этой задачи + редкие регрессы по ней |
| Другой контур | То же после анализа: платежи, изделия, склад… |
Подготовка данных — общая на контур: «заказ только что создан», «процесс доведён до задачи T». Сквозной путь и валидации зовут одну и ту же подготовку. Сюита заказов не должна быть фабрикой данных для сюиты задач: заготовки живут отдельно от сценариев.
Пока тесты делят одну базу — не гонять классы параллельно. Изоляция сценария — новые пользователи и поиск «моей» задачи по типу, а не глобальные счётчики. Отдельную базу-контейнер не внедряем.
Как идти по контуру
- Разбор: что видит пользователь, что смешано в старых крупных сценариях.
- Нарезка в чате (дым + сценарии «один вопрос»). Не копировать структуру файлов задач на другой контур.
- Общая заготовка контура. Сквозной путь и валидации зовут её же.
- Дым → отдельные сценарии → прогон новой сюиты и уже переписанного живого пути заказа.
- Старые крупные сценарии не удалять, пока новый контур не зелёный и не принят на ревью.
Не переписывать «все тесты бека» одним заходом.
Реестр контуров
Статус обновлять по мере разбора. «Не разобран» — нельзя слепо копировать нарезку задач: сначала тот же анализ.
| Контур | Статус | Заметка |
|---|---|---|
| Задачи процесса заказа покупателя | Переписан (эталон) | Сквозной живой путь + валидации по задачам. Ветка чертежа и устаревшее назначение сопровождающего — не в дыме |
| Корректировки задач | Переписан | Отдельные сквозные: приняли / отклонили; не смешивать со дымом основного пути |
| Заказ покупателя вне задач (карточка, товары, документы) | Следующий | Есть старые тесты; нарезку не копировать с задач без разбора. Не тащить сюда оплаты, партнёров, заказ на производство |
| Платежи, счета, план оплат, банковские выгрузки | Не разобран | После карточки заказа. Отдельный контур, высокий риск |
| Изделия и номенклатура склада | Не разобран | После оплат. Другой процесс, не путать с заказом покупателя |
| Склад (остальное) | Не разобран | В т.ч. заказ на производство и синхронизация Google по нему |
| Сотрудники, пользователи, права | Не разобран | |
| Прочие экраны и справочники | Не разобран | Контрагенты и словари — не «заказ вне задач» |
| Не покрыто тестами | Не инвентаризировано целиком | Пробелы — только внутри текущего контура |
Трекер и фронтовые тесты не входят. Полный разбор всех контуров заранее не делаем: отличаются сильно; путаница. Порядок в таблице — согласованный план, не детальная нарезка сценариев.
Как выглядит эталон на задачах заказа
Не дублировать здесь построчный разбор кода. Смысл:
Оставить один сквозной путь живого заказа (после предоплаты и согласования) до сопровождения и состояния «завершён». Шаги только ведут процесс: минимум данных → закрыть задачу → следующая задача у нужного человека / нужное состояние заказа.
Вынести в сценарии задач то, что сейчас спрятано внутри пути: ошибки обязательных полей на каждой задаче; «ответственный не сбросился»; смена сопровождающего; «производственные заказы только на изделия».
Не тащить в дым выключенную ветку чертежа и устаревший шаг назначения сопровождающего.
Типичный объём валидаций живого пути: примерно один сценарий на тип задачи (все плохие переходы статусов внутри него) плюс редкие регрессы. Не десятки тестов на каждое поле.
Как выглядит эталон на корректировках
Единица вопроса — действие (создать запрос, принять, отклонить, пропустить, продолжить), не тип задачи процесса.
Мало сквозных: приняли до источника и закрыли запрос; отклонили и закрыли запрос. Отдельно: нельзя пропустить приёмник; принять только в статус «в работе»; вложенный запрос — активен последний; цепочка через «не требуется» / пропуск согласования — один сценарий, не обход всех этапов подряд.
Следующие контуры повторяют правила этого файла, а не структуру файлов задач. Детальную нарезку сценариев писать когда контур берём в работу.
Плюсы и минусы
Плюсы
- Падение указывает на конкретный вопрос (нет товаров / нет оплаты / сломалась цепочка), а не на «что-то в середине длинного прохода».
- Сквозной путь остаётся страховкой, что процесс целиком жив.
- Новый функционал добавляется понятным сценарием, а не ещё одним блоком в гигантский тест.
- Ревью единообразное: документ задаёт, что считать хорошим тестом.
- Пробелы покрытия становятся видимыми (реестр), а не «потом когда-нибудь».
Минусы и цена
- Тестов по числу станет больше, чем сейчас крупных сценариев. Зато каждый короче. Без группировки по задаче/контуру ориентироваться будет так же плохо — группировка обязательна.
- Сначала нужно вложить время в общую подготовку (заказ до задачи T). Пока её нет, нарезка только размножит копипасту.
- Пока общая база — сюиты лучше не параллелить; полный прогон может стать не быстрее, пока не улучшим инфраструктуру.
- Переписывание одного контура не закрывает пробелы остальных: их берём по очереди из реестра.
- Эталон снят с задач. Следующие контуры будут отличаться; правила нарезки уточнять когда возьмём контур в работу, а не заранее десятками сценариев в этом же документе.
Чего не обещаем
- Не ускорение разработки фич на первом контуре: сначала медленнее из‑за переноса.
- Не стопроцентное покрытие всех методов.
- Не отказ от проверки валидаций: их переносят, а не выкидывают.
Принятые решения
| Тема | Решение |
|---|---|
| Пользовательские сценарии | Оставляем. Меняем размер вопроса и жёсткость проверки, не идею |
| Сквозной путь | Один–два на процесс, без валидаций и полного снимка ответа на каждом шаге |
| Валидации статусов | Один сценарий на задачу (все её плохие переходы), не Fact на каждое поле |
| Снимок всего ответа | Только в отдельных тестах контракта списка/карточки |
| Случайные данные | По умолчанию фиксированные |
| Параллельный прогон | На общей базе — выключен |
| Отдельная база (контейнер) | Не делаем в этом эпике. Хватает общей тестовой базы + без параллелизма + изоляция сценария по пользователю |
| Объём | Эталон — задачи и корректировки. Дальше контур за контуром по реестру, не «все тесты бека сразу» |
| Порядок | Инфраструктура → задачи → корректировки → заказ вне задач → платежи → изделия / склад → остальное |
| Следующий контур | Заказ покупателя вне задач: карточка, товары, документы. Не оплаты, не партнёры, не заказ на производство |
| Кто пишет / кто принимает | Агент пишет по этому документу; два разработчика ревьюят на соответствие документу и здравому смыслу процесса |
| Продуктовый код | Не менять «заодно», кроме явной ошибки, без которой тест нельзя честно написать — тогда отдельным решением |
Порядок дальнейших работ
Согласован 29 сентября 2026. Детальную нарезку сценариев контура 4 и далее не фиксируем здесь заранее — только границы и очередь.
Контур 4. Заказ покупателя вне задач (следующий). Карточка заказа, товары, документы и ссылки, пауза и отмена, смена ответственного / сопровождающего, если это ещё не закрыто задачами. Разделение заказа — только если всплывёт при разборе.
Не входит: счета, план оплат, выписки; контрагенты; импорт списка заказов; заказ на производство; изделия. То, что уже есть в сценариях задач (нельзя без товаров, помощник создаёт заказ, смена сопровождающего на сопровождении), не дублировать.
Старый крупный сценарий «всё про заказ» резать, не копировать. Контракт списка и карточки — один–два теста на сущность.
Контур 5. Платежи. Счета, план оплат, банковские выгрузки. Высокий риск. Нужен живой заказ, но это не карточка.
Контур 6. Изделия и номенклатура склада. Другой процесс.
Контур 7–8. Склад (остальное) и заказ на производство; затем сотрудники, контрагенты, справочники.
Изделия раньше оплат — только если явно решим взять маленький изолированный кусок.
Задачи эпика
Задача 1. Документация. Подход к интеграционным тестам
Этот файл: правила нарезки, плюсы/минусы, реестр и порядок контуров. Нарезка сценариев — когда контур в работе, не заранее на все контуры.
Задача 2. Бек. Инфраструктура тестов
Общая подготовка данных, изоляция сценариев, запрет параллельного прогона на общей базе, заготовки отдельно от сценариев.
Задача 3. Бек. Эталон: задачи процесса заказа покупателя
Сквозной живой путь; сценарии по задачам; вынести валидации и регрессы из дыма; не включать выключенные ветки.
Задача 4. Бек. Пробелы внутри контура задач
Только то, что всплыло при переписывании задач (пропущенные живые сценарии этого контура).
Задача 5. Бек. Корректировки задач
Сквозные принятие и отклонение; отдельные действия (пропуск приёмника, принятие в работу, вложенный запрос, цепочка через «не требуется»). Не смешивать со дымом основного пути.
Задача 6. Бек. Заказ покупателя вне задач
Карточка, товары, документы. Границы — в разделе «Порядок дальнейших работ». Разбор и нарезка — перед кодом.
Критерии приёмки
- Документ задаёт критерии ревью: не прежний стиль «один большой сценарий на всё».
- Для процесса заказа покупателя: есть сквозной дым живого пути; валидации задач не спрятаны внутри него; падение теста читается как вопрос пользователя.
- Подготовка данных не копируется сюитами друг через друга; сквозной путь и валидации используют общую заготовку.
- Сюиты на общей базе не гоняются параллельно.
- Отдельная база-контейнер не внедрена.
- Корректировки вынесены из дыма основного пути: сквозные принятие/отклонение и отдельные действия.
- Контур «заказ покупателя вне задач» разобран, нарезан и переписан в том же подходе (карточка / товары / документы; без оплат и партнёров).
Вне scope
- Смена поведения продукта «чтобы тесты проще писались»
- Покрытие 100% методов и экранов одним заходом
- Тесты фронта и трекера
- Отдельная база-контейнер на прогон (не делаем)
- Воскрешение выключенных веток процесса в дымовом пути
- Смешивать в контур 4 оплаты, выписки, контрагентов, заказ на производство, изделия
- Удалять старые крупные сценарии до приёмки нового контура
- Детальная нарезка сценариев контуров 5+ в этом файле заранее
Открытые вопросы
- Нужны ли точечные проверки домена без HTTP уже на эталоне задач или только если сквозные тесты станут слишком медленными?
Связанные материалы
- Карта системы
- Процесс заказа покупателя
- Аудит процесса (ориентир, сверять с кодом): process-audit.md