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

description

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:

### 🔴 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:

   dotnet build INS.HRM.slnx
   

3. Test:

   dotnet test src/INS.HRM.Backend/INS.HRM.Backend.csproj
   

4. Start server:

   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