qa-report

name	QA Report
description	Protocol สำหรับ QA รายงานผล Test กลับมาใน PMO Repo — AI บันทึกผล Test ตาม Test Cases ใน TaskBoard, อัพเดท Traceability Matrix and Card status — ใช้เมื่อ QA บอกว่า "test เสร็จแล้ว", "ผล test Module X", "Module X ผ่าน/ไม่ผ่าน", หรือต้องการบันทึกผล test ครอบคลุม Step 24-28 ของ PMO Collaboration Workflow (WF-C)

PMO Skill: QA Test Report Protocol

Related Skills:

• Load pmo-taskboard เพื่ออัพเดท Card status + test results
• Load pmo-traceability เพื่อ log activity + update Traceability Matrix
• Load references/qa-report-format.md for report format

---

Purpose

Skill นี้กำหนด protocol ที่ QA ใช้รายงานผล test กลับมาใน PMO Repo ผ่าน Claude AI

ปัญหาที่ skill นี้แก้:

• QA test เสร็จแล้วไม่รู้จะรายงานอะไรบ้าง format ไหน
• PM ไม่เห็นผล test ละเอียด (แค่ "ผ่าน/ไม่ผ่าน" ไม่พอ)
• Bug ที่เจอไม่ถูก track กลับไปที่ Dev อย่างชัดเจน
• Traceability ขาด — ไม่รู้ว่า test ครอบคลุม case ไหนบ้าง

---

QA Setup (ก่อนเริ่ม Test)

QA ต้องเตรียม 2 VS Code Windows:

1. Window 1 — Dev Repo: Code ที่ Dev ทำเสร็จ (clone/pull branch ที่ Dev แจ้ง)
2. Window 2 — PMO Repo: ดู SystemFlow + TaskBoard + คุยกับ AI

QA ถาม AI ว่ามีงาน Test อะไร

เมื่อ QA ถาม AI ใน PMO Repo → AI ต้อง:

1. อ่าน TaskBoard.md → หา Card ที่ status = "QA Testing"
2. สรุป:
   • Module ที่ต้อง test
   • Dev Branch ที่ต้อง pull
   • Test Cases ทั้งหมด (Happy/Alt/Exception) พร้อมรายละเอียด
   • Dev notes (ถ้ามี)

---

QA Report Format

เมื่อ QA test เสร็จแล้ว → รายงานกลับ AI:

Required Information

#	Field	ตัวอย่าง	Required?
1	Module ที่ Test	Module 12 - Manage Pricing	Yes
2	Happy Case Results	4/4 Pass	Yes
3	Alternative Case Results	2/2 Pass	Yes
4	Exception Flow Results	2/3 Pass (E-003 Fail)	Yes
5	Bug Details (ถ้ามี Fail)	รายละเอียด bug แต่ละ case	Yes (ถ้ามี Fail)
6	Test Environment	Local / Staging / Production	Optional
7	Screenshots/Evidence	แนบ screenshot	Optional

QA Report Template (สำหรับ QA copy-paste)

Module: [ชื่อ Module]
Test Results:
- Happy: [x/y] Pass
- Alternative: [x/y] Pass
- Exception: [x/y] Pass
Failed Cases:
- [Case ID]: [อธิบาย bug]
Notes: [หมายเหตุ ถ้ามี]

---

AI Processing QA Report

เมื่อ QA ส่ง report → AI ทำ 3 ขั้นตอน:

Step 1: Validate Report Completeness

ตรวจอะไร	เงื่อนไข
Module ตรงกับ Card ที่ status = QA Testing	ชื่อ Module match
Test case ครบทุกประเภท	Happy + Alt + Exception
Failed cases มี detail	ทุก Fail case ต้องมีรายละเอียด bug

Step 2: Update TaskBoard

ถ้า Test ผ่านครบ 100%:

Update	Value
Card Status	"QA Passed"
Test Results	บันทึกผลทุก case (Pass)
QA Sign-off	QA name + date

ถ้ามี Test Fail:

Update	Value
Card Status	"Revision"
Failed Cases	บันทึก case ที่ Fail + bug detail
Revision Note	สรุปสิ่งที่ Dev ต้องแก้

Step 3: Update Traceability + Logs

1. Traceability Matrix → Change Log: "QA completed Module X — [Pass/Fail]"
2. Activity Log → "QA Report: Card #X — Happy x/x, Alt x/x, Exc x/x"
3. ถ้า Pass → แจ้ง PM: "Module X QA ผ่านแล้ว พร้อม Client Review"
4. ถ้า Fail → แจ้ง Dev: "Module X QA ไม่ผ่าน [X] cases — ดู Revision Note"

---

Bug Report Format (สำหรับ Failed Cases)

ทุก Failed case ต้องมีข้อมูลนี้:

Field	Description
Case ID	จาก Test Cases (เช่น E-003)
Severity	Critical / Major / Minor
Steps to Reproduce	ขั้นตอนที่ทำแล้วเกิด bug
Expected Result	ผลที่ควรจะเป็น (จาก Test Case)
Actual Result	ผลที่เกิดขึ้นจริง
Screenshot	แนบ screenshot (ถ้ามี)

Severity Guide

Severity	เงื่อนไข	ตัวอย่าง
Critical	Feature ใช้งานไม่ได้เลย / Data loss / Security issue	กดปุ่ม Save แล้ว crash, ข้อมูลหาย
Major	Feature ทำงานผิดปกติ แต่มี workaround	คำนวณราคาผิด, แสดงข้อมูลผิด field
Minor	UI/UX issue, Typo, ไม่กระทบ logic	ปุ่มไม่ตรงกลาง, ข้อความ typo

---

Retest Flow (เมื่อ Dev แก้แล้ว)

1. Dev แก้ bug → รายงานกลับผ่าน pmo-dev-report
2. AI อัพเดท Card status = "QA Testing" (รอบ 2)
3. QA test เฉพาะ case ที่ Fail + Regression test (ทดสอบว่า case ที่เคย Pass ยังผ่านอยู่)
4. รายงานผล retest ด้วย format เดิม + เพิ่ม "Retest Round: 2"

---

Do's and Don'ts

Do's

1. ให้ QA ดู Test Cases จาก TaskBoard ก่อนเริ่ม test ทุกครั้ง
2. บันทึก bug detail ทุก Failed case (ห้ามแค่ "Fail")
3. ทำ regression test ทุกรอบ retest
4. อัพเดท TaskBoard + Traceability + Activity Log พร้อมกัน

Don'ts

1. ห้าม mark Pass ถ้ายังไม่ได้ test จริง
2. ห้ามข้าม case ใดๆ (ต้อง test ครบทุก case)
3. ห้าม QA แก้ code เอง — ต้องส่งกลับ Dev เสมอ
4. ห้ามปิด Card ถ้ามี Failed case แม้แต่ 1 case