HandyCafe Docs
owner it-admin

Căn-tin

Căn-tin là mô-đun dịch vụ đồ ăn và thức uống tích hợp trong HandyCafe. Nó cho phép bạn xây dựng sơ đồ số của các bàn, xuất bản thực đơn tự phục vụ có thương hiệu trên web tại handy.cafe/{your-slug}, và theo dõi mọi đơn hàng đến theo thời gian thực từ bảng điều khiển máy chủ.

Khách hàng quét mã QR trên bàn, nhập mã bảo mật 6 chữ số, duyệt thực đơn bằng ngôn ngữ của họ và đặt món. Đơn hàng sẽ xuất hiện trên màn hình Căn-tin Orders của bạn trong vài giây. Nhân viên xác nhận từng giai đoạn chế biến, và khi phục vụ hoàn tất thì thao tác "Settle Check" sẽ đóng hóa đơn chỉ bằng một bước.

Dành cho ai

Căn-tin được thiết kế cho quán internet, trung tâm game và đấu trường esports có phục vụ đồ ăn, thức uống ngay tại chỗ ngồi của khách. Nó thay thế phiếu gọi món giấy và việc gọi miệng ra quầy. Căn-tin hoạt động song song với hệ thống phiên và giá cả chuẩn của HandyCafe; đơn hàng Căn-tin được theo dõi riêng nhưng vẫn thuộc cùng một giấy phép quán.

Khả năng Cốt lõi

Tính năng Tóm tắt
Sơ đồ tầng Trình chỉnh sửa trực quan cho nhiều tầng. Kéo bàn vào vị trí, chuyển sang chế độ 3D, đánh dấu bàn ngừng phục vụ.
Bàn Cấu hình số ghế, hình dạng, kích thước (1 đến 10) và mã hiển thị cho từng bàn. Tạo mã QR và xoay mã theo yêu cầu.
Thực đơn Danh mục với biểu tượng MDI, sản phẩm có ảnh, mô tả Markdown, danh sách thành phần và nhóm biến thể (ví dụ Size, Toppings).
Đơn hàng Bảng điều khiển trực tiếp với thăm dò mỗi 3 giây, huy hiệu số đơn chờ, thông báo desktop và âm thanh, trạng thái theo từng đơn và từng món.
Quyết toán Thao tác đóng hóa đơn một chạm để thanh toán toàn bộ đơn hàng đang mở trên một bàn bằng phương thức thanh toán đã chọn.
Thực đơn khách hàng Thực đơn web có thương hiệu bằng 24 ngôn ngữ tại handy.cafe/{slug}, với giao diện sáng/tối và ngôn ngữ mặc định theo thiết bị.
Thanh toán trực tuyến Tích hợp Stripe Checkout tùy chọn cho thanh toán khi đặt, với phương án dự phòng là thanh toán tiền mặt tại bàn.
Máy in Máy in hóa đơn TCP tùy chọn với tự cắt giấy và tự in khi có đơn mới.

Căn-tin nằm ở đâu trong giao diện máy chủ

Căn-tin có hai điểm truy cập:

  1. Mục Căn-tin trong thanh bên. Đây là không gian vận hành cho sử dụng hằng ngày. Nó gồm năm tab: Tables, Floor Plan, Menu, Orders và Schedule. Tab Orders sẽ hiện huy hiệu chờ khi có đơn mới.
  2. Cài đặt > Căn-tin. Đây là khu vực cấu hình. Nó chứa hồ sơ kinh doanh (slug, tên hiển thị, logo, ảnh tiêu đề, địa chỉ, tiền tệ, múi giờ), cài đặt máy in, quản lý tầng và các công tắc tính năng tùy chọn.

Thiết lập một quán

Khi bạn bật Căn-tin lần đầu, máy chủ sẽ tự dùng giấy phép HandyCafe của bạn làm mã ủy quyền. Bạn không cần dán bất kỳ gì thủ công. Trình hướng dẫn thiết lập sẽ hỏi bốn thông tin:

  1. Slug. Đây sẽ là URL công khai tại handy.cafe/{slug}. Ký tự hợp lệ là chữ thường, số và dấu gạch ngang. Slug dài từ 3 đến 62 ký tự. Hệ thống kiểm tra khả dụng theo thời gian thực và từ chối các slug dành riêng như "admin", "api" hoặc "dashboard".
  2. Tên hiển thị. Tên dễ đọc sẽ xuất hiện ở đầu thực đơn khách hàng.
  3. Quốc gia và tiền tệ. Tiền tệ mặc định cho giá thực đơn. Giá được lưu bằng đơn vị nhỏ nhất và hiển thị với ký hiệu tiền tệ đã cấu hình.
  4. Múi giờ. Dùng cho tính thời gian chuẩn bị động, dấu thời gian của đơn hàng và bản ghi quyết toán.

Sau khi provisioning hoàn tất, quán sẽ được tạo trong cơ sở dữ liệu cloud và không gian làm việc Căn-tin sẽ mở ra. Lúc đó bạn có thể thêm tầng, bàn và món.

Hồ sơ Kinh doanh

Hồ sơ kinh doanh có thể chỉnh sửa bất cứ lúc nào trong Cài đặt > Căn-tin. Các trường chính:

Trường Mục đích
Slug Phần URL công khai. Đổi slug sẽ làm hỏng các mã QR hiện có cho đến khi được tạo lại.
Tên hiển thị Hiển thị ở đầu thực đơn khách hàng.
Logo Ảnh vuông. Khuyến nghị WebP tối đa 2 MB.
Ảnh tiêu đề Ảnh banner ngang ở đầu thực đơn khách hàng. Khuyến nghị WebP tối đa 2 MB.
Địa chỉ và Số điện thoại Tùy chọn. Hiển thị ở chân trang thực đơn.
Tiền tệ Áp dụng cho mọi giá sản phẩm trong thực đơn.
Quốc gia Dùng cho thuế và các thiết lập vùng mặc định.
Múi giờ Áp dụng cho dấu thời gian của đơn hàng và quyết toán.
Hiển thị thời gian chuẩn bị trên thực đơn Công tắc. Khi bật, mỗi sản phẩm sẽ hiển thị một chip thời gian chuẩn bị ước tính.

Cài đặt Máy in

Phần máy in chấp nhận các cấu hình sau:

  • Loại. Chỉ có Disabled hoặc TCP. In trực tiếp qua USB chưa được hỗ trợ trong bản phát hành này.
  • IP và Port. Địa chỉ mạng của máy in hóa đơn. Phần lớn máy in ESC POS TCP lắng nghe ở cổng 9100.
  • Auto Cut. Thêm lệnh cắt giấy sau mỗi hóa đơn được in.
  • Auto Print on New Order. Khi bật, mọi đơn hàng mới sẽ tự động kích hoạt in hóa đơn.
  • Sound Notification. Phát cảnh báo âm thanh ngoài thông báo desktop khi có đơn mới.
  • Test Print. Gửi một hóa đơn mẫu đến máy in đã cấu hình để kiểm tra kết nối.

Tóm tắt Kiến trúc

Căn-tin dùng mô hình dữ liệu ưu tiên cloud. Mọi bản ghi bàn, danh mục, sản phẩm, đơn hàng và quyết toán đều được lưu trong cơ sở dữ liệu cloud của handy.cafe. Máy chủ HandyCafe cục bộ của bạn phản chiếu trạng thái này và thăm dò endpoint Orders mỗi 3 giây để lấy hoạt động mới. Các trang dành cho khách được phục vụ trực tiếp từ handy.cafe cloud; chúng không yêu cầu máy chủ của bạn phải truy cập được từ internet.

Vì dữ liệu nằm trên cloud:

  • Mã QR vẫn hoạt động ngay cả khi máy chủ offline, nhưng nhân viên sẽ không thấy đơn hàng trên bảng điều khiển cho đến khi kết nối trở lại.
  • Thay đổi thực đơn sẽ được đẩy lên handy.cafe trong vài giây sau khi lưu.
  • Đơn hàng do khách đặt sẽ xuất hiện trên bảng điều khiển Orders sau lần thăm dò 3 giây tiếp theo.

Các bước tiếp theo