---

[I128-2796] Расширить FT как постоянное хранилище вложений задач

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2796] Расширить FT как постоянное хранилище вложений задач📄 Скачать в DOCX

---

Тип	Версия	Статус	Приоритет	Исполнитель
⚙️ Новые возможности	2026.3	🔘 Завершено	Средний	Ilya Mikhaylenko

Компоненты: FT, ИРБИС 128. Модуль TemporaryFiles - Временные файлы

Завершено: 09.09.2026 07:47

1. Цель Расширить FT как системное постоянное файловое хранилище для workflow/task-сценариев и зафиксировать безопасный staging временных файлов через TemporaryFiles.

2. Контекст Промышленные формы и задачи должны поддерживать вложения: пользователь загружает файл до сохранения записи, файл проходит временное хранение, проверку и только после успешного сохранения становится постоянным объектом FT. Модуль Tasks или другой предметный модуль не должен самостоятельно владеть физическим хранением файлов.

3. Что Нужно Сделать

• Ввести или формализовать модель постоянного FTObject: file id, владелец, object reference, имя, MIME type, размер, hash, версия, storage path, статус обработки, права, retention policy и trace id.

• Зафиксировать роль TemporaryFiles как staging-слоя: upload token, draft/session binding, TTL, owner, source form, ожидаемое назначение, ограничения размера/типа и безопасное удаление.

• Реализовать stagingtostorage apply: при успешном сохранении формы временные файлы атомарно связываются с постоянной записью FT; при ошибке сохранения не должно появляться постоянных потерянных файлов.

• Реализовать attachment links между записью предметного модуля и FTObject через общий reference contract, пригодный для WorkflowScreen, WorkflowView, API, TestA и миграций.

• Реализовать проверку прав на upload, preview, download, export, delete, restore, legal hold и просмотр metadata через Security.

• Реализовать preview/download/export с безопасными именами, MIME headers, ограничением доступа и возможностью маскирования чувствительных metadata.

• Реализовать quarantine state для подозрительных или не прошедших проверку файлов; пользователь и администратор должны видеть понятный статус.

• Поддержать OCR/text extraction и indexing как отдельные состояния обработки, которые могут выполняться через Queue.

• Реализовать retention, legal hold, cleanup и backup/export policy. Retention/legal hold не должны обходиться предметным модулем.

• Предусмотреть миграцию существующих вложений VirtualRef без потери ссылок, доступности и истории.

  1. Границы Ответственности

• FT владеет постоянным хранением и metadata файлов, TemporaryFiles владеет временным staging.

• Предметные модули задают категории вложений, обязательность, политику проекта и доменные реакции, но не реализуют storage runtime.

• FT не должен знать структуру Tasks или других предметных записей, кроме универсальной ссылки на объект.

  1. Критерии Приемки

• Файл из публичной или внутренней формы сначала попадает в TemporaryFiles, а после успешного сохранения становится постоянным FTObject.

• Ошибка сохранения формы не оставляет постоянных orphan files.

• Preview/download/export проверяют права и не раскрывают файл пользователю без доступа к объекту.

• Quarantine, OCR/indexing и processing errors имеют видимые и диагностируемые состояния.

• Cleanup удаляет просроченные staging-файлы, но не нарушает legal hold и retention.

• Миграционный сценарий сохраняет доступность старых вложений VirtualRef.

  1. Проверки И Документация Нужно подготовить TestAсценарии для upload, stagingto-storage, rollback при ошибке, прав доступа, preview/download/export, quarantine, OCR/indexing state, cleanup, retention/legal hold и миграционного dataset. В Help должны быть описаны storage policies, staging, права, обработка файлов и диагностика проблем.

-

Срез по I128-2796.

Что изменено:

• добавлен нейтральный контракт FTObjectInfo/FTAttachmentLink без раскрытия физических путей;
• добавлены методы FT для безопасной файловой ссылки, 113 LINK вложения, дескриптора фоновой обработки и dry-run чтения system JSON;
• добавлен system JSON modules/FT/system/ftstoragecore.json;
• TemporaryFiles расширен как stagingслой с uploadToken, draft/session/owner binding и безопасным uploadответом;
• TemporaryFiles/UploadTemporaryFile больше не возвращает path в SID-каталоге;
• добавлены Help и TestA safe-read проверки для FT и TemporaryFiles.

Границы:

• FT владеет постоянным файловым объектом и нейтральной ссылкой вложения;
• TemporaryFiles владеет временным staging;
• Queue/Security/HealthCheck/TestA остаются внешними контрактами, без переноса их логики в FT.

Проверки:

• php -l modules/FT/api.php
• php -l modules/TemporaryFiles/api.php
• php -l modules/TemporaryFiles/Actions/UploadTemporaryFile.inc
• php -l modules/TemporaryFiles/__call/AppendFile.inc
• php -l modules/TemporaryFiles/__call/AppendFileFromForm.inc
• php -l modules/FT/Tests/Module.inc
• php -l modules/TemporaryFiles/Tests/Module.inc
• ConvertFromJson modules/FT/system/ftstorage-core.json
• TestA FT safe-read: 126/126
• TestA TemporaryFiles safe-read: 10/10
• git diff -cached -check

1. Связанные задачи

1.1. 🔗 blocks: I128-2803

1.2. 🔗 blocks: I128-2806

1.3. 🔗 blocks: I128-2810

1.4. 🔗 blocks: I128-2811

1.5. 🔗 blocks: I128-2827

1.6. 🔗 blocks: I128-2793

1.7. 🔗 blocks: I128-2795

1.8. 🔗 blocks: I128-2797