a-share-analysis/docs/features/GOV-009-application-scaffold-baseline/gitnexus/impact-plan.md

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 操作修改。