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

2026-10-08 16:15:33 +08:00
commit e98660ce4e
284 changed files with 26838 additions and 0 deletions
@@ -0,0 +1,34 @@
+# Council 决策记录（关键决策留痕）
+
+> 摘自 PRD 变更记录 + decision_log.md，按决策主题归并。
+
+## D-01 AI 文档承载方式
+**决策**：MD 文件流，不建 zt_ai_code_review / zt_ai_work_log 结构化表。
+**理由**：不建表、人可直接阅读、上传即看；结构化弱点由 MD 头部约定补偿。
+**决策人**：用户（CHG-014 拍板）。
+
+## D-02 任务级 AI 数据承载
+**决策**：砍 zt_task_extend；AI 工时入 zt_task.estimate；任务级指数豁免。
+**理由**：evaluation_time 与 estimate 冗余；指数无消费方；一期缩至 1 列（W 10.2→3.2）。
+**决策人**：用户（CHG-019 拍板）。
+
+## D-03 禅道核心表加列破例
+**决策**：zt_story 加 8 列（7 url + code_review_status）；zt_file/zt_meeting 各加 url。
+**理由**：各存最新一份的访问需求直取优先；用户明确拍板接受破例。
+**决策人**：用户（CHG-018/020/021/022/023/025）。
+
+## D-04 任务提交双通道
+**决策**：AI 框架批量（aiBatchAdd）+ 人工创建保留；AI 任务创建人=ai 专用账户；初始状态 wait 走现有任务流程。
+**决策人**：用户（CHG-006/007）。
+
+## D-05 上传接口鉴权
+**决策**：二期必决项；落地为内部 token（saveOrUpdate/aiBatchAdd 限 ai，uploadBind 需登录），创建人取 token 身份。
+**决策人**：用户（v1.10 升级 + CHG-061 落地）。
+
+## D-06 原型暂缓
+**决策**：原型与移动端暂缓（skip_flags.prototype=true）。
+**决策人**：用户（2026-07-23）。
+
+## D-07 普通/重大 Bug 分级
+**决策**：severity 1=重大、2/3/4=普通，以老弹窗 getBugFindScore 为准；撤销 07-28 锁定的 1~2=重大。
+**决策人**：用户（2026-08-04）。
@@ -0,0 +1,25 @@
+# Council 评审记录（回溯）
+
+> ⚠️ 本工作区为 **2026-10-08 回溯归档**，以下评审结论由 pmassist 会话记录回溯认定，
+> 非 tgassist 实时门禁产物。
+
+## 评审结论
+
+| 项 | 结论 | 依据 |
+|---|---|---|
+| 需求合理性 | ✅ 通过 | SOP 符合性核查（v1.8）：18 步流程、6 类数据、8 项动作全有落点 |
+| 架构取舍 | ✅ 通过 | 扩展表 + MD 文件流方案经 4 方案对比（5.5），用户拍板 |
+| 证据充分性 | ✅ 通过（代码级） | PRD 12 章证据映射：全部 [ZT:...] 行号级引用，2026-07-22 两轮摸底 |
+| 安全合规 | ⚠️ 有条件通过 | R-003 上传接口鉴权列为二期必决项 → CHG-061 已兑现，转通过 |
+| 可验收性 | ✅ 通过 | 33 AC 覆盖 14/14 FR；含幂等/防重/对拍/判定源正确性验证点 |
+
+## 评审过程事实
+
+- 评审形式：用户逐轮质询 AI（summary.md「审查迭代」段），单日 25 版 PRD 迭代
+- 拍板事项全部留痕于 PRD 变更记录（CHG-014 MD 流 / CHG-019 砍表 / CHG-021~025 zt_story 8 列）
+- 对外交付评审：2026-08-07 用户拍板接口文档对外发布（Word 版）
+
+## 遗留评审意见
+
+1. 页面级验收需补截图证据（G2 门禁不能完全关闭）
+2. 三期开工前须完成 R-004 考核公式逐 sheet 核对（与 IT 经理）