Итоговый проект: каталог товаров

Всё начинается с модели и её места в слоях. Product — структура с bson-тегами из пятого урока: тег _id с типом bson.ObjectID из двенадцатого, omitempty у необязательных полей, указатель *time.Time у DeletedAt — так различаются «не удаляли» и «удалили тогда-то», мягкое удаление одиннадцатого урока без отдельного булева флага. Цена — int64 в копейках: деньги в целых числах не теряют копейки на округлении, как это бывает у float64, и сортировка по цене предсказуема. Репозиторий — тот же скелет, что в уроке про слой репозитория: структура с дескриптором коллекции и конструктор, принимающий клиента. Database и Collection в драйвере — дескрипторы без сетевых операций: конструктор репозитория ничего не открывает, первая реальная работа произойдёт на первом запросе. Клиент — один на процесс: mongo.Connect из второго урока в main, Ping на старте, дальше клиент передаётся конструкторам всех репозиториев. Такой каталог mongodb golang-код тестируется без базы: интерфейс ProductRepo подменяется моками — механика из двадцать третьего урока. Поверх репозитория живут HTTP-хендлеры: их работа — перевести параметры запроса в ListParams и вернуть JSON, а все решения о типах и условиях принимаются до вызова репозитория.

Фильтр каталога не известен заранее: пользователь выбрал три бренда, сдвинул ползунок цены, включил «только в наличии». Динамический bson.M собирается по мере прихода параметров: базовое условие deleted_at nil отсекает мягко удалённые товары, дальше категория равенством, бренды через $in, цена диапазоном $gte и $lte, наличие условием stock больше нуля. Карта в фильтре легальна: порядок условий в bson.M не влияет на выборку, поэтому драйвер разрешает мультиключевые карты именно здесь. Сравнение в MongoDB строго по типам BSON: строка «1990» и число 1990 — разные значения, и фильтр по цене со строкой молча вернёт пустую выдачу. Перевод типов — обязанность хендлера: strconv для чисел из query-параметров, time.Parse для дат, и только потом фильтр. Поиск по префиксу названия прикрывается $regex с якорем: анкернутый шаблон работает по индексу, без якоря — сканирует. Фильтр удобно строить отдельным методом: toBSON у ListParams возвращает bson.M, тесты подают параметры и сверяют собранный документ — логика условий проверяется без базы и без HTTP. Логика $and и $or из четырнадцатого урока тоже доступна, но простые поля каталога обходятся равенствами и диапазонами — конвейер фильтрации остаётся плоским и читаемым.

Страница каталога собирается одной цепочкой options.Find(): SetSort задаёт порядок, SetSkip и SetLimit режут окно, SetProjection снимает тяжёлое описание с ленты, а массивы в документах режет $slice: галерея из двадцати ссылок карточке в списке не нужна — трёх хватает. Сортировка — только bson.D: порядок полей в ней значим, и карта из двух ключей упадёт с ErrMapForOrderedArgument ещё до отправки запроса — та самая проверка из тринадцатого урока. Для каталога сортировка ходит в паре с фильтром: «внутри категории по цене» — и составной индекс категория плюс цена работает по правилу Equality-Sort-Range из семнадцатого урока. Пагинация математически проста: skip равен номеру страницы минус один, умноженному на размер страницы, а оба аргумента — int64, поэтому переменную int компилятор просит конвертировать явно. У skip есть цена: сервер проходит и отбрасывает все пропущенные документы, значит страница номер пятьсот дорожает линейно. Для кнопки «показать ещё» применяйте keyset-пагинацию по _id из двенадцатого урока: условие _id меньше последнего на экране плюс сортировка по _id убыванию — дёшево на любой глубине, потому что опирается на первичный индекс. Номера страниц оставьте для первых двадцати-тридцати листаний, глубже — только keyset.

Счётчики в каталоге живут в трёх видах, и у каждого своя цена. CountDocuments принимает фильтр, но внутри это агрегация: драйвер строит конвейер из $match и $group со счётчиком $sum, и стоимость пропорциональна числу совпавших документов — под популярной категорией на двадцати тысячах товаров это заметная работа на каждый запрос. EstimatedDocumentCount фильтр не принимает вовсе: он выполняет команду count по метаданным коллекции и отвечает мгновенно — глобальные бейджи «всего товаров» и метрики админки. Панели каталога нужны страница и счётчик под тем же фильтром одновременно, а два запроса — это два round trip'а. Этап $facet решает задачу одним запросом: он держит несколько подконвейеров над одним набором входных документов и складывает результаты в поля выходного документа — items со страницей и total со счётчиком $count. Два правила эксплуатации. Фильтр ставьте этапом $match до $facet: условие сработает по индексу, а фасеты получат суженный набор; $facet первым этапом читает коллекцию целиком. Счётчик $count на пустом входе не выдаёт документа — массив фасета останется пустым, и чтение нулевого элемента без проверки длины паникует. Для популярных сочетаний фильтров счётчик кэшируют на несколько секунд или пересчитывают по Change Streams: витрине не нужна точность до единицы на каждое нажатие. Ограничения мелкие: подконвейеры не принимают $out, $merge и $geoNear, а выходной документ подчиняется лимиту 16 МБ.

Проект заканчивается не кодом запросов, а эксплуатацией. Индексы заводятся при старте методом EnsureIndexes из семнадцатого урока: составной ключ категория плюс цена под сортировку внутри категории, уникальный индекс по sku под импорты из прайс-листов, текстовый индекс по name и description с весами — один на коллекцию. Валидация схемы из двадцать второго урока прикрывает вставки со стороны админки: $jsonSchema не пропустит цену строкой и товар без названия — те же грабли, о которых предупреждал коллаут про типы. Ошибки классифицируются предикатами двадцатого урока и превращаются в HTTP-статусы: IsDuplicateKeyError на импорте даёт 409 с именем индекса, IsTimeout — 503 с ретраем на чтении, ErrNoDocuments при FindOne карточки товара — 404. Пул — из двадцать четвёртого урока: клиент один, SetMaxPoolSize настраивается под пропускную способность, горутины берут соединения и отдают без задержек; длинных ручных итераций по курсору на горячих путях быть не должно — All закрывает курсор сам. Для фоновых сценариев есть Change Streams девятнадцатого урока: витрина узнаёт о новой цене из потока событий, а не опросом.