Files
ds-galo/openspec/changes/shared-album/specs/share-links/spec.md
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.8 KiB

Spec Delta

Purpose

View-only доступ к альбому по ссылке без авторизации, с несколькими ссылками, сроком действия и отзывом.

ADDED Requirements

Requirement: Создание ссылки для просмотра

Владелец и админ SHALL иметь возможность создать ссылку для просмотра альбома с заданным сроком действия.

Scenario: Создание ссылки

  • WHEN админ создаёт share-ссылку со сроком действия
  • THEN система создаёт токен и возвращает URL для просмотра

Requirement: Несколько ссылок

Альбом SHALL поддерживать несколько независимых share-ссылок.

Scenario: Отзыв одной ссылки не затрагивает другие

  • WHEN владелец отзывает одну ссылку
  • THEN остальные ссылки остаются действующими

Requirement: Просмотр альбома по ссылке

Пользователь без авторизации SHALL иметь возможность просматривать альбом по действующему токену (сетка, лайтбокс, скачивание одиночного фото).

Scenario: Просмотр по действующей ссылке

  • WHEN аноним открывает ссылку с действующим токеном
  • THEN система возвращает фото альбома со свежими presigned URL

Scenario: Истёкшая или отозванная ссылка

  • WHEN аноним открывает ссылку с истёкшим или отозванным токеном
  • THEN система отклоняет доступ

Requirement: Ограничения по ссылке

Доступ по ссылке SHALL быть только на просмотр: без комментариев, лайков, загрузки и управления участниками.

Scenario: Аноним не может комментировать

  • WHEN аноним по ссылке пытается добавить комментарий
  • THEN система отклоняет запрос

Requirement: Отзыв ссылки

Владелец и админ SHALL иметь возможность отозвать ссылку.

Scenario: Отзыв ссылки

  • WHEN владелец отзывает share-ссылку
  • THEN система прекращает доступ по этому токену