Skip to content

Tạo CV ​

Tính năng cho phép ứng viên nhập hồ sơ CV trực tiếp trên DevLink gồm thông tin cá nhân và bảy nhóm nội dung, theo dõi mức hoàn thành và lưu lại. Trang dành cho người muốn biết trình tạo CV làm được gì, và cho developer sửa các phần của form.

Vì sao cần ​

Ứng viên cần một CV có cấu trúc để xem trước, tải PDF và dùng lại. Nhập một lần trên DevLink giúp tránh phải soạn lại CV nhiều lần.

Đối tượng: người dùng đã đăng nhập. Trang tạo CV nằm ở /profile?tab=create-cv; /profile không có guard phía frontend, nên người chưa đăng nhập có thể mở được trang nhưng các lời gọi API sẽ bị backend từ chối.

Đánh đổi:

  • Mọi thay đổi chỉ nằm trong trình duyệt cho tới khi bấm lưu; rời trang khi chưa lưu sẽ mất. Chưa thấy cảnh báo rời trang trong code.
  • Mỗi lần lưu gửi toàn bộ CV, không lưu từng mục.

Giao diện ​

Trang tạo CV

Trang tạo CV: các nhóm nội dung bên trái và thanh mức hoàn thành kèm nút lưu bên phải.

Các nhóm nội dung ​

NhómComponentHộp thoại
Thông tin cá nhânPersonalInfoSectionpersonal-info-modal.tsx
Học vấnEducationSectioneducation-modal.tsx
Kinh nghiệm làm việcWorkExperienceSectionwork-experience-modal.tsx
Kỹ năngSkillsSectionskill-modal.tsx
Ngôn ngữLanguagesSectionlanguage-modal.tsx
Dự ánProjectsSectionproject-modal.tsx
Chứng chỉCertificatesSectioncertificate-modal.tsx
Giải thưởngAwardsSectionaward-modal.tsx

Mỗi nhóm có hộp thoại riêng, tám hộp thoại dùng chung thành phần modal-header-banner.tsx, kèm một hook use-*-modal.ts quản lý trạng thái hộp thoại. Email trong thông tin cá nhân chỉ đọc (isEmailReadOnly).

Mức hoàn thành ​

Mức hoàn thành tính theo trọng số các nhóm đã có nội dung:

NhómTrọng số
Thông tin cá nhân (cần họ tên và email)1
Học vấn1
Kinh nghiệm1
Kỹ năng1
Ngôn ngữ1
Dự án0,5
Chứng chỉ0,5
Giải thưởng0,5

Tổng trọng số 6,5; mức hoàn thành là phần trăm trọng số đã có, làm tròn. Nút xem trước bị vô hiệu khi dưới 15%.

Luồng nghiệp vụ ​

Sơ đồ rút gọn; trình tự kỹ thuật xem Tạo và xuất CV.

WARNING

Tab "CV của tôi" (/profile?tab=my-cv) cho chọn hoặc kéo thả một file PDF, DOC, DOCX và hiện thông báo "tải lên thành công", nhưng my-cv-page.tsx chỉ kiểm tra file rồi lưu tên và dung lượng vào state của component. Không có lời gọi API nào, nên file không được gửi đi đâu và mất khi tải lại trang.

API liên quan ​

HookEndpointDùng ở
useLazyGetMyCVProfileQueryGET /cv-profiles/meuse-cv.ts
useUpsertCVProfileMutationPOST /cv-profiles/upsertuse-cv.ts

Bảng đầy đủ: Endpoint CV Profiles.

Dữ liệu và kiểm tra ​

Quy tắc từng field và giới hạn số lượng (tối đa 20 kỹ năng, 5 ngôn ngữ) ở Model CV Profile. Trước khi lưu, trang kiểm tra bằng UpsertCVProfileRequestSchema.

Trường hợp lỗi ​

Tình huốngHành vi
Không tải được CVToast lỗi chung
Dữ liệu không hợp lệToast "dữ liệu không hợp lệ" kèm đường dẫn field và lỗi đầu tiên
Backend từ chối lúc lưuuseCV ghi lỗi, trang hiện toast

NOTE

Nút lưu và nút xem trước của thanh thao tác trên màn hình nhỏ có chữ viết cứng bằng tiếng Việt ("Lưu CV", "Xem trước & Tải PDF") thay vì dùng bản dịch.

Test cases ​

TestNội dung
src/features/cv-builder/components/create-cv-page/create-cv-page.test.tsxTải CV hiện tại và truyền dữ liệu vào các phần
src/features/cv-builder/hooks/use-cv.test.tsxTrả hồ sơ nháp; ghi lỗi khi tải thất bại; lưu kèm file ảnh
src/features/cv-builder/schemas/cv-profile.schema.test.tsNhận hồ sơ nháp không có id; nhận hồ sơ đã lưu; giữ kiểm tra chặt khi lưu

Chưa có test cho: hộp thoại từng nhóm, mức hoàn thành, trang xem trước, tab "CV của tôi".

Source code liên quan ​

Tài liệu backend: CV Profiles.

Đọc tiếp: Xuất CV ra PDF, Tạo và xuất CV, Model CV Profile.

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