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

Job Sources (job_sources)

Cấu hình từng nguồn tin bên ngoài: dùng nhà cung cấp nào, bảng tin nào, có đang bật đồng bộ không, có hiển thị công khai không, và kết quả lần đồng bộ gần nhất. Quản trị viên quản lý qua job-sources.controller.ts.

  • Nguồn schema: job-source.schema.ts
  • Phân loại dữ liệu: cấu hình hệ thống, không có dữ liệu cá nhân.
  • Soft-delete: schema không khai báo, plugin thêm isDeleted và deletedAt.

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
keyStringCó—trim; uniqueKhóa duy nhất của nguồn, dùng làm sourceKey ở external_jobs và làm jobId của hàng đợi
providerStringCó—enum: ITVIEC, TOPDEV, LEVER, GREENHOUSENhà cung cấp dữ liệu: ITVIEC, TOPDEV, LEVER, GREENHOUSE
boardTokenStringCó—match=/^[a-z0-9-]+$/; trimMã bảng tin tại nhà cung cấp. Chỉ chữ thường, số, gạch ngang
companyNameStringCó—trimTên công ty sở hữu nguồn
enabledBooleanCótrue—Có đồng bộ định kỳ hay không
lastSyncedAtDateKhông——Lần đồng bộ gần nhất
lastSyncStatusStringKhông—enum: FAILED, SUSPECT, PARTIAL, SUCCESS, RUNNINGKết quả lần đồng bộ gần nhất
lastSyncErrorStringKhông——Thông báo lỗi của lần đồng bộ gần nhất
displayPolicyStringKhông"LINK_ONLY"enum: FULL, LINK_ONLY, HIDDENChính sách hiển thị công khai. Mặc định LINK_ONLY
lastSyncStatsMixedKhông——Số liệu lần đồng bộ gần nhất, theo ICrawlRunStats
lastSuccessfulListedCountNumberKhông——Số tin liệt kê ở lần thành công gần nhất, dùng làm mức nền phát hiện danh sách co bất thường
consecutiveFailuresNumberKhông0—Số lần lỗi liên tiếp
rejections[Subdoc]Không[]—Danh sách tin bị loại và thời điểm được thử lại
rejections.externalIdStringCó——Mã tin tại nguồn bị loại
rejections.reasonStringCó—enum: NOT_IT, MISSING_FIELDS, NO_STRUCTURED_DATA, NOT_FOUNDLý do loại
rejections.retryAtDateCó——Thời điểm được phép tải lại
createdAtDateKhông—immutableThời điểm tạo, do timestamps hoặc plugin
updatedAtDateKhông——Thời điểm sửa gần nhất, do timestamps
isDeletedBooleanCófalsethêm bởi plugin xóa mềmCờ 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ôngnullthêm bởi plugin xóa mềmThời điểm xóa mềm

lastSyncStats là type: Object tự do, cấu trúc thực tế theo ICrawlRunStats:

FieldÝ nghĩa
listedSố tin có trong danh sách nguồn
plannedSố tin dự định tải chi tiết
fetchedSố tin đã tải
keptSố tin giữ lại sau lọc
rejectedSố tin bị loại
created, updated, unchanged, reactivatedKết quả ghi vào external-jobs
staled, closedSố tin chuyển STALE và CLOSED

rejections[] là mảng phần tử { externalId, reason, retryAt } với _id: false. Đây là danh sách tin bị loại để không tải lại trước thời điểm retryAt. Thời gian chờ theo lý do (job-ingestion.constants.ts):

reasonChờ trước khi thử lại
NOT_FOUND3 ngày
NO_STRUCTURED_DATA3 ngày
MISSING_FIELDS7 ngày
NOT_IT30 ngày

Indexes​

KeysThuộc tínhMục đích
{ key: 1 }uniqueĐảm bảo key duy nhất và tra cứu nguồn theo key

key có unique: true từ khai báo field, nên chỉ có một index duy nhất (trên key).

Chính sách hiển thị (displayPolicy)​

Giá trịTìm kiếm hợp nhất
FULLTrả đầy đủ, gồm mô tả
LINK_ONLYTrả tiêu đề, công ty, địa điểm và liên kết nhưng mô tả để trống (mặc định cho nguồn cũ chưa có field này)
HIDDENLoại khỏi kết quả

Nguồn: job-search.service.ts và DEFAULT_DISPLAY_POLICY trong constants. Với LINK_ONLY, mô tả cũng không được lưu ngay từ khi nạp.

Ví dụ document​

{
"_id": "665f1a2b3c4d5e6f70819c01",
"key": "greenhouse-example",
"provider": "GREENHOUSE",
"boardToken": "example",
"companyName": "Example Software Co.",
"enabled": true,
"displayPolicy": "LINK_ONLY",
"lastSyncedAt": "2026-10-05T06:00:00.000Z",
"lastSyncStatus": "SUCCESS",
"lastSyncStats": { "listed": 40, "planned": 3, "fetched": 3, "kept": 3, "rejected": 0, "created": 1, "updated": 1, "unchanged": 1, "reactivated": 0, "staled": 0, "closed": 0 },
"lastSuccessfulListedCount": 40,
"consecutiveFailures": 0,
"rejections": []
}

Lưu ý​

  • consecutiveFailures và hằng ALERT_AFTER_FAILURES = 3 cho thấy có ngưỡng cảnh báo sau 3 lần lỗi liên tiếp. Nơi phát cảnh báo: Chưa xác minh.
  • Cron mỗi 6 giờ chỉ đồng bộ nguồn có enabled: true (job-ingestion.service.ts).
  • boardToken chỉ nhận chữ thường, số và dấu gạch ngang (/^[a-z0-9-]+$/).
  • Known Limitation: schema không có createdBy/updatedBy, nên không biết ai thêm hoặc đổi nguồn.