@educa-corp/sdd-framework 0.9.6 → 0.9.8

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

@@ -1,47 +0,0 @@
----
-version: 1.0
-updated: 2026-06-11
-ported_from: ui-automation-testing
----
-
-# Gen Script — Integration
-
-Skill **tự chứa**: convert `.Test.md` tích hợp (API↔DB↔service↔queue↔UI) → Python pytest. Chỉ cần load file này.
-
-## Khi nào trigger
-- Convert TC integration (output qa-designer integration/*) sang script; TC đã Reviewed
-
-## Khi KHÔNG trigger
-- Chỉ 1 endpoint/UI đơn → `functional/*` · hành trình đầu-cuối → `e2e.md`
-
-## Quy ước script (bám CLAUDE.md)
-- Tiền đề: `.Test.md` đã Reviewed. KHÔNG hardcode endpoint/DSN/topic → `Env.*`/`CONFIG`.
-- Mỗi hệ thống có client/helper riêng (API client, DB session, Kafka producer/consumer) gói trong fixture.
-- Verify đúng chặng: response (assert), DB (query qua fixture), event (consume + assert payload).
-- **Cleanup bắt buộc** sau khi tạo data; test độc lập; concurrency dùng thread/async khi cần.
-- Bọc mỗi chặng `with step("…")` (`from utils.steps import step`, **KHÔNG Allure**); assertion `expect()`; marker `@pytest.mark.integration` + domain; naming `TestFeatureIntegration` / `test_TC<NNN>_<snake>`.
-
-## Phase 1 — Clarify
-Đọc `.Test.md` · chuỗi tích hợp & chặng cần verify · client/fixture (API/DB/Kafka) đã có chưa · setup/teardown data.
-
-## Phase 2 — Generate
-Mỗi TC → 1 test theo data flow: gọi action → verify từng chặng (response/DB/event). Nhóm happy/contract-negative/failure-retry/concurrency/đồng bộ.
-
-## Phase 3 — Verify
-`py_compile` + `pytest --collect-only -q` · chạy (cần môi trường staging/CRM/Kafka) · cập nhật Status TC.
-
-## Output
-Script `tests/<project>/integration/test_<feature>.py` + client/fixture (DB/Kafka/API) nếu mới. Bàn giao `qa-reviewer`.
-
-## Phase 4 — Report (bắt buộc sau khi chạy test)
-Report = **Playwright Trace viewer + pytest-html** (KHÔNG Allure, KHÔNG dashboard tự viết).
-
-1. Chạy test kèm pytest-html (trace đã bật sẵn ở conftest → mỗi test có `test-results/<nodeid>/trace.zip`):
-   ```bash
-   pytest tests/<project>/integration/test_<feature>.py --html=reports/<feature>/report.html --self-contained-html
-   ```
-2. Gửi cho người dùng:
-   - HTML report: `reports/<feature>/report.html` (self-contained, mở trực tiếp).
-   - Trace từng test (debug step-by-step): `python3 -m playwright show-trace test-results/<nodeid>/trace.zip`.
-   - Tóm tắt: **TOTAL / PASS / FAIL / SKIP** + duration.
-3. TC Fail → mở trace tương ứng để xem timeline/DOM snapshot/network, phân loại theo **3 nhãn** (`script-bug` · `product-gap` · `flaky`) — luật đầy đủ + bước chạy lại ×2 ở `/qc-run-test` §Chạy lại trước khi kết luận, **không chép lại ở đây**; ghi mô tả lỗi tiếng Việt dễ hiểu vào Status/khối kết quả của `.Test.md`.

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

@@ -1,49 +0,0 @@
----
-version: 1.0
-updated: 2026-06-11
-ported_from: ui-automation-testing
----
-
-# Gen Script — Non-Functional
-
-Skill **tự chứa**: convert TC non-functional (performance/security/accessibility/compatibility) → script/đo. Chỉ cần load file này.
-
-## Khi nào trigger
-- Convert TC non-functional (output qa-designer non-functional) sang script/kịch bản đo; TC đã Reviewed
-
-## Khi KHÔNG trigger
-- Kiểm thử chức năng → `functional/*` · tích hợp → `integration.md`
-
-## Quy ước script (bám CLAUDE.md)
-- Tiền đề: `.Test.md` đã Reviewed, có **ngưỡng đo cụ thể**. KHÔNG hardcode → `Env.*`/`CONFIG`.
-- Mỗi loại dùng công cụ phù hợp, gói trong fixture/helper:
-  - **Performance:** đo response time / throughput (pytest + timer, hoặc tích hợp k6/locust); assert ngưỡng.
-  - **Security:** test authZ (role không quyền → 403), input injection, PII không lộ, session/timeout, rate limit.
-  - **Accessibility:** axe-core/lighthouse qua Playwright; assert vi phạm = 0 ở mức WCAG mục tiêu.
-  - **Compatibility:** parametrize trình duyệt/thiết bị.
-- Assert theo **ngưỡng pass** trong TC bằng `expect()`/`assert`; bọc bước `with step("…")` (`from utils.steps import step`, **KHÔNG Allure**); marker `@pytest.mark.{performance,security,accessibility}`.
-
-## Phase 1 — Clarify
-Đọc `.Test.md` · loại + ngưỡng + công cụ · môi trường/tải mẫu · data đặc biệt.
-
-## Phase 2 — Generate
-Mỗi TC → 1 test đo + assert ngưỡng; đánh dấu test cần môi trường/tải riêng (`@pytest.mark.slow`).
-
-## Phase 3 — Verify
-`py_compile` + collect · chạy (môi trường phù hợp) · cập nhật Status TC + số đo thực tế.
-
-## Output
-Script `tests/<project>/non_functional/test_<feature>.py` + helper đo/scan. Bàn giao `qa-reviewer`.
-
-## Phase 4 — Report (bắt buộc sau khi chạy test)
-Report = **Playwright Trace viewer + pytest-html** (KHÔNG Allure, KHÔNG dashboard tự viết).
-
-1. Chạy test kèm pytest-html (trace đã bật sẵn ở conftest → mỗi test có `test-results/<nodeid>/trace.zip`):
-   ```bash
-   pytest tests/<project>/non_functional/test_<feature>.py --html=reports/<feature>/report.html --self-contained-html
-   ```
-2. Gửi cho người dùng:
-   - HTML report: `reports/<feature>/report.html` (self-contained, mở trực tiếp) + số đo thực tế.
-   - Trace từng test (debug step-by-step): `python3 -m playwright show-trace test-results/<nodeid>/trace.zip`.
-   - Tóm tắt: **TOTAL / PASS / FAIL / SKIP** + duration.
-3. TC Fail → mở trace tương ứng để xem timeline/DOM snapshot/network, phân loại theo **3 nhãn** (`script-bug` · `product-gap` · `flaky`) — luật đầy đủ + bước chạy lại ×2 ở `/qc-run-test` §Chạy lại trước khi kết luận, **không chép lại ở đây**; ghi mô tả lỗi tiếng Việt dễ hiểu + số đo vào Status/khối kết quả của `.Test.md`.

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

@@ -1,37 +0,0 @@
----
-version: 1.1
-updated: 2026-06-11
-ported_from: ui-automation-testing
----
-
-# Report — Playwright Trace + pytest-html (stack chuẩn)
-
-Skill **tự chứa**: sinh report sau khi chạy test. Stack chuẩn dự án dùng **Playwright
-Trace viewer** + **pytest-html** (KHÔNG Allure, KHÔNG dashboard tự viết). Chỉ cần load file này.
-
-## Khi nào trigger
-- Sau khi chạy test cần xuất report / xem lại bằng chứng (trace, screenshot).
-
-## Cơ chế (đã dựng sẵn ở tests/conftest.py)
-- **Trace viewer**: fixture `context` (root conftest) gọi `context.tracing.start(screenshots=True, snapshots=True, sources=True)`; teardown lưu `test-results/<nodeid>/trace.zip`.
-  - Xem: `python3 -m playwright show-trace test-results/<...>/trace.zip` → timeline + DOM snapshot + network + console (UI giống Playwright report bản JS).
-- **pytest-html**: 1 file HTML self-contained. Hook `pytest_runtest_makereport` (root conftest) đính screenshot full-page khi FAIL/SKIP.
-  - Mặc định `reports/report.html` (pytest.ini). Theo feature: `--html=reports/<feature>/report.html --self-contained-html`.
-
-## Quy trình
-1. Chạy test với report theo feature:
-   ```
-   python3 -m pytest tests/<project>/<file>.py \
-       --html=reports/<feature>/report.html --self-contained-html
-   ```
-   (Trace tự bật trong conftest → test-results/<nodeid>/trace.zip cho mọi test.)
-2. Báo path:
-   - HTML: `reports/<feature>/report.html` (on WSL, the Windows-accessible path is `\\wsl.localhost\<distro>\<repo-path>\reports\<feature>\report.html`).
-   - Trace TC fail: `test-results/<nodeid>/trace.zip` + lệnh `playwright show-trace`.
-   - Tóm tắt TOTAL / PASS / FAIL / SKIP + duration.
-
-## Nguyên tắc
-- KHÔNG dùng Allure, KHÔNG sinh dashboard HTML tự viết (đã bỏ utils/html_report.py & cộng sự).
-- Evidence trung thực: trace + screenshot phản ánh đúng lần run; FAIL/gap giữ nguyên.
-- `reports/` và `test-results/` đã gitignore (artifact nặng) — không commit.
-- Interpreter `python3`; browser = the system/installed Chromium configured via `browser_type_launch_args` in the root conftest (see the qc-playwright module) — do not hard-code a binary path.