Skip to content

Endpoint Resumes ​

Trang này liệt kê 8 endpoint hồ sơ ứng tuyển trong resume.api.ts: nộp hồ sơ, xem danh sách việc đã ứng tuyển, và các thao tác quản trị. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao cần xem kỹ ​

Nhóm này chia làm hai phía rất khác nhau. Ứng viên chỉ nộp hồ sơ và xem việc mình đã nộp. Nhà tuyển dụng và quản trị xem, đổi trạng thái và xóa hồ sơ. Backend giới hạn quyền ở route, nên cùng một file API phục vụ hai nhóm người dùng với quyền khác nhau.

Bảng endpoint ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useGetResumesQueryGET /resumes?page=..&limit=..&populate=companyId,jobId&fields=companyId.name,jobId.namePaginatedQueryParams: page (1), limit (10), filter, sort; populate và fields được frontend cố địnhCung cấp Resume(dashboard)/admin/resumes/page.tsx
useGetResumeQueryGET /resumes/:idid: stringCung cấp { Resume, id }Chưa có nơi nào dùng
useCreateResumeMutationPOST /resumesCreateResumeFormData: url, companyId, jobIdLàm mất hiệu lực Resumehooks/use-resume.ts khai báo, nhưng handleSubmit chỉ gọi cập nhật
useCreateResumeWithUploadMutationPOST /resumes/upload-cvFormData gồm file và jobIdLàm mất hiệu lực Resumecomponents/modals/apply-modal.tsx
useUpdateResumeMutationPATCH /resumes/:id{ id, data: { status } }Làm mất hiệu lực { Resume, id } và Resumehooks/use-resume.ts
useDeleteResumeMutationDELETE /resumes/:idid: stringLàm mất hiệu lực Resumehooks/use-resume.ts
useTakeOutAppliedJobMutationPOST /resumes/by-userKhông gửi gì; tham số string của hook bị bỏ quaLàm mất hiệu lực Resumeprofile/pages/my-jobs-page.tsx, profile/pages/overview-page.tsx
useBulkDeleteResumesMutationDELETE /resumes/bulkstring[], gửi trong body dạng { ids }Làm mất hiệu lực Resume(dashboard)/admin/resumes/page.tsx

Lấy danh sách việc đã ứng tuyển dùng một mutation (POST) vì backend khai báo route đó là POST. Hệ quả là kết quả không được cache như một truy vấn; my-jobs-page và overview-page tự giữ kết quả trong state của component.

Đối chiếu với backend ​

Cả 8 route có trong resumes.controller.ts. Theo controller:

RouteAi được gọi
POST /resumes/upload-cv, POST /resumes/by-userMọi người dùng đã đăng nhập
POST /resumes, GET /resumes, GET /resumes/:id, PATCH /resumes/:id, DELETE /resumes/:id, DELETE /resumes/bulkChỉ SUPER ADMIN và HR

Một số điểm cần lưu ý:

ĐiểmChi tiết
Giới hạn tốc độupload-cv được giới hạn 20 lần mỗi giờ
Loại fileBackend chấp nhận pdf, doc, docx, txt theo phần mở rộng, tối đa 5 MB; frontend kiểm tra theo MIME và chỉ cho pdf, doc, docx
Xử lý sau khi nộpBackend đưa CV vào hàng đợi xử lý rồi báo cho nhà tuyển dụng; phản hồi là thông điệp "đã đưa vào hàng đợi"
HR đổi trạng tháiBackend từ chối với 403 nếu hồ sơ không thuộc công ty của HR
Route frontend không gọiPOST /resumes/my-resumes, POST /resumes/cv-online, GET /resumes/:id/analysis, POST /resumes/:id/reparse, POST /resumes/:id/reanalyze

Dữ liệu và kiểm tra ​

Hộp thoại ứng tuyển chỉ kiểm tra file (loại và dung lượng); các ô họ tên, số điện thoại và email chỉ hiển thị, không được gửi lên. Xem Ứng tuyển công việc.

Source code liên quan ​

Hợp đồng đầy đủ: API Resumes của backend và controller.

Đọc tiếp: Model Resume, Ứng tuyển công việc, Cache và invalidation.

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