Skip to content

Endpoint Jobs ​

Trang này liệt kê 7 endpoint quản lý tin tuyển dụng nội bộ trong job.api.ts: tạo, đọc, sửa, xóa, duyệt và xóa hàng loạt. Hai endpoint tìm kiếm hợp nhất nằm ở Endpoint Job Search. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao tách khỏi tìm kiếm ​

Hai nhóm phục vụ hai việc khác nhau. jobs là CRUD cho HR và quản trị, trả Job đầy đủ và nhận bộ lọc tự do. Tìm kiếm hợp nhất phục vụ người xem công khai, trả JobSearchItem rút gọn và gồm cả tin ngoài.

Bảng endpoint ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useGetJobsQueryGET /jobs?page=..&limit=..PaginatedQueryParams: page (mặc định 1), limit (10), filter, sort, keyword; xem Phân trang và lọcCung cấp Jobhome-page-client.tsx, (dashboard)/admin/jobs/page.tsx, features/company/components/section/job-listing.tsx
useGetJobQueryGET /jobs/:idid: stringCung cấp { Job, id }Hook chưa có nơi nào dùng; endpoint được gọi bằng jobApi.endpoints.getJob.initiate trong chat-message.utils.ts để lấy việc làm gợi ý của trợ lý AI. Trang chi tiết dùng fetchPublicJobById
useCreateJobMutationPOST /jobsCreateJobFormDataLàm mất hiệu lực Jobhooks/use-job.ts
useUpdateJobMutationPATCH /jobs/:id{ id, data: UpdateJobFormData }Làm mất hiệu lực { Job, id } và Jobhooks/use-job.ts
useDeleteJobMutationDELETE /jobs/:idid: stringLàm mất hiệu lực Jobhooks/use-job.ts
useApproveJobMutationPATCH /jobs/:id/approve{ id, data: ApproveJobFormData }: status (APPROVED hoặc REJECTED), approvalNoteLàm mất hiệu lực { Job, id } và Jobhooks/use-job.ts
useBulkDeleteJobsMutationDELETE /jobs/bulkstring[], gửi trong body dạng { ids }; kết quả IBulkDeleteResultLàm mất hiệu lực Job(dashboard)/admin/jobs/page.tsx

Hook useGetJobsQuery được dùng với ba kiểu lọc khác nhau:

Nơi gọifiltersortlimit
Trang chủisActive=truesort=-createdAt6 (getHomeJobsQuery trong home-query.ts)
Trang quản trị tinname=/<từ khóa>/i và isActive=<trạng thái> khi người dùng chọnKhôngTheo pageSize
Danh sách việc của công tyisActive=true, thêm company._id=<id>, name=/<từ khóa>/i và locationCode=<mã> khi cóKhông20

Đối chiếu với backend ​

Cả 7 route (POST /jobs, GET /jobs, GET /jobs/:id, PATCH /jobs/:id, DELETE /jobs/bulk, DELETE /jobs/:id, PATCH /jobs/:id/approve) có trong jobs.controller.ts. Chưa đối chiếu từng DTO.

WARNING

Ở backend, route DELETE /jobs/bulk phải khai báo trước DELETE /jobs/:id, nếu không bulk sẽ bị hiểu là một id. Controller hiện đặt bulk trước, đúng thứ tự.

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

Form tạo và sửa kiểm tra trước khi gửi bằng JobSchema; các quy tắc từng field xem Model Job. Form duyệt giới hạn approvalNote tối đa 500 ký tự.

Source code liên quan ​

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

Đọc tiếp: Model Job, Endpoint Job Search, Cache và invalidation.

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