feat(版本详情): 完善任务流程与风险预警

docs/decisions.md

@@ -96,8 +96,9 @@
 **决策**：
 - `status: todo|in_progress|testing|submitted`
 - `isBlocked: boolean` + `blockReason: string` + `blockedById: string`
+- DevTask 存在阻塞时不能转为 `submitted`，必须先解除阻塞再提测。
 
-**理由**：阻塞和状态正交。工作台筛选 `isBlocked=true` 一键拉出所有阻塞项，跨状态。
+**理由**：阻塞和状态正交。工作台筛选 `isBlocked=true` 一键拉出所有阻塞项，跨状态；但 `submitted` 代表开发交付完成，仍必须满足“当前无阻塞”的完成条件。
 
 ## 11. 加班原因可选，且去掉"其他"
 
@@ -352,7 +353,7 @@
 - 新建统一的工作日日期时间选择组件，创建任务时复用同一套交互。
 - 内置国务院办公厅发布的 2026 年中国法定节假日和调休工作日；未知年份按周末/工作日兜底。
 - 选择节假日或周末时只提示，不阻止保存；选择调休工作日时按工作日提示。
-- TestCase 增加 `plannedTestAt`，Bug 增加 `plannedFixAt`，保存为 ISO 时间戳。
+- TestCase 增加 `plannedTestAt` / `plannedEndAt`，Bug 增加 `plannedFixAt`，保存为 ISO 时间戳。
 
 **理由**：项目排期需要贴近中国工作日，但研发和线上 Bug 可能确实安排在非工作日处理，所以系统负责提醒，最终是否保存交给用户判断。
 
@@ -404,3 +405,16 @@
 - 没有明确角色匹配或成员匹配时，AI 不输出推荐字段，任务保持未分配，供成员后续领取或手动分配。
 
 **理由**：负责人推荐能减少项目经理初次分配成本，但分配本身是团队执行承诺，必须由人确认。把推荐和写入分开，可以复用版本成员上下文，又避免模型幻觉姓名或越权自动派单。
+
+## 34. AI 草案领取和计划必须绑定
+
+**问题**：AI 生成的 DevTask / TestCase 如果没有负责人，团队需要先领取；如果把“待领取”和“待排期”拆成两个可见状态，会让版本详情列表出现更多标签，且无法体现“领取时就应该承诺计划”的业务动作。
+
+**决策**：
+- 版本详情开发任务和测试用例不显示“待排期”标签。
+- 无负责人时显示“待领取”，领取入口必须同时填写计划起止时间。
+- 用户采纳 AI 推荐负责人后，草案已经有负责人，不再需要领取；但开始开发/测试前仍必须补齐计划起止时间。
+- DevTask 进入 `in_progress` 前必须具备 `assigneeId`、`expectedStartAt`、`expectedEndAt`。
+- TestCase 进入 `running` 前必须具备 `assigneeId`、`plannedTestAt`、`plannedEndAt`。
+
+**理由**：领取代表成员承诺执行，计划时间代表承诺边界，二者应该在同一个动作里完成。列表层只表达“谁还没接手”，状态机层负责阻止未计划任务进入执行，页面不会被额外标签干扰。

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 状态。
+
 ## 测试轮次流程
 
 测试用例支持按版本开启多轮测试：
@@ -231,8 +247,8 @@ Implementation convention:
 - 调研、产品方案、UI 设计、开发任务、测试用例、Bug 创建时使用统一工作日日期时间选择器。
 - 日期选择器接入中国节假日日历。当前内置 2026 年国务院办公厅放假调休安排；其他年份先按周末/工作日兜底。
 - 非工作日只提示，不阻止保存；调休工作日按工作日提示。
-- 测试用例计划测试时间字段为 `plannedTestAt`；Bug 计划修复时间字段为 `plannedFixAt`。
-- 测试轮次复制用例时保留计划测试时间、AI 预估和执行预估，清空实际执行记录。
+- 测试用例计划测试时间字段为 `plannedTestAt` / `plannedEndAt`；Bug 计划修复时间字段为 `plannedFixAt`。
+- 测试轮次复制用例时保留计划测试起止时间、AI 预估和执行预估，清空实际执行记录。
 
 ## 工时统计口径