# Quy Chuẩn Git Workflow & Quản Lý Nhánh Cho DSCons

## 1. Định Dạng Commit Chuẩn (Conventional Commits)
```
<type>(<scope>): <mô tả ngắn gọn bằng tiếng Việt hoặc tiếng Anh>

[Mô tả chi tiết giải pháp, lý do thay đổi và số hiệu văn bản/tiêu chuẩn]
```
Các loại type chuẩn:
- `feat`: Tính năng mới (ví dụ: bóc tách BoQ, xuất phiếu IPC, tính định mức cát)
- `fix`: Sửa lỗi nghiệp vụ / giao diện / tính toán
- `refactor`: Tái cấu trúc mã nguồn mà không thay đổi hành vi nghiệp vụ
- `perf`: Tối ưu hóa hiệu năng truy vấn DB / giao diện bảng tính
- `test`: Bổ sung hoặc chỉnh sửa bộ kiểm thử (pytest, Playwright)
- `docs`: Cập nhật tài liệu kỹ thuật, cẩm nang nghiệp vụ hoặc ADR
- `chore`: Cấu hình môi trường, dependencies, build scripts

## 2. Quy Trình Trước Khi Commit & Tạo Pull Request
1. Bắt buộc chạy kiểm thử hồi quy: `pytest tests -v` đạt 100% Passed.
2. Kiểm tra `git diff`: Rà soát từng file thay đổi, loại bỏ 100% file tạm, `print()` hoặc `console.log()` debug.
3. Kiểm thử giao diện trên trình duyệt thực tế (Playwright) nếu có thay đổi UI/UX.