# 数据模型设计（一期 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 侧枚举，不落库表）。