From bc57cb82fee55d8a2cfccbd0c43ce3c3b3c63b8c Mon Sep 17 00:00:00 2001
From: Codex Agent <agent@vakanaut.ru>
Date: Fri, 25 Sep 2026 08:52:45 +0300
Subject: [PATCH 1/8] fix: relax content search for long queries

---
 backend/README.md                    |  4 +--
 backend/search/api.py                |  2 +-
 backend/search/minjust_opensearch.py |  2 +-
 backend/search/query.py              | 37 ++++++++++++++++++++++++++--
 backend/search/review.html           |  2 +-
 backend/test_search_relevance.py     | 23 +++++++++++++++++
 6 files changed, 63 insertions(+), 7 deletions(-)

diff --git a/backend/README.md b/backend/README.md
index 9713de9..63b5bda 100644
--- a/backend/README.md
+++ b/backend/README.md
@@ -1,6 +1,6 @@
 # Backend Акылдаш
 
-Версия: `0.10.3`
+Версия: `0.10.4`
 
 Первая backend-область проекта — загрузка правовых документов из официального
 Open Data API ЦБД Минюста Кыргызской Республики. Код расположен в
@@ -240,4 +240,4 @@ PYTHONPATH=backend python3 -m search.query "ЖЧК ачуу тартиби" --la
 
 ---
 
-Акылдаш · Backend v0.10.3 · Frontend — не создан
+Акылдаш · Backend v0.10.4 · Frontend — не создан
diff --git a/backend/search/api.py b/backend/search/api.py
index 7659d50..70c2e4a 100644
--- a/backend/search/api.py
+++ b/backend/search/api.py
@@ -17,7 +17,7 @@ from search.reviews import ReviewSnapshots, ReviewStore
 
 
 API_VERSION = "v1"
-SEARCH_ALGORITHM_VERSION = "search-5"
+SEARCH_ALGORITHM_VERSION = "search-6"
 LANGUAGES = {"ru", "ky"}
 CODE = re.compile(r"^[0-9]+$")
 MAX_PAGE_SIZE = 100
diff --git a/backend/search/minjust_opensearch.py b/backend/search/minjust_opensearch.py
index fa8f9a4..7e3f841 100644
--- a/backend/search/minjust_opensearch.py
+++ b/backend/search/minjust_opensearch.py
@@ -17,7 +17,7 @@ from typing import Iterator
 
 from search.catalog import authority_codes, legal_force_code, source_code
 
-APP_VERSION = "0.10.3"
+APP_VERSION = "0.10.4"
 LANGUAGES = {"ru", "ky"}
 DEFAULT_MAPPING = Path(__file__).with_name("minjust-fragments-index.json")
 
diff --git a/backend/search/query.py b/backend/search/query.py
index 40690e9..685c1eb 100644
--- a/backend/search/query.py
+++ b/backend/search/query.py
@@ -24,6 +24,18 @@ LEGAL_FORM_ALIASES = {
 }
 COMPANY_REGISTRATION_DOCUMENTS = (("230044970", 3000), ("667", 2000), ("4", 1000))
 TAX_PROFIT_DOCUMENTS = (("112340", 3000),)
+BOILERPLATE_PREFIXES = {
+    "ru": ("как регулируется", "правовое регулирование", "судебная практика", "сроки и ответственность"),
+    "ky": (),
+}
+
+
+def relaxed_query_text(language: str, query: str) -> str:
+    value = query.strip()
+    for prefix in BOILERPLATE_PREFIXES[language]:
+        if value.casefold().startswith(prefix):
+            return value[len(prefix):].strip()
+    return value
 
 
 def query_variants(language: str, query: str) -> list[str]:
@@ -100,6 +112,7 @@ def tax_profit_clauses(language: str, query: str) -> list[dict]:
 def build_search_query(language: str, query: str) -> dict:
     registration_clauses = company_registration_clauses(language, query)
     intent_clauses = [*registration_clauses, *tax_profit_clauses(language, query)]
+    variants = query_variants(language, query)
     full_text = [
         {
             "multi_match": {
@@ -109,13 +122,33 @@ def build_search_query(language: str, query: str) -> dict:
                 "operator": "OR" if registration_clauses else "AND",
             }
         }
-        for variant in query_variants(language, query)
+        for variant in variants
     ]
+    relaxed_text = []
+    if not registration_clauses:
+        seen_relaxed = set()
+        for variant in variants:
+            value = relaxed_query_text(language, variant)
+            words = value.split()
+            if value in seen_relaxed or len(words) < 2 or (value == variant.strip() and len(words) < 3):
+                continue
+            if len(words) < 3 and not any(len(word) >= 5 for word in words):
+                continue
+            seen_relaxed.add(value)
+            relaxed_text.append({
+                "multi_match": {
+                    "query": value,
+                    "fields": [f"document_name_{language}^4", f"text_{language}"],
+                    "type": "cross_fields",
+                    "operator": "OR",
+                    "boost": 0.1,
+                }
+            })
     phrase_matches = [
         {"match_phrase": {f"text_{language}": {"query": variant, "boost": 3}}}
         for variant in query_variants(language, query)
     ]
-    planned = {"should": [*full_text, *phrase_matches, *intent_clauses], "minimum_should_match": 1}
+    planned = {"should": [*full_text, *phrase_matches, *relaxed_text, *intent_clauses], "minimum_should_match": 1}
     return {"bool": planned}
 
 
diff --git a/backend/search/review.html b/backend/search/review.html
index f5d4316..4ac1cf1 100644
--- a/backend/search/review.html
+++ b/backend/search/review.html
@@ -117,7 +117,7 @@
   <div class="review__actions"><div class="review__actions-inner"><label>Ваше имя или псевдоним<input id="reviewer" maxlength="120" autocomplete="name" placeholder="Например, Айжан К."></label> <label>Комментарий к выдаче <input id="overall-comment" maxlength="4000" placeholder="Что важно учесть? (необязательно)"></label> <button class="review__button--primary" id="save" type="button">Сохранить разметку</button></div></div>
   <dialog id="document-dialog"><button class="review__dialog-close" id="dialog-close" type="button">Закрыть</button><h2 id="dialog-heading">Документ</h2><div class="review__document-body" id="dialog-body"></div></dialog>
   <div class="review__tour-spotlight" id="tutorial-spotlight" hidden aria-hidden="true"></div><dialog class="review__tour" id="tutorial-dialog" aria-labelledby="tutorial-heading" aria-describedby="tutorial-text"><div class="review__tour-content"><p class="review__tour-kicker">Короткое знакомство</p><h2 id="tutorial-heading"></h2><p id="tutorial-text"></p><div class="review__tour-footer"><span class="review__tour-progress" id="tutorial-progress"></span><div class="review__tour-actions"><button id="tutorial-skip" type="button">Пропустить</button><button class="review__button--primary" id="tutorial-next" type="button">Далее</button></div></div></div></dialog>
-  <footer class="review__header">Акылдаш · Backend v0.10.3 · Внутренняя лаборатория релевантности</footer>
+  <footer class="review__header">Акылдаш · Backend v0.10.4 · Внутренняя лаборатория релевантности</footer>
   <script>
     const DRAFT_KEY = 'akyldash-search-review-draft';
     const TOUR_KEY = 'akyldash-search-review-tour-seen';
diff --git a/backend/test_search_relevance.py b/backend/test_search_relevance.py
index 3dfe394..0b6bfd1 100644
--- a/backend/test_search_relevance.py
+++ b/backend/test_search_relevance.py
@@ -49,6 +49,29 @@ class SearchRelevanceTest(unittest.TestCase):
         self.assertIn("регистрация осоо", [variant.casefold() for variant in query_variants("ru", "регистрация общества с ограниченной ответственностью")])
         self.assertIn("жчк ачуу тартиби", [variant.casefold() for variant in query_variants("ky", "жоопкерчилиги чектелген коом ачуу тартиби")])
 
+    def test_relaxed_match_drops_ru_template_prefix_and_stays_low_weight(self):
+        body = json.loads(build_search_body("ru", "правовое регулирование расторжение договора аренды", 10))
+        clauses = body["query"]["bool"]["must"]["bool"]["should"]
+        strict = [item["multi_match"] for item in clauses if "multi_match" in item and item["multi_match"].get("operator") == "AND"]
+        relaxed = [item["multi_match"] for item in clauses if "multi_match" in item and item["multi_match"].get("boost") == 0.1]
+        self.assertEqual(strict[0]["query"], "правовое регулирование расторжение договора аренды")
+        self.assertEqual(relaxed[0]["query"], "расторжение договора аренды")
+        self.assertEqual(relaxed[0]["operator"], "OR")
+        self.assertNotIn("boost", strict[0])
+
+    def test_relaxed_match_supports_kyrgyz_and_avoids_short_named_acts(self):
+        ky = json.loads(build_search_body("ky", "эмгек келишимин бузуу шарттары", 10))
+        ky_clauses = ky["query"]["bool"]["must"]["bool"]["should"]
+        self.assertTrue(any(item.get("multi_match", {}).get("operator") == "OR" and item["multi_match"].get("boost") == 0.1 for item in ky_clauses))
+
+        named_act = json.loads(build_search_body("ru", "Гражданский кодекс", 10))
+        act_clauses = named_act["query"]["bool"]["must"]["bool"]["should"]
+        self.assertFalse(any(item.get("multi_match", {}).get("boost") == 0.1 for item in act_clauses))
+
+        short_template = json.loads(build_search_body("ru", "как регулируется взыскание алиментов", 10))
+        short_clauses = short_template["query"]["bool"]["must"]["bool"]["should"]
+        self.assertTrue(any(item.get("multi_match", {}).get("query") == "взыскание алиментов" and item["multi_match"].get("boost") == 0.1 for item in short_clauses))
+
     def test_company_registration_intent_boosts_current_documents(self):
         for language, query, status in (
             ("ru", "как открыть ОсОО", "Действует"),
-- 
2.54.0


From 3b56445bb2851e42f5ea7e8f013ac582dc8b5ba7 Mon Sep 17 00:00:00 2001
From: Codex Agent <agent@vakanaut.ru>
Date: Fri, 25 Sep 2026 08:59:51 +0300
Subject: [PATCH 2/8] fix: constrain relaxed search matches

---
 backend/search/query.py          | 12 ++++++++++--
 backend/test_search_relevance.py |  5 +++++
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/backend/search/query.py b/backend/search/query.py
index 685c1eb..9066ad0 100644
--- a/backend/search/query.py
+++ b/backend/search/query.py
@@ -25,7 +25,10 @@ LEGAL_FORM_ALIASES = {
 COMPANY_REGISTRATION_DOCUMENTS = (("230044970", 3000), ("667", 2000), ("4", 1000))
 TAX_PROFIT_DOCUMENTS = (("112340", 3000),)
 BOILERPLATE_PREFIXES = {
-    "ru": ("как регулируется", "правовое регулирование", "судебная практика", "сроки и ответственность"),
+    "ru": (
+        "как регулируется", "правовое регулирование", "судебная практика", "сроки и ответственность",
+        "действующая редакция", "последние изменения", "основные положения", "комментарий к акту",
+    ),
     "ky": (),
 }
 
@@ -38,6 +41,10 @@ def relaxed_query_text(language: str, query: str) -> str:
     return value
 
 
+def is_named_act_query(language: str, query: str) -> bool:
+    return language == "ru" and bool(re.search(r"\b(?:кодекс\w*|конституци\w*|закон\s+кыргызской\s+республики)\b", query.casefold()))
+
+
 def query_variants(language: str, query: str) -> list[str]:
     variants = [query]
     for alias, expansions in LEGAL_FORM_ALIASES[language].items():
@@ -125,7 +132,7 @@ def build_search_query(language: str, query: str) -> dict:
         for variant in variants
     ]
     relaxed_text = []
-    if not registration_clauses:
+    if not registration_clauses and not is_named_act_query(language, query):
         seen_relaxed = set()
         for variant in variants:
             value = relaxed_query_text(language, variant)
@@ -141,6 +148,7 @@ def build_search_query(language: str, query: str) -> dict:
                     "fields": [f"document_name_{language}^4", f"text_{language}"],
                     "type": "cross_fields",
                     "operator": "OR",
+                    "minimum_should_match": "75%",
                     "boost": 0.1,
                 }
             })
diff --git a/backend/test_search_relevance.py b/backend/test_search_relevance.py
index 0b6bfd1..94ec919 100644
--- a/backend/test_search_relevance.py
+++ b/backend/test_search_relevance.py
@@ -57,6 +57,7 @@ class SearchRelevanceTest(unittest.TestCase):
         self.assertEqual(strict[0]["query"], "правовое регулирование расторжение договора аренды")
         self.assertEqual(relaxed[0]["query"], "расторжение договора аренды")
         self.assertEqual(relaxed[0]["operator"], "OR")
+        self.assertEqual(relaxed[0]["minimum_should_match"], "75%")
         self.assertNotIn("boost", strict[0])
 
     def test_relaxed_match_supports_kyrgyz_and_avoids_short_named_acts(self):
@@ -68,6 +69,10 @@ class SearchRelevanceTest(unittest.TestCase):
         act_clauses = named_act["query"]["bool"]["must"]["bool"]["should"]
         self.assertFalse(any(item.get("multi_match", {}).get("boost") == 0.1 for item in act_clauses))
 
+        long_named_act = json.loads(build_search_body("ru", "последние изменения Гражданского кодекса Кыргызской Республики", 10))
+        long_act_clauses = long_named_act["query"]["bool"]["must"]["bool"]["should"]
+        self.assertFalse(any(item.get("multi_match", {}).get("boost") == 0.1 for item in long_act_clauses))
+
         short_template = json.loads(build_search_body("ru", "как регулируется взыскание алиментов", 10))
         short_clauses = short_template["query"]["bool"]["must"]["bool"]["should"]
         self.assertTrue(any(item.get("multi_match", {}).get("query") == "взыскание алиментов" and item["multi_match"].get("boost") == 0.1 for item in short_clauses))
-- 
2.54.0


From 6f8b668907469eaa01253d02326c4fb3b386be50 Mon Sep 17 00:00:00 2001
From: Codex Agent <agent@vakanaut.ru>
Date: Fri, 25 Sep 2026 09:02:01 +0300
Subject: [PATCH 3/8] fix: require all tokens for short fallbacks

---
 backend/search/query.py          | 9 +++++++--
 backend/test_search_relevance.py | 9 ++++++++-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/backend/search/query.py b/backend/search/query.py
index 9066ad0..9308d73 100644
--- a/backend/search/query.py
+++ b/backend/search/query.py
@@ -42,7 +42,11 @@ def relaxed_query_text(language: str, query: str) -> str:
 
 
 def is_named_act_query(language: str, query: str) -> bool:
-    return language == "ru" and bool(re.search(r"\b(?:кодекс\w*|конституци\w*|закон\s+кыргызской\s+республики)\b", query.casefold()))
+    act_terms = {
+        "ru": r"кодекс\w*|конституци\w*|закон\s+(?:кыргызской\s+республики|кр)|гк|ук|нк|коап|гпк|упк|уик",
+        "ky": r"кодекс\w*|конституци\w*|мыйзам\w*|жк|үк|салык\s+кодекси",
+    }
+    return bool(re.search(rf"\b(?:{act_terms[language]})\b", query.casefold()))
 
 
 def query_variants(language: str, query: str) -> list[str]:
@@ -142,13 +146,14 @@ def build_search_query(language: str, query: str) -> dict:
             if len(words) < 3 and not any(len(word) >= 5 for word in words):
                 continue
             seen_relaxed.add(value)
+            minimum_should_match = 2 if len(words) == 2 else "75%"
             relaxed_text.append({
                 "multi_match": {
                     "query": value,
                     "fields": [f"document_name_{language}^4", f"text_{language}"],
                     "type": "cross_fields",
                     "operator": "OR",
-                    "minimum_should_match": "75%",
+                    "minimum_should_match": minimum_should_match,
                     "boost": 0.1,
                 }
             })
diff --git a/backend/test_search_relevance.py b/backend/test_search_relevance.py
index 94ec919..bfeb8b1 100644
--- a/backend/test_search_relevance.py
+++ b/backend/test_search_relevance.py
@@ -75,7 +75,14 @@ class SearchRelevanceTest(unittest.TestCase):
 
         short_template = json.loads(build_search_body("ru", "как регулируется взыскание алиментов", 10))
         short_clauses = short_template["query"]["bool"]["must"]["bool"]["should"]
-        self.assertTrue(any(item.get("multi_match", {}).get("query") == "взыскание алиментов" and item["multi_match"].get("boost") == 0.1 for item in short_clauses))
+        short_fallback = next(item["multi_match"] for item in short_clauses if item.get("multi_match", {}).get("boost") == 0.1)
+        self.assertEqual(short_fallback["query"], "взыскание алиментов")
+        self.assertEqual(short_fallback["minimum_should_match"], 2)
+
+        for language, query in (("ru", "изменения ГК КР"), ("ky", "Кыргыз Республикасынын Конституциясы")):
+            act_body = json.loads(build_search_body(language, query, 10))
+            act_clauses = act_body["query"]["bool"]["must"]["bool"]["should"]
+            self.assertFalse(any(item.get("multi_match", {}).get("boost") == 0.1 for item in act_clauses))
 
     def test_company_registration_intent_boosts_current_documents(self):
         for language, query, status in (
-- 
2.54.0


From a3d82b45b5b14f933beaef909ea3c03b9164bb46 Mon Sep 17 00:00:00 2001
From: Codex Agent <agent@vakanaut.ru>
Date: Fri, 25 Sep 2026 09:03:50 +0300
Subject: [PATCH 4/8] fix: guard relaxed search from stopwords

---
 backend/search/query.py          | 3 +--
 backend/test_search_relevance.py | 7 ++++++-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/backend/search/query.py b/backend/search/query.py
index 9308d73..6e0a348 100644
--- a/backend/search/query.py
+++ b/backend/search/query.py
@@ -146,14 +146,13 @@ def build_search_query(language: str, query: str) -> dict:
             if len(words) < 3 and not any(len(word) >= 5 for word in words):
                 continue
             seen_relaxed.add(value)
-            minimum_should_match = 2 if len(words) == 2 else "75%"
             relaxed_text.append({
                 "multi_match": {
                     "query": value,
                     "fields": [f"document_name_{language}^4", f"text_{language}"],
                     "type": "cross_fields",
                     "operator": "OR",
-                    "minimum_should_match": minimum_should_match,
+                    "minimum_should_match": 2,
                     "boost": 0.1,
                 }
             })
diff --git a/backend/test_search_relevance.py b/backend/test_search_relevance.py
index bfeb8b1..329282a 100644
--- a/backend/test_search_relevance.py
+++ b/backend/test_search_relevance.py
@@ -57,7 +57,7 @@ class SearchRelevanceTest(unittest.TestCase):
         self.assertEqual(strict[0]["query"], "правовое регулирование расторжение договора аренды")
         self.assertEqual(relaxed[0]["query"], "расторжение договора аренды")
         self.assertEqual(relaxed[0]["operator"], "OR")
-        self.assertEqual(relaxed[0]["minimum_should_match"], "75%")
+        self.assertEqual(relaxed[0]["minimum_should_match"], 2)
         self.assertNotIn("boost", strict[0])
 
     def test_relaxed_match_supports_kyrgyz_and_avoids_short_named_acts(self):
@@ -79,6 +79,11 @@ class SearchRelevanceTest(unittest.TestCase):
         self.assertEqual(short_fallback["query"], "взыскание алиментов")
         self.assertEqual(short_fallback["minimum_should_match"], 2)
 
+        stopword_query = json.loads(build_search_body("ru", "правовое регулирование права и обязанности", 10))
+        stopword_clauses = stopword_query["query"]["bool"]["must"]["bool"]["should"]
+        stopword_fallback = next(item["multi_match"] for item in stopword_clauses if item.get("multi_match", {}).get("boost") == 0.1)
+        self.assertEqual(stopword_fallback["minimum_should_match"], 2)
+
         for language, query in (("ru", "изменения ГК КР"), ("ky", "Кыргыз Республикасынын Конституциясы")):
             act_body = json.loads(build_search_body(language, query, 10))
             act_clauses = act_body["query"]["bool"]["must"]["bool"]["should"]
-- 
2.54.0


From cf510f08f8ef8a7a473c0f7659063a586b550e22 Mon Sep 17 00:00:00 2001
From: Codex Agent <agent@vakanaut.ru>
Date: Fri, 25 Sep 2026 09:04:53 +0300
Subject: [PATCH 5/8] docs: note relaxed search matching

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 203696c..04f8060 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,7 @@
 
 ## Не выпущено
 
+- Backend обновлён до `0.10.4`: многословный поиск получил низковесный OR fallback с требованием совпадения минимум двух терминов; fallback пропускает распознанные названия нормативных актов.
 - Backend обновлён до `0.10.3`: запрос о налоге на прибыль поднимает действующий
   Налоговый кодекс; точное совпадение фразы дополнительно усиливает результат.
 - Backend обновлён до `0.10.2`: действующие документы ранжируются выше, а
-- 
2.54.0


From 3afac00394d60ed58edc9e84ce384b28f7bcf1f1 Mon Sep 17 00:00:00 2001
From: Codex Agent <agent@vakanaut.ru>
Date: Fri, 25 Sep 2026 20:25:41 +0300
Subject: [PATCH 6/8] fix: retain fallback for act topic searches

---
 backend/search/query.py          | 27 +++++++++++++++++----------
 backend/test_search_relevance.py | 10 ++++++++++
 2 files changed, 27 insertions(+), 10 deletions(-)

diff --git a/backend/search/query.py b/backend/search/query.py
index 6e0a348..9acf3f8 100644
--- a/backend/search/query.py
+++ b/backend/search/query.py
@@ -37,16 +37,23 @@ def relaxed_query_text(language: str, query: str) -> str:
     value = query.strip()
     for prefix in BOILERPLATE_PREFIXES[language]:
         if value.casefold().startswith(prefix):
-            return value[len(prefix):].strip()
-    return value
-
-
-def is_named_act_query(language: str, query: str) -> bool:
-    act_terms = {
-        "ru": r"кодекс\w*|конституци\w*|закон\s+(?:кыргызской\s+республики|кр)|гк|ук|нк|коап|гпк|упк|уик",
-        "ky": r"кодекс\w*|конституци\w*|мыйзам\w*|жк|үк|салык\s+кодекси",
+            value = value[len(prefix):].strip()
+            break
+    act_patterns = {
+        "ru": (
+            r"\b(?:кодекс\w*|конституци\w*|закон\w*|гк|ук|нк|коап|гпк|упк|уик)\b",
+            r"\b(?:гражданск\w*|уголовн\w*|налогов\w*|труд\w*|семейн\w*|административн\w*|процессуальн\w*|правонарушени\w*|кыргызск\w*|республик\w*|кр|о|об|и)\b",
+        ),
+        "ky": (
+            r"\b(?:кодекс\w*|конституци\w*|мыйзам\w*|жк|үк)\b",
+            r"\b(?:жарандык\w*|кылмыш\w*|салык\w*|эмгек\w*|үй-бүлө\w*|административдик\w*|процесстик\w*|бузуу\w*|кыргыз\w*|республика\w*|кр)\b",
+        ),
     }
-    return bool(re.search(rf"\b(?:{act_terms[language]})\b", query.casefold()))
+    marker, title_terms = act_patterns[language]
+    if re.search(marker, value.casefold()):
+        value = re.sub(rf"{marker}|{title_terms}", " ", value, flags=re.IGNORECASE)
+        value = re.sub(r"[^\w\-]+", " ", value).strip()
+    return value
 
 
 def query_variants(language: str, query: str) -> list[str]:
@@ -136,7 +143,7 @@ def build_search_query(language: str, query: str) -> dict:
         for variant in variants
     ]
     relaxed_text = []
-    if not registration_clauses and not is_named_act_query(language, query):
+    if not registration_clauses:
         seen_relaxed = set()
         for variant in variants:
             value = relaxed_query_text(language, variant)
diff --git a/backend/test_search_relevance.py b/backend/test_search_relevance.py
index 329282a..9bf24fc 100644
--- a/backend/test_search_relevance.py
+++ b/backend/test_search_relevance.py
@@ -89,6 +89,16 @@ class SearchRelevanceTest(unittest.TestCase):
             act_clauses = act_body["query"]["bool"]["must"]["bool"]["should"]
             self.assertFalse(any(item.get("multi_match", {}).get("boost") == 0.1 for item in act_clauses))
 
+        for language, query, expected in (
+            ("ru", "Налоговый кодекс ответственность за неуплату налога", "ответственность за неуплату налога"),
+            ("ru", "закон о труде порядок выплаты зарплаты", "порядок выплаты зарплаты"),
+            ("ky", "Кыргыз Республикасынын Конституциясы укуктарды чектөө тартиби", "укуктарды чектөө тартиби"),
+        ):
+            body = json.loads(build_search_body(language, query, 10))
+            clauses = body["query"]["bool"]["must"]["bool"]["should"]
+            fallback = next(item["multi_match"] for item in clauses if item.get("multi_match", {}).get("boost") == 0.1)
+            self.assertEqual(fallback["query"], expected)
+
     def test_company_registration_intent_boosts_current_documents(self):
         for language, query, status in (
             ("ru", "как открыть ОсОО", "Действует"),
-- 
2.54.0


From feb0ddde32fd2e4c2e9be013d1d7289389d7d750 Mon Sep 17 00:00:00 2001
From: Codex Agent <agent@vakanaut.ru>
Date: Fri, 25 Sep 2026 20:27:48 +0300
Subject: [PATCH 7/8] fix: recognize consumer law titles in fallback

---
 backend/search/query.py          |  2 +-
 backend/test_search_relevance.py | 13 +++++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/backend/search/query.py b/backend/search/query.py
index 9acf3f8..9dac6d1 100644
--- a/backend/search/query.py
+++ b/backend/search/query.py
@@ -42,7 +42,7 @@ def relaxed_query_text(language: str, query: str) -> str:
     act_patterns = {
         "ru": (
             r"\b(?:кодекс\w*|конституци\w*|закон\w*|гк|ук|нк|коап|гпк|упк|уик)\b",
-            r"\b(?:гражданск\w*|уголовн\w*|налогов\w*|труд\w*|семейн\w*|административн\w*|процессуальн\w*|правонарушени\w*|кыргызск\w*|республик\w*|кр|о|об|и)\b",
+            r"\bо\s+защит\w*\s+прав\w*\s+потребител\w*\b|\b(?:гражданск\w*|уголовн\w*|налогов\w*|труд\w*|семейн\w*|административн\w*|процессуальн\w*|правонарушени\w*|кыргызск\w*|республик\w*|кр|о|об|и)\b",
         ),
         "ky": (
             r"\b(?:кодекс\w*|конституци\w*|мыйзам\w*|жк|үк)\b",
diff --git a/backend/test_search_relevance.py b/backend/test_search_relevance.py
index 9bf24fc..98f6770 100644
--- a/backend/test_search_relevance.py
+++ b/backend/test_search_relevance.py
@@ -99,6 +99,19 @@ class SearchRelevanceTest(unittest.TestCase):
             fallback = next(item["multi_match"] for item in clauses if item.get("multi_match", {}).get("boost") == 0.1)
             self.assertEqual(fallback["query"], expected)
 
+        for query in (
+            "Закон о защите прав потребителей",
+            "Закон Кыргызской Республики о защите прав потребителей",
+        ):
+            body = json.loads(build_search_body("ru", query, 10))
+            clauses = body["query"]["bool"]["must"]["bool"]["should"]
+            self.assertFalse(any(item.get("multi_match", {}).get("boost") == 0.1 for item in clauses))
+
+        consumer_rights = json.loads(build_search_body("ru", "Закон о защите прав потребителей возврат денег", 10))
+        consumer_clauses = consumer_rights["query"]["bool"]["must"]["bool"]["should"]
+        consumer_fallback = next(item["multi_match"] for item in consumer_clauses if item.get("multi_match", {}).get("boost") == 0.1)
+        self.assertEqual(consumer_fallback["query"], "возврат денег")
+
     def test_company_registration_intent_boosts_current_documents(self):
         for language, query, status in (
             ("ru", "как открыть ОсОО", "Действует"),
-- 
2.54.0


From 9c3cbee14184b2bb1d3e58fbfd247e489b1e5bab Mon Sep 17 00:00:00 2001
From: Codex Agent <agent@vakanaut.ru>
Date: Fri, 25 Sep 2026 22:39:24 +0300
Subject: [PATCH 8/8] fix: preserve topic terms after act titles

---
 backend/search/query.py          | 34 +++++++++++++++++++-------------
 backend/test_search_relevance.py |  5 ++++-
 2 files changed, 24 insertions(+), 15 deletions(-)

diff --git a/backend/search/query.py b/backend/search/query.py
index 9dac6d1..9e9873a 100644
--- a/backend/search/query.py
+++ b/backend/search/query.py
@@ -31,6 +31,21 @@ BOILERPLATE_PREFIXES = {
     ),
     "ky": (),
 }
+ACT_TITLE_PREFIXES = {
+    "ru": (
+        r"(?:гражданский\s+)?процессуальный\s+кодекс(?:\s+(?:кыргызской\s+республики|кр))?",
+        r"(?:гражданск\w*|уголовн\w*|налогов\w*|трудов\w*|семейн\w*)\s+кодекс\w*(?:\s+(?:кыргызской\s+республики|кр))?",
+        r"кодекс\s+о\s+правонарушениях(?:\s+(?:кыргызской\s+республики|кр))?",
+        r"конституци\w*(?:\s+(?:кыргызской\s+республики|кр))?",
+        r"(?:гк|ук|нк|коап|гпк|упк|уик)(?:\s+(?:кыргызской\s+республики|кр))?",
+        r"закон(?:\s+(?:кыргызской\s+республики|кр))?\s+о\s+(?:защит\w*\s+прав\w*\s+потребител\w*|государственн\w+\s+регистраци\w+\s+юридическ\w+\s+лиц|труд\w*)",
+    ),
+    "ky": (
+        r"кыргыз\w*\s+республикасынын\s+конституци\w*",
+        r"(?:кыргыз\w*\s+республикасынын\s+)?(?:жарандык|кылмыш\w*|салык|эмгек|үй-бүлө|административдик|жарандык\s+процесстик)\s+кодекс\w*",
+        r"(?:кыргыз\w*\s+республикасынын\s+)?(?:жк|үк)(?:\s+кр)?",
+    ),
+}
 
 
 def relaxed_query_text(language: str, query: str) -> str:
@@ -39,20 +54,11 @@ def relaxed_query_text(language: str, query: str) -> str:
         if value.casefold().startswith(prefix):
             value = value[len(prefix):].strip()
             break
-    act_patterns = {
-        "ru": (
-            r"\b(?:кодекс\w*|конституци\w*|закон\w*|гк|ук|нк|коап|гпк|упк|уик)\b",
-            r"\bо\s+защит\w*\s+прав\w*\s+потребител\w*\b|\b(?:гражданск\w*|уголовн\w*|налогов\w*|труд\w*|семейн\w*|административн\w*|процессуальн\w*|правонарушени\w*|кыргызск\w*|республик\w*|кр|о|об|и)\b",
-        ),
-        "ky": (
-            r"\b(?:кодекс\w*|конституци\w*|мыйзам\w*|жк|үк)\b",
-            r"\b(?:жарандык\w*|кылмыш\w*|салык\w*|эмгек\w*|үй-бүлө\w*|административдик\w*|процесстик\w*|бузуу\w*|кыргыз\w*|республика\w*|кр)\b",
-        ),
-    }
-    marker, title_terms = act_patterns[language]
-    if re.search(marker, value.casefold()):
-        value = re.sub(rf"{marker}|{title_terms}", " ", value, flags=re.IGNORECASE)
-        value = re.sub(r"[^\w\-]+", " ", value).strip()
+    for pattern in ACT_TITLE_PREFIXES[language]:
+        match = re.match(rf"\s*{pattern}(?=\s|$|[.,;:!?])", value, re.IGNORECASE)
+        if match:
+            value = value[match.end():].lstrip(" \t,;:—-")
+            break
     return value
 
 
diff --git a/backend/test_search_relevance.py b/backend/test_search_relevance.py
index 98f6770..510efc0 100644
--- a/backend/test_search_relevance.py
+++ b/backend/test_search_relevance.py
@@ -84,13 +84,15 @@ class SearchRelevanceTest(unittest.TestCase):
         stopword_fallback = next(item["multi_match"] for item in stopword_clauses if item.get("multi_match", {}).get("boost") == 0.1)
         self.assertEqual(stopword_fallback["minimum_should_match"], 2)
 
-        for language, query in (("ru", "изменения ГК КР"), ("ky", "Кыргыз Республикасынын Конституциясы")):
+        for language, query in (("ru", "последние изменения ГК КР"), ("ky", "Кыргыз Республикасынын Конституциясы")):
             act_body = json.loads(build_search_body(language, query, 10))
             act_clauses = act_body["query"]["bool"]["must"]["bool"]["should"]
             self.assertFalse(any(item.get("multi_match", {}).get("boost") == 0.1 for item in act_clauses))
 
         for language, query, expected in (
             ("ru", "Налоговый кодекс ответственность за неуплату налога", "ответственность за неуплату налога"),
+            ("ru", "Налоговый кодекс налоговая ставка", "налоговая ставка"),
+            ("ru", "Налоговый кодекс: налоговая ставка", "налоговая ставка"),
             ("ru", "закон о труде порядок выплаты зарплаты", "порядок выплаты зарплаты"),
             ("ky", "Кыргыз Республикасынын Конституциясы укуктарды чектөө тартиби", "укуктарды чектөө тартиби"),
         ):
@@ -102,6 +104,7 @@ class SearchRelevanceTest(unittest.TestCase):
         for query in (
             "Закон о защите прав потребителей",
             "Закон Кыргызской Республики о защите прав потребителей",
+            "Закон Кыргызской Республики о государственной регистрации юридических лиц",
         ):
             body = json.loads(build_search_body("ru", query, 10))
             clauses = body["query"]["bool"]["must"]["bool"]["should"]
-- 
2.54.0