chore(openspec): archive completed changes and sync main specs

- fix-large-album-load -> photos, realtime, media-objects - fix-album-cover -> photos, albums
2026-10-11 14:16:38 +03:00
parent d7a37328f0
commit d99ac77587
17 changed files with 69 additions and 14 deletions
@@ -0,0 +1,25 @@
+# Spec Delta
+
+## MODIFIED Requirements
+
+### Requirement: Генерация вариантов
+Генерация thumb и preview SHALL выполняться через надёжную очередь заданий с
+однократным выполнением и повтором при сбое; готовый результат SHALL
+транслироваться подписчикам альбома. Очередь SHALL поддерживать настраиваемую
+пропускную способность и SHALL обрабатывать более свежие фото раньше остальных.
+
+#### Scenario: Повтор после рестарта
+- **WHEN** процесс перезапускается с незавершёнными заданиями
+- **THEN** генерация вариантов продолжается
+
+#### Scenario: Событие после генерации
+- **WHEN** варианты фото готовы
+- **THEN** подписчикам альбома публикуется событие обновления этого фото
+
+#### Scenario: Приоритет свежих фото
+- **WHEN** в очереди есть готовые к обработке задания разного возраста
+- **THEN** система обрабатывает более свежие фото раньше
+
+#### Scenario: Настраиваемая пропускная способность
+- **WHEN** задан уровень параллелизма генерации
+- **THEN** система обрабатывает варианты с этим уровнем параллелизма
@@ -0,0 +1,32 @@
+# Spec Delta
+
+## MODIFIED Requirements
+
+### Requirement: Получение фото по требованию
+Клиент SHALL иметь возможность получить актуальные данные фото с подписанным URL,
+обслуживаемым бэкендом, независимо от бэкенда хранения. Подпись SHALL быть
+детерминированной в пределах окна действия, чтобы повторные выдачи одного и того же
+объекта давали идентичный URL.
+
+#### Scenario: Выдача свежего URL
+- **WHEN** клиент запрашивает фото по id
+- **THEN** система возвращает подписанный URL бэкенда для просмотра
+
+#### Scenario: Повторная выдача совпадает
+- **WHEN** один и тот же объект запрашивается повторно в пределах окна действия подписи
+- **THEN** система возвращает идентичный URL
+
+## ADDED Requirements
+
+### Requirement: Кэширование объектов
+Доставка объектов SHALL помечать ответы как кэшируемые, чтобы браузер переиспользовал
+уже полученные превью, а повторное открытие альбома не вызывало повторную загрузку
+неизменившихся объектов.
+
+#### Scenario: Заголовки кэширования
+- **WHEN** клиент получает объект (оригинал, превью или thumb) по подписанному URL
+- **THEN** ответ содержит заголовок кэширования с ограниченным сроком годности
+
+#### Scenario: Повторный показ без перезагрузки
+- **WHEN** сетка превью перерисовывается, а URL объектов не изменились
+- **THEN** браузер отдаёт объекты из кэша без повторного запроса к бэкенду
@@ -0,0 +1,31 @@
+# Spec Delta
+
+## MODIFIED Requirements
+
+### Requirement: События альбома
+Система SHALL публиковать события photo.created, photo.updated, photo.deleted,
+comment.created, like.added, like.removed, member.joined, member.left, album.updated.
+Событие photo.created SHALL обозначать появление фото в альбоме, а готовность вариантов
+существующего фото SHALL публиковаться как photo.updated.
+
+#### Scenario: Новое фото
+- **WHEN** в альбоме появляется фото
+- **THEN** подписчики получают событие photo.created с метаданными и URL превью
+
+#### Scenario: Готовы варианты
+- **WHEN** для существующего фото сгенерированы thumb и preview
+- **THEN** подписчики получают событие photo.updated с этим фото
+
+## ADDED Requirements
+
+### Requirement: Различение добавления и обновления фото
+Клиент SHALL различать добавление нового фото в альбом и обновление уже показанного:
+обновление SHALL изменять фото на месте, не меняя порядок сетки.
+
+#### Scenario: Обновление отображаемого фото
+- **WHEN** приходит событие обновления для фото, которое уже показано
+- **THEN** клиент обновляет его на месте, порядок сетки не меняется
+
+#### Scenario: Обновление отсутствующего фото
+- **WHEN** приходит событие обновления для фото, которого нет в текущем списке
+- **THEN** клиент не добавляет его в сетку