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

Quy tắc nghiệp vụ

Tổng hợp các quy tắc nghiệp vụ quan trọng, mỗi quy tắc kèm nơi thực thi trong code để kiểm chứng. Đây là mục tra cứu nhanh; giải thích đầy đủ nằm ở tài liệu module và workflow được liên kết.

Tài khoản và phiên​

Quy tắcGiá trịNơi thực thi
Vai trò khi đăng kýNORMAL USERusers.service.ts
Tài khoản mới chưa xác thựcisActive = false, bị xóa tự động sau 15 phút nếu không xác thựcverificationExpires và TTL index, xem users
Mã OTP6 chữ số, hiệu lực 5 phút, tối đa 5 lần nhập sai, chờ 60 giây giữa hai lần gửi lạiauth-verification.service.ts
Lưu OTPChỉ lưu HMAC-SHA256 trong Redis, so sánh bằng timingSafeEqualotp.utils.ts
Số phiên đồng thờiTối đa 5 mỗi người, vượt thì xóa phiên dùng lâu nhấtauth-session.service.ts
Làm mới tokenXóa phiên cũ, tạo phiên mới với refresh token mớiauth-session.service.ts
Khóa tài khoảnQuản trị viên khóa được, không tự khóa mình, khóa xong vô hiệu mọi phiênuser-account.service.ts
Xóa tài khoảnĐặt lịch sau 30 ngày, hủy được trong thời gian chờauth-account-deletion.service.ts

Tin tuyển dụng​

Quy tắcGiá trịNơi thực thi
Tin mớiapprovalStatus = PENDING, chưa hiển thị công khaijob.schema.ts
Hiển thị công khaiisActive, APPROVED, và chưa quá endDate (hoặc không có endDate)jobs.service.ts
Duyệt tinChỉ SUPER ADMIN, chỉ đặt được APPROVED hoặc REJECTED (không quay lại PENDING); không kiểm tra trạng thái hiện tạiapproveJob, ApproveJobDto
Hết hạnCron mỗi giờ đặt isActive = false và báo người tạo tinhandleExpiredJobs
Kỹ năng của tinChuẩn hóa theo danh mục kỹ năng, giá trị không hợp lệ bị từ chốinormalizeControlledSkills
Địa điểmlocationCode hoặc location phải khớp danh mục, nếu không bị từ chốiresolveLocationOrThrow
HR và công tyHR chỉ thao tác trên công ty của mìnhcompanies.service.ts

Hồ sơ ứng tuyển​

Quy tắcGiá trịNơi thực thi
Nộp trùngMột ứng viên không nộp hai lần cho cùng một tincheckDuplicateApplication
CV bị tắtCV có isActive = false không dùng để nộpapplication-submission.service.ts
Trạng thái ban đầuPENDING, ghi vào historiescreate
Đổi trạng tháiKhông kiểm tra thứ tự, mỗi lần đổi thêm một dòng histories và gửi thông báoresumes.service.ts
Phạm vi HRChỉ xem và sửa hồ sơ của công ty mìnhfindOne, update
Trọng số điểmKỹ năng 50%, kinh nghiệm 30%, học vấn 20%matching.constants.ts
Ngưỡng ưu tiênEXCELLENT ≥ 85, HIGH ≥ 70, MEDIUM ≥ 50, còn lại LOWdeterminePriority
Tự động đổi trạng tháiCó hàm nhưng dòng gán bị comment trong processor, nên không áp dụngresume-queue.processor.ts
Giới hạn tốc độ phân tíchTối đa 15 việc mỗi 60 giây trên hàng đợi resume-processingresume-queue.processor.ts

Điểm phù hợp là chỉ báo hỗ trợ, không phải đánh giá khách quan về ứng viên: nó chỉ so khớp kỹ năng, số năm và học vấn khai báo trong CV với yêu cầu của tin.

Tin từ nguồn ngoài​

Quy tắcGiá trịNơi thực thi
Chu kỳ đồng bộMỗi 6 giờ (Asia/Ho_Chi_Minh), chỉ nguồn enabledjob-ingestion.service.ts
Không chạy trùng một nguồnjobId = sync-<key> trên hàng đợijob-ingestion-queue.service.ts
Tin vắng khỏi danh sáchThành STALE, đóng sau 5 giờ ân hạnjob-lifecycle.service.ts
Danh sách co bất thườngDưới 50% mức nền (nền ≥ 20) hoặc rỗng: SUSPECT, không đóng tinisSuspectListing
Tin bị loạiKhông tải lại trong 3 đến 30 ngày tùy lý dojob-ingestion.constants.ts
Hiển thịFULL đầy đủ, LINK_ONLY không có mô tả, HIDDEN bị loạijob-search.service.ts

Chat AI​

Quy tắcGiá trịNơi thực thi
Hạn mức mỗi ngàyNORMAL USER 30, HR 100, SUPER ADMIN không giới hạnchat-quota.service.ts
Đặt lại hạn mứcTheo múi giờ chính sách, mặc định Asia/Ho_Chi_Minhcùng file
Hành động cần xác nhậnHết hạn sau 15 phút (mặc định)chat-tool-action.service.ts
Nhà cung cấp mặc địnhGroq, dự phòng Geminiai.constants.ts

Khác​

Quy tắcGiá trịNơi thực thi
Đăng ký gợi ý việc làmTối đa 3 đang hoạt động mỗi ngườisubscribers.service.ts
Upload5 MB mỗi file, kiểm tra MIME và đuôi file theo thư mụcupload-policy.ts
Thư mục upload companyChỉ HR và SUPER ADMINcùng file
Phân tranglimit mặc định 10, một số nơi giới hạn tối đa 100các service tương ứng
Xóa mềmHầu hết collection, trừ sessions và cv-profiles xóa thậtdatabase-overview

Các giá trị trên là hằng số trong code tại thời điểm viết; nhiều giá trị có thể ghi đè qua biến môi trường (ví dụ CHAT_QUOTA_*). Khi một giá trị đổi, cập nhật tài liệu này cùng Pull Request.