Hướng dẫn Xem Hành trình Sản phẩm & Cảnh báo Gian lận

Đối tượng: Business Admin (Web + Mobile)
Route Web: /product-journey
Route Mobile: /product-journey?type={qr1|qrt|lot}&id={GUID}
Cập nhật: 2026-04-21

1. Hành trình sản phẩm là gì?

Hành trình sản phẩm là tính năng cho phép theo dõi toàn bộ quá trình từ khi xuất xưởng đến khi sản phẩm được quét/kích hoạt bởi người tiêu dùng, bao gồm:

• Timeline: Dòng thời gian các sự kiện (quét QR1, quét QR2, kích hoạt, thay đổi trạng thái)
• Bản đồ: Vị trí quét trên bản đồ OpenStreetMap
• Cảnh báo gian lận: Phát hiện hành vi bất thường (quét đa tỉnh, quét dồn dập, di chuyển bất khả thi)

2. Truy cập (Web Admin)

Cách 1: Từ thanh bên

• An ninh → Hành trình sản phẩm (/product-journey)
• Giao diện tìm kiếm: nhập mã tem / RawData / tên sản phẩm → chọn kết quả

Cách 2: Deep-link từ các trang khác

3. Chế độ hiển thị

3.1. QR1 — Tem đơn lẻ

Xem hành trình 1 tem cụ thể với đầy đủ chi tiết.

Thẻ tổng quan (4 thẻ KPI):

Timeline (dòng thời gian dọc):

• Mỗi sự kiện hiển thị: thời gian, loại event, mô tả, severity dot
• Severity dot màu theo mức độ nghiêm trọng
• Có thể lọc theo loại event và mức độ

Bản đồ (Leaflet/OSM):

• Marker tại vị trí quét
• Polyline nối theo thứ tự thời gian
• Marker màu theo severity: xanh, cam, đỏ
• Hoạt động marker có hiệu ứng pulse animation
• Nhấn marker → popup: loại event, mô tả, thời gian, địa điểm

Bộ lọc:

• Lọc theo loại sự kiện (thẻ lọc chọn)
• Lọc theo mức độ nghiêm trọng
• Lọc theo khoảng thời gian

thanh bên thông tin sản phẩm:

• Tên SP, mã batch, trạng thái tem

3.2. QRT / Lot — Nhóm tem

Xem tổng hợp nhiều tem theo QRT hoặc Lô sản xuất.

Status Distribution: Bar chart phân bổ trạng thái

Stamp Table: Danh sách tem với:

• Tổng số lần quét
• Lần quét cuối
• Số cảnh báo

Drill-down: Nhấn vào tem → navigate đến journey chi tiết (?type=qr1)

4. Mức độ nghiêm trọng (Severity Levels)

5. Cảnh báo gian lận (Fraud Rules)

Hệ thống tự động phát hiện các hành vi bất thường:

6. Hành trình sản phẩm trên Mobile

App Manager (checkpromanager)

Chức năng đầy đủ:

• Timeline + Thẻ tổng quan + Lọc
• Entry point: Nút "Xem hành trình" trên mỗi tem trong Stamp Management

Cách sử dụng:

1. Vào Quản lý tem → chọn 1 tem
2. Nhấn nút "Xem hành trình" (icon bản đồ)
3. Xem thẻ tổng quan + timeline
4. Dùng lọc chips để lọc theo loại sự kiện hoặc mức độ

App Customer (checkprocustomer)

Chức năng đơn giản:

• Timeline read-only, không có lọc
• Summary strip: Tổng quét, vị trí, cảnh báo

Cách sử dụng:

1. Quét mã QR sản phẩm
2. Trên trang kết quả, nhấn "Xem hành trình sản phẩm"
3. Xem timeline với severity dots

Lưu ý: Nút "Xem hành trình sản phẩm" chỉ hiện khi có resolvedQr1Id (tem đã được xác định).

7. Dữ liệu vị trí thu thập

Mỗi lần quét QR, hệ thống thu thập (nếu người dùng cho phép GPS):

Trạng thái thu thập GPS theo nền tảng

8. Tính năng nâng cao (Roadmap)