TỔNG QUAN

I. Mục đích

Tài liệu này nhằm:

• Thống nhất cách quản lý source code trong dự án
• Giảm xung đột khi làm việc nhóm
• Đảm bảo code dễ đọc, dễ review, dễ bảo trì
• Làm căn cứ xử lý khi vi phạm quy trình kỹ thuật

Quy định này áp dụng cho toàn bộ thành viên tham gia phát triển và chỉnh sửa source code của dự án.

II. Nguyên tắc chung

1. Không làm việc trực tiếp trên nhánh chính

• Không commit trực tiếp vào main
• Không commit trực tiếp vào develop
• Mọi thay đổi phải thông qua nhánh riêng và Pull Request

Vi phạm quy định này được xem là vi phạm quy trình kỹ thuật.

2. Mọi thay đổi đều phải trace được

• Mỗi commit phải gắn với task hoặc issue cụ thể
• Không commit không rõ mục đích
• Không chỉnh sửa code mà không có liên quan đến task

Code không trace được nguồn gốc được xem là không hợp lệ.

3. Code phải ưu tiên tính rõ ràng

• Viết code để người khác đọc được
• Không tối ưu hóa sớm khi chưa cần thiết
• Không viết logic phức tạp nếu có thể tách nhỏ

Code khó đọc, khó hiểu sẽ bị yêu cầu chỉnh sửa trong quá trình review.