优化

deploy/sql/README.md

@@ -68,8 +68,8 @@
 |---|---|---|
 | CN / `baiyue_iam` | `migrations/cn/baiyue_iam/V1__align_schema_baseline.sql` | 收敛客户编号、昵称和资质原文件名定义；收紧前检查存量数据 |
 | CN / `baiyue_firstleg` | `migrations/cn/baiyue_firstleg/V1__align_schema_baseline.sql` | 收敛一件代发托盘码非空定义；收紧前检查存量数据 |
-| CN / `baiyue_file` | `migrations/cn/baiyue_file/V1__align_schema_baseline.sql` | 补齐 PDA 发布表和固定渠道，收敛文件业务类型长度 |
-| OVERSEAS / `baiyue_lastleg` | `migrations/overseas/baiyue_lastleg/V1__align_lastleg_production_schema.sql`、`V2__align_schema_baseline.sql` | 补齐尾程字段并收敛字段定义和排序规则；收紧前检查存量数据 |
+| CN / `baiyue_file` | `migrations/cn/baiyue_file/V1__align_schema_baseline.sql`、`V2__widen_business_type.sql` | 补齐 PDA 发布表和固定渠道，并支持正式长业务类型 |
+| OVERSEAS / `baiyue_lastleg` | `migrations/overseas/baiyue_lastleg/V1__align_lastleg_production_schema.sql`、`V2__align_schema_baseline.sql`、`V3__relax_valid_nullable_fields.sql` | 补齐尾程字段并收敛字段定义；放宽退货出库和预入仓批量 SKU 换标合法空值 |
 
 上述新增候选当前只完成编写和离线检查，尚未在测试或生产执行。测试通过后必须复用同一份 SQL 和 manifest 晋级生产，不得重新生成或修改候选。`scripts/prod-database-schema-acceptance.mjs` 仍只负责历史尾程 V1 的专用只读核对/受控执行，不代表本批跨 schema 发布入口；本批按迁移 manifest 管理，实际执行须等待环境执行器接入或当前轮明确授权后的受控人工执行。
 

deploy/sql/migrations/cn/baiyue_file/V2__widen_business_type.sql

@@ -0,0 +1,8 @@
+-- Region: CN
+-- Schema: baiyue_file
+-- Purpose: 支持长度超过 32 的正式文件业务类型，例如海外转运测量照片和换标汇总文档。
+-- Preconditions: 连接必须指向 baiyue_file。
+-- Postconditions: file_object.business_type 为 varchar(64)，与 File 模块正式 SQL 一致。
+
+ALTER TABLE file_object
+  MODIFY COLUMN business_type varchar(64) DEFAULT NULL COMMENT '关联业务类型';

deploy/sql/migrations/overseas/baiyue_lastleg/V3__relax_valid_nullable_fields.sql

@@ -0,0 +1,12 @@
+-- Region: OVERSEAS
+-- Schema: baiyue_lastleg
+-- Purpose: 放宽代码明确允许为空的退货出库仓位与批量 SKU 换标字段。
+-- Preconditions: 连接必须指向 baiyue_lastleg。
+-- Postconditions: 三个字段可空，退货箱直接出库及预入仓批量 SKU 换标可正常持久化。
+
+ALTER TABLE ll_outbound_pda_pick
+  MODIFY COLUMN inventory_position_id bigint NULL COMMENT '库存仓位ID；退货箱直接出库时为空';
+
+ALTER TABLE ll_relabel_item
+  MODIFY COLUMN new_sku_code varchar(128) COLLATE utf8mb4_unicode_ci NULL COMMENT '换标后SKU编码；批量SKU换标使用子明细JSON时为空',
+  MODIFY COLUMN source_warehouse_id varchar(128) COLLATE utf8mb4_unicode_ci NULL COMMENT '原海外中转仓ID；预入仓批量SKU换标时为空';

deploy/sql/头程数据库统一增量-MySQL8.sql

@@ -4427,7 +4427,7 @@ CREATE TABLE file_export_task_guard (
 CREATE TABLE file_object (
   id bigint unsigned NOT NULL COMMENT '文件ID（雪花ID）',
   tenant_id bigint unsigned NOT NULL COMMENT '客户ID和数据隔离键',
-  business_type varchar(32) DEFAULT NULL COMMENT '关联业务类型',
+  business_type varchar(64) DEFAULT NULL COMMENT '关联业务类型',
   business_id varchar(64) DEFAULT NULL COMMENT '关联业务逻辑ID',
   original_name varchar(255) NOT NULL COMMENT '原始文件名',
   object_key varchar(512) NOT NULL COMMENT '对象存储键',

deploy/sql/海外区域统一增量-MySQL8.sql

@@ -1724,7 +1724,7 @@ CREATE TABLE ll_outbound_pda_pick (
   customer_id varchar(128) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '客户数据隔离键',
   task_id bigint NOT NULL COMMENT 'PDA任务ID',
   outbound_pallet_item_id bigint NOT NULL COMMENT '出库托盘明细ID',
-  inventory_position_id bigint NOT NULL COMMENT '库存仓位ID',
+  inventory_position_id bigint DEFAULT NULL COMMENT '库存仓位ID；退货箱直接出库时为空',
   packages bigint NOT NULL COMMENT '拣货箱数',
   idempotency_key varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '拣货幂等键',
   picked_at datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '拣货时间',
@@ -2211,7 +2211,7 @@ CREATE TABLE ll_relabel_item (
   notified_package_count int NOT NULL COMMENT '已通知箱数',
   shipment_no varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '货件编号（无FBA去向时为空）',
   tracking_code varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '物流跟踪编码',
-  new_sku_code varchar(128) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '换标后SKU编码',
+  new_sku_code varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '换标后SKU编码；批量SKU换标使用子明细JSON时为空',
   label_requirement varchar(1000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '换标要求',
   remark varchar(1000) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '货物明细备注',
   relabel_file_id varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '换标文件ID',
@@ -2228,7 +2228,7 @@ CREATE TABLE ll_relabel_item (
   source_inbound_order_id bigint DEFAULT NULL COMMENT '原入仓单ID（预入仓换标任务可为空）',
   source_inbound_order_no varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '原入仓单号快照',
   source_inbound_code varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '原进仓编码快照',
-  source_warehouse_id varchar(128) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '原海外中转仓ID',
+  source_warehouse_id varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '原海外中转仓ID；预入仓批量SKU换标时为空',
   source_warehouse_code varchar(128) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '原海外中转仓编码快照',
   source_warehouse_name varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '原海外中转仓名称快照',
   created_at datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',