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

ADR-0003: BullMQ cho xử lý nền, điều tiết theo hạn mức nhà cung cấp

Bối cảnh​

Đọc CV bằng AI chậm và chịu giới hạn tốc độ; đồng bộ nguồn ngoài mất vài chục giây đến vài phút; email phụ thuộc SMTP; xóa tài khoản cần hẹn giờ 30 ngày.

Quyết định​

Dùng BullMQ trên Redis cho việc nền, mặc định 3 lần thử với backoff mũ. Hàng đợi đọc CV được giới hạn tốc độ khớp trần RPM của Gemini; khi hết quota thì lên lịch lại thay vì báo lỗi.

Hệ quả​

Phản hồi tức thì cho người dùng, điều tiết gọi AI, retry tự động. Đánh đổi: hầu hết hàng đợi thiếu jobId chống trùng, một số giữ việc lỗi vô thời hạn, worker chung tiến trình (queues).

Mức tin cậy của lý do​

Cấu hình và comment trong code là bằng chứng cho việc điều tiết theo trần của nhà cung cấp. Ý định thiết kế tổng thể không được ghi riêng.