Руководство пользователя · Music Collection (веб и Android)

Описание интерфейса для каталогизации музыкальных носителей — винил, CD, кассеты и т.п. Приложение многопользовательское: у каждого свой каталог, доступный после входа по логину и паролю. Разделы 1–7 описывают веб-версию, раздел 8 — мобильное приложение Android.

Что нового в веб и Android — releases.html.

Содержание

1. Регистрация и вход
2. Каталог коллекций
3. Карточка релиза
4. Добавление носителя вручную
5. Импорт из Discogs
6. Личные справочники: теги, категории и места хранения
7. Настройки
8. Мобильное приложение (Android)

Регистрация и вход

Приложение открывается на экране входа. Если учётной записи ещё нет — перейдите на страницу регистрации.

Регистрация

Поля формы:

После регистрации на email приходит код подтверждения — введите его на странице верификации, чтобы отметить адрес подтверждённым. Если код введён неверно слишком много раз, появится сообщение с просьбой запросить новый код (кнопка повторной отправки). При слишком частых попытках входа/регистрации запросы могут временно ограничиваться — подождите и повторите.

Вход

В поле Email или username можно вводить либо почту, либо логин. После успешного входа вы попадаете в каталог коллекций.

Если пароль несколько раз подряд введён неверно, учётная запись временно блокируется на несколько минут — на экране входа появится сообщение с просьбой повторить позже. Это не то же самое, что постоянная блокировка учётной записи (страница «Аккаунт заблокирован»).

Каталог коллекций

Главный экран пользователя — раздел Коллекции. Сверху — панель действий: переключатель вида (Список / Плитка), кнопка + Добавить, блок «Параметры поиска» и рядом с заголовком «Моя коллекция» — Стоимость (сумма цен Discogs по текущему фильтру; носители без Discogs-цены не учитываются; «Моя цена» в сумму не входит).

Вид «Список»

Носители отображаются таблицей: название, исполнитель, год, тип носителя, место хранения; слева — pastel-полоса статуса, рядом — бейдж статуса. Список отсортирован по исполнителю (A–Z; без исполнителя — в конце), затем по названию. Между группами — горизонтальные буквенные разделители (латиница и кириллица; если имя начинается не с буквы — секция #). Показываются все релизы текущего фильтра (без постраничной навигации).

Справа от таблицы — буквенный индекс (латиница, кириллица, #): нажатие на букву прокручивает список к соответствующему разделителю артистов.

Клик по миниатюре обложки в строке открывает её в полном размере (см. Обложка в полном размере).

Вид «Плитка»

Кнопка ▦ Плитка переключает таблицу на карточки. Кнопка ☰ Список возвращает табличный вид. На карточках — та же pastel-маркировка статуса (полоса/бейдж), что и в списке; порядок и пагинация — серверная выдача, без буквенных секций и бокового индекса. Клик по обложке на плитке — lightbox.

Пагинация (плитки)

В виде Плитка переключение страниц — кнопками с номерами. Сколько релизов показывать на странице, выбирается в Настройках (10 / 25 / 50). В виде Список пагинация не используется.

Фильтры

Скриншот устарел (снят до фильтра «Дата добавления» и новой раскладки полей). Нужен новый docs/screenshots/collections-filters.png через scripts/make_screenshots.py.

Блок «Параметры поиска» разворачивается кнопкой ▼ Развернуть (и сворачивается ▲ Свернуть). Поля расположены в два ряда:

1. Название · Исполнитель · Год
2. Дата добавления · Тип носителя · Категория · Место хранения

Доступны поля:

• Название (напр. Dark Side) — у непустого поля кнопка ✕ очищает только это поле и сразу обновляет список (остальные фильтры сохраняются)
• Исполнитель (напр. Pink Floyd) — то же: ✕ очищает поле и сразу переприменяет фильтр
• Год (напр. 1973)
• Дата добавления — календарь (дата YYYY-MM-DD); показывает релизы, добавленные в коллекцию в выбранный календарный день по UTC (как у отметки «Прослушано сегодня»). Пустое поле — без фильтра по дате.
• Тип носителя — выпадающий список (значение «Любой» сбрасывает фильтр)
• Категория — выпадающий список («Любая» сбрасывает); стоит перед местом хранения
• Место хранения — выпадающий список («Любое» сбрасывает)
• Статус — чипы: Коллекция («В коллекции» + «На продажу»), Wish, Заказано, На продажу, Все (по умолчанию — все статусы). Чип «Коллекция» сужает список до owned+for_sale.

Кнопка Применить фильтрует список, Сбросить — убирает фильтры (статус снова «Все»).

Android: те же поля фильтров, включая Дата добавления (выбор даты из календаря) и ✕ у Названия/Исполнителя с немедленным переприменением. Офлайн фильтр по дате добавления тоже работает (по локальному кэшу). День считается по UTC, как на сервере.

Двухпанельный режим (широкий экран)

На широком экране клик по названию релиза в списке или на плитке открывает карточку в правой панели, не уходя со страницы. Клик по обложке открывает её в полном размере (lightbox), а не карточку. Так удобно быстро листать и сверять детали. Панель можно закрыть: кнопка Закрыть, клавиша Esc (если не открыты редактирование, удаление или просмотр обложки) или повторный клик по тому же названию.

Карточка релиза

На узком экране (телефон, узкое окно) клик по названию открывает отдельную страницу детали; клик по обложке — lightbox.

В карточке отображаются: название, исполнитель, год, страна, лейбл, каталожный номер, штрихкод (если задан), тип носителя, жанры, теги, статус (В коллекции / Wish / Заказано / На продажу — pastel-бейдж; меняется инлайн, без формы), категория и место хранения (выпадающие списки из личных справочников; тоже инлайн — можно сменить или очистить без открытия формы), цена Discogs и моя цена (если заданы; рыночная цена — в валюте приложения, «моя» — на ваше усмотрение), идентификатор Discogs (если релиз импортирован оттуда), дата последней чистки (если задана), мои заметки (редактируемые) и заметки Discogs (если есть — только для чтения).

Рядом с ценой (для релизов с Discogs ID) — иконка обновить цену: подтягивает актуальную рыночную цену с Discogs и перезаписывает поле (можно отменить, пока идёт запрос). Если Discogs ID нет — иконка недоступна.

Мой рейтинг в карточке меняется инлайн, без открытия формы редактирования: 5 звёздочек (клик 1…5, на вебе — предпросмотр при наведении) и кнопка Очистить (сбрасывает рейтинг в «без оценки»; значение 0 звёздочками не выставляется — только через «Очистить»). Диапазон рейтинга — 0…5.

Прослушано сегодня — галочка в карточке: отмечает прослушивание за текущий календарный день по UTC (сервер). Повторный клик снимает отметку. Рядом показываются сводка: всего отметок, за последние 30 дней и дата последнего прослушивания. История персональная; в списке коллекций не отображается. Офлайн отметка недоступна (нужна сеть).

Android: в карточке релиза — то же инлайн-управление статусом, категорией, местом хранения, рейтингом (5 звёзд + «Очистить») и галочка «Прослушано сегодня» со сводкой; тап по обложке — lightbox или галерея (см. ниже). Офлайн смена категории/места недоступна (нужна сеть). На форме коллекции кнопка Очистить у рейтинга, «моих заметок» и цен сбрасывает поле в «пусто».

Галерея обложек (релизы из Discogs)

Если релиз импортирован из Discogs и у него несколько фотографий, в карточке под основной обложкой появляется полоса миниатюр (все изображения релиза, primary — первым; сохраняется до 30 штук). Клик по основной обложке или любой миниатюре открывает просмотр; если картинка одна — обычный lightbox, если несколько — галерея (см. следующий подраздел).

В списке и плитке коллекции по-прежнему показывается только основная обложка; полная галерея — только в карточке релиза. Предпросмотр Discogs до импорта галерею не показывает.

Обложка в полном размере (lightbox и галерея)

Клик или тап по миниатюре обложки открывает изображение в модальном окне на весь экран (без масштабирования — MVP).

Одна картинка — простой lightbox. Несколько (импорт из Discogs) — галерея с кнопками ‹ / ›, индикатором N из M, полосой миниатюр внизу и переключением стрелками клавиатуры (← / → на вебе). Закрытие:

• веб — клавиша Esc, клик по затемнённому фону или кнопка ✕;
• Android — кнопка закрытия, свайп по pager или тап вне изображения.

Lightbox (одиночная обложка) доступен в списке/плитке коллекции, в поиске и предпросмотре Discogs — везде, где показывается одна обложка. Галерея с несколькими кадрами — только в карточке импортированного релиза (веб и Android).

Действия:

• Редактировать — открыть форму правки полей.
• Удалить — удалить релиз вместе со всеми треками (подтверждение в диалоге; действие безвозвратно).

Треклист

Ниже карточки — треклист с порядком и длительностью треков. Кнопка + Трек добавляет трек вручную; у каждого трека есть правка и удаление (заметки трека — до 10 000 символов). Если треков нет — подсказка: добавить вручную или импортировать из Discogs.

Добавление носителя вручную

Открывается кнопкой + Добавить в разделе Коллекции. Поля формы:

При превышении лимитов (слишком длинные заметки, больше 50 жанров или тегов, слишком большой запрос целиком) сохранение не пройдёт — появится понятное сообщение об ошибке. На вебе длину «моих заметок» дополнительно ограничивает поле ввода.

После сохранения релиз появляется в каталоге.

Импорт из Discogs

Раздел Discogs — поиск релизов в каталоге Discogs и импорт в свою коллекцию вместе с треклистом. Если раздел недоступен, на экране появится соответствующее сообщение.

Поиск

Введите запрос (напр. Pink Floyd Dark Side) и нажмите Найти. Результаты — список карточек релизов с обложкой, исполнителем, годом, лейблом. У непустой строки поиска — кнопка ✕: очищает только запрос, результаты остаются (удобно уточнить текст и искать снова). Клик по обложке в результатах или в предпросмотре — просмотр в полном размере (lightbox).

Сканирование штрихкода (веб)

Рядом с полем поиска — кнопка Сканировать (если браузер и сайт позволяют использовать камеру). Откроется окно сканера: наведите камеру на штрихкод релиза. Распознанный код подставится в строку поиска — проверьте его и нажмите Найти.

Камера в браузере работает только по защищённому соединению (HTTPS) или на локальном компьютере. Если доступ к камере запрещён — разрешите его в настройках браузера и повторите попытку.

Предпросмотр и импорт

Клик по результату (или кнопка Предпросмотр) открывает правую панель с деталями релиза и треклистом. Перед импортом можно выбрать статус (В коллекции / Wish / Заказано / На продажу; по умолчанию — «В коллекции»), а также опционально категорию и место хранения из личных справочников. Кнопка Импортировать в коллекцию создаёт релиз в вашем каталоге, подставляя:

• название, исполнителя, год, страну, лейбл, каталожный номер, штрихкод (если Discogs отдал Barcode);
• тип носителя и жанры — сопоставляются по имени со справочниками;
• треклист — позиции и длительность;
• цену — рыночную цену с Discogs (можно править после импорта);
• статус — выбранный при импорте (или «В коллекции»);
• категорию и место хранения — если выбраны перед импортом (иначе пусто);
• все изображения релиза с Discogs (основная обложка и дополнительные фото — до 30; галерея в карточке, см. Галерея обложек);
• заметки Discogs — если Discogs отдал поле notes (в карточке только чтение);
• идентификатор Discogs сохраняется в карточке релиза (поле Discogs ID). Свои заметки (Мои заметки) задаются в форме после импорта.

Один и тот же Discogs-релиз можно импортировать только один раз в свою коллекцию. Повторный импорт покажет сообщение, что релиз уже импортирован; на коллекции других пользователей это ограничение не влияет.

Личные справочники: теги, категории и места хранения

Раздел Справочники — личные теги, категории и места хранения, доступные только вам.

• Теги — метки для коллекций (напр. любимое, на продажу); к носителю можно привязать несколько.
• Категории — группировка носителей (напр. Jazz, Оцифровать); у носителя не больше одной категории (как место хранения). Можно выбрать при импорте из Discogs или в форме носителя.
• Места хранения — где физически лежат носители (напр. Полка A, Коробка 3), с описанием; также доступны при импорте из Discogs.

В каждом справочнике можно добавить, переименовать и удалить запись (удаление с подтверждением). Эти значения потом выбираются в форме носителя, при импорте из Discogs и в фильтрах.

Настройки

Страница Настройки (пункт меню с тем же названием) делится на блоки.

Внешний вид

• Тема оформления — Светлая / Тёмная / Системная.
• Язык интерфейса — Русский / English. Выбор сохраняется в браузере и применяется сразу. Сменить можно в любой момент.
• Релизов на страницу — размер страницы в виде Плитка на экране коллекций (10 / 25 / 50). На вид Список не влияет.

Коллекция и Discogs

• Обновить все цены — массово подтянуть актуальные цены с Discogs для ваших релизов с Discogs ID (до 50 за один запуск). Перед запуском — подтверждение:
• только носители без цены (режим по умолчанию);
• или перезаписать уже заданные цены. По завершении — сводка (обновлено / без изменений / пропущено / ошибки). При большой нагрузке на Discogs часть обновлений может сохраниться, а остальные завершатся с ошибкой — их можно повторить позже.

Экспорт коллекции

Карточка «Экспорт коллекции» — скачать ваши релизы в файл (это не бэкап базы данных). Показывается в Настройках обычным пользователям; у учётной записи администратора (суперпользователя) карточки в Настройках нет — личный экспорт предназначен для пользовательского клиента.

Перед скачиванием можно отметить нужные поля чекбоксами (по умолчанию выбраны все). Кнопки «Выбрать все» и очистки выбора — над списком. Пока ни одно поле не выбрано, кнопки экспорта недоступны.

• JSON — один файл music-collection-ГГГГММДД.json с выбранными полями релизов (названия справочников, жанры/теги, треки — если отмечены).
• CSV — ZIP-архив с таблицами collections.csv и/или tracks.csv (удобно открыть в Excel / Numbers); состав файлов зависит от выбранных полей.

Файл сохраняется в папку загрузок браузера. Экспорт касается только вашей коллекции.

Смена email

1. Введите Новый email и отправьте запрос — на новый адрес придёт код.
2. Введите Код подтверждения (6 цифр) — адрес меняется после подтверждения.

Смена пароля

Поля: Текущий пароль, Новый пароль, Повторите новый пароль. Новый пароль — те же правила, что при регистрации (8–128 символов, буква и цифра; без простых последовательностей; слишком распространённые пароли не принимаются). При неверном текущем пароле показывается сообщение «Неверный текущий пароль».

Моя статистика

Карточка «Моя статистика» в Настройках открывает страницу с вашей личной активностью за выбранный период.

Сверху — фильтры диапазона: поля С и По (даты начала и конца) и Гранулярность (День / Неделя / Месяц). По умолчанию показываются последние 30 дней. Графики — входы, импорты из Discogs, изменения коллекции — строятся по дням, неделям или месяцам в зависимости от гранулярности; ниже — список замеченных пользовательских агентов (через какой клиент вы входили). Видны только ваши данные; чужих пользователей и их статистику вы не видите.

Отдельным блоком показана сводка по вашей коллекции:

• Всего релизов — общее количество;
• Без места хранения — сколько релизов со статусом «В коллекции» без привязки к месту (другие статусы не считаются);
• Прослушано сегодня — сколько релизов отмечено прослушанными за текущие UTC-сутки;
• разбивка по статусам — «В коллекции» / «Хочу» / «Заказано» / «На продажу»;
• график «Добавлено по дням» — сколько релизов вы добавляли в каждый интервал (день/неделя/месяц — как выбрано фильтром).

На всех линейных графиках при наведении мышью появляется вертикальная направляющая, подсвечивается точка и всплывает подсказка с датой и значением (например, 2026-07-15: 4).

Мобильное приложение (Android)

Помимо веб-версии есть мобильное приложение для Android, работающее с тем же каталогом. Требуется Android 8.0 и выше. Вход — по email или username и паролю, как в вебе.

Вход по отпечатку

Опционально можно включить вход по отпечатку пальца, чтобы не вводить пароль при каждом запуске.

Включение. В Настройках включите тумблер «Вход по отпечатку». Появится системный запрос отпечатка — приложите палец. После этого текущая сессия сохраняется под защитой отпечатка.

Разблокировка. При холодном старте приложения или после 30 минут бездействия (пока процесс жив) появляется экран разблокировки: приложите палец к сканеру — вход выполняется без пароля. Кнопка «Войти паролем» — запасной вход без биометрии; при следующем входе паролем приложение снова предложит подтвердить отпечаток, чтобы восстановить вход по отпечатку.

После входа паролем. Если вход по отпечатку был включён ранее, сразу после успешного входа паролем появится системный запрос отпечатка (сохранение новой сессии под отпечатком). Подтвердите — биометрия останется включённой. Отмените или выберите продолжить без отпечатка — биометрия выключится, сессия по паролю сохранится (включить снова можно в Настройках).

Когда отпечаток недоступен. Если на устройстве нет сканера или не добавлен ни один отпечаток, тумблер выключен и недоступен, с пояснением причины. В этом случае приложение работает обычным образом — вход по паролю. После закрытия приложения вход может восстановиться без повторного ввода пароля (пока вы явно не выйдете или сессия не истечёт) — это ожидаемое поведение.

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

Язык интерфейса

В Настройках рядом с темой — переключатель Системный / Русский / English. Опция Системный следует языку устройства. Выбор сохраняется на устройстве и применяется сразу.

Сканирование штрихкода и текста (Android)

В разделе Discogs рядом с полем поиска — кнопка Сканировать. Открывается экран Сканер с двумя режимами:

• Штрихкод — наведите камеру на штрихкод релиза; при распознавании код сразу подставляется в строку поиска на экране Discogs.
• Текст — для каталожных номеров на обложке или наклейке (напр. C60 25987): наведите камеру на надпись и нажмите Снимок. Распознанный текст показывается для проверки — при необходимости поправьте его и нажмите Использовать. Кнопка Заново — повторить снимок.

Онлайн: поиск после сканирования не запускается автоматически — проверьте строку поиска и нажмите Найти.

Офлайн (нет сети, есть локальный кэш): поиск идёт по вашей коллекции в кэше — точное совпадение штрихкода (цифры) и подстрочный поиск по названию / исполнителю / каталожному номеру. После скана штрихкода поиск запускается сам. Найденная запись открывает карточку релиза из коллекции; импорт с Discogs офлайн недоступен (нужна сеть).

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

Виды списка коллекции (Android)

В шапке экрана коллекции кнопка переключает три режима по кругу:

• Список — строки с обложкой и метаданными; буквенные секции и быстрый индекс справа.
• Плитка — карточки в 2 колонки (обложка + название/исполнитель и чипы).
• Изображения — только обложки в 3 колонки. Короткое нажатие открывает карточку релиза; долгое удержание — увеличенную обложку (lightbox).

В режимах Список и Плитка тап по обложке тоже открывает lightbox (короткое нажатие по строке/плитке по-прежнему открывает карточку, если вы нажали не на обложку).

Выбранный режим сохраняется на устройстве. Цветная полоска статуса (wish-лист и др.) видна во всех трёх режимах.

Добавление носителя (создание и правка)

На экране списка коллекции плавающая кнопка + открывает форму новой записи. При прокрутке списка вниз кнопка временно скрывается; чтобы она снова появилась — прокрутите немного вверх. Без интернета кнопка + не показывается (добавление онлайн-only).

На экране новой записи или редактирования релиза кнопка Сохранить находится в верхней панели (справа). Отмена — стрелка «назад» слева в той же панели; отдельной кнопки «Отмена» внизу экрана нет.

Локальная копия и обновление (Android)

Приложение хранит на телефоне копию вашей коллекции. Благодаря этому вы можете смотреть и искать свои релизы даже без интернета — например, в дороге или там, где ловит плохо.

Когда копия обновляется сама:

• когда вы открываете приложение и есть интернет — свежие данные подтягиваются автоматически;
• сразу после того, как вы добавили, изменили или удалили релиз на этом телефоне — копия тут же приводится в соответствие.

Как обновить вручную:

• потяните список коллекций вниз — он перезагрузится и обновится;
• в Настройках есть кнопка «Обновить кэш» — нажмите, чтобы принудительно подтянуть свежие данные.

Чего не происходит:

• изменения, сделанные с другого устройства (в вебе или на втором телефоне), не появляются мгновенно — вы увидите их при следующем открытии приложения или после ручного обновления;
• пока приложения нет на экране (оно свёрнуто или закрыто), копия не обновляется.

Без интернета:

• вы видите последнюю сохранённую копию — искать и листать можно;
• добавить, изменить или удалить релиз нельзя — кнопки таких действий отключены, появится подсказка «Нет соединения»;
• как только связь вернётся, копия обновится сама.

Если на телефоне заканчивается место, копию можно стереть целиком кнопкой «Очистить локальный кэш» в Настройках. Ничего ценного при этом не теряется — при следующем подключении к интернету приложение заново скачает коллекцию с сервера. Это удобно и если что-то отображается странно: очистка + новое обновление обычно всё исправляет.

Экспорт коллекции (Android)

В приложении «Моя коллекция» (user) в Настройках — карточка «Экспорт коллекции» (как в вебе: JSON или ZIP с CSV, список полей с чекбоксами, «Выбрать все» / очистка). В админском Android-приложении карточки в Настройках нет. По умолчанию файл сохраняется в системные Загрузки. Можно выбрать другую папку («Выбрать папку…») — выбор запоминается; при недоступности папки файл снова уходит в Загрузки. Кнопка «Сбросить в Загрузки» возвращает путь по умолчанию. Это экспорт ваших релизов, не бэкап серверной БД.

Моя статистика (Android)

В Настройках есть кнопка «Моя статистика». Экран показывает вашу личную активность за выбранный период: входы, импорты из Discogs, изменения коллекции — графиками по дням, неделям или месяцам, а также список замеченных пользовательских агентов. Видны только ваши данные; чужих пользователей и их статистику вы не видите.

Сверху — фильтр диапазона дат: поля С и По открывают календарь (Material date picker) — дату выбирают из календаря, а не вводят руками. По умолчанию диапазон от первого дня текущего месяца до сегодня; кнопка Очистить сбрасывает к этому же дефолту. Гранулярность — День / Неделя / Месяц.

Отдельной карточкой идёт сводка по вашей коллекции: всего релизов, без места хранения (только статус «В коллекции» без привязки к месту), прослушано сегодня (за UTC-сутки), разбивка по статусам («В коллекции» / «Хочу» / «Заказано» / «На продажу») и график «Добавлено по дням». На линейных графиках при касании/протяжке пальцем появляется вертикальная направляющая, подсвечивается точка и всплывает подсказка с датой и значением.

Версия и дата сборки

В самом низу Настроек показаны две строки приглушённым цветом:

• Версия X.Y.Z (N) — версия приложения и числовой код сборки;
• Сборка: YYYY-MM-DD HH:MM — дата и время сборки данного APK. Одинакова для всех установок одной и той же сборки и не зависит от момента установки на устройство.

Обновление приложения (Android)

В Настройках — блок «Обновление приложения» с кнопкой «Проверить обновление». При наличии новой версии на сервере (номер сборки выше установленной) приложение предложит скачать и установить APK (нужно разрешение на установку из этого источника). Проверка также может запускаться при открытии приложения, не чаще чем раз в несколько часов; кнопку «Позже» можно нажать, чтобы отложить.

Первую сборку с этой функцией нужно установить вручную; следующие обновления можно получать из приложения. Актуальная версия на момент обновления документа: «Моя коллекция» 0.5.38 (54).

Вход по отпечатку доступен только в мобильном приложении. В веб-версии вход выполняется по паролю.