improve BA skill

2026-09-09 06:34:57 +07:00
parent 119792967c
commit 2c7bcde741
42 changed files with 5429 additions and 54 deletions
--- a/ba-output/e-commerce/03-specification/AC_US-003_v1.0.md
+++ b/ba-output/e-commerce/03-specification/AC_US-003_v1.0.md
@@ -0,0 +1,267 @@
+# AC — Acceptance Criteria — US-003 Sửa số lượng / xoá sản phẩm trong giỏ hàng
+
+| | |
+|---|---|
+| **Version** | 1.0 |
+| **Date** | 2026-09-08 |
+| **Author** | BA (qua skill ba-3-specification) |
+| **Status** | 🟡 Draft |
+| **Approved by** | QA: — *(chưa có QA thật tham gia lần chạy này)* |
+| **Source** | `SRS_US002-003_v1.0.md` · `RBAC_CartCheckout_v1.0.md` §6 · `BR_CartCheckout_v1.0.md` §3 |
+| **Scope** | US-003 |
+
+## Change Log
+
+| Version | Date | Người sửa | Thay đổi | CR |
+|---|---|---|---|---|
+| 1.0 | 2026-09-08 | BA (qua skill ba-3-specification) | Bản đầu — 13 AC, 4 nhóm (2 AC còn mở chờ `OQ-028`/`OQ-032`, ghi rõ thay vì bịa) | — |
+
+---
+
+## 1. Bốn nhóm bắt buộc
+
+| Nhóm | Nội dung | Tối thiểu | Số AC đã viết |
+|---|---|---|---|
+| 1. Luồng thành công | Tăng/giảm số lượng, xoá dòng, xoá nhóm, xoá giỏ, huỷ modal | 1/hành động | 6 |
+| 2. Validation | Số lượng không hợp lệ; số lượng về 0 | 1/rule | 2 (1 còn mở — `OQ-028`) |
+| 3. Lỗi hệ thống | 5xx cập nhật, timeout xoá, item bị xoá đồng thời | ≥1 | 3 |
+| 4. Phân quyền | Sửa/xoá CartItem không thuộc quyền sở hữu (Customer, Guest) | ≥1/vai trò | 2 (1 còn mở — `OQ-032`) |
+
+---
+
+## 2. Danh sách AC
+
+### Nhóm 1 — Luồng thành công
+
+#### AC-US003-01 — Tăng số lượng CartItem thành công
+
+| | |
+|---|---|
+| **Liên quan** | SCR-04 · F01, C08, C09 |
+| **Vai trò** | ROLE-02 (tương tự ROLE-01) |
+
+```
+Given  CartItem X có quantity=2, Cart.status=active
+When   tôi bấm nút "+" (F01) để tăng số lượng lên 3
+Then   hệ thống gọi PATCH /v1/cart/items/{X} với quantity=3, nhận 200 OK
+ And   F01 hiển thị 3; tạm tính nhóm (C08) và tổng cộng (C09) cập nhật lại ngay theo giá trị mới
+```
+
+#### AC-US003-02 — Giảm số lượng CartItem thành công (còn ≥1)
+
+```
+Given  CartItem X có quantity=3
+When   tôi bấm nút "-" (F01) để giảm còn 2
+Then   PATCH thành công, F01=2, C08/C09 cập nhật
+```
+
+#### AC-US003-03 — Xoá CartItem thành công (đã xác nhận modal)
+
+| | |
+|---|---|
+| **Liên quan** | SCR-04 · C07, C08, C09 |
+| **Vai trò** | ROLE-02 |
+
+```
+Given  CartItem X tồn tại trong nhóm seller "Shop A" (nhóm đang có 2 CartItem)
+When   tôi bấm "Xoá" (C07) trên CartItem X, modal xác nhận hiện ra (theo UICONV §5), tôi bấm
+       nút xác nhận trong modal
+Then   hệ thống gọi DELETE /v1/cart/items/{X}, nhận 200/204
+ And   dòng CartItem X biến mất khỏi danh sách; tạm tính nhóm "Shop A" (C08) cập nhật (còn
+       1 CartItem); tổng cộng (C09) cập nhật
+```
+
+#### AC-US003-04 — Xoá CartItem cuối cùng của một nhóm seller
+
+```
+Given  nhóm seller "Shop B" chỉ có 1 CartItem
+When   tôi xoá CartItem đó (đã xác nhận modal)
+Then   toàn bộ khối nhóm "Shop B" (C02 + dòng CartItem) biến mất khỏi màn hình — không hiển
+       thị một nhóm rỗng không có dòng nào
+```
+
+#### AC-US003-05 — Xoá CartItem cuối cùng của toàn giỏ hàng
+
+```
+Given  giỏ hàng chỉ còn duy nhất 1 CartItem (1 nhóm, 1 dòng)
+When   tôi xoá CartItem đó (đã xác nhận modal)
+Then   màn hình chuyển sang trạng thái "Giỏ hàng trống" (theo SRS §2.A.3.6); nút
+       "Tiến hành Checkout" (C11) ẩn/disable
+ And   Cart.status vẫn là active (KHÔNG tự chuyển abandoned — theo BR §3, chỉ hết hạn phiên
+       mới chuyển abandoned)
+```
+
+#### AC-US003-06 — Huỷ modal xác nhận xoá
+
+```
+Given  modal xác nhận xoá CartItem X đang mở
+When   tôi bấm nút huỷ hoặc đóng modal (không xác nhận)
+Then   CartItem X vẫn còn nguyên trong danh sách; không có request DELETE nào được gửi
+```
+
+---
+
+### Nhóm 2 — Validation
+
+#### AC-US003-07 — Nhập số lượng không phải số nguyên dương hợp lệ
+
+| | |
+|---|---|
+| **Liên quan** | SCR-04 · F01 |
+| **Vai trò** | ROLE-02 |
+
+```
+Given  CartItem X có quantity=2
+When   tôi nhập trực tiếp vào F01 giá trị không hợp lệ (VD "-1", "1.5", "abc", để trống)
+Then   hệ thống hiện lỗi inline dưới F01: "Số lượng phải là số nguyên từ 1 trở lên."
+       (E-CART-0002)
+ And   không gửi request PATCH; F01 giữ nguyên giá trị hợp lệ trước đó (không lưu giá trị lỗi)
+```
+
+#### AC-US003-08 — Giảm số lượng về 0 *(🔴 chưa viết được đầy đủ — chờ `OQ-028`)*
+
+```
+Given  CartItem X có quantity=1 (đã ở mức tối thiểu)
+When   tôi bấm nút "-" hoặc nhập trực tiếp "0" vào F01
+Then   🔴 CHƯA XÁC ĐỊNH — phụ thuộc OQ-028 (PO chưa chốt: (a) chặn nút "-"/nhập 0, hiện
+       thông báo giữ tối thiểu 1, hay (b) tự động mở modal xác nhận xoá dòng)
+```
+
+*QA không viết test case cho AC này cho tới khi `OQ-028` được trả lời — đây là chỗ SRS chưa
+viết xong, không phải QA bỏ sót.*
+
+---
+
+### Nhóm 3 — Lỗi hệ thống
+
+#### AC-US003-09 — Server lỗi 5xx khi cập nhật số lượng
+
+| | |
+|---|---|
+| **Liên quan** | SCR-04 · F01 |
+| **Vai trò** | ROLE-02 |
+
+```
+Given  CartItem X có quantity=2
+When   tôi đổi thành 5 (bấm "+" 3 lần hoặc nhập tay) và PATCH /v1/cart/items/{X} trả 500
+Then   hệ thống hiện banner lỗi tại dòng CartItem: "Không thể cập nhật giỏ hàng, thử lại."
+       (E-CART-0006)
+ And   🔴 F01 trở về giá trị trước đó (2), KHÔNG giữ giá trị đã nhập lỗi (5); nút +/- mở lại
+       được bấm ngay
+```
+
+#### AC-US003-10 — Timeout khi xoá CartItem
+
+```
+Given  tôi bấm "Xoá" trên CartItem X (đã xác nhận modal)
+When   request DELETE bị timeout theo ngưỡng NFR §1 (xem OQ-033)
+Then   hệ thống hiện banner lỗi tại dòng: "Không thể cập nhật giỏ hàng, thử lại." (E-CART-0006)
+ And   CartItem X vẫn hiển thị trong danh sách (không xoá khỏi giao diện khi chưa có xác nhận
+       từ server); nút "Xoá" bấm lại được
+```
+
+#### AC-US003-11 — CartItem đã bị xoá bởi thao tác khác (đồng thời, VD 2 tab)
+
+```
+Given  CartItem X đang hiển thị trên màn hình của tôi, nhưng đã bị xoá khỏi giỏ hàng ở một
+       tab/thiết bị khác trước đó
+When   tôi bấm sửa số lượng (F01) hoặc bấm "Xoá" (C07) trên CartItem X
+Then   PATCH/DELETE trả 404 ERR_NOT_FOUND hoặc 409 ERR_CONFLICT (xem API §4)
+ And   hệ thống hiện banner "Sản phẩm này đã được xoá khỏi giỏ hàng trước đó." (E-CART-0003),
+       sau đó ẩn dòng CartItem X khỏi danh sách và cập nhật lại C08/C09
+```
+
+Ba tình huống tối thiểu của nhóm này:
+
+| # | Tình huống | AC |
+|---|---|---|
+| 1 | Server trả 5xx | AC-US003-09 |
+| 2 | Timeout / mất mạng | AC-US003-10 |
+| 3 | Dữ liệu bị người khác sửa/xoá trong lúc mình đang mở | AC-US003-11 |
+
+---
+
+### Nhóm 4 — Phân quyền
+
+#### AC-US003-12 — Gọi thẳng API sửa/xoá CartItem không thuộc quyền sở hữu (Customer)
+
+| | |
+|---|---|
+| **Liên quan** | SCR-04 |
+| **Vai trò** | ROLE-02 |
+
+```
+Given  tôi đăng nhập ROLE-02 với customerId = A; CartItem Y thuộc Cart của customerId = B
+When   tôi gọi thẳng PATCH /v1/cart/items/{Y} với token của A
+Then   hệ thống trả 403 ERR_FORBIDDEN_OWNERSHIP (E-CART-0005), không cập nhật CartItem Y
+ And   không có thông tin nào của CartItem Y bị lộ ra trong response lỗi
+```
+
+#### AC-US003-13 — Guest cố sửa/xoá CartItem không thuộc session của mình *(🔴 chưa viết được đầy đủ — chờ `OQ-032`)*
+
+```
+Given  tương tự AC-US003-12 nhưng với ROLE-01 (Guest): X-Guest-Session-Id = S1 của tôi,
+       CartItem Z thuộc Cart của session S2
+When   tôi gọi thẳng PATCH /v1/cart/items/{Z} với X-Guest-Session-Id: S1
+Then   🔴 CHƯA XÁC ĐỊNH — đề xuất BA: trả 403 ERR_FORBIDDEN_OWNERSHIP (E-CART-0005) giống hệt
+       AC-US003-12, cần Tech Lead xác nhận cơ chế đối chiếu session_id (OQ-032) trước khi coi
+       AC này là chốt
+```
+
+🔴 Chặn ở giao diện là trải nghiệm, **chặn ở backend mới là bảo mật**. Cả hai AC nhóm này đều
+kiểm tra gọi thẳng API, không chỉ kiểm tra ẩn nút trên giao diện.
+
+---
+
+## 3. Bảng dữ liệu biên
+
+| Field | Dưới ngưỡng | Ngưỡng dưới | Trong khoảng | Ngưỡng trên | Trên ngưỡng | Rỗng | Ký tự đặc biệt | Khoảng trắng đầu/cuối |
+|---|---|---|---|---|---|---|---|---|
+| F01 Số lượng (≥1, ngưỡng trên **chưa chốt** — `OQ-030`) | `0` → lỗi `E-CART-0002` (hành vi cụ thể — `OQ-028`) | `1` → OK | `5` → OK | 🔴 chưa có ngưỡng trên xác nhận — `OQ-030` | 🔴 chưa có ngưỡng trên — `OQ-030` | Xoá trắng ô nhập → lỗi bắt buộc (`E-CART-0002`) | `"abc"`, `"1.5"`, `"-1"` → lỗi `E-CART-0002` | N/A — F01 là input dạng số (`type=number`), không nhận khoảng trắng |
+
+---
+
+## 4. Kịch bản kết hợp
+
+| # | Kịch bản | Các bước | AC liên quan |
+|---|---|---|---|
+| S1 | Sửa số lượng rồi xoá hết một nhóm seller | SCR-04 (mở) → sửa số lượng CartItem của "Shop B" (tổng cập nhật) → xoá cả 2 CartItem còn lại của "Shop B" → nhóm "Shop B" biến mất, tổng cộng chỉ còn của "Shop A" | AC-US003-01, 03, 04 |
+
+---
+
+## 5. Truy vết
+
+| AC | US | BR | Field/Thành phần | Mã lỗi | Test case (QA điền) | Kết quả (QA điền) |
+|---|---|---|---|---|---|---|
+| AC-US003-01 | US-003 | BR §3 CART | F01, C08, C09 | — | | |
+| AC-US003-02 | US-003 | BR §3 CART | F01, C08, C09 | — | | |
+| AC-US003-03 | US-003 | BR §3 CART | C07, C08, C09 | — | | |
+| AC-US003-04 | US-003 | — | C02, C07 | — | | |
+| AC-US003-05 | US-003 | BR §3 CART | C07, C10, C11 | — | | |
+| AC-US003-06 | US-003 | — | C07 | — | | |
+| AC-US003-07 | US-003 | — | F01 | E-CART-0002 | | |
+| AC-US003-08 | US-003 | — | F01 | E-CART-0002 (dự kiến) | *(chờ OQ-028)* | |
+| AC-US003-09 | US-003 | — | F01 | E-CART-0006 | | |
+| AC-US003-10 | US-003 | — | C07 | E-CART-0006 | | |
+| AC-US003-11 | US-003 | — | F01, C07 | E-CART-0003 | | |
+| AC-US003-12 | US-003 | RBAC §6 | — | E-CART-0005 | | |
+| AC-US003-13 | US-003 | RBAC §6 | — | E-CART-0005 (dự kiến) | *(chờ OQ-032)* | |
+
+---
+
+## 6. Xác nhận của QA
+
+| | |
+|---|---|
+| **Người xác nhận** | *(chưa có — chưa có QA thật tham gia lần chạy này)* |
+| **Ngày** | — |
+| ☐ Mọi AC đều test được (2 AC còn mở, chờ OQ trước khi viết test case) | |
+| ☐ Đủ 4 nhóm | |
+| ☐ Bảng dữ liệu biên đủ dùng để viết test case | |
+| ☐ Không có AC nào mâu thuẫn với AC khác | |
+
+**AC bị QA từ chối:**
+
+| AC | Lý do từ chối | BA sửa thế nào |
+|---|---|---|
+| | | |