Quản lý Trạng thái Tem
Menu: Nhãn & QR → Quản lý trạng thái tem
Route:/stamp-management
Quyền yêu cầu:qr.view
Phiên bản: v1.0 — 2026-05-08
1. Giới thiệu
Trang Quản lý trạng thái tem là trung tâm giám sát vòng đời của tất cả tem QR đã phát hành. Theo dõi trạng thái từ khi tạo, in ấn, phân phối, kích hoạt, đến hết hạn hoặc thu hồi.
2. Điều kiện truy cập
| Điều kiện | Chi tiết |
|---|---|
| Quyền | qr.view |
| Trạng thái tổ chức | Đã duyệt |
3. Giao diện
3.1 Quick Lookup — Tra cứu nhanh
Thanh tra cứu nhanh cho phép nhập mã tem để kiểm tra trạng thái ngay lập tức.
3.2 Thẻ tổng quan — 5 thẻ tổng quan
| Thẻ | Icon | Mô tả |
|---|---|---|
| 🔵 Tổng tem | ri-qr-code-line |
Tổng số tem QR trên tất cả đợt |
| 🟢 Đã kích hoạt | ri-shield-check-line |
Tem đã quét lần đầu bởi người tiêu dùng |
| 🔷 Đã phân phối | ri-truck-line |
Tem đã rời nhà máy/kho |
| 🟡 Hết hạn | ri-timer-line |
Tem đã quá hạn sử dụng |
| 🔴 Thu hồi | ri-close-circle-line |
Tem bị thu hồi do lỗi/gian lận |
3.3 Progress Bar — Thanh tổng quan trạng thái
Thanh tiến độ đa màu hiển thị tỷ lệ phần trăm từng trạng thái trên tổng số tem.
3.4 Tabs chức năng — 7 tab
| Tab | Icon | Mô tả |
|---|---|---|
| Theo đợt mã | 📊 | Tổng quan theo đợt: số tem, tỷ lệ kích hoạt/phân phối |
| Danh sách tem riêng lẻ | ✅ | Bảng chi tiết từng tem, lọc theo đợt/QRT/trạng thái |
| Lịch sử quét nội bộ | 🕐 | Log các lần quét bởi nhân viên nội bộ (qua app mobile) |
| Tem có vấn đề | ⚠️ | Tem bất thường: quét quá nhiều, vị trí đáng ngờ |
| Xu hướng | 📈 | Biểu đồ xu hướng tạo/kích hoạt/thu hồi theo thời gian |
| Phiên quét | 🕑 | Chi tiết các phiên quét nội bộ (batch scan sessions) |
| Thống kê | 📊 | Biểu đồ thống kê quét tổng hợp |
4. Hướng dẫn thao tác
4.1 Tra cứu nhanh
- Nhập mã tem vào ô Quick Lookup trên cùng
- Hệ thống hiển thị thông tin trạng thái và lịch sử tem
4.2 Xem lịch sử tem
- Chuyển sang tab "Danh sách tem riêng lẻ"
- Lọc theo đợt mã hoặc QRT
- Nhấn nút "Lịch sử" bên cạnh tem → hộp thoại hiển thị timeline quét
4.3 Thu hồi tem
- Từ tab "Danh sách tem" hoặc "Tem có vấn đề"
- Nhấn nút "Thu hồi" bên cạnh tem
- hộp thoại xác nhận → Nhập lý do → Nhấn "Xác nhận thu hồi"
[!WARNING]
Thu hồi tem là hành động không thể hoàn tác. Tem bị thu hồi sẽ không quét được nữa.
4.4 Phát hiện bất thường
- Chuyển sang tab "Tem có vấn đề"
- Hệ thống tự động phát hiện tem bất thường (quét quá nhiều, vị trí lạ)
- Xem lịch sử hoặc thu hồi nếu cần
5. Trạng thái tem
| Mã | Trạng thái | Màu | Mô tả |
|---|---|---|---|
| 0 | Đã tạo (Created) | Xám | Tem vừa được gen, chưa in |
| 1 | Đã in | Xám nhạt | Tem đã in ra nhãn vật lý |
| 2 | Đã phân phối | Xanh dương | Tem đã rời nhà máy |
| 3 | Đã kích hoạt (Activated) | Xanh lá | Người tiêu dùng đã quét lần đầu |
| 4 | Hết hạn (Expired) | Vàng | Quá hạn sử dụng |
| 99 | Thu hồi | Đỏ | Tem bị thu hồi |
6. FAQ
| Câu hỏi | Trả lời |
|---|---|
| Biểu đồ xu hướng trống? | Cần có dữ liệu quét tối thiểu để hiển thị biểu đồ. |
| "Phiên quét" là gì? | Là 1 batch scan session — nhân viên quét nhiều tem liên tục bằng app mobile. |
| Tem "có vấn đề" cần xử lý không? | Nên kiểm tra. Có thể do quét thử nội bộ hoặc thực sự bị giả mạo. |
Cập nhật lần cuối: 2026-05-08