6. ĐẶC TẢ PHÂN HỆ - CHẤM CÔNG

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

Đánh giá mức độ thay đổi so với quy trình hiện tại (nếu có).

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-ATT-01	Tự chấm công (Check-in/Check-out)	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ích hợp logic nhận diện khuôn mặt
FN-ATT-02	Chấm công thủ công (Bởi HR/Admin)	Quy trình hiện hành (Đã có)	Cập nhật điều kiện nghiệp vụ phụ	Thấp	Đặc tả bổ sung (Delta Spec)	Bổ sung trường lý do khi chấm tay
FN-ATT-03	Xem dữ liệu chấm cô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	Giữ nguyên hiển thị
FN-ATT-04	Giải trình chấm công	Tính năng bổ sung mới	Xây dựng tính năng mới	Lớn	Đặc tả tính năng mới	Quy trình giải trình hoàn toàn mới

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 quản lý việc ghi nhận sự kiện có mặt của nhân viên (Check-in/Check-out), bao gồm cả việc nhân viên tự chấm công qua thiết bị, HR chấm công thủ công và quy trình giải trình sự cố chấm công.

Business Rules dùng chung

Chính sách chấm công (Attendance Policy)

Event Type: Mỗi sự kiện chấm công phải được phân loại là IN, OUT hoặc UNKNOWN.
Phân quyền duyệt: Giải trình chấm công của nhân viên phải được duyệt bởi Manager trực tiếp hoặc HR/Admin.

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-ATT-01	Tự chấm công	Employee	FR-ATT-01	`POST /attendance/events`	SCR-ATT-01
UC-ATT-02	Chấm công thủ công (Bởi HR/Admin)	HR, Admin	—	—	SCR-ATT-02
UC-ATT-03	Xem dữ liệu chấm công	Employee, Manager, HR	—	—	SCR-ATT-03
UC-ATT-04	Giải trình chấm công	Employee, Manager/HR	FR-ATT-02	`POST /attendance/explanations`	SCR-ATT-04

6.1 UC-ATT-01 - Tự chấm công

Mô tả: Nhân viên gửi tín hiệu chấm công thông qua thiết bị di động hoặc đồng bộ từ máy chấm công.

6.1

UC-ATT-01 — Tự chấm công

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-02 Tự động chấm công
Vai trò thực hiện: Employee
Điều kiện: Đã đăng nhập hệ thống
Quy tắc nghiệp vụ: RULE-ATT-01
Màn hình UI: SCR-ATT-01
API Endpoint: POST /attendance/events

Main Flow (Luồng chính)

Thiết bị của nhân viên gọi API POST /attendance/events gửi tọa độ GPS / Face Data.
Hệ thống nhận diện loại sự kiện (IN/OUT) dựa trên cấu hình ca làm việc.
Lưu bản ghi AttendanceEvent vào cơ sở dữ liệu.
Cập nhật trạng thái ngày công thực tế của nhân viên.

Exception Flow (Ngoại lệ)

E1 - Thiết bị không hợp lệ hoặc giả mạo: Hệ thống chặn và từ chối ghi nhận sự kiện.

6.2 UC-ATT-02 - Chấm công thủ công (Bởi HR/Admin)

Mô tả: HR hoặc Admin can thiệp vào dữ liệu chấm công của nhân viên (thêm, sửa, xóa).

6.2

UC-ATT-02 — Chấm công thủ công

Trường hợp C · Cập nhật điều kiện phụ CẬP NHẬT ĐIỀU KIỆN PHỤ Đặc tả bổ sung

Trạng thái: Quy trình hiện hành
Mục tiêu (BN): BN-02
Vai trò thực hiện: HR, Admin
Điều kiện: Quyền attendance.review_explanations
Quy tắc nghiệp vụ: RULE-ATT-02
Màn hình UI: SCR-ATT-02

As-Is (Hiện trạng)

HR/Admin sửa giờ chấm công trực tiếp mà không bắt buộc nhập lý do thay đổi.

To-Be & Delta (Mục tiêu thay đổi)

Bổ sung trường Lý do bắt buộc khi chấm tay/sửa dữ liệu công để lưu vết Nhật ký theo dõi hệ thống phục vụ thanh tra.

6.3 UC-ATT-03 - Xem dữ liệu chấm công

Mô tả: Nhân viên xem dữ liệu chấm công cá nhân, hoặc Quản lý xem dữ liệu của cấp dưới.

6.3

UC-ATT-03 — Xem dữ liệu chấm cô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-02
Vai trò thực hiện: Employee (Tự xem), Manager, HR
Điều kiện: Áp dụng EmployeeScopeGuard
Quy tắc nghiệp vụ: RULE-ATT-03
Màn hình UI: SCR-ATT-03

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

Giữ nguyên tính năng xem bảng lịch sử chấm công theo tháng hiện tại.

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

Không phát triển mới. Chỉ thực hiện test regression tính năng phân quyền hiển thị.

6.4 UC-ATT-04 - Giải trình chấm công

Mô tả: Nhân viên nộp giải trình cho các ngày bị thiếu công hoặc vi phạm nội quy và chờ duyệt.

6.4

UC-ATT-04 — Giải trình chấm công

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-02 Tự động giải trình
Vai trò thực hiện: Employee (Nộp), Manager/HR (Duyệt)
Điều kiện: Quyền attendance.review_explanations
Quy tắc nghiệp vụ: RULE-ATT-04
Màn hình UI: SCR-ATT-04
API Endpoint: POST /attendance/explanations

Main Flow (Luồng chính)

Nhân viên chọn ngày vi phạm (thiếu công/đi muộn), điền lý do và nộp đơn POST /attendance/explanations.
Đơn được lưu hệ thống với trạng thái PENDING.
Manager/HR truy cập danh sách đơn chờ duyệt GET /attendance/explanations/pending.
Manager/HR gọi API PATCH /attendance/explanations/:id/decide để phê duyệt hoặc từ chối.
Nếu duyệt, hệ thống tự động bù giờ công/bản ghi chấm công tương ứng.