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

CV Parsing và Hybrid Matching

Overview​

Hai bước nối tiếp để biến một CV thành điểm phù hợp với một tin tuyển dụng:

  1. Đọc CV (parsing): lấy văn bản từ file, nhờ mô hình AI (Gemini) trích xuất thành dữ liệu có cấu trúc.
  2. Chấm điểm (matching): so dữ liệu đó với yêu cầu của tin bằng công thức do code quy định, không phải do AI chấm.

"Hybrid" ở đây nghĩa là AI chỉ làm phần khó với ngôn ngữ tự nhiên (đọc CV), còn điểm số và mức ưu tiên là kết quả tất định, cùng đầu vào luôn cho cùng điểm. Nguyên tắc này khớp với AGENTS.md: AI hỗ trợ, backend sở hữu quy tắc cuối cùng.

Sơ đồ trình tự: cv-processing. Dữ liệu lưu: resumes.

Điểm phù hợp là chỉ báo hỗ trợ, không phải đánh giá khách quan về ứng viên. Nó chỉ so khớp những gì ứng viên khai trong CV với yêu cầu của tin, và có các giới hạn nêu ở mục Known Limitation.

Responsibilities​

Thành phầnFileTrách nhiệm
Lấy văn bảncv-parser.service.tsPDF, DOC, DOCX, TXT sang văn bản; kiểm tra; làm sạch
Đọc bằng AIgemini.service.ts, ai.service.tsGửi văn bản cho Gemini, nhận JSON
Chuẩn hóa kỹ năngskills.service.tsGhép kỹ năng với danh mục, giữ phần không khớp
Chấm điểmmatching.service.ts và matching/utils/Công thức điểm, ưu tiên, nhận xét
Điều phối bất đồng bộresume-queue.processor.tsChạy hai việc parse-resume và analyze-resume
Giữ quota Geminigemini-quota.service.tsChống vượt hạn mức gọi Gemini

Bước 1: đọc CV​

Trích văn bản​

Định dạngThư viện
.pdfpdf-parse (lớp PDFParse)
.doc, .docxmammoth (extractRawText)
.txtĐọc UTF-8
KhácLỗi Unsupported file type

Sau đó văn bản bị từ chối nếu: dưới 100 ký tự, trên 50.000 ký tự, hoặc dưới 50 từ (validateExtractedText). Văn bản hợp lệ được làm sạch (cleanText).

Trích xuất bằng AI​

GeminiService.parseCV gửi văn bản đã làm sạch cho Gemini với cấu hình responseMimeType: application/json, nhiệt độ và giới hạn token cố định trong code, rồi JSON.parse kết quả theo ParsedDataDto. Mô hình mặc định là gemini-3.1-flash-lite, đổi bằng GEMINI_MODEL. Mọi lần gọi đi qua bộ giữ quota và có retry với backoff khi gặp lỗi giới hạn tốc độ (gemini.service.ts).

Chuẩn hóa kỹ năng​

Kỹ năng AI trả về được đưa qua SkillsService.normalizeExtractedSkills: kỹ năng khớp danh mục vào normalizedSkills, kỹ năng không khớp vào unmappedSkills (không gây lỗi). Hai trường này nằm trong resumes.parsedData (resumes).

Giữ quota Gemini​

Mọi lần gọi Gemini phải "đặt chỗ" quota trong Redis bằng script Lua nguyên tử (gemini-quota.service.ts):

Tham sốMặc địnhNguồn
Giới hạn mỗi phút15DEFAULT_GEMINI_RPM
Ngân sách mỗi ngày450DEFAULT_GEMINI_DAILY_BUDGET, đổi bằng GEMINI_DAILY_BUDGET
Ngưỡng cảnh báo ngày70%, 85%, 95%DEFAULT_GEMINI_DAILY_ALERT_THRESHOLDS

Ba loại công việc dùng chung hạn mức, và mỗi loại chừa một phần cho loại ưu tiên hơn: một yêu cầu chỉ được cấp khi đã dùng + đơn vị ≤ giới hạn − phần chừa.

LoạiChừa mỗi phútChừa mỗi ngàyÝ nghĩa
parse (đọc CV)00Được dùng hết hạn mức: ưu tiên cao nhất
chat-fallback225Chat dự phòng nhường chỗ cho đọc CV
summary450Tóm tắt nhường chỗ nhiều nhất

Khi bị từ chối, GeminiQuotaDeniedException mang scope (minute hoặc day) và retryAfterMs. Processor không coi đây là lỗi: nó lên lịch lại việc parse-resume với độ trễ đó (cộng nhiễu ngẫu nhiên GEMINI_QUOTA_RETRY_JITTER_MS) rồi kết thúc việc hiện tại thành công với delayed: true.

Bước 2: chấm điểm​

MatchingService.calculateMatch(parsedData, job) (matching.service.ts):

tổng = kỹ năng × 0,5 + kinh nghiệm × 0,3 + học vấn × 0,2 (giới hạn 0 đến 100, làm tròn)

Mỗi thành phần có điểm 0 đến 100. Hàm ensureValidScore thay giá trị không hợp lệ (NaN) bằng 0 trước khi nhân trọng số.

Điểm kỹ năng (trọng số 50%)​

  1. Chuẩn hóa mỗi kỹ năng thành chữ hoa, bỏ ký tự đặc biệt trừ + và #, rồi quy về nhãn chuẩn bằng bản đồ bí danh của danh mục.
  2. Một kỹ năng yêu cầu được coi là khớp nếu một kỹ năng của ứng viên bằng nó, hoặc chứa nó, hoặc được nó chứa (so chuỗi con, isSkillMatch).
  3. Mỗi kỹ năng khớp được điểm theo mức thành thạo: expert 100, advanced 85, intermediate 70, beginner 50. Mức được suy từ từ khóa trong chính chuỗi kỹ năng của CV (ví dụ "expert NestJS", "advanced NestJS", "proficient"), và mặc định là intermediate.
  4. Điểm kỹ năng = tổng điểm các kỹ năng khớp ÷ (số kỹ năng yêu cầu × 100).

Điểm kinh nghiệm (trọng số 30%)​

Theo số năm kinh nghiệm so với bảng của từng cấp bậc (matching.constants.ts):

Cấp bậcTối thiểuLý tưởngTối đa
Internship001
Junior123
Mid235
Senior4610
Lead5815
Manager61020
VùngĐiểm
Dưới mức tối thiểunăm ÷ tối thiểu × 50 (tối đa 50). Internship với 0 năm được 100
Từ tối thiểu đến lý tưởngNội suy từ 50 đến 100
Từ lý tưởng đến tối đa100
Vượt tối đaGiảm 2 điểm mỗi năm thừa, tối đa 15, sàn 85
Cấp bậc không có trong bảng50

Điểm học vấn (trọng số 20%)​

Suy từ chuỗi degree của từng mục học vấn: có chứa phd/tiến sĩ, master/thạc sĩ, hoặc bachelor/cử nhân/đại học. Không có dữ liệu học vấn: 50. Điểm theo cấp bậc:

Cấp bậcCó tiến sĩ hoặc thạc sĩCó cử nhânKhông có bằng nào nhận ra
Internship10010075
Junior10010060
Mid1009050
Senior1008040
Lead, Manager1007030

Mức ưu tiên và khuyến nghị​

Tổng điểmpriorityKhuyến nghị (recommendation)
≥ 85EXCELLENTHIGHLY_RECOMMENDED
≥ 70HIGHRECOMMENDED
≥ 50MEDIUMCONSIDER
còn lạiLOWNOT_RECOMMENDED

strengths, weaknesses, summary do các hàm sinh nhận xét từ kết quả trên (insight-generator.util.ts). Đây là văn bản mẫu từ quy tắc, không phải văn bản do AI viết.

Trạng thái tự động (đang tắt)​

determineAutoStatus đề xuất APPROVED (tổng ≥ 85 và điểm kỹ năng ≥ 70), REJECTED (tổng < 30 và điểm kỹ năng < 30), còn lại REVIEWING. Giá trị này có trong kết quả, nhưng dòng gán status ở processor đang bị comment, nên điểm không tự đổi trạng thái hồ sơ.

Xử lý dữ liệu thiếu​

Thiếu gìHành vi
Kỹ năngDanh sách rỗng, điểm kỹ năng 0 nếu tin có yêu cầu
Số năm kinh nghiệmMặc định 0
Học vấnĐiểm học vấn 50 (trung tính)
Tin không có kỹ năng yêu cầuĐiểm kỹ năng 0 (không chia cho 0)
Cấp bậc không nhận raĐiểm kinh nghiệm và học vấn 50

Known Limitation​

Khớp kỹ năng bằng chuỗi con tạo khớp sai. Đã chạy hàm thật calculateSkillsMatch (2026-11-05, bản đồ bí danh rỗng):

CV cóTin yêu cầuKết quảNhận xét
JavaScriptJavaKhớp, 70 điểmHai ngôn ngữ khác nhau
JavaJavaScriptKhớp, 70 điểmNhư trên
ReactCKhớp, 70 điểmChuỗi C nằm trong REACT
GoMongoDBKhớp, 70 điểmChuỗi GO nằm trong MONGODB
TypeScriptScriptKhớp, 70 điểm
PostgreSQLSQLKhớp, 70 điểmCó thể chấp nhận
Node.js / PythonJavaKhông khớpĐúng

Hệ quả: điểm kỹ năng có thể bị thổi phồng với các kỹ năng có tên ngắn hoặc là chuỗi con của kỹ năng khác. Trong vận hành, bản đồ bí danh đưa kỹ năng về nhãn chuẩn trước khi so, nhưng hai nhãn chuẩn khác nhau vẫn có thể là chuỗi con của nhau (như Java và JavaScript). Mức ảnh hưởng thực tế phụ thuộc danh mục; chưa đo trên dữ liệu thật.

Điểm kỹ năng bị chặn ở mức thực tế 70%. Vì mức thành thạo mặc định là intermediate (70) và chỉ nâng khi CV chứa các từ như "expert" hoặc "advanced" ngay trong chuỗi kỹ năng, một CV khớp mọi kỹ năng nhưng không có từ khóa mức độ chỉ đạt 70% điểm kỹ năng (đã xác nhận: khớp 1 trên 1 cho 70). Khi đó tổng điểm tối đa thực tế là 70 × 0,5 + 100 × 0,3 + 100 × 0,2 = 85, đúng bằng ngưỡng EXCELLENT. Tức là chỉ CV hoàn hảo ở cả kinh nghiệm và học vấn mới đạt EXCELLENT. Đây là hệ quả của cách suy mức thành thạo, không phải ý định được ghi trong code.

Khác:

  • Học vấn chỉ nhận ra qua từ khóa trong degree (tiếng Anh và tiếng Việt), bằng cấp ghi cách khác bị coi là không có bằng.
  • yearsOfExperience do AI trích xuất (đường tải file) hoặc được calculateYearsOfExperience tính từ các mục kinh nghiệm của CV trực tuyến; không đường nào đối chiếu với nguồn bên ngoài.
  • Việc đọc CV gửi toàn bộ văn bản CV (dữ liệu cá nhân) cho Google Gemini, một bên thứ ba. Chính sách lưu và sử dụng dữ liệu của bên đó nằm ngoài repository.
  • Nội dung CV có thể ghi vào log. Processor gọi this.logger.log('cleanedText:', cleanedText) ở bước làm sạch (resume-queue.processor.ts). Văn bản đầy đủ của CV (họ tên, điện thoại, email, địa chỉ) có thể xuất hiện trong log ứng dụng. Đã đọc mã; chưa kiểm tra đầu ra log thực tế. Xem 08-security (Phase 4).
  • Một lần nộp bằng file có thể kích hoạt phân tích hai lần (xem queues).
  • Các hàm chấm điểm không có chuẩn đối chiếu độc lập (ground truth); chất lượng so với đánh giá của con người chưa được đo.

Testing​

Thành phầnFile test
GeminiQuotaServicegemini-quota.service.spec.ts
AIServiceai.service.spec.ts
GroqServicegroq.service.spec.ts
ResumeQueueServiceresume-queue.service.spec.ts

src/matching/ và src/cv-parser/ không có file test nào (đã kiểm tra bằng find ... -name '*.spec.ts'). Toàn bộ công thức chấm điểm, khớp kỹ năng, điểm kinh nghiệm và học vấn, cùng việc trích văn bản và kiểm tra văn bản CV, chưa có kiểm thử đơn vị trong repository. Các kết quả thực nghiệm ở mục trên chỉ là phép chạy thủ công một lần, không phải test tự động. Processor resume-queue.processor.ts cũng không có test. Phần thống kê test nằm ở 10-testing (Phase 4).

Source References​

src/cv-parser/, src/matching/, src/gemini/, src/ai/, resume-queue.processor.ts.