Sản phẩm & Dịch vụ (Catalog)

Trang Sản phẩm & Dịch vụ (/app/products) quản lý catalog sản phẩm của shop — đây là nguồn dữ liệu chuẩn giúp AI Agent tra cứu giá, kiểm tra tồn kho, gợi ý sản phẩm cho khách và hỗ trợ tạo đơn hàng tự động.

2 Tab chức năng chính

Tab	Label UI	Mục đích
1	Danh sách Sản phẩm	Xem, tìm kiếm, lọc, kéo-thả sắp xếp và chỉnh sửa thông tin từng sản phẩm.
2	Import Excel/CSV	Tải lên danh sách sản phẩm hàng loạt từ file Excel/CSV để AI tự động trích xuất.

---

Phân loại & Trạng thái Tồn kho trong Catalog

Mỗi sản phẩm hiển thị các chip trạng thái trực quan:

1. Phân loại loại hình sản phẩm (requires_shipping)

• Sản phẩm vật lý (products.type_physical): Cần giao hàng, tính phí ship.
• Sản phẩm số / Dịch vụ (products.type_digital): Dịch vụ, vé, khóa học, không cần vận chuyển.

2. Trạng thái Tồn kho (getStockState)

• Vô hạn (products.stock_unlimited): Khi không bật theo dõi tồn kho (stock_tracking_enabled = false).
• Hết hàng (products.stock_out): Khi số lượng tồn kho qty <= 0 (Chip đỏ danger).
• Sắp hết hàng (products.stock_low): Khi số lượng tồn qty <= low_stock_threshold (Chip vàng warning).
• Còn hàng: Khi số lượng tồn kho an toàn (Chip xanh success).

---

Tạo & Chỉnh sửa Sản phẩm (Modal Form)

Khi bấm + Tạo sản phẩm hoặc nút ✏️ sửa, modal được chia làm 5 phần cấu hình:

1. Thông tin cơ bản

• Tên sản phẩm * (name): Tên hiển thị khi báo giá và tạo đơn.
• Mã sản phẩm / SKU (sku): Mã quản lý kho (vd SP001).
• Đơn vị tính (unit): Đơn vị như cái, hộp, bộ, kg…
• Mô tả AI sử dụng (description): Tóm tắt tính năng, công dụng, chất liệu. AI sẽ đọc trường này để tư vấn khi khách hỏi chi tiết.

2. Giá & Phân loại

• Đơn giá (price): Giá bán sản phẩm (VND / USD).
• Loại hình: Checkbox Yêu cầu giao hàng (Sản phẩm vật lý) để xác định có cần tạo vận đơn khi chốt đơn hay không.

3. Quản lý kho hàng

• Toggle Bật theo dõi tồn kho (stockTrackingEnabled).
• Số lượng tồn kho (stockQuantity): Số lượng khả dụng.
• Ngưỡng cảnh báo tồn thấp (lowStockThreshold): Cảnh báo khi tồn kho chạm ngưỡng (mặc định: 5).

4. Hình ảnh sản phẩm

• Tải lên tối đa 10 ảnh (định dạng JPG, PNG, WebP; dung lượng tối đa 5MB/ảnh).
• Ảnh đầu tiên tự động đặt làm Ảnh chính (badge Chính) — AI sẽ ưu tiên dùng URL ảnh này khi gửi cho khách qua tool image_sending.

5. Thứ tự & Trạng thái kinh doanh

• Thứ tự hiển thị (sortOrder): Quyết định vị trí ưu tiên khi hiển thị cho AI tra cứu.
• Toggle Đang bán / Đang ẩn (isActive): Tắt kinh doanh để ẩn sản phẩm khỏi AI và form tạo đơn.

---

Quy trình Import Excel/CSV tự động qua AI

Để nhập hàng trăm sản phẩm cùng lúc mà không cần nhập tay:

flowchart LR
  UP[❶ Upload File<br/>.xlsx / .csv] --> PARSE[❷ AI Parse dữ liệu<br/>Trích xuất cột]
  PARSE --> REV[❸ Modal Review<br/>Kiểm tra & Sửa dòng]
  REV -->|Duyệt ✅| SAVE[Lưu vào Catalog]

1. Chuyển sang tab Import Excel/CSV.
2. Kéo-thả hoặc chọn file dữ liệu (.xlsx, .xls, .csv — dung lượng tối đa 10MB).
3. Hệ thống xử lý theo các trạng thái:
   • uploaded: Đã tải tệp lên.
   • parsing: AI đang đọc và phân tích các cột dữ liệu.
   • pending_review: Chờ bạn duyệt lại.
4. Bấm Xem & Duyệt → Modal review danh sách sản phẩm trích xuất từ file.
5. Kiểm tra, sửa nhanh thông tin từng hàng nếu cần → Bấm Duyệt & thêm tất cả (hoặc Từ chối).

---

Kéo-thả sắp xếp vị trí (Drag-and-Drop)

Trong tab Danh sách sản phẩm:

• Mỗi hàng có icon tay cầm ⠿ ở đầu.
• Nhấp và kéo-thả hàng lên/xuống để thay đổi thứ tự ưu tiên hiển thị (sortOrder).
• Hệ thống tự động lưu thứ tự mới ngay sau khi thả.

Bước tiếp theo

• Đơn hàng — Chọn sản phẩm từ catalog khi tạo đơn thủ công.
• Thư viện Media & Brand Kit — Quản lý hình ảnh thương hiệu.
• AI gửi ảnh trong chat — Cú pháp [IMAGE:url].