chore(openspec): archive shared-album and sync main specs

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.
2026-10-10 12:58:34 +03:00
parent 2b2b342492
commit 84ce4d1930
20 changed files with 373 additions and 0 deletions
@@ -0,0 +1,49 @@
+# 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