2026-09-09 16:46:15 +00:00
committed by gitea-admin
co-authored by duylh19
parent 13e2c22067
commit 1b8429e33a
147 changed files with 20993 additions and 461 deletions
+106
View File
@@ -0,0 +1,106 @@
# Output Contract — `defect_record`
Do `ui-bug-triage` sinh ra. Giữ **đúng** thứ tự và tên mục. Không có dữ liệu thì ghi
`unknown` hoặc `N/A` kèm lý do — **không xoá mục**.
---
```yaml
---
defect_id: UI-<YYYYMMDD>-<NN>
from_agent: ui-bug-triage
next_agent: <ui-visual-fixer | ux-flow-fixer | i18n-a11y-fixer | RETURN_TO_REPORTER>
category: <visual | flow | i18n-a11y | not-ui>
severity: <S1 | S2 | S3 | S4>
confidence: <low | medium | high>
reproducible: <yes | no | intermittent>
security_review: <required | not-required>
affected_files: []
themes_verified: []
languages_verified: []
blocked_on: []
---
```
# 1. Tóm tắt
Một câu: cái gì hỏng, ở màn nào, với ai.
# 2. Quan sát vs kỳ vọng
| | |
|---|---|
| **Người dùng thấy** | |
| **Người dùng mong** | |
| **Người dùng suy đoán (chưa xác minh)** | |
# 3. Môi trường
| Trường | Giá trị |
|---|---|
| Phiên bản app / commit | |
| OS + độ phân giải + mức scale | |
| Theme lúc xảy ra | |
| Ngôn ngữ lúc xảy ra | |
| Project / workspace liên quan | (mô tả, **không** nêu tên khách hàng) |
# 4. Các bước tái hiện
1.
2.
3.
**Tỉ lệ tái hiện:** _luôn / thỉnh thoảng (n/m lần) / không_
# 5. Ma trận biến thể đã thử
| Biến thể | Đã thử | Kết quả |
|---|---|---|
| Theme dark | | |
| Theme light | | |
| Ngôn ngữ vi / ja / en | | |
| Cửa sổ nhỏ nhất / maximize | | |
| Đổi theme/ngôn ngữ **trước** rồi mới mở màn (bẫy P07) | | |
# 6. Khoanh vùng
| | |
|---|---|
| Nav row | Dashboard / Schedule / Workspace / Monitoring |
| Sub-tab / dialog | |
| `manifest.json` slug | |
| Widget dựng tại | `file.py:line` |
| Control (`controls.json`) | `var`, `type`, `object_name` |
| Đã kiểm cả `ui/` và `presentation/` | có / không |
# 7. Giả thuyết nguyên nhân gốc
| # | Giả thuyết | Mã pitfall | Đã xác minh thế nào | Còn / loại |
|---|---|---|---|---|
| 1 | | P__ | | |
| 2 | | P__ | | |
**Kết luận:** _(một nguyên nhân + `file:line`, hoặc "chưa xác định" nếu `confidence: low`)_
# 8. Tác động
- Ai bị ảnh hưởng:
- Chặn công việc gì:
- Có đường vòng không:
- Lý do chọn mức `severity` này:
# 9. Cân nhắc bảo mật
- Chạm permission / credential / monitoring bảo mật / isolation / routing? _có / không_
- Dữ liệu người dùng gửi lên đã redact? _có / không — mô tả đã bỏ gì_
- Có dấu hiệu ở `system/security.md` S4 không?
# 10. Open Questions (tối đa 3)
| # | Câu hỏi | Mặc định nếu không trả lời | Có chặn không |
|---|---|---|---|
| 1 | | | có / không |
# 11. Out of scope
Vấn đề khác phát hiện được, **không** sửa trong lần này — đề xuất issue riêng.