# 6. Troubleshooting & Gotchas

Khi làm việc với Fashion Stylist Engine, kỹ sư thường gặp các case sau:

## 1. Không tìm thấy Matches cho một sản phẩm (Empty Rules)
- **Nguyên nhân:** Bảng `chatbot_fashion_rules` chưa có luật định nghĩa cho `anchor_category` (Ví dụ: Dòng sản phẩm mới ra mắt).
- **Khắc phục:** Engine sẽ có cơ chế log warning `No DB rules for X, falling back to full compute`. Cần truy cập tool nội bộ (hoặc SQL) thêm cấu hình rule (Ví dụ: `Áo Nỉ` -> `Quần Jean`). Hoặc sử dụng fallback SQL classification (`compute_super_classifications_sql`).

## 2. Lỗi Trộn Lẫn Đồ Trẻ Em và Người Lớn
- **Nguyên nhân:** Data từ PIM/Magento đôi lúc điền thiếu `age_by_product`.
- **Khắc phục:** Phương thức `_pass_hard_filter` đã bọc thêm logic quét Text trong `name`. Mọi tên có chứa "kid", "bé", "bé trai", "bé gái" đều bị bắt lại. Luôn cẩn thận với trường hợp này!

## 3. Lỗi Quá tải Batch Processing
- **Nguyên nhân:** Trigger `/api/fashion-matches/batch` gọi loop hàng chục ngàn sản phẩm có thể gây lag DB nếu kết nối Postgres/SQLite không đủ pool.
- **Khắc phục:** Engine sử dụng trạng thái global `BATCH_STATE` để chặn các request batch chồng chéo (Return HTTP 409). Nên chạy batch vào giờ thấp điểm (ban đêm).

## 4. Thiếu Tag dữ liệu NLP (Tags Data Missing)
- Đôi lúc Data không có `occasion_tags` hay `material_tags`. Engine được thiết kế "fail-gracefully" bằng cách cấp điểm Neutral (Ví dụ material mặc định được 5đ) để không loại bỏ oan sản phẩm. Hãy dùng API `/api/fashion-matches/audit/tag-coverage` để kiểm tra độ phủ data.