QC Workspace

Workspace

All Projects

A clear view of quality across your products.

Add test case

Import checklist

Markdown columns: STT | Feature | Test Case | Steps | Expected Result | Priority. Separate steps with “ / ”.

Bắt đầu nhanh

Hướng dẫn sử dụng QC Workspace

1

Chọn dự án và build

Chọn dự án ở thanh bên trái, sau đó mở một build có sẵn hoặc tạo build mới.

2

Chọn sheet

Mở checklist như Smoke hoặc Regression, hoặc tạo sheet mới cho một phạm vi kiểm thử khác.

3

Tạo checklist

Mở + New để thêm một test case hoặc import JSON/Markdown do AI tạo. Luôn kiểm tra phần xem trước trước khi import.

4

Ghi nhận lần kiểm thử

Test? cho biết mục này đã được thực hiện chưa. Status lưu Not Tested, In Progress, Pass, Fail hoặc Warning. Dùng Run tests để chạy lần lượt từng bước.

5

Đính kèm thông tin

Mở menu ••• của từng bước để lưu ghi chú, link bằng chứng, link bug và xem lại lịch sử chạy.

6

Theo dõi và báo cáo

Dùng tìm kiếm và bộ lọc để thu gọn checklist. Attention tập hợp các mục Fail/Warning; trang tổng quan hiển thị tiến độ của dự án.

⌁

Tự động hóa với AI

Đẩy checklist và kết quả bằng Claude Code / Codex

API key xác định đúng dự án; AI không cần đăng nhập vào website và không cần gửi project_id.

  1. Lấy API key của dự án

    Chỉ admin thực hiện được. Khi tạo dự án, hãy sao chép key trong cửa sổ hiện ra. Với dự án đã có, nhấn biểu tượng chìa khóa bên cạnh tên dự án để tạo key mới. Key chỉ hiển thị một lần và key cũ sẽ ngừng hoạt động ngay.

  2. Đưa key cho Claude Code / Codex một cách an toàn

    Lưu key trong file .env.local của repo và thêm file này vào .gitignore. Không lưu key trong GDD, checklist, CLAUDE.md, AGENTS.md hoặc commit lên Git.

    QA_DASHBOARD_URL=https://qa-dashboard-c4j.pages.dev
QA_DASHBOARD_KEY=qa_live_...
  3. Yêu cầu AI tạo và đẩy checklist

    Dùng prompt mẫu: “Đọc GDD và source code, tạo checklist tiếng Việt cho build 1.43.0, sheet Smoke, rồi đẩy lên QC Workspace bằng QA_DASHBOARD_KEY. Mỗi test case có các bước kiểm tra riêng. Không hiển thị hoặc ghi key vào file.”

    POST /api/testcases

  4. Yêu cầu AI ghi kết quả kiểm thử

    Dùng prompt mẫu: “Đọc checklist của build 1.43.0, sheet Smoke từ QC Workspace, chạy các test phù hợp rồi cập nhật kết quả theo đúng ID. Test có bước con thì cập nhật từng bước; test không có bước con thì cập nhật test case. Gửi theo batch và tóm tắt Pass/Fail.”

    GET /api/testcases → POST /api/step-results hoặc POST /api/results

Lưu ý: Hãy cung cấp rõ tên build và sheet. Nếu bỏ tên sheet khi đẩy checklist bằng API, hệ thống sẽ tự tạo một sheet mới tên “Import …” để tránh trộn dữ liệu.
Mẹo: Khi GDD thay đổi, hãy yêu cầu AI chỉ cập nhật các test bị ảnh hưởng và đẩy chúng vào đúng build/sheet.