# 验收标准（草案 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），本项目自身的「工作量评估」阶段需另行处理