baiyue-firstleg/deploy/sql/README.md

测试环境 SQL 执行说明

本轮一期回归

• 统一入口：2026-07-31一期回归测试环境增量迁移.sql
• 适用数据库：MySQL 8.0。
• 执行账号需要对 baiyue_iam、baiyue_warehouse、baiyue_order、baiyue_firstleg 具备建表、改表、建索引、创建临时存储过程和数据写入权限。
• 脚本不会创建数据库，不会清理或删除业务数据，也不会写入演示租户、演示用户、演示仓库、演示往来单位或快递公司样本。
• 脚本可重复执行。MySQL 的 DDL 会隐式提交，因此不能把整份跨库脚本视为可整体回滚的事务。
• 统一入口已内联 IAM 客户档案字段迁移和 platform:customer:view 权限迁移；测试环境不要再额外拼接或重复按模块脚本执行。

IAM 来源与执行顺序

统一入口中的 IAM 段按以下模块迁移依赖顺序组织，并通过元数据判断或 ON DUPLICATE KEY UPDATE 保持可重复执行：

1. IAM 基线表必须已存在（iam.sql）。
2. 权限父菜单和既有客户列表/审核权限基线（phase1-admin-rbac.sql、rbac-role-management-v2.sql）。
3. phase1-platform-master-data-and-permission-management.sql 中的 platform:customer:view、既有角色继承及管理员授权。
4. phase1-customer-profile.sql 中的九个 iam_tenant 客户档案字段。

测试环境只执行统一入口；模块脚本用于新环境基线构建或单模块升级，不应在统一入口执行后再次串行执行。

执行方式

在 Navicat、DataGrip 或 MySQL 命令行中以“运行脚本”方式完整执行，确保客户端支持 DELIMITER。不要只选中局部语句执行。

执行结束后必须看到 MIGRATION_COMPLETED，并确认其前面的 IAM 权限、IAM 客户档案九字段、Warehouse 表结构、Order 幂等表和 Firstleg 索引核验均通过。

二期第三方测量增量

• 模块脚本：firstleg/src/main/resources/db/phase2-third-party-single-measurement-migration.sql。
• 二期统一脚本：2026-08-04-二期入库新增表字段-MySQL8一键执行.sql 已内联该增量。
• 新增 external_request_hash、inbound_detail_id、external_detail_no 和第三方明细唯一索引，用于一条回传绑定一条订单货物明细及一张文件中心图片。
• 本次代码回归不执行真实数据库迁移；测试环境部署 Firstleg 新版本前必须先执行该增量并确认末尾两项检查为 PASS。