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).