优化

2026-08-11 18:06:26 +08:00
parent a02dd3a422
commit 192964419f
101 changed files with 8892 additions and 1952 deletions
@@ -169,19 +169,19 @@ DROP PROCEDURE IF EXISTS phase3_inbound_add_index;

 CREATE TABLE IF NOT EXISTS fl_inbound_split_batch (
  id BIGINT UNSIGNED NOT NULL COMMENT '拆分批次ID',
-  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户隔离ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
  parent_inbound_id BIGINT UNSIGNED NOT NULL COMMENT '主入仓单ID',
  operation_id VARCHAR(64) NOT NULL COMMENT '业务操作幂等号',
  idempotency_key VARCHAR(128) NOT NULL COMMENT '请求幂等键',
  expected_parent_version INT NOT NULL COMMENT '操作时主单乐观锁版本',
  package_count INT UNSIGNED NOT NULL COMMENT '本批次拆分箱数',
-  status VARCHAR(16) NOT NULL DEFAULT 'PREPARED' COMMENT 'PREPARED、APPLIED、CANCELLED',
+  status VARCHAR(16) NOT NULL DEFAULT 'PREPARED' COMMENT '拆分批次状态：PREPARED已准备、APPLIED已生效、CANCELLED已取消',
  remark VARCHAR(500) NULL COMMENT '拆分原因或备注',
  created_by BIGINT UNSIGNED NOT NULL COMMENT '创建人ID',
  created_by_name VARCHAR(64) NULL COMMENT '创建人名称快照',
-  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '拆分批次创建时间',
  applied_at DATETIME(3) NULL COMMENT '批次生效时间',
-  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本',
+  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号，每次更新递增',
  PRIMARY KEY (id),
  UNIQUE KEY uk_inbound_split_operation (tenant_id, operation_id),
  UNIQUE KEY uk_inbound_split_idempotency (tenant_id, parent_inbound_id, idempotency_key),
@@ -193,7 +193,7 @@ CREATE TABLE IF NOT EXISTS fl_inbound_split_batch (

 CREATE TABLE IF NOT EXISTS fl_inbound_split_item (
  id BIGINT UNSIGNED NOT NULL COMMENT '拆分明细ID',
-  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户隔离ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
  split_batch_id BIGINT UNSIGNED NOT NULL COMMENT '拆分批次ID',
  parent_inbound_id BIGINT UNSIGNED NOT NULL COMMENT '主入仓单ID',
  child_inbound_id BIGINT UNSIGNED NOT NULL COMMENT '子入仓单ID',
@@ -202,7 +202,7 @@ CREATE TABLE IF NOT EXISTS fl_inbound_split_item (
  source_measurement_id BIGINT UNSIGNED NOT NULL COMMENT '来源测量批次ID',
  source_measurement_item_id BIGINT UNSIGNED NOT NULL COMMENT '来源测量箱规明细ID',
  package_count INT UNSIGNED NOT NULL COMMENT '分配给子单的箱数',
-  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '拆分数量台账创建时间',
  PRIMARY KEY (id),
  UNIQUE KEY uk_inbound_split_batch_line (tenant_id, split_batch_id, line_no),
  UNIQUE KEY uk_inbound_split_batch_source_child (tenant_id, split_batch_id, source_measurement_item_id, child_inbound_id),
@@ -217,16 +217,16 @@ CREATE TABLE IF NOT EXISTS fl_inbound_split_item (

 CREATE TABLE IF NOT EXISTS fl_inbound_split_history (
  id BIGINT UNSIGNED NOT NULL COMMENT '拆分历史ID',
-  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户隔离ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
  split_batch_id BIGINT UNSIGNED NOT NULL COMMENT '拆分批次ID',
  operation_id VARCHAR(64) NOT NULL COMMENT '历史操作幂等号',
-  action_type VARCHAR(24) NOT NULL COMMENT 'CREATE、APPLY、CANCEL',
+  action_type VARCHAR(24) NOT NULL COMMENT '拆分动作：CREATE创建批次、APPLY生效、CANCEL取消',
  before_snapshot JSON NULL COMMENT '操作前快照',
  after_snapshot JSON NOT NULL COMMENT '操作后快照',
  operator_id BIGINT UNSIGNED NOT NULL COMMENT '操作人ID',
  operator_name VARCHAR(64) NULL COMMENT '操作人名称快照',
  operation_reason VARCHAR(500) NULL COMMENT '操作原因',
-  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '不可变拆分历史创建时间',
  PRIMARY KEY (id),
  UNIQUE KEY uk_inbound_split_history_operation (tenant_id, operation_id),
  KEY idx_inbound_split_history (tenant_id, split_batch_id, created_at, id),