Module Jobs
Overview
Quản lý tin tuyển dụng nội bộ: tạo, sửa, xóa, duyệt, lọc theo quyền xem, tự hết hạn, và cung cấp dữ liệu cho chat và thống kê.
Responsibilities
- CRUD tin với chuẩn hóa kỹ năng và địa điểm.
- Quyết định ai xem được tin nào.
- Duyệt hoặc từ chối tin (quản trị viên).
- Cron tắt tin hết hạn và thông báo.
- Đưa việc thông báo "tin mới" cho người theo dõi công ty vào hàng đợi.
Architecture
| Thành phần | File |
|---|---|
Controller (7 route, /api/v1/jobs) | jobs.controller.ts |
| Service | jobs.service.ts |
| Repository | job.repository.ts |
| Quy tắc hiển thị | job-visibility.util.ts |
| Enum | EJobLevel, EJobFormOfWork, EJobApprovalStatus trong enums/ |
Dependencies
Import queues (đưa việc vào hàng đợi), skills (chuẩn hóa kỹ năng), statistics (xóa cache). companies cung cấp snapshot qua repository; resumes, chat, job-search đọc tin.
Business Rules
Đầy đủ ở jobs (collection) và business-rules. Tóm tắt:
- Tin mới
PENDING, công khai chỉ khiisActive,APPROVEDvà còn hạn. - HR chỉ thấy tin của công ty mình, quản trị viên thấy tất cả.
- Chỉ
SUPER ADMINđược duyệt; chỉ đặt đượcAPPROVEDhoặcREJECTEDvà không kiểm tra trạng thái trước, nên không quay lạiPENDING. - Kỹ năng và địa điểm được chuẩn hóa hoặc bị từ chối khi tạo và sửa.
- Mỗi lần tạo tin,
createluôn đưa một việc vào hàng đợicompany-follower-notification. Lỗi khi đưa vào hàng đợi chỉ được log, không làm thất bại việc tạo tin.
Data Model
Collection jobs, snapshot công ty nhúng.
API
7 route: POST, GET danh sách (@OptionalAuth), GET :id, PATCH :id, DELETE :id, DELETE bulk, PATCH :id/approve. Danh sách dùng thư viện api-query-params (aqp) để đọc bộ lọc và sắp xếp từ query string, sau đó lọc qua sanitizeAqpQuery để loại toán tử nguy hiểm. Chi tiết ở 05-api/endpoints/jobs.md (Phase 3).
Processing Flow
Sơ đồ trạng thái chi tiết sẽ nằm ở 06-workflows/state-machines/ (Phase 3).
Error Handling
404 khi không có tin, 400 với ID không hợp lệ hoặc kỹ năng/địa điểm không hợp lệ.
Known Limitation
- Sửa tin đã duyệt không đặt lại
PENDING. - Email "tin mới" gửi trước khi tin được duyệt. Hàng đợi được kích hoạt ngay trong
create, và company-follower-queue.processor.ts chỉ lọc người theo dõi (isActive, chưa xóa mềm), không kiểm traapprovalStatuscủa tin. Người theo dõi có thể nhận email về tin chưa được duyệt hoặc sau đó bị từ chối. Processor cũng nuốt lỗi gửi từng email (catchkhông ném lại), nên email lỗi không được retry. - Chi tiết và bằng chứng ở jobs (collection).
Testing
2 file test (jobs.service.spec.ts, job-visibility.util.spec.ts).