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

Companies (companies)

Hồ sơ công ty tuyển dụng. HR thuộc về một công ty, và mỗi tin tuyển dụng gắn với một công ty.

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
nameStringCó—trimTên công ty
addressStringCó—trimĐịa chỉ công ty
descriptionStringCó—trimMô tả công ty
websiteStringKhôngnulltrimĐịa chỉ website
numberOfEmployeesNumberKhông0—Số nhân viên
logoStringKhôngnulltrimĐường dẫn file logo trên đĩa (public/)
createdAtDateKhông——Thời điểm tạo, do timestamps hoặc plugin
updatedAtDateKhông——Thời điểm sửa gần nhất, do timestamps
deletedAtDateKhông——Thời điểm xóa mềm
isDeletedBooleanKhông——Cờ 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
createdByMixedKhôngnull—Người tạo bản ghi, dạng { _id, email }
updatedByMixedKhôngnull—Người sửa gần nhất, dạng { _id, email }
deletedByMixedKhôngnull—Người xóa mềm, dạng { _id, email }

Tài liệu nhúng CompanySnapshot​

Schema CompanySnapshot không phải collection riêng. Đây là bản sao rút gọn của công ty, nhúng vào users (company) và jobs (company).

FieldTypeRequiredDefaultÝ nghĩa
_idObjectIdCó—_id của công ty gốc trong collection companies
nameString (trim)Có—Tên công ty tại thời điểm tạo snapshot
logoString (trim)KhôngnullĐường dẫn logo tại thời điểm tạo snapshot

Khai báo { _id: false, id: false }: snapshot không tự sinh _id riêng, _id của nó chính là mã công ty gốc.

Design Decision: snapshot giúp liệt kê tin kèm tên và logo công ty mà không cần $lookup. Đánh đổi là dữ liệu có thể lệch khi công ty đổi tên hay logo. companies.service.ts không có đoạn nào cập nhật lại snapshot trong jobs hay users khi công ty được sửa (đã grep file này). Chưa kiểm tra các nơi khác trong src/, nên đây là Known Limitation ở mức Chưa xác minh toàn cục.

Indexes​

KeysThuộc tínhMục đích
{ name: 1, isDeleted: 1 }—Tra cứu và sắp xếp công ty theo tên
{ createdAt: -1 }—Liệt kê công ty mới nhất trước

Quan hệ​

Công ty không tham chiếu collection nào. Các collection khác trỏ tới nó:

TừCách
users.companyEmbedded snapshot
users.companyFollowedReference (mảng ObjectId)
jobs.companyEmbedded snapshot
resumes.companyIdReference (ObjectId)

Ví dụ document​

{
"_id": "665f1a2b3c4d5e6f70819901",
"name": "Example Software Co.",
"address": "1 Example Street, Ho Chi Minh City",
"description": "Product company building B2B tools.",
"website": "https://example.com",
"numberOfEmployees": 120,
"logo": "images/company/example-logo.png",
"createdBy": { "_id": "665f1a2b3c4d5e6f70819201", "email": "admin@example.com" },
"isDeleted": false
}

Vòng đời​

  • Logo tải lên được lưu trên đĩa. Cron cleanup-orphaned-company-logos (2 giờ sáng, múi giờ Asia/Ho_Chi_Minh) xóa các file logo không còn công ty nào tham chiếu (companies.service.ts).
  • Số tin đang tuyển của công ty là giá trị tính khi truy vấn, không lưu trong schema này.