# Каталог Vesremont

## Структура

`/catalog/` — корень каталога. Категории, подкатегории, бренды и часть фасетных значений представлены валидированными путями под `/catalog/`. Товар имеет путь, начинающийся с `/catalog/product/`.

Каталог серверно рендерит:

- хлебные крошки и ссылки на родительские разделы;
- дочерние категории;
- выбранные фильтры и ссылки сброса;
- категориальные фасеты как `a[href]`;
- числовые диапазоны как number/range inputs с `data-*` контрактом;
- карточки товаров как ссылки;
- сортировку и пагинацию как ссылки.

JavaScript перехватывает клики для AJAX-обновления, но опубликованные `href` остаются полноценными URL и открываются напрямую.

## Рекомендуемый алгоритм агента

1. Откройте `/catalog/` либо подходящий URL из sitemap.
2. Переходите по ссылкам категорий до нужного раздела.
3. Для категориального фильтра используйте точный `href` его значения.
4. Для range прочитайте контейнер `[data-filter-type="range"]`, затем постройте query по [правилам диапазонов](https://vesremont.com/llms/filters.md).
5. После каждого перехода заново читайте актуальные фасеты, количества и ссылки: они зависят от текущей комбинации.
6. Откройте товар по ссылке карточки и проверьте цену, остаток и возможность заказа на самой карточке.

## Важное ограничение пути

Пользовательская механика размещает до трёх валидных символьных кодов в path, а дополнительные значения — в повторяемых `filter` query-параметрах. Порядок path-сегментов выбирается из актуальных серверных данных каталога и валидируется сервером. Поэтому самостоятельно переставлять или соединять символьные коды нельзя: используйте готовые `href` текущей страницы.

## Отзывы категории

Для валидного состояния каталога может существовать страница `{catalog-url}otziv/`. На ней доступны отзывы товаров выбранной категории/фасетного состояния. Query-параметры этой страницы описаны в [URL-грамматике](https://vesremont.com/llms/url-patterns.md).