# Tổng quan (Overview)

Module **Product Performance & Stock Cache** đóng vai trò là "bộ não" cung cấp dữ liệu thời gian thực về tình hình kinh doanh, tồn kho và danh mục sản phẩm của hệ thống Canifa.

## Mục tiêu thiết kế
- **Tra cứu Hiệu năng (Product Performance):** Khai thác sức mạnh của database OLAP **StarRocks** để truy vấn các chỉ số kinh doanh như `quantity_sold`, `sale_price`, `discount_percent` trên quy mô hàng triệu bản ghi với độ trễ cực thấp (< 50ms).
- **Tra cứu Tồn kho Real-time (Stock Check):** Kết hợp khả năng mở rộng SKU thông minh từ StarRocks và kỹ thuật gửi request song song (Parallel Async Fetching) tới hệ thống ERP/Middleware của Canifa (`CANIFA_STOCK_API`). Giải quyết bài toán tra cứu hàng nghìn SKU cùng lúc mà không gây nghẽn mạng hay dính timeout.

## Vai trò trong hệ sinh thái
- **Cung cấp dữ liệu cho N8N Agent:** `/api/agent/n8n/stock`, giúp agent có thể trả lời khách hàng nhanh chóng về tồn kho của một sản phẩm.
- **Cung cấp dữ liệu cho Chatbot/Frontend:** Hiển thị Dashboard Product Performance (`/api/products/overview`, `/api/products/list`) và Lead Popup (`/api/product/lookup`).
