docs(GOV-011): 确认系列版本约束设计

2026-08-17 17:01:39 +08:00
parent 9e85809096
commit fcfef2d524
9 changed files with 234 additions and 1 deletions
@@ -0,0 +1,29 @@
+# GitNexus 开发前基线
+
+- 功能编号：GOV-011
+- 记录时间：2026年08月17日 16:57:31 CST
+- 分支：main
+- 基线提交：`9e858090966e`
+- 创建方式：用户授权跳过 v0.0.8 Schema 备份后，按 `governance:start` 输出结构手工留痕
+
+## 工作区
+
+```text
+(干净)
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed commit: 9e85809
+Current commit: 9e85809
+Status: up-to-date
+Nodes: 1,957
+Edges: 2,634
+Flows: 50
+```
+
+## Schema 门禁例外
+
+未运行成功的原因、用户决定、禁止伪造边界和残余风险见 `../schema-baseline-waiver.md`。本记录不表示 `governance:start` 自动门禁通过。
@@ -0,0 +1,39 @@
+# GitNexus 开发前影响计划
+
+- 功能编号：GOV-011
+- 基线提交：`9e858090966e`
+- 总体风险：CRITICAL（Schema 门禁中心符号）
+
+## 直接与间接影响
+
+### `assertMysql57Metadata`
+
+- 风险：CRITICAL。
+- 直接调用方：5 个，包括 Schema 测试、captured、captured_empty、历史目录验证和基线生成。
+- 间接影响：10 个符号、5 组流程；深度 2 包含当前发布基线验证和远程发布核对，深度 3 到达 `governance:start`。
+- 控制：测试先行，系列内/外边界、历史 manifest、当前发布门禁和生成路径完整回归。
+
+### `MysqlHealthClient`
+
+- 风险：LOW。
+- 直接依赖：4 个；总计 7 个受影响符号、1 组 API 装配流程。
+- 控制：健康客户端测试覆盖实际版本详情、8.x 拒绝和字符/时区边界，API DTO 不变。
+
+### `assertSupportedRuntime`
+
+- 风险：LOW。
+- 只有运行时测试 1 个直接调用者，0 条业务流程；现有实现已按主版本 22 校验。
+- 控制：只补系列边界测试和现行文档，不改变生产判断。
+
+## 跨模块同步修改
+
+- HTTP/OpenAPI：结构不变，健康 detail 文本显示实际 5.7.x；不改 DTO。
+- Web API：无需修改，现有 adapter 透传 detail。
+- 消息、Redis、Scheduler、Worker：无影响。
+- 数据库：只调整版本判断，不改 Schema、迁移、查询或数据。
+- 配置部署：注释和前置条件改为 Node.js 22.x、MySQL 5.7.x；源码部署方式不变。
+- 测试文档：runtime、Schema、健康客户端、MySQL 规范、架构、开发规范和部署手册同步修改；历史已发布事实不改写。
+
+## 高风险处置
+
+若 Schema 历史清单验证失败、5.6/8.x 被放行、字符规则校验被绕过或 `governance:start` 相关回归失败，立即停止实施并恢复到基线提交的行为。提交前必须执行 GitNexus detect-changes 并确认实际执行流未超出本计划。