Nui Blog

Trời tính không bằng máy tính

Secret Docs

[SAC/Prom] Test app checkin

Lưu ý: Đây là tài liệu nội bộ trong SAC, không được tiết lộ ra ngoài

Giới thiệu

Tài liệu này hướng dẫn cách sử dụng phần mềm soát vé mới, dự kiến sẽ áp dụng dành cho prom năm 2020. Phần mềm này hướng đến giải quyết các vấn đề đã gặp phải với việc soát vé ở các năm trước, vì vậy nó có các tính năng nổi trội như:
– Sử dụng React Native (thay vì web như trước), nên tốc độ xử lý nhanh hơn (thực tế chỉ mất chưa tới 0,5 giây để nhận diện 1 mã QR code)
– Chạy được trên cả iOS (iPad, iPhone) và Android
– Dùng 2 camera trước / sau luân phiên để tránh việc 1 camera bị quá nóng

Hướng dẫn cài đặt

  1. Cài ứng dụng Expo Client:
    Trên Android: https://play.google.com/store/apps/details?id=host.exp.exponent
    Trên iOS: https://apps.apple.com/fr/app/expo-client/id982107779
  2. Mở ứng dụng lên và đăng nhập với:
    Username: promcnh
    Password: bananhNui

Hướng dẫn sử dụng

  1. Mở ứng dụng Expo
  2. Vào mục “Profile” ở góc dưới, bên phải màn hình
  3. Bấm vào “NuiPromMCDT” và đợi nó khởi động (sẽ mất khoảng 10-30 giây)
  4. Lần đầu sử dụng, bạn sẽ được hỏi API Key.
    Nhập vào ô điền Key: nuitest
    Bấm nút “Login”
  5. Nếu được hỏi quyền sử dụng camera, bấm nút Đồng ý (Allow)

Để quét 1 vé (đánh dấu khách đã check-in):

  1. Đưa camera ra trước mã QR
  2. Thông tin về vé sẽ hiện ra
    – Nếu hiện (OK) Haven't checked before cùng màu xanh lá cây ở dưới, tức là vé hợp lệ và chưa từng đc sử dụng trước đó
    – Nếu hiện (WARN) Have been checked before cùng màu đỏ ở dưới, tức là vé đã được check-in trước đây rồi
    – Trong trường hợp mã đã đc scan trước đây, lịch sử các lần scan sẽ hiện theo thứ tự từ cũ đến mới nhất
  3. Bấm nút “Add one check-in”

Lấy 1 vài mã QR để thử tại đây (Bấm vào file dạng ABCdef12-1234abcd.png để xem ảnh mã QR)
https://ngxson.com/_stuffs/ztest_prom_qrcodes/

Để đánh dấu check-out cho một vé:

Trong buổi biểu diễn, sẽ có trường hợp có người cần ra ngoài. Lúc này có thể sử dụng tính năng đánh dấu check-out để đánh dấu rằng người cầm vé này đã đi ra ngoài. Lưu ý, vé đã check-out mà khi check-in lại thì vẫn hiện màu đỏ

  1. Bấm vào nút “Ch. Mode” ở góc trên bên phải, tên chế độ bên cạnh sẽ chuyển thành “Check-OUT”
  2. Thông tin về vé sẽ hiện ra, bấm nút “Add one check-out”

Đổi camera và bộ đếm giờ:

Để đổi giữa camera trước / sau, bấm nút “Ch. Cam.” ở góc trên bên trái

Vì lý do camera của điện thoại khi hoạt động lâu (khoảng trên 10 phút) sẽ nóng và có thể ngừng hoạt động tạm thời. Bộ đếm số giây bên cạnh sẽ cho biết còn khoảng bao lâu thì nên đổi camera (và khi nó đếm hết thì nó cũng sẽ tự đổi camera hộ mình)

Các lỗi có thể gặp

  • “Network error”: Lỗi do mạng, hãy thử lại
  • “Invalid code”: Mã QR được quét không hợp lệ (có thể do có 1 mã QR nào đó khác đang trong tầm nhìn của camera)
  • “API Key Invalid”: Key đã bị đổi, bạn hãy nhập key mới

Theme by Anders Norén