checkpro.vn

Cấu hình mã QR

Menu: Cài đặt → Cấu hình QR
Route: /settings/configqrgen
Quyền yêu cầu: qr.config
Phiên bản: v1.0 — 2026-05-08


1. Giới thiệu

Trang Cấu hình mã QR quản lý các template tạo QR code cho tổ chức. Mỗi cấu hình định nghĩa kiểu QR (Cơ bản/Nâng cao), màu sắc, hình dạng, ảnh nền, logo, và Identity Image. Hỗ trợ xem trước cả Server-side và Client-side.

2. Giao diện — Bảng danh sách

Cột Mô tả
ô tích chọn
Tên cấu hình Tên template
Loại QR Cơ bản / Nâng cao
Loại Nền Kiểu background
Tổng kích thước TotalSize (px)
Trạng thái huy hiệu Kích hoạt/Tắt + công tắc switch
Mặc định công tắc switch — chỉ 1 config mặc định
Ngày tạo Date
Hành động "Xem chi tiết" + 🗑 Xóa

3. Thao tác

3.1 Bật/Tắt trạng thái

công tắc switch → API setConfigQrStatus(id, isActive)

3.2 Đặt mặc định

công tắc switch cột Mặc định → API setDefaultConfigQr(id). Chỉ 1 config mặc định tại 1 thời điểm.

3.3 Xem chi tiết — hộp thoại XL

hộp thoại hiển thị 2 cột:

Cột trái (cuộn được):

  • Thông tin chung: tên, kích thước tổng, loại QR, loại nền, trạng thái, ngày tạo
  • Cấu hình ảnh định danh: tên thương hiệu, mã bí mật, kích thước hiển thị
  • Cấu hình QR:
    • Cơ bản: kích thước, màu tối/sáng, mức sửa lỗi, viền trắng
    • Nâng cao: hình dạng ô, kiểu gradient, tỷ lệ lấp đầy, màu sắc, độ phủ nền, chế độ ảnh nền, kích thước đích, số ô viền trắng

Cột phải — Xem trước:

  • Xem trước (máy chủ): ảnh được tạo trên máy chủ — chính xác nhất.
  • Xem trước (nhanh): ảnh được tạo ngay trên trình duyệt — hiển thị nhanh.
  • Logo (với QR nâng cao): cắt tròn hoặc vuông, có viền trắng.

3.4 Xóa cấu hình

  1. Nhấn 🗑 → API canDeleteConfigQrGen(id) kiểm tra điều kiện
  2. Nếu blocked: hiển thị lý do (đang được sử dụng, là default...)
  3. Nếu OK (có thể kèm warning) → Xác nhận → deleteConfigQrGen(id)

4. Loại QR

Loại Mô tả
Cơ bản QR đen trắng tiêu chuẩn. Tùy chỉnh: màu, kích thước, ECC, quiet zone
Nâng cao QR có ảnh nền, logo, gradient, hình dạng module (Circle/Star/...)

5. FAQ

Câu hỏi Trả lời
Tạo config mới ở đâu? Qua trang Tạo QR (/settings/generateqr), config tự lưu khi tạo.
Xem trước server vs client? Xem trước trên máy chủ chính xác hơn nhưng chậm hơn; xem trước trên trình duyệt nhanh hơn.
Xóa config đang dùng? Không được. canDeleteConfigQrGen sẽ block với lý do rõ ràng.

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