Skip to content

Model CV Profile ​

Trang này mô tả hồ sơ CV của ứng viên ở frontend: dữ liệu người dùng nhập trong trình tạo CV, gồm thông tin cá nhân và bảy nhóm nội dung (học vấn, kinh nghiệm, kỹ năng, ngôn ngữ, dự án, chứng chỉ, giải thưởng). Dành cho developer cần biết field nào có, giới hạn ra sao và vì sao có hai bộ định nghĩa.

Vì sao có hai bộ định nghĩa ​

Dữ liệu CV đi qua hai việc khác nhau. Lúc lưu, frontend phải kiểm tra chặt (tên, số điện thoại, độ dài, số lượng). Lúc đọc về, backend có thể trả hồ sơ nháp chưa đầy đủ, nên schema đọc nới lỏng hơn. Ngoài ra các thành phần hiển thị (mẫu CV, PDF) dùng thêm một interface riêng.

DạngĐịnh nghĩaDùng ở
Dữ liệu gửi lênUpsertCVProfileRequest suy ra từ UpsertCVProfileRequestSchemaupsertCVProfile, kiểm tra trước khi lưu
Dữ liệu nhận vềCVProfile suy ra từ CVProfileSchemagetMyCVProfile, useCV
Dữ liệu cho giao diệnICVProfile trong src/shared/types/cv.d.tsTrang tạo CV, mẫu CV, PDF

Type chính: UpsertCVProfileRequest khi lưu, CVProfile khi đọc, ICVProfile cho giao diện.

Thông tin cá nhân (personalInfo) ​

FieldKiểuBắt buộc khi lưuÝ nghĩa nghiệp vụ
fullNamestringCóHọ tên, 2 đến 100 ký tự
emailstringCóEmail đúng định dạng
phonestringCóSố điện thoại, 10 đến 15 ký tự
gender'male' | 'female' | 'other'CóGiới tính
avatarstringKhôngĐường dẫn ảnh đại diện; file ảnh gửi riêng
titlestringKhôngChức danh, 2 đến 100 ký tự
birthdayDateKhôngNgày sinh
addressstringKhôngĐịa chỉ, tối đa 200 ký tự
personalLinkstringKhôngĐường dẫn cá nhân, phải là URL hoặc để trống
biostringKhôngGiới thiệu, tối đa 500 ký tự

Các nhóm nội dung ​

Mỗi mục có id tùy chọn khi gửi lên (mục mới chưa có id) và bắt buộc khi nhận về.

NhómFieldGiới hạn khi lưu
educationschool, degree, field, startDate, endDate?, description?Tên trường, bằng cấp, chuyên ngành từ 2 ký tự; mô tả tối đa 1000 ký tự
experiencecompany, position, startDate, endDate?, description?Công ty, vị trí từ 2 ký tự; mô tả tối đa 1000 ký tự
skillsname, levelTối đa 20 kỹ năng
languagesname, proficiencyTối đa 5 ngôn ngữ
projectsname, position, description, link?Mô tả từ 10 đến 1000 ký tự; link là URL hoặc để trống
certificatesname, issuer, dateTên và nơi cấp từ 2 ký tự
awardsname, date, description?Tên từ 2 ký tự; mô tả tối đa 1000 ký tự

Các ngày là chuỗi có thể đọc được bằng Date.parse. Các nhóm không bắt buộc, mặc định là mảng rỗng.

Trường cấp hồ sơ khi đọc về ​

FieldKiểuÝ nghĩa
_idstringCó khi hồ sơ đã được lưu; không có ở hồ sơ nháp
userIdstringChủ hồ sơ
isDraftbooleanHồ sơ nháp chưa lưu, backend dựng từ thông tin tài khoản
isActivebooleanHồ sơ còn hiệu lực
createdAt, updatedAt, lastUpdatedstringThời điểm tạo và cập nhật

Ví dụ JSON ​

Dữ liệu giả, một phần của UpsertCVProfileRequest:

json
{
  "personalInfo": {
    "fullName": "Nguyen Van A",
    "email": "a@example.com",
    "phone": "0900000000",
    "gender": "male",
    "title": "Frontend Developer"
  },
  "education": [
    { "school": "Đại học Mẫu", "degree": "Cử nhân", "field": "Công nghệ thông tin", "startDate": "2018-09-01T00:00:00.000Z" }
  ],
  "skills": [{ "name": "React", "level": "Intermediate" }],
  "languages": [{ "name": "English", "proficiency": "Intermediate" }]
}

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

Vấn đềChi tiết
Hai schema cho thông tin cá nhânPersonalInfoSchema (khi lưu) bắt buộc phone từ 10 ký tự và gender; CVProfilePersonalInfoSchema (khi đọc) cho phép phone, gender và title trống và birthday là Date hoặc chuỗi
ICVProfile khác CVProfileICVProfile có id: string bắt buộc ở mọi mục và ngày kiểu Date | string; CVProfile có _id tùy chọn
Hai interface trong cv.d.tsCó thêm CVData với birthday kiểu Date, gần giống ICVProfile
Chuẩn hóa ở giao diệnTrang tạo CV tự đổi dữ liệu nhận về sang dạng của giao diện (normalizeCVProfile) trước khi dùng
Giới hạn số lượngskills tối đa 20 và languages tối đa 5 chỉ có ở schema gửi lên; chưa kiểm tra backend

Chưa có ghi chép về lý do của các khác biệt này.

Nơi dùng ​

Endpoint: Endpoint CV Profiles. Giao diện: Tạo CV và Xuất CV ra PDF.

Source code liên quan ​

Collection ở backend: cv-profiles.

Đọc tiếp: Endpoint CV Profiles, Tạo và xuất CV, Tham chiếu dữ liệu backend.

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