Files

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

3.3 KiB

Raw Permalink Blame History

photos Specification

Purpose

Загрузка, хранение в S3 и просмотр фотографий с генерацией вариантов и извлечением EXIF.

Requirements

Requirement: Загрузка фото

Пользователь с правом загрузки SHALL иметь возможность загружать фото по одному и массово.

Scenario: Успешная загрузка

WHEN участник с правом загрузки отправляет файл изображения
THEN система сохраняет оригинал и создаёт запись фото с метаданными

Scenario: Загрузка без права

WHEN наблюдатель пытается загрузить фото
THEN система отклоняет запрос

Requirement: Варианты изображений

Система SHALL генерировать три варианта: thumb (200px), preview (1200px) и оригинал, с WebP для превью, и извлекать EXIF (дата, координаты, размеры).

Scenario: Генерация вариантов

WHEN фото загружено
THEN система асинхронно генерирует thumb и preview и заполняет EXIF-поля

Requirement: Листинг фото с пагинацией

Система SHALL возвращать фото альбома с cursor-пагинацией.

Scenario: Пагинация по курсору

WHEN клиент запрашивает список с курсором и лимитом
THEN система возвращает не более лимита фото и курсор следующей страницы

Requirement: Получение фото по требованию

Клиент SHALL иметь возможность получить актуальные данные фото с presigned URL.

Scenario: Выдача свежего URL

WHEN клиент запрашивает фото по id
THEN система возвращает свежий presigned URL (срок до 1 часа) для просмотра

Requirement: Скачивание одиночного фото

Любой участник, включая viewer, SHALL иметь возможность скачать одиночное фото.

Scenario: Скачивание фото

WHEN участник запрашивает скачивание фото
THEN система возвращает presigned URL оригинала

Requirement: Удаление фото

Автор SHALL иметь возможность удалить своё фото; владелец и админ SHALL иметь возможность удалить любое фото.

Scenario: Удаление своего фото

WHEN автор удаляет своё фото
THEN система удаляет запись и файлы в S3

Scenario: Удаление чужого фото участником

WHEN участник с ролью member пытается удалить чужое фото
THEN система отклоняет запрос

3.3 KiB Raw Permalink Blame History