feat: 根目录文档、脚本、gitignore
This commit is contained in:
@@ -0,0 +1,29 @@
|
||||
# 依赖与假设
|
||||
|
||||
> 摘自 PRD 4.3 假设与依赖 + 5.6 ID 流转约定。
|
||||
|
||||
## 依赖项
|
||||
|
||||
| 依赖 | 类型 | 状态（回填） | 负责方 |
|
||||
|---|---|---|---|
|
||||
| AI 框架上传报文格式 | 内部 | ✅ 已落地（saveOrUpdate/aiBatchAdd/uploadBind 三通道，见 04_design/interfaces.md） | AI 框架 |
|
||||
| 生产 DB 变更窗口 | 内部 | 🟡 一期 DDL 已执行；二期/三期 DDL 待窗口 | 运维 |
|
||||
| SRC-002 考核公式最终版 | 内部 | ✅ xlsx 为准 | IT 经理 |
|
||||
| zentao 需求单 ID（PRD 存档 + W 补登） | 内部 | 🔴 仍未建单（summary 遗留，阻塞 5.6 闭环展示） | 用户 + AI |
|
||||
| AI 框架侧上传挂钩（7 类） | 内部 | ✅ 已落地（summary CHG-039~061） | AI 框架 |
|
||||
| ai 永久 token | 内部 | ✅ 已生成（.claude/ai_token.txt） | Dev |
|
||||
|
||||
## 关键假设（PRD 4.3 / 11.2）
|
||||
|
||||
1. 工作量指数/AI 参与率由 AI 框架计算，zentao 只存不算
|
||||
2. 绩效数据本系统自有，不外流
|
||||
3. 禅道老表不改结构；扩展走 zt_story_expand 先例 / 用户拍板的 zt_story 加列破例
|
||||
4. 上传接口鉴权在多人环境下为必决项 → 已由 CHG-061 兑现
|
||||
|
||||
## 环境依赖
|
||||
|
||||
| 环境 | 用途 | 状态 |
|
||||
|---|---|---|
|
||||
| 8085 测试环境 | 集成验证 | ✅ CHG-061 验证通过；页面级验证待重启后补 |
|
||||
| 8086 | 鉴权矩阵实测 | ✅ 通过 |
|
||||
| 生产 itsm（https://itsm.sino-assist.com） | 正式上线 | 🟡 守卫已生效（finished 拒绝写入按设计工作） |
|
||||
@@ -0,0 +1,22 @@
|
||||
# 里程碑计划
|
||||
|
||||
> 摘自 PRD 第 10 章（prd_final.md），状态列为 2026-10-08 归档时回填。
|
||||
|
||||
| 里程碑 | 交付物 | 时间 | 负责方 | 状态（回填） |
|
||||
|---|---|---|---|---|
|
||||
| M0 需求确认 | PRD Final | 2026-07-23 定稿 | PM | ✅ 完成 |
|
||||
| M1 一期：数据模型 | zt_story_expand 加列 ai_participation_rate + 实体加字段 + 回归 | 定稿后 1~2 天 | Dev | ✅ 完成（W=3.2） |
|
||||
| M2 二期：文件流+接口+页面 | aiBatchAdd + uploadBind + FileTypes 扩展 + MD 渲染 + 页面（会议 tab/纪要 MD/需求详情区块）+ 框架挂钩 + 鉴权 | 立项时评估 | Dev | ⚠️ 主体完成，页面级验证遗留 |
|
||||
| M3 三期：绩效消费 | 完成率统计 + 9 岗位报表 | 立项时评估 | Dev | ⏳ 未开始 |
|
||||
| M4 验收 | 对照 PRD 与考核方案验收 | — | QA/IT经理 | ⏳ 未开始 |
|
||||
|
||||
## 二期实际交付明细（对照 M2 范围）
|
||||
|
||||
| 范围项 | 交付证据 |
|
||||
|---|---|
|
||||
| aiBatchAdd 任务批量提交 | CHG-061 鉴权落地，8085 实测 |
|
||||
| uploadBind + /common/upload | CHG-061 upload_md.py 直传成功，zt_file addedby=ai |
|
||||
| FileTypes 扩展（aiCodeReview/aiWorkLog/testCase/testReport/testReportSubmit/testOther） | PRD 5.4 表 |
|
||||
| 需求详情 AI 区块/会议 tab/MD 在线查看 | CHG-057（徽标撤下后页面验证遗留） |
|
||||
| 框架侧触发挂钩 | summary CHG-039~061「7 类挂钩净新增」 |
|
||||
| 鉴权（二期必决项 Q1-3） | CHG-061 内部 token，ai 永久 token 存 .claude/ai_token.txt |
|
||||
@@ -0,0 +1,31 @@
|
||||
# 风险登记册
|
||||
|
||||
> 摘自 PRD 第 9 章 + 7.3 口径待确认项 + session 未决问题，2026-10-08 归档时更新状态。
|
||||
|
||||
## 技术/项目风险（PRD 9 章）
|
||||
|
||||
| 编号 | 风险 | 等级 | 应对 | 状态（回填） |
|
||||
|---|---|---|---|---|
|
||||
| R-001 | 无迁移工具，DDL 手工执行 | 中 | DDL 可重入 + 生产执行前备份评审 | 🟡 随三期 DDL 仍有效 |
|
||||
| R-002 | 单测覆盖率<20%，回归无安全网 | 中 | 新 Service 强制单测 | 🟡 CHG-061 单测 24 绿（局部改善，整体覆盖率问题仍在） |
|
||||
| R-003 | 上传接口无鉴权 | 中 | 二期前决策：沿用/签名/JWT | ✅ 已关闭（CHG-061 内部 token 落地） |
|
||||
| R-004 | 考核公式理解偏差 | 中 | 三期前与 IT 经理逐 sheet 核对 | 🟡 未关闭，三期开工前必做 |
|
||||
| R-005 | 一期无可视成果 | 低 | 分期明示 | ✅ 已过一期 |
|
||||
|
||||
## 口径待确认（PRD 7.3，三期前必决）
|
||||
|
||||
| # | 事项 | 状态 |
|
||||
|---|---|---|
|
||||
| 1 | 总分算法（各项×权重求和为 ASSUMPTION） | 🟡 待 IT 经理确认 |
|
||||
| 2 | 线上 Bug 率单位矛盾（×100% vs ‰，按‰理解） | 🟡 待确认 |
|
||||
| 3 | 缺陷检出率申诉流程（系统只留入口） | 🟡 待确认 |
|
||||
| 4 | 普通/重大 Bug 映射 | ✅ 已决（2026-08-04：severity 1=重大、2/3/4=普通，以老弹窗 getBugFindScore 为准） |
|
||||
| 5 | zt_story_user 验收时间链断裂（ysFlag/ysDate 无写入端点） | 🟡 待二期补写或改走 zt_story |
|
||||
|
||||
## 未决问题（session.yaml 继承）
|
||||
|
||||
| ID | 优先级 | 问题 | 状态 |
|
||||
|---|---|---|---|
|
||||
| Q1-2 | P1 三期前 | 绩效与 ZtMonthScore/ZtCountController 关系（替换/并存/渐进） | 🟡 未决 |
|
||||
| Q1-3 | P1 二期前必决 | 上传接口鉴权策略 | ✅ 已由 CHG-061 落地，建议正式关闭 |
|
||||
| Q1-4 | P2 三期前 | （并入上方口径待确认） | 🟡 未决 |
|
||||
Reference in New Issue
Block a user