Timesheet (Chấm công) - Software Requirement Specification

Ví dụ minh họa cách áp dụng _template.md cho một phân hệ cụ thể. Đây là nội dung mẫu rút gọn, không phải tài liệu thật.

1. Document Control & Terminology

Phiên bản	Ngày cập nhật	Người cập nhật	Nội dung thay đổi	Trạng thái
1.0	20/08/2026	Trần Thị B	Khởi tạo tài liệu	Draft

Thuật ngữ / Viết tắt	Ý nghĩa
Timesheet	Bảng chấm công
OT	Overtime (Tăng ca)

graph TD
    A[Timesheet System] --> B(Import vân tay)
    A --> C(Chốt công)
    A --> D(Duyệt tăng ca)

Functional Requirements (Chức năng)Non-Functional Requirements (Phi chức năng)

ID	Tên Yêu Cầu	Mức độ ưu tiên	Trạng thái
FR-01	Import dữ liệu chấm công từ máy vân tay	High	Done
FR-02	Chốt công cuối tháng	High	To Do

ID	Tên Yêu Cầu	Tiêu chí nghiệm thu
NFR-01	Hiệu năng	Import 1,000 bản ghi dưới 5s

Mô tả: Cho phép Admin import file dữ liệu chấm công từ máy chấm công vân tay.

Thông tin cơ bản

Actor: Timesheet Admin
Pre-condition: File dữ liệu đúng định dạng .csv đã được xuất từ máy chấm công.
Post-condition: Dữ liệu chấm công được lưu vào bảng AttendanceEvent.

Luồng chính (Main Flow):

Luồng ngoại lệ (Exception Flow):

E1: Sai định dạng file (Tại bước 3)

Nếu file không đúng định dạng quy định, hệ thống hiển thị thông báo lỗi: "File không đúng định dạng. Vui lòng kiểm tra lại mẫu.". Import bị hủy bỏ.

Quy tắc nghiệp vụ (Business Rules):

BR-01: Trùng lặp bản ghi

Nếu bản ghi chấm công (nhân viên + thời điểm) đã tồn tại, hệ thống bỏ qua bản ghi đó (không tạo trùng).

Trường (Field)	Kiểu dữ liệu	Bắt buộc	Ràng buộc
employee_id	string	Có	Phải tồn tại trong bảng Employee
punch_time	datetime	Có

Vai trò	Xem	Thêm	Sửa	Xóa
Timesheet Admin	✅	✅	✅	✅
Employee	✅ (bản thân)	❌	❌	❌

Yêu cầu (FR/NFR)	Test Case liên quan	Trạng thái
FR-01	TC-TS-01	Done