feat(GOV-010): 完成开发质量与架构治理

2026-08-13 23:56:21 +08:00
parent 61f85e5fa4
commit f178fb4044
15 changed files with 270 additions and 22 deletions
@@ -0,0 +1,23 @@
+# GitNexus 开发后基线
+
+- 功能编号：GOV-010
+- 完成前索引提交：`61f85e5`
+- 当前工作提交：`61f85e5`
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/13/2026, 11:46:53 PM
+Indexed commit: 61f85e5
+Current commit: 61f85e5
+Status: up-to-date
+Nodes: 1,827
+Edges: 2,502
+Clusters: 49
+Flows: 50
+```
+
+## 开发后检测
+
+`gitnexus_detect_changes(scope="compare", base_ref="1c1b15e")`：35 个文件、163 个变更符号、1 条受影响执行流，风险 MEDIUM。详细内容见 `detected-changes.md` 和 `comparison.md`。
@@ -0,0 +1,26 @@
+# GOV-010 GitNexus 计划与实际影响比较
+
+## 直接与间接影响
+
+- 计划中的治理门禁符号已实际改变：`getRequiredFeatureFiles`、`getInvalidFeatureEvidence`、`finish.mjs` 和 `start.mjs` 的测试与完成流程均通过治理测试覆盖。
+- 计划中的请求基础设施影响已实际发生：旧 `createApiClient`/`ApiRequestError` 调用方仅为旧测试；替换后的 `createRequestClient`、`ApiRequestError` 和健康 API 通过 11 项 Web 测试、类型检查、E2E 和构建验证。
+- GitNexus compare 的唯一受影响运行流为 `CreateRequestClient → ApiRequestError`，与计划一致；边界校验是开发期执行流，未进入生产运行时。
+
+## 跨模块同步修改
+
+| 领域 | 计划结论 | 实际结果 | 是否偏差 |
+|---|---|---|---|
+| HTTP/OpenAPI | 保留路由、字段和生成 Schema，仅切换浏览器执行器 | 契约生成无漂移，健康 API 使用生成 DTO，Axios 只在统一 request | 否 |
+| Web API/adapter | 新增健康域 API，保持 DTO 到 ViewModel 隔离 | `api/health/index.ts` 新增，页面仍未消费健康 API，adapter 未被无谓迁移 | 否 |
+| RocketMQ | 不修改消息契约 | 未修改 | 否 |
+| MySQL/Schema | 不修改结构，开发前基线只读开发库 | 全量 Schema 测试通过，未触碰生产库 | 否 |
+| Redis | 不修改缓存键、TTL 或连接 | 只做本机 `PONG` 健康验证，未改代码或数据 | 否 |
+| API/Scheduler/Worker | 不改变运行行为 | 后端测试和三进程构建通过，行为未改 | 否 |
+| 配置/部署 | 沿用 Web API 根地址，不改变源码部署 | 源码发布门禁通过，无 Docker 变更 | 否 |
+| 治理/边界工具 | 增加结构化证据和 HTTP 边界门禁 | 9 项治理、16 项边界测试通过 | 否 |
+| 依赖 | 移除 `openapi-fetch`，新增 Axios；补传递依赖安全修复 | Axios 1.19.0；`js-yaml` 5.2.2 override；官方 audit 0 漏洞 | 仅增加安全修复 |
+| 测试/视觉 | 完整测试、构建、E2E、双视口截图 | 全部通过，截图和无回归结论已保存 | 否 |
+
+## 风险差异
+
+相对基线 compare 输出 MEDIUM，而开发前单项影响多为 LOW/partial。差异来自新增的前端请求运行流和项目边界校验符号，不表示业务数据链路或三进程运行风险升级。复审阶段又收紧了 Review 最终结论校验，变更符号总数由 162 增至 163，仍只有同一条 `CreateRequestClient → ApiRequestError` 运行流受影响。`e992edc` 的传递依赖修复降低了安全风险，未改变 OpenAPI 或生产运行流。
@@ -0,0 +1,18 @@
+# GOV-010 GitNexus 开发后变更检测
+
+- 检测提交：`61f85e5`
+- 检测方式：重新执行 `npx gitnexus analyze` 后调用 `gitnexus_detect_changes(scope="compare", base_ref="1c1b15e")`
+- GitNexus 状态：1,827 nodes、2,502 edges、49 clusters、50 flows；索引提交与当前提交均为 `61f85e5`，状态 up-to-date。
+
+## 检测结果
+
+- 变更文件：35
+- 变更符号：163（主要为治理文档章节、治理/边界工具符号及 Axios 请求测试/实现符号）
+- 受影响执行流：1
+- 风险：MEDIUM
+
+受影响执行流为 `CreateRequestClient → ApiRequestError`，包含 `createRequestClient`、`toApiRequestError` 和 `ApiRequestError` 三步。它是本次 Axios 请求层迁移的预期运行时边界，已由 Web 单元测试、类型检查、E2E 和构建覆盖。
+
+MEDIUM 还反映了项目边界验证流的变化：该工具增加了 Axios、fetch、业务 URL 和统一 request 的 AST 规则。它只在开发/发布门禁运行，不进入 API、Scheduler、Worker 或浏览器生产请求路径。
+
+未检测到计划外的 RocketMQ 消息消费者、MySQL/Redis 数据访问、Schema 迁移或三进程运行流变化。GitNexus 对 Markdown 文档以章节符号记录，不能替代人工阅读，因此同步修改结论在 `comparison.md` 和 Review 中重复核对。