Přeskočit na hlavní obsah

🔍 Diagnostika problémů s vyhledáváním v Upsearch

Tato stránka slouží jako pomocník při řešení problémů s vyhledáváním produktů, značek, kategorií či dalších objektů v systému Upsearch. Níže uvedený diagram a checklisty vás krok za krokem provedou možnými příčinami nefunkčního vyhledávání.

🧭 Rozhodovací diagram​

Diagnostika vyhledávání produktu

Diagram pokrývá celý proces:

  • Od ověření, zda je produkt obsažen ve zdrojovém XML feedu,
  • přes kontrolu databáze (elastic_items) a synchronizace (sync = 1),
  • až po kontrolu nahrání do Elasticsearch a konfiguraci relevance tuning.

Odkaz na plnou verzi diagramu:
👉 /img/diagram.png

✅ Checklist problémů ve vyhledávači (Upsearch)​

1. 🔍 Vyhledávač vůbec nic nenajde / nefunguje​

  • Je Elasticsearch server dostupný?
  • Vrací REST API chybu (např. 500 nebo 503)?
  • Funguje Upsearch na jiném projektu?
  • Jsou všechny indexy v Elasticsearch „green“ a „open“?
  • Dá se otevřít index příkazem POST index_name/_open?

2. 🔍 Produkt nelze vůbec najít ve vyhledávači​

  • Je produkt ve zdrojovém XML feedu?
  • Má produkt unikátní a vyplněný unique key?
  • Byl produkt z XML úspěšně zpracován posl. 2h? (není v „items with error“?)
  • Je produkt v databázové tabulce elastic_items?
  • Má v databázi sync = 1?
  • Je produkt nahrán do Elasticsearch (zobrazit ve „Dokumenty“)?
  • Neodstranil ho cron (např. nebyl ve feedu)?
  • Je aktivní v nastavení „search in this collection“?
  • Není chyba v relevanci (Text Search, Fuzzy, Stemmer, Autocomplete)?

3. 📂 Kategorie nebo značka nejde najít v autocomplete​

  • Je daný parametr označen jako Autocomplete Search v relevance tuning?
  • Má nastavenou dostatečnou váhu (~1)?
  • Je objekt zaškrtnut jako search in this collection – Autocomplete v result settings?
  • Je kategorie vůbec ve feedu? A správně mapovaná?

4. 🗑️ Smazaný produkt se stále zobrazuje ve výsledcích​

  • Není produkt ve zdrojovém XML feedu?
  • Proběhl reindex nebo refresh dat?
  • Funguje běh cronu cleaner.php?

🧑‍💻 Kontakty​

Pro technické dotazy kontaktujte:

  • Vedoucí vývoje: Jakub Kratina → kratina@praguebest.cz
  • Projektový manažer: Prokop Blumel, Aleš Příbramský

ℹ️ Tento dokument je živý a měl by být pravidelně aktualizován s novými informacemi a postupy.