Skip to content

Tìm kiếm và lọc việc làm ​

Trang này vẽ trình tự từ lúc ứng viên mở /jobs đến khi đổi bộ lọc và thấy kết quả mới. Dành cho người cần biết khi nào dữ liệu đến từ server, khi nào từ RTK Query, và vì sao đổi bộ lọc không làm trang nhảy.

Vì sao tách bước nhập và bước áp dụng ​

Người dùng thường chỉnh vài ô lọc (từ khóa, địa điểm, loại hình, cấp bậc, mức lương) rồi mới muốn xem kết quả. Nếu mỗi lần chỉnh đều gọi API thì vừa tốn request vừa làm danh sách nhấp nháy. Vì vậy useJobList giữ hai trạng thái: bản nháp (đang chỉnh) và đã áp dụng (đang hiển thị). Chỉ khi áp dụng, bản nháp mới thành trạng thái đã áp dụng và gây ra request.

Tab nguồn (tất cả, nội bộ, bên ngoài), sắp xếp, trang và số kết quả mỗi trang áp dụng ngay, không qua bản nháp.

Luồng ​

Sơ đồ rút gọn: URL là nguồn của trạng thái ban đầu, và mỗi lần áp dụng bộ lọc URL được ghi lại.

BướcGiải thích
2Giá trị lạ hoặc không hợp lệ trong URL bị thay bằng mặc định; chi tiết bảng tham số ở Phân trang và lọc
3Lời gọi phía server dùng fetch với revalidate 60 giây; nếu lỗi trả null
5shouldUseInitialData đúng khi trạng thái hiện tại bằng trạng thái ban đầu, khi đó useSearchJobsQuery được skip
8applyFilters luôn đưa page về 1
9Ghi URL bằng router.replace, nên không thêm mục vào lịch sử trình duyệt
10Khi trạng thái khác trạng thái ban đầu, truy vấn RTK Query chạy; bước 9 và 10 diễn ra song song

Các thao tác khác ​

Thao tácHành vi
Đổi trangsetPage, áp dụng ngay
Đổi sắp xếpsetSortBy, về trang 1
Đổi tab nguồnsetSource, về trang 1
Đặt lạiresetAllFilters xóa bản nháp, bộ lọc, sắp xếp, và đưa nguồn về all
Ngăn lọc trên điện thoạiTruy vấn thứ hai skip đến khi ngăn mở, dùng để đếm số kết quả theo bản nháp trước khi áp dụng

Nhánh lỗi ​

Tình huốngHành vi
Server không lấy được dữ liệu đầuinitialData là null, nên useJobList không dùng dữ liệu server và RTK Query chạy ngay
RTK Query lỗiDanh sách rỗng; toast chung chỉ hiện với 403, 500 hoặc mất mạng, xem Xử lý lỗi

Backend trộn tin nội bộ và tin ngoài, sắp xếp và phân trang; phần đó thuộc tài liệu backend, không lặp lại ở đây.

Source code liên quan ​

Backend: Quy trình tìm kiếm hợp nhất.

Đọc tiếp: Tìm kiếm việc làm, Phân trang và lọc, Chiến lược cache.

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