feat(GOV-007): 建立开发库 Schema 基线门禁

2026-08-13 12:50:37 +08:00
parent 2c502ebbec
commit da056681b6
30 changed files with 1734 additions and 18 deletions
@@ -0,0 +1,52 @@
+# GitNexus 开发后基线
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/13/2026, 12:44:53 PM
+Indexed commit: 2c502eb
+Current commit: 2c502eb
+Status: ✅ up-to-date
+```
+
+## Git 已跟踪变更摘要
+
+```text
+AGENTS.md | 2 +-
+ 1 file changed, 1 insertion(+), 1 deletion(-)
+```
+
+## Git 工作区摘要
+
+```text
+MM AGENTS.md
+M  CHANGELOG.md
+M  README.md
+M  VERSION
+M  docs/features/GOV-007-development-schema-baseline/design.md
+A  docs/features/GOV-007-development-schema-baseline/gitnexus/comparison.md
+A  docs/features/GOV-007-development-schema-baseline/gitnexus/detected-changes.md
+A  docs/features/GOV-007-development-schema-baseline/gitnexus/impact-plan.md
+A  docs/features/GOV-007-development-schema-baseline/implementation-plan.md
+A  docs/features/GOV-007-development-schema-baseline/manifest.yaml
+A  docs/features/GOV-007-development-schema-baseline/prd.md
+A  docs/features/GOV-007-development-schema-baseline/qa/test-results.md
+A  docs/features/GOV-007-development-schema-baseline/qa/visual-qa.md
+A  docs/features/GOV-007-development-schema-baseline/release-notes.md
+A  docs/features/GOV-007-development-schema-baseline/requirements.md
+A  docs/features/GOV-007-development-schema-baseline/review/code-review.md
+A  docs/features/GOV-007-development-schema-baseline/review/standards-review.md
+A  docs/features/GOV-007-development-schema-baseline/rollback.md
+A  docs/features/GOV-007-development-schema-baseline/test-plan.md
+M  docs/governance/code-development-standards.md
+M  docs/governance/development-workflow.md
+M  docs/index.md
+M  package.json
+A  tools/database/fixtures/mysql57-schema-expected.sql
+A  tools/database/fixtures/mysql57-schema-input.sql
+A  tools/database/schema-baseline.mjs
+A  tools/database/schema-baseline.test.mjs
+M  tools/governance/finish.mjs
+M  tools/governance/start.mjs
+```
@@ -0,0 +1,17 @@
+# GitNexus 前后对比
+
+## 开发前
+
+- 基线提交：`e552b979b61342b9e3a47d463f0b9a821b0ad95d`
+- 索引：641 节点、671 关系、0 流程。
+- 影响：现有治理档案函数总体 LOW，无数据库 Schema 执行流。
+
+## 开发后
+
+- 基线提交：`2c502ebbec25e45ac2980c08ed288ace194b7a04`（先独立提交并推送 v0.0.5 N/A 基线）。
+- 索引：837 节点、997 关系、17 流程。
+- 暂存区：23 文件、179 符号、17 条流程，risk=critical。
+
+## 结论
+
+新增关系和流程全部来自 GOV-007 Schema 安全门禁及其测试，没有引入市场业务、HTTP、RabbitMQ 或页面流程。风险从 LOW 提升到 critical 是因为新的 `governance:start` 前置门禁属于关键开发路径且整个模块首次加入；对应流程已用失败测试、修复测试、远程实测和独立 Review 覆盖。
@@ -0,0 +1,23 @@
+# GitNexus 暂存区变更检测
+
+- 检测日期：2026-08-13
+- 检测范围：staged
+- 变更文件：23
+- 变更符号：179
+- 受影响流程：17
+- GitNexus 风险：critical（已按关键门禁完成专项验证）
+
+## 受影响流程
+
+变更集中在数据库 Schema 治理模块：
+
+- Schema 生成、规范化与敏感/数据写入扫描。
+- 清单、SHA-256 与目录文件集合验证。
+- MySQL 5.7 双客户端、服务端和字符规则验证。
+- 当前发布版本本地校验。
+- 已提交、已推送、远程分支和远程标签严格校验。
+- CLI 生成/验证和 `governance:start` 入口。
+
+## 风险解释
+
+GitNexus 以“新增模块的全部 17 条流程均在本次变更中”为依据给出 critical，而非发现了业务市场分析、生产数据库或跨服务调用回归。本功能本身是开发前关键门禁，因此该风险等级按关键路径处理：执行 20 项 Schema 行为测试、既有 13 项治理回归测试、真实 Gitea `ls-remote` 校验、三轮独立代码 Review 和完成门禁。任何 Review Important 项未关闭前不发布。
@@ -0,0 +1,32 @@
+# GitNexus 开发前影响分析
+
+- 分析日期：2026-08-13
+- 基线提交：`e552b979b61342b9e3a47d463f0b9a821b0ad95d`
+- 索引状态：up-to-date
+
+## 查询范围
+
+围绕 `governance start development gate feature record database schema baseline` 查询现有治理入口。GitNexus 未识别出业务执行流，相关定义集中在：
+
+- `tools/governance/start.mjs`
+- `tools/governance/finish.mjs`
+- `tools/governance/feature-record.mjs`
+- `tools/governance/feature-record.test.mjs`
+- `package.json`
+- 治理规范和 GOV-007 设计档案
+
+## 符号影响
+
+- `getFeatureDirectory`：LOW；3 个直接依赖，分别是 start、finish 和治理测试；0 个执行流、0 个跨模块影响。
+- `validateFeatureId`：LOW；GitNexus 没有发现上游执行流，实际文本导入由 start、finish 和测试覆盖。
+- `getRequiredFeatureFiles`：LOW；没有识别到执行流，完成门禁由现有自动化测试保护。
+
+## 实施边界
+
+本功能不修改上述已有公共函数语义。Schema 逻辑新增为独立模块，只让 `start.mjs` 调用一个只读的“当前已发布版本基线有效”入口。生成、规范化和写入由独立命令负责，因此不会让一般功能档案解析承担数据库职责。
+
+## 风险结论
+
+总体风险：LOW。
+
+没有 HIGH 或 CRITICAL 结果，不需要额外中止确认。主要回归面是治理开始命令可能因缺少上一版本基线被有意阻断；通过 N/A 与真实 Schema 两类测试、既有治理回归测试和命令级验证覆盖。