优化

firstleg/src/main/resources/db/phase2-fee-item-and-inbound-detail.sql

@@ -14,15 +14,15 @@ CREATE TABLE IF NOT EXISTS fl_fee_item (
   warehouse_receivable TINYINT(1) NOT NULL DEFAULT 0 COMMENT '仓储应收是否参与',
   allocation_fee TINYINT(1) NOT NULL DEFAULT 0 COMMENT '平摊费用是否参与',
   description VARCHAR(500) NULL COMMENT '说明',
-  status VARCHAR(16) NOT NULL DEFAULT 'ACTIVE' COMMENT 'ACTIVE或DISABLED',
-  created_by BIGINT NULL,
-  created_by_name VARCHAR(64) NULL,
-  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-  updated_by BIGINT NULL,
-  updated_by_name VARCHAR(64) NULL,
-  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
-  deleted TINYINT(1) NOT NULL DEFAULT 0,
-  version INT NOT NULL DEFAULT 0,
+  status VARCHAR(16) NOT NULL DEFAULT 'ACTIVE' COMMENT '状态：ACTIVE启用、DISABLED停用',
+  created_by BIGINT NULL COMMENT '创建人ID；系统初始化时可为空',
+  created_by_name VARCHAR(64) NULL COMMENT '创建人名称快照',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  updated_by BIGINT NULL COMMENT '最后修改人ID；系统初始化时可为空',
+  updated_by_name VARCHAR(64) NULL COMMENT '最后修改人名称快照',
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '最后更新时间',
+  deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记：0未删除、1已删除',
+  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
   PRIMARY KEY (id),
   UNIQUE KEY uk_fee_item_code (fee_code),
   KEY idx_fee_item_query (tenant_id, trade_scope, category, status, deleted),
@@ -45,26 +45,26 @@ CREATE TABLE IF NOT EXISTS fl_inbound_fee_detail (
   destination_code VARCHAR(32) NULL COMMENT '目的仓编码快照',
   destination_name VARCHAR(128) NULL COMMENT '目的仓名称快照',
   package_count INT NULL COMMENT '件数快照',
-  actual_gross_weight_kg DECIMAL(18,4) NULL COMMENT '仓库实测毛重',
-  actual_volume_cbm DECIMAL(18,6) NULL COMMENT '体积',
-  volume_weight_kg DECIMAL(18,4) NULL COMMENT '材积重',
-  chargeable_weight_kg DECIMAL(18,4) NULL COMMENT '计费重量',
-  chargeable_volume_cbm DECIMAL(18,6) NULL COMMENT '计费体积',
-  unit_price DECIMAL(18,4) NOT NULL COMMENT '单价',
-  currency CHAR(3) NOT NULL COMMENT '币种',
-  amount DECIMAL(18,2) NOT NULL COMMENT '金额',
+  actual_gross_weight_kg DECIMAL(18,4) NULL COMMENT '仓库实测毛重快照，单位千克',
+  actual_volume_cbm DECIMAL(18,6) NULL COMMENT '实际体积快照，单位立方米',
+  volume_weight_kg DECIMAL(18,4) NULL COMMENT '材积重快照，单位千克',
+  chargeable_weight_kg DECIMAL(18,4) NULL COMMENT '费用计算采用的计费重量，单位千克',
+  chargeable_volume_cbm DECIMAL(18,6) NULL COMMENT '费用计算采用的计费体积，单位立方米',
+  unit_price DECIMAL(18,4) NOT NULL COMMENT '费用单价；计价单位由对应费用项目规则确定',
+  currency CHAR(3) NOT NULL COMMENT '金额币种三字码，如CNY',
+  amount DECIMAL(18,2) NOT NULL COMMENT '该费用明细金额，币种由currency字段指定',
   remark VARCHAR(500) NULL COMMENT '备注',
-  review_status VARCHAR(16) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING、APPROVED、REJECTED',
+  review_status VARCHAR(16) NOT NULL DEFAULT 'PENDING' COMMENT '审核状态：PENDING待审核、APPROVED已通过、REJECTED已驳回',
   reviewer_id BIGINT NULL COMMENT '审核人ID',
   reviewer_name VARCHAR(64) NULL COMMENT '审核人名称快照',
   reviewed_at DATETIME(3) NULL COMMENT '审核时间',
   review_reason VARCHAR(500) NULL COMMENT '审核驳回原因',
-  created_by BIGINT NULL,
-  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-  updated_by BIGINT NULL,
-  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
-  deleted TINYINT(1) NOT NULL DEFAULT 0,
-  version INT NOT NULL DEFAULT 0,
+  created_by BIGINT NULL COMMENT '创建人或系统主体ID',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  updated_by BIGINT NULL COMMENT '最后修改人或系统主体ID',
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '最后更新时间',
+  deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记：0未删除、1已删除',
+  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
   PRIMARY KEY (id),
   KEY idx_inbound_fee_detail (tenant_id, inbound_id, business_date, deleted),
   KEY idx_inbound_fee_review (tenant_id, review_status, business_date, deleted),