Skip to content

Duyệt tin tuyển dụng ​

Tính năng cho phép nhà tuyển dụng đăng tin và quản trị viên duyệt hoặc từ chối trước khi tin hiện công khai. Trang dành cho người đăng và người duyệt tin, và developer sửa trang quản trị tin.

Vì sao cần ​

Tin tuyển dụng hiện cho mọi người xem, nên cần một bước kiểm soát nội dung. Nhà tuyển dụng tự đăng, quản trị viên là người quyết định tin nào được hiển thị.

Đối tượng: HR và SUPER ADMIN (đăng, sửa, xóa tin); chỉ SUPER ADMIN được duyệt.

Đánh đổi: tin vừa đăng chưa hiện công khai cho tới khi được duyệt; sửa tin không đưa tin về trạng thái chờ duyệt, nên nội dung đã duyệt có thể bị sửa mà không cần duyệt lại.

Giao diện ​

Trang quản lý việc làm

Trang quản lý tin: ô tìm theo tên, bốn bộ lọc (trạng thái, địa điểm, mức lương, trạng thái duyệt) và bảng tin có cột duyệt, kèm các nút duyệt, sửa, xóa ở mỗi dòng.

Luồng nghiệp vụ ​

Sơ đồ rút gọn; các trạng thái chi tiết ở Trạng thái duyệt tin.

Chức năngHành vi
Đăng và sửa tinHộp thoại JobDialog dùng JobForm, kiểm tra bằng JobSchema
XóaXóa một tin (có xác nhận) hoặc xóa hàng loạt qua các hộp chọn
DuyệtNút duyệt chỉ hiện với SUPER ADMIN; hộp thoại chọn APPROVED hoặc REJECTED và nhập ghi chú tối đa 500 ký tự
Hiển thị kết quảCột "Duyệt" có huy hiệu theo trạng thái; ghi chú duyệt hiện dưới huy hiệu nếu có
LọcTheo tên, trạng thái hoạt động, địa điểm, mức lương và trạng thái duyệt

API liên quan ​

HookEndpointDùng ở
useGetJobsQueryGET /jobs(dashboard)/admin/jobs/page.tsx
useCreateJobMutation, useUpdateJobMutation, useDeleteJobMutationPOST /jobs, PATCH /jobs/:id, DELETE /jobs/:idhooks/use-job.ts
useApproveJobMutationPATCH /jobs/:id/approvehooks/use-job.ts
useBulkDeleteJobsMutationDELETE /jobs/bulk(dashboard)/admin/jobs/page.tsx

Bảng đầy đủ: Endpoint Jobs.

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

Dạng tin và các field duyệt (approvalStatus, approvalNote, approvedBy, approvedAt) ở Model Job.

Trường hợp lỗi ​

Tình huốngHành vi
Thao tác bị backend từ chốiToast với thông điệp của backend hoặc thông điệp dự phòng
HR muốn duyệtKhông có nút; backend cũng từ chối route duyệt
Ghi chú quá 500 ký tựÔ nhập giới hạn 500 ký tự

Test cases ​

Chưa có test cho hộp thoại duyệt, bảng tin quản trị và trang quản trị tin. Test của getJobStatus (nhãn "mới", "sắp hết hạn") nằm ở src/features/job/utils/job-status.test.ts.

Source code liên quan ​

Backend: Use case đăng và duyệt tin.

Đọc tiếp: Trạng thái duyệt tin, Trang quản trị, Dashboard HR.

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