258 lines
4.5 KiB
Markdown
258 lines
4.5 KiB
Markdown
# DAR 模板（缺陷分析报告）— pmassist-v3
|
||
|
||
> **使用说明**：按 8D/根因分析思路组织，所有结论需引用证据。
|
||
> 涉及代码问题时优先查阅 CodeMap/DomainMap，支持精准根因定位。
|
||
|
||
---
|
||
|
||
## 0. 文档信息
|
||
|
||
| 字段 | 内容 |
|
||
|---|---|
|
||
| 缺陷编号 | BUG-xxx |
|
||
| 版本 | v1.0 |
|
||
| 状态 | 分析中 / 已修复 / 已验证 |
|
||
| 作者 | |
|
||
| 创建日期 | |
|
||
| 最后更新 | |
|
||
|
||
---
|
||
|
||
## 1. 缺陷概述
|
||
|
||
### 1.1 问题描述
|
||
> 简要描述缺陷现象，用一句话概括。
|
||
|
||
### 1.2 影响范围
|
||
|
||
| 维度 | 说明 |
|
||
|---|---|
|
||
| 影响用户数 | |
|
||
| 影响业务功能 | |
|
||
| 影响系统/服务 | |
|
||
| 影响时间窗口 | |
|
||
|
||
### 1.3 严重级别与优先级
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 严重级别 | P0（紧急）/ P1（严重）/ P2（一般）/ P3（轻微）|
|
||
| 处理优先级 | 立即修复 / 本迭代修复 / 下迭代修复 |
|
||
|
||
---
|
||
|
||
## 2. 复现信息
|
||
|
||
### 2.1 复现步骤
|
||
|
||
1. 步骤一
|
||
2. 步骤二
|
||
3. 步骤三
|
||
|
||
### 2.2 期望结果 vs 实际结果
|
||
|
||
| | 描述 |
|
||
|---|---|
|
||
| **期望结果** | |
|
||
| **实际结果** | |
|
||
|
||
### 2.3 环境信息
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 系统版本 | |
|
||
| 分支/Tag | |
|
||
| 设备/网络 | |
|
||
| 账号/角色 | |
|
||
|
||
### 2.4 相关证据
|
||
|
||
| 类型 | 路径/描述 |
|
||
|---|---|
|
||
| 日志 | [SRC-001] |
|
||
| 截图 | [SRC-002] |
|
||
| 接口请求 | [SRC-003] |
|
||
| 监控数据 | |
|
||
|
||
---
|
||
|
||
## 3. 时间线
|
||
|
||
| 时间 | 事件 | 操作人 |
|
||
|---|---|---|
|
||
| | 首次发现 | |
|
||
| | 问题升级 | |
|
||
| | 临时止损 | |
|
||
| | 根因确认 | |
|
||
| | 修复上线 | |
|
||
| | 验证通过 | |
|
||
|
||
---
|
||
|
||
## 4. 临时遏制措施（Containment）
|
||
|
||
### 4.1 当前止损方案
|
||
|
||
### 4.2 影响控制范围
|
||
|
||
---
|
||
|
||
## 5. 根因分析
|
||
|
||
### 5.1 直接原因
|
||
|
||
### 5.2 根本原因（5 Whys）
|
||
|
||
| 层次 | Why | 分析 | 证据 |
|
||
|---|---|---|---|
|
||
| 第1层 | 为什么出现缺陷？ | | [SRC-001] |
|
||
| 第2层 | 为什么第1层原因存在？ | | |
|
||
| 第3层 | 为什么第2层原因存在？ | | |
|
||
| 第4层 | 为什么第3层原因存在？ | | |
|
||
| 第5层 | 根本原因 | | |
|
||
|
||
### 5.3 根因类型分类
|
||
|
||
- [ ] 代码逻辑错误
|
||
- [ ] 边界条件未处理
|
||
- [ ] 需求理解偏差
|
||
- [ ] 测试覆盖不足
|
||
- [ ] 配置/环境问题
|
||
- [ ] 第三方依赖问题
|
||
- [ ] 数据质量问题
|
||
- [ ] 其他：______
|
||
|
||
### 5.4 触发条件与边界
|
||
|
||
```mermaid
|
||
graph TD
|
||
A[触发条件] --> B{边界判断}
|
||
B -->|条件A| C[正常路径]
|
||
B -->|条件B| D[Bug触发路径]
|
||
D --> E[问题结果]
|
||
```
|
||
|
||
### 5.5 代码根因定位
|
||
|
||
> 引用 CodeMap/DomainMap 精准定位。
|
||
|
||
| 文件/类 | 方法 | 行号（约） | 问题说明 | 证据 |
|
||
|---|---|---|---|---|
|
||
| | | | | [CODEMAP:...] |
|
||
|
||
---
|
||
|
||
## 6. 纠正措施（Corrective Action）
|
||
|
||
### 6.1 修复方案
|
||
|
||
| 方案 | 描述 | 影响范围 | 风险 | 结论 |
|
||
|---|---|---|---|---|
|
||
| 方案 A（选定）| | | | ✅ 采用 |
|
||
| 方案 B | | | | ❌ 放弃 |
|
||
|
||
### 6.2 修复影响评估
|
||
|
||
| 维度 | 影响说明 |
|
||
|---|---|
|
||
| 影响模块 | |
|
||
| 数据迁移 | 需要 / 不需要 |
|
||
| 接口变更 | 有 / 无 |
|
||
| 回归范围 | |
|
||
|
||
### 6.3 回归验证要点
|
||
|
||
| 验证项 | 说明 | 负责人 |
|
||
|---|---|---|
|
||
| | | |
|
||
|
||
---
|
||
|
||
## 7. 效果验证
|
||
|
||
### 7.1 验证方式与结果
|
||
|
||
| 验证项 | 方式 | 结果 | 时间 |
|
||
|---|---|---|---|
|
||
| | 自动化测试/手工测试 | ✅/❌ | |
|
||
|
||
### 7.2 监控/指标变化
|
||
|
||
| 指标 | 修复前 | 修复后 | 变化 |
|
||
|---|---|---|---|
|
||
| | | | |
|
||
|
||
---
|
||
|
||
## 8. 预防措施与改进
|
||
|
||
### 8.1 预防机制
|
||
|
||
| 类型 | 措施 | 负责人 | 完成时间 |
|
||
|---|---|---|---|
|
||
| 监控告警 | | | |
|
||
| 测试补充 | | | |
|
||
| 流程改进 | | | |
|
||
| 代码规范 | | | |
|
||
|
||
### 8.2 长期改进计划
|
||
|
||
| 改进项 | 优先级 | 计划时间 | 负责方 |
|
||
|---|---|---|---|
|
||
| | P1 | | |
|
||
|
||
---
|
||
|
||
## 9. 经验总结
|
||
|
||
### 9.1 经验教训
|
||
|
||
| 类别 | 教训 | 对应改进措施 |
|
||
|---|---|---|
|
||
| 研发 | | |
|
||
| 测试 | | |
|
||
| 运维 | | |
|
||
| 产品 | | |
|
||
|
||
### 9.2 可复用的规则/检查项
|
||
|
||
> 归纳为可在未来需求中复用的防范规则。
|
||
|
||
- [ ] {检查项1}
|
||
- [ ] {检查项2}
|
||
|
||
---
|
||
|
||
## 10. 证据与引用
|
||
|
||
- 引用 `materials_index.md` 中的 SRC-xxx
|
||
- CODEMAP/DOMAINMAP/RUNTIME 证据引用
|
||
|
||
---
|
||
|
||
## 11. 证据映射表（强制）
|
||
|
||
| 章节 | 关键结论 | 证据 | 状态 |
|
||
|---|---|---|---|
|
||
| 复现信息 | | | |
|
||
| 根因分析 | | | |
|
||
| 纠正措施 | | | |
|
||
| 效果验证 | | | |
|
||
|
||
---
|
||
|
||
## 12. 系统资产引用（强制）
|
||
|
||
| 资产类型 | 路径 | 用途 |
|
||
|---|---|---|
|
||
| CodeMap | | |
|
||
| DomainMap | | |
|
||
| Runtime | | |
|
||
|
||
---
|
||
|
||
## 图表要求（强制检查）
|
||
|
||
- [ ] 至少 1 个 mermaid 图（根因路径/修复流程/时间线任选）
|
||
- [ ] 至少 1 张表（影响范围/根因层次/预防措施等）
|