Skip to content

Endpoint CV Profiles ​

Trang này liệt kê hai endpoint hồ sơ CV trong cv-profile.api.ts: lấy CV của tôi và lưu CV. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao ít endpoint ​

Mỗi người dùng chỉ có một CV, và trình tạo CV lưu toàn bộ CV trong một lần bấm. Vì vậy frontend chỉ cần một lệnh đọc và một lệnh ghi (tạo mới và cập nhật dùng chung, gọi là upsert), thay vì thêm, sửa, xóa từng mục.

Bảng endpoint ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useUpsertCVProfileMutationPOST /cv-profiles/upsertFormData gồm cvData (chuỗi JSON của UpsertCVProfileRequest) và avatar (file, tùy chọn)Làm mất hiệu lực CVProfilefeatures/cv-builder/hooks/use-cv.ts
useGetMyCVProfileQueryGET /cv-profiles/meKhôngCung cấp CVProfileChưa có nơi nào dùng
useLazyGetMyCVProfileQueryGET /cv-profiles/meKhôngCung cấp CVProfilefeatures/cv-builder/hooks/use-cv.ts

Giao diện không dùng hook cache trực tiếp mà qua useCV, hook này bọc hai thao tác và giữ lỗi bằng useState:

Hàm của useCVGọiKết quả
fetchMyCVProfileTruy vấn lazy, không dùng dữ liệu cache cũTrả CVProfile hoặc null; lỗi được ghi vào error
upsertCVMutation upsert kèm file ảnh tùy chọnTrả CVProfile hoặc null; lỗi được ghi vào error

Việc gửi FormData có hai điểm cần lưu ý:

ĐiểmChi tiết
Dữ liệu CV là một chuỗi JSONcvData được JSON.stringify rồi nhét vào một trường của FormData, không phải nhiều trường
HeaderEndpoint đặt rõ Content-Type: multipart/form-data; các endpoint upload khác (ví dụ ứng tuyển) để Axios tự đặt

Đối chiếu với backend ​

Hai route POST /cv-profiles/upsert và GET /cv-profiles/me có trong cv-profiles.controller.ts. Theo controller:

Hành vi backendHệ quả ở frontend
GET /me trả hồ sơ nháp (không lưu) dựng từ thông tin tài khoản nếu chưa có CVTrang tạo CV có dữ liệu ngay lần đầu, kể cả chưa từng lưu
Ảnh đại diện chỉ nhận JPEG, PNG, GIF, WEBP, tối đa 5 MBFrontend không kiểm tra loại và dung lượng ảnh trong upsertCVProfile; kiểm tra ở form ảnh chưa được đối chiếu
Route frontend không gọiGET /cv-profiles/check, DELETE /cv-profiles/me, POST /cv-profiles/me/deactivate, POST /cv-profiles/me/activate, GET /cv-profiles/:id, GET /cv-profiles

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

Trước khi gọi upsert, trang tạo CV kiểm tra bằng UpsertCVProfileRequestSchema và hiện toast kèm lỗi đầu tiên nếu sai. Quy tắc từng field xem Model CV Profile.

Source code liên quan ​

Hợp đồng đầy đủ: API CV Profiles của backend và controller.

Đọc tiếp: Model CV Profile, Tạo CV, Cache và invalidation.

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