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 栏：
15. 重开记录（可追加多次）：
    第 1 次重开：______ 日期 ______ 原因 ______ 重开人 ______
    第 2 次重开：______ 日期 ______ 原因 ______ 重开人 ______
3. 同一缺陷重开 ≥ 3 次 → 自动升级严重等级 1 级（P2→P1），且听码 WDE 须写 WDL 单独说明根因分析。

本文档为【重建推定版】，§一 WDE-001~005 5 条基线缺陷来源于 COLLAB-20260820-02 §代码基线 B1（5 BUG 修复基线）；§二二维定级来源于 PJM §4.5 变更管理；§五重开 ≥ 3 次升级来源于 PJM §缺陷升级条款。

07-缺陷管理（WDE 缺陷编号 × 等级 × 流转）¶

一、缺陷编号规则（WDE-AAA × 三维度）¶

1.1 WDE 代码缺陷 = WDE-<NNN>¶

1.2 缺陷分类前缀¶

二、严重等级 × 引入阶段（二维定级）¶

三、缺陷 5 步流转¶

四、缺陷单标准模板（COLLAB 登记用）¶

五、缺陷重开标准¶

1.1 WDE 代码缺陷 = `WDE-<NNN>`¶