Expand POPULAR_TERMS: 40 -> 293 via 84000.org dictionary

tipatika-wiki/wiki/concepts/popular-terms-seed.md

@@ -0,0 +1,46 @@
+---
+type: concept
+title: POPULAR_TERMS — คำศัพท์ตั้งต้นสำหรับ Autocomplete
+tags: [search, seed-data, buddhism, dictionary]
+related: [search-autocomplete, search-pipeline]
+created: 2026-04-30
+updated: 2026-04-30
+---
+
+# POPULAR_TERMS — คำศัพท์ตั้งต้น
+
+## Description
+
+List **293** คำศัพท์พระไตรปิฎกที่ curate ไว้ใน `search_service.py` เป็น fallback เมื่อ `search_log` ยังว่างหรือ match ไม่ครบ
+
+## Location
+
+`webapp/tipitaka-api/app/services/search_service.py` → `POPULAR_TERMS: List[str]`
+
+## Source
+
+| Source | Count |
+|--------|-------|
+| Core curated terms (original v1) | 40 |
+| 84000.org dictionary topic headings (v2 expansion) | 253 |
+| **Total** | **293** |
+
+คำศัพท์ 253 คำใหม่มาจากหัวข้อ (topic headings) ของ [พจนานุกรมพุทธศาสตร์ ฉบับประมวลธรรม](https://84000.org/tipitaka/dic/) โดยตัดเลขหมวด (varga numbers) ออก ทำ unique และ filter กับรายการเดิม
+
+## รายการปัจจุบัน (2026-04-30)
+
+### หมวด 1 — หลักธรรมพื้นฐาน (40 คำ — original)
+
+อริยสัจ, นิพพาน, ไตรลักษณ์, อนิจจัง, ทุกข์, อนัตตา, สติปัฏฐาน, อัฏฐมรรค, โพชฌงค์, ปฏิจจสมุปบาท, สมาธิ, วิปัสสนา, สมถะ, ศีล, ปัญญา, กรรม, วิบาก, กิเลส, ตัณหา, อวิชชา, โพธิสัตว์, ปรินิพพาน, สังสารวัฏ, มรนสติ, เมตตา, กรุณา, มุทิตา, อุเบกขา, อภิธรรม, วินัยปิฎก, สุตตันตปิฎก, ขันธ์, อายตนะ, ธาตุ, อินทรีย์, โพธิปักขิยธรรม, สัมมาสมาธิ, สัมมาสติ, บารมี, เจตสิก, จิต, รูป, นาม
+
+### หมวด 2 — จาก 84000.org dictionary (253 คำ — v2 expansion)
+
+กถาวัตถุ, กรรมกิเลส, กรรมฐาน, กสิณ, กัลยาณมิตตตา, กัลยาณมิตรธรรม, กาม, กามคุณ, กามโภคี, กาลามสูตรกังขานิยฐาน, กิจ, กิจในอริยสัจจ์, กุลจิรัฏฐิติธรรม, กุศลกรรมบถ, กุศลมูล, กุศลวิตก, คารวะ, ฆราวาสธรรม, จรณะ, จริต, จักขุ, จักร, จักรวรรดิวัตร, ฌาน, ฌาน 2 ประเภท, ญาณ, ถูปารหบุคคล, ทวาร, ทศพลญาณ, ทักขิณาวิสุทธิ, ทาน, ทิฏฐธัมมิกัตถสังวัตตนิกธรรม, ทิฏฐิ, ทิศ, ที่สุด, ทุกขตา, ทุจริต, ธรรม, ธรรมขันธ์, ธรรมคุณ, ธรรมคุ้มครองโลก, ธรรมทำให้งาม, ธรรมนิยาม, ธรรมมีอุปการะมาก, ธรรมสมาทาน, ธรรมสมาธิ, ธรรมสวนานิสงส์, ธรรมเทสกธรรม, ธาตุกัมมัฏฐาน, ธุดงค์, ธุระ, นวกภิกขุธรรม, นวังคสัตถุสาสน์, นาถกรณธรรม, นิมิต, นิยาม, นิวรณ์, นิโรธ, บริษัท, บุคคล, บุคคลหาได้ยาก, บุญกิริยาวัตถุ, บุตร, บุพนิมิตแห่งมรรค, บูชา, ปฏิปทา, ปฏิสันถาร, ปฏิสัมภิทา, ปธาน, ปปัญจะ, ปปัญจธรรม, ปรมัตถธรรม, ประมาณ, ปริญญา, ปริเยสนา, ปัจจัย, ปัจจัยให้เกิดสัมมาทิฏฐิ, ปัพพชิตอภิณหปัจจเวกขณ์, ปาฏิหาริย์, ปาปณิกธรรม, ปาพจน์, ปาริสุทธิศีล, ปิยรูป สาตรูป, ปีติ, ผล, พร, พรหมวิหาร, พละ, พละ 5 ของพระมหากษัตริย์, พหูสูตมีองค์, พุทธคุณ, พุทธจริยา, พุทธโอวาท, ภพ, ภรรยา, ภัพพ���าธรรม, ภาวนา, ภูมิ, มงคล, มรรค, มรรคมีองค์, มละ, มหาปเทส, มหาปเทส 4 เฉพาะในทางพระวินัย, มหาภูต, มัจฉริยะ, มานะ, มาร, มิจฉัตตะ, มิตรปฏิรูปก์, รัตนตรัย, ราชธรรม, ฤทธิ์, ลักษณะตัดสินธรรมวินัย, ลัทธินอกพระพุทธศาสนา, ลีลาการสอน, วณิชชา, วรรณะ, วัฏฏะ, วัฒนมุข, วัตถุประสงค์ในการบัญญัติวินัย, วิชชา, วิญญาณ, วิญญาณฐิติ, วิธีปฏิบัติต่อทุกข์-สุข, วิบัติ, วิปัลลาส, วิปัสสนาญาณ, วิปัสสนูปกิเลส, วิมุตติ, วิรัติ, วิสุทธิ, วิเวก, วิโมกข์, วุฒิ, ศรัทธา, ศีล 8 ทั้งอาชีวะ, สกทาคามี, สมชีวิธรรม, สมบัติ, สมาธิภาวนา, สมาบัติ, สรณะ, สวรรค์, สังขตลักษณะ, สังขาร, สังคหวัตถุ, สังคหวัตถุของผู้ครองแผ่นดิน, สังคหะ, สังฆคุณ, สังวร, สังเวชนียสถาน, สังโยชน์, สัจจะ, สัญญา, สัตตาวาส, สัทธรรม, สันโดษ, สัปปายะ, สัปปุริสทาน, สัปปุริสธรรม, สัปปุริสบัญญัติ, สัมปชัญญะ, สัมปทา, สัมปรายิกัตถสังวัตตนิกธรรม, สัมผัส, สัมมัตตะ, สารณียธรรม, สาสน์, สิกขา, สุข, สุขของคฤหัสถ์, สุจริต, สุทธาวาส, สุทธิ, สุหทมิตร, อกุศลกรรมบถ, อกุศลมูล, อกุศลวิตก, อคติ, อธิปไตย, อธิษฐาน, อนันตริยกรรม, อนาคามี, อนุตตริยะ, อนุบุพพวิหาร, อนุปุพพิกถา, อนุสติ, อนุสัย, อบาย, อบายมุข, อปริหานิยธรรม, อปัณณกปฏิปทา, อปัสเสนะ, อภิญญา, อภิฐาน, อภิณหปัจจเวกขณ์, อภิสังขาร, อรหันต์, อริยทรัพย์, อริยบุคคล, อริยวงค์, อริยวัฑฒิ, อริยสัจจ์, อรูป, อสังขตลักษณะ, อสุภะ, อัคคิ, อัตถะ, อันตคาหิกทิฏฐิ, อันตรายของภิกษุสามเณรผู้บวชใหม่, อัปปมาทะ, อาการที่พระพุทธเจ้าทรงสั่งสอน, อาจารย์, อานาปานสติ 16 ฐาน, อายตนะภายนอก, อายตนะภายใน, อายุสสธรรม, อาวาสิกธรรม, อาสวะ, อาหาร, อิทธิบาท, อุบาสกธรรม, อุปกิเลส, อุปัญญาตธรรม, อุปาทาน, อุปาทารูป, เจดีย์, เจตนา, เถรธรรม, เทพ, เทวทูต, เทศนา, เบญจธรรม, เมถุนสังโยค, เวทนา, เวปุลลธรรม, เวปุลละ, เวสารัชชกรณธรรม, เวสารัชชะ, โกศล, โภควิภาค, โภคอาทิยะ, โยคะ, โยนิ, โยนิโสมนสิการ, โลก, โลกธรรม, โลกุตตรธรรม, โสดาบัน, โสตาปัตติยังคะ, โอฆะ, ไตรปิฎก
+
+## หลักเกณฑ์การเพิ่ม
+
+1. **ที่มาเด่น**: คำศัพท์จาก [84000.org/tipitaka/dic/](https://84000.org/tipitaka/dic/) — หัวข้อหมวดธรรม (topic headings) โดยตัดเลขหมวดออก
+2. **ไม่มีเลขหมวด**: ตัดตัวเลขท้าย เช่น "กรรม 2" → "กรรม", "กาม 2" → "กาม"
+3. **ไม่มี cross-reference**: ตัดตัวเลขวงเล็บ เช่น "ธรรมมีอุปการะมาก 7 [292]" → "ธรรมมีอ���ปการะมาก"
+4. **deduplicate**: คำที่มีอยู่แล้วใน POPULAR_TERMS ไม่เพิ่มซ้ำ
+5. **ควรมีผลลัพธ์ใน DB**: คำที่ seed ควรตรงกับข้อมูลใน tipitaka_mcu.db จริง

tipatika-wiki/wiki/log.md

@@ -0,0 +1,29 @@
+# Research Log
+
+## 2026-04-30
+
+- Project created
+- Initialized `purpose.md` — defined project scope: RAG-based Q&A system for Pali Tipitaka, covering architecture, themes, milestones, and vision
+- Corrected `purpose.md` — repo URL changed from GitHub to Hugging Face Spaces (https://huggingface.co/spaces/dhammawatthumpra/tipitaka)
+
+## 2026-04-30 (ingest | Search Autocomplete Feature)
+
+Pages written: [[search-autocomplete]], [[popular-terms-seed]], [[search-pipeline]]
+Pages updated: index.md, overview.md
+
+Files changed in codebase:
+- `sqlite_db.py` — get_disk_connection(), ensure_search_log_table()
+- `search_service.py` — POPULAR_TERMS, get_suggestions(), log_search(), search() restructured
+- `routers/search.py` — GET /api/search/suggestions endpoint
+- `main.py` — ensure_search_log_table() on startup
+- `searchStore.ts` — suggestions state + fetchSuggestions()
+- `NavDrawer.tsx` — debounce, dropdown UI, keyboard nav
+
+## 2026-04-30 (expand | 84000 Dictionary → POPULAR_TERMS)
+
+Pages updated: [[popular-terms-seed]]
+
+Summary: Scraped 359 topic headings from [พจนานุกรมพุทธศาสตร์ ฉบับประมวลธรรม](https://84000.org/tipitaka/dic/), stripped varga numbers, deduplicated, and merged with existing POPULAR_TERMS (40 terms → 293 terms total).
+
+Files changed in codebase:
+- `search_service.py` — POPULAR_TERMS expanded from 40 → 293 terms (253 new from dictionary)

webapp/tipitaka-api/app/database/sqlite_db.py

@@ -56,6 +56,32 @@ class SQLiteDB:
 
         self._mem_conn = mem
 
+    @contextmanager
+    def get_disk_connection(self) -> Generator[sqlite3.Connection, None, None]:
+        """Always connects to disk — used for persistent writes (e.g. search_log)."""
+        conn = sqlite3.connect(self.db_path)
+        conn.row_factory = sqlite3.Row
+        try:
+            yield conn
+            conn.commit()
+        finally:
+            conn.close()
+
+    def ensure_search_log_table(self) -> None:
+        """Create search_log table on disk if not exists."""
+        with sqlite3.connect(self.db_path) as conn:
+            conn.execute("""
+                CREATE TABLE IF NOT EXISTS search_log (
+                    id      INTEGER PRIMARY KEY AUTOINCREMENT,
+                    query   TEXT NOT NULL COLLATE NOCASE,
+                    count   INTEGER NOT NULL DEFAULT 1,
+                    last_at TEXT NOT NULL DEFAULT (datetime('now','localtime')),
+                    UNIQUE(query)
+                )
+            """)
+            conn.execute("CREATE INDEX IF NOT EXISTS idx_search_log_query ON search_log(query)")
+            conn.commit()
+
     @property
     def is_in_memory(self) -> bool:
         return self._mem_conn is not None

webapp/tipitaka-api/app/main.py

@@ -21,6 +21,8 @@ async def lifespan(app: FastAPI):
     logger.info("Initializing database...")
     db.load_to_memory()
     logger.info("Database loaded to memory — all queries now run in-memory.")
+    db.ensure_search_log_table()
+    logger.info("Search log table ready.")
     
     yield
     # Shutdown logic (if any)

webapp/tipitaka-api/app/routers/search.py

@@ -1,4 +1,5 @@
 from fastapi import APIRouter, Depends, Query
+from typing import List
 from app.schemas import SearchResponse
 from app.services.search_service import SearchService
 from app.database.sqlite_db import get_db, SQLiteDB
@@ -8,6 +9,15 @@ router = APIRouter(prefix="/search", tags=["Search"])
 def get_search_service(db: SQLiteDB = Depends(get_db)) -> SearchService:
     return SearchService(db)
 
+@router.get("/suggestions", response_model=List[str])
+def suggestions(
+    q: str = Query(..., min_length=1),
+    limit: int = Query(8, ge=1, le=20),
+    service: SearchService = Depends(get_search_service)
+):
+    """Autocomplete suggestions based on search history + curated terms."""
+    return service.get_suggestions(q, limit)
+
 @router.get("", response_model=SearchResponse)
 def search(
     q: str = Query(..., min_length=1),

webapp/tipitaka-api/app/services/search_service.py

@@ -1,5 +1,6 @@
 import time
 import re
+from typing import List
 from app.database.sqlite_db import SQLiteDB
 from app.schemas import SearchResponse, SearchResultItem
 
@@ -55,10 +56,153 @@ def to_thai_digits(s: str) -> str:
     return s.translate(str.maketrans("0123456789", "๐๑๒๓๔๕๖๗๘๙"))
 
 
+# ── Curated popular terms (fallback when search_log is empty) ──────
+# Source: https://84000.org/tipitaka/dic/ (topic headings, stripped of varga numbers)
+POPULAR_TERMS: List[str] = [
+    # ── Core doctrines ──────────────────────────────────────────
+    "อริยสัจ", "นิพพาน", "ไตรลักษณ์", "อนิจจัง", "ทุกข์", "อนัตตา",
+    "สติปัฏฐาน", "อัฏฐมรรค", "โพชฌงค์", "ปฏิจจสมุปบาท",
+    "สมาธิ", "วิปัสสนา", "สมถะ", "ศีล", "ปัญญา",
+    "กรรม", "วิบาก", "กิเลส", "ตัณหา", "อวิชชา",
+    "โพธิสัตว์", "ปรินิพพาน", "สังสารวัฏ", "มรนสติ",
+    "เมตตา", "กรุณา", "มุทิตา", "อุเบกขา",
+    "อภิธรรม", "วินัยปิฎก", "สุตตันตปิฎก",
+    "ขันธ์", "อายตนะ", "ธาตุ", "อินทรีย์",
+    "โพธิปักขิยธรรม", "สัมมาสมาธิ", "สัมมาสติ",
+    "บารมี", "เจตสิก", "จิต", "รูป", "นาม",
+    # ── From 84000 dictionary ───────────────────────────────────
+    "กถาวัตถุ", "กรรมกิเลส", "กรรมฐาน", "กสิณ",
+    "กัลยาณมิตตตา", "กัลยาณมิตรธรรม", "กาม", "กามคุณ",
+    "กามโภคี", "กาลามสูตรกังขานิยฐาน", "กิจ", "กิจในอริยสัจจ์",
+    "กุลจิรัฏฐิติธรรม", "กุศลกรรมบถ", "กุศลมูล", "กุศลวิตก",
+    "คารวะ", "ฆราวาสธรรม", "จรณะ", "จริต", "จักขุ",
+    "จักร", "จักรวรรดิวัตร", "ฌาน", "ฌาน 2 ประเภท", "ญาณ",
+    "ถูปารหบุคคล", "ทวาร", "ทศพลญาณ", "ทักขิณาวิสุทธิ",
+    "ทาน", "ทิฏฐธัมมิกัตถสังวัตตนิกธรรม", "ทิฏฐิ", "ทิศ",
+    "ที่สุด", "ทุกขตา", "ทุจริต", "ธรรม", "ธรรมขันธ์",
+    "ธรรมคุณ", "ธรรมคุ้มครองโลก", "ธรรมทำให้งาม", "ธรรมนิยาม",
+    "ธรรมมีอุปการะมาก", "ธรรมสมาทาน", "ธรรมสมาธิ",
+    "ธรรมสวนานิสงส์", "ธรรมเทสกธรรม", "ธาตุกัมมัฏฐาน",
+    "ธุดงค์", "ธุระ", "นวกภิกขุธรรม", "นวังคสัตถุสาสน์",
+    "นาถกรณธรรม", "นิมิต", "นิยาม", "นิวรณ์", "นิโรธ",
+    "บริษัท", "บัญญัติ 2", "บุคคล", "บุคคลหาได้ยาก",
+    "บุญกิริยาวัตถุ", "บุตร", "บุพนิมิตแห่งมรรค", "บูชา",
+    "ปฏิปทา", "ปฏิสันถาร", "ปฏิสัมภิทา", "ปธาน",
+    "ปปัญจะ, ปปัญจธรรม", "ปรมัตถธรรม", "ประมาณ", "ปริญญา",
+    "ปริเยสนา", "ปัจจัย", "ปัจจัยให้เกิดสัมมาทิฏฐิ",
+    "ปัพพชิตอภิณหปัจจเวกขณ์", "ปาฏิหาริย์", "ปาปณิกธรรม",
+    "ปาพจน์", "ปาริสุทธิศีล", "ปิยรูป สาตรูป", "ปีติ",
+    "ผล", "พร", "พรหมวิหาร", "พละ",
+    "พละ 5 ของพระมหากษัตริย์", "พหูสูตมีองค์", "พุทธคุณ",
+    "พุทธจริยา", "พุทธโอวาท", "ภพ", "ภรรยา",
+    "ภัพพตาธรรม", "ภาวนา", "ภูมิ", "มงคล", "มรรค",
+    "มรรคมีองค์", "มละ", "มหาปเทส",
+    "มหาปเทส 4 เฉพาะในท���งพระวินัย", "มหาภูต", "มัจฉริยะ",
+    "มานะ", "มาร", "มิจฉัตตะ", "มิตรปฏิรูปก์",
+    "รัตนตรัย", "ราชธรรม", "ฤทธิ์", "ลักษณะตัดสินธรรมวินัย",
+    "ลัทธินอกพระพุทธศาสนา", "ลีลาการสอน", "วณิชชา", "วรรณะ",
+    "วัฏฏะ", "วัฒนมุข", "วัตถุประสงค์ในการบัญญัติวินัย",
+    "วิชชา", "วิญญาณ", "วิญญาณฐิติ",
+    "วิธีปฏิบัติต่อทุกข์-สุข", "วิบัติ", "วิปัลลาส",
+    "วิปัสสนาญาณ", "วิปัสสนูปกิเลส", "วิมุตติ", "วิรัติ",
+    "วิสุทธิ", "วิเวก", "วิโมกข์", "วุฒิ", "ศรัทธา",
+    "ศีล 8 ทั้งอาชีวะ", "สกทาคามี", "สมชีวิธรรม", "สมบัติ",
+    "สมาธิภาวนา", "สมาบัติ", "สรณะ", "สวรรค์",
+    "สังขตลักษณะ", "สังขาร", "สังคหวัตถุ",
+    "สังคหวัตถุของผู้ครองแผ่นดิน", "สังคหะ", "สังฆคุณ",
+    "สังวร", "สังเวชนียสถาน", "สังโยชน์", "สัจจะ", "สัญญา",
+    "สัตตาวาส", "สัทธรรม", "สันโดษ", "สัปปายะ",
+    "สัปปุริสทาน", "สัปปุริสธรรม", "สัปปุริสบัญญัติ",
+    "สัมปชัญญะ", "สัมปทา", "สัมปรายิกัตถสังวัตตนิกธรรม",
+    "สัมผัส", "สัมมัตตะ", "สารณียธรรม", "สาสน์", "สิกขา",
+    "สุข", "สุขของคฤหัสถ์", "สุจริต", "สุทธาวาส", "สุทธิ",
+    "สุหทมิตร", "อกุศลกรรมบถ", "อกุศลมูล", "อกุศลวิตก",
+    "อคติ", "อธิปไตย", "อธิษฐาน", "อนันตริยกรรม",
+    "อนาคามี", "อนุตตริยะ", "อนุบุพพวิหาร", "อนุปุพพิกถา",
+    "อนุสติ", "อนุสัย", "อบาย", "อบายมุข",
+    "อปริหานิยธรรม", "อปัณณกปฏิปทา", "อปัสเสนะ",
+    "อภิญญา", "อภิฐาน", "อภิณหปัจจเวกขณ์", "อภิสังขาร",
+    "อรหันต์", "อริยทรัพย์", "อริยบุคคล", "อริยวงศ์",
+    "อริยวัฑฒิ", "อริยสัจจ์", "อรูป", "อสังขตลักษณะ",
+    "อสุภะ", "อัคคิ", "อัตถะ", "อันตคาหิกทิฏฐิ",
+    "อันตรายของภิกษุสามเณรผู้บวชใหม่", "อัปปมาทะ",
+    "อาการที่พระพุทธเจ้าทรงสั่งสอน", "อาจารย์",
+    "อานาปานสติ 16 ฐาน", "อายตนะภายนอก", "อายตนะภายใน",
+    "อายุสสธรรม", "อาวาสิกธรรม", "อาสวะ", "อาหาร",
+    "อิทธิบาท", "อุบาสกธรรม", "อุปกิเลส", "อุปัญญาตธรรม",
+    "อุปาทาน", "อุปาทารูป", "เจดีย์", "เจตนา", "เถรธรรม",
+    "เทพ", "เทวทูต", "เทศนา", "เบญจธรรม", "เมถุนสังโยค",
+    "เวทนา", "เวปุลลธรรม", "เวปุลละ", "เวสารัชชกรณธรรม",
+    "เวสารัชชะ", "โกศล", "โภควิภาค", "โภคอาทิยะ",
+    "โยคะ", "โยนิ", "โยนิโสมนสิการ", "โลก", "โลกธรรม",
+    "โลกุตตรธรรม", "โสดาบัน", "โสตาปัตติยังคะ", "โอฆะ",
+    "ไตรปิฎก",
+]
+
+
 class SearchService:
     def __init__(self, db: SQLiteDB):
         self.db = db
 
+    # ── Autocomplete suggestions ────────────────────────────────────
+
+    def get_suggestions(self, prefix: str, limit: int = 8) -> List[str]:
+        """
+        Return autocomplete suggestions for `prefix`.
+        Priority: search_log (by frequency) → POPULAR_TERMS (curated).
+        """
+        if not prefix or len(prefix.strip()) < 1:
+            return []
+
+        prefix = prefix.strip()
+        results: List[str] = []
+        seen: set[str] = set()
+
+        # 1. From search history (disk) — most searched first
+        try:
+            with self.db.get_disk_connection() as conn:
+                rows = conn.execute("""
+                    SELECT query FROM search_log
+                    WHERE query LIKE ? COLLATE NOCASE
+                    ORDER BY count DESC, last_at DESC
+                    LIMIT ?
+                """, (f"{prefix}%", limit)).fetchall()
+                for row in rows:
+                    q = row["query"]
+                    if q not in seen:
+                        results.append(q)
+                        seen.add(q)
+        except Exception:
+            pass
+
+        # 2. Fill remaining from POPULAR_TERMS
+        if len(results) < limit:
+            for term in POPULAR_TERMS:
+                if term.startswith(prefix) and term not in seen:
+                    results.append(term)
+                    seen.add(term)
+                    if len(results) >= limit:
+                        break
+
+        return results[:limit]
+
+    def log_search(self, query: str) -> None:
+        """Upsert query into search_log (increment count if exists)."""
+        q = query.strip()
+        if not q:
+            return
+        try:
+            with self.db.get_disk_connection() as conn:
+                conn.execute("""
+                    INSERT INTO search_log(query, count, last_at)
+                        VALUES(?, 1, datetime('now','localtime'))
+                    ON CONFLICT(query) DO UPDATE SET
+                        count   = count + 1,
+                        last_at = datetime('now','localtime')
+                """, (q,))
+        except Exception:
+            pass  # Never fail a search because of logging
+
     def clean_text(self, text: str) -> str:
         """Port of v2.1 _clean(): strips line numbers, footnotes, separators."""
         if not text:
@@ -210,10 +354,14 @@ class SearchService:
 
             time_ms = (time.time() - start_time) * 1000
 
-            return SearchResponse(
+            response = SearchResponse(
                 query=corrected_q,
                 total_results=total_count,
                 results=paginated,
                 time_taken_ms=time_ms,
                 breakdown_by_volume=breakdown_data,
             )
+
+        # Log after `with` block closes (non-blocking, won't affect response)
+        self.log_search(corrected_q)
+        return response

webapp/tipitaka-web/src/components/layout/NavDrawer.tsx

@@ -1,4 +1,4 @@
-import React, { useState, useEffect } from 'react';
+import React, { useState, useEffect, useRef, useCallback } from 'react';
 import { useUIStore, useReaderStore, useThemeStore } from '../../stores/appStore';
 import { useSearchStore } from '../../stores/searchStore';
 import api from '../../lib/api';
@@ -22,11 +22,15 @@ const NavDrawer: React.FC = () => {
   const {
     query, setQuery, results, totalResults,
     isLoading, performSearch, breakdown, timeTaken,
+    suggestions, showSuggestions, fetchSuggestions, setShowSuggestions,
   } = useSearchStore();
 
   const [toc, setToc] = useState<any[]>([]);
   const [loadingToc, setLoadingToc] = useState(false);
   const [volumes, setVolumes] = useState<any[]>([]);
+  const [activeSuggestion, setActiveSuggestion] = useState(-1);
+  const searchRef = useRef<HTMLDivElement>(null);
+  const debounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
   const s = DRAWER_STYLES[theme] ?? DRAWER_STYLES.dark;
 
@@ -49,8 +53,68 @@ const NavDrawer: React.FC = () => {
     if (window.innerWidth < 1024) setNavOpen(false);
   };
 
+  // Debounced suggestion fetch
+  const handleQueryChange = useCallback((value: string) => {
+    setQuery(value);
+    setActiveSuggestion(-1);
+    if (debounceRef.current) clearTimeout(debounceRef.current);
+    debounceRef.current = setTimeout(() => {
+      fetchSuggestions(value);
+    }, 280);
+  }, [setQuery, fetchSuggestions]);
+
+  // Close suggestions on outside click
+  useEffect(() => {
+    const handler = (e: MouseEvent) => {
+      if (searchRef.current && !searchRef.current.contains(e.target as Node)) {
+        setShowSuggestions(false);
+      }
+    };
+    document.addEventListener('mousedown', handler);
+    return () => document.removeEventListener('mousedown', handler);
+  }, [setShowSuggestions]);
+
+  const selectSuggestion = (term: string) => {
+    setQuery(term);
+    setShowSuggestions(false);
+    setActiveSuggestion(-1);
+    setActiveTab('search');
+    setTimeout(() => performSearch(), 0);
+  };
+
+  const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
+    if (!showSuggestions || suggestions.length === 0) {
+      if (e.key === 'Enter') {
+        e.preventDefault();
+        setActiveTab('search');
+        performSearch();
+      }
+      return;
+    }
+    if (e.key === 'ArrowDown') {
+      e.preventDefault();
+      setActiveSuggestion(i => Math.min(i + 1, suggestions.length - 1));
+    } else if (e.key === 'ArrowUp') {
+      e.preventDefault();
+      setActiveSuggestion(i => Math.max(i - 1, -1));
+    } else if (e.key === 'Enter') {
+      e.preventDefault();
+      if (activeSuggestion >= 0) {
+        selectSuggestion(suggestions[activeSuggestion]);
+      } else {
+        setShowSuggestions(false);
+        setActiveTab('search');
+        performSearch();
+      }
+    } else if (e.key === 'Escape') {
+      setShowSuggestions(false);
+      setActiveSuggestion(-1);
+    }
+  };
+
   const handleSearch = (e: React.FormEvent) => {
     e.preventDefault();
+    setShowSuggestions(false);
     setActiveTab('search');
     performSearch();
   };
@@ -161,16 +225,49 @@ const NavDrawer: React.FC = () => {
           {/* ── Search ── */}
           {activeTab === 'search' && (
             <div className="p-3 space-y-3">
-              <form onSubmit={handleSearch} className="relative">
+              <form onSubmit={handleSearch} className="relative" ref={searchRef}>
                 <input
                   type="text"
                   value={query}
-                  onChange={e => setQuery(e.target.value)}
+                  onChange={e => handleQueryChange(e.target.value)}
+                  onKeyDown={handleKeyDown}
+                  onFocus={() => query && fetchSuggestions(query)}
                   placeholder="ค้นหาข้อความ เช่น อริยสัจ…"
+                  autoComplete="off"
                   className={`w-full pl-9 pr-3 py-2.5 rounded-xl text-sm outline-none border ${s.border} ${s.input} ${s.text} focus:border-[#c8860a] transition-colors`}
                 />
                 <Search size={16} className="absolute left-3 top-3 text-[#888]" />
                 {isLoading && <Loader2 size={14} className="absolute right-3 top-3.5 animate-spin text-[#c8860a]" />}
+
+                {/* Suggestions dropdown */}
+                <AnimatePresence>
+                  {showSuggestions && suggestions.length > 0 && (
+                    <motion.ul
+                      initial={{ opacity: 0, y: -4 }}
+                      animate={{ opacity: 1, y: 0 }}
+                      exit={{ opacity: 0, y: -4 }}
+                      transition={{ duration: 0.12 }}
+                      className={`absolute left-0 right-0 top-full mt-1 z-50 rounded-xl border shadow-lg overflow-hidden ${s.bg} ${s.border}`}
+                    >
+                      {suggestions.map((term, i) => (
+                        <li key={term}>
+                          <button
+                            type="button"
+                            onMouseDown={() => selectSuggestion(term)}
+                            className={`w-full text-left px-4 py-2.5 text-sm flex items-center gap-2 transition-colors ${
+                              i === activeSuggestion
+                                ? 'bg-[#c8860a]/15 text-[#c8860a]'
+                                : `${s.text} hover:bg-white/10`
+                            }`}
+                          >
+                            <Search size={12} className="opacity-40 flex-shrink-0" />
+                            {term}
+                          </button>
+                        </li>
+                      ))}
+                    </motion.ul>
+                  )}
+                </AnimatePresence>
               </form>
 
               {results.length > 0 && (

webapp/tipitaka-web/src/stores/searchStore.ts

@@ -20,11 +20,15 @@ interface SearchState {
   breakdown: Record<number, VolumeStats>;
   isLoading: boolean;
   timeTaken: number;
-  
+  suggestions: string[];
+  showSuggestions: boolean;
+
   // Actions
   setQuery: (q: string) => void;
   performSearch: () => Promise<void>;
   clearResults: () => void;
+  fetchSuggestions: (prefix: string) => Promise<void>;
+  setShowSuggestions: (v: boolean) => void;
 }
 
 export const useSearchStore = create<SearchState>((set, get) => ({
@@ -34,14 +38,31 @@ export const useSearchStore = create<SearchState>((set, get) => ({
   breakdown: {},
   isLoading: false,
   timeTaken: 0,
+  suggestions: [],
+  showSuggestions: false,
 
   setQuery: (q) => set({ query: q }),
 
+  fetchSuggestions: async (prefix: string) => {
+    if (!prefix.trim()) {
+      set({ suggestions: [], showSuggestions: false });
+      return;
+    }
+    try {
+      const res = await api.get('/api/search/suggestions', { params: { q: prefix, limit: 8 } });
+      set({ suggestions: res.data, showSuggestions: res.data.length > 0 });
+    } catch {
+      set({ suggestions: [], showSuggestions: false });
+    }
+  },
+
+  setShowSuggestions: (v) => set({ showSuggestions: v }),
+
   performSearch: async () => {
     const { query } = get();
     if (!query.trim()) return;
 
-    set({ isLoading: true });
+    set({ isLoading: true, showSuggestions: false });
     try {
       const response = await api.get('/api/search', { params: { q: query } });
       set({
@@ -57,5 +78,5 @@ export const useSearchStore = create<SearchState>((set, get) => ({
     }
   },
 
-  clearResults: () => set({ results: [], totalResults: 0, breakdown: {}, query: '' })
+  clearResults: () => set({ results: [], totalResults: 0, breakdown: {}, query: '', suggestions: [], showSuggestions: false })
 }));