Skip to content

Model JobSearchItem ​

Trang này mô tả hai model của tìm kiếm hợp nhất: JobSearchItem (một dòng trong danh sách kết quả, gồm tin nội bộ và tin từ nguồn ngoài) và ExternalJobDetail (chi tiết một tin nguồn ngoài). Dành cho developer cần biết từng field có ý nghĩa gì và frontend dùng nó thế nào.

Vì sao có model riêng ​

Danh sách /jobs trộn hai loại tin có nguồn gốc khác nhau: tin do nhà tuyển dụng đăng trên DevLink và tin DevLink lấy về từ các website khác. Hai loại có dữ liệu khác nhau (tin ngoài có salaryText, không có số lượng tuyển), nên backend trả về một dạng chung rút gọn. Từ dạng chung đó, frontend biết mở tin nào ở trang nào.

Type chính: JobSearchItem và ExternalJobDetail ở src/features/job/schemas/job-search.schema.ts. Đây là type TypeScript thuần, không có schema Zod kiểm tra lúc chạy.

Các field của JobSearchItem ​

FieldKiểuBắt buộcÝ nghĩa nghiệp vụ
idstringCóĐịnh danh trong kết quả, dùng để ghép đường dẫn chi tiết
sourceType'INTERNAL' | 'EXTERNAL'CóTin nội bộ hay tin từ nguồn ngoài; quyết định trang chi tiết và có nút lưu hay không
sourceKeystringKhôngMã nguồn dữ liệu bên ngoài
titlestringCóTiêu đề
companyNamestringCóTên công ty
companyLogostring | nullKhôngLogo công ty
locationstringCóĐịa điểm hiển thị
locationCodestringKhôngMã địa điểm chuẩn hóa
salarynumberKhôngLương dạng số, chủ yếu của tin nội bộ
salaryTextstringKhôngLương dạng văn bản, dùng cho tin ngoài
levelstringKhôngCấp bậc
formOfWorkstringKhôngHình thức làm việc
isRemotebooleanCóCó thuộc nhóm làm từ xa không
skillsstring[]CóKỹ năng
postedAtstringCóThời điểm đăng; dạng chuỗi vì đi qua JSON
endDatestring | nullKhôngHạn nhận hồ sơ
applyMode'INTERNAL' | 'EXTERNAL_REDIRECT'CóCách ứng tuyển do backend gợi ý
applyUrlstringKhôngĐịa chỉ ứng tuyển ngoài

NOTE

Frontend không dùng applyMode và applyUrl ở danh sách. Thẻ kết quả chọn trang chi tiết chỉ dựa vào sourceType: EXTERNAL đi tới /jobs/external/<id>, còn lại đi tới /jobs/<id>.

Cách frontend dùng dữ liệu ​

Điều kiệnHành vi trên thẻ kết quả
sourceType là INTERNALHiện lương dạng số, có nút lưu việc, trạng thái "sắp hết hạn" tính từ endDate
sourceType là EXTERNALHiện nhãn nguồn ngoài, không có nút lưu, hiện salaryText nếu có

Lưu việc chỉ hoạt động với mã tin của DevLink, vì vậy tin ngoài không có nút này.

Các field của ExternalJobDetail ​

FieldKiểuBắt buộcÝ nghĩa nghiệp vụ
idstringCóĐịnh danh tin ngoài
sourceKeystringCóMã nguồn; topdev và itviec được hiển thị bằng tên website trong thông báo nguồn
title, companyNamestringCóTiêu đề và công ty
locationstringCóĐịa điểm
locationCodestringKhôngMã địa điểm chuẩn hóa
isRemotebooleanCóLàm từ xa; nếu false giao diện ghi "chưa rõ" chứ không khẳng định làm tại chỗ
skillsstring[]CóKỹ năng
levelstringKhôngCấp bậc
salaryTextstringKhôngLương dạng văn bản
descriptionHtmlstringCóMô tả; rỗng khi nguồn chỉ cho phép dẫn link
postedAtstringCóThời điểm đăng
sourceUrlstringCóTrang gốc của tin
applyUrlstringCóNơi ứng tuyển
status'ACTIVE' | 'CLOSED'CóTin còn nhận hồ sơ hay đã đóng
displayPolicy'LINK_ONLY' | 'FULL'KhôngChính sách hiển thị của nguồn

Ví dụ JSON ​

Dữ liệu giả:

json
{
  "id": "665f1a2b3c4d5e6f70819320",
  "sourceType": "EXTERNAL",
  "sourceKey": "topdev",
  "title": "Backend Developer",
  "companyName": "Công ty Ví dụ",
  "location": "Hồ Chí Minh",
  "locationCode": "HCM",
  "salaryText": "Thỏa thuận",
  "isRemote": false,
  "skills": ["Node.js"],
  "postedAt": "2026-01-10T00:00:00.000Z",
  "applyMode": "EXTERNAL_REDIRECT",
  "applyUrl": "https://example.com/jobs/1"
}

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

Vấn đềChi tiết
displayPolicyỞ backend (IExternalJobDetail) là bắt buộc và có thêm giá trị HIDDEN; ở frontend là tùy chọn và chỉ có LINK_ONLY, FULL. Code frontend ghi chú tùy chọn để chạy được với backend cũ hơn. Backend không bao giờ trả HIDDEN: tin của nguồn ẩn bị trả 404
Cách nhận biết "bị giữ nội dung"Giao diện không đọc displayPolicy; nó kiểm tra descriptionHtml có rỗng không
Kiểu ngàyBackend dùng Date, frontend dùng string vì qua JSON
Không kiểm tra lúc chạyDữ liệu từ backend được ép kiểu, không được Zod kiểm tra

Danh sách field của JobSearchItem ở frontend và IJobSearchItem ở backend trùng khớp, chỉ khác kiểu ngày.

Nơi dùng ​

Source code liên quan ​

Backend: interface IJobSearchItem và collection external-jobs.

Đọc tiếp: Model Job, Endpoint Job Search, Phân trang và lọc.

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