Skip to content

Model Job ​

Trang này mô tả tin tuyển dụng nội bộ (do nhà tuyển dụng đăng trên DevLink) ở frontend. Dành cho developer cần biết field nào có, kiểu gì, và type nào là type chính. Tin lấy từ nguồn ngoài có model riêng, xem Model JobSearchItem.

Vì sao có nhiều định nghĩa ​

Tin tuyển dụng đi qua ba nơi: form tạo và sửa của HR, trang quản trị và trang công khai. Mỗi nơi cần một dạng khác nhau, nên frontend có schema cho form (JobSchema), schema cho bản ghi đầy đủ (JobEntitySchema) và một interface cũ (IJob).

DạngĐịnh nghĩaDùng ở
Bản ghi đầy đủJob suy ra từ JobEntitySchemagetJobs, getJob, fetchPublicJobById, trang quản trị, trang chi tiết
Dữ liệu formCreateJobFormData suy ra từ JobSchema; UpdateJobFormData là bản PartialForm tạo và sửa tin
Dữ liệu duyệtApproveJobFormData suy ra từ ApproveJobSchemaHộp thoại duyệt tin
Interface cũIJob trong src/shared/types/backend.d.tssrc/features/chatbot/lib/chat-message.utils.ts, chat.d.ts, thẻ việc làm trong chat

Type chính: Job.

Các field của Job ​

FieldKiểuBắt buộcÝ nghĩa nghiệp vụ
_idstringCóĐịnh danh tin
namestringCóTên vị trí, 1 đến 100 ký tự
skillsstring[]CóKỹ năng yêu cầu, ít nhất một
company{ _id, name, logo }CóCông ty đăng tin; logo có thể null
locationCodestringCóMã địa điểm chuẩn hóa
locationstringCóTên địa điểm hiển thị
salarynumberCóMức lương dạng số, không âm
quantitynumberCóSố lượng tuyển, tối thiểu 1
formOfWork'Full-time' | 'Part-time' | 'Internship' | 'Freelance' | 'Remote' | 'Hybrid' | 'Other'CóHình thức làm việc
level'Internship' | 'Junior' | 'Mid' | 'Senior' | 'Lead' | 'Manager'CóCấp bậc
descriptionstringCóMô tả công việc, tối thiểu 10 ký tự
startDate, endDatestringCóNgày bắt đầu và hết hạn nhận hồ sơ, phải là chuỗi ngày hợp lệ
isActivebooleanCóTin còn mở hay đã đóng
approvalStatus'PENDING' | 'APPROVED' | 'REJECTED'KhôngTrạng thái duyệt tin; mặc định PENDING
approvalNotestringKhôngGhi chú khi duyệt hoặc từ chối, tối đa 500 ký tự ở form duyệt
approvedBy{ _id, email }KhôngNgười duyệt
approvedAtstringKhôngThời điểm duyệt
createdBy, updatedBy{ _id, email }KhôngNgười tạo và người sửa gần nhất
createdAt, updatedAtstringKhôngThời điểm tạo và cập nhật

Trạng thái duyệt và cách chúng thay đổi nằm ở nhóm tài liệu trạng thái duyệt tin (Đợt 2).

Ví dụ JSON ​

Dữ liệu giả, theo JobEntitySchema:

json
{
  "_id": "665f1a2b3c4d5e6f70819310",
  "name": "Frontend Developer",
  "skills": ["React", "TypeScript"],
  "company": { "_id": "665f1a2b3c4d5e6f70819302", "name": "Công ty Mẫu", "logo": null },
  "locationCode": "HN",
  "location": "Hà Nội",
  "salary": 20000000,
  "quantity": 2,
  "formOfWork": "Full-time",
  "level": "Junior",
  "description": "Phát triển giao diện web cho sản phẩm tuyển dụng.",
  "startDate": "2026-01-01T00:00:00.000Z",
  "endDate": "2026-02-01T00:00:00.000Z",
  "isActive": true,
  "approvalStatus": "APPROVED"
}

Điểm chưa đồng nhất ​

Vấn đềChi tiết
IJob khác JobIJob không có formOfWork và updatedBy; createdBy là string, còn ở Job là { _id, email }; startDate, endDate là Date còn ở Job là string
Trường lạ trong IJobdeletedAt được khai báo kiểu boolean | null trong khi tên gợi ý là thời điểm
location ở formJobSchema (form) không có location, chỉ locationCode; location chỉ có ở bản ghi đầy đủ

Chưa có ghi chép về lý do của các khác biệt này. Chưa đối chiếu từng field với schema Mongoose của backend; xem tài liệu collection để biết field nào backend thực sự lưu.

Nơi dùng ​

Source code liên quan ​

Collection ở backend: jobs.

Đọc tiếp: Model JobSearchItem, Endpoint Jobs, Tham chiếu dữ liệu backend.

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