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

Jobs (jobs)

Tin tuyển dụng nội bộ do HR hoặc quản trị viên đăng. Tin lấy từ nguồn bên ngoài nằm ở collection riêng external-jobs. Tìm kiếm hợp nhất ghép hai collection này.

  • Nguồn schema: job.schema.ts
  • Phân loại dữ liệu: thông tin tuyển dụng công khai, cộng thêm createdBy và approvedBy chứa email người dùng.
  • Soft-delete: có.

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
nameStringCó—trimTên vị trí tuyển dụng
skills[Mixed]Có——Danh sách tên kỹ năng yêu cầu
companySubdocCó——Snapshot công ty đăng tin. Embedded
company._idObjectIdCó——_id công ty gốc
company.nameStringCó—trimTên công ty tại thời điểm lưu
company.logoStringKhôngnulltrimLogo công ty tại thời điểm lưu
locationStringCó—trimTên địa điểm làm việc
locationCodeStringCó—lowercase; trimMã địa điểm đã chuẩn hóa, chữ thường, dùng để lọc
salaryNumberCó—trimMức lương (số). Đơn vị không được ghi trong schema
quantityNumberCó——Số lượng cần tuyển
levelStringCó—enum: Manager, Lead, Senior, Mid, Junior, Internship; trimCấp bậc yêu cầu
formOfWorkStringKhông—enum: Other, Hybrid, Remote, Internship, Freelance, Part-time, Full-time; trimHình thức làm việc
descriptionStringKhông——Mô tả công việc, nội dung dạng văn bản hoặc HTML
startDateDateKhông——Ngày bắt đầu nhận hồ sơ
endDateDateKhông——Hạn nhận hồ sơ. Quá hạn thì cron đặt isActive = false
isActiveBooleanCótrue—Tin còn mở. false khi hết hạn hoặc bị tắt
approvalStatusStringCó"PENDING"enum: REJECTED, APPROVED, PENDINGTrạng thái duyệt của quản trị viên. Mặc định PENDING
approvalNoteStringKhông——Ghi chú của người duyệt
approvedByMixedKhông——Người duyệt, dạng { _id, email }
approvedAtDateKhông——Thời điểm duyệt
createdByMixedKhông——Người tạo bản ghi, dạng { _id, email }
updatedByMixedKhông——Người sửa gần nhất, dạng { _id, email }
deletedByMixedKhông——Người xóa mềm, dạng { _id, email }
createdAtDateKhông——Thời điểm tạo, do timestamps hoặc plugin
updatedAtDateKhông——Thời điểm sửa gần nhất, do timestamps
isDeletedBooleanKhông——Cờ xóa mềm. true nghĩa là bản ghi đã bị xóa khỏi nghiệp vụ nhưng vẫn còn trong database
deletedAtDateKhông——Thời điểm xóa mềm

Hai điểm khai báo kiểu cần lưu ý:

  • skills khai báo string[] không có type tường minh, nên Mongoose suy ra mảng Mixed. Giá trị được chuẩn hóa chuỗi trước khi lưu bởi SkillsService.normalizeControlledSkills (jobs.service.ts), không phải bởi schema.
  • salary có trim: true nhưng kiểu là Number, nên trim không có tác dụng.

Indexes​

KeysThuộc tínhMục đích
{ company._id: 1, isActive: 1, isDeleted: 1 }—Liệt kê tin đang mở của một công ty
{ isActive: 1, endDate: 1, isDeleted: 1 }—Cron tìm tin hết hạn
{ approvalStatus: 1, isActive: 1, isDeleted: 1, endDate: 1, company._id: 1 }—Truy vấn công khai: tin đã duyệt, đang mở, còn hạn, theo công ty
{ approvalStatus: 1, isActive: 1, createdAt: -1, isDeleted: 1, endDate: 1 }—Trang chủ: tin công khai, mới nhất trước. isDeleted đứng sau createdAt vì plugin xóa mềm lọc bằng $ne
{ skills: 1 }—Lọc theo kỹ năng
{ level: 1 }—Lọc theo cấp bậc
{ location: 1 }—Lọc theo tên địa điểm
{ locationCode: 1 }—Lọc theo mã địa điểm
{ createdAt: -1 }—Sắp xếp mới nhất trước
{ name: 1 }—Sắp xếp và lọc theo tên
{ company.name: 1 }—Lọc theo tên công ty

Collection có 11 index sau Phase 3a. Các index trùng tiền tố và text index không dùng đã bị xóa, xem báo cáo Phase 3a (docs/review-code/phase-3-index-audit.md, chỉ có trên máy, không nằm trong git).

Quan hệ​

FieldLoạiĐích
companyEmbedded (CompanySnapshot)Bản sao _id, name, logo của công ty, xem companies
skillsChuỗi tên, không phải tham chiếuTên kỹ năng khớp danh mục skills

Snapshot công ty được tạo khi tạo tin, và khi cập nhật tin có gửi company._id mới (getCompanySnapshot).

Quy tắc nghiệp vụ​

Duyệt tin. Tin mới có approvalStatus mặc định PENDING. PATCH /jobs/:id/approve của SUPER ADMIN đặt approvalStatus, approvalNote, approvedBy, approvedAt (jobs.service.ts). Code không kiểm tra trạng thái hiện tại, nên APPROVED sang REJECTED và ngược lại đều được chấp nhận; tuy vậy ApproveJobDto chỉ nhận APPROVED hoặc REJECTED, nên không thể quay về PENDING (xem job-approval).

Ai thấy tin nào (findAll):

Người gọiThấy
Khách hoặc NORMAL USERTin isActive, APPROVED, chưa quá endDate hoặc không có endDate
HR có công tyMọi tin của công ty mình, mọi trạng thái
SUPER ADMINTất cả

Hết hạn. Cron deactivate-expired-jobs chạy mỗi giờ (Asia/Ho_Chi_Minh), đặt isActive = false cho tin có endDate đã qua và xóa cache liên quan. Sau đó, với mỗi tin có createdBy.email, cron đưa một việc vào hàng đợi job-expiration-notification để báo cho người tạo tin (xem data-flow).

Ví dụ document​

{
"_id": "665f1a2b3c4d5e6f70819301",
"name": "Senior Backend Engineer",
"skills": ["Node.js", "MongoDB"],
"company": { "_id": "665f1a2b3c4d5e6f70819901", "name": "Example Software Co.", "logo": "images/company/example-logo.png" },
"location": "Ho Chi Minh",
"locationCode": "ho-chi-minh",
"salary": 3000,
"quantity": 2,
"level": "Senior",
"formOfWork": "Full-time",
"description": "<p>Build and operate APIs.</p>",
"startDate": "2026-10-01T00:00:00.000Z",
"endDate": "2026-12-31T00:00:00.000Z",
"isActive": true,
"approvalStatus": "APPROVED",
"approvedBy": { "_id": "665f1a2b3c4d5e6f70819202", "email": "admin@example.com" },
"isDeleted": false
}

Đơn vị tiền của salary không được ghi trong schema. Trạng thái: Chưa xác minh.

Lưu ý​

  • Known Limitation: sửa tin không đặt lại approvalStatus về PENDING. UpdateJobDto mở rộng CreateJobDto và không chứa approvalStatus, cộng với ValidationPipe({ whitelist: true }) nên client không tự đổi được trạng thái duyệt qua API sửa tin. Nhưng nội dung tin đã duyệt có thể được HR sửa mà không qua duyệt lại. Đã đọc update trong jobs.service.ts và grep DTO.
  • Sơ đồ vòng đời duyệt: job-approval. Duyệt không có lịch sử, chỉ lần duyệt cuối được giữ.