Skip to content

Model Company ​

Trang này mô tả công ty tuyển dụng ở frontend: bản ghi công ty, dữ liệu form quản trị và dạng rút gọn của danh sách "công ty tuyển nhiều". Dành cho developer cần biết field nào có và chỗ nào định nghĩa lệch nhau.

Vì sao có nhiều dạng ​

Công ty xuất hiện ở trang công khai (danh sách, chi tiết), ở form quản trị và ở trang chủ (công ty tuyển nhiều). Mỗi nơi cần một lượng thông tin khác nhau.

DạngĐịnh nghĩaDùng ở
Bản ghi đầy đủCompany suy ra từ CompanyEntitySchemagetCompanies, getCompany, fetchPublicCompanyById, fetchPublicCompanies
Dữ liệu formCreateCompanyFormData từ CompanySchema; UpdateCompanyFormData là bản PartialForm tạo và sửa công ty
Công ty tuyển nhiềuTopHiringCompany (interface)getTopHiringCompanies, fetchPublicTopHiringCompanies, trang chủ
Interface cũICompany trong src/shared/types/backend.d.tsXem "Điểm chưa đồng nhất"

Type chính: Company.

Các field của Company ​

FieldKiểuBắt buộc khi lưuÝ nghĩa nghiệp vụ
_idstringCó (khi đọc)Định danh
namestringCóTên công ty, 1 đến 100 ký tự
descriptionstringCóGiới thiệu, 10 đến 3000 ký tự
addressstringCóĐịa chỉ, 1 đến 200 ký tự
websitestringCó, được để trốngPhải là URL hoặc chuỗi rỗng
numberOfEmployeesnumberCóSố nhân viên, 0 đến 1.000.000
logostringKhôngTên file logo, lưu bằng endpoint file với thư mục company
totalJobsnumberKhôngSố tin tuyển dụng, mặc định 0
createdBy, updatedBy{ _id, email }KhôngNgười tạo và cập nhật
createdAt, updatedAtstringKhôngThời điểm tạo và cập nhật

Công ty tuyển nhiều (TopHiringCompany) ​

FieldKiểuÝ nghĩa
_id, name, addressstringĐịnh danh, tên, địa chỉ
logo, websitestring | nullTùy chọn
numberOfEmployeesnumberTùy chọn
totalOpenJobsnumberSố tin đang mở

Ví dụ JSON ​

Dữ liệu giả, theo CompanyEntitySchema:

json
{
  "_id": "665f1a2b3c4d5e6f70819302",
  "name": "Công ty Mẫu",
  "description": "Công ty phần mềm tập trung vào sản phẩm tuyển dụng.",
  "address": "Hà Nội",
  "website": "https://example.com",
  "numberOfEmployees": 120,
  "logo": "logo-1760000000000.png",
  "totalJobs": 4
}

Điểm chưa đồng nhất ​

Vấn đềChi tiết
ICompany khác CompanyICompany không có website, numberOfEmployees, totalJobs; logo bắt buộc; createdBy là string
Hai tên số tintotalJobs ở Company, totalOpenJobs ở TopHiringCompany
Công ty trong Job và UserJob.company chỉ có _id, name, logo; User.company có _id, name, logo tùy chọn

Chưa có ghi chép về lý do.

Nơi dùng ​

Endpoint: Endpoint Companies. Collection ở backend: companies.

Source code liên quan ​

Đọc tiếp: Endpoint Companies, Model Job, Tham chiếu dữ liệu backend.

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