Dlaczego wyszukiwanie działa na osobnym silniku?
Meilisearch to otwartoźródłowy silnik wyszukiwania pełnotekstowego napisany w języku Rust, który można uruchomić u siebie albo kupić jako usługę Meilisearch Cloud. W Endora Commerce jest częścią standardowego stosu, obok PostgreSQL i Redisa, a nie dodatkiem z wyższego planu.
Dla katalogu B2B liczą się trzy jego cechy: tolerancja literówek, wyniki zwracane w trakcie pisania i filtrowanie po dowolnych zadeklarowanych polach. Platforma celuje w czas odpowiedzi wyszukiwarki poniżej 200 ms w 95. percentylu, a demo działa na katalogu ponad 120 tysięcy SKU.
Co trafia do indeksu, a co celowo nie
Każdy kanał sprzedaży ma własny indeks, więc portal dystrybutora i publiczny sklep mogą mieć różny asortyment i nie widzą nawzajem swoich produktów. W indeksie leży jeden dokument na produkt: SKU, nazwa, opis, typ, kategorie, atrybuty i adres głównego zdjęcia. Nazwa jest zapisywana w domyślnym języku kanału, z uwzględnieniem nadpisań treści ustawionych dla kanału i języka.
O tym, po czym da się szukać i filtrować, decydują flagi atrybutów w katalogu. Atrybut oznaczony jako wyszukiwalny trafia do pól przeszukiwanych, oznaczony jako filtrowalny do pól filtrów, a zmiana flagi odświeża ustawienia indeksu. Dla atrybutów typu lista wyboru indeksowana jest też etykieta opcji w języku kanału, więc kupujący wpisujący „Czerwony” znajdzie produkt, którego wartość w bazie to klucz red.
W dokumencie nie ma ceny. W B2B cena zależy od kupującego, a jeden dokument na produkt nie pomieści cennika każdej organizacji. Meilisearch zwraca więc identyfikatory trafień, a platforma dociąga produkty z bazy, odrzuca te, których dany kupujący nie może widzieć, i wylicza cenę z jego cennika. Jak działa ta część, opisuje wpis o silniku cenowym.
Jak indeks nadąża za katalogiem
- Utworzenie, zmiana i archiwizacja produktu wywołują zdarzenie katalogu, które aktualizuje albo usuwa pojedynczy dokument. Zdarzenie przechodzi przez tę samą kolejkę Redis, która obsługuje webhooki i pocztę.
- Proces roboczy co pewien czas przebudowuje indeksy w całości. Odstęp jest ustawieniem, domyślnie 10 minut.
- Pełną przebudowę można wymusić z panelu albo poleceniem CLI, które odtwarza indeks każdego kanału z PostgreSQL.
Indeks nie jest więc źródłem prawdy. Można go skasować i zbudować od nowa, nic się nie gubi.
Co widzi kupujący, a co ustawia administrator
W nagłówku sklepu działa pole z podpowiedziami: po krótkiej pauzie w pisaniu pojawia się lista produktów, po której można poruszać się strzałkami. Pełna strona wyników to ten sam widok co listing katalogu, z tymi samymi filtrami, paginacją i sortowaniem według trafności, daty dodania albo nazwy. Formularz działa także bez JavaScriptu.
Ustawienia wyszukiwarki są osobne dla każdego kanału:
| Ustawienie | Wartość domyślna |
|---|---|
| Liczba produktów w podpowiedziach | 8 |
| Minimalna długość frazy uruchamiająca popup | 3 znaki |
| Wyszukiwanie hybrydowe | wyłączone |
Każda zatwierdzona fraza jest zapisywana razem z kanałem i liczbą wyników, również wtedy, gdy wynik był pusty. Zapis odbywa się w tle i nie opóźnia odpowiedzi sklepu.
Wyszukiwanie hybrydowe
Po włączeniu trybu hybrydowego platforma podpina do indeksu kanału embedder, a Meilisearch łączy dopasowanie fraz z dopasowaniem znaczeniowym. Embedder to dowolny punkt zgodny z API OpenAI: samo OpenAI, Azure OpenAI albo lokalnie uruchomiona Ollama, jeśli dane katalogu nie mają opuszczać Twojej infrastruktury. Panel nie pozwoli włączyć trybu, dopóki dla kanału nie podano adresu, klucza i modelu, a wyłączenie przywraca zwykły ranking leksykalny.
Gdy Meilisearch nie odpowiada
Awaria silnika nie blokuje zapisu produktów i nie wyłącza katalogu. Listing przechodzi wtedy na zapytanie do PostgreSQL: bez tolerancji literówek, ale sklep dalej sprzedaje. Sonda gotowości platformy sprawdza wyszukiwarkę razem z bazą i cache.
Przed uruchomieniem
Po stronie Meilisearch potrzebna jest działająca instancja (własna albo w Meilisearch Cloud), jej adres i klucz API, które podaje się w konfiguracji backendu. W trybie produkcyjnym Meilisearch wymaga ustawienia klucza głównego. Indeksy platforma zakłada sama.
Warto znać kilka ograniczeń silnika:
- W zapytaniu uwzględnianych jest najwyżej 10 słów, więc wklejony długi opis techniczny zostanie obcięty.
- Jedno wyszukiwanie zwraca domyślnie do 1000 dokumentów.
- Domyślnie dopuszczana jest jedna literówka w słowach od 5 znaków i dwie od 9 znaków. To zachowanie silnika opisane w dokumentacji tolerancji literówek i warto je sprawdzić na własnych danych, jeśli katalog opiera się na podobnych do siebie numerach katalogowych.