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

2026-10-08 16:15:33 +08:00
commit e98660ce4e
284 changed files with 26838 additions and 0 deletions
@@ -0,0 +1,53 @@
+# 数据模型设计（一期 DDL）
+
+风格约束：zt_ 前缀；审计字段沿用现有表惯例（create_user/create_time/update_user/update_time）；String 存数值沿用 zt_story_extend.workloadIndex 先例（框架传什么存什么，平台不计算）。DDL 脚本交付于 `codes/zentao/sql/`，含变更说明头。
+
+## 1. zt_ai_code_review（AI 代码审查报告）——SRC-001「审查事项、审查结果」
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | int PK AI | |
+| story_id | int NOT NULL | 关联研发需求 zt_story.id，建索引 |
+| task_id | int NULL | 可选关联任务（按任务审查时） |
+| round | int DEFAULT 1 | 审查轮次（SOP 允许打回重审） |
+| review_item | text | 审查事项（清单/JSON 文本） |
+| review_result | varchar(20) | 审查结果：pass / reject |
+| review_detail | text | 结果详情（问题列表、严重度） |
+| review_time | datetime | 审查时间 |
+| create_user / create_time / update_user / update_time | 审计字段 | |
+
+## 2. zt_ai_work_log（AI 工作日志）——SRC-001 八类日志
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | int PK AI | |
+| story_id | int NOT NULL | 关联研发需求，建索引 |
+| log_type | varchar(32) NOT NULL | 枚举：prd_version / workload_eval / arch_design / arch_review / task_split / gate_check / code_review / doc_update（与 SRC-001 思维导图 8 项一一对应），联合索引 (story_id, log_type) |
+| content | text | 日志内容（如 PRD 版本号、评估结果快照） |
+| result | varchar(255) | 结果（如评审通过/不通过） |
+| happen_time | datetime | 事件发生时间（AI 框架侧时间） |
+| create_time | datetime | 入库时间 |
+
+## 3. zt_task_extend（任务扩展表）——SRC-001「AI 评估的任务工作量指数」
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | int PK AI | |
+| task_id | int NOT NULL UNIQUE | 关联 zt_task.id |
+| ai_workload_index | varchar(16) | AI 评估任务工作量指数（只存不算，风格同 zt_story_extend.workloadIndex） |
+| evaluation_time | varchar(16) | AI 评估工时（对齐需求级字段命名） |
+| create_user / create_time / update_user / update_time | 审计字段 | |
+
+## 4. zt_story_extend 加列
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| ai_participation_rate | varchar(16) | AI 参与率（只存不算，口径由 AI 框架定，注释标「口径待定」） |
+
+## 5. 复用不改动的表（映射核对清单，AC-3）
+
+用户需求 zt_story_user（openeddate/revieweddate/activateddate*死字段二期补写）、会议 zt_meeting（result/storyIds + FileTypes.meeting）、附件 zt_file、验收标准 zt_storyspec.verify、任务工时 zt_task+zt_effort、BUG zt_bug、用例 zt_case、需求级 AI 指标 zt_story_extend。
+
+## 6. 二期预备（不进一期 DDL）
+
+FileTypes 枚举加 testReport；枚举实体 LogTypeEnums 随一期实体生成（Java 侧枚举，不落库表）。