Phase 3 — Analytics Core Logic

Tài liệu này ghi lại quá trình hiện thực hóa các công thức phân tích hiệu suất thành code.

Thông tin	Chi tiết
Ngày hoàn thành	2026-04-17
Trạng thái	✅ Hoàn thành

1. Kiến trúc Analytics

Hệ thống analytics được xây dựng dưới dạng các hàm thuần túy (Pure Functions) để dễ dàng kiểm thử và tái sử dụng:

File chính: src/lib/analytics.ts
Dữ liệu đầu vào: Danh sách Issues và Members từ DB.
Dữ liệu đầu ra: Một object chứa đầy đủ 5 metrics + Overall Score cho mỗi thành viên.

2. Các Modules chính

Module	Chức năng
`calculateVelocity`	Tính điểm sản lượng chuẩn hóa theo team.
`calculateReliability`	Đánh giá tỉ lệ hoàn thành đúng hạn (Effective Deadline).
`calculateQuality`	Trừ điểm dựa trên task trễ hạn và task bị mở lại.
`calculateComplexity`	Tính trung bình trọng số ưu tiên.
`calculateConsistency`	Tính toán độ ổn định qua các Cycle (Statistics).

3. Đặc điểm kỹ thuật

📊 Xử lý số liệu

Sử dụng Math.round để làm tròn score về số nguyên (0-100).
Xử lý chia cho 0 (Division by zero) bằng cách gán giá trị trung tính (Neutral).
Normalization: Tự động điều chỉnh thang điểm Velocity dựa trên người làm nhiều nhất trong đội.

🚩 Detection Systems

Bottleneck Detection: Tự động gắn cờ "High Risk" cho những thành viên có số task đang thực hiện (Started) vượt quá ngưỡng (Threshold = 5).
Risk Categorization: Phân loại rủi ro thành 3 mức: Low, Medium, High.

4. Kết quả đạt được

✅ Logic tính toán chính xác theo tài liệu ANALYTICS.md.
✅ API Endpoint /api/analytics trả về kết quả JSON nhanh chóng.
✅ Hỗ trợ tính toán theo từng Cycle riêng biệt hoặc toàn thời gian.
✅ Khả năng mở rộng (Scalability) tốt khi thêm metrics mới.

Cập nhật lần cuối: 17/04/2026

Thông tin

Chi tiết

Ngày hoàn thành

2026-04-17

Trạng thái

✅ Hoàn thành

1. Kiến trúc Analytics

Hệ thống analytics được xây dựng dưới dạng các hàm thuần túy (Pure Functions) để dễ dàng kiểm thử và tái sử dụng:

File chính: src/lib/analytics.ts

Dữ liệu đầu vào: Danh sách Issues và Members từ DB.

Dữ liệu đầu ra: Một object chứa đầy đủ 5 metrics + Overall Score cho mỗi thành viên.

2. Các Modules chính

Module

Chức năng

calculateVelocity

Tính điểm sản lượng chuẩn hóa theo team.

calculateReliability

Đánh giá tỉ lệ hoàn thành đúng hạn (Effective Deadline).

calculateQuality

Trừ điểm dựa trên task trễ hạn và task bị mở lại.

calculateComplexity

Tính trung bình trọng số ưu tiên.

calculateConsistency

Tính toán độ ổn định qua các Cycle (Statistics).

3. Đặc điểm kỹ thuật

📊 Xử lý số liệu

Sử dụng Math.round để làm tròn score về số nguyên (0-100).

Xử lý chia cho 0 (Division by zero) bằng cách gán giá trị trung tính (Neutral).

Normalization: Tự động điều chỉnh thang điểm Velocity dựa trên người làm nhiều nhất trong đội.

🚩 Detection Systems

Bottleneck Detection: Tự động gắn cờ "High Risk" cho những thành viên có số task đang thực hiện (Started) vượt quá ngưỡng (Threshold = 5).

Risk Categorization: Phân loại rủi ro thành 3 mức: Low, Medium, High.

4. Kết quả đạt được

✅ Logic tính toán chính xác theo tài liệu ANALYTICS.md.

✅ API Endpoint /api/analytics trả về kết quả JSON nhanh chóng.

✅ Hỗ trợ tính toán theo từng Cycle riêng biệt hoặc toàn thời gian.

✅ Khả năng mở rộng (Scalability) tốt khi thêm metrics mới.

Cập nhật lần cuối: 17/04/2026