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

Версия охватывает больше одного DOCX

Часть комплектаЧто требуется закрепить
ШаблонФайл и его контрольное значение
Схема данныхОжидаемые поля и правила отображения
РесурсыШрифты, изображения и вложенные фрагменты
ДвижокВерсию генератора и конвертера
РезультатОтдельный сохранённый артефакт

Если логотип загружается по изменяемому URL, старый DOCX ещё не даёт воспроизводимость. То же относится к общим текстовым блокам и стилям. Соберите манифест зависимостей версии: какие ресурсы входят в выпуск и как проверяется их целостность. Отсутствующий ресурс должен останавливать генерацию, а не незаметно заменяться сегодняшним.

Условный манифест:
template_release = contract-v7
template_hash = контрольное значение файла
data_schema = contract-data-v3
resources = закреплённые версии изображений и шрифтов
renderer = выбранная версия окружения

job.template_release фиксируется при создании задания.
Указатель current используется только для новых заданий.

Редактирование, проверка и продвижение разделены

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

Amazon S3 Versioning сохраняет несколько версий объекта и позволяет обращаться к прежним; документация проверена 29 октября 2026 года. Это полезная защита хранилища, но приложение всё равно должно закреплять нужную версию и зависимости. Чтение только по ключу текущего объекта не делает старую генерацию автоматически воспроизводимой.

Версия шаблона и снимок бизнес-данных решают разные задачи. Старый макет с сегодняшним адресом клиента создаст новый результат. Храните допустимый снимок данных выпуска с ограничением доступа и сроком хранения по требованиям системы. Для поддержки обычно достаточно обезличенного примера и ссылок на версии; полный договор не нужен в общедоступном журнале.

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

Возврат версии не переписывает историю

  1. Создать выпуск шаблона и несколько отложенных заданий.
  2. Продвинуть новую версию до начала исполнения этих заданий.
  3. Проверить, что они используют закреплённый прежний комплект.
  4. Вернуть указатель current на проверенный выпуск.
  5. Сверить новые задания, старые артефакты и журнал продвижений.

У старой версии должна сохраняться совместимость с текущим генератором либо своё поддерживаемое окружение. Возврат только DOCX при уже изменённой схеме данных может снова сломать выпуск. Перед продвижением храните контрольные примеры: длинные названия, отсутствующие необязательные поля, таблицы и приложения.

Для внедрения подготовьте реестр выпусков, манифест зависимостей и правила выбора current. Приёмка отвечает на вопрос: можно ли по одному документу назвать его шаблон, входной снимок, окружение и сохранённый результат? Если хотя бы одна часть определяется как «то, что сейчас лежит в папке», версионирование ещё не завершено.

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