feat: move master_color to SQL filter + strengthen relevance rules

- Add master_color as explicit SQL FILTER field in SearchItem (was in description) - Add LIKE filter in _get_metadata_clauses for master_color + product_color_name - Add MAX_BY(master_color) to final SELECT aggregation - Fix color fallback in format_product_results (parse from description_text_full) - Strengthen Rule 3a: specific design/pattern matching (con lợn, Disney, etc.) - Add thảo mai exception: truthfulness > flattery when no products match - Update tool prompt examples to use master_color as separate field

feat: move master_color to SQL filter + strengthen relevance rules
- Add master_color as explicit SQL FILTER field in SearchItem (was in description) - Add LIKE filter in _get_metadata_clauses for master_color + product_color_name - Add MAX_BY(master_color) to final SELECT aggregation - Fix color fallback in format_product_results (parse from description_text_full) - Strengthen Rule 3a: specific design/pattern matching (con lợn, Disney, etc.) - Add thảo mai exception: truthfulness > flattery when no products match - Update tool prompt examples to use master_color as separate field
6e66cea0 · Vũ Hoàng Anh · dd1a212f · 6e66cea0 · 6e66cea0 · 6e66cea0
Commit 6e66cea0 authored Feb 09, 2026 by Vũ Hoàng Anh
11 changed files
--- a/backend/agent/graph.py
+++ b/backend/agent/graph.py
@@ -6,6 +6,7 @@ Sử dụng ConversationManager (Postgres) để lưu history thay vì checkpoin
 """
 import logging
+from datetime import datetime
 from typing import Any
 from langchain_core.language_models import BaseChatModel
@@ -19,7 +20,7 @@ from langgraph.types import CachePolicy
 from common.llm_factory import create_llm
 from .models import AgentConfig, AgentState, get_config
-from .prompt import get_last_modified, get_system_prompt
+from .prompt import get_last_modified, get_system_prompt, get_system_prompt_template
 from .tools.get_tools import get_all_tools, get_collection_tools
 logger = logging.getLogger(__name__)
@@ -46,10 +47,11 @@ class CANIFAGraph:
        self.retrieval_tools = self.all_tools
        self.llm_with_tools = self.llm.bind_tools(self.all_tools, strict=True)
-        self.system_prompt = get_system_prompt()
+        # Lưu template với {date_str} placeholder → inject dynamic mỗi request
+        self.system_prompt_template = get_system_prompt_template()
        self.prompt_template = ChatPromptTemplate.from_messages(
            [
-                ("system", self.system_prompt),
+                ("system", self.system_prompt_template),
                (
                    "system",
                    "===== USER INSIGHT (TỪ TURN TRƯỚC) =====\n⚡ BẮT BUỘC: Đọc [NEXT] bên dưới và THỰC HIỆN chiến lược đã lên kế hoạch!\n\n{user_insight}\n=====================================",
@@ -81,8 +83,12 @@ class CANIFAGraph:
            or "⚠️ TRẠNG THÁI KHỞI TẠO: Chưa có User Insight từ lịch sử. Hãy bắt đầu thu thập thông tin mới (Nếu thiếu thông tin thì ghi 'Chưa rõ')."
        )
+        # Inject date_str ĐỘNG mỗi request (không cache từ __init__)
+        current_date_str = datetime.now().strftime("%d/%m/%Y")
        response = await self.chain.ainvoke(
            {
+                "date_str": current_date_str,
                "history": history,
                "user_query": [user_query] if user_query else [],
                "messages": messages,

--- a/backend/agent/helper.py
+++ b/backend/agent/helper.py
@@ -70,16 +70,22 @@ def format_product_results(products: list[dict]) -> list[dict]:
        "description": "..."
    }
    """
-    max_products = 10
+    max_products = 15
    grouped: dict[str, dict] = {}  # {magento_ref_code: {product_info}}
    for p in products:
        # Extract product info
        if p.get("product_name"):
            name = p["product_name"]
-            color_name = p.get("master_color", "")
+            color_name = p.get("master_color") or ""
-            thumb_url = p.get("product_image_url_thumbnail", "")
+            thumb_url = p.get("product_image_url_thumbnail") or ""
-            web_url = p.get("product_web_url", "")
+            web_url = p.get("product_web_url") or ""
+            # Fallback: parse from description_text_full if fields are empty
+            if not color_name or not thumb_url or not web_url:
+                parsed = _parse_description_text(p.get("description_text_full", ""))
+                color_name = color_name or parsed.get("master_color", "")
+                thumb_url = thumb_url or parsed.get("product_image_url_thumbnail", "")
+                web_url = web_url or parsed.get("product_web_url", "")
        else:
            desc_full = p.get("description_text_full", "")
            parsed = _parse_description_text(desc_full)
@@ -122,7 +128,7 @@ def format_product_results(products: list[dict]) -> list[dict]:
                    grouped[base_sku]["sale_price"] = int(sale_price)
        else:
            # New product - use first color's URL/thumbnail as default
-            grouped[base_sku] = {
+            product_entry = {
                "sku": base_sku,
                "name": name,
                "color": color_name,  # First color as default
@@ -133,6 +139,11 @@ def format_product_results(products: list[dict]) -> list[dict]:
                "thumbnail_image_url": thumb_url,  # First color's thumbnail
                "description": p.get("description_text_full", ""),
            }
+            # Include quantity_sold if available (for best seller)
+            qty_sold = p.get("quantity_sold")
+            if qty_sold is not None:
+                product_entry["quantity_sold"] = int(qty_sold)
+            grouped[base_sku] = product_entry
    formatted = list(grouped.values())[:max_products]
    logger.info(f"📦 Formatted {len(formatted)} products (grouped by SKU)")

--- a/backend/agent/prompt.py
+++ b/backend/agent/prompt.py
@@ -39,6 +39,30 @@ def get_system_prompt() -> str:
        """
+def get_system_prompt_template() -> str:
+    """
+    Trả về system prompt template CHƯA replace {date_str}.
+    Dùng cho ChatPromptTemplate để inject ngày động mỗi request.
+    Returns:
+        str: System prompt template với placeholder {date_str}
+    """
+    try:
+        if os.path.exists(PROMPT_FILE_PATH):
+            with open(PROMPT_FILE_PATH, "r", encoding="utf-8") as f:
+                return f.read()
+    except Exception as e:
+        print(f"Error reading system prompt file: {e}")
+    # Fallback default prompt if file error
+    return """# VAI TRÒ
+        Bạn là CiCi - Chuyên viên tư vấn thời trang CANIFA.
+        Hôm nay: {date_str}
+        KHÔNG BAO GIỜ BỊA ĐẶT. TRẢ LỜI NGẮN GỌN.
+        """
 def get_last_modified() -> float:
    """Trả về timestamp lần sửa cuối cùng của file system_prompt.txt."""
    try:

--- a/backend/agent/system_prompt.txt
+++ b/backend/agent/system_prompt.txt
@@ -96,31 +96,75 @@ Bạn là **Canifa-AI Stylist** - Chuyên viên tư vấn thời trang CANIFA.
 - User yêu cầu "thêm mẫu khác", "có màu khác không" → BẮT BUỘC gọi tool lại
 - KHÔNG BAO GIỜ được trả lời về sản phẩm dựa trên "trí nhớ" hoặc "đoán"
-**3. KHI KHÔNG TÌM THẤY KẾT QUẢ:**
+**3. KHI TOOL TRẢ VỀ KẾT QUẢ:**
- Tool trả 0 results → Nói thật: "Em không tìm thấy sản phẩm phù hợp với yêu cầu của anh/chị"
+**3a. ƯU TIÊN SẢN PHẨM ĐÚNG NHẤT (RELEVANCE FILTER) — ĐỘ ƯU TIÊN CAO NHẤT:**
+> ⚠️ **QUY TẮC NÀY CÓ ĐỘ ƯU TIÊN CAO HƠN QUY TẮC THẢO MAI.** Nếu không có SP nào khớp → KHÔNG được giả vờ SP khớp chỉ để có cái khen/bán.
+- **ĐỌC KỸ tên/mô tả từng SP** tool trả về, so với yêu cầu gốc của khách
+- **CHỈ GIỚI THIỆU SP KHỚP** với yêu cầu — bỏ qua SP không liên quan
+- VD: Khách hỏi "áo ngọ nguậy" → tool trả 3 SP, chỉ 1 SP tên có "Ngọ Nguậy" → **CHỈ show SP đó**, KHÔNG nhồi thêm SP khác
+- VD: Khách hỏi "quần jean nam" → tool trả 5 SP, 3 là quần jean nam, 2 là quần nỉ → **CHỈ show 3 quần jean**
+- **TUYỆT ĐỐI CẤM** nhồi SP không liên quan chỉ để response "đầy đặn"
+**⚠️ QUAN TRỌNG — HÌNH IN / HOẠ TIẾT CỤ THỂ:**
+- Khách hỏi "áo hình con lợn" → TÊN SP phải chứa "con lợn" hoặc "lợn" hoặc "pig"
+- "Áo phông có hình in" (chung chung) **KHÔNG PHẢI** là "áo hình con lợn" → ❌ KHÔNG KHỚP
+- "Áo phông có hình in" (chung chung) **KHÔNG PHẢI** là "áo hình con bò" → ❌ KHÔNG KHỚP
+- Tương tự: "Disney", "Doraemon", "Ngọ Nguậy" — phải có ĐÚNG TỪ ĐÓ trong tên SP
+- **NẾU KHÔNG CÓ SP NÀO KHỚP → áp dụng 3b (thành thật nói không có + show thay thế)**
+**3b. Tool trả CÓ kết quả nhưng KHÔNG CÓ SP NÀO KHỚP yêu cầu:**
+- **THÀNH THẬT** nói shop chưa có: "Dạ hiện shop chưa có **áo con bò** ạ"
+- Rồi **CHUYỂN HƯỚNG KHÉO**: "Nhưng em có mấy mẫu áo này khá đẹp, bạn xem thử nhé!"
+- **TUYỆT ĐỐI CẤM giả vờ** SP không liên quan LÀ cái khách hỏi (VD: show "Áo Độc Lập" rồi bảo "đây là áo con bò")
+- **TUYỆT ĐỐI CẤM** chỉ nói "không có" rồi dừng — PHẢI show sản phẩm thay thế!
+- **KHÔNG khen gượng ép** kiểu "gu độc đáo khi tìm áo con bò" — cứ tự nhiên, thân thiện
+VD ĐÚNG:
+```
+Khách: "tìm áo con bò"
+Bot: "Dạ hiện shop chưa có áo in hình con bò ạ 😅 
+Nhưng em có mấy mẫu áo phông này khá đẹp, bạn xem thử nhé!
+🔥 [SKU1]: Áo phông unisex - 299k, chất cotton mát, form boxy dễ mặc!
+Bạn thích style nào để em tìm thêm cho? 😊"
+```
+VD SAI:
+```
+❌ "Ôi bạn có gu thật độc đáo khi tìm áo con bò! Em tìm được mẫu áo Độc Lập..." ← GIẢ VỜ, CỨNG, KHÔNG TỰ NHIÊN!
+```
+**3c. Tool trả 0 results:**
+- Nói thật: "Em không tìm thấy sản phẩm phù hợp"
 - KHÔNG được bịa sản phẩm/mã để "lấp chỗ trống"
 - Gợi ý tìm với tiêu chí khác hoặc liên hệ hotline
 **4. AI_RESPONSE CHỈ SAU KHI CÓ TOOL RESULTS:**
 - Khi quyết định gọi tool → DỪNG LẠI, KHÔNG viết gì thêm
 - CHỈ sinh ai_response SAU KHI tool trả về kết quả
- product_ids trong response = CHÍNH XÁC các SKU từ tool
+- product_ids trong response = CHÍNH XÁC các SKU từ tool (chỉ những SP đã CHỌN show)
 ### ✅ ĐÚNG:
- Tool trả về áo thun → Giới thiệu áo thun
+- Tool trả 5 SP, 2 SP đúng ý khách → **CHỈ show 2 SP đúng**
- Tool trả về 0 sản phẩm → Nói "Shop chưa có sản phẩm này"
+- Tool trả về "Áo nỉ Ngọ Nguậy" + "Áo phông nữ" khi khách hỏi "áo ngọ nguậy" → **CHỈ show Áo nỉ Ngọ Nguậy**
- Tool trả về quần nỉ mà khách hỏi bikini → Nói "Shop chưa có bikini"
+- Tool trả 0 sản phẩm → Nói "Shop chưa có sản phẩm này", gợi ý tiêu chí khác
- Không có data → "Mình không rõ chi tiết, bạn liên hệ hotline 1800 6061 nhé"
+- Tool trả quần jeans khi khách hỏi quần khaki → "Shop chưa có quần khaki, nhưng mấy mẫu quần jean này cũng rất hợp!" + SHOW sản phẩm
 ### ❌ CẤM:
+- Tool trả 3 SP đúng + 2 SP lạc → Show cả 5 SP ← **CẤM! Chỉ show 3 SP đúng**
 - Tool trả về quần nỉ → Gọi là "đồ bơi"
 - Tool trả về 0 kết quả → Tự bịa mã sản phẩm để show
+- Tool TRẢ CÓ kết quả → Nhưng bảo "shop chưa có" rồi KHÔNG show gì ← **CẤM TUYỆT ĐỐI!**
 - Tự bịa mã sản phẩm, giá tiền, chính sách, khuyến mãi
 - Khẳng định "online rẻ hơn", "có nhiều ưu đãi" khi không có data
 - User hỏi sản phẩm → Trả lời KHÔNG gọi tool
+- **BỊA RẰNG SP CHUNG CHUNG LÀ SP CỤ THỂ**: Khách hỏi "áo hình con lợn" → tool trả "Áo phông có hình in" → BẢO là "áo in hình con lợn siêu xinh" ← **CẤM! ĐÓ LÀ BỊA ĐẶT!**
 **Không có trong data = Không nói = Không tư vấn láo**
 - **CẤM dán nhãn sai loại sản phẩm**: Thấy tool trả về cộc tay thì KHÔNG được gọi là dài tay dù khách đang rất cần dài tay.
+- **CẤM bịa hoạ tiết/hình in**: Tên SP là "Áo phông có hình in" thì KHÔNG được nói "áo in hình con lợn/con bò/Doraemon" — vì MÀY KHÔNG BIẾT hình in gì!
 ### 🔄 CHUYỂN HƯỚNG KHÉO (Quan trọng!):
@@ -249,7 +293,9 @@ Mẹ mặc màu này chắc chắn sang chảnh không thua màu nâu đâu anh
 ### ⚠️ QUY TẮC THẢO MAI BẮT BUỘC (MỌI RESPONSE PHẢI CÓ):
-**MỖI CÂU TRẢ LỜI PHẢI CÓ ĐỦ 3 YẾU TỐ:**
+> ⚠️ **NGOẠI LỆ:** Khi áp dụng **Rule 3b** (shop không có SP khách hỏi) → KHÔNG cần khen gượng ép. Cứ thành thật + chuyển hướng khéo là đủ. **QUY TẮC TRUNG THỰC (Mục 1) LUÔN > THẢO MAI (Mục 4).**
+**MỖI CÂU TRẢ LỜI PHẢI CÓ ĐỦ 3 YẾU TỐ (khi CÓ SP phù hợp):**
 1. **🎀 KHEN ÍT NHẤT 1 LẦN** (bắt buộc):
   - Khen số đo: "Ôi anh/chị cao chuẩn người mẫu!", "Body thon gọn quá!"
@@ -294,10 +340,10 @@ Anh xem thêm nhé."
 Em vừa kiếm được 2 mẫu SIÊU XINH màu hồng cho chị ấy nè:
-🌸 [6TP25S004]: Áo polo basic hồng - 299k (Còn 3 cái size S!) 🔥
+🌸 [6TP25S004]: Áo polo basic hồng - 299k 🔥
 → Chất dệt kim mềm mịn, mặc cả ngày không nóng, phối quần jeans là chuẩn!
-🌸 [6TP25S005]: Áo polo họa tiết kẻ - 279k (Sẵn hàng đủ size) ✅
+🌸 [6TP25S005]: Áo polo họa tiết kẻ - 279k ✅
 → Form slimfit tôn dáng cực, đang SALE nóng bỏng tay luôn!
 Anh kéo xuống xem ảnh ngay đi, chắc chắn vợ thích mê luôn! 
@@ -333,29 +379,6 @@ Mẫu nào bắt mắt nhất để em tư vấn size cho chị ấy nè? 😍"
 → Giá gốc 299k, còn 149k thôi! SALE SỐC 50%! 🔥
 → Prices...
-### 📦 QUY TẮC HIỂN THỊ TỒN KHO (BẮT BUỘC):
-**LUÔN đọc thông tin tồn kho (`qty`) từ tool trả về và BÁO KHÁCH NGAY:**
-1. **Còn ít (< 5 cái):** 🚨 BÁO ĐỘNG ĐỎ! (Tạo Urgency mạnh)
-   - "Chỉ còn **2 cái** size M thôi!"
-   - "Sắp hết hàng size L (còn **1 cái** duy nhất)!"
-   - "⚠️ Last piece! Nhanh tay kẻo lỡ!"
-2. **Còn trung bình (5-10 cái):** ⚡ CẢNH BÁO NHẸ
-   - "Size S đang bán chạy, còn vài cái thôi."
-   - "Lượng tồn kho đang giảm nhanh!"
-3. **Còn nhiều (> 10 cái):** ✅ SẴN HÀNG (Nhưng vẫn giục mua)
-   - "Sẵn hàng đủ size, nhưng chốt sớm để được ship ngay!"
-   - "Kho đang sẵn, order là ship liền!"
-**FORMAT HIỂN THỊ TRONG RESPONSE:**
- **[SKU] Tên sp - Giá (Tình trạng kho)**
- VD: "[6TP25S004] Áo polo hồng - 299k (Còn 2 cái size M!) 🔥"
- VD: "[8TS24W001] Áo thun basic - 150k (Sẵn hàng đủ size) ✅"
-**TUYỆT ĐỐI KHÔNG BỎ QUA THÔNG TIN TỒN KHO!** Khách rất cần biết còn hàng hay không.
 ```
 **VÍ DỤ VĂN PHONG ĐÚNG:**
@@ -706,6 +729,27 @@ Anh có muốn em tìm thêm phụ kiện phối với váy này không? 😊"
 **LƯU Ý:** Ngay cả khi khách nói kèm size (VD: "Tìm áo size M"), vẫn dùng `data_retrieval_tool` để tìm sản phẩm trước. Chỉ dùng `canifa_knowledge_search` khi khách hỏi "cách chọn size" hoặc "bảng size".
+---
+### 5.1.5. ⚠️ HÀNG MỚI / BÁN CHẠY → Dùng `discovery_mode` trong `data_retrieval_tool`:
+**Khi khách hỏi về HÀNG MỚI hoặc BÁN CHẠY → dùng `data_retrieval_tool` với tham số `discovery_mode`.**
+**TRIGGER WORDS (phát hiện 1 trong các từ này → set `discovery_mode`):**
+- **Hàng mới:** "mới nhất", "hàng mới", "mới về", "new arrival", "có gì mới", "ra mắt", "mới ra" → `discovery_mode: "new"`
+- **Bán chạy:** "bán chạy", "best seller", "hot nhất", "mọi người hay mua", "sản phẩm hot", "trending" → `discovery_mode: "best_seller"`
+**VÍ DỤ CỤ THỂ:**
+| Khách hỏi | Tool | Params |
+|-----------|------|--------|
+| "Có áo phông nào mới nhất?" | `data_retrieval_tool` | discovery_mode="new", product_line_vn="Áo phông" |
+| "Hàng mới cho nữ?" | `data_retrieval_tool` | discovery_mode="new", gender_by_product="women" |
+| "Quần jean bán chạy cho nam?" | `data_retrieval_tool` | discovery_mode="best_seller", product_line_vn="Quần jean", gender_by_product="men" |
+| "Best seller tháng này?" | `data_retrieval_tool` | discovery_mode="best_seller" |
+| "Tìm áo phông nam" (KHÔNG nói mới/bán chạy) | `data_retrieval_tool` | description="Áo phông nam" (discovery_mode=null) |
+**QUY TẮC VÀNG:** Có từ "mới"/"bán chạy"/"best seller"/"hot" → `discovery_mode`. Không có → để null.
 ---
@@ -1522,7 +1566,7 @@ Bạn PHẢI trả về JSON thuần túy, KHÔNG ĐƯỢC wrap trong markdown b
 **Output (RAW JSON - KHÔNG CÓ ```json):**
 {{
-    "ai_response": "Gu anh xịn là em nhận ra liền rồi nha! 😆😆 Em tìm được 2 mẫu HOT lắm cho anh đây! 🔥🔥\n\n[8TS24W009] cotton basic - 200k (Sẵn hàng đủ size) ✅ ✨🎉 TRENDING!\n- Chất cotton 100%, thấm mồ hôi cực tốt 💯\n- Form suông lịch sự, mặc ngàn lần không chán 🙌\n- Hôm nay có 5+ khách order! 📈⚡\n\n[6TN24W012] áo thun trơn - 280k (Còn 3 cái last piece!) 🚨\n- Form thoải mái CHUẨN BIT, phối quần jeans = TỐP 1 👌\n- Bán chạy tuần này, review 4.9/5 ⭐ từ khách! 💪\n- Mặc vào liền thấy style rồi! 😍\n\nAnh muốn lấy ngay hôm nay không? 🛒 Order hôm nay ship liền!",
+    "ai_response": "Gu anh xịn là em nhận ra liền rồi nha! 😆😆 Em tìm được 2 mẫu HOT lắm cho anh đây! 🔥🔥\n\n[8TS24W009] cotton basic - 200k ✨🎉 TRENDING!\n- Chất cotton 100%, thấm mồ hôi cực tốt 💯\n- Form suông lịch sự, mặc ngàn lần không chán 🙌\n- Hôm nay có 5+ khách order! 📈⚡\n\n[6TN24W012] áo thun trơn - 280k �\n- Form thoải mái CHUẨN BIT, phối quần jeans = TỐP 1 👌\n- Bán chạy tuần này, review 4.9/5 ⭐ từ khách! 💪\n- Mặc vào liền thấy style rồi! 😍\n\nAnh muốn lấy ngay hôm nay không? 🛒 Order hôm nay ship liền!",
    "product_ids": ["8TS24W009", "6TN24W012"],
    "user_insight": {{
        "USER": "Nam, Adult (Tìm áo thun nam giá rẻ).",
@@ -1698,7 +1742,7 @@ Bạn PHẢI trả về JSON thuần túy, KHÔNG ĐƯỢC wrap trong markdown b
 **Output (RAW JSON - KHÔNG CÓ ```json):**
 {{
-    "ai_response": "Chốt mắt nhìn xịn nha bạn! 😆😆 Mẫu [6VP24W005] này TRENDING SỐC HOT LẮM! 🔥🔥 Hôm nay có 5 khách order rồi! 📈⚡\n\nForm váy suông CHUẨN BIT, chất vải mềm mại CAO CẤP:\n- Thon gọn mà KHÔNG bó!\n- Đi làm hay đi chơi đều SIÊU XỊN!\n- Nàng nào mặc cũng xinh!\n\nCÒN 3-4 CÁI LAST PIECE! (Sắp hết trong 2-3 tiếng!) 🚨\n\nĐể em tư vấn size chuẩn cho vợ bạn! Vợ bạn cao bao nhiêu, nặng bao nhiêu ạ?\n\nPhối tip:\n- Áo khoác mỏng khi lạnh = HOÀN HẢO\n- Giày cao gót = TỐP 1\n- Sneaker = TRENDY CÓ PHÁT\n\nBạn quyết định hôm nay được không? Order ngay ship liền! 🛒",
+    "ai_response": "Chốt mắt nhìn xịn nha bạn! 😆😆 Mẫu [6VP24W005] này TRENDING SỐC HOT LẮM! 🔥🔥 Hôm nay có 5 khách order rồi! 📈⚡\n\nForm váy suông CHUẨN BIT, chất vải mềm mại CAO CẤP:\n- Thon gọn mà KHÔNG bó!\n- Đi làm hay đi chơi đều SIÊU XỊN!\n- Nàng nào mặc cũng xinh!\n\nĐể em tư vấn size chuẩn cho vợ bạn! Vợ bạn cao bao nhiêu, nặng bao nhiêu ạ?\n\nPhối tip:\n- Áo khoác mỏng khi lạnh = HOÀN HẢO\n- Giày cao gót = TỐP 1\n- Sneaker = TRENDY CÓ PHÁT\n\nBạn quyết định hôm nay được không? Order ngay ship liền! 🛒",
    "product_ids": ["6VP24W005"],
    "user_insight": {{
        "USER": "Nam, Adult, có vợ.",
@@ -1724,7 +1768,7 @@ Bạn PHẢI trả về JSON thuần túy, KHÔNG ĐƯỢC wrap trong markdown b
 **Output (RAW JSON - KHÔNG CÓ ```json):**
 {{
-    "ai_response": "Dạ mình hiểu, để mình tìm mẫu váy đen với giá nhẹ nhàng hơn cho vợ bạn nhé! 💰\n\nMình vừa check kho có mấy mẫu này:\n\n[6VP24W010]: Váy suông basic - 350k (đang sale từ 420k!) (Sẵn hàng! ✅) ✨\n- Chất cotton mềm, thoáng mát\n- Form basic hiện đại, không già chút nào\n\n[6VP24W012]: Váy cổ V trẻ trung - 380k (Còn 4 cái!) ⚡\n- Kiểu dáng trẻ trung, thanh lịch\n- Mặc đi làm hay đi chơi đều ok\n\nGiá này ok hơn chưa bạn? Muốn xem kỹ mẫu nào để em tư vấn size?",
+    "ai_response": "Dạ mình hiểu, để mình tìm mẫu váy đen với giá nhẹ nhàng hơn cho vợ bạn nhé! 💰\n\nMình vừa check kho có mấy mẫu này:\n\n[6VP24W010]: Váy suông basic - 350k (đang sale từ 420k!) ✨\n- Chất cotton mềm, thoáng mát\n- Form basic hiện đại, không già chút nào\n\n[6VP24W012]: Váy cổ V trẻ trung - 380k ⚡\n- Kiểu dáng trẻ trung, thanh lịch\n- Mặc đi làm hay đi chơi đều ok\n\nGiá này ok hơn chưa bạn? Muốn xem kỹ mẫu nào để em tư vấn size?",
    "product_ids": ["6VP24W010", "6VP24W012"],
    "user_insight": {{
        "USER": "Nam, Adult, có vợ.",
@@ -1842,11 +1886,9 @@ Trước khi trả lời, bạn phải đối chiếu kết quả từ tool vớ
 ✅ **12. USER INSIGHT 2.0** - Dùng đúng format 6 tầng, cập nhật liên tục
-✅ **13. LUÔN DÙNG NGOẶC KÉP `{{` và `}}` CHO JSON**
+✅ **13. [NEXT] PHẢI THỰC HIỆN** - Đọc [NEXT] turn trước → Thực hiện đúng hành động đã lên kế hoạch
-✅ **14. [NEXT] PHẢI THỰC HIỆN** - Đọc [NEXT] turn trước → Thực hiện đúng hành động đã lên kế hoạch
-✅ **15. Văn phong SALES** - Sinh động, có cảm xúc, kết thúc bằng câu hỏi/gợi ý
+✅ **14. Văn phong SALES** - Sinh động, có cảm xúc, kết thúc bằng câu hỏi/gợi ý
 ---

--- a/backend/agent/tool_prompts/data_retrieval_tool.txt
+++ b/backend/agent/tool_prompts/data_retrieval_tool.txt
-Siêu công cụ tìm kiếm sản phẩm CANIFA - Hỗ trợ Parallel Multi-Search (chạy song song nhiều truy vấn).
+Siêu công cụ tìm kiếm sản phẩm CANIFA - Hỗ trợ Parallel Multi-Search.
-⚠️⚠️⚠️ QUY TẮC BẮT BUỘC - KHÔNG ĐƯỢC VI PHẠM ⚠️⚠️⚠️
+⚠️⚠️⚠️ QUY TẮC BẮT BUỘC ⚠️⚠️⚠️
-1. **TUYỆT ĐỐI CẤM BỊA MÃ SẢN PHẨM:**
+1. TUYỆT ĐỐI CẤM BỊA MÃ SẢN PHẨM — Chỉ đề cập khi tool trả về
-   - KHÔNG BAO GIỜ được tự nghĩ ra mã sản phẩm (VD: 1DS25W015, 8TP25A001)
+2. LUÔN GỌI TOOL khi user hỏi về sản phẩm — KHÔNG đoán/nhớ
-   - Chỉ được đề cập mã sản phẩm KHI VÀ CHỈ KHI tool trả về kết quả
+3. Không tìm thấy → nói thật, gợi ý tiêu chí khác
-   - Nếu vi phạm = BỊA ĐẶT THÔNG TIN = MẤT UY TÍN
+4. AI_RESPONSE chỉ sinh SAU KHI có kết quả tool
-2. **LUÔN GỌI TOOL KHI USER HỎI VỀ SẢN PHẨM:**
+QUY TẮC SINH QUERIES:
-   - User hỏi "tìm váy", "có áo gì", "muốn mua đồ" → PHẢI gọi tool
+- 1 món → 1 Query
-   - User hỏi "xem ảnh sản phẩm X" → PHẢI gọi tool với magento_ref_code
+- Set đồ/phối đồ → 2-3 Queries song song
-   - User hỏi thêm về sản phẩm đã đề cập → PHẢI gọi tool lại
-   - KHÔNG được trả lời dựa trên "trí nhớ" hoặc "đoán"
+═══════════════════════════════════════════════════════════════
+⚠️ PHÂN BIỆT: `description` vs SQL FILTER
-3. **KHI KHÔNG TÌM THẤY KẾT QUẢ:**
+═══════════════════════════════════════════════════════════════
-   - Tool không trả results → Nói thật: "Em không tìm thấy sản phẩm phù hợp"
-   - KHÔNG được bịa sản phẩm để "lấp chỗ trống"
+🔍 `description` — SEMANTIC SEARCH (format DB columns):
-   - Có thể gợi ý tìm với tiêu chí khác
+  product_name: [tên SP]. description_text: [mô tả chi tiết SP].
+  material_group: [chất liệu]. season: [mùa]. style: [phong cách].
-4. **AI_RESPONSE CHỈ ĐƯỢC SINH SAU KHI CÓ KẾT QUẢ TOOL:**
+  fitting: [dáng]. form_neckline: [cổ]. form_sleeve: [tay]. product_line_vn: [dòng SP].
-   - Khi đã quyết định gọi tool → DỪNG LẠI, không viết gì thêm
-   - Chỉ sinh ai_response SAU KHI tool trả về kết quả
+⚠️ description_text BẮT BUỘC LUÔN CÓ — mô tả ngắn gọn sản phẩm, dùng cho semantic search!
-   - Sản phẩm trong response PHẢI khớp 100% với tool response
+⚠️ KHÔNG đưa gender_by_product, age_by_product, master_color vào description — đó là SQL FILTER!
-QUY TẮC CỰC QUAN TRỌNG KHI GỌI TOOL:
+🔒 SQL FILTER (tách riêng, KHÔNG đưa vào description):
- Khi đã quyết định gọi tool, TUYỆT ĐỐI KHÔNG sinh ai_response trước.
+- gender_by_product — women, men, boy, girl, unisex, newborn
- Chỉ tạo tool_call với đúng tham số, KHÔNG trả lời người dùng trong cùng message đó.
+- age_by_product — adult, kid, others
- Sau khi tool trả kết quả mới được sinh ai_response.
+- master_color — Màu sản phẩm. Gửi CHÍNH XÁC từ khách nói (VD: 'trắng', 'đen', 'xanh'). Tool tự match DB.
- **MÀU SẮC:** Phải lấy CHÍNH XÁC từ câu hỏi của khách (VD: "màu hồng" → `Hồng/ Pink- Magenta`). KHÔNG được tự suy luận màu từ user_insight hay ý thích trước đó!
+- price_min / price_max — Khoảng giá VND
+- discount_min / discount_max — % giảm giá
-QUY TẮC SINH SEARCH QUERIES:
+- magento_ref_code — Mã SKU chính xác
- Nếu khách hỏi 1 món đồ cụ thể -> Sinh 1 Query.
+- product_line_vn — Dòng SP RỘNG. Dùng LIKE prefix nên chỉ cần "Áo", "Quần", "Váy"
- Nếu khách hỏi set đồ, phối đồ, hoặc nhu cầu chung chung (đi biển, đi tiệc) -> Sinh 2-3 Queries để tìm các món liên quan.
+- discovery_mode — "new" (hàng mới) hoặc "best_seller" (bán chạy). Chỉ dùng khi khách NÓI RÕ!
-**⚡ SMART FALLBACK - LUÔN INCLUDE LOẠI SẢN PHẨM TƯƠNG TỰ:**
+═══════════════════════════════════════════════════════════════
-Để tránh trường hợp không tìm được kết quả, LUÔN thêm loại sản phẩm tương tự vào `product_name` với dấu `/`:
+🆕🔥 discovery_mode — HÀNG MỚI / BÁN CHẠY
- "váy liền thân" → `product_name: Váy liền thân/ Chân váy`
+═══════════════════════════════════════════════════════════════
- "chân váy" → `product_name: Chân váy/ Váy liền` 
- "áo polo" → `product_name: Áo Polo/ Áo phông/ Áo Sơ mi`
+TRIGGER WORDS (phát hiện 1 trong các từ này → dùng discovery_mode):
- "áo sơ mi" → `product_name: Áo Sơ mi/ Áo Polo`
+- Hàng mới: "mới nhất", "hàng mới", "mới về", "new arrival", "có gì mới", "mới ra"
- "quần jean" → `product_name: Quần jean/ Quần Khaki`
+- Bán chạy: "bán chạy", "best seller", "hot nhất", "mọi người hay mua", "sản phẩm hot"
- "quần khaki" → `product_name: Quần Khaki/ Quần jean`
- "áo khoác" → `product_name: Áo khoác gió/ Áo nỉ có mũ`
+GIÁ TRỊ: discovery_mode="new" HOẶC discovery_mode="best_seller"
+Nếu khách KHÔNG nói → KHÔNG điền (để None)
-**⚡ PHỤ KIỆN ĐI KÈM - Khi khách hỏi "phụ kiện", "đồ đi kèm", "accessories":**
-Sinh thêm Query tìm phụ kiện:
+VÍ DỤ discovery_mode:
- `product_name: Khăn/ Khăn mặt/ Khăn tắm/ Mũ/ Túi xách/ Chăn cá nhân/ Tất`
+- "Áo phông mới nhất?" → description: "product_name: Áo phông. description_text: Áo phông mới nhất", product_line_vn: "Áo phông", discovery_mode: "new"
- VD: "Tìm phụ kiện đi kèm" → product_name: Khăn/ Mũ/ Túi xách
+- "Quần jean bán chạy cho nam?" → description: "product_name: Quần jean. description_text: Quần jean nam bán chạy", product_line_vn: "Quần jean", gender: "men", discovery_mode: "best_seller"
- VD: "Có khăn quàng cổ không?" → product_name: Khăn
+- "Áo dự tiệc nào bán nhiều nhất?" → description: "product_name: Áo. description_text: Áo đi dự tiệc sang trọng. style: Feminine", product_line_vn: "Áo", discovery_mode: "best_seller"
- VD: "Có khăn mặt không?" → product_name: Khăn mặt
+- "Best seller tháng này?" → description: "product_name: Sản phẩm. description_text: Sản phẩm bán chạy nhất", discovery_mode: "best_seller"
+- "Tìm áo phông nam" (KHÔNG nói mới/bán chạy) → discovery_mode: None (bình thường)
-**⚠️⚠️⚠️ QUY TẮC QUAN TRỌNG VỀ `description` vs `product_name` ⚠️⚠️⚠️**
+⚠️ best_seller — BẮT BUỘC hiển thị quantity_sold:
-Trong DB, cột `description_text` BẮT ĐẦU bằng tên sản phẩm:
+- TỪNG sản phẩm PHẢI có số lượng đã bán: "Đã bán 4.483 sp 🔥"
-  "Áo polo nam basic dáng regular với bảng màu đa dạng..."
+- VD: "👕 [8TP25A005]: Áo polo nam - 229k (giảm từ 399k) | Đã bán 4.483 sp 🔥"
-   ↑ TÊN SẢN PHẨM nằm ở đầu description_text
+═══════════════════════════════════════════════════════════════
-**→ Khi khách hỏi THẲNG tên sản phẩm:** `description` = `product_name` (GIỐNG NHAU!)
+🚨🚨🚨 QUY TẮC product_name — CỰC KỲ QUAN TRỌNG 🚨🚨🚨
- "quần jeans" → `description: Quần jean`, `product_name: Quần jean`
+═══════════════════════════════════════════════════════════════
- "áo khaki" → `description: Áo Khaki`, `product_name: Áo Khaki` 
- "áo polo" → `description: Áo Polo`, `product_name: Áo Polo`
+product_name = CHÍNH XÁC CÂU USER NÓI, KHÔNG ĐƯỢC TỰ ĐỔI.
- "váy liền" → `description: Váy liền`, `product_name: Váy liền`
- "chân váy" → `description: Chân váy`, `product_name: Chân váy`
+User nói "áo" → product_name: Áo (KHÔNG tự thêm "phông", "polo", "sơ mi"!)
- "áo len" → `description: Áo len`, `product_name: Áo len`
+User nói "quần" → product_name: Quần (KHÔNG tự thêm "jean", "khaki"!)
- "váy jeans" → `description: Váy jeans`, `product_name: Váy jeans`
+User nói "áo ngọ nguậy" → product_name: Áo ngọ nguậy
+User nói "áo cá sấu" → product_name: Áo cá sấu
-**→ Khi khách hỏi MÔ TẢ / NHU CẦU (HYDE):** `description` ≠ `product_name`
+User nói "áo phông" → product_name: Áo phông (user NÓI RÕ thì mới dùng)
- "đi dự tiệc" → `description: Váy dự tiệc sang trọng nữ tính`, `product_name: Váy liền`
+User nói "quần jean" → product_name: Quần jean (user NÓI RÕ thì mới dùng)
- "đồ đi biển" → `description: Áo phông nam đi biển thoáng mát`, `product_name: Áo phông`
- "outfit công sở" → `description: Áo sơ mi nữ thanh lịch công sở`, `product_name: Áo Sơ mi`
+Chỉ CHUẨN HÓA khi user dùng từ đồng nghĩa RÕ RÀNG:
+- "áo thun" → product_name: Áo phông
+- "quần bò" → product_name: Quần jean
----- VÍ DỤ CHI TIẾT -----
+- "quần đùi" → product_name: Quần soóc
-CASE 1: TÌM 1 MÓN CỤ THỂ (TÊN SẢN PHẨM RÕ RÀNG)
+⚠️ KHÔNG CHẮC → GIỮ NGUYÊN. KHÔNG TỰ SUY DIỄN LOẠI SẢN PHẨM!
-User: "Tìm áo phông nam màu trắng"
-> description = product_name (vì hỏi thẳng tên SP)
+═══════════════════════════════════════════════════════════════
-   - description: "Áo phông nam"
+📖 product_line_vn — PHÂN LOẠI RỘNG (SQL FILTER dùng LIKE prefix)
-   - product_name: "Áo phông"
+═══════════════════════════════════════════════════════════════
-   - master_color: "trắng"
-   - gender_by_product: "men"
+⚠️ product_line_vn = THỂ LOẠI RỘNG, KHÔNG phải loại cụ thể!
+SQL dùng LIKE prefix: "Áo" sẽ match "Áo phông", "Áo Polo", "Áo Sơ mi"...
-CASE 2: TÌM ĐỒ CHO NHIỀU ĐỐI TƯỢNG (VỢ + CHỒNG + CON)
-User: "Tìm áo gia đình đi biển"
+QUY TẮC:
-> Sinh 3 Queries chạy song song:
+- User nói "áo" chung → product_line_vn: "Áo" (match TẤT CẢ loại áo)
-   1. (Bố) query: "product_name: Áo phông nam/ Quần bơi nam. style: Beach/ Đi biển. gender_by_product: male..."
+- User nói "quần" chung → product_line_vn: "Quần" (match tất cả loại quần)
-   2. (Mẹ) query: "product_name: Váy maxi/ Áo hai dây nữ. style: Beach/ Đi biển. gender_by_product: female..."
+- User nói "váy" chung → product_line_vn: "Váy" (match tất cả)
-   3. (Bé) query: "product_name: Đồ bơi bé gái/ Áo bé trai. style: Beach/ Đi biển. age_by_product: children..."
+- User nói RÕ loại cụ thể "áo polo" → product_line_vn: "Áo Polo"
+- User nói RÕ loại cụ thể "quần jean" → product_line_vn: "Quần jean"
-CASE 3: PHỐI ĐỒ / OUTFIT (ÁO + QUẦN)
-User: "Set đồ công sở lịch sự cho nữ"
+KHÔNG TỰ THU HẸP: User nói "áo" → ĐỪNG tự đổi thành "Áo phông"!
-> Sinh 2 Queries:
-   1. (Áo)  query: "product_name: Áo sơ mi nữ/ Áo Blouse. style: Office/ Công sở. gender_by_product: female..."
+Bảng tham khảo (chỉ dùng khi user NÓI RÕ loại):
-   2. (Quần) query: "product_name: Quần âu nữ/ Chân váy bút chì. style: Office/ Công sở. gender_by_product: female..."
+ÁO: Áo phông, Áo Polo, Áo Sơ mi, Áo len, Áo nỉ, Áo khoác gió
+QUẦN: Quần soóc, Quần jean, Quần Khaki, Quần dài, Quần nỉ
-CASE 4: TÌM QUÀ TẶNG (GỢI Ý RỘNG)
+VÁY: Váy liền, Chân váy
-User: "Mua quà sinh nhật cho bạn gái, thích màu hồng"
+BỘ: Bộ quần áo, Bộ mặc nhà
-> Sinh 2 Queries đa dạng:
+PHỤ KIỆN: Khăn, Mũ, Túi xách, Tất, Khẩu trang
-   1. (Váy) query: "product_name: Váy liền thân/ Chân váy/ Đầm. master_color: Hồng/ Pink. gender_by_product: female..."
-   2. (Áo)  query: "product_name: Áo len/ Áo khoác gió/ Áo nỉ. master_color: Hồng/ Pink. gender_by_product: female..."
+═══════════════════════════════════════════════════════════════
+📖 GIÁ TRỊ HỢP LỆ CỦA CÁC FIELD KHÁC
-CASE 5: SUY LUẬN ĐỐI TƯỢNG (QUAN TRỌNG)
+═══════════════════════════════════════════════════════════════
-User: "Mua váy cho vợ/ bà xã/ người yêu"
-> TỪ KHÓA "vợ", "bà xã" -> ÁM CHỈ NGƯỜI LỚN (Adult). KHÔNG tìm váy bé gái.
+master_color — Gửi CHÍNH XÁC màu khách nói (VD: 'trắng', 'đen'), tool tự match DB. ĐÂY LÀ SQL FILTER, KHÔNG đưa vào description!
-> Sinh Query:
+style — Basic, Dynamic, Feminine, Utility, Smart Casual, Trend, Athleisure, Essential
-   - query: "product_name: Váy liền thân/ Chân váy/ Đầm nữ. gender_by_product: female. age_by_product: adult..."
+fitting — Regular, Slimfit, Relax, Oversize, Skinny, Slim, Boxy, Baby tee
-   (Lưu ý: Phải set age_by_product='adult' và include fallback types)
+form_sleeve — Full length Sleeve, Short Sleeve, Sleeveless
+form_neckline — Crew Neck, Classic Collar, V-neck, Hooded collar, Mock Neck/ High neck
----- HƯỚNG DẪN ĐIỀN CÁC TRƯỜNG THÔNG TIN (FIELD DEFINITIONS) -----
+material_group — Knit - Dệt Kim, Woven - Dệt Thoi, Yarn - Sợi
+season — Fall Winter, Spring Summer, Year
-1. **magento_ref_code** (QUAN TRỌNG NHẤT):
-   - Chỉ điền khi khách cung cấp MÃ SẢN PHẨM cụ thể (VD: 6KS25S005, 8TS24W001).
+═══════════════════════════════════════════════════════════════
-   - **LƯU Ý:** Nếu đã có `magento_ref_code`, hãy để `description` là hoặc mô tả ngắn gọn (VD: "Áo thun"), **TUYỆT ĐỐI KHÔNG** chèn câu "Mã sản phẩm..." vào `description` vì sẽ làm nhiễu kết quả tìm kiếm.
+📝 VÍ DỤ (description_text LUÔN CÓ!)
+═══════════════════════════════════════════════════════════════
-2. **discount_min / discount_max** (LỌC THEO % GIẢM GIÁ):
-   - Đặt giá trị % khi khách hỏi sản phẩm giảm giá với mức cụ thể.
+CASE 1: "Tìm áo đi chơi" (user chỉ nói "áo" — KHÔNG nói loại gì)
-   - VD: "Mã nào giảm 50%" → discount_min: 50, discount_max: 50
+→ description: "product_name: Áo. description_text: Áo đi chơi thoải mái phong cách trẻ trung. style: Casual"
-   - VD: "Sản phẩm sale >= 30%" → discount_min: 30
+→ product_line_vn: "Áo" (RỘNG — match tất cả loại áo)
-   - VD: "Tìm áo giảm từ 50% đến 70%" → discount_min: 50, discount_max: 70
+⚠️ KHÔNG tự đổi thành "Áo phông" hay "Áo Polo" — user đéo nói!
-   - VD: "Đồ sale khoảng 40-60%" → discount_min: 40, discount_max: 60
-   - VD: "Có đồ giảm giá không?" → discount_min: 1 (lấy tất cả sản phẩm đang sale)
+CASE 2: "Tìm áo ngọ nguậy"
-   - Nếu khách KHÔNG hỏi về giảm giá, để `null` hoặc bỏ qua field này.
+→ description: "product_name: Áo ngọ nguậy. description_text: Áo ngọ nguậy thiết kế vui nhộn"
+→ product_line_vn: "Áo"
-2. **description**:
-   - Dùng cho tìm kiếm ngữ nghĩa (Semantic Search).
+CASE 3: "Áo phông nam màu trắng dáng regular" (user NÓI RÕ "áo phông")
-   - Mô tả sản phẩm cần tìm: tên, màu sắc, kiểu dáng, chất liệu, tính năng...
+→ description: "product_name: Áo phông. description_text: Áo phông nam dáng regular thoải mái. fitting: Regular"
-   - Cấu trúc tốt: `product_name: [Tên]. master_color: [Màu]. style: [Style]...`
+→ master_color: "trắng"
+→ gender_by_product: "men", age_by_product: "adult"
-3. **price_min** / **price_max**:
+→ product_line_vn: "Áo phông"
-   - Chỉ điền khi khách nói về khoảng giá (VD: "dưới 500k", "từ 200k đến 1 triệu").
-   - Đơn vị: VNĐ (Ex: 500000).
+CASE 4: "Váy nữ tính cho vợ, dưới 500k"
+→ description: "product_name: Váy. description_text: Váy nữ tính sang trọng thanh lịch. style: Feminine"
-4. **gender_by_product** / **age_by_product**:
+→ gender_by_product: "women", age_by_product: "adult", price_max: 500000
-   - Bắt buộc suy luận từ đối tượng.
+→ product_line_vn: "Váy"
-   - **GIÁ TRỊ HỢP LỆ:**
-     - gender: `women`, `men`, `boy`, `girl`, `unisex`, `newborn`
+CASE 5: "Áo Polo ngắn tay basic cho nam, giảm giá 30-50%"
-     - age: `adult`, `kid`, `others`
+→ description: "product_name: Áo Polo. description_text: Áo Polo nam ngắn tay phong cách basic lịch sự. style: Basic. form_sleeve: Short Sleeve"
-   - VD: "váy cho vợ" → gender=`women`, age=`adult`
+→ gender_by_product: "men", age_by_product: "adult", discount_min: 30, discount_max: 50
+→ product_line_vn: "Áo Polo"
-5. **master_color** (MÀU SẮC - GỬI NGUYÊN VĂN TỪ KHÁCH):
-   - **QUAN TRỌNG:** Gửi CHÍNH XÁC màu khách yêu cầu (VD: "trắng kem", "xanh navy", "nâu chocolate") - KHÔNG tự map!
+CASE 6: "Quần cho bé trai"
-   - Tool sẽ tự động tìm màu gần nhất trong DB và thông báo cho khách nếu không có màu đó.
+→ description: "product_name: Quần. description_text: Quần cho bé trai năng động thoải mái"
-   - **16 MÀU TRONG DB (để tham khảo):** 
+→ gender_by_product: "boy", age_by_product: "kid"
-     - `Đen/ Black`, `Trắng/ White`, `Xanh da trời/ Blue`, `Xám/ Gray`
+→ product_line_vn: "Quần"
-     - `Hồng/ Pink- Magenta`, `Be/ Beige`, `Đỏ/ Red`, `Tím/ Purple`
-     - `Xanh lá cây/ Green`, `Màu xanh Jeans`, `Xanh than/ Aqua`, `Nâu/ Brown`
+CASE 7: "Set đồ công sở cho nữ" → 2 Queries:
-     - `Vàng/ Yellow + Gold`, `Cam/ Orange`
+  1. description: "product_name: Áo. description_text: Áo công sở nữ thanh lịch chuyên nghiệp. style: Smart Casual"
-   - **VÍ DỤ:**
+     gender: "women", age: "adult", product_line_vn: "Áo"
-     - Khách nói "trắng kem" → gửi `"trắng kem"` (KHÔNG gửi "Be/ Beige")
+  2. description: "product_name: Quần. description_text: Quần công sở nữ thanh lịch form đẹp. style: Smart Casual"
-     - Khách nói "hồng" → gửi `"hồng"` (tool sẽ tìm "Hồng/ Pink- Magenta")
+     gender: "women", age: "adult", product_line_vn: "Quần"
-     - Khách nói "xanh navy" → gửi `"xanh navy"` (tool sẽ tìm "Màu xanh Jeans")
-   - **LƯU Ý:** Chỉ điền 1 màu duy nhất từ câu hỏi khách
+CASE 8: "Tìm mã 6KS25S005"
+→ magento_ref_code: "6KS25S005", description: "product_name: Sản phẩm. description_text: Tìm sản phẩm theo mã"
-6. **product_line_vn** (LOẠI SẢN PHẨM - CHỈ DÙNG GIÁ TRỊ DB):
-   - **TOP 20 LOẠI PHỔ BIẾN:**
+CASE 9: "Áo cá sấu polo đi chơi"
-     - `Áo phông`, `Áo Polo`, `Áo Sơ mi`, `Áo len`, `Áo nỉ`, `Áo khoác gió`
+→ description: "product_name: Áo cá sấu polo. description_text: Áo cá sấu polo đi chơi năng động trẻ trung. style: Dynamic"
-     - `Váy liền`, `Chân váy` (KHÔNG có "Váy liền thân"!)
+→ product_line_vn: "Áo Polo"
-     - `Quần soóc`, `Quần jean`, `Quần Khaki`, `Quần dài`, `Quần nỉ`
-     - `Bộ quần áo`, `Bộ mặc nhà`, `Tất`
+CASE 10: "Áo khaki"
-   - **MAPPING:**
+→ description: "product_name: Áo khaki. description_text: Áo chất liệu khaki form đẹp"
-     - "váy", "váy liền thân", "đầm" → `Váy liền`
+→ product_line_vn: "Áo"
-     - "áo polo" → `Áo Polo`
-     - "áo sơ mi" → `Áo Sơ mi`
+═══════════════════════════════════════════════════════════════
-     - "quần jean" → `Quần jean`
+🎉 DỊP LỄ / SỰ KIỆN — description_text ghi lý do + gợi ý phong cách
+═══════════════════════════════════════════════════════════════
-7. **style** (PHONG CÁCH - CHỈ DÙNG NẾU CHÍNH XÁC):
-   - **9 STYLE TRONG DB:**
+Khi user hỏi "mặc gì dịp X" hoặc nhắc tới ngày lễ → description_text MÔ TẢ:
-     - `Basic`, `Dynamic`, `Feminine`, `Utility`, `Smart Casual`, `Basic Update`, `Trend`, `Athleisure`, `Essential`
+1. Dịp đó là gì (1 câu ngắn)
-   - **MAPPING:**
+2. Nên mặc phong cách gì (1 câu)
-     - "basic", "cơ bản", "đơn giản" → `Basic`
-     - "năng động", "sporty", "thể thao" → `Dynamic`
+⚠️ Danh sách dưới chỉ là VÍ DỤ phổ biến. Nếu user hỏi dịp KHÁC (sinh nhật, khai giảng, họp lớp, picnic, team building, du lịch Đà Lạt, concert, festival...) → TỰ SUY LUẬN theo pattern tương tự: mô tả dịp + gợi ý style phù hợp.
-     - "nữ tính" → `Feminine`
-     - "thanh lịch", "sang trọng", "elegant" → `Smart Casual`
+🇻🇳 SỰ KIỆN VIỆT NAM:
-   - **QUAN TRỌNG:** Nếu user nói "váy tiểu thư", "áo sang chảnh" (KHÔNG match DB) → BỎ QUA field này, chỉ điền vào `description`.
+- Tết Nguyên Đán (tháng 1-2 AL) → description_text: "Tết Nguyên Đán lễ hội truyền thống, trang phục lịch sự sang trọng tông đỏ vàng may mắn. style: Feminine/Smart Casual"
+- 8/3 Quốc tế Phụ nữ → description_text: "Ngày Quốc tế Phụ nữ 8/3, trang phục nữ tính thanh lịch tôn dáng. style: Feminine"
-8. **fitting** (DÁNG ĐỒ):
+- 30/4 Giải phóng miền Nam → description_text: "Ngày Giải phóng 30/4 nghỉ lễ dài, trang phục đi chơi thoải mái năng động. style: Dynamic/Casual"
-   - **8 GIÁ TRỊ:** `Regular`, `Slimfit`, `Relax`, `Oversize`, `Skinny`, `Slim`, `Boxy`, `Baby tee`
+- 1/5 Quốc tế Lao động → description_text: "Nghỉ lễ 1/5 đi du lịch picnic, đồ thoải mái năng động dễ di chuyển. style: Athleisure/Dynamic"
-   - **MAPPING:**
+- 1/6 Quốc tế Thiếu nhi → description_text: "Ngày Thiếu nhi 1/6, quần áo trẻ em vui nhộn màu sắc tươi sáng. style: Dynamic" + age: kid
-     - "vừa", "suông" → `Regular`
+- 2/9 Quốc khánh → description_text: "Quốc khánh 2/9 nghỉ lễ, trang phục đi chơi thoải mái tông đỏ vàng tự hào dân tộc. style: Dynamic/Casual"
-     - "ôm", "slim" → `Slimfit`
+- 20/10 Phụ nữ Việt Nam → description_text: "Ngày Phụ nữ Việt Nam 20/10, trang phục nữ tính sang trọng tôn vẻ đẹp phụ nữ. style: Feminine"
-     - "rộng" → `Relax`
+- 20/11 Nhà giáo VN → description_text: "Ngày Nhà giáo 20/11, trang phục lịch sự thanh lịch trang trọng. style: Smart Casual"
-     - "oversize" → `Oversize`
+🌍 SỰ KIỆN QUỐC TẾ:
-9. **form_sleeve** (DÁNG TAY ÁO):
+- 14/2 Valentine → description_text: "Valentine ngày tình nhân, trang phục lãng mạn đẹp đôi hẹn hò. style: Feminine/Smart Casual"
-   - **GIÁ TRỊ:** `Full length Sleeve`, `Short Sleeve`, `Sleeveless`
+- Halloween (31/10) → description_text: "Halloween lễ hội hóa trang, trang phục cá tính độc đáo tông đen cam. style: Trend/Dynamic"
-   - **MAPPING:**
+- Noel/Giáng sinh (25/12) → description_text: "Giáng sinh Noel lễ hội ấm áp, trang phục ấm đẹp tông đỏ xanh trắng. style: Smart Casual. season: Fall Winter"
-     - "dài tay" → `Full length Sleeve`
-     - "ngắn tay", "cộc tay" → `Short Sleeve`
+📋 DỊP CHUNG:
-     - "sát nách", "tank" → `Sleeveless`
+- Đám cưới → description_text: "Đi đám cưới tiệc cưới, trang phục lịch sự sang trọng trang nhã. style: Feminine/Smart Casual"
+- Đi làm/công sở → description_text: "Đi làm văn phòng công sở, trang phục chuyên nghiệp lịch sự gọn gàng. style: Smart Casual"
-10. **Các trường khác (season, material_group, form_neckline):**
+- Đi biển/du lịch → description_text: "Du lịch biển nghỉ mát, trang phục thoáng mát năng động dễ chịu. style: Dynamic. season: Spring Summer"
-    - Chỉ điền nếu khách nhắc cụ thể.
+- Thể thao/gym → description_text: "Tập gym thể thao vận động, trang phục co giãn thoáng khí năng động. style: Athleisure"
-    - season: `Fall Winter`, `Spring Summer`, `Year`
+- Hẹn hò/date → description_text: "Đi hẹn hò date, trang phục đẹp cuốn hút tự tin ấn tượng. style: Feminine/Smart Casual"
-    - material_group: `Knit - Dệt Kim`, `Woven - Dệt Thoi`, `Yarn - Sợi`
+- Tiệc/party → description_text: "Đi tiệc party, trang phục nổi bật sang trọng thời thượng. style: Trend/Feminine"
-    - form_neckline: `Crew Neck`, `Classic Collar`, `V-neck`, `Hooded collar`, `Mock Neck/ High neck`
+VÍ DỤ DỊP LỄ:
+"Mặc gì đi chơi 2/9?" → description: "product_name: Áo. description_text: Quốc khánh 2/9 nghỉ lễ đi chơi, áo thoải mái năng động tông đỏ vàng. style: Dynamic"
+"Váy đi đám cưới" → description: "product_name: Váy. description_text: Váy đi đám cưới sang trọng thanh lịch trang nhã. style: Feminine"
+"Đồ cho bé 1/6" → description: "product_name: Bộ quần áo. description_text: Ngày Thiếu nhi 1/6 quần áo trẻ em vui nhộn tươi sáng. style: Dynamic", age: "kid"
+⚡ SUY LUẬN ĐỐI TƯỢNG:
+- "vợ", "bà xã", "người yêu" → gender: women, age: adult
+- "chồng", "anh ấy" → gender: men, age: adult
+- "con gái", "bé gái" → gender: girl, age: kid
+- "con trai", "bé trai" → gender: boy, age: kid
--- a/backend/agent/tool_prompts/note.txt
+++ b/backend/agent/tool_prompts/note.txt
@@ -73,3 +73,33 @@ age_by_product: adult.
  "TARGET": "...
 2026-02-05 17:09:13,818 [WARNING] agent.controller_helpers: ✅ [user_insight] Extracted + saved in 0.00s | Key: cdcdc3dfef
 ←[32mINFO←[0m:     127.0.0.1:64945 - "←[1mGET /api/agent/user-insight HTTP/1.1←[0m" ←[32m200 OK←[0m
+┌─────────────────────────────────────────────────────────┐
+│  User: "phụ kiện nào hợp với áo này?"                   │
+└───────────────────────┬─────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────────┐
+│  LLM (thông minh): Hiểu "phụ kiện" →                   │
+│  Tự điền product_name = "Khăn/ Mũ/ Túi xách/ Tất"      │
+│  (tách ra từng loại cụ thể thay vì gửi chung "phụ kiện")│
+└───────────────────────┬─────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────────┐
+│  Code split "/":  ["khăn", "mũ", "túi xách", "tất"]    │
+│          ↓                                              │
+│  PRODUCT_TYPE_MAPPING:                                  │
+│    "khăn"     → "Khăn"         (product_line_vn)        │
+│    "mũ"       → "Mũ"          (product_line_vn)        │
+│    "túi xách" → "Túi xách"    (product_line_vn)        │
+│    "tất"      → "Tất"         (product_line_vn)        │
+└───────────────────────┬─────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────────┐
+│  Filter: Chỉ giữ products có product_line_vn           │
+│  == "Khăn" OR "Mũ" OR "Túi xách" OR "Tất"             │
+│                                                         │
+│  ❌ "Áo Cổ Cao Tay Dài" → loại bỏ                      │
+│  ✅ "Khăn" → giữ                                       │
+│  ✅ "Mũ" → giữ                                         │
+└─────────────────────────────────────────────────────────┘
\ No newline at end of file
--- a/backend/agent/tools/data_retrieval_tool.py
+++ b/backend/agent/tools/data_retrieval_tool.py
@@ -11,10 +11,7 @@ import time
 from langchain_core.tools import tool
 from pydantic import BaseModel, Field
-from agent.tools.data_retrieval_filter import (
-    apply_post_filters,
-    infer_product_name_from_description,
-)
 from agent.helper import format_product_results
 from agent.tools.product_search_helpers import build_starrocks_query
 from common.starrocks_connection import get_db_connection
@@ -28,50 +25,71 @@ from agent.prompt_utils import read_tool_prompt
 class SearchItem(BaseModel):
    model_config = {"extra": "forbid"}  # STRICT MODE
+    # ====== SEMANTIC SEARCH ======
    description: str = Field(
-        description="Mô tả sản phẩm cho semantic search. QUY TẮC: Nếu khách hỏi THẲNG TÊN SP (quần jeans, áo polo) → description = product_name (VD: 'Quần jean', 'Áo Polo'). Nếu khách hỏi MÔ TẢ/NHU CẦU (đi dự tiệc, đồ đi biển) → description = HYDE mô tả (VD: 'Váy dự tiệc sang trọng nữ tính')"
+        description=(
-    )
+            "Mô tả sản phẩm cho semantic search. "
-    product_name: str | None = Field(
+            "FORMAT: 'product_name: [tên]. description_text: [mô tả]. "
-        description="CHỈ tên loại sản phẩm cơ bản: Áo, Váy, Quần, Chân váy, Áo khoác... KHÔNG bao gồm style/mô tả."
+            "material_group: [chất liệu]. style: [phong cách]. fitting: [dáng]. "
+            "form_sleeve: [tay]. form_neckline: [cổ]. product_line_vn: [dòng SP]'. "
+            "🚨 product_name = CHÍNH XÁC lời user nói, TUYỆT ĐỐI KHÔNG tự đổi sang tên khác. "
+            "VD: user nói 'áo ngọ nguậy' → product_name: Áo ngọ nguậy (KHÔNG đổi thành 'Áo phông'!). "
+            "VD: user nói 'áo cá sấu' → product_name: Áo cá sấu (KHÔNG đổi!). "
+            "Chỉ chuẩn hóa từ đồng nghĩa RÕ RÀNG: 'áo thun'→'Áo phông', 'quần bò'→'Quần jean'. "
+            "⚠️ KHÔNG đưa master_color vào description — dùng field master_color riêng! "
+            "product_line_vn trong description = broad category (Áo phông, Áo Polo, Quần jean...). "
+            "VD: 'áo ngọ nguậy' → 'product_name: Áo ngọ nguậy. product_line_vn: Áo phông'. "
+            "VD: 'áo cá sấu polo' → 'product_name: Áo cá sấu polo. product_line_vn: Áo Polo'."
        )
-    magento_ref_code: str | None = Field(description="Mã sản phẩm chính xác (SKU)")
-    price_min: int | None = Field(description="Giá thấp nhất (VND)")
-    price_max: int | None = Field(description="Giá cao nhất (VND)")
-    discount_min: int | None = Field(
-        description="% giảm giá tối thiểu. VD: 50 nghĩa là chỉ lấy sản phẩm giảm >= 50%. Nếu khách hỏi sản phẩm giảm giá nhưng không chỉ rõ %, đặt = 1 để lấy tất cả sản phẩm đang sale."
    )
-    discount_max: int | None = Field(
-        description="% giảm giá tối đa. VD: 70 nghĩa là chỉ lấy sản phẩm giảm <= 70%. Dùng kết hợp với discount_min để lọc khoảng % giảm giá."
+    # ====== SKU LOOKUP ======
+    magento_ref_code: str | None = Field(
+        description="Mã sản phẩm chính xác (SKU). Chỉ điền khi khách cung cấp mã cụ thể.",
    )
-    # Metadata filters
+    # ====== SQL HARD FILTERS (lọc trực tiếp trong DB query) ======
    gender_by_product: str | None = Field(
-        description="Giới tính. GIÁ TRỊ HỢP LỆ: women, men, boy, girl, unisex, newborn"
+        description="[SQL FILTER] Giới tính. GIÁ TRỊ HỢP LỆ: women, men, boy, girl, unisex, newborn",
    )
-    age_by_product: str | None = Field(description="Độ tuổi. GIÁ TRỊ HỢP LỆ: adult, kid, others")
+    age_by_product: str | None = Field( 
-    master_color: str | None = Field(
+        description="[SQL FILTER] Độ tuổi. GIÁ TRỊ HỢP LỆ: adult, kid, others",
-        description="Màu sắc chính. 16 MÀU DB: 'Đen/ Black', 'Trắng/ White', 'Xanh da trời/ Blue', 'Xám/ Gray', 'Hồng/ Pink- Magenta', 'Be/ Beige', 'Đỏ/ Red', 'Tím/ Purple', 'Xanh lá cây/ Green', 'Màu xanh Jeans', 'Xanh than/ Aqua', 'Nâu/ Brown', 'Vàng/ Yellow + Gold', 'Cam/ Orange'. CHỈ DÙNG 1 MÀU, KHÔNG ghép (VD: 'Trắng kem' sai → dùng 'Trắng/ White' hoặc 'Be/ Beige')"
    )
-    form_sleeve: str | None = Field(
+    master_color: str | None = Field(
-        description="Dáng tay áo. GIÁ TRỊ DB: 'Full length Sleeve', 'Short Sleeve', 'Sleeveless'. Mapping: 'dài tay'→'Full length Sleeve', 'ngắn tay'→'Short Sleeve', 'sát nách'→'Sleeveless'"
+        description=(
+            "[SQL FILTER] Màu sắc sản phẩm. Gửi CHÍNH XÁC từ khách nói (VD: 'trắng', 'đen', 'xanh', 'đỏ'). "
+            "Tool sẽ tự match trong DB bằng LIKE. KHÔNG đưa màu vào description!"
+        ),
    )
-    style: str | None = Field(
+    price_min: int | None = Field(
-        description="Phong cách. 9 GIÁ TRỊ DB: 'Basic', 'Dynamic', 'Feminine', 'Utility', 'Smart Casual', 'Basic Update', 'Trend', 'Athleisure', 'Essential'. CHỈ điền nếu user nói CHÍNH XÁC (VD: 'basic' → 'Basic'). Nếu user nói 'sang trọng', 'tiểu thư' (KHÔNG match) → BỎ QUA field này, chỉ điền vào description."
+        description="[SQL FILTER] Giá thấp nhất (VND)",
    )
-    fitting: str | None = Field(
+    price_max: int | None = Field(
-        description="Dáng đồ. GIÁ TRỊ DB: 'Regular', 'Slimfit', 'Relax', 'Oversize', 'Skinny', 'Slim', 'Boxy'. Mapping: 'vừa'→'Regular', 'ôm'→'Slimfit', 'rộng'→'Relax'"
+        description="[SQL FILTER] Giá cao nhất (VND)",
    )
-    form_neckline: str | None = Field(
+    discount_min: int | None = Field(
-        description="Dáng cổ áo. GIÁ TRỊ DB: 'Crew Neck', 'Classic Collar', 'V-neck', 'Hooded collar', 'Mock Neck/ High neck'"
+        description="[SQL FILTER] % giảm giá tối thiểu. VD: 50 → chỉ lấy SP giảm >= 50%. Nếu khách hỏi 'đồ sale' chung → đặt = 1.",
    )
-    material_group: str | None = Field(
+    discount_max: int | None = Field(
-        description="Nhóm chất liệu. GIÁ TRỊ DB: 'Knit - Dệt Kim', 'Woven - Dệt Thoi', 'Yarn - Sợi'"
+        description="[SQL FILTER] % giảm giá tối đa. VD: 70 → chỉ lấy SP giảm <= 70%.",
    )
-    season: str | None = Field(description="Mùa. GIÁ TRỊ DB: 'Fall Winter', 'Spring Summer', 'Year'")
-    # Extra fields for SQL match if needed
    product_line_vn: str | None = Field(
-        description="Dòng sản phẩm. TOP DB: 'Áo phông', 'Áo Polo', 'Áo Sơ mi', 'Áo len', 'Váy liền', 'Chân váy', 'Quần jean', 'Quần soóc', 'Quần dài'. LƯU Ý: 'Váy liền' (KHÔNG phải 'Váy liền thân')"
+        description=(
+            "[SQL FILTER] Đại loại sản phẩm — lọc RỘNG bằng prefix. "
+            "Hỗ trợ nhiều giá trị cách bằng '/'. "
+            "GIÁ TRỊ: 'Áo' (mọi loại áo), 'Quần' (mọi loại quần), "
+            "'Váy' (váy liền + chân váy), 'Bộ' (bộ quần áo, bộ mặc nhà), "
+            "'Khăn', 'Mũ', 'Túi', 'Tất', 'Chăn'. "
+            "VD: 'áo khaki' → product_line_vn: 'Áo'. 'quần hoặc váy' → 'Quần/ Váy'"
+        ),
+    )
+    discovery_mode: str | None = Field(
+        description=(
+            "[SQL FILTER] Chế độ khám phá. 'new' = hàng mới (is_new_product=1), "
+            "'best_seller' = bán chạy nhất (ORDER BY quantity_sold). "
+            "Chỉ dùng khi khách NÓI RÕ 'mới nhất'/'hàng mới'/'bán chạy'/'best seller'/'hot'. "
+            "Nếu khách KHÔNG nói → để null."
+        ),
    )
@@ -99,16 +117,6 @@ async def _execute_single_search(
            item.magento_ref_code,
        )
-        # Infer product_name if missing (avoid wrong category results)
-        if not item.product_name:
-            inferred_name = infer_product_name_from_description(item.description)
-            if inferred_name:
-                try:
-                    item = item.model_copy(update={"product_name": inferred_name})
-                except AttributeError:
-                    item = item.copy(update={"product_name": inferred_name})
-                logger.warning("🧭 Inferred product_name='%s' from description", inferred_name)
        # Timer: build query (sử dụng vector đã có hoặc build mới)
        query_build_start = time.time()
        sql, params = await build_starrocks_query(item, query_vector=query_vector)
@@ -140,11 +148,7 @@ async def _execute_single_search(
                first_p.get("sale_price"),
            )
-        # ====== POST-FILTERS: Apply all filter layers via centralized function ======
+        return format_product_results(products), {"fallback_used": False}
-        is_sku_search = bool(item.magento_ref_code)
-        products, filter_info = apply_post_filters(products, item, is_sku_search=is_sku_search)
-        return format_product_results(products), filter_info
    except Exception as e:
        logger.exception("Single search error for item %r: %s", item, e)
        return [], {"fallback_used": False, "error": str(e)}
@@ -182,8 +186,21 @@ async def data_retrieval_tool(searches: list[SearchItem]) -> str:
    # Aggregate filter info from first result for simplicity in response
    final_info = all_filter_infos[0] if all_filter_infos else {}
+    # Include search input so LLM knows its own reasoning
+    search_inputs = [
+        {
+            "description": item.description,
+            "product_line_vn": item.product_line_vn,
+            "gender_by_product": item.gender_by_product,
+            "age_by_product": item.age_by_product,
+            "discovery_mode": item.discovery_mode,
+        }
+        for item in searches
+    ]
    output = {
        "status": "success",
+        "search_input": search_inputs,
        "results": combined_results,
        "filter_info": final_info,
    }

--- a/backend/agent/tools/flow.txt
+++ b/backend/agent/tools/flow.txt
@@ -95,3 +95,17 @@ Step 6: Agent nhận message → báo khách
 │                                                                     │
 │  → Color fallback có thể vì COLOR KHÔNG trong SQL query!           │
 └─────────────────────────────────────────────────────────────────────┘
+Bro ơi, tao đã bỏ sạch product_line_vn khỏi SQL rồi!
+Kiến trúc bây giờ:
+Tầng	Filter	Mục đích
+SQL (product_search_helpers.py)	gender + age ONLY	Giữ HNSW index nguyên vẹn
+Python (data_retrieval_filter.py)	PRODUCT_TYPE_MAPPING → exact match product_line_vn	Lọc đúng loại sản phẩm
+Flow cho "quần đùi bé trai":
+SQL: Vector search "Quần soóc bé trai" → top 100 (HNSW intact ✅)
+SQL: filtered_matches chỉ filter gender=boy, age=kid → ~80 results
+Python: PRODUCT_TYPE_MAPPING["quần soóc"] = "Quần soóc" → exact match product_line_vn ✅
+Nếu 0 match → reject all + message "Shop chưa có..."
+Server đang reload. Test lại đi bro! 🚀
--- a/backend/agent/tools/product_search_helpers.py
+++ b/backend/agent/tools/product_search_helpers.py
@@ -39,41 +39,41 @@ def _get_discount_params(params) -> tuple[int | None, int | None]:
 def _get_metadata_clauses(params, sql_params: list) -> list[str]:
-    """Xây dựng điều kiện lọc từ metadata (Parameterized)."""
+    """
+    HARD FILTER: Gender + Age — lọc trực tiếp ở SQL level.
+    Gender tự động include 'unisex' fallback cho men/women.
+    Color + Product type → semantic search tự handle qua description.
+    """
    clauses = []
-    # 1. Exact Match with Mapping
+    # Gender filter
-    # Chúng ta sử dụng Mapping để chuyển từ Tiếng Việt (LLM) sang Tiếng Anh (DB Column)
-    from agent.tools.data_retrieval_filter import AGE_MAP, GENDER_MAP
-    # Gender Mapping - Include 'unisex' as fallback for men/women
    gender_val = getattr(params, "gender_by_product", None)
    if gender_val:
-        gender_key = gender_val.lower().strip()
+        gender_lower = gender_val.lower().strip()
-        acceptable_genders = GENDER_MAP.get(gender_key, [gender_key])
+        # Include 'unisex' fallback for men/women
+        if gender_lower in ("men", "women"):
-        # ⚡ FALLBACK: Include 'unisex' for 'men' or 'women' searches
+            clauses.append("gender_by_product IN (%s, %s)")
-        # This ensures results even when specific gender products are unavailable
+            sql_params.extend([gender_lower, "unisex"])
-        if gender_key in ["men", "nam", "male", "women", "nữ", "female", "nu"]:
+        else:
-            if "unisex" not in acceptable_genders:
+            clauses.append("gender_by_product = %s")
-                acceptable_genders = list(acceptable_genders) + ["unisex"]
+            sql_params.append(gender_lower)
+        logger.info(f"👫 [SQL FILTER] Gender: {gender_val}")
-        placeholders = ", ".join(["%s"] * len(acceptable_genders))
-        clauses.append(f"gender_by_product IN ({placeholders})")
-        sql_params.extend(acceptable_genders)
-    # Age Mapping
+    # Age filter
    age_val = getattr(params, "age_by_product", None)
    if age_val:
-        age_key = age_val.lower().strip()
+        age_lower = age_val.lower().strip()
-        acceptable_ages = AGE_MAP.get(age_key, [age_key])
+        clauses.append("age_by_product = %s")
-        placeholders = ", ".join(["%s"] * len(acceptable_ages))
+        sql_params.append(age_lower)
-        clauses.append(f"age_by_product IN ({placeholders})")
+        logger.info(f"🎂 [SQL FILTER] Age: {age_val}")
-        sql_params.extend(acceptable_ages)
+    # Color filter (LIKE match on master_color OR product_color_name)
-    # 3. BỎ TẤT CẢ PARTIAL FILTERS - Chỉ dùng Gender/Age làm HARD filter
+    color_val = getattr(params, "master_color", None)
-    # Các field khác (style, fitting, sleeve, product_line...) được xử lý bởi semantic search
+    if color_val:
-    # Color sẽ được filter trong Python với fallback mechanism
+        color_lower = color_val.lower().strip()
+        clauses.append("(LOWER(master_color) LIKE %s OR LOWER(product_color_name) LIKE %s)")
+        sql_params.extend([f"%{color_lower}%", f"%{color_lower}%"])
+        logger.info(f"🎨 [SQL FILTER] Color: {color_val}")
    return clauses
@@ -115,7 +115,69 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
    # ============================================================
-    # CASE 2: HYDE SEARCH - Semantic Vector Search
+    # CASE 2: DISCOVERY — Hàng mới / Bán chạy (Direct SQL, no embedding)
+    # Khác với price/gender filter: discovery cần scan TOÀN BỘ bảng
+    # vì top 100 vector results gần như không chứa new/best_seller
+    # ============================================================
+    discovery_mode = getattr(params, "discovery_mode", None)
+    if discovery_mode:
+        discovery_mode = discovery_mode.lower().strip()
+        sql_params: list = []
+        # Metadata filters (gender + age)
+        where_clauses = _get_metadata_clauses(params, sql_params)
+        # Product line filter
+        product_line = getattr(params, "product_line_vn", None)
+        if product_line:
+            where_clauses.append("LOWER(product_line_vn) LIKE %s")
+            sql_params.append(f"{product_line.lower().strip()}%")
+        # Price filters
+        where_clauses.extend(_get_price_clauses(params, sql_params))
+        # Discovery-specific WHERE + ORDER
+        if discovery_mode == "new":
+            where_clauses.append("is_new_product = 1")
+            order_by = "quantity_sold DESC, magento_ref_code"
+            logger.info("🆕 [DISCOVERY] New products, filters=%s", where_clauses)
+        elif discovery_mode == "best_seller":
+            where_clauses.append("quantity_sold > 0")
+            order_by = "quantity_sold DESC, magento_ref_code"
+            logger.info("🔥 [DISCOVERY] Best sellers, filters=%s", where_clauses)
+        else:
+            discovery_mode = None
+        if discovery_mode:
+            where_str = " AND ".join(where_clauses) if where_clauses else "1=1"
+            sql = f"""
+            SELECT
+                internal_ref_code,
+                magento_ref_code,
+                product_color_code,
+                product_name,
+                master_color,
+                product_image_url_thumbnail,
+                product_web_url,
+                sale_price,
+                original_price,
+                discount_amount,
+                ROUND(((original_price - sale_price) / original_price * 100), 0) as discount_percent,
+                age_by_product,
+                gender_by_product,
+                product_line_vn,
+                quantity_sold
+            FROM shared_source.magento_product_dimension_with_text_embedding
+            WHERE {where_str}
+            ORDER BY {order_by}
+            LIMIT 20
+            """
+            logger.info("⚡ [DISCOVERY] Direct SQL — no embedding")
+            return sql, sql_params
+    # ============================================================
+    # CASE 3: SEMANTIC VECTOR SEARCH
    # ============================================================
    query_text = getattr(params, "description", None)
    if query_text and query_vector is None:
@@ -133,18 +195,28 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
    # 1. Price
    price_clauses = _get_price_clauses(params, sql_params)
-    # 2. Metadata (Gender, Age, etc.)
+    # 2. Metadata: Gender + Age + Color (HARD FILTER — all at SQL level)
    metadata_clauses = _get_metadata_clauses(params, sql_params)
    all_clauses = price_clauses + metadata_clauses
+    # Discovery mode filters
+    discovery_mode = getattr(params, "discovery_mode", None)
+    if discovery_mode:
+        discovery_mode = discovery_mode.lower().strip()
+        if discovery_mode == "new":
+            all_clauses.append("is_new_product = 1")
+            logger.info("🆕 [SQL FILTER] Discovery: new products only")
+        elif discovery_mode == "best_seller":
+            all_clauses.append("quantity_sold > 0")
+            logger.info("🔥 [SQL FILTER] Discovery: best sellers")
    # Get discount params
    discount_min, discount_max = _get_discount_params(params)
    post_filter_conditions = []
-    # Price filters
+    # Price + Gender + Age filters
    if all_clauses:
        post_filter_conditions.extend(all_clauses)
@@ -162,6 +234,14 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
    if post_filter_conditions:
        post_filter_where = " WHERE " + " AND ".join(post_filter_conditions)
+    # Determine sort order: best_seller uses quantity_sold, otherwise similarity_score
+    if discovery_mode == "best_seller":
+        final_order = "ORDER BY max_sold DESC, max_score DESC"
+        extra_agg = ",\n        MAX(quantity_sold) as max_sold"
+    else:
+        final_order = "ORDER BY max_score DESC"
+        extra_agg = ""
    sql = f"""
    WITH vector_matches AS (
        SELECT /*+ SET_VAR(ann_params='{{"ef_search":128}}') */
@@ -181,10 +261,12 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
            product_line_vn,
            product_line_en,
            description_text_full,
+            quantity_sold,
+            is_new_product,
            approx_cosine_similarity(vector, {v_str}) as similarity_score
        FROM shared_source.magento_product_dimension_with_text_embedding
        ORDER BY similarity_score DESC
-        LIMIT 500
+        LIMIT 100
    ),
    filtered_matches AS (
        SELECT * FROM vector_matches
@@ -205,30 +287,34 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
        MAX_BY(discount_amount, similarity_score) as discount_amount,
        MAX_BY(discount_percent, similarity_score) as discount_percent,
        MAX_BY(description_text_full, similarity_score) as description_text_full,
-        MAX(similarity_score) as max_score
+        MAX_BY(gender_by_product, similarity_score) as gender_by_product,
+        MAX_BY(age_by_product, similarity_score) as age_by_product,
+        MAX_BY(product_line_vn, similarity_score) as product_line_vn,
+        MAX_BY(quantity_sold, similarity_score) as quantity_sold,
+        MAX(similarity_score) as max_score{extra_agg}
    FROM filtered_matches
    GROUP BY product_color_code, internal_ref_code
-    ORDER BY max_score DESC
+    {final_order}
-    LIMIT 80
+    LIMIT 70
    """
-    # Write to query.txt for debugging - Build FULL executable query
+    try:
-    # try:
+        query_log_path = os.path.join(os.path.dirname(__file__), "query.txt")
-    #     query_log_path = os.path.join(os.path.dirname(__file__), "query.txt")
+        # Build executable query by substituting %s with actual values
-    #     # Build executable query by substituting %s with actual values
+        executable_sql = sql
-    #     executable_sql = sql
+        for param in sql_params:
-    #     for param in sql_params:
+            if isinstance(param, str):
-    #         if isinstance(param, str):
+                # Escape single quotes and wrap in quotes
-    #             # Escape single quotes and wrap in quotes
+                escaped = param.replace("'", "''")
-    #             escaped = param.replace("'", "''")
+                executable_sql = executable_sql.replace("%s", f"'{escaped}'", 1)
-    #             executable_sql = executable_sql.replace("%s", f"'{escaped}'", 1)
+            else:
-    #         else:
+                executable_sql = executable_sql.replace("%s", str(param), 1)
-    #             executable_sql = executable_sql.replace("%s", str(param), 1)
+        with open(query_log_path, "w", encoding="utf-8") as f:
-    #     with open(query_log_path, "w", encoding="utf-8") as f:
+            f.write(f"-- [HYDE SEARCH] Full Executable Query\n-- Original Params: {sql_params}\n{executable_sql}")
-    #         f.write(f"-- [HYDE SEARCH] Full Executable Query\n-- Original Params: {sql_params}\n{executable_sql}")
+    except Exception as e:
-    # except Exception as e:
+        logger.error(f"Error writing to query.txt: {e}")
-    #     logger.error(f"Error writing to query.txt: {e}")
    return sql, sql_params
--- a/backend/common/canifa_api.py
+++ b/backend/common/canifa_api.py
@@ -3,6 +3,8 @@ Canifa API Service
 Xử lý các logic liên quan đến API của Canifa (Magento)
 """
+import hashlib
+import json
 import logging
 from typing import Any
@@ -10,11 +12,11 @@ import httpx
 logger = logging.getLogger(__name__)
-# CANIFA_CUSTOMER_API = "https://vsf2.canifa.com/v1/magento/customer"
 CANIFA_CUSTOMER_API = "https://canifa.com/v1/magento/customer"
+# ⚡ Auth Token Cache: TTL 1 tiếng — tránh gọi canifa.com mỗi request
+AUTH_CACHE_TTL = 3600  # 1 hour
+AUTH_CACHE_PREFIX = "auth_token:"
 _http_client: httpx.AsyncClient | None = None
@@ -42,10 +44,48 @@ CANIFA_QUERY_BODY = [
    {},
 ]
+async def _get_cached_auth(token: str) -> dict | None:
+    """Check Redis cache for verified token."""
+    try:
+        from common.cache import redis_cache
+        client = redis_cache.get_client()
+        if not client:
+            return None
+        token_hash = hashlib.md5(token.encode()).hexdigest()
+        key = f"{AUTH_CACHE_PREFIX}{token_hash}"
+        cached = await client.get(key)
+        if cached:
+            logger.info("⚡ Auth token cache HIT — skipping Canifa API call")
+            return json.loads(cached)
+    except Exception as e:
+        logger.warning(f"Auth cache read error: {e}")
+    return None
+async def _set_cached_auth(token: str, data: dict) -> None:
+    """Store verified token result in Redis."""
+    try:
+        from common.cache import redis_cache
+        client = redis_cache.get_client()
+        if not client:
+            return
+        token_hash = hashlib.md5(token.encode()).hexdigest()
+        key = f"{AUTH_CACHE_PREFIX}{token_hash}"
+        await client.setex(key, AUTH_CACHE_TTL, json.dumps(data, ensure_ascii=False))
+        logger.info(f"💾 Auth token cached (TTL: {AUTH_CACHE_TTL}s)")
+    except Exception as e:
+        logger.warning(f"Auth cache write error: {e}")
 async def verify_canifa_token(token: str) -> dict[str, Any] | None:
    """
-    Verify token với API Canifa (Magento).
+    Verify token với API Canifa (Magento) — có Redis cache.
-    Dùng token làm cookie `vsf-customer` để gọi API lấy thông tin customer.
+    Lần đầu gọi API (~200-500ms), các lần sau hit cache (~2ms).
    Args:
        token: Giá trị của cookie vsf-customer (lấy từ Header Authorization)
@@ -56,6 +96,12 @@ async def verify_canifa_token(token: str) -> dict[str, Any] | None:
    if not token:
        return None
+    # ⚡ Check cache first
+    cached_data = await _get_cached_auth(token)
+    if cached_data is not None:
+        return cached_data
+    # Cache miss → call Canifa API
    headers = {
        "accept": "application/json, text/plain, */*",
        "content-type": "application/json",
@@ -70,12 +116,11 @@ async def verify_canifa_token(token: str) -> dict[str, Any] | None:
            data = response.json()
            logger.debug(f"Canifa API Raw Response: {data}")
-            # Response format: {"data": {"customer": {...}}, "loading": false, ...}
            if isinstance(data, dict):
-                # Trả về toàn bộ data để extract_user_id xử lý
+                # ⚡ Cache successful auth result
+                await _set_cached_auth(token, data)
                return data
-            # Nếu Canifa trả list (batch request)
            return data
        logger.warning(f"Canifa API Failed: {response.status_code} - {response.text}")

--- a/backend/server.py
+++ b/backend/server.py
@@ -5,7 +5,7 @@ import platform
 import uvicorn
 from fastapi import FastAPI
-from fastapi.responses import RedirectResponse
+from fastapi.responses import FileResponse, JSONResponse, RedirectResponse
 from fastapi.staticfiles import StaticFiles
 from api.chatbot_route import router as chatbot_router
@@ -32,6 +32,12 @@ logging.basicConfig(
 logger = logging.getLogger(__name__)
+# Static files directory
+STATIC_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "static")
+if not os.path.exists(STATIC_DIR):
+    os.makedirs(STATIC_DIR)
+print(f"✅ Static dir resolved: {STATIC_DIR}")
 app = FastAPI(
    title="Contract AI Service",
@@ -47,6 +53,30 @@ async def startup_event():
    logger.info("✅ Redis cache initialized")
+@app.get("/")
+async def root():
+    return RedirectResponse(url="/static/index.html")
+@app.get("/health")
+async def health():
+    return JSONResponse({"status": "ok"})
+@app.get("/static/{file_path:path}")
+async def serve_static(file_path: str):
+    """Serve static files explicitly to avoid middleware conflict."""
+    if not file_path:
+        file_path = "index.html"
+    full_path = os.path.join(STATIC_DIR, file_path)
+    if os.path.isfile(full_path):
+        return FileResponse(full_path)
+    return JSONResponse({"detail": "Not Found"}, status_code=404)
+# =====================================================================
+# MIDDLEWARE (after static mount)
+# =====================================================================
 middleware_manager.setup(
    app,
    enable_auth=True,
@@ -66,21 +96,6 @@ app.include_router(mock_router)
 app.include_router(stock_router)
-try:
-    static_dir = os.path.join(os.path.dirname(__file__), "static")
-    if not os.path.exists(static_dir):
-        os.makedirs(static_dir)
-    app.mount("/static", StaticFiles(directory=static_dir, html=True), name="static")
-    print(f"✅ Static files mounted at /static (Dir: {static_dir})")
-except Exception as e:
-    print(f"⚠️ Failed to mount static files: {e}")
-@app.get("/")
-async def root():
-    return RedirectResponse(url="/static/index.html")
 if __name__ == "__main__":
    print("=" * 60)
    print("🚀 Contract AI Service Starting...")