Skip to content

Xuất CV ra PDF ​

Tính năng cho phép ứng viên xem CV theo ba mẫu và tải về dạng PDF ngay trên trình duyệt. Trang dành cho người muốn biết các mẫu và giới hạn của file PDF, và cho developer sửa mẫu hoặc xử lý ảnh, font.

Vì sao cần ​

CV đã nhập trên DevLink chỉ có giá trị khi ứng viên mang đi nộp được. Xuất PDF cho phép dùng CV ở nơi khác. File được dựng ngay trên máy người dùng nên backend không phải xử lý.

Đối tượng: người dùng đã có CV được lưu. Chưa có CV thì trang hiện thông báo và nút quay lại tạo CV.

Đánh đổi:

  • PDF dựng bằng @react-pdf/renderer trên trình duyệt nên chỉ chạy phía client và có thể chậm khi CV dài.
  • Xem trước trên trang và file PDF dùng hai bộ mẫu riêng (HTML và PDF), nên hai nơi có thể lệch nhau; chưa có ghi chép về lý do.

Giao diện ​

Xem trước CV

Trang xem trước: chọn mẫu, bật tắt xem trước PDF và nút tải xuống.

Ba mẫu ​

MẫuGiá trịBản xem trước trên trangBản PDF
Cổ điểnclassicfeatures/cv-builder/components/templates/classic/ClassicTemplate.tsxfeatures/cv-builder/components/pdf/templates/classic/ClassicTemplate.tsx
Hiện đạimodernfeatures/cv-builder/components/templates/modern/ModernTemplate.tsxfeatures/cv-builder/components/pdf/templates/modern/ModernTemplate.tsx
Tối giảnminimalfeatures/cv-builder/components/templates/minimal/MinimalTemplate.tsxfeatures/cv-builder/components/pdf/templates/minimal/MinimalTemplate.tsx

Mẫu mặc định là classic. Khổ giấy là A4. CVPdfDocument chọn mẫu PDF theo giá trị template; giá trị lạ rơi về classic.

Luồng nghiệp vụ ​

Sơ đồ rút gọn; trình tự kỹ thuật, kể cả xử lý ảnh, xem Tạo và xuất CV.

Chi tiết kỹ thuật ​

Hạng mụcCách làm trong code
Tải filePDF chỉ được dựng khi bấm nút: nút tải @react-pdf/renderer và CVPdfDocument bằng import(), gọi pdf(...).toBlob() rồi tải file qua object URL. Trong lúc dựng, nút hiện spinner và không bấm được
Tên fileCV_<họ tên, khoảng trắng thành _>_<ngày YYYY-MM-DD>.pdf
Xem trước PDFPDFViewer, bật tắt bằng nút; chỉ chạy trên client và được tải bằng next/dynamic khi bật lần đầu
Khóa dựng lạigenerateCVDataKey ghép mẫu, thời điểm cập nhật và số mục học vấn, kinh nghiệm, kỹ năng, dự án để buộc dựng lại PDF khi dữ liệu đổi; code ghi chú đây là cách tránh lỗi Eo is not a function của react-pdf
FontRoboto, đăng ký từ /fonts/Roboto-Regular.ttf, -Medium, -Bold, -Italic trong public/fonts/
Ảnh đại diệngetProxiedImageUrl đổi ảnh của backend sang /api/proxy-image?url=... để tránh CORS

Proxy ảnh trả ảnh với Cache-Control: public, max-age=31536000, immutable và Access-Control-Allow-Origin: *. Route chỉ cho tải từ localhost:8081 và host lấy từ NEXT_PUBLIC_API_URL sau khi bỏ http:// hoặc https://. Nếu biến này chứa đường dẫn (ví dụ /api/v1) thì chuỗi sau khi bỏ giao thức vẫn có đường dẫn và sẽ không khớp với url.host; chưa kiểm tra giá trị thật trên môi trường triển khai.

API liên quan ​

Không có endpoint riêng: PDF dựng hoàn toàn ở trình duyệt. Dữ liệu đầu vào lấy bằng GET /cv-profiles/me, xem Endpoint CV Profiles. Ảnh đi qua route nội bộ GET /api/proxy-image.

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

Dữ liệu vào mẫu là ICVProfile, xem Model CV Profile. Chưa có kiểm tra riêng cho PDF; dữ liệu đã được kiểm tra khi lưu.

Trường hợp lỗi ​

Tình huốngHành vi
Chưa có CVThông báo và nút tạo CV
Dựng PDF lỗiHiện toast lỗi; nút tải bấm lại được
Ảnh không tải đượcProxy trả lỗi; ảnh không hiện (chưa kiểm tra cách mẫu xử lý ảnh lỗi)
URL ảnh nằm ngoài danh sách cho phépProxy trả 403
Thiếu tham số urlProxy trả 400

Test cases ​

TestNội dung
src/features/cv-builder/lib/pdf/image-helpers.test.tsHàm xử lý địa chỉ ảnh cho PDF
src/features/cv-builder/components/pdf/download-pdf-button.test.tsxChưa bấm thì chưa dựng PDF; bấm thì dựng đúng mẫu và tải file; lỗi thì hiện toast và nút bấm lại được

Chưa có test cho: các mẫu PDF, trang xem trước, route proxy-image.

Source code liên quan ​

Đọc tiếp: Tạo CV, Tạo và xuất CV, Giao tiếp API.

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