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

Комплект имеет собственный состав

Элемент спискаЗачем он нужен
ID и версия документаВыбрать нужный выпуск
Имя внутри архиваДать понятную уникальную запись
ОбязательностьРешить, допустима ли неполнота
Размер и контрольная суммаСверить выбранные байты
Порядок и назначениеОбъяснить состав получателю

Условный комплект может содержать договор и два приложения, которые остаются отдельными файлами. Это задача упаковки, а не склейки страниц в один PDF. Если нужен единый PDF, для него отдельно проверяют порядок страниц, формы и навигацию; успешная сборка ZIP этих свойств не подтверждает.

Документация Python zipfile описывает создание и чтение ZIP, выбор имени записи через arcname и проверку содержимого методом testzip. Источник проверен 25 октября 2026 года. Проверка целостности архива не отвечает на вопрос, положили ли туда нужную версию документа: это проверяется по вашему списку.

Имена файлов не должны управлять путями сервера

Условный план комплекта:
release -> конкретный получатель и версия состава
01-main.pdf -> документ A, версия 3
02-annex-a.pdf -> приложение B, версия 2
03-annex-b.pdf -> приложение C, версия 1
missing_required -> остановить выдачу
validated -> опубликовать ссылку на этот выпуск

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

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

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

Проверка начинается после закрытия архива

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

Готовый архив публикуйте после завершения записи и проверки. При повторе запроса возвращайте тот же утверждённый выпуск или создавайте явно новую версию по правилам продукта. Текущие данные профиля не должны незаметно менять уже выданный комплект при каждом скачивании.

Ограничьте объём сборки и срок жизни временных файлов. Удаляйте только собственную рабочую область после завершения или безопасной остановки; исходные документы к этому сроку не относятся. Обычная ZIP-упаковка сама по себе не делает содержимое конфиденциальным, поэтому выдача должна оставаться в защищённом процессе доступа.

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

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