Skip to content

Danh bạ công ty ​

Tính năng cho phép mọi người xem danh sách công ty đang tuyển, tìm theo tên và mở trang chi tiết của từng công ty cùng các tin đang mở. Trang dành cho người muốn biết các phần của trang công ty, và cho developer sửa danh sách hoặc trang chi tiết.

Vì sao cần ​

Ứng viên muốn biết công ty trước khi ứng tuyển, không chỉ vị trí. Trang công ty gom thông tin giới thiệu và các tin đang mở ở một nơi.

Đối tượng: mọi người, kể cả khách. Theo dõi công ty cần đăng nhập, xem Theo dõi công ty.

Đánh đổi: cả danh sách và chi tiết được render trên server. Dữ liệu công ty được giữ trong cache Next.js tới 1 giờ, còn tin đang mở của công ty tới 1 phút, nên công ty mới hoặc thông tin vừa sửa có thể chưa hiện ngay; xem Chiến lược cache.

Giao diện ​

Danh sách công ty

Trang danh sách công ty: ô tìm theo tên và lưới thẻ công ty.

Chi tiết công ty

Trang chi tiết: thông tin công ty, nút theo dõi, các tin đang mở, liên hệ và chia sẻ.

Danh sách /companies ​

Chức năngHành vi
Tìm theo tênChỉ chạy khi người dùng bấm tìm, không chạy khi đang gõ; kết quả lọc bằng name=/<từ khóa>/i
Phân trangMặc định 9 công ty mỗi trang
URLTừ khóa, trang và số lượng được ghi vào URL (q, page, limit) bằng router.replace, không cuộn trang
Dữ liệu đầuRender trên server; khi trạng thái giống ban đầu thì bỏ qua truy vấn RTK Query
Thẻ công tyHiện logo, mô tả rút gọn (đã bỏ thẻ HTML) và số vị trí đang mở; thẻ không có nút theo dõi

Trang chi tiết /companies/<id> ​

PhầnNội dung
Dữ liệufetchPublicCompanyById và fetchPublicJobs (tin còn mở của công ty, 20 tin) chạy song song trên server; không có công ty thì trang 404
SEOMetadata theo công ty và dữ liệu có cấu trúc Organization dạng application/ld+json
Giới thiệuPhần đầu, tổng quan và mô tả được dựng ngay trong page.tsx
Tin đang mởJobListing lọc tin còn mở của công ty; có thể lọc thêm theo tên tin và địa điểm, khi đó gọi GET /jobs bằng RTK Query
Liên hệ, chia sẻCompanyContact, ShareCompany
Theo dõiCompanyFollowButton

Luồng nghiệp vụ ​

Sơ đồ rút gọn hành trình xem công ty.

API liên quan ​

Hook hoặc hàmEndpointDùng ở
fetchPublicCompaniesGET /companiescompanies/page.tsx
useGetCompaniesQueryGET /companiescompanies-page-client.tsx
fetchPublicCompanyByIdGET /companies/:idcompanies/[id]/page.tsx
fetchPublicJobs, useGetJobsQueryGET /jobsTin đang mở của công ty

Bảng đầy đủ: Endpoint Companies, Endpoint Jobs.

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

Dạng dữ liệu: Model Company.

Trường hợp lỗi ​

Tình huốngHành vi
Công ty không tồn tại hoặc backend lỗiTrang 404 (lỗi bị trả thành null)
Server không lấy được danh sách đầuDanh sách tải lại bằng RTK Query khi mở

Test cases ​

TestNội dung
src/app/[locale]/(main)/companies/companies-page-client.test.tsxChữ ở phần đầu trang; URL không đổi khi đang gõ; URL đổi sau khi bấm tìm
src/features/company/components/company-card.test.tsxThẻ ưu tiên mô tả, số vị trí đang mở, không có nút theo dõi

Chưa có test cho: trang chi tiết công ty, JobListing, các phần giới thiệu.

Source code liên quan ​

Tài liệu backend: Companies.

Đọc tiếp: Theo dõi công ty, Tìm kiếm việc làm, Rendering và SEO.

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