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

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

Actor và mục đích​

ActorMục đích
HRĐăng, sửa, xóa tin của công ty mình
Quản trị viênĐăng tin, duyệt hoặc từ chối tin, xem mọi tin
Khách và ứng viênXem tin đã duyệt, còn hạn

Precondition và postcondition​

Giá trị
PreconditionNgười đăng có vai trò HR hoặc SUPER ADMIN; công ty tồn tại; kỹ năng nằm trong danh mục; địa điểm hợp lệ
Postcondition tạo tinTin approvalStatus = PENDING, isActive theo yêu cầu; chưa hiển thị công khai
Postcondition duyệtapprovalStatus là APPROVED hoặc REJECTED, ghi người duyệt và thời điểm

Luồng chính​

  1. HR gửi POST /jobs (tên, kỹ năng, công ty, địa điểm, lương, số lượng, cấp bậc, hình thức, mô tả, ngày bắt đầu và kết thúc, isActive).
  2. Hệ thống chuẩn hóa kỹ năng theo danh mục, tạo snapshot công ty, suy ra địa điểm chuẩn hóa, lưu tin PENDING, xóa cache liên quan, đưa việc thông báo người theo dõi công ty vào hàng đợi.
  3. Quản trị viên xem tin (GET /jobs thấy mọi trạng thái) và gửi PATCH /jobs/:id/approve với APPROVED hoặc REJECTED kèm ghi chú tùy chọn.
  4. Tin APPROVED, isActive và còn hạn hiển thị cho công chúng và vào tìm kiếm hợp nhất.
  5. Khi quá endDate, cron mỗi giờ tắt tin và gửi email cho người tạo.

Luồng thay thế​

LuồngMô tả
Từ chốiREJECTED kèm approvalNote (tối đa 500 ký tự); tin không hiển thị công khai, HR vẫn thấy
Đổi quyết địnhQuản trị viên duyệt lại giữa APPROVED và REJECTED
HR sửa tin đã duyệtPATCH /jobs/:id; vẫn APPROVED, không qua duyệt lại
Xóa tinXóa mềm một hoặc hàng loạt

Luồng lỗi​

Tình huốngKết quả
Kỹ năng không có trong danh mục400 "Unknown skills: ..."
Địa điểm không hợp lệ400
endDate không sau startDate400 (validator IsAfter)
HR thao tác tin công ty khácBị từ chối theo kiểm tra sở hữu
Duyệt bởi vai trò khác403

Quy tắc nghiệp vụ​

business-rules, job-approval, jobs.

Edge case​

  • Email "tin mới" cho người theo dõi công ty được gửi lúc tạo tin, trước khi duyệt; tin bị từ chối vẫn có thể đã được báo (jobs).
  • Email gợi ý hằng tuần không lọc theo trạng thái duyệt (queues).
  • Tin hết hạn biến mất khỏi công khai ngay khi quá endDate, kể cả trước khi cron chạy, vì bộ lọc hiển thị cũng kiểm tra endDate.
  • Snapshot công ty trong tin không đổi khi công ty đổi tên.