🐞 Bug/Defect Report Template
# 🐛 Bug Report: [Bug Title]
## Bug ID
BUG-YYYY-XXX
(e.g., BUG-2025-014)
## Reported By
[Your Name]
## Reported On
[YYYY-MM-DD]
## Environment
- **App Version**: v1.5.0
- **Test Environment**: Staging
- **Browser/OS**: Chrome v123 / macOS 13.6
- **Device**: MacBook Pro 2021
## Priority
🔼 Low / Medium / High
## Severity
🟨 Minor / 🟧 Major / 🟥 Critical / 🟥 Blocker
## Module / Feature Affected
[e.g., User Profile > Change Password]
## Summary
Concise description of the issue.
> _Example_: Password change fails when submitting valid input, and no error is shown.
## Steps to Reproduce
1. Log in as `[email protected]`
2. Navigate to Profile Settings
3. Enter current password and a new valid password
4. Click "Save Changes"
5. Observe no confirmation and no change in password
## Actual Result
No message is displayed and the password remains unchanged.
## Expected Result
User should receive a success message, and password should be updated.
## Screenshot / Video
Attach or link if available
📷 
## Logs / Console Output (if applicable)
```json
{
"error": "Password update failed",
"status": 500
}
Bug Type
- Functional
- UI
- Performance
- Security
- Accessibility
- Compatibility
Status
- Open / In Progress / Resolved / Closed / Reopened
Assigned To
[Developer Name or Team]
Related Test Case(s)
- TC-2025-045: Change Password with Valid Input
Comments
This issue blocks UAT sign-off for the Profile module.
---
# 📋 Bug Report Example (Tabular Format)
| Field | Value |
|----------------------|------------------------------------------------------------|
| **Bug ID** | BUG-2025-014 |
| **Title** | Password not updating after form submission |
| **Reported By** | A. Singh |
| **Date** | 2025-03-24 |
| **Priority** | High |
| **Severity** | Major |
| **Module** | User Profile - Change Password |
| **Environment** | Staging – Chrome 123 / macOS Ventura |
| **Steps to Reproduce** | 1. Go to Profile Settings<br>2. Enter valid password<br>3. Click Save |
| **Actual Result** | Password remains unchanged, no message shown |
| **Expected Result** | Password updated with success notification |
| **Screenshot** | Attached |
| **Logs** | `POST /api/user/update-password` returns 500 |
| **Bug Type** | Functional |
| **Status** | Open |
| **Assigned To** | T. Roy (Backend Dev) |
| **Related Test Case**| TC-2025-045 |
| **Comments** | Blocks UAT for Sprint 12 |
---
# ✅ Best Practices for Bug Reporting
- **Be concise** but complete—developers hate vague bugs
- **Always include repro steps** that are consistent and minimal
- **Attach screenshots or screen recordings**—visuals help!
- Use standard **severity & priority** labels defined by your org
- Link to test cases or test runs when possible
- Log bugs **as early as possible** in the sprint or cycle