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

2026-10-08 16:15:33 +08:00
commit e98660ce4e
284 changed files with 26838 additions and 0 deletions
@@ -0,0 +1,38 @@
+# 数据模型
+
+> 摘自 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