@educa-corp/sdd-framework 0.9.1 → 0.9.3

package/core/skills/qc/qa-planner/risk-model.md

@@ -0,0 +1,106 @@
+---
+version: 1.0
+updated: 2026-08-25
+ported_from: ui-automation-testing
+upstream_path: skills/qa-tc-analyst/risk-acceptance-analyzer.md
+upstream_sha: 5eca5091acd30e063d20b63f12b04e2d1c78ac83
+port_completeness: partial
+---
+
+# Risk Model — cách tính mức rủi ro và dùng nó để chia độ sâu test
+
+`test-plan.md` có **khung** bảng rủi ro (`§6`) nhưng không có **cách điền**. File này là cách điền.
+
+Nạp cùng `test-plan.md` khi lập plan. Đầu ra không phải file riêng — nó điền vào `§6 Rủi ro`
+và `§5 Tiêu chí Vào/Ra` của `TEST_PLAN.md`.
+
+## Cố ý chỉ port một phần
+
+Bản upstream (`risk-acceptance-analyzer`) có 5 phase. Ba phase bị **cố ý bỏ** vì trạm 1 đã làm rồi:
+
+| Phase upstream | Vì sao không port |
+|---|---|
+| Test Conditions | trùng vai với `qa-analyst/spec-breakdown` + `business-rules` (trạm 1) |
+| Ambiguity & Gap | trùng vai với `DOC_GAP` + `steps/gap-verify.md` (trạm 1) |
+| Acceptance Criteria | trùng vai với `qa-analyst/acceptance-criteria` (trạm 1) |
+
+Chỉ port **Phase 3 (Risk Register)** và **Phase 5 (Ưu tiên + Entry/Exit)** — hai phần trạm 2 sở hữu.
+
+*Ghi `port_completeness: partial` ở frontmatter — lần đồng bộ sau đừng hiểu phần thiếu là
+"ta cố ý xoá nội dung".*
+
+---
+
+## Bước 1 — Liệt kê rủi ro sản phẩm
+
+Bảy nguồn rủi ro. Quét từng cái, không bỏ nguồn nào chỉ vì "feature này chắc không có":
+
+| # | Nguồn | Dấu hiệu trong PRD/BR |
+|---|---|---|
+| 1 | **Logic phức tạp** | nhiều điều kiện AND/OR lồng nhau, bảng định tuyến, công thức tính |
+| 2 | **Tiền / thanh toán** | giao dịch, hoàn tiền, mã giảm giá, hạn mức |
+| 3 | **Dữ liệu nhạy cảm** | thông tin cá nhân, số điện thoại, thông tin định danh |
+| 4 | **Tích hợp nhiều phần** | gọi dịch vụ khác, hàng đợi sự kiện, đồng bộ dữ liệu |
+| 5 | **Code mới hoặc sửa nhiều** | feature xây mới, hoặc vùng vừa refactor |
+| 6 | **Lịch sử lỗi cao** | vùng đã từng có bug — tra `{paths.bug_reports_dir}` cho UC/feature này |
+| 7 | **Ảnh hưởng nhiều người dùng** | luồng chính mọi người đều đi qua, màn đăng nhập, trang chủ |
+
+> Nguồn 6 là nguồn duy nhất **tra được bằng dữ liệu thật** trong framework — sổ bug nằm ở
+> `{paths.bug_reports_dir}`. Đừng đoán "vùng này chắc ổn"; mở ra đếm.
+
+## Bước 2 — Chấm mức cho từng rủi ro
+
+Hai chiều, mỗi chiều ba mức:
+
+- **Khả năng xảy ra** — Cao / Trung bình / Thấp
+- **Mức thiệt hại nếu xảy ra** — Cao / Trung bình / Thấp
+
+Nhân lại ra **P0 → P3**:
+
+| Khả năng \ Thiệt hại | Cao | Trung bình | Thấp |
+|---|:---:|:---:|:---:|
+| **Cao** | **P0** | **P1** | P2 |
+| **Trung bình** | **P1** | P2 | P3 |
+| **Thấp** | P2 | P3 | P3 |
+
+> **Chấm hai chiều riêng rồi mới nhân** — đừng chấm thẳng ra P0/P1 theo cảm tính. Hai chiều
+> tách nhau là chỗ tranh luận trở nên cụ thể: *"cái này thiệt hại cao nhưng khả năng thấp"*
+> là một câu nói được, còn *"cái này P1"* thì không cãi được, chỉ tin hoặc không tin.
+
+## Bước 3 — Dùng mức rủi ro để chia **độ sâu** test
+
+Đây là chỗ bảng rủi ro trả lại giá trị. Không có bước này thì nó chỉ là một bảng trang trí.
+
+| Mức | Test sâu tới đâu | Tự động hoá |
+|---|---|---|
+| **P0** | nhiều kỹ thuật cùng lúc: phân lớp tương đương + giá trị biên + bảng quyết định + chuyển trạng thái | ✅ ưu tiên — cả kiểm thử hồi quy |
+| **P1** | hai kỹ thuật trở lên, phủ đủ nhánh chính + nhánh lỗi | ✅ nếu ổn định |
+| **P2** | một kỹ thuật, phủ luồng thuận + một nhánh lỗi tiêu biểu | tuỳ |
+| **P3** | danh sách kiểm tay, không cần test case đầy đủ | ❌ |
+
+**Thứ tự chạy:** rủi ro cao **và** phụ thuộc thấp làm trước — không phải "P0 làm hết rồi mới tới P1".
+Một P0 đang chờ gap chặn thì không chạy được; làm P1 sẵn sàng trước là đúng.
+
+**Tháp test:** end-to-end tự động **chỉ** cho luồng P0/P1 trọng yếu. E2E cho P2/P3 là đắt và giòn —
+tiền không đáng.
+
+## Bước 4 — Điền Entry / Exit theo rủi ro
+
+`test-plan.md §5` đã có khung. Rủi ro làm nó cụ thể hơn:
+
+- **Entry** — mọi gap 🔴 chặn đã `Answered`; **và** mọi rủi ro P0 đã có ít nhất một cách giảm thiểu ghi rõ.
+- **Exit** — phủ 100% vùng P0 · không còn defect mở ở vùng P0/P1 · tỉ lệ pass đạt ngưỡng đã khai.
+
+> **Rủi ro P0 không có cách giảm thiểu = chưa đủ điều kiện bắt đầu.** Ghi ra một rủi ro rồi
+> không nói làm gì với nó là ghi cho có.
+
+---
+
+## Điền vào `TEST_PLAN.md §6`
+
+| Rủi ro | Nguồn (1–7) | Khả năng | Thiệt hại | Mức | Giảm thiểu (loại test + kỹ thuật) |
+|---|---|---|---|---|---|
+| … | 2 · tiền | Cao | Cao | **P0** | functional/api + giá trị biên; e2e luồng thanh toán |
+
+Mỗi dòng rủi ro phải **trỏ được về BR-xx hoặc GAP-xx** đã có ở `REQUIREMENT_ANALYSIS.md` /
+`DOC_GAP.md` — rủi ro không neo vào yêu cầu nào là rủi ro tự nghĩ ra.

package/core/skills/qc/qa-planner/test-plan.md

@@ -1,24 +1,29 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
+upstream_path: skills/qa-tc-analyst/test-plan.md
+upstream_sha: f259b4d123c565a42ba6c6ec96980a8e4c66284f
 ---
 
 # Lập Test Plan
 
-Tổng hợp **output của qa-analyst** thành **Test Plan** cho một feature.
+Tổng hợp **output của qa-analyst** thành **Test Plan** cho một feature — tức **một plan cho cả
+(PRD × nền)**, các UC là các hàng bên trong.
 
 **Đầu vào (bắt buộc, chỉ 2 nguồn — đúng 2 file qa-analyst trả ra):**
-1. `{paths.qc_dir}/{UC-ID}/REQUIREMENT_ANALYSIS.md` — chức năng, BR-xx, AC-xx, data flow (qa-analyst).
-2. `{paths.qc_dir}/{UC-ID}/DOC_GAPS.md` — bảng gap GAP-xx, mức độ, gap Blocker (qa-analyst).
+1. `{qc_artifact_dir}REQUIREMENT_ANALYSIS.md` — chức năng, BR-xx, AC-xx, data flow của **mọi UC
+   trong phạm vi**, kèm mục *Mâu thuẫn chéo UC* (qa-analyst).
+2. `{qc_artifact_dir}DOC_GAP.md` — bảng gap 11 cột `GAP-UC{N}-{nnn}`, mức độ, gap Blocker, và
+   bảng *Phạm vi phân tích* (qa-analyst). **Lọc cột `UC`** khi cần phần của một UC cụ thể.
 
 ## Khi nào trigger
 - "lập test plan cho [Feature]" / "viết test plan"
-- Sau khi qa-analyst xong (đã có REQUIREMENT_ANALYSIS + DOC_GAPS)
+- Sau khi qa-analyst xong (đã có REQUIREMENT_ANALYSIS + DOC_GAP)
 - Trước khi qa-designer thiết kế chi tiết TC — test plan là khung định hướng
 
 ## Khi KHÔNG trigger
-- Chưa có REQUIREMENT_ANALYSIS / DOC_GAPS → chạy qa-analyst trước
+- Chưa có REQUIREMENT_ANALYSIS / DOC_GAP → chạy qa-analyst trước
 - Thiết kế test case chi tiết (.Test.md) → dùng qa-designer
 - Bóc tách yêu cầu/spec, lập danh sách gap → dùng qa-analyst
 
@@ -28,7 +33,7 @@ Tổng hợp **output của qa-analyst** thành **Test Plan** cho một feature.
 
 1. Đọc `REQUIREMENT_ANALYSIS.md`: nắm chức năng, các BR-xx và AC-xx, data flow,
    integration/failure point.
-2. Đọc `DOC_GAPS.md`: lấy danh sách gap, đặc biệt **gap Blocker còn Open** → đây là
+2. Đọc `DOC_GAP.md`: lấy danh sách gap, đặc biệt **gap Blocker còn Open** → đây là
    nguồn cho cột "Phụ thuộc" và cho Entry criteria.
 3. Map mỗi nhóm BR sang **layer test** của qa-designer: functional/gui-screen,
    gui-feature, api, integration, e2e/journey, non-functional.
@@ -47,38 +52,45 @@ Tổng hợp **output của qa-analyst** thành **Test Plan** cho một feature.
   criteria yêu cầu đóng các gap đó trước khi thiết kế TC.
 - Liệt kê **E2E journey** đầy đủ (mỗi journey: tiền điều kiện, kết quả/định tuyến kỳ
   vọng, BR, phụ thuộc, priority) + bộ **verify point chung** sau submit.
-- Mục Rủi ro: rút trực tiếp từ gap Blocker + các BR logic phức tạp.
+- Mục Rủi ro: **nạp `risk-model.md`** — quét đủ 7 nguồn, chấm khả năng × thiệt hại → P0–P3,
+  rồi dùng mức đó chia độ sâu test. Đừng chấm thẳng ra P0/P1 theo cảm tính.
 
 ---
 
 ## Output — Template `TEST_PLAN.md`
 
-Đặt tại `{paths.qc_dir}/{UC-ID}/TEST_PLAN.md`:
+Đặt tại `{qc_artifact_dir}TEST_PLAN.md`:
 
 ```markdown
-# Test Plan – <Feature>
+# Test Plan – <TICKET-ID> <Tên feature> / <nền>
 
 | Trường | Giá trị |
 |---|---|
-| Feature / Project / Module | … |
+| Feature / Project / Module | `<TICKET-ID>` — … |
+| Nền (platform) | `<web \| app \| system>` |
+| UC trong phạm vi | `<UC-ID>` · `<UC-ID>` … (`⏸ chưa xét`: `<UC-ID>`) |
 | Người lập | qa-planner |
 | Ngày / Phiên bản | … |
-| Nguồn | REQUIREMENT_ANALYSIS · DOC_GAPS |
+| Nguồn | REQUIREMENT_ANALYSIS · DOC_GAP |
 
 ## 1. Mục tiêu
 Mục tiêu test của feature (1–3 câu).
 
 ## 2. Phạm vi
-- **In scope:** chức năng/BR được test.
-- **Out of scope:** phần để tài liệu/feature khác; nội dung gạch ngang đã loại.
+- **In scope:** chức năng/BR được test, **theo từng UC** (`<UC-ID>`: …).
+- **Out of scope:** phần để tài liệu/feature khác; nội dung gạch ngang đã loại; và **UC
+  `⏸ Chưa xét`** (BDD chưa `approved`) — liệt kê rõ mã UC + lý do. *Không ghi ra thì một UC bị
+  bỏ trông giống một UC không có gì để test.*
 
 ## 3. Test items theo vùng & độ ưu tiên
 Bảng — mỗi vùng kèm rule chi tiết + metadata:
 
-| # | Vùng test | Rule chi tiết | Layer (qa-designer) | Loại test | Pri | Ước lượng |
-|---|---|---|---|---|---|---|
-| ① | <vùng> | **BR-xx:** … <br>**BR-yy:** … | functional/gui-screen | Functional/Negative | P0 | n |
-| … | … | … | … | … | … | … |
+| # | UC | Vùng test | Rule chi tiết | Layer (qa-designer) | Loại test | Pri | Ước lượng |
+|---|---|---|---|---|---|---|---|
+| ① | `<UC-ID>` | <vùng> | **BR-xx:** … <br>**BR-yy:** … | functional/gui-screen | Functional/Negative | P0 | n |
+| … | … | … | … | … | … | … | … |
+
+*Cột `UC` bắt buộc — một plan phủ nhiều UC, không có nó thì không ai biết vùng test nào của UC nào.*
 
 > Tổng ước lượng sơ bộ: ~N test case (+ E2E).
 
@@ -95,12 +107,14 @@ Kỹ thuật áp dụng: EP+BVA, Decision Table (cho logic điều kiện), stat
 integration, negative/exploratory; tự động hoá theo `CLAUDE.md` (Playwright + pytest-playwright + Trace + pytest-html).
 
 ## 5. Tiêu chí Vào / Ra
-- **Entry:** gap Blocker (trong DOC_GAPS) đã Answered; doc phụ thuộc sẵn sàng; môi trường + tài khoản role.
+- **Entry (chấm theo TỪNG UC, không chấm cả PRD):** gap 🔴 Blocker của **UC đó** (lọc cột `UC`
+  trong DOC_GAP) đã Answered; doc phụ thuộc sẵn sàng; môi trường + tài khoản role.
+  Ghi `Ready`/`Blocked` cho mỗi UC — blocker ở UC3 không dừng thiết kế test UC1.
 - **Exit:** pass P0=100%, P1≥95%; không còn defect Blocker/Critical; mọi BR/AC được trace; báo cáo pytest-html + Playwright Trace.
 
 ## 6. Rủi ro (risk-based)
-| Rủi ro | Ảnh hưởng | Mức | Giảm thiểu |
-(rút từ gap Blocker + BR logic phức tạp)
+| Rủi ro | Nguồn | Khả năng | Thiệt hại | Mức | Giảm thiểu |
+(cách chấm mức + 7 nguồn rủi ro + cách dùng mức để chia độ sâu test: xem `risk-model.md`)
 
 ## 7. Dữ liệu & Môi trường
 Tài khoản các role, dữ liệu mẫu (biên/edge), môi trường staging.

package/core/skills/qc/qa-reviewer/script/e2e.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Script — E2E Journey

package/core/skills/qc/qa-reviewer/script/exploratory.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Session Note — Exploratory

package/core/skills/qc/qa-reviewer/script/functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Script — Functional

package/core/skills/qc/qa-reviewer/script/integration.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Script — Integration

package/core/skills/qc/qa-reviewer/script/non-functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Script — Non-Functional

package/core/skills/qc/qa-reviewer/test-case/e2e.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Case — E2E Journey

package/core/skills/qc/qa-reviewer/test-case/exploratory.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Charter — Exploratory

package/core/skills/qc/qa-reviewer/test-case/functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Case — Functional

package/core/skills/qc/qa-reviewer/test-case/integration.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Case — Integration
@@ -21,7 +21,7 @@ Review bộ TC tích hợp (GUI↔Backend, API, DB) và đánh giá chất lư
 ## Phase 1 — Clarify
 
 1. Đọc tất cả TC integration trong folder chỉ định; xác định loại: GUI↔Backend / API / DB
-2. Đọc REQUIREMENT_ANALYSIS + DOC_GAPS nếu có
+2. Đọc REQUIREMENT_ANALYSIS + DOC_GAP nếu có
 3. Xác định chuỗi tích hợp (caller → component → downstream)
 
 ---

package/core/skills/qc/qa-reviewer/test-case/non-functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Case — Non-Functional

package/core/skills/qc/qa-runner/e2e.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Gen Script — E2E Journey

package/core/skills/qc/qa-runner/exploratory/session.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Session Template & Convert Findings — Exploratory
@@ -33,4 +33,4 @@ Input: session note (#BUG + #IDEA).
 - **Weekly summary** (nếu yêu cầu): overview, top findings, coverage gap, recommendations.
 
 ## Output
-Mode 1: file session note. Mode 2: bug reports + file TC trong `{paths.qc_dir}/{UC-ID}/test-cases/` + summary.
+Mode 1: file session note. Mode 2: bug reports + file TC trong `{qc_artifact_dir}test-cases/` + summary.

package/core/skills/qc/qa-runner/functional/api.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Gen Script — Functional API

package/core/skills/qc/qa-runner/functional/gui-feature.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Gen Script — Functional GUI Feature (đa màn hình)

package/core/skills/qc/qa-runner/functional/gui-screen.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Gen Script — Functional GUI Screen (1 màn hình)

package/core/skills/qc/qa-runner/integration.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Gen Script — Integration

package/core/skills/qc/qa-runner/non-functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Gen Script — Non-Functional

package/core/skills/qc/qa-runner/report/report.md

@@ -1,7 +1,7 @@
 ---
 version: 1.1
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Report — Playwright Trace + pytest-html (stack chuẩn)

package/core/steps/context-loader.md

@@ -35,7 +35,7 @@ Thực hiện các bước theo đúng thứ tự. Lưu mọi thứ vào bộ nh
 **Paths (nếu có):**
 - `paths.specs_dir` → gốc của spec artifact — PRD, BDD, tech-docs, design-spec. Cấu trúc: `{specs_dir}/{domain}/{prd-slug}/{ {TICKET-ID}-{prd-slug}.md | bdd/ | tech-docs/ | design-spec/}` (file PRD đặt tên `{TICKET-ID}-{prd-slug}.md`, là file `.md` duy nhất ở gốc feature folder)
 - `paths.refinement_dir` → thư mục output cho findings/review
-- `paths.qc_dir` → gốc artifact QC automation (hiện ở top-level, mỗi UC một thư mục con: `{qc_dir}/{UC-ID}/`)
+- `paths.qc_dir` → gốc artifact QC automation (ở top-level, gom theo **PRD**: `{qc_dir}/{TICKET-ID}/{platform}/` — một `DOC_GAP.md` / `TEST_PLAN.md` / `REQUIREMENT_ANALYSIS.md` cho cả PRD, các UC là mục bên trong. Xem `steps/qc-scope.md`)
 - `paths.qc_skills_dir` → nơi các lệnh qc-* nạp QC skill (mặc định bundled `.agent/skills/qc`; override sang repo/submodule riêng của team QC để bản nâng cấp framework không ghi đè)
 - `paths.product_definitions_dir` → gốc product definition
 - `paths.domain_knowledge_dir` → gốc domain knowledge