Мета

З нуля розгорнути й налаштувати пошуковий мікросервіс на Elasticsearch, який швидко та коректно знаходить товари, підтримує запити за моделями техніки й кодами, і ранжує результати за формулою релевантність/наявність/популярність. Архітектура — модульна, готова до подальшого розширення (реалізація розширень — окремими задачами).

Що потрібно зробити

Інфраструктура

• Розгорнути Elasticsearch і Kibana в Docker (один docker-compose.yml + README з кроками запуску).

• Налаштувати ресурси та зберігання під великий каталог (пам’ять, volume, логи).

• Базова безпека та health-перевірки.

Дані та індексація

• Спроєктувати структуру індексів під: товари, моделі, бренди, тип техніки/деталі та зв’язки між ними.

• Підтримати поля uk/ru і базову нормалізацію тексту (без морфології та без обробки опечаток).

• Виконати первинну індексацію тестової вибірки 10 000+ позицій із збереженням зв’язків «модель ↔ сумісні товари».

• Реалізувати повну й часткову переіндексацію (додавання/оновлення/видалення).

Пошукова логіка (база)

• Пошук товарів за: назвою, описом, брендом, внутрішнім артикулом, кодами виробника (uk/ru поля).

• Пошук за моделлю техніки: при введенні моделі показувати сумісні запчастини; якщо точного збігу немає — близькі моделі.

• Типові сценарії, що мають працювати «з коробки»:

  • «насос samsung»

  • «DC31-00054A»

  • «запчастини для Samsung WF-J125A»

• Ранжування (фіксуємо правило для приймання):
  підсумковий скоринг = релевантність 50% + наявність 25% + популярність 25%; Коефіцієнти мають встановлюватись в конфігах, таким чином, щоб можна було їх змінювати.
  приховані/зняті позиції песимізуються; за однакової релевантності — в наявності вище відсутніх; якщо в запиті явно вказано тип деталі — відповідні товари вище.

• Якщо точного збігу немає — показувати схожі результати за найкращою комбінацією факторів.

• Не входить: морфологія uk/ru, автодоповнення, обробка опечаток, синоніми (окремі задачі).

Спостережуваність

• Метрики: health-endpoint, лічильники запитів/помилок, p95-латентність, % порожньої видачі.

• Дашборд у Kibana для моніторингу індексів і продуктивності.

Критерії приймання

1. Розгортання: сервіс підіймається однією командою з docker-compose.yml; у README — змінні середовища та команди.

2. Індексація: тестові дані завантажено; зв’язки «модель ↔ сумісні товари» працюють; доступні повна та часткова переіндексації.

3. Пошукові сценарії: товари, моделі та коди коректно шукаються uk/ru без морфології та автодоповнення.

4. Ранжування: дотримано формули 50/25/25; приховані/зняті позиції песимізовані; за відсутності точних збігів показані схожі.

5. Продуктивність (демо-стенд):

   • p95 для пошуку за товарами/кодами ≤ 200 мс,

   • p95 для видачі за моделлю та сумісністю ≤ 350 мс
     (у звіті — конфігурація VPS та фактичні заміри).

6. Документація: README з описом індексів і полів, схемою ранжування, прикладами API-запитів/відповідей, інструкціями запуску/переіндексації, описом дашборда Kibana.