📖 Умные папки и коллекции Библиотеки (Library Collections)

🧠 1. Анатомия инструмента и Логика движка (Tool Anatomy & Engine Logic)

• Что это такое? Умные папки и коллекции Библиотеки решают проблему хаоса в каталоге сохраненных треков велосипедиста. Когда число маршрутов превышает десяток, искать нужный становится неудобно. Инструмент позволяет структурировать поездки по категориям (например, «Работа», «Тренировки», «ПВД»), сортировать их по дистанции и дате создания.
• Активация: Библиотека открывается нажатием на кнопку папки со значком 🗂️ в левой панели инструментов или переходом в раздел «Библиотека» главного меню.
• Физика интерфейса (Basic UI Physics):
  • Цветные папки-карточки: Каждая коллекция имеет свой цвет-маркер (Catppuccin Mocha-стили, настраивается при создании: #3b82f6 для асфальта, #10b981 для лесов).
  • Счетчик треков (Badge): Числовой индикатор на папке, показывающий количество маршрутов внутри (например, 5 tracks).
  • Drag-n-Drop ярлыки: Интерактивные строки маршрутов с иконкой захвата (шесть точек слева) для перетаскивания.
  • Прогресс-бар заполнения: В проектах с фазами показывает процент готовности маршрута (например, 60% completed).
• 

Подробная инструкция для Арт-директора: Сделать снимок экрана боковой панели Библиотеки с раскрытыми папками, цветными тегами и строкой поиска с введенным текстом.

🎬 2. Матрица сценариев (Все комбинации взаимодействия)

Сценарий А: Создание папки и распределение Drag & Drop

• Действие пользователя: Нажать кнопку «Создать папку» вверху панели, ввести название «Осень 2026», выбрать оранжевый цвет, зажать левую кнопку мыши на маршруте «Лесная петля» в общем списке и перетащить его внутрь новой папки.
• Реакция системы (Магия): Папка мгновенно создается в списке с оранжевым ярлыком. При перетаскивании трек визуально «проваливается» внутрь папки, а счетчик треков в ней увеличивается на 1.
• Физика процесса («Почему»): Клиент ловит событие onDragEnd библиотеки @hello-pangea/dnd, считывает ID перетаскиваемого трека и ID целевой папки, после чего вызывает Hono API POST /api/collections/:id/routes.
• 

Подробная инструкция: Процесс переноса карточки маршрута мышкой в оранжевую папку «Осень 2026» с подсвеченной рамкой сброса.

Сценарий Б: Связывание одного трека с несколькими папками

• Действие пользователя: Перетащить один и тот же маршрут «Дом - Работа» сначала в папку «Ежедневные», а затем в папку «Асфальт».
• Реакция системы (Магия): Маршрут отображается в обеих папках одновременно. Изменение названия трека в одной папке мгновенно обновляет его во второй.
• Физика процесса («Почему»): Таблица отношений track_collections связывает внешние ключи. Сам трек не дублируется в таблице tracks, папки ссылаются на один и тот же ID, выступая виртуальными ярлыками.
• 

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

🚨 3. Защита от дурака и Крайние случаи (QA Guide)

• Деструктивный сценарий: Удаление папки (коллекции), внутри которой лежат три важных спланированных веломаршрута.
• Реакция UI: Клик на иконку урны папки открывает предупреждение. При подтверждении папка удаляется, но сами маршруты не исчезают, а безопасно возвращаются в корневой каталог «Все маршруты».
• Точный текст ошибки (Toast): При успешном удалении коллекции: "🛡️ Коллекция успешно удалена. Связанные маршруты сохранены в Библиотеке."
• 

Подробная инструкция: Снимок экрана с всплывающим предупреждением о подтверждении удаления папки.