Каждый выпуск документа связывайте с конкретной неизменяемой версией шаблона. Ссылка «текущий шаблон» удобна для выбора новых заданий, но не объясняет, из чего получился вчерашний договор. Сохраните версию в задании до постановки в очередь, чтобы задержка запуска не подменила макет.
Версия охватывает больше одного 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 рассматривайте как самостоятельный результат. Даже при закреплённых ресурсах повторная конвертация в другой среде может изменить переносы и расположение элементов. Если нужен точный прежний файл, отдавайте сохранённый артефакт, проверяя доступ. Повторную генерацию оформляйте отдельной операцией с понятным основанием.
Возврат версии не переписывает историю
- Создать выпуск шаблона и несколько отложенных заданий.
- Продвинуть новую версию до начала исполнения этих заданий.
- Проверить, что они используют закреплённый прежний комплект.
- Вернуть указатель current на проверенный выпуск.
- Сверить новые задания, старые артефакты и журнал продвижений.
У старой версии должна сохраняться совместимость с текущим генератором либо своё поддерживаемое окружение. Возврат только DOCX при уже изменённой схеме данных может снова сломать выпуск. Перед продвижением храните контрольные примеры: длинные названия, отсутствующие необязательные поля, таблицы и приложения.
Для внедрения подготовьте реестр выпусков, манифест зависимостей и правила выбора current. Приёмка отвечает на вопрос: можно ли по одному документу назвать его шаблон, входной снимок, окружение и сохранённый результат? Если хотя бы одна часть определяется как «то, что сейчас лежит в папке», версионирование ещё не завершено.