Files

T

iu 2b2b342492 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.

2026-10-10 12:50:33 +03:00

2.9 KiB

Raw Blame History

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

2.9 KiB Raw Blame History