Hướng dẫn nhân viên Barista / Pha chế
Dành cho: Pha chế · Thu ngân · Quản lý ca · docs.xcaphe.vn
Thiết bị cần có
- Điện thoại hoặc tablet (Android/iOS/iPad)
- Kết nối WiFi hoặc 4G
- Đã được Chủ quán tạo tài khoản và cấp PIN
Phần 1 — Cài đặt Barista App lần đầu
Bước 1: Mở trình duyệt và truy cập barista.xcaphe.vn
- Android: Dùng Chrome
- iPhone/iPad: Dùng Safari (không dùng Chrome trên iOS)
Bước 2: Nhập mã ghép (do Chủ quán cung cấp)
Chủ quán sẽ đọc cho bạn một mã 6 ký tự. Nhập vào ô mã ghép, đặt tên thiết bị (ví dụ: "iPad Quầy"), nhấn Kết nối.
⚠️
Mã có hiệu lực 15 phút. Nếu hết hạn, yêu cầu Chủ quán tạo mã mới.
Bước 3: Cài app lên màn hình chính (khuyến nghị)
Android (Chrome):
- Nhấn menu ⋮ góc trên phải → Thêm vào màn hình chính
- Nhấn Cài đặt để xác nhận
iPhone/iPad (Safari):
- Nhấn nút Share ⬆️ (ở thanh dưới Safari)
- Chọn Thêm vào màn hình chính → nhấn Thêm
Bước 4: Cắm sạc và tắt auto-lock
- Android: Cài đặt → Màn hình → Thời gian chờ → Không tắt
- iOS/iPad: Cài đặt → Màn hình & Độ sáng → Auto-Lock → Không bao giờ
Phần 2 — Đăng nhập mỗi ca
- Mở app barista (biểu tượng trên màn hình chính)
- Chọn tên của bạn từ danh sách
- Nhập PIN → nhấn ✓
- Nếu có KDS: chọn khu vực bếp bạn phụ trách
Phiên làm việc kéo dài 8 giờ từ lúc đăng nhập.
Phần 3 — Nhận và xử lý đơn hàng
Đơn từ khách quét QR
Đơn tự động xuất hiện ở tab Đơn hàng (real-time).
| Trạng thái | Nghĩa | Hành động của bạn |
|---|---|---|
| 🟡 Chờ xác nhận | Khách vừa đặt | Nhấn Xác nhận |
| 🔵 Đang pha chế | Đang làm | Pha chế xong → nhấn Xong |
| ✅ Sẵn sàng | Chờ khách lấy | Gọi tên / số bàn |
| ✓ Hoàn thành | Khách đã nhận | — |
Tạo đơn POS (tại quầy)
- Nhấn tab Tạo đơn (hoặc nút + góc phải)
- Chọn món → chọn biến thể → thêm vào giỏ
- Chọn Bàn hoặc Takeaway
- Nhấn Thanh toán → chọn phương thức → Xác nhận
Phần 4 — Bán hàng khi mất WiFi
Khi mất mạng, banner vàng xuất hiện: "Mất kết nối — Đang hoạt động offline"
- Vẫn tạo đơn bình thường được — đơn lưu tạm trên thiết bị
- Giỏ hàng hiện badge:
⏳ 3(số đơn chờ đồng bộ) - Khi có mạng lại → đơn tự đồng bộ trong 30 giây
⚠️
Đơn offline không nhận được từ khách quét QR. Chỉ đơn bạn tự tạo mới hoạt động offline.
Phần 5 — Các tình huống thường gặp
| Tình huống | Xử lý |
|---|---|
| PIN sai, bị khóa | Chờ 15 phút hoặc nhờ Manager đặt lại PIN |
| Đơn không hiện lên | Kéo làm mới trang · Kiểm tra WiFi |
| Mã ghép hết hạn | Yêu cầu Chủ quán tạo mã mới |
| App cập nhật chậm | Đóng hoàn toàn → mở lại |
| Máy in không in | Báo Manager kiểm tra Bridge Device |
Liên hệ hỗ trợ
Nếu gặp sự cố không tự xử lý được: báo ngay Quản lý / Chủ quán.
docs.xcaphe.vn/getting-started/pwa-install · docs.xcaphe.vn/getting-started/device-pairing