feat: 根目录文档、脚本、gitignore

2026-10-08 16:15:33 +08:00
commit e98660ce4e
284 changed files with 26838 additions and 0 deletions
@@ -0,0 +1,41 @@
+# 验收标准（草案 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），本项目自身的「工作量评估」阶段需另行处理
@@ -0,0 +1,16 @@
+# 验收检查清单（对应 acceptance.md v1）
+
+## DoD 检查项
+
+- [ ] AC-1 `zt_ai_code_review` 表 DDL（含变更说明头，字段覆盖：需求关联、审查事项、审查结果、通过标志、审查时间）
+- [ ] AC-1 `zt_ai_work_log` 表 DDL（日志类型枚举覆盖 SRC-001 全部 8 类）
+- [ ] AC-1 `zt_story_extend` AI 参与率字段 DDL
+- [ ] AC-1 任务级 AI 工作量指数字段 DDL
+- [ ] AC-2 新实体/Mapper/Service 按规范生成，项目编译通过
+- [ ] AC-3 SRC-001 数据项映射表归档（复用项字段名逐一核对）
+- [ ] AC-4 新增 Service 单测通过（正常 + 异常/边界），结果记录至 05_delivery/dev_log.md
+- [ ] AC-5 现有编译/测试无回归
+
+## 签字确认
+
+- [x] 用户确认验收标准（本文件与 acceptance.md）— 2026-07-22 确认 v2