Files
zentao-flow/tmp/withdrawn-tgassist-session/zentao-20260722-1638/02_acceptance/acceptance.md
T

4.1 KiB
Raw Blame History

验收标准(草案 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-117 workloadIndex 为外部传入/DB 已有值,无源头计算 —— 与该边界一致
  • 推论:本期新增的 AI 参与率字段同样「只存不算」;zt_ai_code_review、zt_ai_work_log 后续阶段需参照 /zt-story-expand 模式补上传接口(记入后续计划,不在本期范围)
  • 另注:tgassist 提到的 demand-assessor 技能本机不存在(.kimi-code/skills/ 仅 tgassist),本项目自身的「工作量评估」阶段需另行处理