Hướng dẫn Chỉnh Sửa Sản Phẩm (Web Admin)
Đối tượng: Business Admin
Route:/products/{id}/edit
Cập nhật: 2026-04-21
1. Truy cập trang Chỉnh sửa
Cách 1: Từ danh sách sản phẩm
- Vào Sản phẩm → Danh sách sản phẩm (
/products/list) - Tìm sản phẩm cần sửa
- Nhấn nút "Sửa" (icon bút chì) hoặc nhấn vào tên sản phẩm
Cách 2: Từ trang chi tiết sản phẩm
- Vào
/products/{id}/detail - Nhấn nút "Chỉnh sửa"
Cách 3: Sau khi tạo sản phẩm mới
- Hệ thống tự động chuyển đến trang Sửa sau khi lưu thành công
2. Giao diện chỉnh sửa
Trang chỉnh sửa có giao diện tương tự trang thêm sản phẩm (6 tabs), với các điểm khác biệt:
Khác biệt so với trang Thêm
| Tính năng | Trang Thêm | Trang Sửa |
|---|---|---|
| Trạng thái | Chỉ: Bản nháp, Hoạt động, Ngừng hoạt động | Hiển thị thêm: Chờ duyệt, Bị từ chối, Bị khóa (nếu có) |
| Mẫu mã DEFAULT | Tạo inline | Chỉnh sửa qua section riêng |
| Phiên bản r1.0 | Tạo inline | Quản lý qua trang Mẫu mã |
| Ảnh sản phẩm | Tải lên mới | Xem + thêm + xóa ảnh hiện có |
| Nút quản lý | Không có | Có nút: Mẫu mã, Lô sản xuất, Đợt tem |
3. Chỉnh sửa thông tin
3.1. Cập nhật thông tin cơ bản (Tab 1-6)
Tất cả các trường giống như khi thêm sản phẩm. Thay đổi trường nào, nhập giá trị mới rồi nhấn "Lưu".
3.2. Thay đổi trạng thái
Từ danh sách thả xuống trạng thái (Tab 1, thanh bên phải):
| Hành động | Trạng thái mới | Kết quả |
|---|---|---|
| Bản nháp → Hoạt động | Hoạt động (hoặc Chờ duyệt) | Sản phẩm công khai (nếu auto-approve bật) hoặc chờ duyệt |
| Hoạt động → Ngừng hoạt động | Ngừng kinh doanh | Sản phẩm ẩn khỏi trang quét |
| Ngừng hoạt động → Hoạt động | Hoạt động | Sản phẩm hiển thị lại |
| Bị từ chối → Hoạt động | Hoạt động (hoặc Chờ duyệt) | Gửi lại yêu cầu duyệt |
Trạng thái đặc biệt (chỉ xem, không tự chuyển):
| Trạng thái | Giao diện | Hành động |
|---|---|---|
| Chờ duyệt | Ẩn danh sách thả xuống, hiện thông báo "Sản phẩm đang chờ Master Admin duyệt" | Chờ hoặc liên hệ admin |
| Bị từ chối | Hiện lý do từ chối + cho phép chọn lại "Hoạt động" | Sửa thông tin → chọn Hoạt động |
| Bị khóa | Hiện thông báo "Sản phẩm đã bị khóa" + lý do | Không thể chỉnh sửa. Liên hệ Master Admin |
3.3. Quản lý ảnh (Tab 2)
Thêm ảnh mới:
- Chuyển sang Tab 2
- Kéo thả hoặc nhấn khu vực tải lên
- Nhấn "Lưu" để tải lên
Xóa ảnh:
- Rê chuột lên ảnh cần xóa
- Nhấn nút ❌
- Xác nhận xóa
Đổi ảnh đại diện:
- Nhấn vào ảnh muốn đặt làm primary
- Ảnh được chọn sẽ có viền highlight
Ảnh theo mẫu mã:
- Ảnh với viền xanh lá (
border-success) = thuộc mẫu mã cụ thể - Ảnh không viền = ảnh chung sản phẩm
- Nếu sản phẩm có nhiều mẫu mã, ảnh được nhóm theo variant với nút lọc
4. Điều hướng đến các chức năng liên quan
Từ trang chỉnh sửa, có thể truy cập nhanh:
| Nút | Đường dẫn | Chức năng |
|---|---|---|
| Mẫu mã | /products/{id}/variants |
Quản lý mẫu mã + phiên bản |
| Lô sản xuất | /products/{id}/lots |
Quản lý lô sản xuất |
| Chi tiết | /products/{id}/detail |
Xem chi tiết sản phẩm |
| Đợt tem | /identifierqr/list?productId={id} |
Quản lý đợt mã QR |
5. Lưu thay đổi
- Nhấn nút "Lưu" (góc phải trên)
- Hệ thống cập nhật thông tin sản phẩm
- Tải lên ảnh mới (nếu có)
- Hiển thị thông báo thành công
⚠️ Quan trọng: Nếu sản phẩm đang bị Khóa, backend sẽ trả lỗi
ERR_LOCKEDvà không cho phép chỉnh sửa bất kỳ thông tin nào.
6. Xóa sản phẩm
Xóa một sản phẩm
- Từ danh sách sản phẩm, nhấn menu ⋯ trên card sản phẩm
- Chọn "Xóa"
- Xác nhận trong hộp thoại
Xóa nhiều sản phẩm (Bulk Xóa)
- Tick ô tích bên cạnh các sản phẩm muốn xóa
- Nhấn nút "Xóa đã chọn" ở thanh công cụ
- Xác nhận xóa
Lưu ý: Xóa sản phẩm là soft xóa (đánh dấu xóa, không xóa vĩnh viễn khỏi database). Sản phẩm đã xóa không hiển thị trong danh sách nhưng dữ liệu vẫn tồn tại.
7. Câu hỏi thường gặp
Q: Tại sao tôi không sửa được trường "Thương hiệu"?
A: Thương hiệu được tự động gán bằng tên tổ chức. Backend override giá trị này, không cho phép client thay đổi.
Q: Sản phẩm đang "Chờ duyệt", tôi có sửa được không?
A: Có — bạn vẫn sửa được thông tin sản phẩm. Nhưng nếu chọn "Hoạt động" lại, hệ thống sẽ gửi lại yêu cầu duyệt.
Q: Sản phẩm bị khóa, phải làm sao?
A: Liên hệ Master Admin để mở khóa. Sau khi mở khóa, sản phẩm trở về trạng thái "Không hoạt động" — bạn tự kích hoạt lại.
Q: Ảnh tải lên bị lỗi nhưng sản phẩm đã tạo thành công?
A: Sản phẩm và ảnh là 2 bước riêng biệt. Vào lại trang chỉnh sửa → Tab Hình ảnh → tải lên lại ảnh bị lỗi.