07-缺陷管理（WDE 缺陷编号 × 等级 × 流转）¶
【重建推定版 V1.0】 / DOC-BT-07 / 版本 V1.0（2026-08-21 听写重建） 依据：PJM §4.5 变更管理 + WLG V3.8 §5.2 协作路由 + COLLAB-20260819-03 S6 修复 5 条 WDE-001~005 示例
一、缺陷编号规则（WDE-AAA × 三维度）¶
1.1 WDE 代码缺陷 = WDE-<NNN>¶
NNN = 三位序号，全局递增（WDE-001 = 本项目第 1 条发现的代码缺陷）。 目前历史基线：WDE-001 ~ WDE-005（5 条 BUG 全部修复，V3.3.0 代码恢复静态基线必须包含）
| ID | 缺陷简述（5 基线） | 引入模块 | 修复日期 | 当前状态 |
|---|---|---|---|---|
| WDE-001 | QSV DTO category_code 和 category_id 二选一逻辑缺陷 | interfaces/api/qsv_router.py | 2026-08-18 | ✅ Closed |
| WDE-002 | v3_seed 17 账号 ON CONFLICT 非幂等 → 重复执行报错 | infrastructure/db/seed/v3_seed.py | 2026-08-18 | ✅ Closed |
| WDE-003 | OQS get_oqs_user_or_admin 权限未覆盖 admin 角色 | application/services/oqs_service.py | 2026-08-18 | ✅ Closed |
| WDE-004 | main.py 未使用模块级 app = create_app()，导致 uvicorn 多 worker 异常 |
main.py（入口） | 2026-08-18 | ✅ Closed |
| WDE-005 | demo.py _cleanup 外键删除顺序错误（正序）导致 FK violation | seed/demo.py | 2026-08-18 | ✅ Closed |
后续新增缺陷编号：WDE-006, WDE-007, ...（听码 WDE 维护；听写在 COLLAB / DTL 中引用时须对齐编号）
1.2 缺陷分类前缀¶
完整编号 =
<前缀>-<NNN>：
| 前缀 | 含义 | 归属维护人 | 留痕日志 |
|---|---|---|---|
| WDE- | 代码 / 架构缺陷（听码修复） | 听码 WDE | WDL |
| OPS- | 运营流程 / 物料 / 场景脚本问题（OL 优化） | 运营 OL | DTL |
| OCL- | 部署 / 环境 / 配置缺陷（听云修复） | 听云 OCM | OCL |
| MDS- | 主数据内容 / 费率矩阵 / 标签分类数据问题（ML 维护） | ML 成文 | DTL（MDS 运营类） |
| DOC- | 文档错误 / 缺失 / 版本不一致（听写修复） | 听写 DT | DTL |
二、严重等级 × 引入阶段（二维定级）¶
PJM §4.5 变更管理：P0=阻塞、P1=严重、P2=一般、P3=轻微；纵轴=引入阶段（越早发现越便宜）。
| 严重等级 | L1 单元阶段 引入（听码自查） | L2 组件阶段 引入（听写交叉） | L3 UAT 阶段 引入（OL 联调） | L4 公测阶段 引入（真实用户） |
|---|---|---|---|---|
| P0 阻塞（系统不可用） | 处罚：返工 1h + WDL 说明 | 处罚：返工 2h + TL 审核 | 处罚：UAT 轮次打回 S5 重启 | 处罚：紧急回滚 + OCL + 客户赔偿预案 + BO 全员开会 |
| P1 严重（核心路径受损） | 返工 30min | 返工 1h + 听写复核 | UAT 本轮必须修复 | 生产热修复 + OCL 留痕 + 公开致歉 |
| P2 一般（非核心路径有 workaround） | 正常修复，不阻塞提交 | 修复进入下一轮 UAT | 可进入 UAT 下一轮（≤ 10 个容忍） | 下一个版本修复 + 写入补丁说明 |
| P3 轻微（UI / 文案 / 格式） | 累积修复（批处理） | 累积修复 | 累积修复（不限数量） | 下个小版本修复 |
三、缺陷 5 步流转¶
flowchart LR
A[1.New 新建] --> B(2.Assigned 派单)
B --> C{是否 WDE-代码类?}
C -->|是 WDE-| D1[听码 WDE 修复<br/>写 WDL]
C -->|否(OPS/OCL/MDS/DOC)| D2[对应角色修复<br/>写对应日志]
D1 --> E(3.Fixed 修复提交<br/>附修复 commit+WDL编号)
D2 --> E
E --> F(4.Verified OL/听写复核<br/>复跑用例打 PASS)
F --> G{是否通过?}
G -->|通过| H(5.Closed 关闭<br/>协作记录关联)
G -->|不通过| I(Reopen 打回 Step2<br/>备注复核失败理由)
I --> B四、缺陷单标准模板（COLLAB 登记用）¶
【缺陷单 DOC-BT-07 模板】
1. 缺陷编号：WDE-XXX（或其他前缀）
2. 标题：<一句话简洁描述>
3. 严重等级：P0 / P1 / P2 / P3（二维定级后选）
4. 引入阶段：L1 / L2 / L3 / L4
5. 发现人 & 发现日期：__________
6. 前置条件：
- 测试账号 ID
- 订单号 / 接口 / 模块
- 环境：本地预生产 / 阿里云 UAT
7. 复现步骤（可复现 = 缺陷解决 50%）：
Step 1 / 2 / 3 / ...
8. 实际结果（附截图 + CURL + response body）：
_____________________________
9. 预期结果（对照 05-基线用例的断言）：
_____________________________
10. 初步分析（选填）：___________________
11. 派单归属（前缀选）：WDE / OPS / OCL / MDS / DOC → Owner = ___________
12. 修复截止日期：________（P0=当日；P1=次日；P2=3 日内；P3=下周 batch）
13. 修复状态跟踪：
□ Assigned → Owner 签字 ______ 日期 ______
□ Fixed → 修复 commit hash: ________ WDL/OCL/DTL 编号: ________
□ Verified → 复现者签字 ______ 日期 ______ （附 PASS 截图 + CURL）
□ Closed → TL/BO 签字 ______ 日期 ______
14. 回归验证范围（影响用例清单）：
- UAT-<S#>-<##>, UAT-<S#>-<##>... 共 N 条用例重跑通过
五、缺陷重开标准¶
已 Closed 缺陷不得直接再编辑；必须走重开流程： 1. 重开触发条件：原修复后同一复现步骤再次出现相同实际结果 = 缺陷重开（非新缺陷） 2. 重开流程：DefectID 不变 + 状态 New → Assigned，增加「重开原因」第 15 栏：
3. 同一缺陷重开 ≥ 3 次 → 自动升级严重等级 1 级（P2→P1），且听码 WDE 须写 WDL 单独说明根因分析。15. 重开记录（可追加多次）： 第 1 次重开：______ 日期 ______ 原因 ______ 重开人 ______ 第 2 次重开：______ 日期 ______ 原因 ______ 重开人 ______
本文档为【重建推定版】，§一 WDE-001~005 5 条基线缺陷来源于 COLLAB-20260820-02 §代码基线 B1（5 BUG 修复基线）；§二 二维定级来源于 PJM §4.5 变更管理；§五重开 ≥ 3 次升级来源于 PJM §缺陷升级条款。