feat(photos): separate object storage from metadata layer
Move physical file facts out of the photos table into an objects ledger:
- objects / photo_objects / variant_jobs tables (migration 000008)
- drop storage_key/thumb_key/preview_key/size/width/height/mime_type from
photos (migration 000009); they are derived via joins to the original object
- album-free storage keys: objects/{id}/{role}.{ext}
- explicit GC via pending/ready/deleting states; objects deleted only when no
photo references them
- background worker drives variant generation (durable variant_jobs) and GC
- copy/move are metadata-only; storage objects are shared between photos
- remove unused storage.DeletePrefix
Non-destructive to the external JSON API: size/dimensions/mime and URLs are
still returned, just sourced from the object layer.
OpenSpec change: media-object-layer
This commit is contained in:
@@ -0,0 +1,90 @@
|
||||
# Spec Delta
|
||||
|
||||
## Purpose
|
||||
|
||||
Физическое объектное хранилище с непрозрачными ключами и журналом объектов:
|
||||
привязка объектов к фото по ролям, совместное использование объектов несколькими
|
||||
фото и сборка мусора по отсутствию ссылок.
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Непрозрачные ключи хранилища
|
||||
Слой хранения SHALL адресоваться непрозрачными ключами объектов, не содержащими
|
||||
идентификаторов сущностей метаданных (таких как альбом или фото); сопоставление
|
||||
ключей и сущностей SHALL храниться только в слое метаданных.
|
||||
|
||||
#### Scenario: Ключ без альбома
|
||||
- **WHEN** система сохраняет объект в хранилище
|
||||
- **THEN** ключ объекта не содержит идентификатора альбома
|
||||
|
||||
#### Scenario: Перенос не трогает ключи
|
||||
- **WHEN** фото переносится в другой альбом
|
||||
- **THEN** ключи его объектов остаются неизменными
|
||||
|
||||
### Requirement: Журнал объектов
|
||||
Каждый физический объект SHALL иметь ровно одну запись в слое метаданных с ключом,
|
||||
MIME-типом, размером, габаритами и состоянием; фото SHALL ссылаться на объекты по
|
||||
ролям original, thumb и preview.
|
||||
|
||||
#### Scenario: Привязка ролей
|
||||
- **WHEN** фото загружено и обработано
|
||||
- **THEN** фото ссылается на объект-оригинал и, когда они готовы, на объекты thumb и preview
|
||||
|
||||
#### Scenario: Оригинал без вариантов
|
||||
- **WHEN** варианты ещё не сгенерированы
|
||||
- **THEN** фото доступно с оригиналом, а thumb и preview отсутствуют
|
||||
|
||||
### Requirement: Совместные объекты
|
||||
Несколько фото SHALL иметь возможность ссылаться на один и тот же физический
|
||||
объект; перенос и копирование SHALL изменять только ссылки и SHALL не изменять
|
||||
объекты хранилища.
|
||||
|
||||
#### Scenario: Копирование
|
||||
- **WHEN** пользователь копирует фото в другой альбом
|
||||
- **THEN** создаётся новая запись, ссылающаяся на те же объекты, без операций с хранилищем
|
||||
|
||||
#### Scenario: Перенос
|
||||
- **WHEN** пользователь переносит фото в другой альбом
|
||||
- **THEN** изменяется только привязка к альбому, объекты хранилища не меняются
|
||||
|
||||
### Requirement: Сборка мусора по ссылкам
|
||||
Объект хранилища SHALL удаляться только когда на него не ссылается ни одно фото;
|
||||
удаление альбома и попадание фото в корзину SHALL сохранять объекты.
|
||||
|
||||
#### Scenario: Последняя ссылка удалена
|
||||
- **WHEN** фото удаляется навсегда и больше ни одно фото не ссылается на его объекты
|
||||
- **THEN** объекты удаляются из хранилища
|
||||
|
||||
#### Scenario: Остались ссылки
|
||||
- **WHEN** на объект ссылается другое фото
|
||||
- **THEN** объект сохраняется в хранилище
|
||||
|
||||
#### Scenario: Удаление альбома
|
||||
- **WHEN** владелец удаляет альбом
|
||||
- **THEN** объекты хранилища не удаляются
|
||||
|
||||
### Requirement: Устойчивость жизненного цикла объекта
|
||||
Объект SHALL иметь состояние жизненного цикла, и незавершённые операции SHALL
|
||||
самовосстанавливаться: неудачная загрузка не оставляет осиротевших объектов, а
|
||||
удаление объекта SHALL доводиться до конца после сбоя.
|
||||
|
||||
#### Scenario: Сбой загрузки
|
||||
- **WHEN** запись объекта создана, но загрузка в хранилище не завершилась
|
||||
- **THEN** объект очищается без ручного вмешательства
|
||||
|
||||
#### Scenario: Сбой удаления
|
||||
- **WHEN** удаление объекта из хранилища не удалось
|
||||
- **THEN** попытка повторяется до успешного удаления
|
||||
|
||||
### Requirement: Генерация вариантов
|
||||
Генерация thumb и preview SHALL выполняться через надёжную очередь заданий с
|
||||
однократным выполнением и повтором при сбое; готовый результат SHALL
|
||||
транслироваться подписчикам альбома.
|
||||
|
||||
#### Scenario: Повтор после рестарта
|
||||
- **WHEN** процесс перезапускается с незавершёнными заданиями
|
||||
- **THEN** генерация вариантов продолжается
|
||||
|
||||
#### Scenario: Событие после генерации
|
||||
- **WHEN** варианты фото готовы
|
||||
- **THEN** подписчикам альбома публикуется событие с этим фото
|
||||
@@ -0,0 +1,14 @@
|
||||
# Spec Delta
|
||||
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Удаление фото
|
||||
Автор SHALL иметь возможность удалить своё фото; владелец и админ SHALL иметь возможность удалить любое фото. Удаление SHALL помещать фото в корзину и SHALL не удалять объекты хранилища.
|
||||
|
||||
#### Scenario: Удаление своего фото
|
||||
- **WHEN** автор удаляет своё фото
|
||||
- **THEN** фото помещается в корзину, а объекты хранилища сохраняются
|
||||
|
||||
#### Scenario: Удаление чужого фото участником
|
||||
- **WHEN** участник с ролью member пытается удалить чужое фото
|
||||
- **THEN** система отклоняет запрос
|
||||
Reference in New Issue
Block a user