Карта документации

Для кого: Для тех, кто хочет увидеть весь проект перед выбором конкретной задачи. Задача: Найти нужную страницу для установки, ежедневной работы, обслуживания или проверки контракта. Тип: Объяснение

DJ Track Similarity помогает искать музыку в локальной коллекции, когда папок, тегов и памяти уже недостаточно. Отправной точкой может быть знакомый трек, описание нужного звучания или черновая идея сета. Приложение превращает её в короткий список, который стоит прослушать.

Приложение не решает, какие треки «хорошие», и не гарантирует, что любая найденная пара сведётся безупречно. Оно сокращает область поиска, объясняет появление кандидата и оставляет музыкальное решение диджею.

Бэкенд и CLI — актуальная поверхность схемы v7. Они создают новую Core и обязательную Artifacts, а Evaluation — только при необходимости; старые схемы не мигрируют. Перенос React отложен.

Что можно получить

Ваша ситуация	С чего начать	Результат
Помните один подходящий трек	Поиск по референсному треку (seed) в MERT или SONARA	Ранжированный список близких кандидатов для прослушивания
Можете описать звук, но не назвать трек	Текстовый поиск CLAP	Короткий список, подобранный по описанию звучания
Есть несколько опорных точек для сета	Smart Set Builder	Редактируемый черновик порядка с направлением энергии и темпа
Нужен широкий пул для последующего прослушивания	Фильтры, референсные треки или текстовый поиск	Подборка, которую можно экспортировать в CSV или M3U
Регулярно оцениваете треки по собственному признаку	Классификатор Rhythm Lab	Сохранённая оценка каждого трека для фильтров и мягкого влияния на SET или Hybrid

Эта карта поможет выбрать самый короткий путь от текущей идеи к нужному результату. Точные контракты CLI, API, хранилища и моделей находятся в справочном разделе.

Если вы только начинаете

1. Прочитайте раздел Установка.
2. Пройдите Быстрый старт.
3. Создайте базу по инструкции Первая фонотека.
4. Добавьте результаты моделей с помощью страницы Первый анализ.
5. Соберите первый список через поиск по референсным трекам или текстовый поиск.
6. Прослушайте кандидатов, прежде чем превращать их в подборку или сет.

Если вы готовите музыку

• Подготовка сета описывает полный путь от референсных треков до экспорта.
• Поиск совместимых треков подойдёт, когда уже есть один или несколько референсных треков.
• Создание подборок поможет собрать пул для прослушивания без окончательного порядка.
• Smart Set Builder объясняет настройки SET и предварительный просмотр Hybrid.
• Текстовый поиск нужен, когда вы знаете нужное звучание, но не можете выбрать референсный трек.

Если вы хотите понять данные анализа

• Идея проекта объясняет цель локальной драматургии диджейского сета и намеренно скромный масштаб проекта.
• Признаки, эмбеддинги и теги рассказывают, что означает каждый сохранённый результат.
• Оценки сходства объясняют, почему оценки MERT, SONARA, CLAP, SET, Hybrid и Audio Dedup нельзя бездумно смешивать.
• Построение маршрута SET показывает, почему созданный порядок — это черновик, а не гарантия.
• Классификаторы и Rhythm Lab описывают локальные профили и оценки опубликованных моделей.

Если вы обслуживаете фонотеку

• Обслуживание фонотеки предлагает безопасный регулярный порядок действий.
• Подготовка и пересоздание релиза SONARA задаёт порядок резервного копирования, активации, повторного анализа и пересборки классификаторов.
• Теги и запись в аудиофайлы перечисляют все операции, которые действительно меняют файлы.
• Audio Doctor описывает исправления с обязательной предварительной проверкой.
• Audio Dedup описывает поиск дубликатов, который по умолчанию создаёт только отчёт.
• Оптимизация базы данных объясняет обслуживание SQLite с резервной копией.

Если нужен точный контракт

• Справочник CLI перечисляет команды dj-sim и отдельных инструментов.
• Справочник API описывает группы эндпоинтов API и важные структуры данных.
• Справочник конфигурации содержит переменные окружения, порты, локальные артефакты и команды сборки.
• Контракт SONARA v0.2.9 фиксирует четыре контракта результатов и границу Core/Artifacts.
• Элементы интерфейса перечисляют диапазоны и значения по умолчанию.
• Модели и лицензии содержат ссылки на используемые проекты SONARA и модели.

Текущая команда сборки документации

Запускайте из активированного окружения после установки зависимостей Node.js:

cd docs\dj-track-similarity
npm run check

npm run check выполняет строгую проверку Vale для README.md и дерева Markdown VitePress, а затем собирает статический сайт в site/.