Cài đặt Barista App (PWA)
Màn hình barista XCaphe (barista.xcaphe.vn (opens in a new tab)) là Progressive Web App (PWA) — bạn cài đặt trực tiếp từ trình duyệt, không qua App Store hay Play Store.
PWA hoạt động như app native: fullscreen, không có thanh trình duyệt, tự cập nhật tính năng mới, và hỗ trợ bán hàng offline khi mất kết nối internet.
Tại sao nên cài PWA?
| Trình duyệt thường | Barista PWA | |
|---|---|---|
| Fullscreen (không thanh địa chỉ) | ❌ | ✅ |
| Bán hàng khi mất internet | ❌ | ✅ |
| Tự đồng bộ đơn khi có mạng lại | ❌ | ✅ |
| Biểu tượng trên màn hình chính | ❌ | ✅ |
| Cập nhật tự động, không cần tải lại | ❌ | ✅ |
| Không cần App Store | ✅ | ✅ |
Hướng dẫn cài đặt
Android — Chrome
Mở Chrome và truy cập barista.xcaphe.vn
Đăng nhập bằng tài khoản nhân viên của bạn.
Nhấn menu ⋮ ở góc phải trên
Tìm nút 3 chấm (⋮) ở góc trên bên phải màn hình Chrome.
Chọn "Thêm vào màn hình chính"
Hoặc Chrome có thể hiện banner tự động "Thêm XCaphe Barista vào màn hình chính" ở dưới màn hình — nhấn Cài đặt để xác nhận.
Nhấn "Cài đặt" / "Thêm"
Biểu tượng XCaphe Barista xuất hiện trên màn hình chính thiết bị.
Mở app và đăng nhập
Nhấn biểu tượng để mở — app chạy fullscreen như app native.
Nếu không thấy menu "Thêm vào màn hình chính": vào Cài đặt Chrome → Trang chủ → Thêm vào màn hình chính.
Cài đặt thiết bị cho barista
Sau khi cài PWA, thực hiện thêm các bước sau để tối ưu trải nghiệm:
Giữ màn hình luôn sáng
- Android: Vào Cài đặt → Màn hình → Thời gian chờ màn hình → Không tắt (hoặc thời gian dài nhất)
- iOS/iPad: Vào Cài đặt → Màn hình & Độ sáng → Auto-Lock → Không bao giờ
- Lưu ý: Chỉ làm điều này trên thiết bị dùng chuyên cho quán, cắm sạc liên tục
Cắm sạc liên tục trong ca làm
Màn hình barista chạy suốt ca làm việc — cắm sạc để tránh hết pin.
Kết nối WiFi ưu tiên, có 4G backup
Barista App hỗ trợ offline, nhưng đơn từ kênh khác (khách QR, online) cần mạng để nhận. Dùng WiFi chính + điện thoại hotspot 4G làm backup.
Bán hàng offline hoạt động như thế nào?
Khi thiết bị mất kết nối internet:
- Banner vàng xuất hiện trên màn hình: "Mất kết nối — Đang hoạt động offline"
- Nhân viên vẫn tạo đơn bình thường — đơn được lưu tạm trong bộ nhớ thiết bị
- Trên giỏ hàng hiển thị badge số đơn chờ đồng bộ (ví dụ:
⏳ 3) - Khi kết nối phục hồi → đơn tự động gửi lên server trong vòng 30 giây
- Thông báo xanh xác nhận: "✅ Đơn TM1234 đã đồng bộ lên máy chủ"
Giới hạn offline: Đơn tạo offline không nhận được từ các kênh khác (QR khách, online store) cho đến khi có mạng. Chỉ đơn nhân viên tự tạo trên barista app mới hoạt động offline.
Cập nhật app
PWA tự cập nhật tự động — không cần làm gì. Khi có phiên bản mới:
- App tải phiên bản mới ngầm trong nền
- Lần mở app tiếp theo sẽ chạy phiên bản mới nhất
Nếu muốn cập nhật ngay: đóng app hoàn toàn → mở lại.
Gỡ cài đặt (nếu cần)
- Android: Nhấn giữ biểu tượng → Gỡ cài đặt (hoặc kéo lên "Remove")
- iOS/iPad: Nhấn giữ biểu tượng → Remove App → Delete App
- Máy tính: Trong cửa sổ app → nhấn nút
⋮góc phải trên → Gỡ cài đặt XCaphe Barista
Câu hỏi thường gặp về PWA
Q: PWA có an toàn không?
Có. PWA chạy trong sandbox của trình duyệt, không có quyền truy cập tệp máy hay camera ngoài những gì bạn cấp phép.
Q: Cài trên nhiều thiết bị được không?
Được. Mỗi nhân viên hoặc mỗi thiết bị trong quán có thể cài độc lập. Dữ liệu đồng bộ qua server — không liên quan đến thiết bị cụ thể.
Q: Nếu xóa app thì dữ liệu có mất không?
Không. Dữ liệu lưu trên server XCaphe. Xóa app chỉ xóa shortcut trên màn hình, không ảnh hưởng dữ liệu đơn hàng, menu, kho.
Q: App không chạy fullscreen trên iPhone?
Phải cài qua Safari mới có chế độ fullscreen. Nếu cài qua Chrome iOS, app sẽ mở trong Safari (không fullscreen). Gỡ ra và cài lại qua Safari.
Q: Đơn offline không đồng bộ sau khi có mạng?
Thử: kéo làm mới trang hoặc đóng/mở lại app. Nếu vẫn không sync, liên hệ support — đơn được lưu local trên thiết bị và có thể khôi phục thủ công.