# Core Logic: Product Performance (StarRocks)

Toàn bộ logic tính toán hiệu năng (số lượng bán, giá bán, độ phủ màu sắc) được thực hiện trên bảng `shared_source.magento_product_dimension_with_text_embedding` lưu trữ trong **StarRocks**.

## Smart Relevance Ranking
Một điểm nổi bật trong API `/api/products/list` là khả năng tự động hiểu các từ đồng nghĩa (ví dụ: "áo thun" → "Áo phông") dựa vào từ điển mapping `SYNONYM_TO_DB`.

Ngoài ra, hệ thống tự động xây dựng một `relevance_score` qua truy vấn SQL `CASE` (nếu user có dùng thanh search) để xếp hạng sản phẩm:

```sql
MAX(
    CASE
        WHEN UPPER(internal_ref_code) = 'AO THUN' THEN 100
        WHEN UPPER(internal_ref_code) LIKE 'AO THUN%' THEN 90
        WHEN LOWER(product_name) = 'áo thun' THEN 85
        WHEN LOWER(product_name) LIKE 'áo thun%' THEN 70
        WHEN LOWER(product_name) LIKE '%áo thun%' THEN 50
        WHEN LOWER(product_line_vn) = 'áo thun' THEN 40
        ELSE 30
    END
) AS relevance_score
```

Sản phẩm được `ORDER BY relevance_score DESC, quantity_sold DESC`.

## Grouping bằng ANY_VALUE
Do bảng lưu mức độ hạt mịn đến từng SKU/Màu, để tổng hợp lên cấp độ sản phẩm cha (`internal_ref_code`), API sử dụng hàm `ANY_VALUE()` và `GROUP_CONCAT()` đặc trưng của StarRocks:
```sql
SELECT
    internal_ref_code,
    ANY_VALUE(product_name) AS product_name,
    MAX(quantity_sold) AS quantity_sold,
    COUNT(DISTINCT product_color_code) AS color_count,
    GROUP_CONCAT(DISTINCT master_color) AS colors
FROM magento_product_dimension_with_text_embedding
GROUP BY internal_ref_code
```
