HandyCafe Docs
owner

Quản lý Thực đơn

Tab Menu trong Căn-tin là nơi bạn xây dựng danh mục mà khách sẽ thấy tại handy.cafe/{slug}. Thực đơn gồm danh mục và sản phẩm. Sản phẩm có thể có nhóm biến thể cho các lựa chọn như Size hoặc Toppings.

Cấu trúc

Cấp Mục đích
Danh mục Một phần của thực đơn, ví dụ "Đồ uống nóng" hoặc "Burger". Mỗi danh mục có biểu tượng và thứ tự sắp xếp.
Sản phẩm Một mặt hàng có thể đặt riêng bên trong danh mục. Nó có tên, mô tả, ảnh, giá, thuế suất VAT và thời gian chuẩn bị.
Nhóm biến thể Tùy chọn. Một nhóm lựa chọn gắn với sản phẩm, ví dụ "Size: Nhỏ, Vừa, Lớn". Mỗi biến thể có giá cộng thêm riêng.

Danh mục

Mỗi danh mục có các trường sau:

Trường Ý nghĩa
Tên Hiển thị như tiêu đề phần trên thực đơn khách hàng.
Biểu tượng Tên biểu tượng MDI (Material Design Icons). Chọn từ bộ chọn biểu tượng.
Thứ tự sắp xếp Số nguyên. Số nhỏ hơn sẽ hiển thị trước. Có thể điều chỉnh bằng kéo hoặc nút lên/xuống.
Active Khi tắt, danh mục và toàn bộ sản phẩm trong đó sẽ bị ẩn khỏi thực đơn khách hàng nhưng không bị xóa.

Thêm danh mục

  1. Mở Căn-tin > Menu.
  2. Nhấp Add Category.
  3. Nhập tên.
  4. Nhấp vào ô biểu tượng và chọn một biểu tượng MDI. Bộ chọn mở ra danh sách có tìm kiếm. Hãy thử các từ khóa như "coffee", "burger" hoặc "pizza".
  5. Lưu. Danh mục sẽ xuất hiện trong trình chỉnh sửa thực đơn.

Sắp xếp lại danh mục

Kéo tay nắm trên một hàng danh mục để di chuyển nó. Vị trí mới sẽ được lưu ngay khi bạn thả chuột. Bạn cũng có thể dùng mũi tên lên/xuống để đặt chính xác.

Xóa mềm

Xóa một danh mục có sản phẩm phụ thuộc sẽ đánh dấu danh mục đó là inactive thay vì xóa bản ghi. Việc này giữ lại lịch sử đơn hàng tham chiếu tới các ID sản phẩm gốc. Để khôi phục, bật lại danh mục từ giao diện quản trị.

Sản phẩm

Mỗi sản phẩm có các trường sau:

Trường Ý nghĩa
Danh mục Danh mục cha.
Tên Hiển thị cho khách.
Mô tả Hỗ trợ Markdown. Xuất hiện trong bảng chi tiết sản phẩm khi khách chạm vào món.
Thành phần Dòng ngắn bên dưới mô tả. Dùng cho dị ứng hoặc nhấn mạnh thành phần.
Giá cơ bản Giá trước khi áp dụng biến thể. Được lưu bằng đơn vị nhỏ nhất nhưng nhập theo đơn vị tiền tệ tròn.
Thuế suất VAT Phần trăm. Áp dụng khi hiển thị tổng tiền trên hóa đơn khách.
Đơn vị Nhãn tùy chọn như "ml" hoặc "g". Hiển thị cạnh giá.
Ảnh Ảnh sản phẩm. Chấp nhận mọi định dạng. Khuyến nghị WebP tối đa 2 MB để tải thực đơn nhanh nhất.
Track Stock Khi bật, sản phẩm có số lượng tồn kho và sẽ giảm sau mỗi đơn hàng.
In Stock Số lượng tồn hiện tại. Khi tồn về 0, đơn hàng của khách sẽ thất bại và sản phẩm tự ẩn.
Active Khi tắt, sản phẩm bị ẩn khỏi thực đơn khách hàng.
Thứ tự sắp xếp Vị trí trong danh mục.
Thời gian chuẩn bị Ước tính cố định dự phòng theo phút. Xem mục Thời gian chuẩn bị động bên dưới.

Tải ảnh lên

  1. Mở sản phẩm.
  2. Nhấp vào vùng ảnh.
  3. Chọn một hình ảnh từ máy tính. Endpoint tải lên chấp nhận mọi định dạng.
  4. Máy chủ xử lý file, lưu asset ID, MIME type và checksum, rồi trả về một URL.
  5. Ảnh sẽ xuất hiện ngay trong trình chỉnh sửa và trên thực đơn khách hàng sau vài giây.

Thay ảnh bằng cách nhấp vào hình hiện có và tải một file mới. File cũ sẽ bị thay thế.

Markdown trong mô tả

Mô tả sản phẩm hỗ trợ Markdown. Các cách dùng phổ biến:

  • Nhấn mạnh bằng **đậm**.
  • Xuống dòng cho mô tả nhiều dòng.
  • Danh sách ngắn cho thành phần hoặc món đi kèm.

Tránh dùng tiêu đề (H1 đến H6) trong mô tả sản phẩm. Thực đơn khách hàng hiển thị mô tả trong một thẻ hạn chế và tiêu đề sẽ trông rất cồng kềnh.

Nhóm biến thể

Biến thể ghi nhận các lựa chọn của khách làm thay đổi giá hoặc cấu hình. Một sản phẩm có thể có nhiều nhóm biến thể, ví dụ Size và Toppings trên cùng một chiếc burger.

Mỗi biến thể có:

Trường Ý nghĩa
Tên Nhãn hiển thị cho khách, ví dụ "Size" hoặc "Thêm phô mai".
Chênh lệch giá Số tiền cộng thêm vào giá cơ bản khi biến thể này được chọn. Có thể bằng 0 hoặc âm.
Bắt buộc Khi bật, khách phải chọn ít nhất một biến thể từ nhóm này trước khi thêm vào giỏ.
Thứ tự sắp xếp Vị trí trong nhóm.

Tạo nhóm biến thể

  1. Mở sản phẩm.
  2. Cuộn đến phần Variants.
  3. Nhấp Add Variant.
  4. Nhập tên và chênh lệch giá. Bật Required nếu lựa chọn đó là bắt buộc.
  5. Lưu.

Lặp lại cho từng tùy chọn trong nhóm. Một nhóm "Size" điển hình có ba dòng: Small với chênh lệch 0, Medium với +1.00, Large với +2.00.

Thời gian chuẩn bị động

HandyCafe có thể tính thời gian chuẩn bị ước tính theo thời gian thực cho từng sản phẩm dựa trên hiệu suất bếp thực tế. Điều này giúp tăng độ chính xác của chip ước lượng hiển thị trên thực đơn khách hàng và trên các đơn hàng đang xử lý.

Thiết lập Tác động
Static Time Được lưu trên sản phẩm. Dùng khi chưa đủ lịch sử để tính giá trị động.
Dynamic Estimate Được tính từ 30 ngày gần nhất của lịch sử đơn hàng. Thời gian chuẩn bị trung bình của từng sản phẩm được nhân với hệ số bận rộn suy ra từ độ dài hàng chờ hiện tại. Hệ số nhân được giới hạn từ 1.0 đến 2.0. Giá trị cuối cùng được giới hạn từ 1 đến 120 phút.

Thiết lập "Show Prep Time on Menu" trong hồ sơ kinh doanh quyết định chip ước lượng có hiển thị với khách hay không. Nhân viên luôn thấy ước lượng trên bảng Orders.

Theo dõi tồn kho

Bật Track Stock cho từng sản phẩm để tránh bán những món đã hết.

  • Khi một đơn hàng được đặt, số lượng tồn sẽ giảm theo số lượng đã đặt.
  • Khi tồn về 0, sản phẩm sẽ tự động ẩn khỏi thực đơn khách hàng cho đến khi bạn cập nhật lại số lượng.
  • Để nhập hàng lại, hãy chỉnh sửa sản phẩm và nhập giá trị In Stock mới.

Các sản phẩm không bật Track Stock sẽ hoạt động như tồn kho vô hạn và không bao giờ tự ẩn.

Sắp xếp lại sản phẩm trong một danh mục

Kéo tay nắm để di chuyển sản phẩm lên hoặc xuống. Thứ tự sắp xếp mới sẽ được lưu khi thả chuột. Thực đơn khách hàng phản ánh thứ tự mới sau lần làm mới thực đơn tiếp theo, diễn ra ở mỗi lần tải phiên.

Mẹo

  • Bắt đầu với 6 đến 10 danh mục. Quá nhiều danh mục sẽ làm khách duyệt thực đơn chậm hơn.
  • Dùng ảnh sáng rõ, tương phản cao. Ảnh tối hoặc nhiễu sẽ làm giảm tỉ lệ đặt món.
  • Giữ mô tả dưới 120 ký tự nếu có thể. Mô tả dài sẽ đẩy nút Add to Cart xuống dưới màn hình đầu tiên trên điện thoại.
  • Đặt thời gian chuẩn bị tĩnh thực tế. Hệ thống động cần 30 ngày để học. Trong thời gian đó, con số tĩnh là điều khách sẽ thấy.
  • Với món có nhiều lựa chọn, hãy tách thành hai nhóm biến thể thay vì một danh sách quá lớn. "Size" cộng với "Sữa" sẽ gọn hơn nhiều so với "Size kèm Sữa".