Релевантность отвечает, насколько товар похож на запрос, а наличие — имеет ли пользователь право увидеть его как доступный сейчас. Не пытайтесь «понизить score» товара без остатка: при слабой конкуренции он всё равно останется в выдаче. Жёсткое бизнес-условие должно находиться в filter context.
Возьмите один неверный SKU и запишите channel, регион или склад, способ доставки, inventory version, время изменения в источнике и содержимое документа в конкретном search index. Фраза «остаток ноль» без этих измерений неполна: товар может быть доступен для доставки, но не для самовывоза, или наоборот.
Доступность — вычисленное правило, а не одно число
| Симптом | Возможная причина | Проверка |
|---|---|---|
| Товар виден во всех регионах | Поле не разделено по region/channel | Document mapping и filter запроса |
| Исчезает с задержкой | Inventory event ещё не проиндексирован или не refreshed | Event 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 остаётся последней проверкой истины
- Поиск фильтрует документ для выбранного channel и location.
- Карточка товара показывает свежесть и запрашивает актуальную доступность при необходимости.
- Добавление в корзину повторно проверяет и, если предусмотрено, резервирует quantity.
- Checkout атомарно подтверждает reservation либо возвращает понятную замену.
- Reconciliation исправляет расхождение индекса и публикует метрику, а не скрывает его.
Приёмочный тест должен обновить остаток 1→0, дождаться измеряемой поисковой видимости и проверить исчезновение SKU, затем доставить старое событие повторно и убедиться, что товар не вернулся. Для разбора достаточно mapping, обезличенного документа, JSON query, source/index versions и времён стадий. Полный каталог и доступ к production не нужны.