优化

scripts/README.md

@@ -136,6 +136,8 @@ Client 全量、Client 入库测量与计费、待审核订单和批量待分柜
 
 部署目录的入口另有：`deploy/scripts/deploy-built-service.sh`（单服务健康检查与失败回滚）、`deploy/scripts/deploy-development-service.sh`（经 SSH 部署开发服务）、`deploy/scripts/deploy-services.sh`（按服务列表编排部署）、`deploy/scripts/initialize-test-databases.sh`（初始化测试基础设施数据库）和 `deploy/rocketmq/render-broker-config.sh`（容器内渲染并启动 RocketMQ broker）。这些脚本都会改变运行环境，不能作为普通本地检查执行。
 
+数据库迁移离线入口为 `deploy/sql/scripts/db-migrations.mjs`：`new` 自动生成单 schema 的下一个版本草稿，`check` 做范围/文件/跨 schema 静态检查，`plan` 生成选定服务的不可变清单，`run --dry-run` 只输出执行计划。当前不连接数据库；真实 Flyway 执行须等迁移阶段完成并获得对应环境授权。用途、参数和边界见 `deploy/sql/README.md`。
+
 服务局部分析入口为 `firstleg/scripts/analyze-firstleg-dependencies.mjs` 与 `lastleg-service/scripts/analyze-lastleg-dependencies.mjs`，相邻的 `*.test.mjs` 负责对基线和违规依赖做离线回归；`warehouse/scripts/warehouse-public-master-data-contract.test.mjs` 只读校验 Warehouse 公共主数据 CSV 与 SQL。SQL 辅助文件 `scripts/db/incremental.sql` 不是当前统一部署入口，正式数据库变更以 `deploy/sql/README.md` 指向的统一增量为准。
 
 新增可直接运行的脚本时，必须同时在本节登记用途、目标环境、是否写数据和密钥边界，并运行 `node --test scripts/script-documentation-contract.test.mjs`。仅新增 `*.test.mjs` 或 `admin-test-env-modules/` 内部模块时，分别更新对应合同范围或模块 README，不把内部文件误写成独立入口。

scripts/script-documentation-contract.test.mjs

@@ -14,6 +14,7 @@ const excludedDirectoryNames = new Set([
 const allowedDirectoryPrefixes = [
   'scripts/',
   'deploy/scripts/',
+  'deploy/sql/scripts/',
   'deploy/rocketmq/',
   'firstleg/scripts/',
   'lastleg-service/scripts/',
@@ -62,6 +63,7 @@ test('all directly runnable scripts are documented in scripts/README.md', async
     ...await executableFiles('scripts', ['.mjs', '.ps1', '.groovy']),
     ...await executableFiles('scripts/openapi-validation', ['.mjs']),
     ...await executableFiles('deploy/scripts', ['.sh']),
+    ...await executableFiles('deploy/sql/scripts', ['.mjs']),
     ...await executableFiles('deploy/rocketmq', ['.sh']),
     ...await executableFiles('firstleg/scripts', ['.mjs']),
     ...await executableFiles('lastleg-service/scripts', ['.mjs']),