tailscale-custom/.agent/workflows/audit.md

---
description: Audit all features on a page/module like a picky user. Find and fix form issues, API silent failures, missing fields, hardcoded values.
---

# /audit - Feature Audit & Fix

Quy trình kiểm tra tính năng toàn diện cho một page/module, đóng vai user khó tính.

---

## Phase 1: IDENTIFY — Xác định scope

1. **Xác định page/module cần audit** từ user request
2. **Liệt kê tất cả files liên quan:**
   - Frontend page (`.razor`)
   - Frontend service (`HrmApiService.cs` hoặc tương đương)
   - Backend controller
   - Backend service
   - DTOs / Entities / Enums
3. **Đọc toàn bộ code** của các files trên

---

## Phase 2: AUDIT — Kiểm tra từng chức năng

Với MỖI form/popup/grid trên page, kiểm tra theo checklist:

### 2a. Form Fields — Trường nhập liệu
- [ ] So sánh form fields với DTO/Entity → **Có trường nào trong DTO mà form không hiển thị?**
- [ ] Kiểm tra có giá trị **hardcoded** trong handler thay vì cho user nhập? (e.g., `DayType.Normal`, `IsNightShift = false`, `ShiftCodeId = 1`)
- [ ] Mọi trường bắt buộc có dấu `*` (required indicator)?
- [ ] Các trường time dùng `DxTimeEdit` thay vì `DxTextBox`?
- [ ] Các trường date dùng `DxDateEdit` thay vì `DxTextBox`?
- [ ] Các trường enum/lookup dùng `DxComboBox` với data source thay vì `DxTextBox`?
- [ ] **FK fields (xxxId) PHẢI dùng `DxComboBox` hiện tên/mã từ DB, KHÔNG dùng `DxSpinEdit` nhập số ID thủ công**
  - Tìm: `DxSpinEdit.*Id` → phải đổi sang `DxComboBox` với data load từ API
  - Label phải hiện tên entity ("Phòng ban", "Ca làm việc"), KHÔNG hiện "Phòng ban ID"
  - ComboBox cần có `NullText`, `FilteringMode`, `ClearButtonDisplayMode`
- [ ] Checkbox cho boolean fields?

### 2b. Validation — Kiểm tra ràng buộc
- [ ] Required fields có validation trước khi submit?
- [ ] Date range: ToDate >= FromDate?
- [ ] Time range: ToTime > FromTime (trừ ca đêm)?
- [ ] Số lượng/giá trị > 0 khi cần?
- [ ] Có hiện Toast warning với message cụ thể khi validation fail?

### 2c. API Error Handling — Xử lý lỗi API
- [ ] Mọi POST/PUT/DELETE API call có kiểm tra `resp.IsSuccessStatusCode`?
- [ ] Khi API fail, có **throw exception** (KHÔNG return default value im lặng)?
- [ ] Error message có đọc `resp.Content` để hiển thị chi tiết?
- [ ] Frontend handler có `try/catch` bao bọc API call?
- [ ] Catch block có hiện `Toast.Error()` với `ex.Message`?

### 2d. Popup / Form Reset
- [ ] `ShowAddXxx()` reset TẤT CẢ field về default (không chỉ một vài)?
- [ ] Date fields reset về `DateTime.Today` (không để giá trị cũ)?
- [ ] Nullable fields reset về `null`?
- [ ] String fields reset về `""`?

### 2e. Grid Display — Hiển thị dữ liệu
- [ ] Grid columns khớp với DTO properties cần hiển thị?
- [ ] Enum columns hiển thị text thay vì số (e.g., "Phép năm" thay vì "0")?
- [ ] Date/Time columns format đúng?
- [ ] Có column thừa hoặc thiếu?

### 2f. Data Integrity — Tính toàn vẹn dữ liệu
- [ ] Default values trong entity có hợp lý? (e.g., DateOnly default = 0001-01-01 → cần set mặc định)
- [ ] Foreign key relationships có valid? (e.g., EmployeeId phải tồn tại)
- [ ] Seed data có đủ cho tất cả dropdowns?

---

## Phase 3: REPORT — Báo cáo audit

Tạo danh sách issues theo severity:

```markdown
### 🔴 Critical — Silent failures, data loss
### 🟡 Medium — Missing fields, hardcoded values  
### 🟢 Low — UI polish, format
```

---

## Phase 4: FIX — Sửa batch

// turbo-all

1. **Sửa tất cả issues trong batch** — ưu tiên Critical → Medium → Low
2. **Build:**
   ```powershell
   dotnet build INS.HRM.slnx
   ```
3. **Test:**
   ```powershell
   dotnet test src/INS.HRM.Backend/INS.HRM.Backend.csproj
   ```
4. **Start server:**
   ```powershell
   dotnet run --project src/INS.HRM.Backend
   ```

---

## Phase 5: VERIFY — Xác nhận

5. Tóm tắt kết quả cho user:
   - Số issues tìm được
   - Số issues đã sửa
   - Build status
   - Test status

---

## Examples

```
/audit trang chấm công
/audit module nhân viên
/audit tất cả các form trên trang tổ chức
/audit page recruitment
```