📖 HƯỚNG DẪN SỬ DỤNG SVN

A. Cài đặt phần mềm

1. Tải và cài TortoiseSVN (Windows):
   https://tortoisesvn.net/downloads.html

2. Sau khi cài xong, chuột phải trên thư mục sẽ thấy các lệnh SVN.

B. Quy trình làm việc SVN chung

I. Dành cho Teamlead

1. Tạo Repository

• Sử dụng server hoặc máy tính có Apache Subversion Server (hoặc dùng dịch vụ SVN hosting).

• Ví dụ URL: http://svn.server.com/repos/ten_du_an

2. Tạo cấu trúc thư mục chuẩn trong SVN:

/trunk        # nhánh chính
/branches     # nhánh phát triển riêng
/tags         # các bản release

3. Phân quyền truy cập (trên file svnserve.conf hoặc hệ thống web SVN như VisualSVN)

• Teamlead: full quyền

• Thành viên: chỉ được commit trong /trunk hoặc /branches/ten_cua_minh

4. Tạo nhánh làm việc riêng

svn copy http://svn.server.com/repos/ten_du_an/trunk \
         http://svn.server.com/repos/ten_du_an/branches/feature-xyz \
         -m "Tạo nhánh feature-xyz cho dev A"

5. Kiểm tra và hợp nhất code (merge)

• Teamlead làm nhiệm vụ tổng hợp code từ các nhánh về trunk sau khi review OK.

6. Gắn Tag khi release

svn copy http://svn.server.com/repos/ten_du_an/trunk \
         http://svn.server.com/repos/ten_du_an/tags/v1.0 \
         -m "Release version 1.0"

II. Dành cho Thành viên

1. Checkout mã nguồn

• Chuột phải ở thư mục trống → SVN Checkout

• Dán URL nhánh được giao (trunk hoặc branch riêng)
  Ví dụ: http://svn.server.com/repos/ten_du_an/branches/feature-xyz

2. Update code mới nhất

• Chuột phải → SVN Update

• Luôn thực hiện trước khi sửa code.

3. Commit thay đổi

• Sau khi sửa xong → Chuột phải → SVN Commit

• Ghi chú nội dung commit rõ ràng: Thêm chức năng login, Sửa lỗi validate form

4. Xem lịch sử và so sánh

• Chuột phải file → TortoiseSVN → Show Log

• Có thể xem ai đã sửa, sửa gì, khi nào

5. Xử lý xung đột

• Khi commit bị từ chối vì có thay đổi trùng lặp:

  • Chạy SVN Update

  • SVN báo file bị xung đột (.mine, .r###)

  • Mở trình merge để giải quyết (tích hợp sẵn trong TortoiseSVN)

C. Quy ước đặt tên và làm việc nhóm (đề xuất)

📌 MẸO CHO TEAMLEAD

• Thiết lập hook pre-commit để kiểm tra message, cấm commit trống.

• Thường xuyên kiểm tra branches để đảm bảo không bị “rác”.

• Review định kỳ: Gộp nhánh nào hoàn thành về trunk.

📌 MẸO CHO THÀNH VIÊN

• Không commit code chưa chạy được.

• Commit nhỏ và thường xuyên thay vì một lần nhiều.

• Khi gặp xung đột khó xử lý → liên hệ Teamlead.