Bắt đầu nhanh — CheckPro Web Admin

Phiên bản: v1.0 — 2026-05-08
Đối tượng: Tất cả người dùng mới

1. Giới thiệu

CheckPro Web Admin là cổng quản trị trực tuyến dành cho doanh nghiệp trên nền tảng CheckProVN — hệ thống truy xuất nguồn gốc hàng hóa dựa trên mã QR bảo mật kép (QR1 công khai + QR2 bí mật). Tại đây, bạn có thể:

Quản lý sản phẩm, mẫu mã và lô sản xuất
Tạo và quản lý mã QR định danh cho từng sản phẩm
Theo dõi lịch sử quét, phát hiện gian lận
Quản lý hồ sơ doanh nghiệp, nhân sự, phân quyền
Chat với khách hàng qua hệ thống CSKH tích hợp

2. Đăng nhập

2.1 Truy cập hệ thống

Mở trình duyệt web (Chrome, Firefox, Edge — phiên bản mới nhất)
Truy cập URL quản trị do CheckProVN cung cấp
Hệ thống sẽ tự động chuyển hướng đến trang đăng nhập Keycloak

2.2 Đăng nhập bằng tài khoản

Trường	Mô tả
Email / Username	Email hoặc tên đăng nhập đã đăng ký
Mật khẩu	Mật khẩu tài khoản

Nhập thông tin và nhấn Đăng nhập
Nếu đăng nhập lần đầu, hệ thống có thể yêu cầu đổi mật khẩu

Hình 2 — Màn hình Đăng nhập hệ thống qua trang quản lý tài khoản

[!TIP]
Nếu quên mật khẩu, nhấn liên kết "Quên mật khẩu?" trên trang đăng nhập Keycloak để nhận email khôi phục.

2.3 Đăng ký tài khoản mới

Nếu chưa có tài khoản, nhấn "Đăng ký" trên trang Keycloak và điền đầy đủ thông tin yêu cầu.

3. Giao diện tổng quan

Sau khi đăng nhập thành công, bạn sẽ thấy giao diện quản trị gồm các khu vực chính:

3.1 Bố cục giao diện

Khu vực	Vị trí	Mô tả
Phần đầu (Thanh trên)	Trên cùng	Logo, nút thu/mở thanh bên, thanh tìm kiếm, thông báo, avatar người dùng
thanh bên (Menu bên trái)	Bên trái	Danh sách các tính năng, phân nhóm theo chức năng
Nội dung chính	Trung tâm	Khu vực hiển thị trang đang truy cập
Breadcrumb	Dưới phần đầu	Đường dẫn phân cấp giúp bạn biết đang ở đâu

3.2 Thanh Phần đầu

Phần tử	Chức năng
☰ Hamburger icon	Thu gọn / mở rộng thanh bên
🔔 Thông báo	Hiển thị thông báo tức thời (phê duyệt, cảnh báo gian lận, v.v.)
🌐 Ngôn ngữ	Chuyển đổi giao diện Tiếng Việt / English
👤 Avatar	Menu danh sách thả xuống: Hồ sơ cá nhân, Đổi mật khẩu, Đăng xuất

thanh bên được tổ chức thành các nhóm tính năng. Menu sẽ hiển thị khác nhau tùy theo:

Vai trò (Role) của bạn: Owner, Admin, Staff, UNROLE
Quyền (Permission) được phân bổ
Trạng thái tổ chức: Chỉ khi tổ chức đã được Duyệt mới hiển thị đầy đủ menu

📌 Tổng quan

Mục menu	Mô tả	Quyền cần
DashboardMain	Bảng điều khiển tổng quan	`analytics.view`
Phân tích thống kê	Biểu đồ phân tích chi tiết	`analytics.view`
Báo cáo chi tiết	Xuất báo cáo dữ liệu	`analytics.view`

📦 Sản phẩm

Mục menu	Mô tả	Quyền cần
Danh sách sản phẩm	Xem tất cả sản phẩm	`products.view`
Thêm sản phẩm	Tạo sản phẩm mới	`products.create`
Quản lý mẫu mã	Tạo biến thể/SKU	`products.view`
Quản lý Lô SX	Quản lý lô sản xuất	`batches.view`
Quản lý đánh giá	Xem/phản hồi đánh giá khách hàng	`products.view`

🏷️ Nhãn & QR

Mục menu	Mô tả	Quyền cần
Danh sách đợt tạo mã QR	Lịch sử các đợt gen QR	`qr.view`
Quản lý trạng thái tem	Theo dõi tem QR đã phát hành	`qr.view`
Danh sách QRT	Quản lý mã QRT (mã truy xuất)	`qr.view`
Phân cấp QRT	Cấu trúc phân cấp QRT	`qr.view`
Generate QR	Tạo mã QR mới	`qr.create`
Danh sách cấu hình QR	Quản lý template QR	`qr.create`

🛡️ An ninh & Giám sát

Mục menu	Mô tả	Quyền cần
Phát hiện gian lận	Cảnh báo quét bất thường	`analytics.view`
Hành trình sản phẩm	Timeline sản phẩm	`analytics.view` hoặc `qr.view`
Báo cáo nghi vấn	Báo cáo từ người tiêu dùng	`analytics.view`
Ảnh minh chứng	Ảnh chụp từ nhà máy/kho	`analytics.view`
Góp ý & Báo lỗi	Phản hồi người dùng	`feedback.view`
Thu hồi tem / lô	Thu hồi tem/lô lỗi	`batches.edit`
Lịch sử	Nhật ký hoạt động	`analytics.view` hoặc `qr.view`

👥 Doanh nghiệp

Mục menu	Mô tả	Quyền cần
Hồ sơ doanh nghiệp	Thông tin và hồ sơ pháp lý DN	(tất cả)
Quản lý nhân viên	Mời, thêm, xóa nhân viên	`staff.view`
Quản lý vai trò	Tạo vai trò và phân quyền RBAC	`roles.view` hoặc `roles.edit`
Quản lý dung lượng	Quản lý dung lượng lưu trữ	`organization.view`
Chat	Nhắn tin CSKH	`feedback.view`

Khi tổ chức chưa được duyệt (trạng thái Bản nháp, Đang chờ duyệt, Bị từ chối, Cần bổ sung), thanh bên chỉ hiển thị:

Hồ sơ doanh nghiệp — để bạn hoàn thiện hồ sơ và gửi duyệt

Nếu tài khoản chưa thuộc tổ chức nào, thanh bên sẽ hiển thị:

Đăng ký — Đăng ký vai trò và tạo tổ chức mới

4.4 Thao tác với thanh bên

Thu gọn: Nhấn icon ☰ (hamburger) trên phần đầu hoặc tự động khi màn hình nhỏ hơn 1025px
Mở rộng nhóm con: Nhấn vào mục có mũi tên ▼ để mở/đóng sub-menu
Hoạt động state: Mục đang truy cập sẽ được highlight tự động

[!NOTE]
Trên thiết bị mobile (< 767px), thanh bên sẽ tự ẩn và hiển thị dạng lớp phủ khi nhấn nút hamburger.

5. Quy trình onboarding cơ bản

Nếu bạn là người dùng mới, quy trình bắt đầu như sau:

Đăng nhập → Chọn vai trò → Hoàn thiện hồ sơ DN → Gửi duyệt → Chờ phê duyệt → Truy cập đầy đủ

Đăng nhập vào hệ thống
Hệ thống tự động chuyển bạn đến trang Hồ sơ doanh nghiệp
Chọn vai trò: Chủ thể đăng ký hoặc Nhân viên (tham gia bằng mã mời)
Nếu là Chủ thể → Chọn loại hình tổ chức → Điền thông tin → Tải lên giấy phép
Nhấn Gửi duyệt khi hoàn thành danh sách kiểm tra
Chờ quản trị viên phê duyệt (thông báo tức thời qua chuông 🔔)
Sau khi được duyệt → Menu đầy đủ hiện ra → Bắt đầu sử dụng

[!IMPORTANT]
Bạn phải hoàn thành tất cả mục bắt buộc trong Danh sách kiểm tra trước khi nút "Gửi duyệt" khả dụng. Xem chi tiết tại guide 22_Business_Profile.md.

6. Các thao tác chung

6.1 Đổi mật khẩu

Nhấn Avatar (góc trên bên phải) → Đổi mật khẩu
Nhập mật khẩu cũ và mật khẩu mới
Nhấn Lưu

6.2 Xem thông báo

Nhấn icon 🔔 trên phần đầu
danh sách thả xuống hiển thị các thông báo gần nhất
Nhấn vào thông báo để xem chi tiết

6.3 Đăng xuất

Nhấn Avatar → Đăng xuất
Hệ thống sẽ xóa phiên đăng nhập và chuyển về trang đăng nhập

7. Câu hỏi thường gặp (FAQ)

Câu hỏi	Trả lời
Tôi không thấy menu nào trên thanh bên?	Tổ chức của bạn chưa được duyệt hoặc bạn chưa có quyền. Hoàn thành Hồ sơ doanh nghiệp trước.
Tôi là nhân viên, làm sao để vào?	Chọn "Nhân viên" → Nhập mã mời 6 ký tự do quản trị viên cung cấp.
Hệ thống hỗ trợ ngôn ngữ nào?	Tiếng Việt và English. Chuyển đổi tại icon 🌐 trên phần đầu.
Tôi bị lỗi "Truy cập bị từ chối"?	Tài khoản không có quyền truy cập trang này. Liên hệ quản trị viên để được phân quyền.
Trang không tải được?	Kiểm tra kết nối mạng, thử xóa cache trình duyệt hoặc liên hệ hỗ trợ kỹ thuật.

Cập nhật lần cuối: 2026-05-08