# Kịch bản test tay — Nhập công OT (mode `workday`)

Checklist để thử bằng tay trên môi trường dev. Đánh dấu `[x]` khi đã kiểm và đúng.

**Thứ tự đề nghị:** làm nhóm **A1** và nhóm **F** trước. Đó là hai nhóm "không được phép đổi" — nếu chúng sạch thì phần mới có sai cũng không phá cái đang chạy.

**Lưu ý chung**

- Thẻ thống kê đầu trang chỉ tính **tháng hiện tại**. Dữ liệu seed cũ (2025) sẽ luôn hiện `0`. Muốn test thẻ thì phải tạo request có ngày trong tháng này.
- Số công nhập theo dạng `HH:MM`, nghĩa là **giờ công OT**, không phải giờ làm thêm. `05:00` = 5 giờ công.
- Hai màn hình có hình dạng khác nhau: **admin** = 1 nhân viên + nhiều dòng ngày; **manager** = 1 ngày + nhiều nhân viên.

---

## A. Tạo yêu cầu OT

### A1. Mode cũ phải y như trước — làm nhóm này đầu tiên

- [ ] **Admin** — tạo OT nhập khoảng giờ như bình thường → giống hệt trước
- [ ] **Manager** — tạo OT nhập khoảng giờ như bình thường → giống hệt trước
- [ ] Tạo OT khoảng giờ **trùng giờ** với OT khoảng giờ đã có → vẫn báo lỗi trùng
- [ ] Tạo OT khoảng giờ **ngắn hơn** `min_minutes_recognized` → vẫn báo lỗi dưới ngưỡng

### A2. Mode công — màn hình **admin** (1 nhân viên, nhiều dòng)

- [ ] 1 dòng: ngày + `05:00` → tạo được, không phải nhập giờ bắt đầu/kết thúc
- [ ] 3 dòng, 3 ngày khác nhau → tạo ra **3 yêu cầu**
- [ ] 2 dòng **cùng một ngày** → **bị từ chối**, và **không dòng nào** được tạo
- [ ] Nhiều dòng sai cùng lúc → lỗi **liệt kê hết** các dòng sai, không chỉ dòng đầu tiên
- [ ] Nhập số công rất nhỏ → bị từ chối, và câu lỗi **nói rõ phải nhập từ bao nhiêu trở lên**, theo **đúng đơn vị đang chọn** ở dropdown (Giờ hay Phút)
- [ ] Đổi dropdown sang **Phút** rồi nhập dưới ngưỡng → con số trong câu lỗi hiện theo phút
- [ ] Gõ **đúng** con số mà câu lỗi vừa nêu → **phải tạo được**, không bị từ chối lần nữa
- [ ] Hai dòng dưới ngưỡng, một ngày thường một ngày lễ → **mỗi dòng báo một con số tối thiểu khác nhau**

### A3. Mode công — màn hình **manager** (1 ngày, nhiều nhân viên)

- [ ] 1 ngày + `05:00` + nhiều nhân viên → tạo được
- [ ] Trong nhóm có người ca `work_ratio = 0` hoặc chưa gán ca → **bị từ chối**, lỗi **nêu tên người đó**
- [ ] Nhiều người cùng lỗi → lỗi liệt kê **tất cả**, không chỉ người đầu tiên
- [ ] Số công dưới ngưỡng, nhóm có người khác ca → **mỗi người báo một con số tối thiểu riêng**

### A4. Hai mode không chặn nhau

- [ ] Ngày X đã có OT **mode công** → tạo thêm OT **khoảng giờ** cùng ngày X → cho phép
- [ ] Ngày X đã có OT **khoảng giờ** → tạo thêm OT **mode công** cùng ngày X → cho phép
- [ ] Tạo 2 request mode công cùng ngày bằng **2 lần submit riêng** → cho phép (chỉ cấm trùng trong **cùng một** lần submit)

---

## B. Tính công

Tạo request xong thì chạy lại tính công rồi mở bảng công.

### B1. Số công OT được ghim — không ăn theo hệ số

- [ ] `05:00` cho **ngày thường** → công OT = **5 giờ công**
- [ ] `05:00` cho **ngày lễ** (hệ số 3) → công OT = **5 giờ công**, KHÔNG phải 15
- [ ] `05:00` cho **ngày nghỉ** (hệ số 2) → công OT = **5 giờ công**
- [ ] Tạo xong rồi **đổi setting hệ số OT**, tính lại → công OT **vẫn 5 giờ**
- [ ] Tạo xong rồi khai ngày đó thành **ngày lễ**, tính lại → công OT **vẫn 5 giờ**

### B2. Cột giờ OT thì ngược lại — **có** đổi theo hệ số

- [ ] `05:00`, ngày thường, hệ số 1.5, ca ratio 1 → giờ OT hiện **3h20**
- [ ] Đổi ngày đó thành lễ hệ số 3, tính lại → giờ OT hiện **1h40**, công OT **vẫn 5 giờ**

### B3. Cộng dồn

- [ ] 1 ngày có 2 request mode công `03:00` + `02:00` → công OT = **5 giờ**
- [ ] 1 ngày có cả khoảng giờ (ra 6 giờ công) lẫn mode công `05:00` → công OT = **11 giờ**
- [ ] Huỷ 1 trong 2 request → chỉ còn phần còn lại

### B4. Ngày chỉ có mode công vẫn vào lương

- [ ] Ngày không có OT khoảng giờ nào, chỉ có mode công → timesheet được đánh dấu có OT, và **số công OT xuất hiện trong bảng lương**

> Nếu bảng lương không thấy phần này → lỗi cờ `is_recognized_overtime`. Đây là lỗi nặng, báo ngay.

### B5. Phép năm — chỉ khi công ty bật "quy đổi OT thành phép"

- [ ] Nhân viên ca `work_ratio = 1`, nhập `05:00`, duyệt timesheet → cộng **đúng 5 giờ** phép
- [ ] Nhân viên ca `work_ratio = 0.5` → cộng **10 giờ** phép (= 5 ÷ 0.5). Đúng theo thiết kế, không phải lỗi

---

## C. Thẻ thống kê đầu trang

### C1. Đổi cách đếm — ảnh hưởng cả dữ liệu cũ, không liên quan mode công

- [ ] 1 request **khoảng giờ** 4 giờ, gắn **3 nhân viên** → thẻ hiện **12 giờ** (trước đây hiện 4)
- [ ] 1 request khoảng giờ 4 giờ, gắn **1 nhân viên** → vẫn 4 giờ, không đổi

> Đây là thay đổi dễ gây thắc mắc nhất khi lên production: request gắn nhiều người giờ nhân lên theo số người. Là sửa chỗ đếm thiếu trước đây, không phải lỗi mới.

### C2. Mode công được tính vào

- [ ] Tạo OT mode công **trong tháng hiện tại** → thẻ "Tổng thời gian" tăng, theo **giờ OT quy đổi** chứ không phải số giờ công đã gõ
- [ ] Tạo cho **ngày tương lai** trong tháng này, chưa có dữ liệu chấm công → thẻ vẫn tăng **ngay**

### C3. Phạm vi — hai màn hình **cố tình khác nhau**

Cần một request gắn nhiều người, và một manager chỉ quản một phần trong số đó.

- [ ] **Admin**: request gắn 5 người → tính **cả 5**
- [ ] **Manager** (quản 2 trong 5) → chỉ tính **2**, cả "Tổng thời gian" lẫn "Tổng nhân viên"
- [ ] Trên **danh sách** của manager, dòng đó hiện **2 khuôn mặt** và ghi **2**
- [ ] **Mở** chính request đó ra → danh sách chi tiết vẫn liệt kê **đủ 5 người**

> **Hai số khác nhau ở đây là đúng, không phải lỗi.** Màn hình manager chỉ nói về nhân viên
> của chính họ: dòng danh sách, thẻ "Tổng thời gian" và thẻ "Tổng nhân viên" đều đếm 2, nên ba
> chỗ khớp nhau. Màn hình admin nói về cả công ty nên đếm 5.
>
> Chỗ duy nhất manager thấy đủ 5 là khi **mở request** ra — vì đó là nội dung của chính cái
> request, không phải con số thống kê. **Dòng hiện 2 mặt mà chi tiết hiện 5 người là đúng.**

### C4. Nhân viên đã nghỉ việc vẫn được tính

- [ ] Request gắn 3 người, 1 người đã chuyển `quit_job` → vẫn tính **3 người**

> Nghỉ việc là đổi `status`, tài khoản vẫn còn. Hệ thống chưa bao giờ lọc theo đó, và giữ nguyên như vậy — request OT là bản ghi lịch sử, người đó đã làm và đã được trả công.

### C5. Hai số còn lại không đổi

- [ ] "Tổng yêu cầu" vẫn đếm theo **request**, không nhân theo người
- [ ] "Tổng nhân viên" như cũ

---

## D. Danh sách yêu cầu

- [ ] Lọc theo **mode** (`time_range` / `workday`) → trả đúng loại
- [ ] Lọc theo mode **để trống** → trả cả hai loại
- [ ] Lọc theo **khoảng ngày** → vẫn hiện **cả** request mode công. Nếu mất là bug
- [ ] Lọc khoảng ngày **kết hợp** lọc mode → cả hai điều kiện cùng áp
- [ ] Tốc độ tải trang `limit=30` → không chậm hơn trước
- [ ] Dòng mode công hiện `total_time = 00:00:00` → **đúng theo thiết kế**, FE tự hiện cột giờ công

---

## E. Email và thông báo

- [ ] Duyệt OT **mode công** → mail/noti ghi **ngày + số giờ công**, KHÔNG có khoảng giờ
- [ ] Huỷ OT **mode công** → tương tự
- [ ] Duyệt OT **khoảng giờ** → y như cũ, dạng `"18:00 - 20:00, Thứ Tư 05/11"`

---

## F. Những thứ KHÔNG được đổi — làm nhóm này sớm

Thay đổi có chạm vào `Account::getHolidays()`, là code dùng chung với phần tính công. Nếu bảng công lệch so với trước thì nguyên nhân gần như chắc chắn nằm ở đó.

- [ ] Bảng công một tháng **có ngày lễ**, dữ liệu không liên quan mode công → `date_type`, hệ số, công, phép năm **giống hệt** trước
- [ ] Nhân viên có ngày lễ áp **theo phòng ban** → vẫn nhận đúng lễ của phòng mình, **không** nhận lễ phòng khác
- [ ] Nhân viên có ngày lễ áp **theo vị trí** → tương tự
- [ ] Ngày lễ `applicable = all` → áp cho mọi người như cũ
- [ ] Nhân viên **chưa gán vị trí nào** → chỉ nhận lễ `all`, không lỗi
- [ ] Một ngày trùng **2 ngày lễ khác hệ số** → vẫn lấy hệ số **cao hơn**
- [ ] Bảng lương với dữ liệu không có mode công → không đổi
- [ ] Tạo / sửa / xoá ngày lễ → vẫn bình thường

---

## Ghi chú khi phát hiện sai

Gửi kèm: màn hình nào (admin/manager), mode nào, ngày, số đã nhập, số hiển thị, số kỳ vọng. Với lỗi bảng công thì thêm `date_type`, `overtime_ratio`, `work_ratio` của dòng timesheet đó.
