Skip to content

Việc làm từ nguồn ngoài ​

DevLink tổng hợp tin tuyển dụng từ các website khác vào cùng danh sách /jobs. Trang này giải thích người dùng thấy gì ở loại tin này, vì sao nó khác tin do nhà tuyển dụng đăng, và frontend dùng dữ liệu nào để quyết định. Dành cho người dùng muốn hiểu và developer sửa phần hiển thị.

Vì sao cần ​

Ứng viên muốn thấy nhiều cơ hội ở một nơi. Nhưng tin đó thuộc về website khác, nên DevLink không nhận hồ sơ và không đăng lại nội dung nếu nguồn không cho phép. Vì vậy loại tin này có trang chi tiết và quy tắc hiển thị riêng.

Đối tượng: mọi người, kể cả khách. Không có thao tác lưu việc hay ứng tuyển trên DevLink cho loại tin này.

Đánh đổi:

  • Nội dung phụ thuộc vào nguồn. Nguồn chỉ cho dẫn link thì DevLink chỉ hiển thị thông tin tóm tắt.
  • Tin ngoài không vào công cụ tìm kiếm của Google, nên không đem lại lượt truy cập từ tìm kiếm tự nhiên.

Tin nội bộ và tin bên ngoài ​

Tin nội bộTin bên ngoài
NguồnNhà tuyển dụng đăng trên DevLinkTổng hợp từ website khác
Trang chi tiết/jobs/<id>/jobs/external/<id>
Ứng tuyểnTrên DevLink bằng hộp thoại nộp hồ sơSang website gốc, tab mới
Lưu việcCóKhông
Lươngsalary (số)salaryText (văn bản)
Chỉ mục tìm kiếmCó trong sitemap.tsrobots: noindex, nofollow, không có trong sitemap.ts

Quy tắc hiển thị ​

Mỗi nguồn có một chính sách do backend quyết định. Backend trả dữ liệu khác nhau theo chính sách:

Chính sáchBackend trả gìNgười dùng thấy
FULLĐầy đủ mô tảMô tả, thông tin tin, nút ứng tuyển và liên kết bài gốc
LINK_ONLYdescriptionHtml rỗngThông tin tóm tắt và đường dẫn tới trang gốc
HIDDENTrả 404Trang 404; tin cũng không xuất hiện trong danh sách

Frontend không đọc trường displayPolicy; nó chỉ kiểm tra descriptionHtml có rỗng hay không để quyết định hiển thị mô tả hay hướng dẫn xem ở nguồn.

Giao diện trang chi tiết ​

Trang gồm: huy hiệu nguồn, tiêu đề, công ty, địa điểm, thời điểm đăng; nút ứng tuyển và liên kết "xem bài gốc"; thông báo nguồn; mô tả; thông tin phụ (cấp bậc, nơi làm việc, địa điểm, lương, kỹ năng).

Thông báo nguồn nói rõ đây là tin tổng hợp. Với nguồn topdev và itviec thông báo gọi tên website; với nguồn khác nó gọi tên công ty.

Các trường hợp hiển thị khác nhau theo dữ liệu được liệt kê ở Chuyển tới tin tuyển dụng bên ngoài.

Vì sao noindex ​

Code đặt robots: { index: false, follow: false } và ghi chú rằng nội dung bên thứ ba tổng hợp được giữ ra khỏi chỉ mục tìm kiếm. Chưa có ghi chép thêm về lý do.

API liên quan ​

HàmEndpointDùng ở
fetchPublicExternalJobByIdGET /job-search/external/:idTrang chi tiết và generateMetadata
useSearchJobsQueryGET /job-searchDanh sách, tab "bên ngoài"

Hook useGetExternalJobQuery có khai báo nhưng chưa được dùng. Chi tiết ở Endpoint Job Search.

Dữ liệu và kiểm tra ​

Kiểu dữ liệu ở Model JobSearchItem. Frontend chỉ chấp nhận liên kết http: và https: (isSafeHttpUrl); liên kết khác bị ẩn.

Trường hợp lỗi ​

Tình huốngHành vi
Tin không tồn tại, nguồn ẩn hoặc backend lỗiTrang 404
Tin đã đóngHiện thông báo đóng, ẩn nút ứng tuyển
Địa chỉ ứng tuyển không an toànẨn nút ứng tuyển
Nguồn chỉ cho dẫn linkHiện câu hướng dẫn xem đầy đủ ở nguồn

Test cases ​

TestNội dung
src/features/job/components/external-job-detail-content.test.tsxLiên kết ứng tuyển mở tab mới; ẩn nút khi tin đóng; không hiển thị liên kết giao thức lạ; hiện hoặc ẩn lương; không khẳng định làm tại chỗ khi nguồn không có cờ remote; chỉ về bài gốc khi không có mô tả; component không import thư viện làm sạch HTML
src/app/[locale]/(main)/jobs/external/[id]/page.test.tsxMô tả được làm sạch trên server trước khi tới component; mô tả rỗng thì truyền null; tin không tồn tại thì trả 404
src/lib/utils/is-safe-http-url.test.tsKiểm tra URL an toàn
src/features/job/components/job-search-card.test.tsxThẻ tin ngoài không có lương số và nút lưu

Chưa có test cho: trang external/[id]/page.tsx (noindex, notFound), thông báo nguồn theo sourceKey.

Source code liên quan ​

Tài liệu backend: Job ingestion.

Đọc tiếp: Tìm kiếm việc làm, Chuyển tới tin tuyển dụng bên ngoài, Rendering và SEO.

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