Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.royalratsproductions.ru/llms.txt

Use this file to discover all available pages before exploring further.

R2 и изображения реестра

Постоянные изображения реестра планируется хранить во внешнем object storage в стиле R2. На текущем этапе реализация постоянного R2-хранилища для изображений реестра в коде не заявлена.

Цель

Реестр может ссылаться на изображения записей. Для долгосрочного использования такие изображения не должны зависеть от временных ссылок или ручного копирования URL. Планируемый подход:
  • изображение хранится как объект в object storage;
  • база хранит только метаданные и ссылку на объект;
  • SQLite не хранит binary blob-данные изображений;
  • постоянные изображения отделяются от временного cache;
  • удаление или архивирование записи не должно случайно удалять объект без явного lifecycle-правила.

Метаданные

В базе должны храниться только необходимые сведения:
  • идентификатор объекта;
  • публичная или подписанная ссылка, если она нужна UI;
  • тип файла;
  • размер;
  • время загрузки;
  • владелец или связанная запись;
  • статус lifecycle.

Постоянные ассеты и cache

Постоянный asset — это изображение, которое является частью записи реестра и должно переживать рестарты, миграции и обновления UI. Cache — это временная копия или preview, которую можно пересоздать. Cache не должен быть единственным источником изображения.

Ограничения текущего этапа

Пока R2-путь не реализован, документация не должна обещать загрузку, миграцию или автоматическое хранение изображений в R2. Текущие пользовательские поверхности могут работать с URL изображений, если это поддержано конкретным модулем.