Skip to content

Model Resume ​

Trang này mô tả hồ sơ ứng tuyển (resume) ở frontend: bản ghi mà nhà tuyển dụng và quản trị xem, kết quả khi ứng viên nộp hồ sơ và dạng "việc đã ứng tuyển" trong trang cá nhân. Dành cho developer cần biết field nào có, và chỗ nào frontend lệch với backend.

Vì sao có nhiều dạng ​

Cùng một hồ sơ được nhìn bởi ba đối tượng. Nhà tuyển dụng cần bản đầy đủ có lịch sử đổi trạng thái và điểm phân tích. Ứng viên chỉ cần biết mình đã nộp vào việc nào và trạng thái hiện tại. Lúc vừa nộp, backend trả một bản rút gọn.

DạngĐịnh nghĩaDùng ở
Bản ghi đầy đủResume suy ra từ ResumeEntitySchemagetResumes, trang quản trị hồ sơ
Phản hồi sau khi nộpResumeResponseUpload suy ra từ ResumeAppliedJobEntitySchemacreateResumeWithUpload
Việc đã ứng tuyểnResumeAppliedJobtakeOutAppliedJob, trang việc của tôi
Dữ liệu formCreateResumeFormData: url, companyId, jobId; UpdateResumeFormData: statusForm quản trị, createResume, updateResume
Interface cũIResume trong src/shared/types/backend.d.tsXem mục "Điểm chưa đồng nhất"

Type chính: Resume.

Các field của Resume ​

FieldKiểuBắt buộcÝ nghĩa nghiệp vụ
_idstringCóĐịnh danh hồ sơ
emailstringCóEmail ứng viên
userIdstringCóỨng viên đã nộp
urlstringCóĐường dẫn tới file CV
status'PENDING' | 'REVIEWING' | 'APPROVED' | 'REJECTED'CóTrạng thái xử lý; xem Trạng thái hồ sơ
companyIdstring | { _id, name }KhôngCông ty nhận hồ sơ; là đối tượng khi backend đã populate
jobIdstring | { _id, name }KhôngTin ứng tuyển; là đối tượng khi đã populate
histories{ status, updatedAt, updatedBy: { _id, email } }[]CóLịch sử đổi trạng thái
aiAnalysis{ matchingScore: number }KhôngĐiểm phù hợp do backend phân tích
priority'HIGH' | 'MEDIUM' | 'LOW' | 'EXCELLENT'KhôngMức ưu tiên
createdBy, updatedBy{ _id, email }KhôngNgười tạo và người cập nhật gần nhất
createdAt, updatedAtstringKhôngThời điểm tạo và cập nhật

Việc đã ứng tuyển (ResumeAppliedJob) ​

FieldKiểuÝ nghĩa nghiệp vụ
jobId{ _id, name, location, salary }Tin đã nộp vào
companyId{ _id, name }Công ty; trang việc của tôi còn đọc thêm logo từ đây dù type không khai báo
statusstringTrạng thái hồ sơ, giữ kiểu chuỗi thay vì danh sách giá trị
createdAtstringThời điểm nộp

Ví dụ JSON ​

Dữ liệu giả, theo ResumeEntitySchema:

json
{
  "_id": "665f1a2b3c4d5e6f70819330",
  "email": "a@example.com",
  "userId": "665f1a2b3c4d5e6f70819301",
  "url": "cv-a-1760000000000.pdf",
  "status": "PENDING",
  "companyId": { "_id": "665f1a2b3c4d5e6f70819302", "name": "Công ty Mẫu" },
  "jobId": { "_id": "665f1a2b3c4d5e6f70819310", "name": "Frontend Developer" },
  "histories": [],
  "aiAnalysis": { "matchingScore": 78 },
  "priority": "HIGH"
}

Điểm chưa đồng nhất ​

Vấn đềChi tiết
Thiếu trạng thái INTERVIEWINGBackend (EResumeStatus) có 5 trạng thái, trong đó INTERVIEWING; schema Zod, form và trang quản trị ở frontend chỉ có 4
histories và historyResume dùng histories; IResume dùng history, kiểu thời gian là Date
IResume khác ResumeIResume bắt buộc jobId, companyId và có logo cho công ty; status kiểu string
ResumeResponseUploadSuy ra từ ResumeAppliedJobEntitySchema, có jobName, companyName và file, còn companyId kế thừa dạng đối tượng. Chưa đối chiếu với phản hồi thật của upload-cv
Giá trị priorityKhớp với EResumePriority của backend

Chưa có ghi chép về lý do của các khác biệt này.

Nơi dùng ​

Endpoint và hook: Endpoint Resumes. Luồng nộp: Ứng tuyển công việc.

Source code liên quan ​

Backend: collection resumes và enum trạng thái.

Đọc tiếp: Endpoint Resumes, Trạng thái hồ sơ, Tham chiếu dữ liệu backend.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code