## Description

<!-- Provide a clear and concise description of what this PR does -->

### What changed?

- 

### Why?

- 

---

## Related Issues

<!-- Link to related issues using keywords: Fixes #123, Closes #456, Related to #789 -->

Fixes #

---

## Type of Change

<!-- Mark the relevant option with an 'x' -->

- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
- [ ] ✨ New feature (non-breaking change which adds functionality)
- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] 📝 Documentation update
- [ ] ♻️ Refactoring (no functional changes)
- [ ] 🎨 Style/formatting changes
- [ ] ⚙️ Configuration/infrastructure changes
- [ ] 🧪 Test additions or modifications

---

## Checklist

<!-- Mark completed items with an 'x' -->

### Code Quality

- [ ] My code follows the project's style guidelines
- [ ] I have run `make format` to format my code
- [ ] I have run `make lint` and addressed all issues
- [ ] My code passes `make test`
- [ ] I have added/updated tests that prove my fix/feature works
- [ ] New and existing unit tests pass locally

### Documentation

- [ ] I have updated the documentation accordingly
- [ ] I have added docstrings to new functions/classes
- [ ] I have updated the README if needed
- [ ] I have added comments for complex logic

### Testing

- [ ] I have tested this manually
- [ ] I have added unit tests
- [ ] I have added E2E tests (if applicable)
- [ ] All tests pass: `make test-all`

### Security

- [ ] I have not introduced any security vulnerabilities
- [ ] I have not committed secrets or credentials
- [ ] I have reviewed the code for potential security issues

---

## Testing Instructions

<!-- Describe how reviewers can test this PR -->

### How to test:

1. 
2. 
3. 

### Expected behavior:

- 

---

## Screenshots (if applicable)

<!-- Add screenshots for UI changes -->

### Before:

### After:

---

## Additional Context

<!-- Any additional information that reviewers should know -->

### Performance Impact:

- 

### Breaking Changes:

- 

### Migration Guide (if breaking):

```bash
# Steps to migrate
```

---

## Deployment Notes

<!-- Special deployment considerations -->

- [ ] Requires database migration
- [ ] Requires configuration changes
- [ ] Requires dependency updates
- [ ] Should be deployed during off-hours
- [ ] Requires feature flag

---

## Reviewers

<!-- Tag specific reviewers if needed -->

@mentions

---

<!-- 
## For Maintainers

### Merge Checklist:
- [ ] All CI checks passing
- [ ] Required approvals received
- [ ] No unresolved conversations
- [ ] Branch is up to date with base
- [ ] Deployment plan confirmed (if needed)
-->
