iu
84ce4d1930
Move the completed shared-album change to openspec/changes/archive/2026-10-10-shared-album/ and create the 8 main specs (albums, auth, members, notifications, photos, realtime, share-links, social) from the delta ADDED requirements.
50 lines
2.9 KiB
Markdown
50 lines
2.9 KiB
Markdown
# Spec Delta
|
|
|
|
## Purpose
|
|
|
|
Поток событий альбома и персональный поток через Server-Sent Events.
|
|
|
|
## ADDED Requirements
|
|
|
|
### Requirement: Подписка на события альбома
|
|
Клиент SHALL иметь возможность подписаться на события конкретного альбома через SSE.
|
|
|
|
#### Scenario: Подписка на альбом
|
|
- **WHEN** участник подключается к SSE-потоку альбома
|
|
- **THEN** система устанавливает text/event-stream и отправляет heartbeat
|
|
|
|
### Requirement: События альбома
|
|
Система SHALL публиковать события photo.created, photo.deleted, comment.created, like.added, like.removed, member.joined, member.left, album.updated.
|
|
|
|
#### Scenario: Новое фото
|
|
- **WHEN** в альбоме появляется фото
|
|
- **THEN** подписчики получают событие photo.created с метаданными и URL превью
|
|
|
|
### Requirement: Персональный поток
|
|
Клиент SHALL иметь возможность подписаться на персональный поток (приглашения, уведомления).
|
|
|
|
#### Scenario: Подписка на персональный поток
|
|
- **WHEN** пользователь подключается к персональному потоку
|
|
- **THEN** система отправляет ему персональные события
|
|
|
|
### Requirement: Авторизация и область доступа
|
|
Клиент SHALL подписываться только на доступные ему альбомы; токен передаётся в query-параметре.
|
|
|
|
#### Scenario: Подписка на недоступный альбом
|
|
- **WHEN** пользователь подписывается на альбом, к которому нет доступа
|
|
- **THEN** система отклоняет подключение
|
|
|
|
### Requirement: Устойчивость соединения
|
|
Система SHALL отправлять heartbeat каждые 25 секунд и отключать медленных клиентов при переполнении буфера.
|
|
|
|
#### Scenario: Переполнение буфера клиента
|
|
- **WHEN** буфер клиента переполняется
|
|
- **THEN** система отключает клиента
|
|
|
|
### Requirement: Догон пропущенного
|
|
Клиент SHALL иметь возможность догнать пропущенные события через REST.
|
|
|
|
#### Scenario: Переподключение
|
|
- **WHEN** клиент переподключается после разрыва
|
|
- **THEN** клиент догоняет события через запрос фото с параметром since
|