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

Use case: nộp hồ sơ ứng tuyển và xử lý hồ sơ

Actor và mục đích​

ActorMục đích
Ứng viênNộp CV cho một tin và xem kết quả phân tích
HRXem, đánh giá, đổi trạng thái hồ sơ của công ty mình
Quản trị viênXem và xử lý mọi hồ sơ
Hệ thốngĐọc CV, chấm điểm, gửi thông báo

Precondition và postcondition​

Giá trị
PreconditionĐã đăng nhập; tin tồn tại (và, với đường file, đang hoạt động khi phân tích); chưa nộp cho tin này; với CV trực tuyến, CV đang bật
PostconditionCó bản ghi resumes PENDING; đã hoặc sẽ có điểm và mức ưu tiên; HR nhận thông báo

Luồng chính A: CV trực tuyến​

Ứng viên đã tạo CV (xem cv-management) gửi POST /resumes/cv-online. Hệ thống chấm điểm ngay và trả kết quả. Sơ đồ: cv-processing.

Luồng chính B: tải file CV​

Ứng viên gửi POST /resumes/upload-cv (file pdf, doc, docx hoặc txt, tối đa 5 MB, và jobId). Hệ thống lưu hồ sơ, đưa việc đọc và phân tích vào hàng đợi, trả processing. Kết quả xem qua GET /resumes/:id/analysis. Sơ đồ: cv-processing.

Xử lý bởi nhà tuyển dụng​

  1. HR hoặc quản trị viên xem danh sách (GET /resumes, HR chỉ thấy công ty mình), lọc và sắp xếp theo điểm hoặc mức ưu tiên.
  2. Đổi trạng thái qua PATCH /resumes/:id (PENDING, REVIEWING, INTERVIEWING, APPROVED, REJECTED), có thể ghi hrNotes.
  3. Mỗi lần đổi ghi histories và gửi thông báo, email cho ứng viên (resume-status).
  4. Có thể gọi reparse hoặc reanalyze để xử lý lại.

Luồng lỗi​

Tình huốngKết quả
Nộp trùng cho cùng tinTừ chối
CV trực tuyến bị tắtTừ chối "Your CV profile is inactive"
File không hợp lệ hoặc quá lớn400
Văn bản CV quá ngắn, quá dài, ít từGhi parseError, retry theo hàng đợi
Hết quota GeminiHoãn việc đọc, không báo lỗi cho ứng viên
HR thao tác hồ sơ công ty khác403
Vượt giới hạn nộp429 (10 lần mỗi 5 phút cho CV trực tuyến, 20 lần mỗi giờ cho file)

Quy tắc nghiệp vụ​

Điểm 50% kỹ năng, 30% kinh nghiệm, 20% học vấn; ngưỡng ưu tiên 85, 70, 50. Chi tiết và giới hạn: cv-parsing-and-matching. Điểm chỉ ảnh hưởng priority, không tự đổi status.

Edge case​

  • Điểm có thể bị thổi phồng bởi khớp kỹ năng bằng chuỗi con (Java và JavaScript): known limitation.
  • Phân tích có thể chạy hai lần cho đường file.
  • HR không xem được GET /resumes/:id/analysis (chỉ chủ hồ sơ hoặc quản trị viên).
  • Bản sao CV tại thời điểm nộp không đổi khi ứng viên sửa CV sau đó.