docs(GOV-009): 封存脚手架复核材料

2026-08-13 19:55:45 +08:00
parent 95b8611bd9
commit f50268b70f
15 changed files with 290 additions and 2 deletions
@@ -0,0 +1,19 @@
+# GitNexus 开发后基线
+
+- 记录时间：2026-08-13 GMT+8
+- 分支：`main`
+- 实现提交：`95b8611bd9bbc282193591e472e2e19c617e5035`
+- 远端：`origin/main` 已核对为同一 SHA
+
+```text
+Repository: a-share-analysis
+Indexed commit: 95b8611
+Current commit: 95b8611
+Status: up-to-date
+Nodes: 1568
+Relationships: 2190
+Clusters: 46
+Execution flows: 47
+```
+
+图谱已包含 Web、API、Scheduler、Worker、配置加载、健康检查、OpenAPI、消息信封、Schema、Docker 验证和治理门禁。GitNexus 本地索引未提交仓库。
@@ -0,0 +1,18 @@
+# GitNexus 前后对比
+
+| 项目 | 开发前 `c04184a6` | 开发后 `95b8611` | 变化 |
+| --- | ---: | ---: | ---: |
+| 符号 | 958 | 1568 | +610 |
+| 关系 | 1141 | 2190 | +1049 |
+| 执行流程 | 23 | 47 | +24 |
+
+开发前仓库以治理文档、环境模板和 Schema 工具为主，Web/Server 仍无可运行应用。开发后形成以下新边界：
+
+- Vue 3 Web 可启动、测试、构建，并通过生成的 OpenAPI 类型访问 API。
+- NestJS API、Scheduler、Worker 为独立入口和独立配置容器。
+- Scheduler/Worker 具备可验证的持续运行与 SIGTERM 优雅关闭生命周期。
+- HTTP 契约由 Server DTO 单向发布；RocketMQ 消息信封只存在于 Server。
+- Docker Compose 与 Ubuntu 源码部署共用同一配置语义和构建产物。
+- Schema 空库、MySQL 5.7.42、契约漂移和 `.vue` 工程边界均有自动门禁。
+
+新增关系数量符合“从占位目录建立应用基线”的预期。后续市场概览功能应在这些边界内增加业务模块，不应把 Web 与 Server 重新耦合。
@@ -0,0 +1,15 @@
+# GitNexus 变更检测
+
+- 对比基线：`c04184a6111da0cfad90d1a265dc3cd3a6d90a9c`
+- 实现提交：`95b8611bd9bbc282193591e472e2e19c617e5035`
+- 检测命令：`npx gitnexus detect-changes --scope compare --base-ref c04184a6 --repo a-share-analysis`
+- 变更范围：110 个文件、452 个符号、45 条执行流程
+- 风险：CRITICAL
+
+CRITICAL 来自一次建立完整 Web、API、Scheduler、Worker、契约生成、Schema 和部署验证链路，而不是单个未受控函数。主要流程为三进程配置加载、Schema 生成/验证、OpenAPI 发布、Web 客户端边界和 Docker/源码部署。
+
+Review 整改前对具体符号分别执行上游影响分析：三进程 bootstrap、动态模块、消息信封、空库捕获和 MySQL 健康检查大多为 LOW；`assertMysql57Metadata` 因位于 Schema 发布门禁核心为 CRITICAL。该变更只把服务端补丁版本固定到 5.7.42，历史 `v0.0.7` 清单回归和 `schema:verify` 均通过。
+
+最终代码复审补充发现无引号 Vue 外部 `script src` 可绕过早期正则门禁；影响分析为 LOW，只有 1 个直接调用者和 1 条边界检查流程。`95b8611` 改用 Vue 3.5.41 官方 SFC 解析器，并以单双引号、无引号和属性换序用例验证，未扩大应用运行影响面。
+
+检测范围与开发前影响计划一致，未出现用户体系、生产数据库、外部消息写入或其他项目流程。