Hướng dẫn sử dụng
← Quay lại Product
← Quay lại Product Performance

# 📖 Hướng dẫn sử dụng — Product Performance

Trang quản lý và phân tích toàn bộ catalog sản phẩm Canifa — dành cho team BA, Product & Marketing

## 🎯 1. Mục đích tính năng

Trang Product Performance cung cấp cái nhìn tổng quan về toàn bộ catalog sản phẩm Canifa, giúp team:

- Nắm bắt nhanh tổng sản phẩm, dòng SP, giá trung bình, sản phẩm giảm giá, sản phẩm mới, tổng đã bán
- Tìm kiếm & lọc sản phẩm theo tên, mã SP, giới tính, dòng sản phẩm
- Phân tích chi tiết từng sản phẩm: thông tin, giá, tồn kho thực tế (real-time)
- Hỗ trợ quyết định về nhập hàng, khuyến mãi, chiến lược sản phẩm

💡 Dữ liệu từ đâu? Trang này lấy dữ liệu từ StarRocks Data Lake (bảng `magento_product_dimension`), được đồng bộ từ hệ thống Magento của Canifa. Tồn kho được check real-time qua API Canifa.

## ⚡ 2. Các tính năng chính

📊
KPI Dashboard
6 chỉ số tổng quan: Tổng SP, Dòng SP, Giá TB, Đang giảm giá, Hàng mới, Tổng đã bán. Cập nhật ngay khi load trang.
🔍
Tìm kiếm thông minh
Tìm theo tên sản phẩm, mã nội bộ hoặc mã magento. Tự động debounce 300ms — gõ đến đâu, lọc đến đó.
🏷️
Lọc theo tiêu chí
Lọc theo giới tính (Nam/Nữ/Bé trai/Bé gái/Unisex), dòng sản phẩm (Áo phông, Quần jean, Váy...), sắp xếp theo tên/giá/bán chạy.
📦
Check tồn kho Real-time
Bấm vào sản phẩm bất kỳ để xem tồn kho thực tế từ API Canifa — chi tiết theo size, màu, cửa hàng.
📱
Responsive
Giao diện tự thích ứng trên desktop, tablet, mobile. Sidebar có thể thu gọn để xem nhiều hơn.
🔗
Link trực tiếp
Mỗi sản phẩm có link trực tiếp đến trang canifa.com — tiện cho team kiểm tra nhanh.

## 📝 3. Hướng dẫn sử dụng

### Bước cơ bản

- Truy cập trang: Vào `Product Perf.` từ sidebar hoặc truy cập trực tiếp `/static/product.html`
- Xem KPI tổng quan: 6 chỉ số ở đầu trang hiện ngay khi load. Bấm 🔄 Refresh để cập nhật lại.
- Tìm sản phẩm: Gõ tên/mã SP vào ô tìm kiếm. Kết quả hiện ngay khi gõ.
- Lọc & Sắp xếp: Dùng dropdown "Giới tính", "Dòng SP", "Sắp xếp" để thu hep kết quả.
- Xem chi tiết: Bấm vào sản phẩm → xem thông tin chi tiết + check tồn kho real-time.
- Load thêm: Cuộn xuống cuối danh sách, bấm "Load More" để xem thêm sản phẩm.

## 📊 4. Giải thích KPI

#### SP trong Catalog

Tổng số sản phẩm (đếm theo mã magento_ref_code, mỗi màu = 1 SP riêng). VD: Áo polo trắng và áo polo đen cùng kiểu = 2 SP.

#### Dòng sản phẩm

Số lượng dòng SP khác nhau (VD: Áo phông, Quần short, Váy liền, Áo khoác...). Giúp nắm độ đa dạng catalog.

#### Giá trung bình

Giá bán trung bình (sale_price) của toàn bộ catalog. Sub-text hiển thị giá gốc trung bình để so sánh mức giảm.

#### Đang giảm giá

Số SP có discount_amount > 0 (đang được markdown). Sub-text hiện % trên tổng catalog.

#### Hàng mới

Số SP có flag is_new_product = 1. Thường là SP mới nhập trong mùa hiện tại.

#### Tổng đã bán

Tổng quantity_sold của toàn bộ catalog. Con số này tích lũy, không phải theo ngày/tháng.

## 🔍 5. Bộ lọc & Tìm kiếm

#### Tìm kiếm

Tìm theo: tên sản phẩm (VD: "áo polo"), mã nội bộ (VD: "8TP25A005"), hoặc mã magento (VD: "8TP25A005-SW011"). Không phân biệt hoa thường. Tự động debounce 300ms.

#### Lọc giới tính

Tất cả / Nam (men) / Nữ (women) / Bé trai (boy) / Bé gái (girl) / Unisex. Dữ liệu theo trường `gender_by_product`.

#### Lọc dòng SP

Dropdown tự động load tất cả dòng SP có trong catalog: Áo phông, Quần short, Chân váy, Đầm/Váy, Áo khoác, v.v.

#### Sắp xếp

Mặc định: Bán chạy nhất. Các tùy chọn: Tên A→Z / Z→A, Giá thấp→cao / Cao→thấp, Bán chạy nhất, Giảm giá nhiều nhất.

## 📦 6. Kiểm tra tồn kho

Khi bấm vào 1 sản phẩm, hệ thống sẽ gọi API Canifa real-time để check tồn kho:

- Còn hàng — Hiển thị danh sách size còn hàng, số lượng mỗi size
- Hết hàng — Hiển thị thông báo "Hết hàng" với label đỏ
- Đang load — Spinner hiện trong khi chờ API trả về

⚠️ Lưu ý: Tồn kho được check real-time nên có thể mất 1-3 giây. Dữ liệu tồn kho phản ánh số lượng tại thời điểm check, không phải lúc load trang.

## 💡 7. Mẹo sử dụng

- So sánh nhanh: Dùng bộ lọc "Giảm giá nhiều nhất" để tìm SP đang markdown mạnh → kiểm tra tồn kho → quyết định push marketing.
- Check hàng mới: Sắp xếp theo "Bán chạy nhất" + lọc giới tính → nhanh chóng biết SP mới nào đang hot.
- Tìm gap catalog: Lọc theo dòng SP → so sánh số lượng giữa các dòng → phát hiện dòng nào cần bổ sung.
- Refresh thường xuyên: Bấm 🔄 Refresh trước khi ra quyết định quan trọng để đảm bảo dữ liệu mới nhất.

## ❓ 8. Câu hỏi thường gặp

#### Q: Dữ liệu cập nhật bao lâu 1 lần?

Dữ liệu catalog được đồng bộ từ Magento → StarRocks hàng ngày. Tồn kho được check real-time khi bấm vào sản phẩm.

#### Q: Tại sao "Tổng đã bán" không khớp với báo cáo kinh doanh?

Con số này lấy từ trường `quantity_sold` trong catalog, chỉ dùng để tham khảo mức độ phổ biến. Để so sánh doanh số chính xác, dùng báo cáo từ hệ thống ERP.

#### Q: Sao tìm không ra sản phẩm?

Thử tìm theo mã nội bộ (VD: "8TP25A005") thay vì tên. Hoặc bỏ bớt bộ lọc giới tính/dòng SP đang chọn.

#### Q: Trang load chậm?

Trang mặc định load 50 SP/lần. Nếu vẫn chậm, kiểm tra kết nối mạng nội bộ đến StarRocks (172.16.2.100:9030).