Hành trình Sản phẩm

Menu: An ninh & Giám sát → Hành trình sản phẩm
Route: /product-journey
Quyền yêu cầu: analytics.view, qr.view
Phiên bản: v1.0 — 2026-05-08

1. Giới thiệu

Trang Hành trình sản phẩm hiển thị toàn bộ timeline cuộc đời của một tem QR — từ lúc tạo, in, phân phối, quét bởi người tiêu dùng, đến khi hết hạn hoặc thu hồi. Hỗ trợ tra cứu theo 3 chiều: QR1 (từng tem), QRT (nhóm tem), và Lô sản xuất.

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

3. Giao diện

3.1 Trang chờ (Landing) — Khi chưa nhập ID

Hiển thị Tìm kiếm Panel cho phép nhập:

3.2 Chế độ Chi tiết (Xem QR1)

a) Thanh thông tin sản phẩm:

b) 4 Thẻ tổng quan:

c) Bộ lọc sự kiện:

d) Layout 2 cột:

3.3 Chế độ Tổng hợp (QRT / Xem theo lô)

Hiển thị bằng component JourneyAggregateView:

• Thống kê gộp cho toàn bộ nhóm/lô
• Biểu đồ phân bố sự kiện
• Danh sách tem con với link đến chi tiết

4. Hướng dẫn thao tác

4.1 Tra cứu hành trình tem

1. Truy cập /product-journey
2. Tại Tìm kiếm Panel, chọn "Theo QR1"
3. Nhập QR1 ID → Nhấn "Tra cứu"
4. Xem timeline sự kiện + bản đồ vị trí

4.2 Tra cứu hành trình nhóm (QRT)

1. Chọn "Theo QRT" → Nhập QRT ID
2. Hiển thị xem tổng hợp: thống kê quét, phân bố, cảnh báo

4.3 Tra cứu hành trình lô

1. Chọn "Theo Lô" → Nhập Lot ID
2. Hiển thị xem tổng hợp cho toàn bộ lô

4.4 Lọc sự kiện

1. Sử dụng bộ lọc phía trên timeline
2. Chọn loại sự kiện, mức độ, khoảng thời gian
3. Timeline tự động cập nhật — huy hiệu hiển thị "Đang lọc (X tổng)"

4.5 Tương tác Timeline ↔ Map

1. Nhấn sự kiện trên timeline → Marker tương ứng highlight trên bản đồ
2. Nhấn marker trên bản đồ → Sự kiện tương ứng highlight trên timeline
3. Nhấn lại để bỏ chọn

5. Nhận biết dấu hiệu bất thường & Phân loại mức độ

Hệ thống tự động phân tích timeline sự kiện của tem để phát hiện các hành vi bất thường. Mỗi sự kiện trên timeline được gán mức độ nghiêm trọng và phân biệt bằng mã màu:

5.1. Mã màu mức độ nghiêm trọng

• 🟢 Bình thường: Các sự kiện hợp lệ (Tạo tem, in ấn, phân phối, quét QR1 đầu tiên hoặc kích hoạt QR2).
• 🔵 Thông tin (info): Quét lại QR2 (sau khi đã kích hoạt). Có thể do khách hàng quét lại để xem thông tin bảo hành.
• 🟡 Cảnh báo: Lượt quét phát sinh từ tỉnh/thành phố khác so với địa điểm quét gần nhất trước đó.
• 🔴 Nguy hiểm: Phát hiện dấu hiệu gian lận rõ ràng:
  • Mã QR2 bị quét lại quá 5 lần.
  • Tem được quét từ 3 tỉnh/thành phố khác nhau trở lên.
  • Tốc độ di chuyển bất khả thi: 2 lượt quét cách nhau >200km trong khoảng thời gian không đủ để di chuyển bằng phương tiện thông thường.

5.2. Kết nối tự động với Phát hiện gian lận

Các sự kiện mức độ 🔴 Nguy hiểm sẽ tự động kích hoạt tạo cảnh báo gian lận trong hệ thống:

• Lượt quét đa tỉnh → Cảnh báo FR-01.
• Quét lại QR2 nhiều lần → Cảnh báo FR-02.
• Di chuyển bất khả thi → Cảnh báo FR-07.

6. Các tình huống thực tế áp dụng

6.1. Xử lý khiếu nại khách hàng

Khi khách hàng báo quét mã QR2 nhận được thông báo "Mã đã kích hoạt trước đó":

1. Vào /product-journey, chọn Theo QR1, nhập ID tem.
2. Kiểm tra sự kiện Kích hoạt QR2 (★): xem thời gian và vị trí (kinh độ, vĩ độ, tên tỉnh).
3. Đối chiếu với thông tin của khách hàng. Nếu thời gian kích hoạt là từ tuần trước tại tỉnh khác → tem đã bị sao chép hoặc bị đại lý tự cào kích hoạt trước.

6.2. Kiểm soát chuỗi cung ứng (Audit phân phối)

1. Chọn tra cứu Theo Lô hoặc Theo QRT.
2. Xem phân bổ địa lý các lượt quét trên Bản đồ hành trình: kiểm tra xem sản phẩm của lô hàng phân phối cho miền Nam có xuất hiện lượt quét tại miền Bắc hay không (phát hiện bán lấn vùng).

7. Điều hướng nhanh từ các trang khác

Khi xảy ra lỗi, trang hiển thị 3 nút điều hướng nhanh:

• Quản lý tem → /stamp-management
• Cảnh báo gian lận → /fraud-alerts
• Báo cáo nghi vấn → /consumer-reports

8. Lưu ý

[!NOTE]

• Bản đồ sử dụng Leaflet (lazy-load, không SSR) — có thể mất 1-2 giây để render.
• Hệ thống sử dụng sequence guard để tránh dữ liệu cũ ghi đè dữ liệu mới khi tra cứu liên tục.
• Không phải lượt quét nào cũng hiển thị trên bản đồ. Nếu người tiêu dùng từ chối chia sẻ vị trí (GPS), hệ thống chỉ ghi nhận IP và hiển thị nhãn địa danh gần đúng chứ không có tọa độ để chấm marker lên bản đồ.

9. FAQ

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