# GitNexus 开发前影响分析

- 功能编号：GOV-009
- 基线提交：`c04184a6111da0cfad90d1a265dc3cd3a6d90a9c`
- 分析日期：2026-08-13

## 查询范围

本功能会新增 Web、Server 和构建入口；这些文件在基线图谱中尚无符号，无法产生既有调用方。对已有代码的修改集中在 `tools/database/schema-baseline.mjs`、根工程编排、环境模板和部署配置，因此对 Schema 关键符号执行上游影响分析，并查询现有 Vue/NestJS 执行流。

## 结果

### `assertSafeDevelopmentConfiguration`

- 风险：**CRITICAL**。
- 直接影响：4 个调用方。
- 间接影响：9 个符号、5 组执行流程。
- 直接调用方：`buildMysqldumpArguments`、`runBaselineGeneration`、`assertNotApplicableMatchesDevelopmentConfiguration` 和 Schema 测试。
- 关键下游：`assertCurrentReleasedBaseline`、`assertCurrentReleasedBaselinePublished`、`runCommandLine` 与 `governance:start`。

### `resolveFixedDevelopmentEnv`

- 风险：**HIGH**。
- 直接影响：2 个调用方。
- 间接影响：7 个符号、3 组执行流程。
- 关键下游：Schema 生成、当前发布基线校验和下一功能开发前门禁。

### `buildCapturedArtifacts`

- 风险：LOW。
- 直接影响：Schema 测试；现有运行流程没有额外上游调用。

### 新增工程

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

## 风险控制

1. Schema 变更先写失败测试，覆盖固定远程白名单、未知远程拒绝、`api.env.local` 优先级、历史 N/A 基线验证和空库 captured 状态。
2. 已发布的 `v0.0.7` N/A 清单保持不可变；配置启用不得静默重写历史。GOV-009 不创建数据库对象，`v0.0.8` 发布后、下一功能开始前首次捕获空库或真实结构。
3. `governance:start` 的严格远程分支、标签和已提交基线校验必须继续通过现有测试。
4. Schema 密码只通过子进程环境传递；固定白名单写在代码中，不接受命令参数、动态 env 白名单或通配地址。
5. 新增 Server 进程分别测试配置最小权限、启动和关闭；Web 通过边界测试禁止导入 Server 源码。
6. 每个阶段运行全量 Schema 与治理回归；提交前运行 GitNexus `detect_changes`，若风险超出本报告则停止并重新确认。

## 回退

Schema 阶段可以独立回退到 GOV-009 开始提交，已发布基线目录不变。应用脚手架不执行业务迁移，回退对应提交即可移除 Web/Server 构建产物；本地 `*.env.local`、Redis 数据和远程开发库不随 Git 操作修改。