Insight Catalog

Quick Reference

• Who: Tất cả vai trò
• Where: Menu trái → Insight Catalog (/insights)
• Time: ~2-5 phút per insight
• Prerequisites: Đã đăng nhập

Prerequisites

• [ ] Đã đăng nhập hệ thống

Step-by-Step Guide

Step 1: Duyệt Catalog

1. Click Insight Catalog trên sidebar
2. Hệ thống hiện grid các insights có sẵn (12+ insights)

Phân loại Insights:

Series	Seller Type	Ví dụ
O-series (Omisell)	Đa kênh	Doanh số, so sánh sàn, top sản phẩm, lợi nhuận
B-series (Boxme)	Fulfillment	Fulfillment, vận chuyển, tồn kho, hoàn trả
X-series (Cross)	Cả hai	KPI tổng hợp, xu hướng mùa

Step 2: Tìm kiếm Insight

1. Nhập keyword vào ô tìm kiếm (VD: "doanh thu", "inventory")
2. Kết quả filter realtime theo tên và mô tả
3. Hoặc filter theo category (revenue, fulfillment, shipping, inventory...)

Step 3: Xem Chi tiết Insight

1. Click vào insight card
2. Trang detail hiện:

Thông tin	Mô tả
Tên & Mô tả	Giải thích insight làm gì
Khi nào dùng	Gợi ý tình huống sử dụng
Kết quả mong đợi	Output mà insight mang lại
Tags	Nhãn phân loại
Rating	Đánh giá trung bình từ users
Granularities	Các mức thời gian hỗ trợ

Step 4: Cấu hình & Execute

1. Chọn Granularity (day, week, month, quarter, year)

2. Chọn filters (nếu có):

   Filter	Loại	Ví dụ
   End Date	date	2026-04-14
   Country	string (enum)	VN, TH, ID
   Sort By	string	revenue, orders
   Sort Order	select	asc / desc
   Limit	number	10, 50, 100

3. Click Execute để chạy insight

Step 5: Xem Kết quả

Kết quả hiện dưới form:

• Biểu đồ — auto-detect type từ chart_hint
• Bảng dữ liệu — phân trang, sortable
• Alerts — cảnh báo nếu dữ liệu bất thường
• Thời gian thực thi — hiện ở footer

Step 6: Export Dữ liệu

1. Trên bảng dữ liệu, click Export
2. Chọn format: CSV hoặc Excel
3. File tải xuống tự động

Step 7: Đánh giá Insight

1. Click sao (1-5) để đánh giá chất lượng insight
2. Thêm comment (tùy chọn)
3. Rating giúp team ưu tiên cải thiện insights

Danh sách Insights Có sẵn

Code	Tên	Category	Seller Type
O1-01	Tổng quan doanh số đa kênh	revenue	Omisell
O1-03	So sánh doanh thu theo sàn	revenue	Omisell
O1-05	Top sản phẩm bán chạy	product	Omisell
O2-01	Phân tích lợi nhuận gộp	finance	Omisell
B1-01	Tổng quan fulfillment	fulfillment	Boxme
B2-01	Phân tích vận chuyển theo carrier	shipping	Boxme
B3-01	Tổng quan tồn kho	inventory	Boxme
B4-01	Phân tích hoàn trả	returns	Boxme
X1-01	Báo cáo tổng hợp vận hành	operations	Cross
X1-02	Phân tích thời gian xử lý đơn	operations	Cross
X2-01	KPI Dashboard	kpi	Cross
X2-02	Phân tích xu hướng theo mùa	trends	Cross

Source: (src/app/core/demo/mock-insights.ts:1-194)

Expected Results

• Insight execute trong 0.5-2 giây
• Biểu đồ auto-render đúng type (line cho trend, bar cho compare, pie cho distribution)
• Export CSV/Excel giữ đầy đủ dữ liệu

Troubleshooting

Không thấy insight nào

Cause: API chưa load hoặc seller_type không match.

Solution:

1. Refresh trang
2. Kiểm tra seller_type của account (Boxme only → chỉ thấy B-series)

Execute trả lỗi

Cause: Filter không hợp lệ hoặc backend error.

Solution:

1. Kiểm tra lại filter values
2. Thử với granularity khác
3. Thử bỏ filter → execute default

Related

• AI Chat — Hỏi AI về insight
• Dashboards — Pin insight vào dashboard
• Thông báo — Subscribe insight tự động
• API: POST /api/v1/insights/:code/execute — Xem API