From 4cab703b82ad7c0bc61e9aeeb5bbedd5b4e7c026 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <noreply@anthropic.com>
Date: Thu, 2 Jul 2026 20:55:27 +0300
Subject: [PATCH] =?UTF-8?q?feat(bot):=20KnowledgeSearch=20=E2=80=94=20FTS?=
 =?UTF-8?q?=20russian=20top-N=20=D1=81=20=D1=80=D0=B0=D0=BD=D0=B6=D0=B8?=
 =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5=D0=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 app/app/Services/Bot/KnowledgeSearch.php      | 40 +++++++++++++++++
 app/tests/Feature/Bot/KnowledgeSearchTest.php | 44 +++++++++++++++++++
 2 files changed, 84 insertions(+)
 create mode 100644 app/app/Services/Bot/KnowledgeSearch.php
 create mode 100644 app/tests/Feature/Bot/KnowledgeSearchTest.php

diff --git a/app/app/Services/Bot/KnowledgeSearch.php b/app/app/Services/Bot/KnowledgeSearch.php
new file mode 100644
index 00000000..a26e5be4
--- /dev/null
+++ b/app/app/Services/Bot/KnowledgeSearch.php
@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\Bot;
+
+use App\Models\KnowledgeChunk;
+use Illuminate\Support\Collection;
+
+/**
+ * Поиск по базе знаний бота: PostgreSQL FTS (russian) по generated-колонке
+ * search_tsv (title+topics+content), ранжирование ts_rank. websearch_to_tsquery
+ * терпим к пользовательскому вводу (спецсимволы не ломают запрос).
+ * Интерфейс намеренно узкий — замена на pgvector позже не тронет вызывающих.
+ *
+ * @return list<KnowledgeChunk>
+ */
+class KnowledgeSearch
+{
+    public function search(string $question, int $limit = 3): array
+    {
+        $question = trim($question);
+        if ($question === '') {
+            return [];
+        }
+
+        /** @var Collection<int, KnowledgeChunk> $hits */
+        $hits = KnowledgeChunk::query()
+            ->selectRaw(
+                "knowledge_chunks.*, ts_rank(search_tsv, websearch_to_tsquery('russian', ?)) AS rank",
+                [$question]
+            )
+            ->whereRaw("search_tsv @@ websearch_to_tsquery('russian', ?)", [$question])
+            ->orderByDesc('rank')
+            ->limit($limit)
+            ->get();
+
+        return $hits->all();
+    }
+}
diff --git a/app/tests/Feature/Bot/KnowledgeSearchTest.php b/app/tests/Feature/Bot/KnowledgeSearchTest.php
new file mode 100644
index 00000000..ab21cad1
--- /dev/null
+++ b/app/tests/Feature/Bot/KnowledgeSearchTest.php
@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\KnowledgeChunk;
+use App\Services\Bot\KnowledgeSearch;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+
+uses(RefreshDatabase::class);
+
+beforeEach(function () {
+    KnowledgeChunk::create([
+        'source_path' => 'help/p.md', 'title' => 'Что такое проект', 'tour' => 'create-project',
+        'topics' => 'создать проект, заявка на лиды', 'chunk_index' => 0,
+        'content' => 'Проект — это заявка на поток клиентов с выбранного источника.',
+    ]);
+    KnowledgeChunk::create([
+        'source_path' => 'help/b.md', 'title' => 'Как пополнить баланс', 'tour' => 'top-up-balance',
+        'topics' => 'пополнить, закинуть деньги, оплата', 'chunk_index' => 0,
+        'content' => 'Пополнить баланс: раздел Биллинг, кнопка Пополнить.',
+    ]);
+});
+
+it('находит релевантный чанк и ранжирует его первым', function () {
+    $hits = app(KnowledgeSearch::class)->search('а что такое проект?', 3);
+
+    expect($hits)->not->toBeEmpty()
+        ->and($hits[0]->title)->toBe('Что такое проект');
+});
+
+it('находит по синонимам из topics («закинуть деньги»)', function () {
+    $hits = app(KnowledgeSearch::class)->search('как закинуть деньги', 3);
+
+    expect($hits)->not->toBeEmpty()
+        ->and($hits[0]->title)->toBe('Как пополнить баланс');
+});
+
+it('на вопрос не по теме возвращает пусто', function () {
+    expect(app(KnowledgeSearch::class)->search('какая погода в москве', 3))->toBeEmpty();
+});
+
+it('не падает на спецсимволах в вопросе', function () {
+    expect(app(KnowledgeSearch::class)->search('проект & | ! ( )', 3))->toBeArray();
+});