iu
7ae9bcf305
- move change media-object-layer to openspec/changes/archive/2026-10-10-media-object-layer - add main spec specs/media-objects (opaque keys, object journal, shared objects, reference-based GC, lifecycle recovery, variant generation queue) - update specs/photos deletion requirement to place photos in the trash without deleting storage objects
50 lines
3.5 KiB
Markdown
50 lines
3.5 KiB
Markdown
# Proposal
|
|
|
|
## Why
|
|
|
|
Слой хранения S3 сейчас знает о сущности «альбом»: ключи объектов имеют вид
|
|
`albums/{album_id}/original/{photo_id}.{ext}` (`photos/service.go:72,114,115`).
|
|
Это протекание модели метаданных в физический слой: перенос фото оставляет ключ в
|
|
старом namespace, копия делит объекты под префиксом исходного альбома, а
|
|
неиспользуемый `DeletePrefix` (`storage/storage.go:107`) создаёт латентный риск
|
|
удаления живых объектов. Нужно развести слои: S3 хранит непрозрачные объекты, а
|
|
сущности и их жизненный цикл живут в БД.
|
|
|
|
## What Changes
|
|
|
|
- Ввести таблицу `objects` — физические блобы (ключ, mime, размер, габариты,
|
|
checksum, состояние) и `photo_objects` — связка photo↔object с ролью
|
|
(`original|thumb|preview`).
|
|
- **BREAKING**: удалить `storage_key`, `thumb_key`, `preview_key` из `photos`;
|
|
ключи фото выводятся через джойн к объекту-оригиналу. Миграция разрушительная
|
|
(в базе только дев-данные).
|
|
- Сделать ключи S3 album-free: `objects/{id}/{role}.{ext}`, где `id` — случайный
|
|
идентификатор объекта.
|
|
- Ввести явный GC через ledger-состояния объектов `pending | ready | deleting`:
|
|
физический объект удаляется только когда на него не осталось ни одной связки.
|
|
- Перенести генерацию вариантов в фоновый воркер: таблица `variant_jobs`
|
|
(ровно-один-раз, ретраи с backoff), воркер также удаляет осиротевшие объекты и
|
|
досасывает зависшие `pending`. SSE `photo.created` публикует воркер.
|
|
- Удалить `DeletePrefix` из клиента хранения — entity-namespace больше нет.
|
|
|
|
## Capabilities
|
|
|
|
### New Capabilities
|
|
- `media-objects`: физическое объектное хранилище с непрозрачными ключами, журнал
|
|
объектов и их жизненный цикл, сборка мусора по отсутствию ссылок, привязка
|
|
объектов к фото по ролям.
|
|
|
|
### Modified Capabilities
|
|
- `photos`: уточняется семантика удаления (корзина не удаляет объекты хранилища) и
|
|
разделение объектов между фото при переносе и копировании.
|
|
|
|
## Impact
|
|
|
|
- Backend: `internal/photos/{service,store}.go`, `internal/storage/storage.go`,
|
|
`internal/albums/*` (косвенно, через ключи обложки), wiring фонового воркера,
|
|
`migrations/` (новая схема + удаление колонок).
|
|
- Данные: разрушительная миграция `photos` (dev-only), новые таблицы.
|
|
- Внешний JSON API не меняется: `thumb_url/preview_url/original_url` и
|
|
`size/width/height/mime_type` по-прежнему отдаются, но выводятся из объектов.
|
|
- Документация: `project.md` §10 (структура в S3).
|