@relipa/ai-flow-kit 0.1.4-beta.0 → 0.1.5-beta.0

package/custom/skills/test-skills/template/{template_testcase.md → testcase-template.md}

@@ -18,75 +18,66 @@ Tài liệu này cung cấp **Template Test Case** chuẩn chỉnh và hướng
 | **Người kiểm duyệt (Reviewer)** | [Ví dụ: Nguyễn Văn A] |
 | **Ngày kiểm duyệt (Review Date)** | [Ví dụ: 2026-06-16] |
 
-## 2. Kết quả kiểm thử tổng hợp (Test Execution Summary)
+## 2. Danh sách Test Cases Chi Tiết
 
-| Vòng kiểm thử (Round) | Đạt (Passed) | Lỗi (Failed) | Chưa test (Untest) | Chờ (Pending) | Tổng số (Total) | Tỷ lệ Đạt (%) |
-|:---|:---:|:---:|:---:|:---:|:---:|:---:|
-| Round 1 | 0 | 0 | 0 | 0 | 0 | 0% |
-| Round 2 | 0 | 0 | 0 | 0 | 0 | 0% |
+### 2.1. Kiểm thử truy cập & Phân quyền (Access & Authorization)
 
----
-
-## 3. Danh sách Test Cases Chi Tiết
-
-### 3.1. Kiểm thử truy cập & Phân quyền (Access & Authorization)
-
-| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID_001] | Truy cập trực tiếp qua URL khi chưa đăng nhập | High | Người dùng chưa đăng nhập hệ thống | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống không cho phép truy cập.<br>Tự động chuyển hướng về trang Đăng nhập (Login). | | | | | | | | |
-| [ID_002] | Truy cập trực tiếp qua URL khi đã đăng nhập | Medium | Người dùng đã đăng nhập hệ thống thành công | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống cho phép truy cập.<br>Hiển thị đúng giao diện màn hình. | | | | | | | | |
-| [ID_003] | Truy cập qua button/menu điều hướng | Low | Người dùng đang ở màn hình danh sách | 1. Click vào nút "Thêm mới" hoặc menu tương ứng. | - | Hệ thống mở màn hình đăng ký/thực hiện tương ứng thành công. | | | | | | | | |
+| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID_001] | Truy cập trực tiếp qua URL khi chưa đăng nhập | High | Người dùng chưa đăng nhập hệ thống | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống không cho phép truy cập.<br>Tự động chuyển hướng về trang Đăng nhập (Login). | | |
+| [ID_002] | Truy cập trực tiếp qua URL khi đã đăng nhập | Medium | Người dùng đã đăng nhập hệ thống thành công | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống cho phép truy cập.<br>Hiển thị đúng giao diện màn hình. | | |
+| [ID_003] | Truy cập qua button/menu điều hướng | Low | Người dùng đang ở màn hình danh sách | 1. Click vào nút "Thêm mới" hoặc menu tương ứng. | - | Hệ thống mở màn hình đăng ký/thực hiện tương ứng thành công. | | |
 
-### 3.2. Kiểm thử Giao diện Người dùng (UI/UX)
+### 2.2. Kiểm thử Giao diện Người dùng (UI/UX)
 
-| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID_004] | Kiểm tra hiển thị giao diện tổng quan | Low | Màn hình hiển thị bình thường | 1. Quan sát giao diện màn hình.<br>2. Kiểm tra layout, màu sắc, font chữ, khoảng cách giữa các trường. | - | 1. Layout cân đối, font chữ và cỡ chữ đồng nhất.<br>2. Các trường bắt buộc nhập có dấu sao đỏ (*).<br>3. Không có lỗi chính tả, lỗi dịch thuật tiếng Nhật/Anh/Việt.<br>4. Định dạng placeholder hiển thị chính xác theo thiết kế. | | | | | | | | |
+| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID_004] | Kiểm tra hiển thị giao diện tổng quan | Low | Màn hình hiển thị bình thường | 1. Quan sát giao diện màn hình.<br>2. Kiểm tra layout, màu sắc, font chữ, khoảng cách giữa các trường. | - | 1. Layout cân đối, font chữ và cỡ chữ đồng nhất.<br>2. Các trường bắt buộc nhập có dấu sao đỏ (*).<br>3. Không có lỗi chính tả, lỗi dịch thuật tiếng Nhật/Anh/Việt.<br>4. Định dạng placeholder hiển thị chính xác theo thiết kế. | | |
 
-### 3.3. Kiểm thử Validation các trường nhập liệu (Input Validation)
+### 2.3. Kiểm thử Validation các trường nhập liệu (Input Validation)
 *(Tạo riêng từng bảng hoặc nhóm theo từng Field để dễ theo dõi)*
 
 #### * Đối với Trường nhập liệu Text (Ví dụ: 【品番】/【品名】...)
-| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID_005] | Kiểm tra giá trị mặc định | Low | Đã truy cập màn hình | 1. Quan sát trường [Tên Trường]. | - | Giá trị mặc định là trống (blank).<br>Hiển thị đúng Placeholder thiết kế. | | | | | | | | |
-| [ID_006] | Kiểm tra trường bắt buộc nhập để trống | High | Đã truy cập màn hình | 1. Để trống trường [Tên Trường].<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | Empty | 1. Hiển thị thông báo lỗi trên đầu trang hoặc dưới field: "Hãy nhập [Tên Trường]" (tiếng Nhật/Anh tương ứng).<br>2. Field bị highlight viền đỏ. | | | | | | | | |
-| [ID_007] | Kiểm tra nhập ký tự khoảng trắng (Spaces) | Medium | Đã truy cập màn hình | 1. Nhập toàn khoảng trắng vào trường.<br>2. Bấm nút thực hiện (Đăng ký/Lưu) hoặc focus out. | `"   "` | Hệ thống xem như để trống.<br>Báo lỗi bắt buộc nhập (nếu là trường Required) hoặc tự động trim khoảng trắng. | | | | | | | | |
-| [ID_008] | Kiểm tra nhập khoảng trắng ở đầu/cuối chuỗi | Low | Đã truy cập màn hình | 1. Nhập chuỗi có khoảng trắng ở đầu/cuối.<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | `"  data_test  "` | Hệ thống tự động cắt bỏ (trim) khoảng trắng ở đầu và cuối chuỗi trước khi lưu vào DB. | | | | | | | | |
-| [ID_009] | Kiểm tra nhập độ dài tối thiểu/tối đa (Boundary Value) | Medium | Đã truy cập màn hình, biết Maxlength = N | 1. Nhập chuỗi có độ dài N - 1 ký tự.<br>2. Nhập chuỗi có độ dài N ký tự.<br>3. Nhập chuỗi có độ dài > N ký tự. | Chuỗi test tương ứng | - Với độ dài <= N: Cho phép nhập và lưu bình thường.<br>- Với độ dài > N: Hệ thống chặn trực tiếp trên UI (không cho gõ tiếp) hoặc báo lỗi hợp lệ. | | | | | | | | |
-| [ID_010] | Kiểm tra nhập ký tự đặc biệt / Tiếng Nhật Halfwidth & Fullwidth | Medium | Đã truy cập màn hình | 1. Nhập các ký tự đặc biệt (!@#$).<br>2. Nhập ký tự Halfwidth (ｶﾀｶﾅ, 123).<br>3. Nhập ký tự Fullwidth (カタカナ, １２３). | Dữ liệu kiểm thử | Hệ thống lưu trữ đúng định dạng ký tự đã nhập (hoặc báo lỗi chuẩn nếu có quy định hạn chế định dạng). | | | | | | | | |
-| [ID_011] | Kiểm tra thao tác Copy/Paste | Low | Đã truy cập màn hình | 1. Copy một chuỗi hợp lệ.<br>2. Paste vào trường thông tin.<br>3. Bấm nút thực hiện. | - | Cho phép paste dữ liệu vào field thành công và xử lý lưu bình thường. | | | | | | | | |
+| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID_005] | Kiểm tra giá trị mặc định | Low | Đã truy cập màn hình | 1. Quan sát trường [Tên Trường]. | - | Giá trị mặc định là trống (blank).<br>Hiển thị đúng Placeholder thiết kế. | | |
+| [ID_006] | Kiểm tra trường bắt buộc nhập để trống | High | Đã truy cập màn hình | 1. Để trống trường [Tên Trường].<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | Empty | 1. Hiển thị thông báo lỗi trên đầu trang hoặc dưới field: "Hãy nhập [Tên Trường]" (tiếng Nhật/Anh tương ứng).<br>2. Field bị highlight viền đỏ. | | |
+| [ID_007] | Kiểm tra nhập ký tự khoảng trắng (Spaces) | Medium | Đã truy cập màn hình | 1. Nhập toàn khoảng trắng vào trường.<br>2. Bấm nút thực hiện (Đăng ký/Lưu) hoặc focus out. | `"   "` | Hệ thống xem như để trống.<br>Báo lỗi bắt buộc nhập (nếu là trường Required) hoặc tự động trim khoảng trắng. | | |
+| [ID_008] | Kiểm tra nhập khoảng trắng ở đầu/cuối chuỗi | Low | Đã truy cập màn hình | 1. Nhập chuỗi có khoảng trắng ở đầu/cuối.<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | `"  data_test  "` | Hệ thống tự động cắt bỏ (trim) khoảng trắng ở đầu và cuối chuỗi trước khi lưu vào DB. | | |
+| [ID_009] | Kiểm tra nhập độ dài tối thiểu/tối đa (Boundary Value) | Medium | Đã truy cập màn hình, biết Maxlength = N | 1. Nhập chuỗi có độ dài N - 1 ký tự.<br>2. Nhập chuỗi có độ dài N ký tự.<br>3. Nhập chuỗi có độ dài > N ký tự. | Chuỗi test tương ứng | - Với độ dài <= N: Cho phép nhập và lưu bình thường.<br>- Với độ dài > N: Hệ thống chặn trực tiếp trên UI (không cho gõ tiếp) hoặc báo lỗi hợp lệ. | | |
+| [ID_010] | Kiểm tra nhập ký tự đặc biệt / Tiếng Nhật Halfwidth & Fullwidth | Medium | Đã truy cập màn hình | 1. Nhập các ký tự đặc biệt (!@#$).<br>2. Nhập ký tự Halfwidth (ｶﾀｶﾅ, 123).<br>3. Nhập ký tự Fullwidth (カタカナ, １２３). | Dữ liệu kiểm thử | Hệ thống lưu trữ đúng định dạng ký tự đã nhập (hoặc báo lỗi chuẩn nếu có quy định hạn chế định dạng). | | |
+| [ID_011] | Kiểm tra thao tác Copy/Paste | Low | Đã truy cập màn hình | 1. Copy một chuỗi hợp lệ.<br>2. Paste vào trường thông tin.<br>3. Bấm nút thực hiện. | - | Cho phép paste dữ liệu vào field thành công và xử lý lưu bình thường. | | |
 
 #### * Đối với Trường Số (Number / Price / Quantity)
-| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID_012] | Kiểm tra nhập chữ cái và ký tự đặc biệt | Medium | Đã truy cập màn hình | 1. Cố gắng nhập chữ cái (a, b, c...) hoặc ký tự đặc biệt.<br>2. Bấm nút thực hiện. | `"abc"`, `"@#$"` | UI ngăn không cho nhập chữ cái/ký tự đặc biệt, chỉ chấp nhận chữ số. | | | | | | | | |
-| [ID_013] | Kiểm tra nhập số âm | High | Đã truy cập màn hình | 1. Nhập số âm.<br>2. Bấm nút thực hiện. | `-10` | Báo lỗi giá trị phải lớn hơn hoặc bằng 0 (hoặc chặn dấu trừ `-` trực tiếp từ UI). | | | | | | | | |
-| [ID_014] | Kiểm tra nhập số thập phân | High | Đã truy cập màn hình | 1. Nhập số có dấu phẩy thập phân.<br>2. Bấm nút thực hiện. | `1.5`, `2,3` | Báo lỗi chỉ chấp nhận số nguyên (hoặc chấp nhận số thập phân tùy đặc tả nghiệp vụ). | | | | | | | | |
-| [ID_015] | Kiểm tra hiển thị định dạng phân tách hàng nghìn | Low | Đã truy cập màn hình | 1. Nhập số lớn.<br>2. Focus out khỏi trường nhập liệu. | `1000000` | Số tự động định dạng phân tách hàng nghìn (Ví dụ: `1,000,000`). | | | | | | | | |
+| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID_012] | Kiểm tra nhập chữ cái và ký tự đặc biệt | Medium | Đã truy cập màn hình | 1. Cố gắng nhập chữ cái (a, b, c...) hoặc ký tự đặc biệt.<br>2. Bấm nút thực hiện. | `"abc"`, `"@#$"` | UI ngăn không cho nhập chữ cái/ký tự đặc biệt, chỉ chấp nhận chữ số. | | |
+| [ID_013] | Kiểm tra nhập số âm | High | Đã truy cập màn hình | 1. Nhập số âm.<br>2. Bấm nút thực hiện. | `-10` | Báo lỗi giá trị phải lớn hơn hoặc bằng 0 (hoặc chặn dấu trừ `-` trực tiếp từ UI). | | |
+| [ID_014] | Kiểm tra nhập số thập phân | High | Đã truy cập màn hình | 1. Nhập số có dấu phẩy thập phân.<br>2. Bấm nút thực hiện. | `1.5`, `2,3` | Báo lỗi chỉ chấp nhận số nguyên (hoặc chấp nhận số thập phân tùy đặc tả nghiệp vụ). | | |
+| [ID_015] | Kiểm tra hiển thị định dạng phân tách hàng nghìn | Low | Đã truy cập màn hình | 1. Nhập số lớn.<br>2. Focus out khỏi trường nhập liệu. | `1000000` | Số tự động định dạng phân tách hàng nghìn (Ví dụ: `1,000,000`). | | |
 
 #### * Đối với Trường File Upload (Hình ảnh)
-| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID_016] | Kiểm tra không upload file (Trường tùy chọn) | Medium | Đã truy cập màn hình | 1. Không chọn file upload.<br>2. Bấm nút thực hiện. | - | Hệ thống cho phép thực hiện thành công mà không báo lỗi. | | | | | | | | |
-| [ID_017] | Kiểm tra upload file sai định dạng | High | Định dạng cho phép: jpeg, png | 1. Chọn upload file có định dạng không được phép (xlsx, gif, pdf...). | File `.pdf`, `.xlsx` | Upload không thành công. Hiển thị thông báo lỗi đúng thiết kế: "Hình ảnh phải là định dạng jpeg hoặc png." | | | | | | | | |
-| [ID_018] | Kiểm tra upload dung lượng vượt quá giới hạn | High | Giới hạn dung lượng: tối đa 10MB | 1. Chọn file có kích thước > 10MB.<br>2. Tiến hành upload. | File kích thước `10.5MB` | Upload thất bại. Hiển thị lỗi cảnh báo: "Dung lượng hình ảnh vượt quá 10MB." | | | | | | | | |
-| [ID_019] | Kiểm tra upload file giả mạo đuôi mở rộng (Spoofing) | High | Đã truy cập màn hình | 1. Đổi đuôi file thực thi nguy hiểm `.exe` thành `.jpg`.<br>2. Chọn upload file này. | File `.exe` đổi tên thành `.jpg` | Hệ thống kiểm tra phần thân file (MIME type) thực tế và báo lỗi không đúng định dạng. | | | | | | | | |
-| [ID_020] | Kiểm tra kéo thả file (Drag & Drop) | Low | Đã truy cập màn hình | 1. Kéo file ảnh thả vào vùng upload. | File `.png` hợp lệ | Upload file thành công và hiển thị thumbnail ảnh xem trước trên giao diện. | | | | | | | | |
-
-### 3.4. Kiểm thử Logic Nghiệp vụ (Business Rules - BR)
-
-| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID_021] | Kiểm tra ràng buộc trùng lặp dữ liệu duy nhất (Unique) | High | Đã tồn tại bản ghi trong DB | 1. Nhập thông tin trùng khóa chính/mã duy nhất với bản ghi cũ.<br>2. Điền các thông tin hợp lệ khác.<br>3. Bấm Đăng ký. | Mã trùng lặp | Hệ thống báo lỗi trùng lặp: "Mã/Tên này đã tồn tại trong hệ thống. Vui lòng kiểm tra lại." | | | | | | | | |
-| [ID_022] | Kiểm tra logic liên kết dữ liệu động (Dynamic Form Control) | High | Điều kiện thay đổi hiển thị | 1. Tích chọn/Bỏ tích chọn [Checkbox điều kiện]. | - | Giao diện tự động thay đổi hiển thị ẩn/hiện hoặc disable/enable các trường thông tin liên quan theo đúng mô tả BR. | | | | | | | | |
-| [ID_023] | Kiểm tra lưu dữ liệu vào Database thành công | Critical | Nhập đầy đủ và chính xác tất cả dữ liệu hợp lệ | 1. Nhập toàn bộ dữ liệu hợp lệ.<br>2. Bấm nút Đăng ký.<br>3. Kiểm tra DB và màn hình danh sách. | Dữ liệu hợp lệ | 1. Lưu bản ghi mới thành công.<br>2. Hiển thị thông báo thành công.<br>3. Dữ liệu trong Database khớp hoàn toàn các trường thông tin đã điền trên UI. | | | | | | | | |
-
-### 3.5. Kiểm thử Ngoại lệ & Hệ thống (Exceptions & Systems)
-
-| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| [ID_024] | Bấm nút Đăng ký nhiều lần liên tiếp (Double Click) | High | Đã điền đầy đủ dữ liệu hợp lệ | 1. Click liên tiếp nhiều lần vào nút Đăng ký/Lưu. | - | Nút bấm bị disable ngay sau lượt click đầu tiên. Hệ thống chỉ xử lý và tạo duy nhất 1 bản ghi trong DB, không tạo trùng lặp. | | | | | | | | |
-| [ID_025] | Kiểm tra mất kết nối mạng đột ngột khi bấm Lưu | High | Điền đầy đủ dữ liệu hợp lệ | 1. Bấm nút Lưu.<br>2. Đồng thời ngắt kết nối mạng (hoặc giả lập mất kết nối mạng). | - | Hệ thống hiển thị loading và thông báo lỗi kết nối mạng, không bị crash hoặc treo màn hình trắng. | | | | | | | | |
-| [ID_026] | Kiểm tra nhấn nút Quay lại (戻る) | Low | Đã điền một số dữ liệu | 1. Nhập một số thông tin.<br>2. Bấm nút Quay lại. | - | Hệ thống chuyển hướng về màn hình danh sách trước đó.<br>Bản ghi mới không được tạo trong DB. | | | | | | | | |
+| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID_016] | Kiểm tra không upload file (Trường tùy chọn) | Medium | Đã truy cập màn hình | 1. Không chọn file upload.<br>2. Bấm nút thực hiện. | - | Hệ thống cho phép thực hiện thành công mà không báo lỗi. | | |
+| [ID_017] | Kiểm tra upload file sai định dạng | High | Định dạng cho phép: jpeg, png | 1. Chọn upload file có định dạng không được phép (xlsx, gif, pdf...). | File `.pdf`, `.xlsx` | Upload không thành công. Hiển thị thông báo lỗi đúng thiết kế: "Hình ảnh phải là định dạng jpeg hoặc png." | | |
+| [ID_018] | Kiểm tra upload dung lượng vượt quá giới hạn | High | Giới hạn dung lượng: tối đa 10MB | 1. Chọn file có kích thước > 10MB.<br>2. Tiến hành upload. | File kích thước `10.5MB` | Upload thất bại. Hiển thị lỗi cảnh báo: "Dung lượng hình ảnh vượt quá 10MB." | | |
+| [ID_019] | Kiểm tra upload file giả mạo đuôi mở rộng (Spoofing) | High | Đã truy cập màn hình | 1. Đổi đuôi file thực thi nguy hiểm `.exe` thành `.jpg`.<br>2. Chọn upload file này. | File `.exe` đổi tên thành `.jpg` | Hệ thống kiểm tra phần thân file (MIME type) thực tế và báo lỗi không đúng định dạng. | | |
+| [ID_020] | Kiểm tra kéo thả file (Drag & Drop) | Low | Đã truy cập màn hình | 1. Kéo file ảnh thả vào vùng upload. | File `.png` hợp lệ | Upload file thành công và hiển thị thumbnail ảnh xem trước trên giao diện. | | |
+
+### 2.4. Kiểm thử Logic Nghiệp vụ (Business Rules - BR)
+
+| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID_021] | Kiểm tra ràng buộc trùng lặp dữ liệu duy nhất (Unique) | High | Đã tồn tại bản ghi trong DB | 1. Nhập thông tin trùng khóa chính/mã duy nhất với bản ghi cũ.<br>2. Điền các thông tin hợp lệ khác.<br>3. Bấm Đăng ký. | Mã trùng lặp | Hệ thống báo lỗi trùng lặp: "Mã/Tên này đã tồn tại trong hệ thống. Vui lòng kiểm tra lại." | | |
+| [ID_022] | Kiểm tra logic liên kết dữ liệu động (Dynamic Form Control) | High | Điều kiện thay đổi hiển thị | 1. Tích chọn/Bỏ tích chọn [Checkbox điều kiện]. | - | Giao diện tự động thay đổi hiển thị ẩn/hiện hoặc disable/enable các trường thông tin liên quan theo đúng mô tả BR. | | |
+| [ID_023] | Kiểm tra lưu dữ liệu vào Database thành công | Critical | Nhập đầy đủ và chính xác tất cả dữ liệu hợp lệ | 1. Nhập toàn bộ dữ liệu hợp lệ.<br>2. Bấm nút Đăng ký.<br>3. Kiểm tra DB và màn hình danh sách. | Dữ liệu hợp lệ | 1. Lưu bản ghi mới thành công.<br>2. Hiển thị thông báo thành công.<br>3. Dữ liệu trong Database khớp hoàn toàn các trường thông tin đã điền trên UI. | | |
+
+### 2.5. Kiểm thử Ngoại lệ & Hệ thống (Exceptions & Systems)
+
+| Test Case ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment |
+|---|---|---|---|---|---|---|---|---|
+| [ID_024] | Bấm nút Đăng ký nhiều lần liên tiếp (Double Click) | High | Đã điền đầy đủ dữ liệu hợp lệ | 1. Click liên tiếp nhiều lần vào nút Đăng ký/Lưu. | - | Nút bấm bị disable ngay sau lượt click đầu tiên. Hệ thống chỉ xử lý và tạo duy nhất 1 bản ghi trong DB, không tạo trùng lặp. | | |
+| [ID_025] | Kiểm tra mất kết nối mạng đột ngột khi bấm Lưu | High | Điền đầy đủ dữ liệu hợp lệ | 1. Bấm nút Lưu.<br>2. Đồng thời ngắt kết nối mạng (hoặc giả lập mất kết nối mạng). | - | Hệ thống hiển thị loading và thông báo lỗi kết nối mạng, không bị crash hoặc treo màn hình trắng. | | |
+| [ID_026] | Kiểm tra nhấn nút Quay lại (戻る) | Low | Đã điền một số dữ liệu | 1. Nhập một số thông tin.<br>2. Bấm nút Quay lại. | - | Hệ thống chuyển hướng về màn hình danh sách trước đó.<br>Bản ghi mới không được tạo trong DB. | | |
 ```

package/custom/templates/shared/coding-workflow.md

@@ -0,0 +1,15 @@
+## /coding — Manual Trigger for the DEV Coding Workflow
+
+**Why this command exists:** the `[DEV] 5-Gate Development Workflow` (for `taskType`: `bug-fix`, `feature`, `refactor`, `investigation`, `documentation`) normally auto-starts via the `SessionStart` hook, which only fires when a Claude Code session **starts, resumes, or is cleared**. If a ticket was loaded with `ak use <TICKET-ID>` while this chat session was already open, the hook never re-ran — so this session has no ticket context yet, and typing "start" does nothing because nothing told the AI what "start" means. `/coding` fixes that by loading the ticket context manually, right now.
+
+**Steps — do these now, in order:**
+
+1. Read `.aiflow/context/current.json`.
+   - Missing, or no `taskId` field → tell the developer to run `ak use <TICKET-ID>` first, then stop here.
+2. Read `.aiflow/tasks/[taskId]/task-state.json` if it exists.
+   - If `currentGate > 1` (task already in progress) → **resume at that gate** — do NOT restart from Gate 1. List which gates are already `APPROVED` before continuing.
+   - Otherwise → start fresh at Gate 1.
+3. In this project's main AI instruction file (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, or `.github/copilot-instructions.md` — whichever is present), find the section **`## [DEV] 5-Gate Development Workflow`** and follow it exactly, beginning at the gate identified in step 2.
+4. This workflow applies regardless of the ticket's `taskType` value — `bug-fix`, `feature`, `refactor`, `investigation`, and `documentation` all share this same 5-gate flow (see the "Workflow Selection" table above that section for the full routing).
+
+Do not wait for further confirmation from the developer before starting — begin the identified gate immediately.

package/custom/templates/shared/create-spec-workflow.md

@@ -13,53 +13,53 @@ Các skill sau đây được cài tự động vào `.claude/skills/ba-skills/`
 
 | Skill | File |
 |---|---|
-| `skill-ba-phan-tich-ban-dau` | `.claude/skills/ba-skills/skill-ba-phan-tich-ban-dau-v1.md` |
-| `skill-ba-qa` | `.claude/skills/ba-skills/skill-ba-qa-v1.md` |
-| `skill-ba-prototype` | `.claude/skills/ba-skills/skill-ba-prototype-v1.md` |
-| `skill-ba-ve-luong-mermaid` | `.claude/skills/ba-skills/skill-ba-ve-luong-mermaid-v1.md` |
-| `skill-ba-xay-dung-business-rules` | `.claude/skills/ba-skills/skill-ba-xay-dung-business-rules-v1.md` |
-| `skill-ba-viet-spec-uc` | `.claude/skills/ba-skills/skill-ba-viet-spec-uc-v1.md` |
-| `template-phan-tich-ban-dau` | `.claude/skills/ba-skills/skill-ba-template-phan-tich-ban-dau-v1.md` |
-| `template-qa` | `.claude/skills/ba-skills/skill-ba-qa-template-v1.md` |
-| `template-uc` | `.claude/skills/ba-skills/skill-ba-template-uc-v1.md` |
+| `skill-ba-phan-tich-ban-dau` | `.claude/skills/ba-skills/skill-ba-initial-analysis-v1.md` |
+| `skill-ba-qa` | `.claude/skills/ba-skills/skill-ba-qna-v1.md` |
+| `skill-ba-prototype` | `.claude/skills/ba-skills/skill-ba-ui-prototype-v1.md` |
+| `skill-ba-ve-luong-mermaid` | `.claude/skills/ba-skills/skill-ba-mermaid-flowchart-v1.md` |
+| `skill-ba-xay-dung-business-rules` | `.claude/skills/ba-skills/skill-ba-build-business-rules-v1.md` |
+| `skill-ba-viet-spec-uc` | `.claude/skills/ba-skills/skill-ba-write-uc-spec-v1.md` |
+| `template-phan-tich-ban-dau` | `.claude/skills/ba-skills/skill-ba-initial-analysis-template-v1.md` |
+| `template-qa` | `.claude/skills/ba-skills/skill-ba-qna-template-v1.md` |
+| `template-uc` | `.claude/skills/ba-skills/skill-ba-uc-template-v1.md` |
 
 ---
 
 ### Cấu trúc thư mục đầu ra
 
 ```
-docs/ak-{project}/spec/
-├── phan-tich/
-│   ├── [functionId]_phan-tich(1).md     ← Gate 1 tạo
-│   └── [functionId]_phan-tich(n).md     ← Gate 2 cập nhật (tăng version)
-├── QA/
-│   ├── [functionId]_QA(1).md            ← Gate 1 tạo
-│   └── [functionId]_QA(m).md            ← Gate 2 tạo thêm nếu còn Open
-├── design/
-│   └── [functionId]_design.html         ← Gate 3 tạo
-└── UC/
-    └── [functionId]_UC.md               ← Gate 4 tạo
+02.BA-Specs/
+├── 01.Analysis/
+│   ├── [functionId]/Analysis_v1.md      ← Gate 1 tạo
+│   └── [functionId]/Analysis_vn.md      ← Gate 2 cập nhật (tăng version)
+├── 02.QnA/
+│   ├── [functionId]/QnA-Log_v1.md       ← Gate 1 tạo
+│   └── [functionId]/QnA-Log_vm.md       ← Gate 2 tạo thêm nếu còn Open
+├── 03.UI-Prototypes/
+│   └── [functionId]/UI-Prototype_v1.html← Gate 3 tạo
+└── 04.UC-Specs/
+    └── [functionId]/UC-Spec_v1.md       ← Gate 4 tạo
 ```
 
-Ví dụ: `functionId = AD10`, `project = coinbook` → thư mục gốc là `docs/ak-coinbook/spec/`
+Ví dụ: `functionId = AD10` → thư mục gốc là `02.BA-Specs/`
 
 ---
 
 ### Quy trình tổng quan 4 Gates
 
 ```
-(spec/ = docs/ak-{project}/spec/ — viết tắt cho ngắn gọn)
+(BA-Specs/ = 02.BA-Specs/ — viết tắt cho ngắn gọn)
 
-[Input: Jira / Backlog / file] → Pre-flight: xác định functionId + thư mục đầu ra
+[Input: Jira / Backlog / file] → Pre-flight: BẮT BUỘC xác định functionId
     ↓
-Gate 1: Phân tích yêu cầu & Tạo Q&A       → spec/phan-tich/ + spec/QA/
+Gate 1: Phân tích yêu cầu & Tạo Q&A       → BA-Specs/01.Analysis/ + BA-Specs/02.QnA/
     ↓ APPROVED
 Gate 2: Cập nhật phản hồi Q&A ←─────────────────────────────────────────┐
-    ↓ còn Open → tạo QA(m+1) → đợi BA phản hồi → lặp lại ───────────────┘
+    ↓ còn Open → tạo QnA-Log_v(m+1) → đợi BA phản hồi → lặp lại ────────┘
     ↓ tất cả Confirmed + APPROVED
-Gate 3: Thiết kế UI Prototype HTML/CSS     → spec/design/
+Gate 3: Thiết kế UI Prototype HTML/CSS     → BA-Specs/03.UI-Prototypes/
     ↓ APPROVED
-Gate 4: Viết đặc tả Use Case Spec          → spec/UC/
+Gate 4: Viết đặc tả Use Case Spec          → BA-Specs/04.UC-Specs/
     ↓ APPROVED
 Bàn giao Dev/Test
 ```
@@ -71,55 +71,46 @@ Bàn giao Dev/Test
 **Mục tiêu:** Tiếp nhận đầu vào, hiểu nghiệp vụ, phát hiện khoảng trống (Gaps), lập bản phân tích sơ bộ và danh sách Q&A.
 
 **Đầu ra (Outputs):**
-- `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(1).md`
-- `docs/ak-{project}/spec/QA/[functionId]_QA(1).md`
+- `02.BA-Specs/01.Analysis/[functionId]/Analysis_v1.md`
+- `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v1.md`
 
 **Bước thực hiện:**
 
 #### Bước 0: Pre-flight — Xác định functionId và thư mục đầu ra
 
-**Xác định `functionId`:**
+**Xác định `functionId` (BẮT BUỘC):**
 
 Kiểm tra theo thứ tự ưu tiên:
 1. Trường `functionId` hoặc `screenId` trong `.aiflow/context/current.json`
 2. Rút gọn từ `ticketId` — bỏ dấu gạch, giữ ký hiệu (ví dụ: `AD-10` → `AD10`)
-3. Nếu không tìm thấy → **hỏi BA ngay**:
+3. Nếu không tìm thấy → **BẮT BUỘC hỏi BA ngay**:
 
 ```
 Không tìm thấy functionId trong context.
 Vui lòng cung cấp mã định danh cho chức năng này (ví dụ: AD10, UC-LOGIN, PM-003):
 ```
 
-→ Đợi BA trả lời, ghi nhận giá trị, dùng cho toàn bộ workflow.
+→ Đợi BA trả lời, ghi nhận giá trị, dùng cho toàn bộ workflow. KHÔNG ĐƯỢC TIẾP TỤC NẾU CHƯA CÓ functionId.
 
-**Xác định `{project}` và thư mục đầu ra:**
+**Xác định thư mục đầu ra:**
 
-1. Lấy `{project}` theo thứ tự ưu tiên:
-   - Trường `project` trong `.aiflow/context/current.json`
-   - Tên thư mục gốc workspace (chuyển lowercase, thay space bằng `-`)
-
-2. Kiểm tra tồn tại thư mục `docs/ak-{project}/spec/` trong root dự án:
+1. Kiểm tra tồn tại thư mục `02.BA-Specs/` trong root dự án:
    - **Tìm thấy** → thông báo xác nhận:
      ```
-     ✓ Thư mục đầu ra: docs/ak-{project}/spec/
+     ✓ Thư mục đầu ra: 02.BA-Specs/
      ✓ functionId: [functionId]
      → Bắt đầu Gate 1...
      ```
-   - **Không tìm thấy** → **hỏi BA**:
-     ```
-     Không tìm thấy thư mục docs/ak-{project}/spec/.
-     Tên project là gì? (ví dụ: coinbook, crm-app)
-     ```
-     → Nhận tên project từ BA → chuyển lowercase → tạo toàn bộ cây thư mục:
+   - **Không tìm thấy** → tạo toàn bộ cây thư mục:
      ```
-     docs/ak-{project}/spec/phan-tich/
-     docs/ak-{project}/spec/QA/
-     docs/ak-{project}/spec/design/
-     docs/ak-{project}/spec/UC/
+     02.BA-Specs/01.Analysis/
+     02.BA-Specs/02.QnA/
+     02.BA-Specs/03.UI-Prototypes/
+     02.BA-Specs/04.UC-Specs/
      ```
      → Thông báo:
      ```
-     ✓ Đã tạo thư mục: docs/ak-{project}/spec/
+     ✓ Đã tạo thư mục: 02.BA-Specs/
      ✓ functionId: [functionId]
      → Bắt đầu Gate 1...
      ```
@@ -129,6 +120,7 @@ Vui lòng cung cấp mã định danh cho chức năng này (ví dụ: AD10, UC-
 - Nếu description có URL → chạy `ak fetch-links <url>` để tải nội dung
 - Nếu có `supplementaryContext[]` → đọc từng item (file đính kèm, ticket liên quan, comment PM)
 - Nếu có file yêu cầu thô được chỉ định → đọc file đó
+- **READ skill:** `.superpowers/skills/brainstorming/SKILL.md` (hoặc `brainstorming` skill) để chủ động làm rõ các yêu cầu thô, khơi gợi ý tưởng trước khi phân tích.
 
 #### Bước 1b: Đọc Source Code
 
@@ -160,26 +152,25 @@ Nếu workspace mở dạng parent folder chứa cả `ak docs` lẫn source cod
 - Nếu có điểm mơ hồ cốt yếu → hỏi ONE câu làm rõ, đợi BA trả lời trước khi tiếp tục
 
 #### Bước 3: Soạn thảo Kết quả phân tích sơ bộ
-- **READ template:** `.claude/skills/ba-skills/skill-ba-template-phan-tich-ban-dau-v1.md`
+- **READ template:** `.claude/skills/ba-skills/skill-ba-initial-analysis-template-v1.md`
 - Điền đầy đủ các mục theo template: Actors, Facts, Assumptions, Gap Analysis table
-- Lưu: `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(1).md`
+- Lưu: `02.BA-Specs/01.Analysis/[functionId]/Analysis_v1.md`
 
 #### Bước 4: Soạn thảo danh sách Q&A
-- **READ skill:** `.claude/skills/ba-skills/skill-ba-qa-v1.md`
-- **READ template:** `.claude/skills/ba-skills/skill-ba-qa-template-v1.md`
+- **READ skill:** `.claude/skills/ba-skills/skill-ba-qna-v1.md`
+- **READ template:** `.claude/skills/ba-skills/skill-ba-qna-template-v1.md`
 - Chuyển từng Gap thành câu hỏi cụ thể, khách quan, không định hướng
 - Mỗi câu hỏi tương ứng với ít nhất một Gap. Trạng thái ban đầu: **Open**
-- Lưu: `docs/ak-{project}/spec/QA/[functionId]_QA(1).md`
+- Lưu: `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v1.md`
 
 #### Bước 5: Gate Review & Pause
 - **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-1-[functionId].md`
-- **Kiểm tra Q&A bắt buộc:** Đọc `QA(1).md` — đếm số câu có trạng thái **Open**
+- **Kiểm tra Q&A bắt buộc:** Đọc `QnA-Log_v1.md` — đếm số câu có trạng thái **Open**
 - Hiển thị gate pause message — chờ phản hồi từ BA
 
-**Nếu nhận được APPROVED mà QA(1).md còn câu hỏi Open → từ chối ngay, hiển thị:**
+**Nếu nhận được APPROVED mà QnA-Log_v1.md còn câu hỏi Open → từ chối ngay, hiển thị:**
 
-```
-⛔ GATE 1 BLOCKED — Còn [N] câu hỏi chưa được trả lời trong QA(1).md.
+⛔ GATE 1 BLOCKED — Còn [N] câu hỏi chưa được trả lời trong QnA-Log_v1.md.
 
 | ID | Câu hỏi còn Open |
 |----|-----------------|
@@ -188,10 +179,9 @@ Nếu workspace mở dạng parent folder chứa cả `ak docs` lẫn source cod
 Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 → Option A: nhập trực tiếp — `Q1: [trả lời], Q2: [trả lời]`
 → Option B: paste nội dung bảng Q&A đã điền vào chat
-→ Option C: đặt file `[functionId]_QA(1)_response.md` vào thư mục QA/ rồi gõ NEXT
+→ Option C: đặt file `QnA-Log_v1_response.md` vào thư mục `02.QnA/[functionId]/` rồi gõ NEXT
 
 ❌ APPROVED không được chấp nhận cho đến khi 100% câu hỏi đã Confirmed.
-```
 
 **Khi APPROVED (chỉ sau khi tất cả câu hỏi trong QA(1).md đã Confirmed):**
 → **INVOKE** `gate-review` skill (verify mode) — chạy `ak review check --gate 1 --ticket [functionId]`
@@ -199,9 +189,9 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 → Nếu blocked: làm theo gate-review skill response protocol
 
 **Definition of Done:**
-- [ ] `functionId` và `{project}` đã được xác định và thư mục đầu ra đã sẵn sàng
-- [ ] File `phan-tich(1).md` tạo đúng vị trí, cấu trúc đúng template, có bảng Gap Analysis
-- [ ] File `QA(1).md` có ít nhất 1 câu hỏi cho mỗi Gap, tất cả trạng thái **Open**
+- [ ] `functionId` đã được xác định và thư mục đầu ra đã sẵn sàng
+- [ ] File `Analysis_v1.md` tạo đúng vị trí, cấu trúc đúng template, có bảng Gap Analysis
+- [ ] File `QnA-Log_v1.md` có ít nhất 1 câu hỏi cho mỗi Gap, tất cả trạng thái **Open**
 - [ ] Không có giả định nào được tự ý chốt thành Spec mà không đưa vào Q&A
 
 > **Telemetry:** Run `ak gate 1 start --ticket [functionId]` khi bắt đầu gate này.
@@ -215,54 +205,50 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 
 **Đầu vào (Inputs):**
 - Phản hồi Q&A từ BA (xem 3 option bên dưới)
-- `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n).md` — phiên bản hiện tại
-- `docs/ak-{project}/spec/QA/[functionId]_QA(m).md` — danh sách câu hỏi hiện tại
+- `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n).md` — phiên bản hiện tại
+- `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m).md` — danh sách câu hỏi hiện tại
 
 **Cách BA cung cấp phản hồi (BA chọn một trong 3):**
 - **Option A** — Nhập trực tiếp vào chat: `Q&A: Q1: [trả lời], Q2: [trả lời]`
 - **Option B** — Paste nội dung bảng Q&A đã điền vào chat
-- **Option C** — Đặt file tại: `docs/ak-{project}/spec/QA/[functionId]_QA(m)_response.md`
+- **Option C** — Đặt file tại: `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m)_response.md`
 
 **Bước thực hiện:**
 
 #### Bước 1: Tiếp nhận và đánh giá câu trả lời
-- **READ skill:** `.claude/skills/ba-skills/skill-ba-qa-v1.md` và làm theo
-- Đối chiếu từng câu trả lời với câu hỏi trong `QA(m).md`
+- Đối chiếu từng câu trả lời với câu hỏi trong `QnA-Log_v(m).md`
 - Phân loại:
   - Đủ thông tin → cập nhật trạng thái: **Confirmed**
   - Chưa rõ hoặc phát sinh nghiệp vụ mới → giữ trạng thái **Open**, bổ sung ghi chú
 
 #### Bước 2: Tích hợp thông tin vào tài liệu phân tích
-- Lấy thông tin từ các câu Confirmed → cập nhật vào `phan-tich(n).md`
+- Lấy thông tin từ các câu Confirmed → cập nhật vào `Analysis_v(n).md`
 - Xóa các Gap đã được giải quyết khỏi bảng Gap Analysis
-- Tạo phiên bản mới: `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1).md`
+- Tạo phiên bản mới: `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md`
 
 #### Bước 3: Rẽ nhánh theo trạng thái Q&A
 
 **Kịch bản A — Vẫn còn câu hỏi Open:**
-1. Dùng `skill-ba-phan-tich-ban-dau` kiểm tra `phan-tich(n+1).md` có phát sinh Gap mới không
-2. Tạo: `docs/ak-{project}/spec/QA/[functionId]_QA(m+1).md` theo `skill-ba-qa` — chỉ giữ câu Open và câu mới phát sinh
+1. Kiểm tra `Analysis_v(n+1).md` có phát sinh Gap mới không
+2. Tạo: `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md` — chỉ giữ câu Open và câu mới phát sinh
 3. **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-2-[functionId]-round-[m+1].md`
 4. Hiển thị:
 
-```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ⏸️  GATE 2 — VÒNG Q&A [m+1]
 
 Câu hỏi còn Open: [N]
-File Q&A mới:     [docs/ak-{project}/spec/QA/[functionId]_QA(m+1).md](docs/ak-{project}/spec/QA/[functionId]_QA(m+1).md)
-File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1).md](docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1).md)
+File Q&A mới:     [02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md](02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md)
+File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md)
 
 → BA điền câu trả lời và cung cấp theo một trong 3 option (A/B/C)
 → Sau khi cung cấp phản hồi, type NEXT để AI xử lý vòng tiếp theo
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
 
 5. Lặp lại Bước 1 khi nhận phản hồi mới
 
 **Nếu BA gõ APPROVED khi đang ở Kịch bản A (còn câu hỏi Open) → từ chối ngay:**
 
-```
 ⛔ GATE 2 BLOCKED — Còn [N] câu hỏi chưa Confirmed.
 
 | ID | Câu hỏi còn Open |
@@ -271,7 +257,6 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 
 → Cung cấp câu trả lời (Option A/B/C) rồi gõ NEXT để AI xử lý tiếp.
 ❌ APPROVED chỉ được chấp nhận khi 100% câu hỏi đã Confirmed.
-```
 
 **Kịch bản B — Tất cả đã Confirmed:**
 1. Chốt tài liệu phân tích (phiên bản cuối cùng là đầu vào Gate 3)
@@ -300,10 +285,10 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 **Điều kiện vào Gate 3:** Tất cả Q&A đã **Confirmed** và Gate 2 đã **APPROVED**.
 
 **Đầu vào (Inputs):**
-- `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n).md` — phiên bản cuối
+- `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n).md` — phiên bản cuối
 
 **Đầu ra (Outputs):**
-- `docs/ak-{project}/spec/design/[functionId]_design.html`
+- `02.BA-Specs/03.UI-Prototypes/[functionId]/UI-Prototype_v1.html`
 
 **Bước thực hiện:**
 
@@ -323,7 +308,7 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 - CSS nổi bật lỗi (chữ đỏ, viền đỏ), mặc định ẩn (`display: none`)
 
 #### Bước 4: Lưu file
-- `docs/ak-{project}/spec/design/[functionId]_design.html`
+- `02.BA-Specs/03.UI-Prototypes/[functionId]/UI-Prototype_v1.html`
 
 #### Bước 5: Gate Review & Pause
 - **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-3-[functionId].md`
@@ -335,7 +320,7 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 → Nếu blocked: làm theo gate-review skill response protocol
 
 **Definition of Done:**
-- [ ] File `[functionId]_design.html` tạo đúng vị trí
+- [ ] File `UI-Prototype_v1.html` tạo đúng vị trí
 - [ ] Giao diện hiển thị đủ tất cả thành phần nghiệp vụ
 - [ ] 100% thẻ tương tác có `id` duy nhất
 - [ ] CSS tự chứa trong file HTML
@@ -352,18 +337,18 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 **Điều kiện vào Gate 4:** Gate 3 đã **APPROVED** và `design.html` đã hoàn chỉnh.
 
 **Đầu vào (Inputs):**
-- `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n).md` — phiên bản cuối
-- `docs/ak-{project}/spec/design/[functionId]_design.html`
+- `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n).md` — phiên bản cuối
+- `02.BA-Specs/03.UI-Prototypes/[functionId]/UI-Prototype_v1.html`
 
 **Đầu ra (Outputs):**
-- `docs/ak-{project}/spec/UC/[functionId]_UC.md`
+- `02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v1.md`
 
 **Bước thực hiện:**
 
 #### Bước 1: Khởi tạo Spec từ Template
-- **READ template:** `.claude/skills/ba-skills/skill-ba-template-uc-v1.md`
-- **READ skill:** `.claude/skills/ba-skills/skill-ba-viet-spec-uc-v1.md`
-- Tạo: `docs/ak-{project}/spec/UC/[functionId]_UC.md`
+- **READ template:** `.claude/skills/ba-skills/skill-ba-uc-template-v1.md`
+- **READ skill:** `.claude/skills/ba-skills/skill-ba-write-uc-spec-v1.md`
+- Tạo: `02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v1.md`
 - Điền General Information: Use Case ID, Title, Version, Actors, Preconditions, Postconditions
 
 #### Bước 2: Mô tả luồng sự kiện (Flow of Events)
@@ -373,7 +358,7 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 - Viết rõ tương tác Actor ↔ System ở từng bước
 
 #### Bước 3: Tích hợp giao diện Prototype
-- Copy toàn bộ mã HTML/CSS từ `design.html` vào phần Screen Description
+- Copy toàn bộ mã HTML/CSS từ `UI-Prototype_v1.html` vào phần Screen Description
 
 #### Bước 4: Mô tả chi tiết UI Components
 - Lập bảng: Tên | Loại | Bắt buộc | Độ dài tối đa | Giá trị mặc định | Ràng buộc validation
@@ -405,7 +390,7 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 - BA gõ `REVISION: [nội dung]` → cập nhật section liên quan → re-generate review file → hiển thị lại gate pause
 
 **Definition of Done:**
-- [ ] File `[functionId]_UC.md` đúng vị trí và cấu trúc template
+- [ ] File `UC-Spec_v1.md` đúng vị trí và cấu trúc template
 - [ ] 100% element HTML được mô tả trong bảng UI Components (id, loại, ràng buộc)
 - [ ] Mã Mermaid hợp lệ, thể hiện đủ Main/Alternative/Exception Flow
 - [ ] Business Rules đầy đủ với mã `[BR-NNN]` và thông báo lỗi chính xác
@@ -420,10 +405,10 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 
 | Gate | Skills đọc | Output |
 |---|---|---|
-| Gate 1 | `skill-ba-phan-tich-ban-dau`, `template-phan-tich-ban-dau`, `skill-ba-qa`, `template-qa` | `phan-tich(1).md`, `QA(1).md` |
-| Gate 2 | `skill-ba-qa`, `skill-ba-phan-tich-ban-dau` | `phan-tich(n+1).md`, `QA(m+1).md` (nếu còn Open) |
-| Gate 3 | `skill-ba-prototype` | `design.html` |
-| Gate 4 | `skill-ba-viet-spec-uc`, `template-uc`, `skill-ba-ve-luong-mermaid`, `skill-ba-xay-dung-business-rules` | `_UC.md` |
+| Gate 1 | `brainstorming`, `skill-ba-initial-analysis`, `skill-ba-initial-analysis-template`, `skill-ba-qna`, `skill-ba-qna-template` | `Analysis_v1.md`, `QnA-Log_v1.md` |
+| Gate 2 | `skill-ba-qna`, `skill-ba-initial-analysis` | `Analysis_v(n+1).md`, `QnA-Log_v(m+1).md` (nếu còn Open) |
+| Gate 3 | `skill-ba-ui-prototype` | `UI-Prototype_v1.html` |
+| Gate 4 | `skill-ba-write-uc-spec`, `skill-ba-uc-template`, `skill-ba-mermaid-flowchart`, `skill-ba-build-business-rules` | `UC-Spec_v1.md` |
 
 ---