# Một lượt test đầy đủ — Nhập công OT (mode `workday`)

Bản **chạy theo thứ tự** của `manual-test.md`. Khác biệt: ở đây gom theo *lượt dựng dữ liệu*
chứ không gom theo chủ đề, để chạy một mạch từ trên xuống mà không phải quay lại dựng lại dữ
liệu. Có thêm các nhánh lỗi và các chỗ hồi quy mà bản kia không nêu.

Mỗi mục ghi rõ **màn hình nào**: `[A]` = admin, `[M]` = manager (employee), `[A+M]` = phải thử
cả hai.

Đánh `[x]` khi đã kiểm và đúng. Sai thì ghi lại theo mẫu ở cuối file.

---

## 0. Dựng dữ liệu — làm một lần, dùng cho toàn bộ bài test

Mọi ngày test đều nằm trong **tháng hiện tại**, vì thẻ thống kê đầu trang chỉ tính tháng này.
Dưới đây dùng tháng 11/2026 làm ví dụ; đổi theo tháng bạn đang test.

**Công ty C — ghi lại giá trị cũ trước khi sửa, cuối bài trả về như cũ:**

- [ ] `overtime_ratio` = `1.5`
- [ ] `overtime_day_off_ratio` = `2`
- [ ] `min_minutes_recognized` = `30`
- [ ] `overtime_option` — ghi lại giá trị hiện tại: `________________`

**Nhân viên:**

- [ ] **NV-A** — ca `work_ratio = 1`, áp T2–T6
- [ ] **NV-B** — ca `work_ratio = 0.5`, áp T2–T6
- [ ] **NV-C** — **chưa gán ca nào** (dùng cho nhánh lỗi mục 4)
- [ ] **NV-D** — có ca bình thường, sẽ **xoá** ở mục 7
- [ ] **Manager M** — quản NV-A và NV-B, **không** quản NV-C, NV-D

**Ngày lễ:**

- [ ] **Lễ-H** — 20/11/2026 (Thứ Sáu), `work_ratio = 3`, `applicable = all`
- [ ] **Lễ-H0** — 13/11/2026 (Thứ Sáu), `work_ratio` **để trống** (dùng cho nhánh lỗi mục 4)

**Các ngày sẽ dùng:**

| Ký hiệu | Ngày | Loại |
|---|---|---|
| `D-thường` | 12/11/2026 | Thứ Năm, ngày làm bình thường |
| `D-lễ` | 20/11/2026 | Lễ-H, hệ số 3 |
| `D-nghỉ` | 15/11/2026 | Chủ Nhật, ngoài `applied_days` |
| `D-T7a` | 14/11/2026 | Thứ Bảy tuần này |
| `D-T7b` | 21/11/2026 | Thứ Bảy tuần kế (khác chẵn/lẻ với `D-T7a`) |
| `D-lỗi` | 13/11/2026 | Lễ-H0, hệ số trống |

---

## 1. Hồi quy trước — chưa tạo gì cả

Làm **trước tiên**. Change này có sửa `Account::getHolidays()`, là code dùng chung với tính
công. Nếu nhóm này đã sai thì mọi thứ sau đều vô nghĩa.

**Chạy script đối chiếu trước khi soi bằng mắt.** Nó dựng lại bản cũ lấy từ `develop`, tự tạo
7 ngày lễ phủ đủ các kiểu phạm vi, so sánh trên toàn bộ account rồi rollback:

```
docker exec hrm-api-app-1 php artisan tinker /var/www/openspec/changes/add-overtime-workday-input/verify-holiday-refactor.php
```

- [ ] Mọi dòng `lech` đều bằng **0**
- [ ] Mục `[7]`: số query cho 1 account **cũ = mới**, và số query hàng loạt **không tăng theo số account**
- [ ] Mục `[4]`, `[5]`, `[6]` đúng như ghi chú in kèm

Script phủ được phần *chọn ngày lễ nào*. Nó **không** phủ được phần *ngày lễ đó ảnh hưởng gì
tới bảng công và bảng lương* — phần đó vẫn phải xem bằng mắt theo các mục dưới đây.

- [ ] Chụp/ghi lại bảng công **tháng có ngày lễ** của NV-A: `date_type`, `overtime_ratio`,
      `work_ratio`, công, giờ OT, công OT, phép năm
- [ ] Chạy lại tính công cho đúng tháng đó → **mọi cột giống hệt** bản vừa ghi
- [ ] Ghi lại bảng lương tháng đó → chạy lại → **không đổi**
- [ ] NV có ngày lễ áp **theo phòng ban** → chỉ nhận lễ phòng mình, không nhận lễ phòng khác
- [ ] NV có ngày lễ áp **theo vị trí** → tương tự
- [ ] Ngày lễ `applicable = all` → áp cho mọi người như cũ
- [ ] NV **chưa gán vị trí nào** → chỉ nhận lễ `all`, không văng lỗi
- [ ] Một ngày trùng **2 lễ khác hệ số** → vẫn lấy hệ số **cao hơn**
- [ ] Lễ `applicable = custom` **không gắn ai** → không áp cho bất kỳ ai
- [ ] Lễ **nhiều ngày** (`repeat = day`, `times = 1`) → phủ đúng 2 ngày liên tiếp, ngày thứ ba
      quay về ngày thường. Cả ngưỡng tối thiểu của mode công lẫn `date_type` trên bảng công
      đều phải theo đúng phạm vi đó
- [ ] Tạo / sửa / xoá một ngày lễ → bình thường, danh sách lễ không đổi thứ tự

---

## 2. Mode cũ `time_range` phải y hệt trước

- [ ] `[A]` Tạo OT khoảng giờ cho NV-A, `D-thường` 18:00–20:00 → tạo được
- [ ] `[M]` Tạo OT khoảng giờ cho NV-A + NV-B, `D-thường` 20:30–22:00 → tạo được
- [ ] `[A+M]` Tạo OT khoảng giờ **trùng giờ** với cái vừa tạo → vẫn báo lỗi trùng
- [ ] `[A+M]` Tạo OT khoảng giờ **ngắn hơn** 30 phút → vẫn báo lỗi dưới ngưỡng
- [ ] `[A]` **Không gửi** `input_mode` trong body (gọi thẳng API hoặc dùng client cũ) →
      hành xử y như trước, bản ghi lưu `input_mode = time_range`
- [ ] `[A]` Gửi 3 dòng `times`, trong đó **dòng thứ 2 trùng giờ** với OT đã có →
      bị từ chối và **không dòng nào được tạo** (kể cả dòng 1)

> Mục cuối là chỗ tôi nghi ngờ: nhánh `time_range` mở transaction rồi `return` lỗi mà không
> `rollBack()`. Nếu dòng 1 vẫn nằm trong DB sau khi bị từ chối → **là bug, báo ngay**.

---

## 3. Mode `workday` — tạo thành công

### 3a. Màn hình admin — 1 nhân viên, nhiều dòng ngày

- [ ] `[A]` 1 dòng: NV-A + `D-thường` + `05:00` → tạo được, **không** phải nhập giờ bắt đầu/kết thúc
- [ ] `[A]` 3 dòng, 3 ngày khác nhau (`D-thường`, `D-lễ`, `D-nghỉ`) → tạo ra **3 yêu cầu riêng**
- [ ] `[A]` Bản ghi tạo ra có `from` = 00:00:00 của ngày đó, `to` rỗng, `total_time = 00:00:00`
- [ ] `[A]` Đổi dropdown đơn vị sang **Phút**, nhập `300` phút → kết quả giống hệt `05:00`

### 3b. Màn hình manager — 1 ngày, nhiều nhân viên

- [ ] `[M]` `D-thường` + `05:00` + NV-A và NV-B → tạo được **1 yêu cầu gắn 2 người**
- [ ] `[M]` Chọn theo **phòng ban / vị trí** thay vì chọn tay từng người → vẫn tạo được
- [ ] `[M]` Bản ghi tạo ra giống hình dạng ở 3a

### 3c. Hai mode không chặn nhau

- [ ] `[A+M]` `D-thường` đã có OT **mode công** → tạo thêm OT **khoảng giờ** cùng ngày → **cho phép**
- [ ] `[A+M]` `D-thường` đã có OT **khoảng giờ** → tạo thêm OT **mode công** cùng ngày → **cho phép**
- [ ] `[A]` Tạo 2 request mode công cùng một 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)
- [ ] `[A]` Tạo OT khoảng giờ bắt đầu **đúng 00:00** của ngày đang có OT mode công → cho phép,
      không bị nhầm là trùng

---

## 4. Mode `workday` — các nhánh bị từ chối

### 4a. Trùng ngày trong cùng một submit — chỉ có ở admin

- [ ] `[A]` 2 dòng **cùng một ngày** → từ chối với `overtime_duplicated_workday_date`
- [ ] `[A]` Sau khi bị từ chối, **không dòng nào** trong submit đó được tạo
- [ ] `[A]` 4 dòng trong đó dòng 2 và dòng 4 sai → `entries` liệt kê **cả hai**, mỗi dòng kèm
      `date` và `status_code` riêng
- [ ] `[A]` `status_code` và `message` ở cấp ngoài cùng mô tả **lỗi đầu tiên** (để client cũ
      chỉ đọc 2 trường này vẫn chạy)

### 4b. Dưới ngưỡng tối thiểu

Ngưỡng tính theo **giờ OT**, nên quy ra số công tối thiểu **khác nhau theo từng ngày và từng
người**: `min × hệ_số_OT × work_ratio_ca`. Với `min = 30` phút:

| Trường hợp | Hệ số OT | work_ratio | Công tối thiểu |
|---|---|---|---|
| NV-A, `D-thường` | 1.5 | 1 | 45 phút |
| NV-A, `D-lễ` | 3 | 1 | 90 phút |
| NV-A, `D-nghỉ` | 2 | 1 | 60 phút |
| NV-B, `D-thường` | 1.5 | 0.5 | 23 phút (làm tròn lên) |

- [ ] `[A]` NV-A + `D-thường` + `00:30` → từ chối, câu lỗi nói **45 phút**
- [ ] `[A]` Nhập **đúng** con số câu lỗi vừa nêu (`00:45`) → **tạo được**, không bị từ chối lần nữa
- [ ] `[A]` 2 dòng cùng dưới ngưỡng, một `D-thường` một `D-lễ` → mỗi dòng báo **con số khác nhau**
      (45 và 90)
- [ ] `[A]` Đổ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
- [ ] `[M]` `D-thường` + `00:30` + NV-A và NV-B → từ chối, `entries` liệt kê **cả hai người**,
      mỗi người kèm `account_id`, `employee_full_name` và **con số tối thiểu riêng** (45 và 23)
- [ ] `[M]` `D-thường` + `00:30` + NV-A và NV-B → **không nhân viên nào** được tạo request
- [ ] `[M]` `date` được báo **một lần ở cấp ngoài cùng**, không lặp trong từng `entry`

### 4c. `overtime_workday_cannot_be_evaluated` — 5 nguyên nhân

Lỗi này nghĩa là `hệ_số_OT × work_ratio_ca = 0`, không quy ngược ra giờ OT được. Thử đủ:

- [ ] `[A]` NV-C (**chưa gán ca**) + ngày bất kỳ → từ chối với mã này
- [ ] `[A]` NV có ca `work_ratio = 0` → từ chối với mã này
- [ ] `[A]` NV-A + `D-lỗi` (**lễ có `work_ratio` trống**) → từ chối với mã này
- [ ] `[A]` Đặt `overtime_ratio = 0` rồi tạo cho `D-thường` → từ chối với mã này
- [ ] `[A]` Đặt `overtime_day_off_ratio = 0` rồi tạo cho `D-nghỉ` → từ chối với mã này
- [ ] `[A]` **Xoá hẳn** dòng setting `overtime_ratio` của công ty (không phải set = 0) →
      cũng từ chối với mã này

> Mục cuối là một phát hiện: `CompanySetting::getByKey()` trả `null` khi công ty **chưa có**
> dòng setting đó, nên "chưa cấu hình" và "đã set = 0" cho ra cùng một lỗi, dù câu lỗi chỉ nói
> "is zero". Nếu khách hàng gặp lỗi này mà setting trông vẫn bình thường trên UI → kiểm tra
> xem dòng setting có thực sự tồn tại trong DB không.

- [ ] `[M]` Nhóm có NV-C lẫn NV-A → từ chối, `entries` **nêu đích danh NV-C**, và NV-A cũng
      **không** được tạo
- [ ] **Nhớ trả `overtime_ratio` và `overtime_day_off_ratio` về 1.5 / 2 trước khi đi tiếp**

### 4d. Giá trị biên

- [ ] `[A+M]` Nhập `0:00` → nên bị từ chối. Nếu tạo được request 0 công → **báo lại**
- [ ] `[A+M]` Nhập `00:00:45` (có phần giây) → hệ thống **bỏ phần giây**, thành 0 phút.
      Xem có lọt qua không
- [ ] `[A+M]` Nhập sai định dạng (`5`, `5h`, `abc`, `99:99`) → báo lỗi validate, không 500
- [ ] `[A+M]` Nhập số rất lớn (`999:59`) → hoặc tạo được đúng, hoặc báo lỗi rõ ràng, không tràn số

### 4e. Thứ Bảy chẵn / lẻ

Hệ thống phân biệt `Sat_Even` / `Sat_Odd`. Nếu ca của NV-A chỉ áp một trong hai:

- [ ] `[A]` Tạo mode công cho `D-T7a` và `D-T7b` → một ngày tính theo hệ số **ngày thường**,
      ngày kia theo hệ số **ngày nghỉ**, và ngưỡng tối thiểu báo ra cũng khác nhau tương ứng

---

## 5. Tính công — chạy lại tính công rồi mở bảng công

### 5a. Công OT được ghim — **không** ăn theo hệ số

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

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

- [ ] `05:00`, `D-thường`, hệ số 1.5, ca ratio 1 → giờ OT hiện **03:20**
- [ ] Đổi ngày đó thành lễ hệ số 3, tính lại → giờ OT hiện **01:40**, công OT **vẫn 5 giờ**
- [ ] NV-B (ca `work_ratio = 0.5`), `05:00`, `D-thường` → giờ OT hiện **06:40**

### 5c. Cộng dồn trong một ngày

- [ ] 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ờ**
- [ ] **Không double-count:** ngày chỉ có 1 request mode công → công OT đúng **một lần**,
      không gấp đôi. Đây là lỗi nặng nhất của change này
- [ ] Huỷ 1 trong 2 request → tính lại → chỉ còn phần còn lại

### 5d. Ngày chỉ có mode công

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

> Nếu bảng lương không thấy → lỗi cờ `is_recognized_overtime`, báo ngay.

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

- [ ] NV-A (ca `work_ratio = 1`), `05:00`, duyệt timesheet → cộng **đúng 5 giờ** phép
- [ ] NV-B (ca `work_ratio = 0.5`) → cộng **10 giờ** phép (= 5 ÷ 0.5). Đúng thiết kế, không phải lỗi
- [ ] Huỷ request rồi tính lại → phép năm được trả về

---

## 6. Đổi ca giữa chừng — điểm nghi ngờ

Phần validate và thẻ thống kê lấy ca **hiện tại** của nhân viên, trong khi bảng công lấy ca
**lưu trên dòng timesheet**. Nếu lệch nhau thì số trên thẻ sẽ không khớp bảng công.

- [ ] Tạo OT mode công cho NV-A ở `D-thường` khi ca còn `work_ratio = 1`
- [ ] Đổi ca của NV-A sang ca `work_ratio = 0.5` (ca mới, ngày hiệu lực sau `D-thường`)
- [ ] Mở lại thẻ thống kê và bảng công → ghi lại **cả hai con số**:
      thẻ `__________`, bảng công `__________`

> Lệch nhau là **đã biết trước**, không phải bug mới. Ghi lại con số để quyết định có cần ghi
> vào release note hay không.

---

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

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

- [ ] `[A]` 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)
- [ ] `[A]` 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. Là sửa chỗ đếm thiếu trước đây.

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

- [ ] `[A]` Tạo OT mode công trong tháng này → "Tổng thời gian" tăng theo **giờ OT quy đổi**,
      không phải số công đã gõ
- [ ] `[A]` Tạo cho **ngày tương lai** trong tháng này, chưa có chấm công → thẻ tăng **ngay**
- [ ] `[A]` Đổi `overtime_ratio` rồi tải lại thẻ → con số **đổi theo**, dù không tính lại công
- [ ] `[A]` Request mode công mà ratio = 0 (NV-C) → đóng góp 0 giờ, nhưng **vẫn được đếm**
      trong "Tổng yêu cầu" và "Tổng nhân viên"

### 7c. Phạm vi — khác nhau giữa hai màn hình

Cần một request gắn 5 người, manager M chỉ quản 2 trong số đó.

- [ ] `[A]` → tính **cả 5**
- [ ] `[M]` → tính **chỉ 2**
- [ ] `[M]` Tổng của manager **nhỏ hơn** tổng của admin trên cùng dữ liệu

### 7d. Nhân viên đã nghỉ việc

- [ ] `[A]` Xoá NV-D, request gắn 3 người trong đó có NV-D → "Tổng thời gian" tính **2 người**,
      "Tổng nhân viên" cũng là **2**

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

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

---

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

- [ ] `[A+M]` Lọc theo mode `time_range` → chỉ ra loại khoảng giờ
- [ ] `[A+M]` Lọc theo mode `workday` → chỉ ra loại mode công
- [ ] `[A+M]` **Không** lọc mode → ra cả hai loại
- [ ] `[A+M]` Lọc theo **khoảng ngày** → **vẫn hiện** request mode công. Mất là bug
- [ ] `[A+M]` Lọc khoảng ngày có `from = to =` đúng ngày của request mode công → vẫn ra
- [ ] `[A+M]` Lọc khoảng ngày **kết hợp** lọc mode → cả hai điều kiện cùng áp
- [ ] `[A+M]` Lọc theo trạng thái + mode → cùng áp
- [ ] `[A+M]` Tìm theo tên nhân viên / tiêu đề → vẫn ra request mode công
- [ ] `[A]` API public `/admin/public/overtime_requests` → cũng nhận `input_mode`
- [ ] `[A+M]` Dòng mode công hiện `total_time = 00:00:00` → **đúng thiết kế**
- [ ] `[A+M]` Tải trang `limit=30` → không chậm hơn rõ rệt so với trước

---

## 9. Xem chi tiết, sửa, huỷ, xoá

- [ ] `[A+M]` Mở chi tiết một request mode công → hiện đủ ngày, số công, danh sách nhân viên
- [ ] `[A+M]` Sửa **tiêu đề** request mode công → lưu được, `input_mode` và số công **không đổi**
- [ ] `[A+M]` Huỷ request mode công → trạng thái đổi, tính lại công → công OT ngày đó giảm tương ứng
- [ ] `[A+M]` Xoá request mode công → tương tự
- [ ] `[M]` Manager **không phải người tạo** → không sửa/huỷ được (như cũ)
- [ ] `[A+M]` Huỷ rồi huỷ lại → vẫn báo lỗi trạng thái như cũ

---

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

- [ ] `[A+M]` Duyệt OT **mode công** → mail và noti ghi **ngày + số giờ công**, KHÔNG có khoảng giờ
- [ ] `[A+M]` Huỷ OT **mode công** → tương tự
- [ ] `[A+M]` Duyệt OT **khoảng giờ** → y như cũ, dạng `18:00 - 20:00, Thứ Tư 12/11`
- [ ] Tên thứ trong tiếng Việt hiện đúng
- [ ] Mail gửi cho request gắn **nhiều nhân viên** → mỗi người nhận đúng nội dung

---

## 11. Dọn dẹp sau khi test

- [ ] Trả `overtime_ratio`, `overtime_day_off_ratio`, `min_minutes_recognized`,
      `overtime_option` về giá trị đã ghi ở mục 0
- [ ] Xoá Lễ-H và Lễ-H0
- [ ] Xoá các request OT đã tạo, tính lại công cho các nhân viên liên quan
- [ ] Khôi phục ca của NV-A nếu đã đổi ở mục 6

---

## 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 đó.
Với lỗi API thì kèm nguyên body request và body response.
