feat(版本详情): 完善流程日志与需求覆盖

docs/workflow.md

@@ -35,6 +35,22 @@
 
 开发任务从“待开发”切换到“开发中”时，只有当前时间已经超过 `expectedEndAt`（预计截止）才要求填写延后原因。超过预计开始时间但仍未超过预计截止时间，不视为延后。
 
+## AI 草案领取与计划流程
+
+开发任务和测试用例由 AI 生成后，版本详情里不再显示独立的“待排期”状态：
+
+1. DevTask / TestCase 没有负责人时显示“待领取”。
+2. 点击“领取并填写计划”时同时写入当前用户为负责人，并填写计划起止时间。
+3. 已采纳推荐负责人的 AI 草案已经有负责人，不需要领取，但开始开发/测试前仍必须点击“填写计划”补齐计划起止时间。
+4. DevTask 开始开发前必须同时具备 `assigneeId`、`expectedStartAt`、`expectedEndAt`；TestCase 开始测试前必须同时具备 `assigneeId`、`plannedTestAt`、`plannedEndAt`。
+5. 计划起止时间自动按工作日历计算 `estimateHours`。AI 预估仍保留在 `aiEstimateHours`，不代表负责人已确认排期。
+
+## 开发任务提测流程
+
+1. DevTask 从“自测”转为“已提测”前，任务不能处于阻塞中。
+2. 如果 `isBlocked=true`，必须先解除阻塞并清空阻塞原因，再允许提测。
+3. “已提测”仍然是 DevTask 终态；后续测试通过或失败不回写 DevTask 状态。
+
 ## 测试轮次流程
 
 测试用例支持按版本开启多轮测试：
@@ -207,6 +223,8 @@ AI 估时约束：
 - `version-plan-workflow.ts` 是调研/产品方案/UI 设计完成条件的唯一入口。
 - `requirement-selector.ts` 是版本内关联需求候选的唯一入口。
 - `TaskCategory.code` 是 AI 和系统任务类型的稳定映射锚点，`id` 只作为存储主键。
+- 产品方案和 UI 设计的引用需求不再用 checkbox 直接标记完成，必须通过 `requirementCoverage[]` 记录 `not_started / partial / completed`、本次已完成内容和剩余内容；只有 `completed` 计入成果提交门禁。
+- 产品/UI 计划右侧展示计划日志，需求进度更新和 AI 拆解触发/完成/失败都写入 `VersionPlan.logs[]`，页面只消费日志数据，不临时拼历史。
 ## Work Activity Daily Report Flow (2026-06-26)
 
 The daily report flow uses mixed evidence:
@@ -244,8 +262,8 @@ AI 解读不由人工按钮触发。`at_risk`、`likely_delayed`、`blocked` 自
 - 调研、产品方案、UI 设计、开发任务、测试用例、Bug 创建时使用统一工作日日期时间选择器。
 - 日期选择器接入中国节假日日历。当前内置 2026 年国务院办公厅放假调休安排；其他年份先按周末/工作日兜底。
 - 非工作日只提示，不阻止保存；调休工作日按工作日提示。
-- 测试用例计划测试时间字段为 `plannedTestAt`；Bug 计划修复时间字段为 `plannedFixAt`。
-- 测试轮次复制用例时保留计划测试时间、AI 预估和执行预估，清空实际执行记录。
+- 测试用例计划测试时间字段为 `plannedTestAt` / `plannedEndAt`；Bug 计划修复时间字段为 `plannedFixAt`。
+- 测试轮次复制用例时保留计划测试起止时间、AI 预估和执行预估，清空实际执行记录。
 
 ## 工时统计口径