Skip to content

Tạo và xuất CV ​

Trang này vẽ trình tự từ lúc ứng viên mở trình tạo CV, nhập và lưu dữ liệu, đến lúc xem trước và tải PDF. Dành cho người cần biết dữ liệu đi qua những đâu, và vì sao xem trước chỉ hiện dữ liệu đã lưu.

Vì sao tách bước lưu và bước xem trước ​

Trình tạo CV giữ mọi thay đổi trong state của trang cho tới khi người dùng bấm lưu; mỗi lần lưu gửi toàn bộ CV lên backend một lượt. Trang xem trước không nhận dữ liệu từ trang tạo mà tải lại CV từ backend. Vì vậy thay đổi chưa lưu sẽ không xuất hiện trong bản xem trước hay file PDF.

Luồng ​

Sơ đồ rút gọn: dữ liệu chỉ đi qua backend khi lưu, và trang xem trước luôn đọc lại từ backend.

BướcGiải thích
3Backend trả hồ sơ nháp dựng từ tài khoản nếu chưa có CV; trang chuẩn hóa dữ liệu trước khi dùng
5Mỗi nhóm nội dung có hộp thoại riêng; dữ liệu được ghi vào state của trang, chưa gửi đi
7Nếu sai, hiện toast kèm đường dẫn field và lỗi đầu tiên; không gọi API
8Dữ liệu CV là chuỗi JSON trong trường cvData; ảnh đại diện (nếu vừa chọn) là trường avatar
10Sau khi lưu, trang tải lại CV rồi chuẩn hóa để hiển thị, và xóa file ảnh đang giữ
11Nút xem trước bị vô hiệu khi mức hoàn thành dưới 15%
14Người dùng chọn mẫu classic, modern hoặc minimal; xem trước PDF là tùy chọn bật tắt
15PDF được dựng ngay trên trình duyệt, không qua backend

Ảnh đại diện trong PDF ​

Ảnh nằm ở backend nên trình duyệt có thể bị chặn khi trình dựng PDF tải ảnh (CORS). Hàm getProxiedImageUrl đổi địa chỉ ảnh của backend thành /api/proxy-image?url=...; route này tải ảnh phía server rồi trả lại cùng nguồn gốc. Ảnh ở máy chủ khác, ảnh dạng data: hoặc đường dẫn tương đối được giữ nguyên.

Route chỉ cho phép tải từ localhost:8081 và host lấy từ NEXT_PUBLIC_API_URL (sau khi bỏ http:// hoặc https://), nên không thể dùng để tải địa chỉ tùy ý.

Nhánh lỗi ​

Tình huốngHành vi
Không tải được CVuseCV ghi lỗi; trang hiện toast lỗi chung
Dữ liệu không hợp lệToast "dữ liệu không hợp lệ" kèm lỗi đầu tiên, không lưu
Backend từ chối lúc lưuupsertCV trả null và ghi lỗi vào error
Chưa có CV ở trang xem trướcHiện thông báo và nút quay lại tạo CV
Tạo PDF lỗiHiện toast lỗi; nút tải bấm lại được

Source code liên quan ​

Backend: Use case quản lý CV.

Đọc tiếp: Tạo CV, Xuất CV ra PDF, Endpoint CV Profiles.

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