Chuyển tới nội dung chính
Offline Hub (tạm ngừng)

Thông báo trạng thái tạm ngừng và tài liệu lịch sử của Offline Hub.

Cập nhật: 2026-08-02
Mở Tổng quanMở Đơn hàngMở Bàn & QRGửi nhân viên hỗ trợ

QR Tiger Device Hub - Vận hành Offline Hub

Tạm ngừng từ 2026-08-02: Offline Hub, Staff LAN App và các API LAN đã được gỡ khỏi Device Hub hiện hành. Nội dung bên dưới chỉ được giữ làm tài liệu lịch sử, không phải hướng dẫn cho bản đang phát hành.

Cập nhật 2026-07-15: Local Hub không còn là ứng dụng merchant-facing riêng cho cài đặt mới. Cài một ứng dụng duy nhất là QR Tiger Device Hub, chọn hồ sơ máy chính, rồi bật module Offline Hub và Staff LAN App nếu máy này cần chạy vận hành nội bộ.

Khi nào dùng​

Dùng khi cửa hàng triển khai Local Hub để vận hành nội bộ tại điểm bán và cần hiểu các bước thiết lập, đồng bộ và đường dẫn nhân viên cục bộ.

Điều kiện cần​

  • Tài khoản root/chủ cửa hàng QR Tiger đang hoạt động thực hiện thiết lập đầu tiên; tài khoản nhân viên/khách hàng không dùng để gắn Device Hub.
  • Tenant phải còn quyền sử dụng gói hợp lệ. Khi quyền hết hạn, các thao tác Device Hub bị khóa cho đến khi quyền được khôi phục và kiểm tra lại.
  • Máy chạy Local Hub cần kết nối mạng trong giai đoạn đăng nhập chủ cửa hàng và đồng bộ ban đầu.
  • Chỉ mở đường dẫn nhân viên cục bộ sau khi Local Hub thiết lập xong.

Các phase chính​

  1. Owner login: chủ cửa hàng đăng nhập để xác thực quyền thiết lập.
  2. Cloud sync: Local Hub lấy dữ liệu cần thiết từ QR Tiger.
  3. Local setup: chọn cửa hàng, chi nhánh, thiết bị và cấu hình vận hành tại chỗ.
  4. Dashboard: theo dõi trạng thái, đơn, thiết bị và đồng bộ.

Electron mở Local Hub console tại /ui/. Đây là màn hình quản trị Local Hub, không phải đường dẫn gọi món của nhân viên.

Dashboard tabs​

TabDùng để
OverviewXem trạng thái tổng quan, phiên bản và cảnh báo chính
OrdersTheo dõi đơn được Local Hub xử lý
DevicesKiểm tra thiết bị đã kết nối hoặc cần kích hoạt
SyncTheo dõi đồng bộ với QR Tiger
AdminTác vụ quản trị và kiểm tra vận hành

Đường dẫn nhân viên cục bộ​

/app/ chỉ mở cho nhân viên sau khi setup hoàn tất và chạy qua chế độ localHub=1. Đường dẫn nhân viên cục bộ không dùng trực tiếp Firebase, Auth hoặc App Check như cổng đám mây; luồng này đi qua Local Hub.

Local Hub hiện không tạo đơn hẹn giờ. Nếu cửa hàng dùng đơn hẹn giờ, hãy xử lý theo luồng đám mây hoặc quy trình vận hành đã được hướng dẫn riêng.

Nếu không thấy đơn hoặc thiết bị​

Kiểm tra chi nhánh đang chọn, trạng thái đồng bộ, thiết bị đã kích hoạt và tab Sync. Nếu nhân viên mở nhầm đường dẫn đám mây thay vì đường dẫn cục bộ, dữ liệu có thể không giống nhau.

Lỗi thường gặp​

  • Không vào được /app/: setup chưa hoàn tất hoặc chưa chạy qua localHub=1.
  • Không thấy đơn: kiểm tra tab Orders, chi nhánh và trạng thái đồng bộ.
  • Thiết bị chưa hoạt động: kiểm tra tab Devices và quá trình kích hoạt thiết bị.
  • Dữ liệu không mới: kiểm tra tab Sync và kết nối mạng.
  • Device Hub báo gói hết hạn: gia hạn/khôi phục quyền tenant, sau đó chờ hoặc kích hoạt kiểm tra lại trước khi tiếp tục thao tác.

Màn hình liên quan​

  • Local Hub console
  • Đơn hàng
  • Bàn & QR
  • Tổng quan

Khi nào nên gửi nhân viên hỗ trợ​

Gửi hỗ trợ khi Local Hub đã setup đủ nhưng không đồng bộ, không mở được đường dẫn nhân viên cục bộ hoặc dữ liệu tại điểm bán không khớp với QR Tiger.