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

package/custom/skills/test-skills/template/template_testcase.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/create-spec-workflow.md

@@ -178,7 +178,6 @@ Nếu workspace mở dạng parent folder chứa cả `ak docs` lẫn source cod
 
 **Nếu nhận được APPROVED mà QA(1).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.
 
 | ID | Câu hỏi còn Open |
@@ -191,7 +190,6 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 → Option C: đặt file `[functionId]_QA(1)_response.md` vào thư mục QA/ 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]`
@@ -245,7 +243,6 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 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]
 
@@ -256,13 +253,11 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 → 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 +266,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)

package/docs/common/CHANGELOG.md

@@ -7,6 +7,53 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [0.1.4] - 2026-06-29
+
+### Added
+
+- **`spec` task type — 4-Gate BA Workflow (Create Spec)** — New end-to-end spec creation workflow for Business Analysts. Activated when `taskType: "spec"` in context. Orchestrated by the `create-spec` skill across 4 gates:
+  - **Gate 1 — Phân tích Yêu cầu Ban đầu**: AI reads ticket, classifies Facts vs Assumptions, identifies Gaps, generates a Q&A list for clarification. BA reviews → `APPROVED`.
+  - **Gate 2 — Q&A Loop & Confirm**: AI iterates through each Q&A answer, updates analysis until all items are Confirmed. BA approves full Q&A → `APPROVED`.
+  - **Gate 3 — Prototype Design**: AI generates HTML/CSS prototype for the main screens. BA reviews UI flow → `APPROVED`.
+  - **Gate 4 — UC Spec hoàn chỉnh**: AI produces a complete UC Spec document (flows, business rules, validations, edge cases). BA reviews → `APPROVED`.
+
+- **`testcase` task type — 4-Gate QA Workflow (Create Testcase)** — New structured test case creation workflow for QA engineers. Activated when `taskType: "testcase"` in context. Orchestrated by the `create-testcase` skill across 4 gates:
+  - **Gate 1 — Phân tích Yêu cầu & Rủi ro**: AI reads ticket/spec, analyzes scope and risk, reads source code to discover hidden validation rules and business logic. QA reviews → `APPROVED`.
+  - **Gate 2 — Xây dựng Scenarios & Checklist**: AI generates checklist grouped by Functional, Non-functional, Data & Integration, Regression. Checks Dev Artifacts (PR diff) via `pr-impact-analysis` skill to add regression TCs. Output: `test-plan/checklist.md`. QA reviews → `APPROVED`.
+  - **Gate 3 — Thiết kế Test Case chi tiết**: AI generates full TC table (TC_ID, Steps, Expected Result) using BVA, Equivalence Partitioning, Decision Table, State Transition techniques. Output: `test-plan/test-cases/`. QA reviews → `APPROVED`.
+  - **Gate 4 — Review & Tối ưu**: AI reviews coverage, removes duplicates, adds missing edge cases, exports final set to `test-plan/test-cases/final-testcases.md`. QA reviews → `APPROVED`.
+
+- **BA Skills Library** (`custom/skills/ba-skills/`) — New collection of BA-specific sub-skills:
+  - `skill-ba-phan-tich-ban-dau-v1` — Initial requirement analysis (Facts vs Assumptions, Gap Analysis)
+  - `skill-ba-qa-v1` — Q&A generation and confirmation loop
+  - `skill-ba-viet-spec-uc-v1` — UC Spec writing with flows, business rules, validations
+  - `skill-ba-prototype-v1` — HTML/CSS prototype generation for UI screens
+  - `skill-ba-ve-luong-mermaid-v1` — Mermaid flow diagram generation
+  - `skill-ba-xay-dung-business-rules-v1` — Business rules extraction and structuring
+
+- **Test Skills Library** (`custom/skills/test-skills/`) — New collection of 20+ QA sub-skills organized by category:
+  - **Core**: `requirement-analysis`, `risk-analysis`, `test-scenario-builder`, `testcase-review`
+  - **Test Design**: `boundary-value-analysis`, `equivalence-partitioning`, `decision-table`, `state-transition`, `pairwise`, `error-guessing`
+  - **UI Testing**: `UI-layout`, `form-validation`, `navigation`, `localization`, `accessibility`
+  - **Business Testing**: `CRUD-testing`, `workflow-testing`, `permission-testing`, `dependency-validation`, `notification-testing`, `calculation-testing`
+  - **Data Testing**: `database-testing`, `import-export-testing`, `data-mapping`, `duplicate-handling`, `migration`
+  - **Integration**: `API-testing`, `third-party-integration`, `batch-processing`, `file-upload-download`
+  - **Domain Skills**: `CMS`, `Ecommerce`
+  - **Review**: `coverage-review`, `knowledge-learning`, `repository-update`, `change-history`
+
+- **`gate-review` skill** (`custom/skills/gate-review/SKILL.md`) — New gate review orchestration skill that enforces explicit `APPROVED` at each gate boundary across all workflow types (coding, execute, spec, testcase). Prevents silent gate advancement without QA/BA/DEV sign-off.
+
+- **Gate review protocol in Execute Test Flow** — Gates 1, 3, and 4 of the execute-flow now explicitly require QA `APPROVED` before advancing. Gate 2 (Script Sync) is AI-only and advances automatically after sync completes.
+
+- **`spec` and `testcase` options in `ak use` type selector** — Both the `promptForTaskType()` shared function and the `manualContext()` flow now include `spec` and `testcase` as selectable types, routing AI to the correct 4-gate workflow.
+
+### Changed
+
+- **`aiflow` CLI alias fully deprecated → use `ak`** — All documentation, README, QUICK_START, cli-reference, and guide output updated to use `ak` as the primary command. The `aiflow` command still works but shows a deprecation warning on every invocation.
+- **README restructured** — "Overview Flow" section renamed to "Coding Flow"; Execute Test Flow merged into a single diagram (removed duplicate Vietnamese section); Create Spec Flow and Create Testcase Flow diagrams added.
+
+---
+
 ## [0.1.3] - 2026-06-18
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relipa/ai-flow-kit",
-  "version": "0.1.4-beta.0",
+  "version": "0.1.4",
   "description": "All-in-one AI Flow Kit for team development with Claude AI - skills, templates, and MCP adapters",
   "author": "Example Team",
   "publishConfig": {

package/scripts/review.js

@@ -9,6 +9,10 @@ function reviewFilePath(gate, ticketId) {
     return path.join(process.cwd(), REVIEW_DIR, `gate-${gate}-${ticketId}.md`);
 }
 
+function commentsFilePath(ticketId) {
+    return path.join(process.cwd(), REVIEW_DIR, `comments-${ticketId}.json`);
+}
+
 /**
  * Parse a gate review file and return checkbox state.
  *
@@ -17,65 +21,98 @@ function reviewFilePath(gate, ticketId) {
  * @returns {Promise<{exists: boolean, passed?: boolean, total?: number, unchecked?: string[], commented?: Array<{item: string, comment: string}>}>}
  */
 async function checkReviewFile(gate, ticketId) {
-    const filePath = reviewFilePath(gate, ticketId);
+    const mdPath = reviewFilePath(gate, ticketId);
+    const jsonPath = commentsFilePath(ticketId);
+
+    const mdExists = await fs.pathExists(mdPath);
+    const jsonExists = await fs.pathExists(jsonPath);
 
-    if (!(await fs.pathExists(filePath))) {
+    if (!mdExists && !jsonExists) {
         return { exists: false };
     }
 
-    const content = await fs.readFile(filePath, 'utf-8');
-    const lines = content.split('\n');
-
     const unchecked = [];
     const commented = [];
     let total = 0;
 
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const checkboxMatch = line.match(/^- \[([ xX])\] (.+)/);
-        if (!checkboxMatch) continue;
-
-        total++;
-        const isChecked = checkboxMatch[1].toLowerCase() === 'x';
-        const itemText = checkboxMatch[2].trim();
-
-        if (!isChecked) {
-            let comment = null;
-            let commentBuffer = '';
-            let inComment = false;
-            for (let j = i + 1; j < lines.length; j++) {
-                const nextLine = lines[j].trim();
-                if (!inComment && nextLine.match(/^- \[/)) break;
-                if (!inComment && nextLine === '---') break;
-                if (!inComment) {
-                    const singleLineMatch = nextLine.match(/<!--([\s\S]+?)-->/);
-                    if (singleLineMatch) {
-                        comment = singleLineMatch[1].trim();
-                        break;
-                    }
-                    if (nextLine.includes('<!--')) {
-                        inComment = true;
-                        commentBuffer = nextLine.replace(/^.*<!--/, '');
-                        if (commentBuffer.includes('-->')) {
-                            comment = commentBuffer.replace(/-->.*$/, '').trim();
+    // 1. Process JSON comments if file exists
+    if (jsonExists) {
+        try {
+            const data = await fs.readJson(jsonPath);
+            const comments = Array.isArray(data) ? data : (data.comments || []);
+            
+            // Filter comments by gate
+            const gateComments = comments.filter(c => String(c.gate) === String(gate));
+            total += gateComments.length;
+
+            for (const comment of gateComments) {
+                const isUnresolved = comment.status === 'active' || comment.status === 'unresolved';
+                if (isUnresolved) {
+                    const fileLabel = comment.filePath ? path.basename(comment.filePath) : 'File';
+                    const itemLabel = `**[${fileLabel}:${comment.line || 1}]**`;
+                    commented.push({
+                        item: itemLabel,
+                        comment: comment.text
+                    });
+                }
+            }
+        } catch (err) {
+            console.error(`Error reading comments JSON: ${err.message}`);
+        }
+    }
+
+    // 2. Process MD checklist if file exists
+    if (mdExists) {
+        const content = await fs.readFile(mdPath, 'utf-8');
+        const lines = content.split('\n');
+
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const checkboxMatch = line.match(/^- \[([ xX])\] (.+)/);
+            if (!checkboxMatch) continue;
+
+            total++;
+            const isChecked = checkboxMatch[1].toLowerCase() === 'x';
+            const itemText = checkboxMatch[2].trim();
+
+            if (!isChecked) {
+                let comment = null;
+                let commentBuffer = '';
+                let inComment = false;
+                for (let j = i + 1; j < lines.length; j++) {
+                    const nextLine = lines[j].trim();
+                    if (!inComment && nextLine.match(/^- \[/)) break;
+                    if (!inComment && nextLine === '---') break;
+                    if (!inComment) {
+                        const singleLineMatch = nextLine.match(/<!--([\s\S]+?)-->/);
+                        if (singleLineMatch) {
+                            comment = singleLineMatch[1].trim();
+                            break;
+                        }
+                        if (nextLine.includes('<!--')) {
+                            inComment = true;
+                            commentBuffer = nextLine.replace(/^.*<!--/, '');
+                            if (commentBuffer.includes('-->')) {
+                                comment = commentBuffer.replace(/-->.*$/, '').trim();
+                                break;
+                            }
+                            continue;
+                        }
+                    } else {
+                        if (nextLine.includes('-->')) {
+                            commentBuffer += ' ' + nextLine.replace(/-->.*$/, '');
+                            comment = commentBuffer.trim();
                             break;
                         }
-                        continue;
+                        commentBuffer += ' ' + nextLine;
                     }
+                }
+                if (comment) {
+                    commented.push({ item: itemText, comment });
                 } else {
-                    if (nextLine.includes('-->')) {
-                        commentBuffer += ' ' + nextLine.replace(/-->.*$/, '');
-                        comment = commentBuffer.trim();
-                        break;
-                    }
-                    commentBuffer += ' ' + nextLine;
+                    unchecked.push(itemText);
                 }
             }
-            if (comment) {
-                commented.push({ item: itemText, comment });
-            } else {
-                unchecked.push(itemText);
-            }
         }
     }
 
@@ -88,4 +125,4 @@ async function checkReviewFile(gate, ticketId) {
     };
 }
 
-module.exports = { checkReviewFile, reviewFilePath };
+module.exports = { checkReviewFile, reviewFilePath, commentsFilePath };