​
Bug Report — Báo cáo Bug

Tạo bug report có cấu trúc chuẩn, giúp dev hiểu và fix nhanh hơn.

​
Cú pháp

/bug-report

​
Cấu trúc Bug Report

1

Tiêu đề

Mô tả ngắn gọn bug. Ví dụ: “API trả về 500 khi tạo trang mới”
2

Môi trường

  • URL: staging/production
  • Browser / Device
  • Account test
3

Steps to Reproduce

Các bước cụ thể để tái hiện bug:
  1. Truy cập trang X
  2. Click nút Y
  3. Nhập dữ liệu Z
  4. Click Submit
4

Expected Result

Kết quả mong đợi (theo PRD/AC).
5

Actual Result

Kết quả thật tế (bug). Đính kèm: screenshot, error log, API response.

​
Output mẫu

## Bug Report: API trả về 500 khi tạo trang mới

**Severity:** High
**Environment:** Staging (https://staging.site.com)
**Browser:** Chrome 124 / macOS

### Steps to Reproduce
1. Đăng nhập tại https://staging.site.com/login
2. Vào Site Editor → Page Manager
3. Click "Add Page"
4. Nhập title: "Test Page"
5. Click "Save"

### Expected Result
Trang mới được tạo thành công, hiển thị trong danh sách.

### Actual Result
API trả về HTTP 500 Internal Server Error.
Error message: "field invalid: Site"

### Evidence
- API Response: POST /api/sites/2/pages → 500
- Server Log: TypeError: Cannot read property 'id' of null
- Screenshot: [đính kèm]

### Notes
- Chỉ xảy ra với sites chưa có trang nào
- Sites đã có trang thì add được bình thường

​
Mức độ nghiêm trọng (Severity)

SeverityĐịnh nghĩaVí dụ
CriticalApp crash, mất dữ liệu, bảo mậtPayment bị trùng, data leak
HighChức năng chính không hoạt độngKhông tạo được trang mới
MediumChức năng phụ bị lỗiSort không đúng thứ tự
LowUI/UX nhỏ, không ảnh hưởng chức năngButton bị lệch 2px

​
Liên kết với QA

Khi QA dùng /qa-full:verify-issue, bug report được tự động tạo và comment lên GitHub issue với format tương tự. 
# QA verify và tự động tạo bug report:
/qa-full:verify-issue #66