Chuyển tới nội dung chính

Module Statistics

Overview​

Tính số liệu tổng hợp cho hai dashboard: quản trị viên (toàn hệ thống) và nhà tuyển dụng (theo công ty). Kết quả được cache ngắn hạn.

Responsibilities​

  • Dashboard quản trị: số tin 24 giờ qua, tin đã duyệt đang mở, tin chờ duyệt, số công ty, số công ty đang tuyển, số người dùng, xu hướng 7 ngày của tin và hồ sơ, kỹ năng được cần nhiều nhất, và tình trạng xử lý hồ sơ (tỉ lệ đã đọc, đã phân tích).
  • Dashboard HR: tổng hồ sơ, hồ sơ 24 giờ qua, phân bố trạng thái hồ sơ, top tin theo số hồ sơ, tỉ lệ phản hồi, thời gian phản hồi đầu tiên trung bình, điểm phù hợp trung bình, tin hết hạn.
  • Danh sách công ty tuyển nhiều nhất cho trang chủ (cache riêng).

Danh sách trên suy từ tên các hàm trong statistics.service.ts; định nghĩa chính xác từng chỉ số (ví dụ "tỉ lệ phản hồi") chưa được kiểm tra. Trạng thái: Chưa xác minh.

Architecture​

Thành phầnFile
Controller (2 route, /api/v1/statistics)statistics.controller.ts
Service tính số liệustatistics.service.ts
Cachestatistics-cache.service.ts
Hằng sốstatistics.constants.ts

Dependencies​

Không import module nghiệp vụ nào. Module tự đăng ký schema của các collection cần đọc (MongooseModule.forFeature) và truy vấn trực tiếp. Nhiều module khác import statistics để xóa cache khi dữ liệu đổi (jobs, companies, resumes, queues).

Business Rules​

DashboardRouteQuyềnCache (TTL)Khóa
Quản trịGET /statistics/admin-dashboardSUPER ADMIN15 phútdashboard:admin
HRGET /statistics/hr-dashboardHR (quản trị viên không gọi được)3 phútdashboard:hr:<companyId>
Top công ty tuyển dụngtrong GET /companies/top-hiringcông khai5 phúthomepage:top-hiring-companies:<limit>

Giới hạn: top kỹ năng 10, top tin 5, top công ty tuyển dụng 20 (statistics.constants.ts).

Khi dữ liệu liên quan đổi, các service khác gọi clearScopedDashboardCaches(companyId) để xóa cache của công ty tương ứng và cache quản trị.

Data Model​

Chỉ đọc từ users, companies, jobs, resumes. Không có collection riêng.

API​

GET /statistics/admin-dashboard, GET /statistics/hr-dashboard. Chi tiết ở 05-api/endpoints/statistics.md (Phase 3).

Known Limitation​

  • Cache dùng CACHE_MANAGER, nằm trong bộ nhớ và không dùng chung giữa instance (data-flow). Hệ quả: số liệu có thể khác nhau giữa các instance trong tối đa vài phút.
  • GET /statistics/hr-dashboard chỉ cho vai trò HR, nên quản trị viên không xem được dashboard của một công ty cụ thể qua route này.
  • Số liệu "chat AI" của quản trị viên nằm ở GET /chat/admin/usage/*, không thuộc module này.

Testing​

1 file test (statistics.service.spec.ts).

Source References​

src/statistics/.