优化

firstleg/src/main/resources/db/phase3-customs-schema.sql

@@ -116,6 +116,22 @@ CREATE TABLE IF NOT EXISTS fl_customs_submission_batch (
   CONSTRAINT chk_customs_batch_status CHECK (status IN ('SUBMITTED','ACKNOWLEDGED','REJECTED','COMPLETED'))
 ) ENGINE=InnoDB COMMENT='报关代理提交批次及冻结文件版本';
 
+-- 历史代理名称无法安全反推Supplier ID，旧行保持NULL；新写入由服务端校验并持久化。
+DROP PROCEDURE IF EXISTS phase3_customs_supplier_snapshot_add_column;
+DELIMITER $$
+CREATE PROCEDURE phase3_customs_supplier_snapshot_add_column()
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns
+      WHERE table_schema=DATABASE() AND table_name='fl_customs_submission_batch'
+        AND column_name='customs_agent_id') THEN
+    ALTER TABLE fl_customs_submission_batch
+      ADD COLUMN customs_agent_id BIGINT UNSIGNED NULL COMMENT '本批次报关代理Supplier逻辑ID快照；历史数据无法推导时为空' AFTER batch_version;
+  END IF;
+END$$
+DELIMITER ;
+CALL phase3_customs_supplier_snapshot_add_column();
+DROP PROCEDURE phase3_customs_supplier_snapshot_add_column;
+
 CREATE TABLE IF NOT EXISTS fl_customs_receipt (
   id BIGINT UNSIGNED NOT NULL COMMENT '报关回执文件版本逻辑ID',
   customs_case_id BIGINT UNSIGNED NOT NULL COMMENT '所属报关协同单ID',