70 lines
3.4 KiB
Markdown
70 lines
3.4 KiB
Markdown
# AI 拆解无需求ID分组设计
|
||
|
||
## 背景
|
||
|
||
0 到 1 项目中，需求池可能只录入一条宽泛需求，例如“做一个充值功能”。产品原型里通常会有更多细粒度批注，例如金额输入、支付渠道、支付结果、充值记录、异常提示等。旧规则只拆关联需求命中的内容，原型中未命中关联需求的批注只进入 `noteOnly` 报告，容易漏掉真实要开发和测试的功能点。
|
||
|
||
## 决策
|
||
|
||
AI 拆解继续以当前版本关联需求为正式范围锚点，但原型中明确可拆、且没有匹配到关联需求的功能批注，也可以生成 DevTask / TestCase 草案。
|
||
|
||
这类草案不创建 Requirement，不进入需求池，也不加入版本关联需求列表。它们只在开发任务和测试用例中形成一个展示分组：
|
||
|
||
```text
|
||
无需求ID · 充值记录展示
|
||
```
|
||
|
||
分组只是一段展示用需求名称，不是正式需求实体。列表不额外显示“原型发现”等标记；草案本身仍按既有 AI 草案规则显示 `aiDraft` 视觉状态。
|
||
|
||
## 数据契约
|
||
|
||
DevTask 需要从“通过 `requirementId` 反查版本”调整为“直接归属版本”：
|
||
|
||
- `versionId`：必填，表示执行归属。
|
||
- `requirementId`：可选。有关联需求时填写；无正式需求 ID 时为空。
|
||
- `requirementName`：可选。无正式需求 ID 时作为分组展示名。
|
||
- `references[]`：仍必填，原型独有项至少包含 `prototype_note` 引用。
|
||
|
||
TestCase 已经主归属版本，保持同样语义：
|
||
|
||
- `versionId`：必填。
|
||
- `requirementId`：可选。
|
||
- `requirementName`：可选，用于无需求ID分组。
|
||
- `references[]`：仍必填。
|
||
|
||
旧数据兼容：没有 `versionId` 的 DevTask 可继续通过 `requirementId -> Requirement.versionId` 推导版本归属；新写入必须带 `versionId`。
|
||
|
||
## 对账报告
|
||
|
||
拆解报告从“匹配 / 单边 / 含糊”细化为：
|
||
|
||
- `matched`：关联需求和原型批注匹配，正常生成带 `requirementId` 的任务/用例。
|
||
- `reqOnly`：关联需求存在，但原型没有看到对应批注，提醒用户确认原型是否遗漏。
|
||
- `prototypeOnly`：原型有明确功能批注，但没有匹配到关联需求；生成无需求ID分组草案。
|
||
- `ambiguous`：原型批注含糊，无法形成稳定任务/用例，不自动写入。
|
||
|
||
`prototypeOnly` 不再只是提醒，它是可被用户采纳的草案来源。
|
||
|
||
## 派生规则
|
||
|
||
- 版本进度、阶段耗时、工作台、小宝预警等版本级聚合必须包含无需求ID分组下的 DevTask / TestCase。
|
||
- 需求进度、需求实际状态和需求关闭条件只统计带正式 `requirementId` 的 DevTask；无需求ID分组不影响任何 Requirement。
|
||
- 删除版本时，通过 `versionId` 清理对应 DevTask / TestCase / Bug；旧数据仍按 requirement 反查兼容。
|
||
- AI 重新拆解去重时，签名需要包含 `requirementId` 或 `requirementName`、任务类型、标题规范化和引用来源。
|
||
|
||
## UI 行为
|
||
|
||
开发任务和测试用例列表按需求分组时：
|
||
|
||
1. 正式关联需求分组按版本关联需求顺序展示。
|
||
2. 无需求ID分组排在正式需求之后，标题格式为 `无需求ID · {requirementName}`。
|
||
3. 不显示“原型发现”标记。
|
||
4. 详情抽屉中可以展示引用来源，方便追溯到原型批注。
|
||
|
||
## 不做
|
||
|
||
- 不自动创建 Requirement。
|
||
- 不把无需求ID分组加入版本关联需求列表。
|
||
- 不把无需求ID分组计入需求池统计。
|
||
- 不用隐藏 Requirement 作为技术兜底。
|