Skip to content

Dashboard nhà tuyển dụng ​

Dashboard HR cho nhà tuyển dụng thấy số liệu tuyển dụng của riêng công ty mình: tin đang mở, hồ sơ nhận được, tỷ lệ phản hồi và xu hướng. Trang dành cho nhà tuyển dụng, và developer sửa các thẻ số liệu hoặc biểu đồ.

Vì sao cần ​

Nhà tuyển dụng cần biết nhanh tình hình tuyển dụng mà không phải đếm tay từng tin và từng hồ sơ. Backend tính sẵn số liệu theo công ty của HR; frontend chỉ hiển thị.

Đối tượng: vai trò HR. Route /hr/dashboard được bảo vệ bởi HrRoute; người không phải HR bị chuyển đi (quản trị viên về /admin, người khác về /).

Đánh đổi: số liệu có thể là bản cache của backend. Giao diện luôn ghi rõ là bản cache hay bản mới cùng thời điểm tạo, để người xem biết độ mới.

Giao diện ​

Các thẻ số liệu, biểu đồ và nhãn độ mới của trang này tương tự trang quản trị; xem ảnh ở Trang quản trị. Chưa có ảnh chụp riêng của dashboard HR trong public/images/screenshots/.

Cách HR vào trang này ​

Sau khi đăng nhập, HR được chuyển tới /admin/resumes chứ không phải dashboard. Trong thanh bên của khu vực quản trị, mục "Dashboard" trỏ tới /admin; trang này chuyển HR sang /hr/dashboard ngay khi biết vai trò.

Sơ đồ rút gọn đường đi tới dashboard HR.

Nội dung ​

HrStatisticsPage gọi GET /statistics/hr-dashboard và hiển thị:

PhầnDữ liệu
Thẻ số liệucountActiveJobs, countPendingApprovalJobs, countExpiredJobs, totalApplications (StatisticsKpiGrid)
Hiệu quả xử lý hồ sơresponseRate, averageFirstResponseHours, averageMatchingScore
Biểu đồ phân bố trạng thái hồ sơapplicationStatusDistribution, thanh ngang
Biểu đồ xu hướng hồ sơapplicationTrend, vùng
Tin nhiều hồ sơ nhấttopJobsByApplications
Độ mớigeneratedAt và fromCache (StatisticsFreshness)

Biểu đồ được nạp động (dynamic) và dùng thư viện Recharts, nên phần đầu trang hiện trước và biểu đồ hiện khung chờ trong lúc tải.

Trạng thái giao diện ​

Trạng tháiKhi nàoHiển thị
Đang tảiTruy vấn chạy lần đầuKhung chờ
Không có công tyBackend trả 403Thông báo HR chưa gắn với công ty nào
LỗiLỗi khácThông báo lỗi kèm nút thử lại
RỗngKhông có dữ liệuThông báo trống
Có dữ liệuPhản hồi hợp lệThẻ, biểu đồ, nhãn độ mới

API liên quan ​

HookEndpointDùng ở
useGetHrDashboardStatsQueryGET /statistics/hr-dashboardcomponents/statistics/hr-statistics-page.tsx

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

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

Dạng IHrDashboardStats ở Endpoint Statistics. Backend giới hạn route này cho HR.

Trường hợp lỗi ​

Xem bảng trạng thái giao diện ở trên. Mã 403 được hiểu là HR chưa có công ty; chưa kiểm tra backend còn trả 403 trong trường hợp khác hay không.

Test cases ​

TestNội dung
src/components/statistics/hr-statistics-page.test.tsxHiển thị số liệu từ endpoint của HR; hiện trạng thái "không có công ty" khi bị từ chối

Chưa có test cho: HrRoute, biểu đồ, nhãn độ mới.

Source code liên quan ​

Tài liệu backend: Statistics.

Đọc tiếp: Trang quản trị, Duyệt tin tuyển dụng, Phân quyền.

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