Mẫu bug report để Dev không phải hỏi lại

Copy mẫu dưới vào Jira hoặc tải file .md. Giải thích và ví dụ trước/sau trong bài "Viết bug report để Dev không phải hỏi lại".

Công thức tiêu đề

[Loại lỗi] Nơi + hành vi sai + điều kiện

Ví dụ: [FUNC] Chart Giá vàng không cập nhật khi đổi kỳ từ 1Y sang 5Y

Mẫu 1 lỗi

**Tiêu đề:** [<UI | API | DATA | FUNC>] <nơi> <hành vi sai> khi <điều kiện>
**Môi trường:** <staging/prod>, build <...>, <trình duyệt>, <độ rộng>, tài khoản <...>
**Điều kiện trước:** <...>

**Các bước:**
1. <...>
2. <...>

**Thực tế:** <...>
**Mong đợi:** <...> (nguồn: AC #<n> / Figma <link> / API doc <mục>)
**Bằng chứng:** <ảnh, GIF, curl, log>
**Severity:** <Critical/Major/Minor> — <lý do ngắn>

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

Mức	Khi nào
Critical	Sập, mất dữ liệu, lỗi bảo mật, chặn luồng chính và không có cách tránh
Major	Sai chức năng hoặc sai số liệu quan trọng, có cách tránh
Minor	Sai nhỏ, ít ảnh hưởng người dùng: lệch giao diện, câu chữ

Severity do QA đánh giá (lỗi nặng tới đâu). Priority (cần sửa gấp tới đâu) thường do PO/PM quyết định.

Mẫu bug tổng hợp nhiều lỗi cùng loại

[UI] Tổng hợp lỗi giao diện trang <tên trang>

1. <Khu vực 1>
  1.1 <lỗi>
  1.2 <lỗi>
2. <Khu vực 2>
  2.1 <lỗi>

Dev sửa xong mục nào thì ghi ": Fixed" hoặc ": Không cần fix" ngay sau mục đó. Khi retest, chỉ kiểm các mục đã Fixed. Lỗi nghiêm trọng, lỗi ngoài phạm vi Story hoặc cần team khác sửa thì tách ticket riêng.

Soát trước khi gửi

• ☐ Đọc tiêu đề là hiểu lỗi, không cần mở ra
• ☐ Người chưa dùng tính năng làm theo các bước vẫn tái hiện được
• ☐ Thông báo lỗi được chép nguyên văn
• ☐ Kết quả mong đợi có nguồn (AC / Figma / API doc / quyết định đã chốt)
• ☐ Có bằng chứng: ảnh khoanh vùng, GIF, curl, log console
• ☐ Đã ghi severity kèm lý do
• ☐ Đã tìm xem lỗi này có ticket chưa