Trường hợp đặc biệt và rào cản

Danh sách này mô tả các tình huống thực tế xảy ra tại cửa và cách xử lý. Mỗi trường hợp đi kèm dấu hiệu nhận biết, hành động cần làm, và liên kết tới trạng thái quét tương ứng.

1. Quét trùng (đã check-in rồi)

Khách đã được check-in thành công và quay lại quét mã QR.

Nếu sự kiện bật check-out: quét lại sẽ tự động check-out khách (màn hình xanh dương “Tự động check-out”). Lần quét tiếp theo sẽ check-in lại — phù hợp sự kiện cho phép ra vào nhiều lần.
Nếu sự kiện chỉ cho vào một lần: màn hình vàng “Đã check-in rồi”, hiển thị thời gian check-in trước và tên cửa. Không cho vào trừ khi chính sách cho phép — nhân viên báo ban tổ chức.

2. Quét khi mất mạng (offline)

Mạng sudden drop giữa lúc đang check-in.

Máy quét tự động chuyển sang chế độ offline: các lượt check-in được lưu tạm trên thiết bị và tự đồng bộ khi có mạng lại.
Màn hình thành công offline màu hổ phách “Đang chờ đồng bộ” cùng số lượng đang chờ — bạn trấn an khách là vé đã được ghi nhận.
Mỗi lượt lưu tạm mang theo dấu thời gian để hệ thống sắp xếp đúng thứ tự khi đồng bộ.

3. Mã QR không hợp lệ hoặc không rõ ràng

Camera quét không ra hoặc hệ thống trả kết quả “Mã QR không hợp lệ” (đỏ).

Yêu cầu khách mở lại vé trên điện thoại, tăng độ sáng màn hình hoặc in lại PDF.
Nếu vẫn không được, dùng nhập tay số vé hoặc tìm theo tên/email (xem mục 5).
Mã QR không tồn tại trong hệ thống — xác nhận khách có đúng vé của sự kiện này không.

4. Vé thuộc sự kiện khác

Mã QR hợp lệ nhưng thuộc một sự kiện khác — màn hình đỏ “Sai sự kiện”.

Không cho vào. Hướng dẫn khách tới sự kiện đúng của họ.
Thường xảy ra khi khách có nhiều vé hoặc nhầm sự kiện cùng ngày.

5. Khách mất điện thoại / không có vé (“No Ticket”)

Khách đến cửa nhưng không có mã QR.

Bấm nút “No Ticket” trên máy quét.
Tìm khách theo tên hoặc email.
Nếu tìm thấy vé đang hoạt động — tiến hành check-in thủ công (ghi nhận phương thức “Tra cứu thủ công”).
Nếu không tìm thấy vé — không cho vào, báo ban tổ chức hỗ trợ.

6. Check-in lại / hoàn tác

Cần đảo ngược một lượt check-in.

Sự kiện bật check-out: dùng tính năng check-out (hoặc quét lại để tự động check-out như mục 1).
Sự kiện chỉ vào một lần: chỉ ban tổ chức mới được hoàn tác — nhân viên cửa báo lên ban tổ chức để xử lý. Ban tổ chức xem hướng dẫn xóa hoặc khôi phục một lượt check-in tại trang Quản lý lượt check-in.
Để hiểu rõ hơn về chính sách ra vào nhiều lần và check-out, xem Vào lại và check-out.

7. Cửa hết sức chứa (đã đủ người)

Sức chứa cửa đã đầy — màn hình hổ phách “Cửa hết chỗ”.

Hướng dẫn khách sang cửa khác còn chỗ, hoặc chờ có khách ra (check-out) để giải phóng chỗ.
Sức chứa được tính theo thời gian thực dựa trên số đang ở trong cửa.

8. Ngoài khung giờ check-in / sự kiện nhiều ngày

Thời gian hiện tại nằm ngoài cửa sổ check-in.

Chưa tới giờ: “Chưa tới giờ check-in” (hỏi khách chờ tới giờ mở cửa).
Đã quá giờ: “Đã hết giờ check-in” (yêu cầu ban tổ chức gia hạn cửa sổ).
Sự kiện nhiều ngày có lịch theo ngày: “Hôm nay không mở” khi hôm nay không nằm trong các ngày được bật của lịch check-in theo ngày — kiểm tra lại lịch với ban tổ chức.

9. Kiosk tự phục vụ

Chế độ kiosk để khách tự quét vé mà không cần nhân viên.

Cấu hình thời gian chờ và nguồn nhập (camera/bàn phím) trước khi bật.
Kiosk ghi nhận phương thức check-in là “Quét tại kiosk”.
Phù hợp sự kiện lưu lượng lớn, nhưng cần giám sát từ xa và có người hỗ trợ khi khách gặp vấn đề (mục 3–5).

10. Phiên đăng nhập hết hạn

Phiên đăng nhập bị vô hiệu hóa hoặc hết hạn — nhân viên bị đá ra khỏi phiên.

Đăng nhập lại bằng thông tin tài khoản hoặc mã đăng nhập QR.
Các lượt quét offline đã lưu tạm vẫn giữ nguyên và sẽ đồng bộ sau khi đăng nhập lại (nếu cùng thiết bị).

11. Phân biệt lỗi mạng tạm thời vs lỗi dữ liệu

Cách hai loại lỗi được xử lý khác nhau — quan trọng để không bị kẹt.

Loại lỗi	Ví dụ	Xử lý
Tạm thời	Không phản hồi, lỗi máy chủ tạm thời, không kết nối được máy chủ	Lưu tạm offline, hiển thị “Đang chờ đồng bộ” / “Lỗi mạng”, tự đồng bộ khi có mạng
Lỗi dữ liệu / vé không hợp lệ	Không có quyền, không được phép, dữ liệu gửi không hợp lệ	Hiển thị ngay, không lưu tạm để tránh lặp lại lượt quét không hợp lệ

Khi cần tra cứu nhanh

Trạng thái quét

Bảng đầy đủ 15 trạng thái màu và hành động tương ứng — xem chi tiết.

Tổng quan Check-in

Quay lại trang tổng quan để xem hai vai trò và luồng chính — xem tổng quan.