Quản lý Mẫu mã

Menu: Sản phẩm → Quản lý mẫu mã
Route: /products/variants
Quyền yêu cầu: products.view
Phiên bản: v1.0 — 2026-05-08

1. Giới thiệu

Trang hiển thị hệ thống phân cấp Sản phẩm → Mẫu mã → Bản sửa đổi dưới dạng Dạng cây.

2. Điều kiện truy cập

3. Cấu trúc phân cấp

Giao diện cây phân cấp tổ chức dữ liệu theo mô hình cha - con chặt chẽ nhằm quản lý lịch sử sản phẩm tối ưu:

📦 Sản phẩm (Product) 
 └── 🏷️ Mẫu mã (Variant)
      └── 📋 Phiên bản/Bản sửa đổi (Revision)

• Sản phẩm (Product): Định nghĩa đối tượng sản phẩm chung (ví dụ: Gạo ST25 Hữu Cơ).
• Mẫu mã (Variant): Các quy cách đóng gói hoặc mẫu mã thương mại khác nhau (ví dụ: Túi 5kg, Hộp quà Tết 2kg). Mỗi sản phẩm có ít nhất 1 mẫu mã mặc định (DEFAULT).
• Phiên bản (Revision): Lưu trữ công thức, bao bì tại từng thời điểm. Mỗi mẫu mã có ít nhất 1 bản sửa đổi (r1.0). Chỉ phiên bản ở trạng thái "Đã đăng" mới có thể sử dụng khi tạo đợt mã QR.

4. Giao diện & Thao tác

4.1 Cây sản phẩm — Mẫu mã — Phiên bản

Truy cập vào menu Sản phẩm → Quản lý mẫu mã (hoặc đường dẫn /products/variants):

• Tìm kiếm nhanh: Nhập tên sản phẩm ở thanh tìm kiếm phía trên để lọc nhanh cây phân cấp.
• Mở rộng nhánh: Nhấp vào biểu tượng mũi tên ▶ bên cạnh Sản phẩm hoặc Mẫu mã để tải động (lazy-load) các cấp con tương ứng.

Hình 6.1 — Giao diện cây phân cấp Sản phẩm - Mẫu mã - Phiên bản

4.2 Quản lý danh sách mẫu mã

Khi bạn nhấp vào biểu tượng cấu hình bên cạnh tên sản phẩm trên cây phân cấp, hệ thống sẽ đưa bạn đến trang quản lý danh sách mẫu mã chi tiết:

Hình 6.2 — Giao diện quản lý danh sách mẫu mã của sản phẩm

Tại đây bạn có thể:

• Xem thông tin mẫu mã: Mã mẫu mã, Tên, mã SKU, Giá bán, số phiên bản (Revisions).
• Đặt mẫu mã mặc định: Nhấp nút ngôi sao để đổi mẫu mã mặc định hiển thị chính cho sản phẩm.
• Kích hoạt/Tạm ngưng: Nhấp vào huy hiệu trạng thái của mẫu mã để bật hoặc tắt hoạt động.

4.3 Thêm mẫu mã mới

1. Tại trang danh sách mẫu mã, nhấn nút "Thêm mẫu mã".
2. Biểu mẫu modal hiện ra, điền đầy đủ các thông tin:
   • Mã mẫu (Bắt buộc): Mã duy nhất, viết HOA không dấu, không khoảng trắng (Ví dụ: ST25-GIFT-2K).
   • Tên mẫu: Tên hiển thị chi tiết (Ví dụ: Hộp Quà Tết 2kg).
   • Giá (VNĐ): Giá bán thương mại dành riêng cho mẫu mã này.
   • Trọng lượng (g): Khối lượng tịnh của mẫu mã.
   • SKU: Mã quản lý kho nội bộ.
   • Thuộc tính mở rộng: Các thông số bổ sung dạng Key-Value (ví dụ: Màu sắc: Đỏ, Chất liệu: Carton cao cấp).
3. Nhấn "Tạo mẫu mã" để hoàn tất.

Hình 6.3 — Biểu mẫu thêm mẫu mã mới cho sản phẩm

Cập nhật lần cuối: 2026-06-18