feat: implement shared-album multi-user photo album
Backend (Go/Gin/pgx): env config, pgx pool with retries, Garage S3 client (path-style, region garage), embedded golang-migrate migrations, JWT auth with refresh rotation, albums CRUD, members/roles/invites with no-escalation matrix, photo upload + async imaging/goexif WebP variants, cursor pagination, presigned URLs, likes/comments, SSE hub (album + personal), notifications, share links. Frontend (SvelteKit 2 + Svelte 5 + Tailwind v4): API wrapper with 401 refresh, auth store, all screens, Uploader/PhotoGrid/Lightbox/Comments, SSE client with reconnect + REST catch-up, three themes + system via data-theme. Deploy without Docker: Makefile builds the frontend into backend/static and embeds it (go:embed) into a single statically linked binary; systemd unit and nginx SSE example included. Use gen2brain/webp (-tags nodynamic) instead of cgo kolesa-team/go-webp to keep CGO_ENABLED=0 static builds; design.md/proposal.md updated accordingly.
This commit is contained in:
@@ -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
|
||||
Reference in New Issue
Block a user