# Quy tắc Áp dụng CI/CD – Dành cho Nhóm Phát Triển

| Quy tắc                                                         | Diễn giải / Hành động cụ thể                                                                                           |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Không làm việc trực tiếp trên nhánh chính (main/master/develop) | - Dev không push trực tiếp lên nhánh chính.<br/>- Git server cấu hình "Protected Branches", yêu cầu Pull Request.      |
| Đặt tên nhánh theo quy tắc (feat/, fix/, chore/, ...)           | - Tuân thủ naming convention khi tạo nhánh mới.<br/>- Có thể dùng pre-receive hook hoặc CI lint để kiểm tra tên nhánh. |
| Không hardcode biến, dùng `.env` cho local                      | - Không ghi trực tiếp token, URL... vào code.<br/>- Sử dụng secret management và `.env`.                               |
| Document rõ nếu template CI bị chỉnh sửa lớn                    | - Ghi chú lại những thay đổi cấu trúc template CI/CD để chia sẻ với team, không ảnh hưởng luồng hàng ngày.             |
| Mọi thay đổi qua Pull Request (có review)                       | - Code được review trước khi merge.<br/>- PR trigger pipeline và cần pass + được review đầy đủ trước khi merge.        |
| Test phải pass 100% (unit, integration, coverage)               | - Nếu bất kỳ test nào fail → pipeline dừng.<br/>- Kiểm tra code coverage đủ ngưỡng tối thiểu.                          |
| Ưu tiên giữ pipeline luôn "Xanh" (Green)                        | - Khi có lỗi phải fix sớm.<br/>- Coi việc pipeline đỏ là blocker.                                                      |
| Tối ưu hóa thời gian chạy pipeline định kỳ                      | - Review log pipeline theo chu kỳ để giảm thời gian chờ build/test.                                                    |
| Cấu hình cảnh báo pipeline (Slack, Email, Teams...)             | - Gửi notify khi lỗi hoặc deploy thành công.                                                                           |
| Commit message ý nghĩa                                          | - Viết commit rõ ràng.<br/>- Có thể dùng pre-commit hook hoặc CI lint commit message.                                  |
| "Definition of Done" (DoD)                                      | - Checklist kiểm tra các bước đã pass, QA/PO đã nghiệm thu trước khi đóng task.                                        |
| Ai chịu trách nhiệm khi pipeline lỗi?                           | - Người vừa push hoặc cả team (tuỳ lỗi).<br/>- Có cơ chế phân công hoặc cảnh báo rõ người chịu trách nhiệm xử lý.      |