Files
baiyue-firstleg/scripts
2026-08-12 20:36:11 +08:00
..
2026-08-12 20:36:11 +08:00
2026-08-12 20:36:11 +08:00
2026-08-12 20:36:11 +08:00
2026-08-08 12:01:45 +08:00
2026-08-08 11:33:18 +08:00
2026-08-11 18:06:26 +08:00
2026-08-04 09:05:28 +08:00
2026-08-11 20:39:28 +08:00
2026-08-08 15:25:46 +08:00
2026-08-11 18:16:59 +08:00
2026-08-04 18:54:22 +08:00
2026-07-30 18:01:36 +08:00
2026-08-07 23:43:41 +08:00
2026-08-01 12:02:01 +08:00
2026-08-11 18:06:26 +08:00

后端全量回归

入口

在 baiyue-firstleg 根目录执行:

.\scripts\backend-full-regression.ps1

前端全量回归

frontend-full-regression.ps1 只编排本地 Admin/Client 的 pnpm test 与 pnpm typecheck,不调用 Gateway、不部署、不连接数据库。

.\scripts\frontend-full-regression.ps1 -DryRun
.\scripts\frontend-full-regression.ps1
.\scripts\frontend-full-regression.ps1 -SkipAdmin
.\scripts\frontend-full-regression.ps1 -SkipClient

脚本会检查 pnpm 和目标应用的 package.json;任一命令失败时立即透传退出码,不能同时跳过 Admin 和 Client。

脚本固定运行:

mvn -f <仓库根>/pom.xml -pl order,firstleg -am test

这会先构建公共依赖,再运行 order 与 firstleg 的全部 Maven 测试。覆盖包括:

  • 三期 Ocean Booking Controller/Service/Mapper/SQL 契约;
  • 三期 Truck Appointment Controller/Service/Mapper 契约、状态机、乐观锁和幂等操作;
  • 二期 WAIT_SPLIT 的 firstleg 查询、order 统一查询及筛选语义;
  • 拣货/预装/装柜模型映射与既有 Smart Loading/Split 契约。

Dry-run

.\scripts\backend-full-regression.ps1 -DryRun

Dry-run 只检查根 pom.xml 和关键回归测试文件并打印 Maven 命令,不启动 Java 服务,不请求 Gateway,不连接或写入任何数据库。

现有相关脚本与边界

数据库中文注释审计

database-comment-audit.ps1 离线扫描各模块 src/main/resources/db/*.sql 中的 CREATE TABLE 定义,不连接数据库、不执行 SQL,也不修改任何文件。

.\scripts\database-comment-audit.ps1
.\scripts\database-comment-audit.ps1 -Modules finance,order
.\scripts\database-comment-audit.ps1 -Modules finance -SummaryOnly
.\scripts\database-comment-audit.ps1 -Format Json
.\scripts\database-comment-audit.ps1 -FailOnIssues
.\scripts\database-comment-audit.ps1 -SelfTest

默认报告模式即使存在存量缺口也返回 0;CI 使用 -FailOnIssues,缺失或纯英文表/字段注释返回 1,模块或路径配置错误返回 2。规范和注释口径见 ../docs/数据库注释维护规范.md。

本地 MySQL 全量验收

正式入口是 local-db-full-acceptance.ps1,只允许连接本机 127.0.0.1 或 localhost,默认端口 3306;测试库 8.163.30.128 会立即以退出码 2 拒绝。脚本固定校验统一 SQL SHA-256 7F61C3BAB0D4D49525A30C1E5030DEA4B798F38F6A0287901E6D1D676967DFFA 和 13712 行,并静态确认中文注释升级采用校验入队、每表一次 ALTER、结构签名复核、九库覆盖断言及唯一最终 PASS。

.\local-db-full-acceptance.ps1 -DryRun
.\local-db-full-acceptance.ps1

Dry-run 只校验 SQL 输入并打印空库、复跑、两类 picking 旧结构、WAIT_SPLIT/IAM、海外仓旧结构、中断恢复和最终结构的执行顺序,不启动 MySQL、不写库。真实运行每阶段写入 .codex-tmp/p23-04-acceptance/acceptance-run-*.log,不使用 --force,任一 SQL 错误立即停止并透传退出码,最后执行 verify-final.sql。脚本不保存或传入数据库密码,使用本机默认认证环境。

仓库中 phase2-test-env-acceptance.ps1、admin-test-env-acceptance.mjs、client-test-env-acceptance.mjs、export-center-test-env-acceptance.ps1 等属于测试环境/API 验收脚本;它们可能读取或写入测试环境数据,不由本入口调用。migrate-local-qualification-file.ps1、local-env.ps1 等是环境/迁移辅助脚本,也不由本入口调用。

本入口不读取数据库凭据、不执行 MySQL、HTTP、迁移、DDL、INSERT/UPDATE/DELETE,也不启动 Nacos、Gateway 或业务服务。需要数据库矩阵时必须单独运行受控验收流程。

退出码

  • 0:dry-run 检查通过或 Maven 全量测试通过;
  • 2:仓库根 pom 或关键测试文件缺失,脚本未启动 Maven;
  • 其他非零值:原样透传 Maven 失败退出码。

脚本不设置 MAVEN_OPTS、数据库 URL 或测试账号;环境参数仅为可选的 $MavenCommand(默认 mvn),用于指定本机 Maven 可执行文件。