docs(GOV-009): 封存 GOV-009 与 GOV-010 架构基线

2026-08-17 16:27:37 +08:00
parent 4971077d3b
commit 9e85809096
23 changed files with 220 additions and 23 deletions
@@ -24,3 +24,11 @@ Review 整改前对具体符号分别执行上游影响分析：三进程 bootst
 开发前对 `assertImmutableImageReferences`、旧 Docker 辅助函数和 `forwardSignal` 的上游影响均为 LOW，0 条业务执行流受影响。最终 compare 的 MEDIUM 来自部署门禁整体替换：旧 Docker 验证删除，源码发布与 Redis 预检新增，并非应用业务依赖扩散。

 Review 中 `verifySourceDeployment` 和 `assertDockerArtifactsAbsent` 的影响分析均为 LOW；后者只影响 1 条源码部署校验流程。递归活动资产扫描与 systemd 正式目标名测试完成后，部署 6/6、环境 10/10 和完整 `verify:release` 通过。
+
+## v0.0.8 发布封存检测
+
+- 检测日期：2026-08-17
+- 检测命令：`npx gitnexus detect-changes --repo a-share-analysis`
+- 结果：22 个已索引文档/版本文件、55 个文档符号、0 条受影响执行流，风险 LOW。
+
+本次变化只封存用户确认、版本状态、独立开发总结、安全/性能证据和 Review，不修改运行时代码。逐项核对确认 HTTP/OpenAPI、Web API、消息、数据库、Redis、API、Scheduler、Worker 与源码部署无需代码同步；CHANGELOG、manifest、发布说明和回退说明已同步。
@@ -34,6 +34,21 @@

 GitNexus 查询未找到 Vue、NestJS、API、Scheduler 或 Worker 的既有运行符号，证明当前只有文档和治理工具。新增工程不会破坏已有应用调用方，但会建立新的构建、配置、HTTP 和进程启动流程，开发后必须重新索引并逐项核对。

+## 直接与间接影响
+
+- `assertSafeDevelopmentConfiguration` 为 CRITICAL：4 个直接调用方、9 个间接符号和 5 组流程，影响 Schema 生成、已发布基线校验与 `governance:start`。
+- `resolveFixedDevelopmentEnv` 为 HIGH：2 个直接调用方、7 个间接符号和 3 组流程，影响开发配置解析和当前发布基线验证。
+- 新增 Web、API、Scheduler、Worker 在开发前没有既有调用方，但会新增构建、启动、OpenAPI、生命周期和部署流程；开发后必须用 detect-changes 与 compare 核对实际边界。
+
+## 跨模块同步修改
+
+- HTTP/OpenAPI：新增 Server DTO、OpenAPI 输出、Web 生成类型和漂移门禁；Web 不直接依赖 Server 源码。
+- Web API：建立生成契约与 adapter 边界；后续 GOV-010 再统一为 Axios request 与业务域 API。
+- 消息：建立 RocketMQ 信封和禁用 Adapter，不创建 Topic 或启用真实收发。
+- 数据库与 Redis：同步 MySQL 5.7.42、字符规则、开发 Schema 安全边界和只读健康检查，不实施业务迁移或缓存写入。
+- API/Scheduler/Worker：同步三进程入口、最小配置、持续运行和优雅退出验证。
+- 部署、测试与文档：同步环境模板、systemd/Nginx、源码发布门禁、Playwright、Review、回退和架构复核；早期 Docker 方案后来由仅源码部署设计取代。
+
 ## 风险控制

 1. Schema 变更先写失败测试，覆盖固定远程白名单、未知远程拒绝、`api.env.local` 优先级、历史 N/A 基线验证和空库 captured 状态。