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

2026-10-08 16:15:33 +08:00
commit e98660ce4e
284 changed files with 26838 additions and 0 deletions
@@ -0,0 +1,8 @@
+# 依赖登记
+
+| ID | 依赖 | 影响 | 状态 |
+|---|---|---|---|
+| D1 | AI 框架侧（本框架/demand-assessor）上传报文格式 | 二期接口字段需与其对齐 | 一期不阻塞；demand-assessor submit_assessment.py 报文可作参照 |
+| D2 | 生产 DB（itsm MySQL）变更窗口与备份 | M2 DDL 落库 | 待用户安排 |
+| D3 | zentao 需求单（本项目自身 W=10.2 补登用） | 仅考核记账，不阻塞开发 | 暂缓（裁剪留痕） |
+| D4 | 前端公共上传组件 src/components/upload | 二期页面改动依赖 | 已存在，34 处引用 |
@@ -0,0 +1,16 @@
+# 里程碑计划（W=10.2 作为输入，风险等级：中）
+
+## 一期（本期 MVP：数据模型落地）
+
+| 里程碑 | 内容 | 出口标准 |
+|---|---|---|
+| M1 方案冻结 | 04_design 三件套用户确认 | 设计冻结，变更走变更单 |
+| M2 DDL 就绪 | codes/zentao/sql/ 下 4 个 DDL 脚本（3 新表+1 加列），含变更说明头，可重入 | 用户评审 DDL 通过 |
+| M3 实体与单测 | 实体/Mapper/Service 生成，编译通过；新 Service 单测（正常+异常路径）全过 | AC-2/AC-4 |
+| M4 验收归档 | 映射表归档（AC-3）、无回归确认（AC-5）、dev_log 完整 | checklist 全勾，进入验收评审 |
+
+排期建议：W=10.2 人日 ≈ 1 人 2 周（含评审往返）；G(A)=1.0 的解读：安全门因测试欠账触发，单测补齐（AC-4）是本期硬要求而非可选项。
+
+## 二期（预排）：上传接口 + 展示打通（立项时重新评估 W）
+
+## 三期（预排）：绩效消费（IZtCountService 接入 AI 指标 → 9 岗位自动算分）
@@ -0,0 +1,10 @@
+# 风险登记
+
+| ID | 风险 | 等级 | 应对 |
+|---|---|---|---|
+| R1 | 无迁移工具，DDL 手工执行；zt_story_extend 生产加列 | 中 | DDL 含变更说明头+可重入；生产执行前备份+用户评审（M2 出口） |
+| R2 | 项目测试覆盖率 <20%（安全门已触发，G(A)=1.0） | 中 | AC-4 新 Service 强制单测；验收以编译+单测+映射核对为准 |
+| R3 | 上传接口无鉴权先例（saveOrUpdate 直连） | 中 | 一期无接口不触发；Q4-1 二期前决策 |
+| R4 | approveddate/activateddate 死字段（用户需求时间链断点） | 低 | 二期小改补写；本期映射表标注 |
+| R5 | /common/upload 未绑定文件 objectType=null，数据卫生 | 低 | 二期附件打通时统一绑定；本期不涉及 |
+| R6 | 一期只落模型无入口，短期"看不见成果" | 低 | 已在方案中明示分期；storyinfo AI 区块二期即有可视产出 |