You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

55 lines
5.2 KiB

1 week ago
# 02: 22 条缺陷复测裁决(原型 v29 > PRD > 问用户)
`Type: research`
`Status: resolved`
`Blocked by: 01`
## 问题
上轮 e2e 报告(`.scratch/opportunity-e2e/e2e-report.md` §D-01..D-22)的 22 条缺陷,需要逐条对照**最新原型 v29** 裁决:✅ 确认(真实缺陷,附原型证据)/ ⚠ 翻案(原型/PRD 证明现状是对的)/ ❓ 存疑(升级用户拍板)。
判定依据优先级(用户钦定):**原型 > PRD > 问用户**。原型文本库在 `.scratch/opportunity-bugfix/lanhu-pages/`(票 01 产出);PRD 在 `.scratch/opportunity-module/商机业务-PRD.md`(辅以 `商机模块-产品确认稿.md`);**原型页面自带需求批注区(开发说明/详细说明/字段说明/交互说明/业务规则&功能逻辑/验收标准),这是最强的判定依据,先读批注再下结论**。
## 逐条裁决指引
白盒根因已实锤的(裁决基本是确认,重点是补原型证据引用):
- **D-01~03**(关联客户 add/search/set-primary 404):查 a3-1-1-1-2-4(添加关联客户弹窗)+ 概览 Tab「添加关联客户」按钮 + 批注「1、开发说明」。已知团队成员页有「添加关联客户」按钮(本 session 已提取)。域规则见 `crm-opportunity/CONTEXT.md`(一商机多客户、有且仅一个主要意向、无删除、切主三步事务)。
- **D-04~06**(团队成员 add/delete/update 404):原型证据已铁(「+ 添加成员」「编辑」「移除」按钮 + 表头 + 移交入口,`extract-out.txt` 样例)。补 a3-1-1-1-8 批注区内容即可。
- **D-07/08**(暂缓态可编辑/可关闭):PRD §3.3 边约束。查 v29 暂缓态页面的按钮态批注(暂缓态下编辑/关闭按钮是否置灰)。
- **D-09**(禁领规则未生效):查公海页/领取动作的批注(是否提「禁领」规则)。
- **D-10~12**(V-CONFIG 三族 50001):规则配置页(A7-3-2-x)批注是否描述「编辑发布中版本→生成新草稿」流程。代码根因已定位(map.md 锚点表),无论原型怎么写主键冲突都是实现 bug。
- **D-13**(owner_dept_id 恒空):查商机列表/详情的部门字段展示 + 部门专用公海规则页(A7-3-2-3-1 前后)批注。
需要原型细看才知真假的(重点核查项):
- **D-14**(必填校验 500 类)→ 新建商机页(原型 12 必填 vs 后端 2 必填的对照已在 demo 子表实测里答过,见 map Notes);批注「3、字段说明」应列必填项。
- **D-15**(公海看板 summary 未过滤)→ 商机公海页(a3-1-x)看板卡片字段。
- **D-16**(detail 六联动字段 null)→ 商机详情概览 Tab 的联动字段区(招标形式/责任人/所属团队/所属部门等——本 session 已提取到详情页头有这些字段,即原型要求显示)。
- **D-17**(方案卡提交后主表未回显)→ 方案卡 Tab + 提交流程批注。
- **D-18**(surveySeq 需调用方传)/ **D-19**(勘察说明不必填)→ 现场勘察 Tab 批注「3、字段说明」。
- **D-20**(oplog 流转不留痕)→ 操作日志 Tab 的记录类型枚举(原型是否含流转记录)。
- **D-21**(bizType 契约矛盾)/ **D-22**(versions 实体直出泄露)→ 代码/文档层缺陷,原型无关;D-22 违 ADR-0017 直接确认。
## 产出
`retest-verdicts.md`:每条 D-NN 一节 —— 裁决(✅/⚠/❓)+ 原型证据(页名 + 关键文本引用)+ 修复方向(确认的给一句方案,供票 03-06 直接开工)+ 翻案理由(⚠ 的说明现状为何正确)。❓ 的列成问题清单升级用户。
## 验收
- 22 条全覆盖,每条有裁决 + 依据引用(原型页名或 PRD 节号)。
- ⚠ 翻案 ≤ 5 条为正常预期(上轮已预判 D-18/19 可能翻案);超过说明判定口径有问题,回查。
- 修复票 03-06 的范围以此为准确认(翻案的从修复范围剔除)。
## Answer
**产出**:`retest-verdicts.md`(同目录)。**裁决:✅ 确认 19 / ⚠ 翻案 3(D-08、D-18、D-19)/ ❓ 0**(翻案 3 ≤ 5 符合验收预期)。
- 22 条全部有裁决 + 证据引用(v29 原型页名·批注小节 / PRD 节号 / Controller 源码),修复方向已写至可直接开工粒度。
- **三条翻案(均按「原型 > PRD > 拍板」优先级裁定)**:
- **D-08 暂缓态可关闭 → 行为正确**:PRD §3.2 E6 明文「2,3→4」+ §3.3 暂缓中允许 E6;e2e 报告所引「无 3→4 出边」与现行 PRD 原文不符。
- **D-18 surveySeq 调用方传 → 符合原型**:v29「*勘察次数」是必填下拉框(第一次/第二次…),上轮拍板 P1-2「自动生成」被推翻。
- **D-19 勘察说明非强制 → 符合原型**:v29 字段说明「建议必填」+ 表单无星号,上轮拍板 P1-3 被推翻。
- **范围变化**:票 05 剔除 D-08;票 06 剔除 D-18/19;D-16 收窄至 4 字段(节点停留天数/下阶段名两字段在 v29 原型与 PRD 均无出处,e2e 报告引「PRD §7.9」实为 view_log 节,引用失准)。回归时 D-08/18/19 三处断言需反转(票 09 处理)。
- **升级用户项**:无强制拍板;两条知悉项(翻案异议窗口、D-07 按 PRD P1-7 从严)已列在 retest-verdicts.md 末尾,不阻塞开工。