Создайте явный признак типа клиента и таблицу соответствия утверждённым вариантам шаблона. Не угадывайте тип по наличию одного реквизита или длине названия. Если признаки противоречат друг другу, генерация должна остановиться с понятной задачей уточнения, а не выдать первый доступный договор.
Маршрут состоит из типа, правила и версии шаблона
| Вход | Решение генератора |
|---|---|
| Поддерживаемый тип и полный набор | Выбрать назначенный вариант |
| Поддерживаемый тип, поля неполны | Запросить нужные данные |
| Неизвестный тип | Остановить выбор |
| Конфликтующие признаки | Передать на уточнение |
| Старый выпуск | Использовать его сохранённый выбор |
Содержание вариантов утверждается ответственными за документ. Задача автоматизации — корректно выбрать и заполнить согласованный вариант, а не самостоятельно вывести новые условия из профиля клиента. Идентификатор шаблона не должен произвольно приходить от браузера: сервер сопоставляет разрешённый тип с доступным вариантом.
Сохраняйте вместе с выпуском исходный тип, версию правила выбора и версию шаблона. После исправления профиля повторное скачивание старого документа не должно незаметно превращать его в другой вариант. Новый выпуск — отдельная операция с понятным основанием, а не побочный эффект просмотра.
Валидация зависит от выбранной ветки
JSON Schema поддерживает условную проверку if/then/else: применяемая ветка зависит от результата if. Документация проверена 25 октября 2026 года. Это инструмент проверки данных; сам по себе он не выбирает файл шаблона и не подтверждает правильность условий документа. Маршрутизацию и проверку связывают одним согласованным контрактом.
Условный маршрут, не готовая юридическая схема:
client_type -> явное значение из разрешённого набора
routing_version -> утверждённая таблица
template -> точная версия выбранного варианта
validation -> обязательные поля этой ветки
conflict -> остановка до уточнения
release -> снимок данных и результата выбораПроверяйте присутствие самого признака типа. Условие, которое смотрит только properties без требования поля, может вести себя иначе при его отсутствии. Не полагайтесь на визуальную обязательность выпадающего списка: сервер получает и прямые запросы. Ошибка должна называть проблемное поле и шаг, не раскрывая чужие данные.
Не превращайте пустую строку, null и отсутствующее значение в один случай без решения продукта. Пользователь мог не заполнить поле, интеграция могла его не передать или явно очистить. Такое различие влияет на возможность выпуска и должно сохраняться до валидации, а не исчезать при автоматической подстановке defaults.
Матрица тестов проверяет переходы между вариантами
- Сгенерировать разрешённый набор для каждого типа.
- Удалить обязательное поле выбранной ветки.
- Передать неизвестный и отсутствующий тип.
- Создать конфликт признаков и проверить остановку.
- Изменить профиль после выпуска и сравнить повторное скачивание.
Для каждого теста ожидайте конкретный шаблон, поля и исход отказа. Проверяйте сам итоговый файл: правильная строка template_id в журнале не исключает старый кеш или неверный ресурс. Разные варианты должны иметь отдельные ключи кеширования, учитывающие версию и данные выпуска.
При добавлении нового типа сначала расширьте матрицу и утвердите вариант, затем включайте маршрут. Откат правила должен сохранять доступ к прежним выпускам и не пересобирать их по новой ветке. Смешение старой и новой схемы проверяйте на границе очереди, если задания могут ждать во время обновления.
Для разработки подготовьте искусственные профили, таблицу выбора и ожидаемые фрагменты каждого варианта. Приёмка отвечает на конкретный вопрос: почему именно этот клиент получил именно этот шаблон по этой версии правила. Если ответ можно восстановить из записи выпуска, ошибки маршрута становятся объяснимыми и исправляются без догадок.