Skip to content

Việc làm đã lưu ​

Tính năng cho phép ứng viên đánh dấu một tin tuyển dụng để xem lại sau và xem danh sách các tin đã lưu. Trang dành cho người muốn biết cách lưu và xem lại, và cho developer sửa nút lưu hoặc danh sách.

Vì sao cần ​

Ứng viên hiếm khi quyết định ứng tuyển ngay. Lưu tin giúp họ quay lại so sánh mà không phải tìm lại.

Đối tượng: người dùng đã đăng nhập. Khách bấm nút lưu sẽ được mời đăng nhập.

Điều kiện: chỉ tin nội bộ lưu được; tin từ nguồn ngoài không có nút lưu, xem Việc làm từ nguồn ngoài.

Đánh đổi: nút lưu đổi trạng thái ngay trước khi backend trả lời (cập nhật lạc quan) và hoàn tác nếu lỗi, nên người dùng có thể thấy nút đổi rồi đổi lại khi mạng lỗi.

Giao diện ​

Trang việc của tôi

Trang "Việc của tôi" có hai tab: việc đã ứng tuyển và việc đã lưu.

Luồng nghiệp vụ ​

Sơ đồ rút gọn hành vi của hook useJobFavorite.

Chức năngHành vi
Nút lưuCó trên thẻ kết quả tìm kiếm (tin nội bộ), thẻ tin ở trang chủ và trang chi tiết tin
Trạng thái đã lưuLấy từ danh sách mã tin trong thông tin đăng nhập; hợp nhất ba tên cũ, xem Model User
Trước khi trang hydrateNút ở trạng thái chưa lưu và bị vô hiệu, để tránh lệch giữa server và trình duyệt
Danh sách đã lưuTab "đã lưu" ở /profile?tab=my-jobs, gọi GET /users/saved-jobs với page 1, limit 10
Lưu qua chatTrợ lý AI có thể đề xuất lưu việc và chờ xác nhận, xem Trợ lý AI

WARNING

Tab "đã lưu" chỉ hiển thị 10 tin đầu tiên. my-jobs-page.tsx giữ currentPage luôn bằng 1 (không có chỗ nào đổi) và không có nút phân trang, trong khi số đếm trên tab lấy từ tổng số tin đã lưu. Người có hơn 10 tin đã lưu sẽ thấy số đếm lớn hơn số tin hiển thị.

API liên quan ​

HookEndpointDùng ở
useSaveJobMutation, useUnsaveJobMutationPOST và DELETE /users/save-jobhooks/use-job-favorite.ts
useGetSavedJobsQueryGET /users/saved-jobsprofile/pages/my-jobs-page.tsx

Bảng đầy đủ: Endpoint Users.

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

Dạng một tin đã lưu (SavedJob): _id, name, skills, company, location, salary, level, startDate, endDate, formOfWork, status tùy chọn. Phản hồi phân trang có meta: { current, pageSize, pages, total }, khác hình dạng của các danh sách khác.

Trường hợp lỗi ​

Tình huốngHành vi
Chưa đăng nhậpMở modal đăng nhập
Backend từ chốiHoàn tác nút, toast với thông điệp của backend
Không tải được danh sáchChưa kiểm tra giao diện báo lỗi riêng cho tab này

Test cases ​

TestNội dung
src/features/job/hooks/use-job-favorite.test.tsxĐọc trạng thái từ savedJobIds; nút chưa lưu trước khi hydrate; không gửi trước khi hydrate; lưu lạc quan và hoàn tác khi lỗi; bỏ lưu
src/features/auth/redux/auth.slice.test.tsHợp nhất danh sách việc đã lưu
src/features/job/components/job-card.test.tsxNhãn lưu trước và sau khi hydrate

Chưa có test cho: tab "đã lưu" của trang việc của tôi.

Source code liên quan ​

Tài liệu backend: Users.

Đọc tiếp: Theo dõi hồ sơ, Theo dõi công ty, Tìm kiếm việc làm.

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