Skip to content

Trạng thái hồ sơ ứng tuyển ​

Trang này mô tả các trạng thái của một hồ sơ ứng tuyển, ai được đổi trạng thái và giao diện hiển thị mỗi trạng thái thế nào. Dành cho người xử lý hồ sơ, và cho developer cần thêm hoặc sửa trạng thái.

Vì sao cần trạng thái ​

Ứng viên muốn biết hồ sơ của mình đang ở đâu; nhà tuyển dụng cần một cách đánh dấu hồ sơ đã xem hay chưa. Trạng thái là thông tin chung giữa hai phía: nhà tuyển dụng đổi, ứng viên nhìn thấy.

WARNING

Backend có 5 trạng thái, frontend chỉ biết 4. Trạng thái INTERVIEWING không có trong schema, form và danh sách lọc của frontend. Xem mục "Điểm lệch" bên dưới.

Sơ đồ ​

Sơ đồ vẽ luồng xử lý thông thường, không phải ràng buộc. Code không kiểm tra thứ tự: backend ghi trạng thái được gửi lên mà không so với trạng thái hiện tại, và form của frontend cho chọn bất kỳ trong 4 trạng thái, nên thực tế có thể chuyển từ trạng thái nào sang trạng thái nào cũng được.

Bảng trạng thái ​

Giá trịỞ frontendỞ backendÝ nghĩaHiển thị cho ứng viên (trang việc của tôi)
PENDINGCóCóVừa nộp, chưa xử lýNhãn "Đang chờ"
REVIEWINGCóCóĐang được xem xétNhãn "Đang xem xét"
INTERVIEWINGKhôngCóĐược mời phỏng vấnHiện nhãn "Từ chối" (xem bên dưới)
APPROVEDCóCóĐược chấp nhậnNhãn "Đã duyệt"
REJECTEDCóCóKhông được chọnNhãn "Từ chối"

Ai đổi trạng thái ​

Hành độngAiỞ đâu
Tạo hồ sơ (PENDING)Ứng viên đã đăng nhậpHộp thoại ứng tuyển, POST /resumes/upload-cv
Đổi trạng tháiHR, SUPER ADMINTrang quản trị hồ sơ, PATCH /resumes/:id với { status }

Backend từ chối HR đổi trạng thái của hồ sơ không thuộc công ty của họ (403). Mỗi lần đổi, backend ghi thêm một mục vào histories gồm trạng thái, thời điểm và người đổi.

Sau khi đổi, backend tạo thông báo trong hệ thống cho ứng viên và gửi email về trạng thái mới; email có nội dung riêng cho REVIEWING, INTERVIEWING, APPROVED và REJECTED.

Giao diện theo trạng thái ​

Màn hìnhCách xử lý
Bảng hồ sơ quản trị (resume-table.tsx)Màu theo trạng thái: xanh lá cho APPROVED, đỏ cho REJECTED, xanh dương cho REVIEWING, vàng cho PENDING, xám cho giá trị khác
Bộ lọc trang quản trịCó PENDING, REVIEWING, APPROVED, REJECTED
Form đổi trạng tháiChỉ các trạng thái của frontend
Trang việc của tôi (my-jobs-page.tsx)Chỉ phân biệt PENDING, REVIEWING, APPROVED; mọi giá trị còn lại đều hiện nhãn "Từ chối"
Thống kê (statisticsDashboard.statuses)Có chuỗi dịch cho INTERVIEWING ("Phỏng vấn" ở bản tiếng Việt)

Điểm lệch ​

Vấn đềChi tiếtHệ quả
INTERVIEWING có ở backend nhưng không có ở frontendEResumeStatus có 5 giá trị; schema Zod, form và bộ lọc của frontend có 4Quản trị không chọn được INTERVIEWING từ giao diện này
Trang việc của tôi xử lý giá trị lạ như từ chốiNhánh cuối của phép so sánh trả nhãn "Từ chối"Hồ sơ ở INTERVIEWING sẽ hiện nhãn "Từ chối" nếu được đặt bằng cách khác (ví dụ gọi API trực tiếp)
Kiểu statusResumeAppliedJob.status là stringKhông có kiểm tra kiểu cho giá trị mới

Chưa có ghi chép về lý do. Đây là chỗ frontend lệch backend; tài liệu ghi đúng hiện trạng và không sửa code.

Source code liên quan ​

Backend: Trạng thái hồ sơ, enum và service.

Đọc tiếp: Model Resume, Ứng tuyển công việc, Ứng tuyển (tính năng).

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