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

Sequence: nộp hồ sơ và xử lý CV

Hai đường nộp hồ sơ có trình tự khác nhau. Quy tắc chấm điểm: cv-parsing-and-matching. Quy tắc nghiệp vụ hồ sơ: resumes.

Actor​

ActorVai trò
Ứng viênNộp hồ sơ
APIResumesController và các service
Hàng đợi resume-processingChạy việc đọc và phân tích, tối đa 15 việc mỗi 60 giây, một worker
GeminiTrích xuất dữ liệu CV
Nhà tuyển dụngNhận thông báo, xử lý hồ sơ

Đường 1: CV trực tuyến (đồng bộ)​

Không dùng AI và không đi qua hàng đợi: dữ liệu CV đã có cấu trúc sẵn.

Đường 2: tải file CV (bất đồng bộ)​

Nhánh thay thế và lỗi​

Tình huốngXử lý
Văn bản CV dưới 100 ký tự, trên 50.000, hoặc dưới 50 từNém lỗi Invalid CV text, ghi parseError, retry theo cấu hình
Hết quota Gemini (phút hoặc ngày)Không tính là lỗi: lên lịch lại parse-resume với độ trễ và nhiễu ngẫu nhiên, việc hiện tại hoàn tất với delayed: true
Gemini trả lỗi giới hạn tốc độRetry với backoff mũ bên trong GeminiService
Lỗi khác khi đọcGhi parseError, isParsed = false, ném lại để BullMQ retry (3 lần, backoff mũ từ 2 giây)
Việc analyze chạy khi chưa parse xongNém Resume must be parsed before analysis, ghi analysisError, retry
Tin đã hết hoạt động khi phân tíchNém Job is no longer active, ghi analysisError
Đã có kết quả parse trong cacheTrả ngay từ cache, bỏ qua bước trích xuất (cache nằm trong bộ nhớ tiến trình)
Quản trị viên hoặc HR gọi reparse hoặc reanalyzeĐưa lại việc tương ứng vào hàng đợi

Ghi chú​

  • Việc analyze được đưa vào hàng đợi hai lần trong đường 2: một lần lúc nộp, một lần sau khi parse xong. Hàng đợi không đặt jobId cố định cho hai loại việc này nên không loại trùng; xem queues.
  • Ưu tiên 1 (parse) được xử lý trước ưu tiên 2 (analyze) trong BullMQ, nhờ vậy analyze được đưa lúc nộp thường chạy sau parse.
  • Phản hồi dự kiến "30-60 seconds" là chuỗi cố định trong code, không phải số đo.
  • Văn bản CV được gửi tới Gemini và có thể xuất hiện trong log, xem known limitation.