Chuyển tới nội dung chính

State machine: trạng thái hồ sơ ứng tuyển (resumes.status)

Giá trị enum EResumeStatus: PENDING, REVIEWING, INTERVIEWING, APPROVED, REJECTED.

Điều quan trọng nhất: code không ép thứ tự chuyển​

ResumesService.update đặt status bằng giá trị gửi lên mà không kiểm tra trạng thái hiện tại (resumes.service.ts). Mọi chuyển đổi giữa năm trạng thái đều được chấp nhận, kể cả quay lại PENDING hay từ REJECTED sang APPROVED. Vì vậy sơ đồ dưới đây mô tả luồng dự kiến theo tên trạng thái, không phải ràng buộc được thực thi.

Chỉ mũi tên [*] → PENDING do code tạo ra. Các mũi tên còn lại là luồng hợp lý theo ý nghĩa tên gọi; mọi cặp trạng thái khác cũng hợp lệ về mặt kỹ thuật.

Điều code thực sự làm​

Sự kiệnHành viNơi thực hiện
Nộp hồ sơ (cv-online, upload-cv, create)status = PENDING, histories có một phần tử PENDINGcreate, application-submission.service.ts
PATCH /resumes/:id có statusGhi status mới, $push vào histories (status, updatedAt, updatedBy)update
Sau khi đổi statusGửi thông báo cho ứng viên bất đồng bộ; lỗi chỉ logsendStatusChangeNotification
Chấm điểm xongChỉ đổi priority; không đổi statushandleAnalyzeResume (dòng gán status bị comment)

Ai được đổi: HR (hồ sơ công ty mình) và SUPER ADMIN. Ứng viên không đổi được trạng thái hồ sơ của chính mình.

Edge case​

Tình huốngHành vi
Đổi sang cùng trạng thái hiện tạiVẫn ghi thêm một phần tử histories và gửi thông báo
Hai người đổi cùng lúcKhông có khóa lạc quan; lần ghi sau thắng, histories có cả hai
histories tăngKhông có giới hạn kích thước
Hồ sơ bị xóa mềmKhông thuộc các trạng thái này; xem resumes

Known Limitation​

  • Không có kiểm tra chuyển trạng thái (xem trên). Muốn bảo đảm luồng, cần thêm bảng chuyển hợp lệ trong update.
  • Trạng thái tự động theo điểm đã có hàm nhưng đang tắt (resumes).