518 lines
23 KiB
Markdown
518 lines
23 KiB
Markdown
# 项目全面审计 - 文档索引
|
||
|
||
> **HISTORICAL(2026-09-12 初审快照)**
|
||
> **当前发布/缺口 SSOT** → [../remediation/gap-matrix.md](../remediation/gap-matrix.md)
|
||
> **协作焦点** → [../ops/CURRENT.md](../ops/CURRENT.md)
|
||
> **Agent 工作方式** → [AGENTS.md](../../AGENTS.md) · [PROJECT.md](../../PROJECT.md)
|
||
|
||
**审计日期**: 2026-09-12
|
||
**项目**: Chat-Agent-System
|
||
**审计状态**: 历史索引(下方 5.7/10 为初审结论,勿作 live status)
|
||
|
||
---
|
||
|
||
## 核心文档(按阅读顺序推荐)
|
||
|
||
### 系统全面 Code Review(2026-09-26)
|
||
|
||
**文件**: [2026-09-26-system-code-review.md](./2026-09-26-system-code-review.md)
|
||
|
||
**结论**: tip `f4c1b73f` 上 `arch-check --mode block` PASS,但存在已证实会话上下文 IDOR、arch-check 未登记表静默跳过、Authorizer 无池 fail-open、swboot `sh -c` 前缀白名单、intentflow `proposed` 可 Confirm 升 dispatch 等 critical/high 项;FAV outbox 禁用路径未见旁路。**本轮不实施修复**。
|
||
|
||
**任务**: [short-term](../ops/short-term/2026-09-26-system-code-review.md) · mutex `docs-audit-review`
|
||
|
||
### 对话办公能力全景盘点(2026-09-25)
|
||
|
||
**文件**: [2026-09-25-dialogue-office-capability-research.md](./2026-09-25-dialogue-office-capability-research.md)
|
||
|
||
**结论**: 32 ActionKey 双轨脱节(主链假成功 vs intentflow 部分 live);HTTP 169 = A46/B66/C44+基线13;治理结构写永久 UI 专属。整改见 P0–P3 计划。
|
||
|
||
**整改**: [对话办公扩展计划](../remediation/2026-09-25-dialogue-office-expansion-plan.md) · task `dialogue-office-expansion-2026-09-25`
|
||
|
||
### 模块化重构方案审核检查清单(2026-09-23)
|
||
|
||
**文件**: [2026-09-23-modular-refactor-plan-review-checklist.md](./2026-09-23-modular-refactor-plan-review-checklist.md)
|
||
|
||
**结论**: 产物机器方案(`modular-contract-standard-2026-09-22`)本机不可见;本清单按已生效模块开发规范与 A–G/验证契约,覆盖阶段 1、阶段 2 与取消状态契约自查项,并留「22 条规范」映射回填。不实施业务代码。
|
||
|
||
**任务**: [short-term](../ops/short-term/2026-09-23-modular-refactor-review.md)
|
||
|
||
### 模块耦合现状(2026-09-20)
|
||
|
||
**文件**: [2026-09-20-module-coupling-audit.md](./2026-09-20-module-coupling-audit.md)
|
||
|
||
**结论**: 模块化单体与事件总线已在;残留扩散点是 server 具体类型装配、chat/app/coordinator 逻辑环、docgov 词汇泄漏,以及 2026-09-28 到期的 sql_write/path 例外。不改 `production_ready`。
|
||
|
||
**整改**: [分批计划](../remediation/2026-09-20-module-decoupling-batch-plan.md) · [开发规范](../system-design/2026-09-20-module-development-standards.md)
|
||
|
||
### 系统全量体检(2026-09-20)
|
||
|
||
**文件**: [2026-09-20-system-triage-audit.md](./2026-09-20-system-triage-audit.md)
|
||
|
||
**结论**: 迁移 00054 断链 + 三项 IDOR + taskrun channel panic + 凭证硬编码/暴露为 P0;main 分支与生产 schema 脱节记 backlog。
|
||
|
||
**整改**: [P0 热修方案](../remediation/2026-09-20-p0-remediation-plan.md) · [short-term](../ops/short-term/2026-09-20-p0-hotfixes.md)
|
||
|
||
### 可选职责空审核人 CreateOrGetDocument FK(2026-09-17)
|
||
|
||
**文件**: [2026-09-17-docgov-optional-duty-null-fk.md](./2026-09-17-docgov-optional-duty-null-fk.md)
|
||
|
||
**结论**: 无 reviewer 职责时 `CreateOrGetDocument` 写 `reviewer_id=0` 触发 FK,被 `ClassifyError` 掩盖为 `INTERNAL_ERROR`;heal 路径已有 `nullIfZero`,创建路径漏改。
|
||
|
||
**整改**: [short-term](../archive/ops/2026-09-17-docgov-optional-duty-null-fk.md) · branch `fix/docgov-optional-duty-null-fk`
|
||
|
||
### FEATURE-MATRIX production-ready 连续性审计(2026-09-16)
|
||
|
||
**文件**: [2026-09-16-feature-matrix-production-readiness-audit.md](./2026-09-16-feature-matrix-production-readiness-audit.md)
|
||
|
||
**结论**: 排除纯软件项目自举后没有新增发布 blocker;矩阵需要拆分能力成熟度、发布关系、补证、增强和 deferred 状态,并修复 schema、D3/D5、IAM、前端与 FAV 叙事漂移。
|
||
|
||
**整改**: [FEATURE-MATRIX Production-Ready Continuity - Plan](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md)
|
||
|
||
### 多意图与 HITL 方案复核(2026-09-15)
|
||
|
||
**文件**: [2026-09-15-multi-intent-hitl-plan-review.md](./2026-09-15-multi-intent-hitl-plan-review.md)
|
||
|
||
**结论**: 多意图方向可行,但必须以 `app/intentflow` 深模块、PG 权威状态机、逐动作即时授权和分波 mutex 防止 intent/coordinator 再耦合;确认、卡片和 SSE 均不能替代授权或权威状态。
|
||
|
||
**设计/计划**: [多意图持久计划与 HITL](../system-design/2026-09-15-multi-intent-hitl-plan.md) · [核心 U1–U8 与扩面 U9–U12](../ops/short-term/2026-09-15-multi-intent-hitl.md)
|
||
|
||
|
||
### 模块解耦 Phase 2 方案复核(2026-09-15)
|
||
|
||
**文件**: [2026-09-15-module-decoupling-phase2-plan-review.md](./2026-09-15-module-decoupling-phase2-plan-review.md)
|
||
|
||
**结论**: PG delivery 尚未形成生产闭环;原计划把事件、结构和协议三轨绑成一次交付,并误判 docgov/docrevision 依赖方向。修订版先完成事件生产与历史数据门,再以 PG dispatcher、逐消费者 shadow 和真实刷新/重启恢复收口。
|
||
|
||
**整改**: [Phase 2 持久事件交付与后续解耦路线](../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md)
|
||
|
||
|
||
### arch-check U1 可重放基线(2026-09-14)
|
||
|
||
**文件**: [2026-09-14-arch-check-baseline.md](./2026-09-14-arch-check-baseline.md)
|
||
|
||
**结论**: 四类规则(production import / SQL write / path / event)可重放。import=0,sql_write=5,path=17,event=0。Goose 与测试不计生产写者。新违规与过期例外立即 block。
|
||
|
||
### 模块解耦方案复核(2026-09-14)
|
||
|
||
**文件**: [2026-09-14-module-decoupling-plan-review.md](./2026-09-14-module-decoupling-plan-review.md)
|
||
|
||
**结论**: 模块化单体方向成立,但原横向 Wave 缺少跨属主事务、可靠事件、多副本互斥、逐动作授权和 FAV 边界;应先完成受控文档可靠性纵向试点,再按证据扩面。
|
||
|
||
**整改**: [模块解耦与文档可靠性重构计划](../remediation/2026-09-14-module-decoupling-refactor-plan.md)
|
||
|
||
### 项目 143 workflow-plan 409 与三权全有或全无(2026-09-14)
|
||
|
||
**文件**: [2026-09-14-workflow-plan-409-frozen-and-optional-duties.md](./2026-09-14-workflow-plan-409-frozen-and-optional-duties.md)
|
||
|
||
**结论**: 项目 143 已于 2026-09-13 激活 main 工作流(实例 89),`SaveWorkflowPlan` 因 `lifecycle=active` 返回 409 `PLAN_FROZEN`;前端无冻结守卫、错误提示在视口外,表现为「校验并预览无反应」。按文档支持三权全有或全无,但全空仅用于定义允许裁剪的非必需文档,表示“不纳入人工审批”而非“非受控”;必需文档和零治理激活不得被绕过。
|
||
|
||
**整改**: [workflow-plan 409 + 三权全有或全无整改](../remediation/2026-09-14-workflow-plan-409-frozen-and-optional-duties-remediation.md)
|
||
|
||
### 项目 143 受控正文 canonical hash 漂移(2026-09-14)
|
||
|
||
**文件**: [2026-09-14-project143-controlled-content-404.md](./2026-09-14-project143-controlled-content-404.md)
|
||
|
||
**结论**: 正文文件存在;revision bootstrap 去掉 5 行具有 Markdown 硬换行语义的双空格并把 canonical SHA 写入账本/DocGov,却未同步文件,正文读取将哈希冲突误报为 404;5 秒 lease no-op 更新又周期性重复 hydration。原文件必须保全,不能用旧 canonical blob 覆盖。
|
||
|
||
**整改**: [canonical hash 漂移整改计划](../remediation/2026-09-14-controlled-content-canonical-hash-remediation.md)
|
||
|
||
### 文档版本账本运行时失效(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-document-revision-runtime-404.md](./2026-09-13-document-revision-runtime-404.md)
|
||
|
||
**结论**: 原现场 404(账本仅内存、GET 无 bootstrap、freeform 跳过 PATCH、overlay 空壳、静态假 JSON)已在工程侧修复;**Round20 真实 UI PASS**(项目 6159,V3/r2)。change report 仍为 fallback,不冒充 PI 叙事。
|
||
|
||
**整改**: [运行时整改方案](../remediation/2026-09-13-document-revision-runtime-remediation.md) · [short-term](../archive/ops/2026-09-13-document-revision-runtime.md) · [Round20 报告](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md)
|
||
|
||
### 文档修改与智能体版本专项分析(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-document-revision-management-gap-analysis.md](./2026-09-13-document-revision-management-gap-analysis.md)
|
||
|
||
**结论**: 现有受控文档只有当前工作区正文和哈希,缺少不可变快照、智能体版本边界、人工修订差异、实际变更报告和负责人通知;前端块编辑尚未持久化。
|
||
|
||
**设计/整改**: [系统设计](../system-design/document-revision-management.md) · [实施方案](../remediation/2026-09-13-document-revision-management-implementation-plan.md)
|
||
|
||
### 最新专项审计(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-document-revision-pg-id-remap.md](./2026-09-13-document-revision-pg-id-remap.md)
|
||
|
||
**结论**: 项目 6158 首次生成 PG 已写入 baseline snapshot=249、candidate id=175、output snapshot id=250、report id=175,但内存计数器未同步,临时 ID 覆盖并删除 baseline,commit `not found`。工程修复已合入;Round20 项目 6159 首次生成 UI-03 PASS。
|
||
|
||
**整改**: [short-term](../archive/ops/2026-09-13-document-revision-pg-id-remap.md) · [Round20 报告](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md)
|
||
|
||
**文件**: [2026-09-13-document-revision-post-restart-final-snippet.md](./2026-09-13-document-revision-post-restart-final-snippet.md)
|
||
|
||
**结论**: 第二次 post-restart 已恢复 V3/r2 与正文;当时失败只因 phase-state 仍断言 UI-06 marker。Round20 `bodySnippet=A1-win-mu0gwiez`,post-restart PASS。
|
||
|
||
**整改**: [short-term](../archive/ops/2026-09-13-document-revision-post-restart-final-snippet.md) · [Round20 报告](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md)
|
||
|
||
**文件**: [2026-09-13-document-revision-post-restart-selector.md](./2026-09-13-document-revision-post-restart-selector.md)
|
||
|
||
**结论**: 第18轮 main 18 PASS;post-restart 在项目已恢复时,页面级项目名同时命中顶栏与侧栏,strict violation,未到 revision-state。
|
||
|
||
**整改**: [short-term](../archive/ops/2026-09-13-document-revision-post-restart-selector.md)
|
||
|
||
**文件**: [2026-09-13-document-revision-reviewer-duty-sync.md](./2026-09-13-document-revision-reviewer-duty-sync.md)
|
||
|
||
**结论**: 第17轮 UI-00–12 PASS;精确职责断言暴露真实缺陷——UI-01 已把 B 设为 reviewer,`doc_proj6145_*` 的 `reviewer_id` 却是硬编码 `2`,矩阵为 viewer。
|
||
|
||
**整改**: [项目 reviewer 同步整改](../remediation/2026-09-13-document-revision-reviewer-duty-sync.md)
|
||
|
||
### UI-13a 职责单元格误判(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-document-revision-duty-cell-assertion.md](./2026-09-13-document-revision-duty-cell-assertion.md)
|
||
|
||
**结论**: 第16轮 UI-13a 已打开 reviewer B 权限矩阵;整行 `innerText` 含全部 select option,误命中「编制负责人」。须读 select value / badge role。
|
||
|
||
**整改**: [职责单元格精确断言整改](../remediation/2026-09-13-document-revision-duty-cell-assertion.md)
|
||
|
||
### 受控文档分类导航(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-document-revision-workflow-category-navigation.md](./2026-09-13-document-revision-workflow-category-navigation.md)
|
||
|
||
**结论**: 第15轮 UI-00–12 PASS;UI-13a 在私密分类下直接展开文档菜单,找不到 `doc_proj*_intake`。须先用页面控件切到流程受控。
|
||
|
||
**整改**: [受控文档分类导航整改](../remediation/2026-09-13-document-revision-workflow-category-navigation.md)
|
||
|
||
### UI-11 快速完成观测(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-document-revision-fast-completion-observation.md](./2026-09-13-document-revision-fast-completion-observation.md)
|
||
|
||
**结论**: 第14轮 UI-11 上传归档后助手已 `completed`;验收默认硬等 inflight 60s,把成功终态误判为失败。
|
||
|
||
**整改**: [快速完成观测契约整改](../remediation/2026-09-13-document-revision-fast-completion-observation.md)
|
||
|
||
### 质量修复子工作区契约(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-document-revision-quality-repair-workspace-contract.md](./2026-09-13-document-revision-quality-repair-workspace-contract.md)
|
||
|
||
**结论**: 第13轮 UI-03 质量门禁正确判缺「阻塞信息/非阻塞信息」;repair TASK 引导 `../../output.md`,模型越界改根文件,本地目标缺失,manifest 停在 70。
|
||
|
||
**整改**: [质量修复子工作区契约整改](../remediation/2026-09-13-document-revision-quality-repair-workspace-contract.md)
|
||
|
||
### 编辑弹窗 hydration 竞态(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-document-revision-editor-hydration-race.md](./2026-09-13-document-revision-editor-hydration-race.md)
|
||
|
||
**结论**: 第十二轮 UI-06 在 fill 窗口完成后台 hydration,块 ID 被重建;保存按旧 ID 找不到目标后静默关窗,未发 PATCH,修订停在 r0。
|
||
|
||
**整改**: [编辑弹窗 hydration 竞态整改](../remediation/2026-09-13-document-revision-editor-hydration-race.md)
|
||
|
||
### 对话意图运行时审计(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-conversation-intent-runtime-state.md](./2026-09-13-conversation-intent-runtime-state.md)
|
||
|
||
**结论**: 真实会话被诊断探针污染;客户端名词匹配令只读总结请求误启动写任务;错误动作与文档租约状态刷新后无法恢复。
|
||
|
||
**整改**: [对话意图、可恢复任务状态与文档占用可见性整改](../remediation/2026-09-13-conversation-intent-runtime-state-remediation.md)
|
||
|
||
### 刷新历史专项审计(2026-09-13)
|
||
|
||
**文件**: [2026-09-13-chat-history-refresh-disappears.md](./2026-09-13-chat-history-refresh-disappears.md)
|
||
|
||
**结论**: 消息仍在数据库;文档任务与激活前消息缺阶段作用域,被刷新后的窗口过滤器剔除,而统计仍返回未过滤数量。
|
||
|
||
**整改**: [对话刷新恢复与阶段授权一致性整改方案](../remediation/2026-09-13-chat-history-refresh-remediation.md)(2026-09-22 口径裁定:gap `CHAT-HISTORY-REFRESH` = PASS;见 [reconcile](../ops/short-term/2026-09-22-chat-history-refresh-reconcile.md))
|
||
|
||
### 0️⃣ 当前状态(Live SSOT)
|
||
|
||
**文件**: [gap-matrix.md](../remediation/gap-matrix.md)
|
||
**协作**: [CURRENT.md](../ops/CURRENT.md) · [AGENTS.md](../../AGENTS.md) · [PROJECT.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*
|
||
|
||
- 2026-09-17:[系统全面体检](2026-09-17-system-health-check.md)(任务收口 / 缺陷 / 未启用功能;配套 [整改方案](../remediation/2026-09-17-system-health-remediation-plan.md) Wave0–7)。
|
||
- 2026-09-17:[首次加载性能诊断与改进](2026-09-17-initial-load-performance-audit.md)(三入口重启首访;U2 已验收,主 JS ~624 KB;U1/U3–U7 待实施)。
|