Skip to content

Endpoint Statistics ​

Trang này liệt kê 2 endpoint thống kê trong statistics.api.ts: số liệu cho dashboard quản trị và dashboard nhà tuyển dụng. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao có hai endpoint ​

Quản trị viên cần cái nhìn toàn hệ thống (số việc làm, công ty, người dùng, xu hướng, kỹ năng được cần nhiều). Nhà tuyển dụng chỉ cần số liệu của công ty mình (tin đang mở, hồ sơ nhận được, tỷ lệ phản hồi). Backend tách hai route và giới hạn vai trò riêng cho từng route.

Bảng endpoint ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useGetAdminDashboardStatsQueryGET /statistics/admin-dashboardKhôngCung cấp Statisticscomponents/statistics/admin-statistics-page.tsx
useGetHrDashboardStatsQueryGET /statistics/hr-dashboardKhôngCung cấp Statisticscomponents/statistics/hr-statistics-page.tsx

Đường dẫn được lấy từ DASHBOARD_API_ENDPOINTS trong src/shared/config/dashboard.config.ts.

Đối chiếu với backend ​

Hai route có trong statistics.controller.ts. Theo controller, admin-dashboard chỉ cho SUPER ADMIN và hr-dashboard chỉ cho HR; chưa kiểm tra backend có cho SUPER ADMIN gọi route của HR hay không.

Dữ liệu ​

Cả hai phản hồi có generatedAt (thời điểm tạo) và fromCache (backend trả bản đã cache hay không). Giao diện dùng hai trường này để hiện độ mới của số liệu.

DạngField chính
IAdminDashboardStatscountActiveJobs, countPendingApprovalJobs, countHiringCompanies, countCompanies, countUsers, jobTrend, applicationTrend, topDemandedSkills, resumeProcessingHealth, generatedAt, fromCache
IHrDashboardStatscountActiveJobs, countPendingApprovalJobs, countExpiredJobs, totalApplications, applicationStatusDistribution, applicationTrend, topJobsByApplications, responseRate, averageFirstResponseHours, averageMatchingScore, generatedAt, fromCache

Các type nằm ở src/shared/types/dashboard.d.ts và là type TypeScript thuần, không có schema Zod kiểm tra lúc chạy. IAdminDashboardStats còn có thêm countJobs24h; xem file để biết đủ field.

Source code liên quan ​

Hợp đồng đầy đủ: API Statistics của backend và controller.

Đọc tiếp: Cache và invalidation, Endpoint Resumes, Tham chiếu dữ liệu backend.

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