Phân tích & Thống kê
Menu: Tổng quan → Phân tích & Thống kê
Route:/dashboard-analytics
Quyền yêu cầu:analytics.view
Phiên bản: v1.0 — 2026-05-08
1. Giới thiệu
Trang Phân tích & Thống kê cung cấp dữ liệu chi tiết hơn Tổng quan chính. Hỗ trợ lọc theo khoảng thời gian linh hoạt (7/14/30/60/90 ngày) và trực quan hóa 5 nhóm dữ liệu: KPI, xu hướng quét, khu vực, trạng thái tem, và cảnh báo gian lận.
2. Giao diện
2.1 Bộ lọc — danh sách thả xuống + Làm mới
- danh sách thả xuống khoảng thời gian: 7 / 14 / 30 / 60 / 90 ngày
- Nút Làm mới — Tải lại dữ liệu
- Chờ org context (
useActiveOrg) trước khi gọi API
2.2 KPI Cards — 4 Cards
| Card | Metric | Subtitle |
|---|---|---|
| 🔵 Tổng tem QR1 | totalQr1Codes |
X đang hoạt động |
| 🟢 Tổng tem QR2 | totalQr2Codes |
X% đã kích hoạt |
| 🔷 Tổng lượt quét | totalScans |
X người quét duy nhất |
| 🔴 Cảnh báo gian lận | openFraudAlerts |
Đang chờ / Đã xử lý |
2.3 Xu hướng quét — Stacked Bar Chart (CSS)
- Biểu đồ cột CSS thuần (không ApexCharts)
- Mỗi cột = 1 ngày, chia 2 phần: QR1 (xanh) + QR2 (xanh lá)
- chú thích: ngày, QR1, QR2, Kích hoạt
- Legend + date range axis
2.4 Top khu vực quét — Progress Bars
Danh sách vùng + thanh progress, sắp theo lượt quét giảm dần
2.5 Phân bổ trạng thái tem — Stacked Color Bar + Legend
- Thanh ngang multi-color (mỗi status 1 màu)
- Danh sách: Status + Count + %
2.6 Cảnh báo theo mức độ — Bảng Severity
| Cột | Mô tả |
|---|---|
| Mức độ | huy hiệu: Critical/High/Medium/Low |
| Đang mở | Số cảnh báo chưa xử lý |
| Đã xử lý | Số đã đã xử lý |
2.7 Hoạt động quét gần đây — Bảng chi tiết
Cột: #, Thời gian, Mã tem, Loại QR (huy hiệu), Khu vực, IP, Sản phẩm
3. FAQ
| Câu hỏi | Trả lời |
|---|---|
| Khác Tổng quan chính? | Analytics có lọc khoảng thời gian linh hoạt hơn (7/14/30/60/90 ngày) và hiển thị phân bổ mức độ nghiêm trọng của cảnh báo gian lận (Fraud Severity). |
| Org context? | Trang chờ useActiveOrg load xong mới gọi API, tránh lỗi 400. |
| "Người quét duy nhất" tính như thế nào? | Hệ thống đếm số địa chỉ IP khác nhau đã thực hiện quét trong khoảng thời gian được lọc. Nếu cùng một người dùng quét bằng Wi-Fi rồi chuyển sang 4G (2 IP khác nhau), hệ thống sẽ đếm là 2 người quét duy nhất. |
| "Tỷ lệ kích hoạt" thấp có phải là dấu hiệu xấu? | Không hẳn. Tỷ lệ kích hoạt thấp có thể do sản phẩm mới phân phối chưa đến tay người mua, đại lý đang lưu kho, hoặc người tiêu dùng chưa cào lớp phủ để quét QR2. Nếu tỷ lệ thấp kéo dài sau 1-2 tháng, doanh nghiệp nên đánh giá lại kênh phân phối. |
| Tần suất cập nhật dữ liệu? | Dữ liệu được cập nhật theo thời gian thực. Khi người tiêu dùng quét mã, số liệu sẽ cập nhật ngay khi bạn nhấn nút Làm mới hoặc tải lại trang. |
Cập nhật lần cuối: 2026-06-15