🗂️ Категории, коллекции и поисковый индекс

Категории строят навигацию каталога. Коллекции объединяют товары для отдельных подборок и не образуют дерево.

Категории

Путь: Админка → Категории.

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

Иерархия и порядок

1. Откройте Админка → Категории.
2. Нажмите «Редактировать рейтинг».
3. Перетаскивайте категории, чтобы изменить родителя и порядок.
4. Сохраните изменения.

Витрина показывает только активные публичные категории. Порядок на витрине совпадает с порядком, сохранённым в админке. Если скрыт родитель, его дочерние страницы тоже недоступны.

Как скрыть категорию

Откройте категорию → «Редактировать» и выберите один из вариантов:

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

Оба варианта убирают категорию из дерева витрины и закрывают её страницу.

:::warning Категория и товар скрываются отдельно Скрытие категории не снимает её товары с публикации. Опубликованный товар может остаться в общем каталоге, поиске или другой публичной категории. Чтобы скрыть сам товар, переведите его в черновик. :::

Коллекции

Путь: Админка → Коллекции.

Коллекция — плоский список товаров. У неё нет родителя, ручного порядка на витрине, статуса или переключателя видимости. В карточке коллекции можно добавлять и удалять товары.

Коллекция с точным названием «Акции» имеет специальное назначение: её товары попадают в карусель акций на главной. Это не промокод и не автоматическая скидка — цена товара сама по себе не меняется.

Чтобы убрать подборку, удалите из неё товары или удалите саму коллекцию. Перед удалением «Акции» проверьте главную страницу: карусель станет пустой.

Поисковый индекс (*)

Изменения товаров, вариантов, категорий и остатков автоматически отправляются в поиск. Ручной запуск для обычной работы не нужен.

:::warning Кнопки полной переиндексации нет В админке и Admin API проекта нет действия «Переиндексировать». Полный запуск доступен только разработчику из каталога apps/backend:

npx medusa exec ./src/scripts/reindex-catalog.ts

:::

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

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