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

State machine: vòng đời tin ngoài (external_jobs.status)

Mô tả các trạng thái và chuyển trạng thái của một tin lấy từ nguồn ngoài. Chỉ vẽ chuyển trạng thái có trong code; mỗi mũi tên ghi nơi thực hiện.

Trạng thái​

Trạng tháiÝ nghĩaHiển thị công khai
ACTIVEVừa được thấy hoặc tải gần đâyCó
STALEVắng khỏi một danh sách đầy đủ, đang trong thời gian ân hạnCó (trả ra dưới dạng ACTIVE)
CLOSEDĐã đóng, kèm closeReasonKhông trong danh sách tìm kiếm; chi tiết trả status: CLOSED

VISIBLE_EXTERNAL_JOB_STATUSES là ACTIVE và STALE (job-ingestion.constants.ts).

Sơ đồ​

Bảng chuyển trạng thái​

TừĐếnĐiều kiệnNơi thực hiện
(chưa có)ACTIVELần đầu tải thành công và qua bộ lọcupsertFetched (external-job.repository.ts)
ACTIVESTALEKhông được tải lần này, không bị loại, không nằm trong danh sách, và danh sách đầy đủ (listingComplete)computeTransitions rồi markStale
STALEACTIVEĐược tải lại thành côngupsertFetched (xóa staleSince, closedAt, closeReason)
STALECLOSEDstaleSince quá 5 giờ (STALE_GRACE_HOURS) mà vẫn vắng, danh sách đầy đủcomputeTransitions: GONE_FROM_SOURCE
ACTIVE hoặc STALECLOSEDTải lại bị loại với lý do NOT_FOUNDcomputeTransitions: NOT_FOUND
ACTIVE hoặc STALECLOSEDTải lại bị loại với lý do khác (không còn là tin IT, thiếu trường)computeTransitions: NO_LONGER_MATCHES
ACTIVE hoặc STALECLOSEDexpiresAt đã quacloseExpired: EXPIRED
CLOSEDACTIVETin xuất hiện lại trong danh sách và được tải thành công (tính vào reactivated)upsertFetched

Tin đã CLOSED và có closeReason = EXPIRED còn mới (tải trong vòng 7 ngày) không bị tải lại vì nguồn thường giữ tin hết hạn trong danh sách một thời gian (job-lifecycle.service.ts, planFetch).

Điều kiện bảo vệ​

Chuyển sang STALE hoặc đóng vì vắng mặt bị chặn khi lần đồng bộ là SUSPECT (listingComplete = !suspect trong source-sync-coordinator.ts). Lần PARTIAL (dừng sớm khi tải chi tiết) vẫn áp dụng vì danh sách đã đầy đủ; lần FAILED không đi tới bước này. Chi tiết: job-ingestion.

Edge case​

Tình huốngHành vi
Nguồn trả danh sách rỗng lúc có sự cốSUSPECT (khi đã có mức nền): không tin nào bị đổi trạng thái vì vắng mặt
Tin hết hạn nhưng vẫn ở trong danh sách nguồnBị đóng EXPIRED ngay lần đồng bộ sau, không chờ ân hạn
Đổi nguồn sang LINK_ONLYKhông đổi status; xóa mô tả đã lưu
Tin đã CLOSED trở lại sau nhiều ngàyĐược tải lại thứ tự ưu tiên thứ hai (RANK_REAPPEARED) và kích hoạt lại nếu qua bộ lọc

Known Limitation​

Không có chuyển trạng thái thủ công qua API: quản trị viên không đóng hay mở lại từng tin ngoài được, chỉ đổi cấu hình nguồn. Đã đối chiếu 4 route của job-sources.