doc-itb-implement

name	doc-itb-implement
description	Workflow tạo tài liệu Test Case ITb (Scenario Integration). Sử dụng khi cần định nghĩa kịch bản kiểm thử luồng nghiệp vụ xuyên suốt qua nhiều màn hình và role. Trigger phrases: tạo test case itb, viết test case luồng, doc itb.
argument-hint	Tên luồng nghiệp vụ hoặc danh sách file thiết kế liên quan

Skill: doc-itb-implement

Mục đích

Tạo tài liệu Test Case ITb (Scenario Integration) dựa trên các tài liệu thiết kế FE (Screen) và BE (API). Tài liệu này dùng để định nghĩa các kịch bản kiểm thử luồng nghiệp vụ xuyên suốt qua nhiều màn hình và nhiều vai trò (Role), kèm theo Test Data và Flow Data cụ thể.

Khi nào sử dụng

• Khi user yêu cầu tạo test case ITb cho một luồng nghiệp vụ (VD: Luồng xuất bản bài viết, Luồng đăng ký và đăng nhập).
• Khi user gõ lệnh /doc-itb-implement.

Hướng dẫn thực hiện (Workflow - 5 Phases)

Để tránh timeout và đảm bảo kịch bản luồng đạt chuẩn Enterprise, AI PHẢI thực hiện theo 5 Phase sau. Dừng lại và hỏi ý kiến user sau mỗi Phase.

Phase 1: Phân tích Workflow & Chuẩn bị

• BẮT BUỘC: Đọc tài liệu [Design][WORKFLOW] tương ứng của luồng nghiệp vụ này (tại demo_docs/workflow/). Không tự suy luận luồng từ FE/BE docs.
• Đọc TEMPLATE_ITb.md, VIEWPOINT_ITb.md.
• Đọc tài liệu demo_docs/[Design][DB] DATABASE_Schema.md để nắm chính xác cấu trúc DB, phục vụ cho việc lập DB Confirmation Matrix ở bước sau.
• Review lại sơ đồ Mermaid sequenceDiagram từ file Workflow để xác định các Actor, Nodes (Screen/API).
• Dừng lại và yêu cầu user xác nhận đã hiểu đúng Workflow.

Phase 2: Lập Ma trận Dữ liệu (DB Confirmation Matrix) & Setup Data

• Viết câu lệnh SQL Setup Data (DELETE/INSERT).
• Lập bảng DB Confirmation Matrix mapping Step -> Table -> Column -> Expected Value -> SQL Verify.
• Dừng lại và yêu cầu user xác nhận ma trận dữ liệu.

Phase 3: Lập Checklist (ITb Checklist)

• Dựa vào 9 Pattern Taxonomy (HP, ALT, IDEM, PIPE-INT, PRE-MISS, DEL-CASC, STATE-VIO, CONC, ISO), lập bảng ITb Checklist tóm tắt các TC sẽ viết.
• Đảm bảo tuân thủ Anti-pattern: Mọi TC phải đi qua >= 2 nodes.
• Dừng lại và yêu cầu user xác nhận checklist.

Phase 4: Viết Kịch bản Chi tiết (Happy Path & Alternative)

• Viết bảng TC Detail cho các pattern HP và ALT.
• Step và Expected Result phải đánh số tương ứng (1-1).
• Dừng lại và hỏi user có muốn viết tiếp các TC Error không.

Phase 5: Viết Kịch bản Chi tiết (Error & Edge Cases) & Hoàn thiện file

• Viết bảng TC Detail cho các pattern còn lại (IDEM, PIPE-INT, PRE-MISS, DEL-CASC, STATE-VIO, CONC, ISO).
• Tổng hợp toàn bộ nội dung từ Phase 1 đến Phase 5 thành 1 file hoàn chỉnh.
• Lưu file vào demo_docs/tests/ITb/[Test][ITb] TC_{TênLuồng}.md.
• Cập nhật PROJECT_MANIFEST.yml để thêm đường dẫn file test case vừa tạo vào section test_cases.itb của feature tương ứng (hoặc tạo một feature group mới cho luồng).

Yêu cầu đầu ra

• File Markdown tuân thủ 100% cấu trúc của TEMPLATE_ITb.md.
• Dữ liệu SQL phải hợp lệ với PostgreSQL.
• Các bước phải logic, không bị đứt gãy dữ liệu.

---

📝 Ghi Log Bắt Buộc

Sau khi hoàn thành skill này, PHẢI ghi log vào reports/AGENT_EXECUTION_LOG.md trước khi báo cáo kết quả.

Dùng template sau (copy và điền vào):

### [YYYY-MM-DD HH:mm:ss] - {be-agent | fe-agent | test-agent | playwright-agent | docs-agent}
- **Task**: {Mô tả ngắn gọn việc vừa làm}
- **Skill Used**: {tên skill này}
- **Target Feature**: {key trong PROJECT_MANIFEST.yml, ví dụ: auth_login}
- **Files Processed**:
  - `path/to/file` [Modified]
  - `path/to/file` [Verified/Unchanged]
- **Status**: SUCCESS | FAILED | PARTIAL
- **Notes**: {Ghi chú: findings, residual risks, việc chưa làm}

⚠️ Nếu bị interrupt, ghi Status: PARTIAL và ghi rõ đã làm đến bước nào. ⚠️ Sau khi ghi log, cập nhật cycle_checkpoint trong PROJECT_MANIFEST.yml.