chore(openspec): archive completed changes and sync main specs
- fix-large-album-load -> photos, realtime, media-objects - fix-album-cover -> photos, albums
This commit is contained in:
@@ -54,10 +54,10 @@
|
|||||||
- **WHEN** у альбома нет обложки или фото обложки удалено
|
- **WHEN** у альбома нет обложки или фото обложки удалено
|
||||||
- **THEN** ответ не содержит URL обложки, и клиент показывает плейсхолдер
|
- **THEN** ответ не содержит URL обложки, и клиент показывает плейсхолдер
|
||||||
|
|
||||||
|
|
||||||
### Requirement: Выбор обложки
|
### Requirement: Выбор обложки
|
||||||
Владелец и админ SHALL иметь возможность назначить обложкой любое фото альбома или сбросить
|
Владелец и админ SHALL иметь возможность назначить обложкой любое фото альбома или сбросить
|
||||||
обложку; после сброса обложка определяется заново по умолчанию.
|
обложку; после сброса обложка SHALL становиться не заданной (без возврата к значению по
|
||||||
|
умолчанию).
|
||||||
|
|
||||||
#### Scenario: Назначение обложки
|
#### Scenario: Назначение обложки
|
||||||
- **WHEN** владелец выбирает фото альбома как обложку
|
- **WHEN** владелец выбирает фото альбома как обложку
|
||||||
@@ -65,13 +65,12 @@
|
|||||||
|
|
||||||
#### Scenario: Сброс обложки
|
#### Scenario: Сброс обложки
|
||||||
- **WHEN** админ сбрасывает обложку
|
- **WHEN** админ сбрасывает обложку
|
||||||
- **THEN** система удаляет явный выбор, и обложка возвращается к значению по умолчанию
|
- **THEN** система снимает обложку, и альбом отображается без обложки, пока обложку не назначат снова
|
||||||
|
|
||||||
#### Scenario: Нет прав на смену обложки
|
#### Scenario: Нет прав на смену обложки
|
||||||
- **WHEN** участник без права редактирования пытается сменить обложку
|
- **WHEN** участник без права редактирования пытается сменить обложку
|
||||||
- **THEN** система отклоняет запрос
|
- **THEN** система отклоняет запрос
|
||||||
|
|
||||||
|
|
||||||
### Requirement: Счётчики альбома
|
### Requirement: Счётчики альбома
|
||||||
Данные альбома SHALL включать количество фото и участников, чтобы панель и карточки могли
|
Данные альбома SHALL включать количество фото и участников, чтобы панель и карточки могли
|
||||||
показать их без отдельных запросов.
|
показать их без отдельных запросов.
|
||||||
|
|||||||
@@ -79,7 +79,8 @@ MIME-типом, размером, габаритами и состоянием;
|
|||||||
### Requirement: Генерация вариантов
|
### Requirement: Генерация вариантов
|
||||||
Генерация thumb и preview SHALL выполняться через надёжную очередь заданий с
|
Генерация thumb и preview SHALL выполняться через надёжную очередь заданий с
|
||||||
однократным выполнением и повтором при сбое; готовый результат SHALL
|
однократным выполнением и повтором при сбое; готовый результат SHALL
|
||||||
транслироваться подписчикам альбома.
|
транслироваться подписчикам альбома. Очередь SHALL поддерживать настраиваемую
|
||||||
|
пропускную способность и SHALL обрабатывать более свежие фото раньше остальных.
|
||||||
|
|
||||||
#### Scenario: Повтор после рестарта
|
#### Scenario: Повтор после рестарта
|
||||||
- **WHEN** процесс перезапускается с незавершёнными заданиями
|
- **WHEN** процесс перезапускается с незавершёнными заданиями
|
||||||
@@ -87,4 +88,12 @@ MIME-типом, размером, габаритами и состоянием;
|
|||||||
|
|
||||||
#### Scenario: Событие после генерации
|
#### Scenario: Событие после генерации
|
||||||
- **WHEN** варианты фото готовы
|
- **WHEN** варианты фото готовы
|
||||||
- **THEN** подписчикам альбома публикуется событие с этим фото
|
- **THEN** подписчикам альбома публикуется событие обновления этого фото
|
||||||
|
|
||||||
|
#### Scenario: Приоритет свежих фото
|
||||||
|
- **WHEN** в очереди есть готовые к обработке задания разного возраста
|
||||||
|
- **THEN** система обрабатывает более свежие фото раньше
|
||||||
|
|
||||||
|
#### Scenario: Настраиваемая пропускная способность
|
||||||
|
- **WHEN** задан уровень параллелизма генерации
|
||||||
|
- **THEN** система обрабатывает варианты с этим уровнем параллелизма
|
||||||
|
|||||||
@@ -33,11 +33,17 @@
|
|||||||
|
|
||||||
### Requirement: Получение фото по требованию
|
### Requirement: Получение фото по требованию
|
||||||
Клиент SHALL иметь возможность получить актуальные данные фото с подписанным URL,
|
Клиент SHALL иметь возможность получить актуальные данные фото с подписанным URL,
|
||||||
обслуживаемым бэкендом, независимо от бэкенда хранения.
|
обслуживаемым бэкендом, независимо от бэкенда хранения. Подпись SHALL быть
|
||||||
|
детерминированной в пределах окна действия, чтобы повторные выдачи одного и того же
|
||||||
|
объекта давали идентичный URL.
|
||||||
|
|
||||||
#### Scenario: Выдача свежего URL
|
#### Scenario: Выдача свежего URL
|
||||||
- **WHEN** клиент запрашивает фото по id
|
- **WHEN** клиент запрашивает фото по id
|
||||||
- **THEN** система возвращает свежий подписанный URL бэкенда (срок до 1 часа) для просмотра
|
- **THEN** система возвращает подписанный URL бэкенда для просмотра
|
||||||
|
|
||||||
|
#### Scenario: Повторная выдача совпадает
|
||||||
|
- **WHEN** один и тот же объект запрашивается повторно в пределах окна действия подписи
|
||||||
|
- **THEN** система возвращает идентичный URL
|
||||||
|
|
||||||
### Requirement: Скачивание одиночного фото
|
### Requirement: Скачивание одиночного фото
|
||||||
Любой участник, включая viewer, SHALL иметь возможность скачать одиночное фото.
|
Любой участник, включая viewer, SHALL иметь возможность скачать одиночное фото.
|
||||||
@@ -58,17 +64,26 @@
|
|||||||
- **THEN** система отклоняет запрос
|
- **THEN** система отклоняет запрос
|
||||||
|
|
||||||
### Requirement: Обложка по умолчанию
|
### Requirement: Обложка по умолчанию
|
||||||
При обработке загруженного фото система SHALL назначать его обложкой альбома только если
|
При загрузке фото система SHALL назначать его обложкой альбома, если обложка ещё не задана,
|
||||||
обложка ещё не задана.
|
то есть обложкой становится первое загруженное фото. Когда фото, выбранное обложкой, покидает
|
||||||
|
альбом (помещено в корзину или перенесено в другой альбом), система SHALL снять обложку.
|
||||||
|
|
||||||
#### Scenario: Первое фото
|
#### Scenario: Первое фото
|
||||||
- **WHEN** фото обработано, и у альбома нет обложки
|
- **WHEN** фото загружено, и у альбома нет обложки
|
||||||
- **THEN** система назначает это фото обложкой
|
- **THEN** система назначает это фото обложкой альбома
|
||||||
|
|
||||||
#### Scenario: Обложка уже задана
|
#### Scenario: Обложка уже задана
|
||||||
- **WHEN** фото обработано, а обложка уже задана
|
- **WHEN** фото загружено, а обложка уже задана
|
||||||
- **THEN** система не меняет обложку
|
- **THEN** система не меняет обложку
|
||||||
|
|
||||||
|
#### Scenario: Фото-обложка в корзине
|
||||||
|
- **WHEN** фото, назначенное обложкой, помещается в корзину
|
||||||
|
- **THEN** система снимает обложку, и альбом отображается без обложки
|
||||||
|
|
||||||
|
#### Scenario: Фото-обложка перенесено
|
||||||
|
- **WHEN** фото, назначенное обложкой, переносится в другой альбом
|
||||||
|
- **THEN** система снимает обложку исходного альбома
|
||||||
|
|
||||||
### Requirement: Переименование фото
|
### Requirement: Переименование фото
|
||||||
Автор фото, владелец и админ альбома SHALL иметь возможность изменить имя файла фото;
|
Автор фото, владелец и админ альбома SHALL иметь возможность изменить имя файла фото;
|
||||||
остальные SHALL получать отказ, а пустое имя SHALL отклоняться.
|
остальные SHALL получать отказ, а пустое имя SHALL отклоняться.
|
||||||
@@ -171,3 +186,16 @@
|
|||||||
#### Scenario: Снятие метки
|
#### Scenario: Снятие метки
|
||||||
- **WHEN** пользователь убирает метку с фото
|
- **WHEN** пользователь убирает метку с фото
|
||||||
- **THEN** метка отвязывается от фото
|
- **THEN** метка отвязывается от фото
|
||||||
|
|
||||||
|
### Requirement: Кэширование объектов
|
||||||
|
Доставка объектов SHALL помечать ответы как кэшируемые, чтобы браузер переиспользовал
|
||||||
|
уже полученные превью, а повторное открытие альбома не вызывало повторную загрузку
|
||||||
|
неизменившихся объектов.
|
||||||
|
|
||||||
|
#### Scenario: Заголовки кэширования
|
||||||
|
- **WHEN** клиент получает объект (оригинал, превью или thumb) по подписанному URL
|
||||||
|
- **THEN** ответ содержит заголовок кэширования с ограниченным сроком годности
|
||||||
|
|
||||||
|
#### Scenario: Повторный показ без перезагрузки
|
||||||
|
- **WHEN** сетка превью перерисовывается, а URL объектов не изменились
|
||||||
|
- **THEN** браузер отдаёт объекты из кэша без повторного запроса к бэкенду
|
||||||
|
|||||||
@@ -14,12 +14,19 @@
|
|||||||
- **THEN** система устанавливает text/event-stream и отправляет heartbeat
|
- **THEN** система устанавливает text/event-stream и отправляет heartbeat
|
||||||
|
|
||||||
### Requirement: События альбома
|
### Requirement: События альбома
|
||||||
Система SHALL публиковать события photo.created, photo.deleted, comment.created, like.added, like.removed, member.joined, member.left, album.updated.
|
Система 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: Новое фото
|
#### Scenario: Новое фото
|
||||||
- **WHEN** в альбоме появляется фото
|
- **WHEN** в альбоме появляется фото
|
||||||
- **THEN** подписчики получают событие photo.created с метаданными и URL превью
|
- **THEN** подписчики получают событие photo.created с метаданными и URL превью
|
||||||
|
|
||||||
|
#### Scenario: Готовы варианты
|
||||||
|
- **WHEN** для существующего фото сгенерированы thumb и preview
|
||||||
|
- **THEN** подписчики получают событие photo.updated с этим фото
|
||||||
|
|
||||||
### Requirement: Персональный поток
|
### Requirement: Персональный поток
|
||||||
Клиент SHALL иметь возможность подписаться на персональный поток (приглашения, уведомления).
|
Клиент SHALL иметь возможность подписаться на персональный поток (приглашения, уведомления).
|
||||||
|
|
||||||
@@ -47,3 +54,15 @@
|
|||||||
#### Scenario: Переподключение
|
#### Scenario: Переподключение
|
||||||
- **WHEN** клиент переподключается после разрыва
|
- **WHEN** клиент переподключается после разрыва
|
||||||
- **THEN** клиент догоняет события через запрос фото с параметром since
|
- **THEN** клиент догоняет события через запрос фото с параметром since
|
||||||
|
|
||||||
|
### Requirement: Различение добавления и обновления фото
|
||||||
|
Клиент SHALL различать добавление нового фото в альбом и обновление уже показанного:
|
||||||
|
обновление SHALL изменять фото на месте, не меняя порядок сетки.
|
||||||
|
|
||||||
|
#### Scenario: Обновление отображаемого фото
|
||||||
|
- **WHEN** приходит событие обновления для фото, которое уже показано
|
||||||
|
- **THEN** клиент обновляет его на месте, порядок сетки не меняется
|
||||||
|
|
||||||
|
#### Scenario: Обновление отсутствующего фото
|
||||||
|
- **WHEN** приходит событие обновления для фото, которого нет в текущем списке
|
||||||
|
- **THEN** клиент не добавляет его в сетку
|
||||||
|
|||||||
Reference in New Issue
Block a user