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
- Nhấn 🗑 → API
canDeleteConfigQrGen(id)kiểm tra điều kiện - Nếu blocked: hiển thị lý do (đang được sử dụng, là default...)
- 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