9. ĐẶC TẢ PHÂN HỆ - LOG & BÁO CÁO

Đánh giá & Xử lý Thay đổi

Quản lý việc xuất báo cáo tổng hợp hàng tháng cho từng nhân viên, làm cơ sở để tính lương (Payroll).

Function ID	Chức năng	Trạng thái hiện trạng	Phân loại thay đổi	Mức độ ảnh hưởng	Phương án xử lý	Tóm tắt nội dung thay đổi
FN-LOG-01	Xem báo cáo tổng hợp tháng	Quy trình hiện hành (Đã có)	Giữ nguyên nghiệp vụ gốc	Thấp	Tham chiếu quy trình gốc	Xem báo cáo như cũ
FN-LOG-02	Tính toán lại báo cáo (Recompute)	Quy trình hiện hành (Đã có)	Thay đổi luồng nghiệp vụ chính	Lớn	Đặc tả lại toàn bộ luồng	Tính toán lại dựa trên bảng công mới
FN-LOG-03	Chốt báo cáo (Finalize)	Tính năng bổ sung mới	Xây dựng tính năng mới	Trung bình	Đặc tả tính năng mới	Tính năng chốt push sang Payroll

Quy tắc chọn Phương án xử lý

Việc chọn Phương án xử lý cho từng chức năng ở trên tuân theo Decision Matrix chung của toàn hệ thống — xem 4.1.3 Requirement Phương án xử lý và 4.1.4 Decision Matrix.

Mẫu mô tả theo từng case

Mỗi UC bên dưới được trình bày theo đúng bố cục Case (A–F) tương ứng với Phân loại thay đổi của nó — xem định nghĩa chi tiết từng case tại 4.1.6 Mẫu mô tả theo từng case.

Phạm vi chức năng

Module này thu thập dữ liệu từ Bảng công (Timesheet) và Nghỉ phép (Leave) để tính ra các chỉ số tổng hợp cuối cùng trong tháng: Tổng số ngày làm việc, Tổng số giờ OT, Số ngày nghỉ phép đã dùng, v.v.

Business Rules dùng chung

Quy tắc báo cáo (Reporting Rules)

Phụ thuộc: Báo cáo tháng chỉ mang tính chính xác 100% khi Bảng công của tháng đó đã được chốt (Locked).
Trạng thái Finalize: Khi một báo cáo tháng được đánh dấu FINALIZED, nó sẽ được chốt cứng để gửi sang hệ thống tính lương.

Use Case Catalog

UC ID	Use Case	Vai trò thực hiện	FR	Dịch vụ tích hợp	Giao diện thao tác
UC-LOG-01	Xem báo cáo tổng hợp tháng	Employee, Manager, HR	FR-LOG-01	—	SCR-LOG-01
UC-LOG-02	Tính toán lại báo cáo	HR, Admin	—	`POST /monthly-summary/recompute`	SCR-LOG-02
UC-LOG-03	Chốt báo cáo	HR, Admin	—	`PATCH /monthly-summary/:id/finalize`	SCR-LOG-03

9.1 UC-LOG-01 - Xem báo cáo tổng hợp tháng

Mô tả: Nhân viên xem các chỉ số tổng hợp của mình trong một tháng cụ thể.

9.1

UC-LOG-01 — Xem báo cáo tổng hợp tháng

Trường hợp A · Giữ nguyên nghiệp vụ gốc GIỮ NGUYÊN NGHIỆP VỤ Tham chiếu gốc

Trạng thái: Quy trình hiện hành
Mục tiêu (BN): BN-04 / FR-LOG-01
Vai trò thực hiện: Employee, Manager, HR
Điều kiện: Áp dụng EmployeeScopeGuard
Quy tắc nghiệp vụ: RULE-LOG-01
Màn hình UI: SCR-LOG-01

Đặc tả Quy trình hiện hành (Tham chiếu gốc)

Giữ nguyên giao diện và luồng hiển thị báo cáo tổng hợp tháng cho cá nhân.

Mức độ ảnh hưởng & Regression

Không phát triển mới. Thực hiện test regression báo cáo tháng.

9.2 UC-LOG-02 - Tính toán lại báo cáo

Mô tả: HR kích hoạt việc tính toán lại báo cáo tổng hợp nếu có sai sót dữ liệu.

9.2

UC-LOG-02 — Tính toán lại báo cáo

Trường hợp D · Thay đổi luồng nghiệp vụ chính THAY ĐỔI LUỒNG CHÍNH Đặc tả lại toàn bộ

Trạng thái: Quy trình hiện hành
Mục tiêu (BN): BN-04 Báo cáo tháng
Vai trò thực hiện: HR, Admin
Điều kiện: Quyền monthly_summary.manage
Quy tắc nghiệp vụ: RULE-LOG-02
Màn hình UI: SCR-LOG-02
API Endpoint: POST /monthly-summary/recompute

Main Flow (Luồng chính)

HR chọn danh sách nhân sự, Tháng, Năm và bấm "Tính lại".
Hệ thống gọi API POST /monthly-summary/recompute.
Hệ thống xóa bản ghi cũ, quét lại toàn bộ dữ liệu từ Timesheet mới để tạo bản ghi MonthlySummary chuẩn.

9.3 UC-LOG-03 - Chốt báo cáo

Mô tả: Xác nhận báo cáo tổng hợp đã chính xác để làm căn cứ tính lương.

9.3

UC-LOG-03 — Chốt báo cáo

Trường hợp E · Tính năng xây dựng mới TÍNH NĂNG MỚI Đặc tả mới

Trạng thái: Tính năng mới bổ sung
Mục tiêu (BN): BN-04 Push Payroll
Vai trò thực hiện: HR, Admin
Điều kiện: Quyền monthly_summary.manage
Quy tắc nghiệp vụ: RULE-LOG-03
Màn hình UI: SCR-LOG-03
API Endpoint: PATCH /monthly-summary/:id/finalize

Main Flow (Luồng chính)

HR đối soát số liệu tổng hợp cuối cùng và nhấn "Chốt báo cáo".
Hệ thống gọi API PATCH /monthly-summary/:id/finalize.
Trạng thái bản ghi chuyển sang FINALIZED và kích hoạt đẩy dữ liệu sang Payroll Engine.