Files
zentao-flow/tmp/withdrawn-tgassist-session/zentao-20260722-1638/04_design/data_model.md
T

54 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 数据模型设计(一期 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 侧枚举,不落库表)。