Chuyển tới nội dung chính

Chat Quota Policies (chat_quota_policies)

Cấu hình giới hạn số lượt chat mỗi ngày theo vai trò. Có thể thay đổi giới hạn mà không cần triển khai lại.

  • Nguồn schema: chat-quota-policy.schema.ts
  • Phân loại dữ liệu: cấu hình hệ thống, không có dữ liệu cá nhân.
  • Soft-delete: plugin thêm isDeleted và deletedAt.

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
roleNameStringCó——Tên vai trò áp dụng, trùng giá trị ERole
dailyLimitNumberKhôngnull—Số lượt chat tối đa mỗi ngày. null là không giới hạn
timezoneStringCó"Asia/Ho_Chi_Minh"—Múi giờ xác định thời điểm đặt lại bộ đếm, mặc định Asia/Ho_Chi_Minh
isActiveBooleanKhôngtrue—Chính sách đang áp dụng
createdAtDateKhông—immutableThời điểm tạo, do timestamps hoặc plugin
updatedAtDateKhông——Thời điểm sửa gần nhất, do timestamps
isDeletedBooleanCófalsethêm bởi plugin xóa mềmCờ xóa mềm. true nghĩa là bản ghi đã bị xóa khỏi nghiệp vụ nhưng vẫn còn trong database
deletedAtDateKhôngnullthêm bởi plugin xóa mềmThời điểm xóa mềm

Indexes​

KeysThuộc tínhMục đích
{ isActive: 1 }—Lọc chính sách đang bật
{ roleName: 1, isActive: 1 }—Truy vấn chính: chính sách đang bật của một vai trò

Cách quota hoạt động​

Collection này chỉ giữ chính sách. Bộ đếm lượt dùng nằm ở Redis, không ở MongoDB (chat-quota.service.ts):

  1. Chọn chính sách theo vai trò. SUPER ADMIN luôn không giới hạn (limit = null).
  2. Tìm bản ghi { roleName, isActive: true }. Chính sách được nhớ trong bộ nhớ tiến trình một thời gian.
  3. Nếu không có bản ghi, dùng giá trị mặc định trong code.
  4. Đếm bằng script Lua trên Redis (INCR kèm hạn PEXPIRE đến hết ngày theo múi giờ của chính sách) để chiếm chỗ nguyên tử. Nếu lượt chat thất bại có thể hoàn lại bằng DECR.
Vai tròMặc định trong code (khi không có bản ghi)Cấu hình ghi đè
NORMAL USER30 lượt/ngàyCHAT_QUOTA_NORMAL_USER_DAILY_LIMIT
HR100 lượt/ngàyCHAT_QUOTA_HR_DAILY_LIMIT
SUPER ADMINKhông giới hạn—

dailyLimit = null trong bản ghi nghĩa là không giới hạn cho vai trò đó. Nếu giá trị khác null nhưng không hợp lệ, dùng giá trị dự phòng ở bảng trên (normalizePolicyLimit).

Quan hệ​

roleName là chuỗi trùng giá trị của ERole, không phải tham chiếu.

Ví dụ document​

{
"_id": "665f1a2b3c4d5e6f7081a001",
"roleName": "NORMAL USER",
"dailyLimit": 30,
"timezone": "Asia/Ho_Chi_Minh",
"isActive": true,
"isDeleted": false
}

Lưu ý​

  • Known Limitation: schema không ràng buộc duy nhất roleName với isActive: true. Nếu có hai bản ghi cùng bật cho một vai trò, findOne lấy bản ghi nào trước là không xác định.
  • Việc ghi vào collection này (API hay seed) chưa được kiểm tra. Trạng thái: Chưa xác minh.
  • Bộ đếm Redis mất khi Redis mất dữ liệu, dẫn đến người dùng có thể được đếm lại từ 0 trong ngày.