ds-galo/openspec/changes/lightroom-workspace-ui/specs/ui-workspace/spec.md

Spec Delta

Purpose

Рабочий стол веб-приложения: постоянный каркас с рейлом альбомов, контекстной панелью, режимом просмотра фото и адаптивным поведением, обеспечивающий цельный «lightroom»-вид.

ADDED Requirements

Requirement: Рабочий стол приложения

Аутентифицированные экраны SHALL отображаться внутри постоянного каркаса с топбаром, левым рейлом альбомов и контекстной правой панелью. Публичные экраны (вход, инвайт, share-ссылка) SHALL отображаться вне каркаса, но в общей теме оформления.

Scenario: Внутренний экран

• WHEN аутентифицированный пользователь открывает список альбомов или альбом
• THEN экран отрисован внутри каркаса с рейлом и панелью, рейл не перезагружается при переходе

Scenario: Публичный экран

• WHEN пользователь открывает публичную share-ссылку без входа
• THEN экран отрисован без рейла и контекстной панели, но в тех же цветовых токенах

Requirement: Рейл альбомов

Рейл SHALL постоянно показывать список доступных альбомов с их обложками и отмечать активный альбом.

Scenario: Активный альбом

• WHEN пользователь находится в альбоме
• THEN соответствующий элемент рейла выделен, остальные показывают обложки или плейсхолдер

Requirement: Создание альбома

Создание альбома SHALL выполняться через иконочную кнопку с подсказкой, открывающую модальное окно ввода названия, вместо инлайн-формы.

Scenario: Создание через модалку

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

Scenario: Пустое название

• WHEN пользователь подтверждает пустое название
• THEN создание не выполняется

Requirement: Контекстная панель альбома

Правая панель SHALL показывать превью обложки, название, счётчики фото и участников, управление обложкой и переходы к участникам, настройкам и ссылкам. Элементы управления обложкой SHALL быть доступны только owner и admin.

Scenario: Владелец альбома

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

Scenario: Наблюдатель

• WHEN viewer открывает альбом
• THEN панель не показывает управление обложкой

Requirement: Режим просмотра фотографии

Просмотр фото SHALL быть отдельным маршрутом внутри каркаса с крупным изображением, лентой миниатюр снизу и панелью метаданных и комментариев. Тот же режим SHALL использоваться на публичных share-страницах.

Scenario: Открытие фото

• WHEN пользователь выбирает фото в сетке
• THEN открывается маршрут фото в каркасе, рейл и панель остаются доступны, адрес отражает фото

Scenario: Навигация в просмотре

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

Scenario: Публичный просмотр

• WHEN посетитель share-ссылки открывает фото
• THEN используется тот же режим просмотра без рейла и панели

Requirement: Плотность сетки

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

Scenario: Изменение размера

• WHEN пользователь двигает регулятор плотности
• THEN размер миниатюр меняется, значение сохраняется и восстанавливается при следующем открытии

Requirement: Загрузка фотографий из рабочего стола

Загрузка SHALL запускаться действием в тулбаре; перетаскивание файлов над альбомом SHALL показывать оверлей и загружать их; пустой альбом SHALL показывать подсказку-зону загрузки. Загрузка SHALL быть доступна только ролям с правом загрузки.

Scenario: Перетаскивание

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

Scenario: Пустой альбом

• WHEN пользователь открывает альбом без фото и имеет право загрузки
• THEN в центре показана зона-подсказка загрузки

Requirement: Темы и графитовый хром

Тёмная тема SHALL использовать графитовый хром Lightroom и SHALL применяться по умолчанию; нейтральная тема SHALL быть тёплым графитом; остальные темы SHALL оставаться доступными, а скроллбары SHALL быть стилизованы в цвет темы.

Scenario: Первый вход

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

Scenario: Смена темы

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

Scenario: Нейтральная тема

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

Requirement: Адаптивность рабочего стола

На узких экранах рейл SHALL становиться выдвижной панелью, контекстная панель — сворачиваемой секцией, а лента миниатюр — горизонтально прокручиваемой.

Scenario: Узкий экран

• WHEN ширина окна меньше порога рабочего стола
• THEN рейл скрыт за кнопкой открытия, панель сворачиваема, лента прокручивается горизонтально

Requirement: Доступность рабочего стола

Иконочные органы управления каркаса SHALL иметь доступные имена, панели SHALL быть достижимы с клавиатуры с видимым фокусом, анимации SHALL учитывать предпочтение уменьшенного движения.

Scenario: Клавиатурная навигация

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

Requirement: Изменение ширины панелей

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

Scenario: Перетаскивание разделителя

• WHEN пользователь тянет разделитель у панели на рабочем столе
• THEN панель меняет ширину в допустимых пределах

Scenario: Сохранение ширины

• WHEN пользователь перезагружает приложение
• THEN восстановленные панели имеют сохранённую ширину

Requirement: Сворачиваемые разделы панели

Контекстная панель SHALL группировать содержимое в сворачиваемые разделы, а состояние сворачивания SHALL сохраняться; раздел «Информация» SHALL показывать метаданные EXIF фото.

Scenario: Сворачивание раздела

• WHEN пользователь нажимает заголовок раздела
• THEN содержимое раздела скрывается или показывается, состояние сохраняется

Scenario: Метаданные фото

• WHEN открыт просмотр фото
• THEN раздел «Информация» показывает размер, тип, разрешение, дату съёмки и координаты

Requirement: Полноэкранный просмотр фотографии

В режиме просмотра SHALL быть доступен переход в полноэкранный режим кнопкой и хоткеем f.

Scenario: Вход в полный экран

• WHEN пользователь нажимает кнопку полного экрана или клавишу f
• THEN просмотр разворачивается на весь экран

Scenario: Выход из полного экрана

• WHEN пользователь повторно нажимает кнопку или клавишу f
• THEN полноэкранный режим закрывается

Requirement: Зум в просмотре

Просмотр SHALL поддерживать зум: колесо мыши меняет масштаб, Space переключает 100%, а при увеличении фото SHALL панорамироваться. Зум SHALL работать и в полноэкранном режиме.

Scenario: Зум колесом

• WHEN пользователь вращает колесо мыши над фото
• THEN масштаб фото меняется относительно положения курсора

Scenario: 100% по пробелу

• WHEN пользователь нажимает Space
• THEN фото показывается в масштабе 100% (1:1), повторное нажатие возвращает вписанный вид

Scenario: Панорамирование

• WHEN фото увеличено
• THEN пользователь может перемещать изображение перетаскиванием и прокруткой

Requirement: Удаление фото из просмотра

Автор фото, владелец и админ альбома SHALL иметь возможность удалить текущее фото из режима просмотра; удаление SHALL подтверждаться диалогом.

Scenario: Подтверждение удаления

• WHEN пользователь с правом удаления нажимает «Удалить»
• THEN открывается диалог подтверждения, и после подтверждения фото удаляется

Scenario: Лента после удаления

• WHEN фото удалено
• THEN просмотр переходит к соседнему фото, а лента миниатюр обновляется без удалённого

Requirement: Возврат к обзору

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

Scenario: Возврат из альбома

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

Scenario: Возврат из просмотра

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