HandyCafe Docs
owner

Cấp bậc Thành viên

Hệ thống cấp bậc thành viên tự động giảm giá cho khách hàng thường xuyên dựa trên hoạt động tích lũy. Khi hội viên sử dụng quán (chi tiêu, đăng nhập, mua gói hoặc đặt hàng) họ tích lũy điểm thưởng. Khi tổng điểm vượt ngưỡng cấp bậc, họ lên hạng cao hơn và nhận giảm giá lớn hơn cho phiên.

Cấu trúc Cấp bậc

Mỗi cấp bậc được định nghĩa bởi bốn trường:

Trường Mô tả
code Mã ngắn duy nhất cho cấp bậc (ví dụ: silver, gold, vip). Dùng nội bộ cho nhận dạng và trong phản hồi API.
name Tên hiển thị dễ đọc (ví dụ: "Hội viên Bạc", "Hội viên Vàng"). Hiển thị trong hồ sơ hội viên và trên màn hình khóa máy khách.
threshold_points Số điểm thưởng tối thiểu hội viên phải tích lũy để đủ điều kiện cho cấp bậc này.
discount_bps Giảm giá áp dụng cho phiên, tính bằng điểm cơ bản (basis points). 100 BPS bằng 1%. Giá trị 500 nghĩa là giảm 5%.

Cấp bậc được sắp xếp theo giá trị threshold_points. Hội viên thuộc cấp bậc cao nhất mà họ đạt ngưỡng điểm.

Giảm giá Điểm Cơ bản (BPS)

Giảm giá được tính bằng điểm cơ bản (BPS) thay vì phần trăm để tránh lỗi làm tròn số thập phân trong tính toán tài chính. Một điểm cơ bản bằng 0.01%, hay một phần trăm của phần trăm.

Giá trị giảm giá phổ biến:

Giá trị BPS Phần trăm Ví dụ trên giá 50.000/giờ
250 2.5% Hội viên trả 48.750/giờ
500 5% Hội viên trả 47.500/giờ
1000 10% Hội viên trả 45.000/giờ
1500 15% Hội viên trả 42.500/giờ
2000 20% Hội viên trả 40.000/giờ

Khi hội viên có giảm giá cấp bậc bắt đầu phiên, bộ tính giá giảm giá theo giờ cơ bản bằng discount_bps của cấp bậc trước khi tính chi phí đoạn.

Sự kiện Tích điểm

Hội viên tích điểm qua sự kiện tích điểm. Mỗi sự kiện ghi nhận thay đổi điểm và hoạt động kích hoạt:

Loại Sự kiện Mô tả Điểm Thường gặp
spend Hội viên thanh toán phiên (trả sau hoặc trừ ví). Điểm tỷ lệ với số tiền chi. Theo số tiền chi
usage Hội viên sử dụng PC hoặc console, bất kể thanh toán. Điểm dựa trên thời lượng sử dụng. Theo số phút
visit Hội viên đăng nhập từ PC khách. Thưởng cố định cho mỗi lần ghé, khuyến khích đến thường xuyên. Cố định mỗi lần
topup Hội viên nạp tiền vào ví. Điểm phản ánh số tiền nạp. Theo số tiền nạp
order Hội viên đặt đơn hàng sản phẩm (đồ ăn, đồ uống, v.v.). Điểm tỷ lệ với tổng đơn. Theo tổng đơn
adjustment Điều chỉnh điểm thủ công bởi quản trị viên. Dùng cho sửa lỗi, khuyến mãi hoặc phần thưởng đặc biệt. Giá trị bất kỳ

Nâng hạng

Quy trình nâng hạng hoạt động như sau:

  1. Hội viên thực hiện hoạt động (phiên, mua hàng, đăng nhập, v.v.).
  2. Hệ thống tạo sự kiện tích điểm với points_delta tương ứng.
  3. Tổng điểm hội viên được tính lại bằng tổng tất cả giá trị points_delta.
  4. Hệ thống kiểm tra tổng mới có đạt ngưỡng cấp bậc cao hơn không.
  5. Nếu hội viên đủ điều kiện cho cấp bậc mới, trường tier được cập nhật và giảm giá mới có hiệu lực từ phiên tiếp theo.

Quản trị viên cũng có thể gán cấp bậc thủ công, ghi đè tính toán tự động.

Cách Giảm giá Cấp bậc Áp dụng

Khi bộ tính giá tính chi phí đoạn phiên cho hội viên:

  1. Giá theo giờ cơ bản được xác định bởi ô giá đang hoạt động.
  2. Nếu hội viên có cấp bậc với giá trị discount_bps, giá cơ bản được giảm: giá_giảm = giá_cơ_bản * (10000 - discount_bps) / 10000.
  3. Giảm giá cấp cá nhân (member_discount_bps trên bản ghi hội viên) cũng được áp dụng nếu có.
  4. Giá giảm cuối cùng dùng để tính chi phí đoạn.

Giảm giá cấp bậc và giảm giá cá nhân có thể cộng dồn, mang lại cho hội viên lợi ích kết hợp.

Tạo và Quản lý Cấp bậc

Để tạo cấp bậc mới:

  1. Đi đến Cài đặt và mở phần Giá cả (hoặc khu vực quản lý cấp bậc chuyên dụng).
  2. Nhấp Thêm Cấp bậc.
  3. Nhập (duy nhất, chữ thường), tên (nhãn hiển thị), ngưỡng điểmgiảm giá BPS.
  4. Lưu cấp bậc.

Để chỉnh sửa, chọn từ danh sách và thay đổi bất kỳ trường nào. Thay đổi discount_bps có hiệu lực với tất cả hội viên hiện thuộc cấp bậc đó, bắt đầu từ phiên tiếp theo.

Ví dụ Thiết lập

Cấu hình ba cấp bậc thông thường:

Tên Ngưỡng Điểm Giảm giá BPS
bronze Đồng 0 0
silver Bạc 500 500
gold Vàng 2000 1000
vip VIP 5000 1500

Hội viên mới bắt đầu ở Đồng (không giảm giá). Sau khi tích lũy 500 điểm, tự động lên Bạc với giảm 5%. Tại 2000 điểm đạt Vàng (10%) và tại 5000 điểm đạt VIP (15%).