Hướng dẫn Duyệt & Quản lý Sản phẩm (Master Admin)

Đối tượng: Master Admin (SuperAdmin)
Route: /products (mastercheckprovn)
Cập nhật: 2026-04-21

1. Tổng quan

Master Admin có quyền giám sát và kiểm soát toàn bộ sản phẩm trên hệ thống, bao gồm:

• Xem danh sách sản phẩm cross-org (tất cả tổ chức)
• Phê duyệt hoặc Từ chối sản phẩm chờ duyệt
• Khóa sản phẩm vi phạm
• Mở khóa sản phẩm đã khóa
• Cấu hình Tự động duyệt (system + per-org)
• Quản lý Loại sản phẩm (CRUD ProductTypes)

2. Truy cập

1. Đăng nhập vào trang Master Admin (mastercheckprovn)
2. Từ thanh bên → Sản phẩm → Quản lý sản phẩm (/products)

3. Giao diện trang Quản lý sản phẩm

3.1. Thẻ thống kê (Stats Cards)

Hiển thị 6 thẻ đếm sản phẩm theo trạng thái:

3.2. Bộ lọc

Tabs phía trên bảng: Tất cả | Chờ duyệt | Hoạt động | Bản nháp | Từ chối | Ngừng KD | Bị khóa

3.3. Bảng sản phẩm

Mỗi sản phẩm hiển thị: Tên SP, Tổ chức, Danh mục, SKU, Trạng thái, Ngày tạo, Thao tác

4. Phê duyệt sản phẩm

Khi nào cần duyệt?

Khi Business Admin chọn trạng thái "Hoạt động" cho sản phẩm và cấu hình Tự động duyệt đang TẮT, sản phẩm tự động chuyển sang "Chờ duyệt".

Cách duyệt

1. Chuyển tab "Chờ duyệt" để lọc danh sách
2. Nhấn vào sản phẩm để xem chi tiết (hoặc nhấn icon 👁)
3. Kiểm tra thông tin sản phẩm
4. Chọn hành động:

Ghi chú khi duyệt

• Khi Phê duyệt, có thể nhập ghi chú tùy chọn (optional)
• Khi Từ chối, bắt buộc nhập lý do → lý do hiển thị cho Business Admin trên trang Sửa sản phẩm
• Business Admin có thể sửa thông tin rồi gửi lại duyệt (chọn "Hoạt động" lần nữa)

5. Khóa sản phẩm

Mục đích

Khóa sản phẩm vi phạm quy định hoặc có vấn đề nghiêm trọng. Sản phẩm bị khóa:

• ❌ Không hiển thị công khai (showcase chỉ query Hoạt động)
• ❌ Business Admin không thể chỉnh sửa (backend trả lỗi ERR_LOCKED)
• ❌ Không thể tạo lô/đợt tem mới
• ✅ Chỉ Master Admin mới có thể mở khóa

Cách khóa

1. Trên dòng sản phẩm, nhấn nút 🔒 Khóa
2. hộp thoại hiện ra → bắt buộc nhập lý do khóa
3. Nhấn "Xác nhận"
4. Sản phẩm chuyển sang trạng thái Bị khóa
5. Business Admin nhận notification 🔒 kèm lý do

Lưu ý: Có thể khóa sản phẩm ở bất kỳ trạng thái nào (trừ đã Bị khóa).

Cách mở khóa

1. Chuyển tab "Bị khóa" để lọc
2. Trên dòng sản phẩm, nhấn nút 🔓 Mở khóa
3. Sản phẩm chuyển sang trạng thái Không hoạt động
4. Business Admin nhận notification 🔓
5. Business Admin tự kích hoạt lại sản phẩm nếu muốn

6. Cấu hình Tự động duyệt

Hệ thống hỗ trợ 2 cấp cấu hình auto-approve:

Cấp 1: System Default (toàn hệ thống)

1. Vào Cài đặt hệ thống → Cấu hình sản phẩm (/system-settings)
2. công tắc "Tự động duyệt sản phẩm":
   • BẬT: Mọi sản phẩm chọn "Hoạt động" → Hoạt động ngay (trừ org có override)
   • TẮT: Mọi sản phẩm chọn "Hoạt động" → Chờ duyệt (trừ org có override)

Cấp 2: Per-Org Override (theo tổ chức)

Đặt chính sách riêng cho từng tổ chức, ghi đè system default:

1. Vào Quản lý tổ chức → Chi tiết tổ chức
2. Set Auto-approve per-org:
   • null (mặc định): Theo system default
   • true: Luôn tự động duyệt cho tổ chức này (dù system tắt)
   • false: Luôn yêu cầu duyệt cho tổ chức này (dù system bật)

Thứ tự ưu tiên

Per-Org Override (nếu có) → System Default → Chờ duyệt

7. Quản lý Loại sản phẩm

Truy cập

thanh bên → Quản lý loại sản phẩm (/product-types)

Chức năng

Loại hệ thống (không thể xóa)

Lưu ý: Loại sản phẩm tùy chỉnh có ID từ 4 trở lên (smallint, tự tăng).

8. Notification cho Business Admin

Khi quản trị hệ thống thực hiện một hành động, tài khoản doanh nghiệp nhận được thông báo theo thời gian thực:

Nhấn vào thông báo để mở trang chi tiết sản phẩm.