HandyCafe Docs
admin

Thao tác Giấy phép trong Quản trị Cloud

Quản trị viên nền tảng HandyCafe được ủy quyền có thể quản lý quyền truy cập thương mại của khách hàng từ trang chi tiết khách hàng. Trang mở đầu bằng phần tổng quan tài khoản, trạng thái hồ sơ, trạng thái kết nối trực tiếp và số lượng giấy phép Genesis. Mỗi giấy phép Genesis có một thẻ thao tác riêng, hiển thị gói hiện tại, giới hạn PC và console, số dư AI, số dư hội viên, quyền dùng mô-đun bổ sung cùng trạng thái Stripe.

Các công cụ cũ và công cụ beta được giữ trong một phần riêng có thể mở rộng. Hoạt động ping và các thay đổi hồ sơ nằm trong mục Chẩn đoán và lịch sử thay đổi. Cách sắp xếp này giữ cho quy trình Genesis hiện hành luôn nổi bật mà không phải bỏ đi các công cụ hỗ trợ cũ.

Xem toàn bộ giấy phép Genesis

Mở Giấy phép trong bảng điều khiển quản trị nội bộ. Thẻ Genesis được mở mặc định và chỉ liệt kê các gói Free cùng Genesis hiện hành. Các giấy phép Beta đã cấp trước đây vẫn nằm ở thẻ Beta riêng.

Các thẻ tóm tắt hiển thị tổng số giấy phép cùng số giấy phép đang hoạt động, trả phí và miễn phí. Danh sách có thể tìm theo quán, tài khoản, email, gói hoặc khóa giấy phép. Quản trị viên cũng có thể lọc theo loại gói hoặc theo trạng thái. Mỗi dòng hiển thị hạn mức, quyền dùng Cloud và Căn-tin, số dư AI, thời hạn hiệu lực cùng trạng thái. Chọn Quản lý để mở không gian làm việc của khách hàng cho các thao tác về gói, dịch vụ, tín dụng và thanh toán.

Tạo giấy phép Genesis đầu tiên

Khi một tài khoản chưa có giấy phép Genesis, trang chi tiết khách hàng sẽ hiển thị biểu mẫu tạo giấy phép thay vì một kết quả trống. Chọn một gói Genesis đang hoạt động và một ngày hết hạn trong tương lai. Xem lại gói, ngày hết hạn và quốc gia trong hộp thoại xác nhận. Chọn Tạo giấy phép để gán trực tiếp giấy phép cho tài khoản khách hàng.

Tài khoản phải có tên quán và quốc gia trước khi tạo. Chọn Sửa hồ sơ để bổ sung thông tin còn thiếu. Gói quy định cả giới hạn PC lẫn giới hạn console. Ngày hết hạn đã chọn có hiệu lực đến hết ngày đó theo giờ UTC.

Các thao tác khả dụng

  • Gán gói Genesis. Giấy phép cấp thủ công nhận hạn mức và ngày hết hạn của gói đã chọn. Gói đăng ký do Stripe quản lý tuân theo quy tắc nâng cấp và hạ cấp thông thường, gồm cả việc tính phí ngay hoặc thay đổi theo lịch.
  • Quản lý Cloud và Căn-tin. Quyền dùng Cloud được cập nhật trên giấy phép. Việc bật Căn-tin đồng thời khởi tạo hoặc kích hoạt lại tenant tương ứng trên handy.cafe, còn khi tắt thì tenant đó bị tạm ngưng. Hai dịch vụ này không bao giờ được đồng bộ trong lúc cơ sở dữ liệu đang bị khóa.
  • Cấp tín dụng AI. Phần thao tác tín dụng hiển thị số dư AI hiện tại của giấy phép đã chọn trước khi quản trị viên nhập khoản nạp thêm. Việc cấp tín dụng sẽ cộng tín dụng USD trả trước vào ví AI và ghi lại một mục kiểm toán.
  • Cấp tín dụng hội viên. Cộng tín dụng thưởng vào tài khoản hội viên HandyCafe có cùng địa chỉ email. Thao tác này không khả dụng khi không tìm thấy hội viên trùng khớp.
  • Đổi ngày thanh toán kế tiếp. Với gói đăng ký Stripe, ngày này được cập nhật trên Stripe rồi mới đồng bộ về gói đăng ký và giấy phép nội bộ. Nếu đang có một thay đổi gói theo lịch thì phải hủy thay đổi đó trước.
  • Hoàn tiền một giao dịch. Quản trị viên chọn một khoản thu Stripe có thể hoàn, chọn một lý do do Stripe định nghĩa, nhập phần giải thích nội bộ bắt buộc rồi xác nhận hoàn tiền. Việc hoàn tiền không hủy gói đăng ký hay thu hồi quyền dùng sản phẩm.

Cơ chế an toàn và kiểm toán

Mọi hành động làm thay đổi dữ liệu đều cần xác nhận trên bảng điều khiển. Các thao tác backend có tác động lớn chỉ chạy được khi có khóa API quản trị, được kiểm tra quyền sở hữu đối với khoản thu Stripe và ghi một bản ghi kiểm toán chỉ thêm mới. Lịch sử thanh toán chỉ được tải khi có yêu cầu và giới hạn ở các khoản thu gần đây. Thao tác hoàn tiền dùng một khóa idempotency duy nhất để tránh gửi trùng ngoài ý muốn.

Nếu một giấy phép cũ không còn khóa dạng văn bản thuần có thể khôi phục, việc khởi tạo Căn-tin tự động sẽ dừng lại an toàn và bảng điều khiển báo rằng quản trị viên phải xử lý thông tin xác thực của giấy phép đó trước.

Tiền tố quốc gia trên khóa giấy phép

Khóa giấy phép mới gắn với tài khoản dùng mã quốc gia hai chữ cái lấy từ hồ sơ đã hoàn tất của khách hàng, chẳng hạn GEN-TR-... cho giấy phép Genesis do quản trị viên tạo hoặc HC-TR-... cho giấy phép tài khoản không gắn với gói cụ thể. Việc tạo từ phía quản trị sẽ dừng lại khi hồ sơ chưa có quốc gia hợp lệ. Hệ thống không bao giờ tạo khóa GEN-XX-... hay HC-XX-....

Việc cập nhật trường quốc gia trên một giấy phép đã có sẽ không âm thầm xoay vòng khóa đang hoạt động của nó. Quản trị viên phải phối hợp giữa việc chỉnh lại quốc gia và việc xoay vòng khóa, vì máy chủ đã cài đặt sẽ phải đăng nhập lại sau khi thông tin xác thực của nó thay đổi.