Files
ds-galo/openspec/changes/archive/2026-10-10-shared-album/specs/realtime/spec.md
T
iu 84ce4d1930 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

2.9 KiB

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