# 数据模型

> 摘自 PRD 5.4 字段表 + 7.1 一期 DDL。完整口径见 prd_final.md 第 7 章。

## 一期 DDL（已交付）

```sql
ALTER TABLE `zt_story_expand`
  ADD COLUMN `ai_participation_rate` VARCHAR(16) DEFAULT NULL
  COMMENT 'AI参与率（只存不算，口径待定）' AFTER `ai_efficiency_coefficient`;
```

## 二期 DDL/字段（已设计，随版本交付）

| 字段 | 表 | 类型 | 说明 | 决策 |
|---|---|---|---|---|
| url | zt_file | varchar(512) | 附件访问链接（pathname=存储路径，url=可访问地址） | CHG-018 |
| url | zt_meeting | varchar(512) | 会议纪要 MD 链接，存最新一份 | CHG-020 |
| prd_url / code_review_url / work_log_url / test_case_url / test_report_download_url / test_report_submit_url / test_other_url | zt_story | varchar(512)×7 | 研发需求 7 类文档链接，各存最新一份 | CHG-021/022/025 用户拍板 |
| code_review_status | zt_story | varchar(16) | pass/reject/NULL；上传时解析写入 | CHG-023 |

## FileTypes 枚举扩展

aiCodeReview / aiWorkLog / testCase（下载）/ testReport（供下载）/ testReportSubmit（提交）/ testOther

## 已否决的表（决策留痕）

| 表 | 否决原因 | 决策 |
|---|---|---|
| zt_ai_code_review / zt_ai_work_log | MD 文件流替代 | CHG-014 |
| zt_task_extend | evaluation_time 与 zt_task.estimate 冗余；指数无消费方 | CHG-019 |

## 关键口径（7.3 节选）

- 大型需求判定：workloadIndex > 20 → 五类文档强制
- 月度达标工时 =（工作天数×人数 − 团队请假天数）×5÷人数（CHG-034 全团队平摊）
- 普通/重大 Bug：severity 1=重大、2/3/4=普通（2026-08-04 已决）
- 待确认 5 项见 03_plan/risks.md