Files

T

iu 7ae9bcf305 chore(openspec): archive media-object-layer and sync main specs

- 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

2026-10-10 23:32:21 +03:00

3.5 KiB

Raw Blame History

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).

3.5 KiB Raw Blame History