Релевантность отвечает, насколько товар похож на запрос, а наличие — имеет ли пользователь право увидеть его как доступный сейчас. Не пытайтесь «понизить score» товара без остатка: при слабой конкуренции он всё равно останется в выдаче. Жёсткое бизнес-условие должно находиться в filter context.

Возьмите один неверный SKU и запишите channel, регион или склад, способ доставки, inventory version, время изменения в источнике и содержимое документа в конкретном search index. Фраза «остаток ноль» без этих измерений неполна: товар может быть доступен для доставки, но не для самовывоза, или наоборот.

Доступность — вычисленное правило, а не одно число

СимптомВозможная причинаПроверка
Товар виден во всех регионахПоле не разделено по region/channelDocument mapping и filter запроса
Исчезает с задержкойInventory event ещё не проиндексирован или не refreshedEvent lag, bulk response, refresh interval
Снова появился со старым остаткомСобытия применены не по версииSource version и порядок consumer offsets
Фильтр есть, но не действуетДругая ветка bool или неверный тип поляПолный JSON query и mapping
Поиск скрывает, checkout всё равно отказываетReservation изменила остаток после поискаПовторная проверка в authoritative inventory

Документ поиска удобно денормализовать: is_available, available_qty либо список sellable_channels вычисляются из авторитетной системы. Но формула должна включать reserved quantity, safety stock, статус публикации, регион и обещанный способ доставки. Elasticsearch не становится системой бронирования только потому, что хранит копию остатка.

Текст ранжируется, доступность фильтруется

{
  "query": {
    "bool": {
      "must": [{ "multi_match": { "query": "кофемолка", "fields": ["name^3", "description"] }}],
      "filter": [
        { "term": { "is_available": true } },
        { "term": { "channel": "delivery-msk" } },
        { "range": { "available_qty": { "gte": 1 } } }
      ]
    }
  }
}

Это пример модели, а не обязательная схема: is_available и available_qty могут быть избыточны, если они вычислены по разным правилам. Elastic описывает filter context как бинарную проверку без влияния на score; такие фильтры подходят для точных структурированных значений и могут кэшироваться.

Событие остатка должно победить только более старую версию

Consumer индекса хранит для SKU монотонную source version или revision. Событие с меньшей версией после retry игнорируется; с большей — пересчитывает документ и подтверждается только после успешного bulk item response. Timestamp приложения хуже версии: часы узлов расходятся, а два изменения способны иметь одинаковое время.

  • Передавать SKU, scope availability и source version в каждом событии.
  • Проверять ошибку каждого элемента bulk response, а не только HTTP запроса.
  • Хранить dead-letter с причиной без персональных данных покупателя.
  • Периодически сверять выборку источника и индекса и переиндексировать расхождения.
  • Измерять event-to-searchable latency, lag consumer и возраст последнего события.

Успешный update ещё не означает немедленную видимость в search

Elasticsearch работает near real-time: изменения становятся видимыми поиску после refresh. Официальная документация указывает, что refresh открывает недавние операции для поиска; принудительный refresh ресурсоёмок. Для пользовательского действия, которое обязано увидеть собственное изменение, рассмотрите refresh=wait_for, но не включайте refresh=true на каждое событие остатков без нагрузочного теста.

Refresh объясняет короткое окно, но не многоминутное отставание. Для долгой задержки проследите outbox, broker offset, consumer retry, bulk errors, alias и фактический index. Частая ошибка — обновить новый индекс, пока search alias всё ещё смотрит на старый, либо читать один документ из другого environment.

Checkout остаётся последней проверкой истины

  1. Поиск фильтрует документ для выбранного channel и location.
  2. Карточка товара показывает свежесть и запрашивает актуальную доступность при необходимости.
  3. Добавление в корзину повторно проверяет и, если предусмотрено, резервирует quantity.
  4. Checkout атомарно подтверждает reservation либо возвращает понятную замену.
  5. Reconciliation исправляет расхождение индекса и публикует метрику, а не скрывает его.

Приёмочный тест должен обновить остаток 1→0, дождаться измеряемой поисковой видимости и проверить исчезновение SKU, затем доставить старое событие повторно и убедиться, что товар не вернулся. Для разбора достаточно mapping, обезличенного документа, JSON query, source/index versions и времён стадий. Полный каталог и доступ к production не нужны.

Проверенные источники