优化

finance/src/main/resources/db/finance.sql

@@ -212,7 +212,13 @@ CREATE TABLE IF NOT EXISTS fin_cost (
   id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键ID',
   tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
   cost_no VARCHAR(64) NOT NULL COMMENT '客户范围内唯一成本编号',
-  cost_type VARCHAR(24) NOT NULL COMMENT '成本归属类型：SINGLE_ORDER单票成本、CONTAINER_SHARED整柜公共成本',
+  cost_type VARCHAR(24) NOT NULL COMMENT '成本归属类型：SINGLE_ORDER单票、CONTAINER_SHARED整柜公共、SOURCE_DIRECT_PAID来源直接已付',
+  cost_origin VARCHAR(24) NOT NULL DEFAULT 'MANUAL' COMMENT '成本来源：MANUAL人工补充、FIRSTLEG_DIRECT_PAID头程直接已付',
+  source_system VARCHAR(32) NULL COMMENT '来源系统，头程直接已付固定FIRSTLEG',
+  source_type VARCHAR(32) NULL COMMENT '来源费用类型快照',
+  source_fee_id BIGINT UNSIGNED NULL COMMENT '来源费用ID',
+  source_fee_version INT UNSIGNED NULL COMMENT '来源费用版本',
+  source_hash CHAR(64) NULL COMMENT '来源不可变快照SHA-256',
   order_id BIGINT UNSIGNED NULL COMMENT '成本归属的头程订单ID，单票成本必填',
   inbound_id BIGINT UNSIGNED NULL COMMENT '成本关联的入库单ID，可为空',
   container_id BIGINT UNSIGNED NULL COMMENT 'Firstleg装柜计划ID，整柜公共成本必填',
@@ -223,6 +229,9 @@ CREATE TABLE IF NOT EXISTS fin_cost (
   currency_code CHAR(3) NOT NULL DEFAULT 'CNY' COMMENT 'ISO 4217三位币种代码，首期仅CNY',
   cost_amount DECIMAL(20,6) NOT NULL COMMENT '成本总金额，精度6位小数',
   voucher_file_ids JSON NOT NULL COMMENT 'File服务财务凭证文件ID字符串数组JSON',
+  paid_at DATETIME(3) NULL COMMENT '直接已付时间；人工补充成本可为空',
+  payment_method VARCHAR(32) NULL COMMENT '直接已付方式：ONLINE、BANK_TRANSFER、CASH、OTHER',
+  payment_reference_no VARCHAR(128) NULL COMMENT '直接已付流水号',
   status VARCHAR(16) NOT NULL DEFAULT 'DRAFT' COMMENT '成本状态：DRAFT草稿、CONFIRMED已确认、VOIDED已作废',
   remark VARCHAR(500) NULL COMMENT '平台成本内部备注',
   confirmed_at DATETIME(3) NULL COMMENT '成本确认时间',
@@ -238,6 +247,7 @@ CREATE TABLE IF NOT EXISTS fin_cost (
   updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '最后更新时间，数据修改时自动刷新',
   PRIMARY KEY (id),
   UNIQUE KEY uk_fin_cost_no (tenant_id, cost_no),
+  UNIQUE KEY uk_fin_cost_source_version (source_system, source_type, source_fee_id, source_fee_version),
   KEY idx_fin_cost_ticket (tenant_id, order_id, inbound_id),
   KEY idx_fin_cost_container (tenant_id, container_id),
   CONSTRAINT chk_fin_cost_tenant CHECK (tenant_id > 0),
@@ -246,8 +256,16 @@ CREATE TABLE IF NOT EXISTS fin_cost (
   CONSTRAINT chk_fin_cost_target CHECK (
     (cost_type = 'SINGLE_ORDER' AND order_id IS NOT NULL AND container_id IS NULL)
     OR (cost_type = 'CONTAINER_SHARED' AND container_id IS NOT NULL)
+    OR (cost_type = 'SOURCE_DIRECT_PAID' AND (order_id IS NOT NULL OR inbound_id IS NOT NULL OR container_id IS NOT NULL))
+  ),
+  CONSTRAINT chk_fin_cost_origin CHECK (
+    (cost_origin='MANUAL' AND source_system IS NULL AND source_type IS NULL AND source_fee_id IS NULL AND source_fee_version IS NULL AND source_hash IS NULL)
+    OR (cost_origin='FIRSTLEG_DIRECT_PAID' AND source_system='FIRSTLEG' AND source_type IS NOT NULL
+      AND source_fee_id IS NOT NULL AND source_fee_version IS NOT NULL AND source_hash IS NOT NULL
+      AND status IN ('CONFIRMED','VOIDED') AND paid_at IS NOT NULL
+      AND payment_method IN ('ONLINE','BANK_TRANSFER','CASH','OTHER'))
   )
-) ENGINE=InnoDB COMMENT='人工成本；单票直接归属，整柜按体积分摊';
+) ENGINE=InnoDB COMMENT='成本事实；人工补充成本与头程直接已付来源成本统一留痕';
 
 CREATE TABLE IF NOT EXISTS fin_cost_allocation (
   id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键ID',