Xử lý thay đổi khi dự án đang chạy

Dự án BA đang chạy theo module thì thay đổi là chuyện bình thường. Trang này liệt kê 5 tình huống phổ biến nhất và cách xử lý đúng.

Nguyên tắc chung

• Không sửa trực tiếp trên main
• Không sửa artifact ngoài module mình được giao
• Thay đổi chạm scope, actor, rule, menu, navigation → báo Lead BA
• Core thay đổi trước, module cập nhật sau
• Dùng impact trước khi sửa bất cứ thứ gì liên quan đến requirement

Cách gọi theo runtime

---

Scenario 1: Change Request từ stakeholder/client

Ví dụ: Client đổi rule tính phí, thêm actor mới, thêm yêu cầu audit log.

Module BA phải làm gì

1. Dừng sửa artifact liên quan
2. Không tự sửa backbone, DESIGN.md hoặc module artifact theo suy đoán
3. Ghi lại CR: ai yêu cầu, yêu cầu gì, module nào bị ảnh hưởng
4. Báo Lead BA:

/ba-collab Phát hiện CR trong module reporting: Export CSV phải ghi audit log. Pause module và gửi Lead BA review.

Lead BA phải làm gì

1. Xác nhận CR có phải requirement change thật không
2. Chạy impact để biết file nào bị ảnh hưởng
3. Nếu đổi core → tạo branch/PR core riêng, merge trước
4. Thông báo member bị ảnh hưởng sync với main
5. Cập nhật COLLAB-HOME.md

Module BA sync sau khi core merge

Đồng bộ module reporting với main trước khi tôi làm tiếp.

Agent sẽ kiểm tra branch, fetch/pull main, merge vào branch module. Nếu conflict → dừng và báo Lead BA.

---

Scenario 2: Module BA thấy menu/UI/UX cần chỉnh

Ví dụ: Menu không hợp lý, cần thêm tab, đổi label navigation.

Module BA phải làm gì

1. Không tự sửa DESIGN.md, backbone, hoặc shared navigation
2. Ghi proposal ngắn: vấn đề, màn hình liên quan, đề xuất, lý do, module bị ảnh hưởng
3. Gửi Lead BA

Lead BA phải làm gì

1. Module-local → cho member tự sửa trong module PR
2. Shared → Lead cập nhật DESIGN.md/backbone, mở PR core riêng, merge trước
3. Yêu cầu member affected sync và cập nhật module

Khi nào member được tự sửa UI/UX

Chỉ khi: đổi mô tả screen của module mình, không đổi menu global, không đổi actor/portal, không đổi shared component, không ảnh hưởng module khác.

---

Scenario 3: Lead BA thay đổi core

Ví dụ: Backbone đổi actor map, DESIGN.md đổi navigation schema.

Lead BA phải làm gì

1. Cập nhật core artifact
2. Ghi rõ: file nào đổi, lý do, module nào bị ảnh hưởng
3. Merge core PR
4. Thông báo team:

Core update đã merge:
- PR: #12
- Thay đổi: DESIGN.md đổi navigation schema cho Portal Admin
- Affected modules: auth-flow, reporting
- Cần làm: sync module với main, đọc lại DESIGN.md, rerun SRS screen sections

Module BA phải làm gì

1. Dừng sửa đến khi branch đã sync
2. Yêu cầu agent sync module với main
3. Đọc lại file core bị đổi
4. Kiểm tra artifact module: FRD, stories, SRS, wireframe-input
5. Sửa phần bị ảnh hưởng
6. Cập nhật PR module

---

Scenario 4: Hai module mâu thuẫn nhau

Ví dụ: Module A gọi actor là "Approver", module B gọi là "Supervisor". Module A cho export CSV, module B cấm export.

Module BA phải làm gì

1. Không tự sửa module của người khác
2. Ghi rõ mâu thuẫn: 2 đường dẫn file, khác nhau chỗ nào
3. Báo Lead BA
4. Dừng phần artifact phụ thuộc

Lead BA phải làm gì

1. Xác định mâu thuẫn: terminology, business rule, actor, hay navigation
2. Chọn source of truth cần sửa (thường là backbone hoặc DESIGN.md)
3. Mở PR core, merge
4. Yêu cầu member affected sync và sửa

---

Scenario 5: Phát hiện lỗi sau khi merge

Ví dụ: Typo quan trọng, acceptance criteria sai, screen ID trùng, thiếu section.

Cách xử lý

1. Không sửa trực tiếp trên main
2. Báo Lead BA: lỗi ở file/section nào
3. Lead BA quyết định: hotfix nhỏ hay CR
4. Nếu hotfix: tạo branch fix/{slug}-{module}-{mô-tả}, sửa đúng lỗi, mở PR hotfix
5. Nếu là requirement change → xử lý như Scenario 1

Checklist nhanh cho Module BA

Trước khi sửa:

• Tôi biết mình đang ở branch riêng, không phải main
• Tôi biết module mình sở hữu
• Tôi đã đọc core mới nhất

Khi phát hiện thay đổi:

• Chạm core → báo Lead BA
• Chạm menu/navigation/shared UX → báo Lead BA
• CR từ stakeholder → pause, báo Lead BA
• Không chắc → hỏi trước khi sửa

Trước khi gửi review:

• Chỉ có file đúng scope
• Đã ghi assumption/open question
• Nếu có CR/core update → đã sync từ PR nào

Tiếp theo

• BA làm việc như developer - workflow chi tiết
• Collaboration overview - tổng quan về collaboration