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

Маршрут состоит из типа, правила и версии шаблона

ВходРешение генератора
Поддерживаемый тип и полный наборВыбрать назначенный вариант
Поддерживаемый тип, поля неполныЗапросить нужные данные
Неизвестный типОстановить выбор
Конфликтующие признакиПередать на уточнение
Старый выпускИспользовать его сохранённый выбор

Содержание вариантов утверждается ответственными за документ. Задача автоматизации — корректно выбрать и заполнить согласованный вариант, а не самостоятельно вывести новые условия из профиля клиента. Идентификатор шаблона не должен произвольно приходить от браузера: сервер сопоставляет разрешённый тип с доступным вариантом.

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

Валидация зависит от выбранной ветки

JSON Schema поддерживает условную проверку if/then/else: применяемая ветка зависит от результата if. Документация проверена 25 октября 2026 года. Это инструмент проверки данных; сам по себе он не выбирает файл шаблона и не подтверждает правильность условий документа. Маршрутизацию и проверку связывают одним согласованным контрактом.

Условный маршрут, не готовая юридическая схема:
client_type -> явное значение из разрешённого набора
routing_version -> утверждённая таблица
template -> точная версия выбранного варианта
validation -> обязательные поля этой ветки
conflict -> остановка до уточнения
release -> снимок данных и результата выбора

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

Не превращайте пустую строку, null и отсутствующее значение в один случай без решения продукта. Пользователь мог не заполнить поле, интеграция могла его не передать или явно очистить. Такое различие влияет на возможность выпуска и должно сохраняться до валидации, а не исчезать при автоматической подстановке defaults.

Матрица тестов проверяет переходы между вариантами

  1. Сгенерировать разрешённый набор для каждого типа.
  2. Удалить обязательное поле выбранной ветки.
  3. Передать неизвестный и отсутствующий тип.
  4. Создать конфликт признаков и проверить остановку.
  5. Изменить профиль после выпуска и сравнить повторное скачивание.

Для каждого теста ожидайте конкретный шаблон, поля и исход отказа. Проверяйте сам итоговый файл: правильная строка template_id в журнале не исключает старый кеш или неверный ресурс. Разные варианты должны иметь отдельные ключи кеширования, учитывающие версию и данные выпуска.

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

Для разработки подготовьте искусственные профили, таблицу выбора и ожидаемые фрагменты каждого варианта. Приёмка отвечает на конкретный вопрос: почему именно этот клиент получил именно этот шаблон по этой версии правила. Если ответ можно восстановить из записи выпуска, ошибки маршрута становятся объяснимыми и исправляются без догадок.

Проверенные источники