4.1 KiB
4.1 KiB
验收标准(草案 v2,待用户确认)
v2 变更:激活时间确认复用
zt_story_user.activateddate;本期边界明确为「DDL+实体+Mapper+Service,不含 Controller」(PM 依需求解读决定,用户授权);DDL 路径定为codes/zentao/sql/;Q1-4 核实结论附文末。
本期 MVP 范围:需求全生命周期数据模型落地(Q1-2 确认)。项目总目标(SOP 流程流转 + 绩效统计)不在本期验收范围内。
范围界定
- 含:缺口表的 DDL、实体/Mapper/Service 生成、字段-需求映射验证、单元测试
- 不含:Controller 层 CRUD 接口(属后续流程/页面阶段)、SOP 流程状态流转逻辑、绩效统计算分、前端页面、AI 自动评估能力
数据项映射与缺口分析(证据:SRC-001 思维导图 vs 现有代码)
| SRC-001 数据项 | 现状(证据) | 缺口 |
|---|---|---|
| 用户需求:内容/创建人/创建/审批时间 | ZtStoryUser.java:111,120 openeddate/approveddate |
复用,无缺口 |
| 用户需求:激活时间 | ZtStoryUser.java:153 activateddate(已存在,用户指出并核实) |
复用,无缺口 |
| 需求讨论会:会议时间/参与人/纪要 | ZtMeeting.java:47,52,73 meetingDate/users/result |
复用,无缺口 |
| 讨论会 PRD 附件 | ZtFile.java 通用附件表 |
objectType 取值约定 → Arch 阶段给方案 |
| 研发需求:AI 工作量指标 | ZtStoryExpand.java numberUnits/unitBusinessComplexity/technicalComplexityCoefficient/aiEfficiencyCoefficient/evaluationTime/workloadIndex |
缺「AI 参与率」字段 |
| 研发任务:AI 评估任务工作量指数 | ZtTask.java estimate/consumed/left 为人工工时 |
缺任务级 AI 工作量指数字段 |
| 测试任务/BUG/测试报告 | ZtTesttask.java、ZtBug.java、ZtCase.java |
复用,无缺口 |
| AI 代码审查报告(审查事项、审查结果) | 全库 grep 无命中 | 净新增表 |
| AI 工作日志(8 类:PRD版本/工作量评估/架构设计/架构评审/任务拆分/门禁检查/代码审查/文档更新) | 全库 grep 无命中 | 净新增表 |
验收条目
- AC-1 DDL 交付:新增
zt_ai_code_review(AI代码审查报告:需求关联、审查事项、审查结果、是否通过、审查时间)、zt_ai_work_log(AI工作日志:需求关联、日志类型枚举覆盖 SRC-001 全部 8 类、内容/结果、发生时间)两张表;zt_story_extend增加 AI 参与率字段;任务侧增加 AI 工作量指数字段。DDL 脚本含变更说明头,存放于codes/zentao/sql/(新建目录)。 - AC-2 实体规范:新表实体/Mapper/Service 按现有规范生成(
zt_前缀、MyBatis-Plus 无注解驼峰映射、conf/CodeGenerator.java生成、Lombok),项目编译通过。 - AC-3 映射完整性:SRC-001 思维导图全部数据项均有字段级映射(上表「复用」项逐一核对落库字段名,缺口项由 AC-1 覆盖),映射表随交付物归档。
- AC-4 单测:新增 Service 方法单测覆盖正常路径 + ≥1 异常/边界路径,全部通过(tgassist Dev 强制规则)。
- AC-5 无回归:现有代码编译与已有测试不因本期改动失败。
附:Q1-4 核实结论(用户澄清 + 证据)
架构边界(用户确认):工作量指数不在 zentao 计算,由 AI 框架(本框架)计算后上传至 zentao 存储。zentao 只存不算。
- 上传通道已存在:
ZtStoryExpandController.java:23(/zt-story-expand)→zt_story_extend.workloadIndex等字段 - 代码佐证:
ZtStoryExpandServiceImpl.java:114-117workloadIndex 为外部传入/DB 已有值,无源头计算 —— 与该边界一致 - 推论:本期新增的 AI 参与率字段同样「只存不算」;
zt_ai_code_review、zt_ai_work_log后续阶段需参照/zt-story-expand模式补上传接口(记入后续计划,不在本期范围) - 另注:tgassist 提到的 demand-assessor 技能本机不存在(
.kimi-code/skills/仅 tgassist),本项目自身的「工作量评估」阶段需另行处理