10 KiB
项目全面审计 - 文档索引
HISTORICAL（2026-09-12 初审快照）
当前发布/缺口 SSOT → ../remediation/gap-matrix.md
协作焦点 → ../ops/CURRENT.md
Agent 工作方式 → AGENTS.md · PROJECT.md
审计日期: 2026-09-12
项目: Chat-Agent-System
审计状态: 历史索引（下方 5.7/10 为初审结论，勿作 live status）
核心文档（按阅读顺序推荐）
最新专项审计（2026-09-13）
文件: 2026-09-13-conversation-intent-runtime-state.md
结论: 真实会话被诊断探针污染；客户端名词匹配令只读总结请求误启动写任务；错误动作与文档租约状态刷新后无法恢复。
刷新历史专项审计（2026-09-13）
文件: 2026-09-13-chat-history-refresh-disappears.md
结论: 消息仍在数据库；文档任务与激活前消息缺阶段作用域，被刷新后的窗口过滤器剔除，而统计仍返回未过滤数量。
0️⃣ 当前状态（Live SSOT）
文件: gap-matrix.md
协作: CURRENT.md · AGENTS.md · PROJECT.md
用途: 发布缺口、Codex 再审计闭环证据、发布门禁勾选
1️⃣ 从这里开始：审计总结报告（历史）
文件: 2026-09-12-audit-summary-report.md
用途: 项目整体现状、关键数字、风险评估
适合: 项目经理、技术负责人、快速概览
阅读时间: 15-20 分钟
关键内容:
- 项目评分及各维度打分
- 12 个已确认缺陷分布（critical/high/medium）
- 未完成功能清单
- 开发库数据污染现状（88 个测试定义）
- 整改时间与资源规划
- 立即行动建议
2️⃣ 详细缺陷与整改：综合整改方案
文件: 2026-09-12-comprehensive-audit-and-remediation-plan.md
用途: 12 个缺陷的详细分析 + 3 个新功能的整改方案
适合: 架构师、资深开发工程师
阅读时间: 45-60 分钟
关键内容:
- BUG-01 到 BUG-12 的代码现场与后果分析
- 5 个 high 缺陷的深层原因
- 3 个 MISSING 新功能的实现设计
- 3 个 Phase (A/B/C) 的整改计划
- 风险预案与建议
3️⃣ 可执行的任务拆分：任务清单与验收
文件: 2026-09-12-remediation-tasks-and-acceptance-checklist.md
用途: 具体的代码修改指引、单元测试框架、验收标准
适合: 开发工程师、QA、代码审查人
阅读时间: 60-90 分钟
关键内容:
- Task A1-A6：关键缺陷修复（15h）
- 每个 Task 的修改文件、代码片段、测试用例
- 验收标准与预计工作量
- Task B1-B3：高优先级新功能（26h）
- 受控终止 API 的完整实现
- E2E 测试框架与运行命令
- 项目上下文快照的数据模型与集成点
- Task C1-C7：完善与发布（20h）
- 全套验收检查表
4️⃣ 快速参考与速查：快速指南
文件: 2026-09-12-quick-reference-guide.md
用途: 问题症状→原因→解决方案的快速诊断
适合: 所有开发人员、值班人员
阅读时间: 5-10 分钟（按需查阅）
关键内容:
- 10 个常见症状的诊断矩阵
- 代码热点地图（哪个文件有哪个 bug）
- 整改优先级排序
- 代码修改检查清单
- 数据库迁移清单
- 测试命令参考
- API 变动汇总
- 常见问题 Q&A
配套参考文档
业务需求原文
文件: 2026-09-12-three-workflows-strict-governance-remediation.md
用途: 业务决策、验收标准的原始出处
适合: 产品、架构、QA（需要理解业务背景）
关键章节:
- 第 3 章：不可违反的业务规则
- 第 7 章：验收标准（7.1-7.5）
- 第 8-9 章：已确认决策与实施解释
快速导航
我是 PM/项目经理
1. 读 audit-summary-report.md 第一部分（总体评估）
2. 重点关注第九章（建议行动计划）
3. 查阅 quick-reference-guide.md 第三部分（优先级排序）
4. 预估资源与时间
我是后端开发
1. 读 quick-reference-guide.md（快速了解要改什么）
2. 针对每个 task 查阅 remediation-tasks-and-acceptance-checklist.md
3. 参考 comprehensive-audit-and-remediation-plan.md 理解原因
4. 按照 task 中的"修改文件"和"代码片段"进行开发
5. 执行"测试用例"部分验证修改
我是 QA/测试工程师
1. 读 audit-summary-report.md 第十一章（验收标准清单）
2. 查阅 quick-reference-guide.md 第五部分（检查清单）
3. 针对每个 task 制定测试计划
4. 执行 comprehensive-audit-and-remediation-plan.md 中的验收标准
5. 特别关注 remediation-tasks 的 E2E 部分
我是前端工程师
1. 读 quick-reference-guide.md 第三部分（了解哪些前端需改）
2. 查看 BUG-09、BUG-10、BUG-12 的具体改动
3. 关注 comprehensive-audit 中的前端相关缺陷
4. 参考 remediation-tasks 的 API 变动部分
我是架构师/技术负责人
1. 读 audit-summary-report.md（整体判定）
2. 深入 comprehensive-audit-and-remediation-plan.md（详细分析）
3. 关注第八章（架构建议）和第十二章（结语）
4. 制定整改计划和资源分配
我要处理现场问题
1. 查询 quick-reference-guide.md 第五部分（症状→原因→解决）
2. 找到对应的 bug 号
3. 查阅 comprehensive-audit 的完整分析
4. 按照 remediation-tasks 中的修复步骤操作
5. 若需临时绕过，参考 quick-reference-guide 的建议
文档关系图
入口文档
↓
audit-summary-report.md ← 总体评估与建议
↓
├→ comprehensive-audit-and-remediation-plan.md ← 详细缺陷分析
│ ├─ BUG-01 到 BUG-12 详解
│ ├─ MISSING-01 到 MISSING-04 详解
│ └─ Phase A/B/C 整改计划
│
├→ remediation-tasks-and-acceptance-checklist.md ← 可执行任务
│ ├─ Task A1-A6（关键缺陷）
│ ├─ Task B1-B3（新功能）
│ └─ 验收检查表
│
├→ quick-reference-guide.md ← 快速查询
│ ├─ 症状诊断矩阵
│ ├─ 代码热点地图
│ ├─ 优先级排序
│ └─ 常见问题 Q&A
│
└→ three-workflows-strict-governance-remediation.md ← 业务背景
├─ 业务需求与决策
├─ 验收标准
└─ 来源证据
关键指标速查
| 指标 | 数值 | 位置 |
|---|---|---|
| 项目完成度 | 70% | audit-summary-report.md:1.2 |
| 总体评分 | 5.7/10 | audit-summary-report.md:1.1 |
| 缺陷总数 | 12 个 | audit-summary-report.md:2.1 |
| Critical 缺陷 | 3 个 | audit-summary-report.md:2.1 |
| 整改工作量 | 61h | audit-summary-report.md:9.1 |
| 单元测试覆盖率 | 85% | audit-summary-report.md:1.2 |
| E2E 覆盖率 | 0% | audit-summary-report.md:1.2 |
| 开发库污染定义 | 88 个 | audit-summary-report.md:4.1 |
立即行动清单
今天需要做的事（第一天）：
[ ] 技术负责人读 audit-summary-report.md（20 分钟）
[ ] 架构师读 comprehensive-audit-and-remediation-plan.md（60 分钟）
[ ] 后端 A 开发师启动 Task A1（2h）- 项目生命周期修复
[ ] 后端 A 开发师启动 Task A4（2h）- 对话推进新服务
[ ] QA 准备 E2E 测试框架（同步进行）
[ ] 全队讨论确认整改计划（30 分钟）
本周目标（5 天）：
Day 1: 完成 Phase A 关键缺陷修复（15h）
Day 2-3: 启动 Phase B 新功能开发并行（26h）
Day 4-5: Phase C 完善与发布准备（20h）
+ 每晚运行完整测试套件验证
常见路径快查
"完成工作流后项目仍然是 active"
→ quick-reference-guide.md 第二部分 症状 1
→ comprehensive-audit 第二部分 BUG-01
→ remediation-tasks 的 Task A1
"对话推进不起作用"
→ quick-reference-guide.md 第二部分 症状 3
→ comprehensive-audit 第二部分 BUG-04
→ remediation-tasks 的 Task A4
"禁用文档仍能被打开"
→ quick-reference-guide.md 第二部分 症状 2
→ comprehensive-audit 第二部分 BUG-05
→ remediation-tasks 的 Task A5
"激活 token 可能被重复使用"
→ quick-reference-guide.md 第二部分 症状 6
→ comprehensive-audit 第二部分 BUG-06
→ remediation-tasks 的 Task A6
"无法运行测试流程"
→ quick-reference-guide.md 第二部分 症状 7
→ comprehensive-audit 第三部分 MISSING-06
→ remediation-tasks 的 Phase B 开始
"需要完整 E2E 验证"
→ comprehensive-audit 第三部分 MISSING-04
→ remediation-tasks 的 Task B2
发布检查清单
上线前必须确认:
整改完成度:
□ Phase A 全部 PASS
□ Phase B 全部 PASS
□ Phase C 全部 PASS
测试覆盖:
□ 单元测试覆盖率 ≥ 85%
□ E2E 测试三工作流完整链路
□ 并发测试通过
□ 数据库迁移兼容性验证
业务验收:
□ 验收标准 7.1-7.5 全部满足
□ 不存在 critical 缺陷
□ 安全性审计通过
运维就绪:
□ 数据库备份与恢复方案
□ 审计日志完整
□ 监控告警配置
□ 性能基准测试
文档维护
这套审计文档为 v1.0，应定期更新：
- 每完成一个 task: 更新对应 task 的状态
- 每发现新缺陷: 补充到 comprehensive-audit-and-remediation-plan.md
- 每月: 做一次整体进度评估和文档更新
审计完毕
下一步: 确认整改计划，进入实施阶段
总体建议: 立即启动 Phase A（关键缺陷），并行启动 E2E 测试框架，一周内完成所有整改。
本索引最后更新于 2026-09-12 15:05 UTC