优化

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

@@ -18,6 +18,11 @@ CREATE TABLE IF NOT EXISTS fin_fee_source (
   fee_item_name VARCHAR(200) NOT NULL COMMENT '来源费用项目名称快照',
   amount DECIMAL(20,6) NOT NULL COMMENT '来源费用金额，精度6位小数',
   currency_code CHAR(3) NOT NULL DEFAULT 'CNY' COMMENT 'ISO 4217三位币种代码，首期仅CNY',
+  settlement_mode VARCHAR(16) NULL COMMENT '仅PAYABLE：ON_ACCOUNT账期应付、DIRECT_PAID业务已付；RECEIVABLE为空',
+  paid_at DATETIME(3) NULL COMMENT 'DIRECT_PAID业务已付时间',
+  payment_method VARCHAR(32) NULL COMMENT 'DIRECT_PAID付款方式：ONLINE、BANK_TRANSFER、CASH、OTHER',
+  payment_reference_no VARCHAR(128) NULL COMMENT 'DIRECT_PAID付款流水号',
+  payment_voucher_file_ids JSON NULL COMMENT 'DIRECT_PAID付款凭证File ID数组',
   source_hash CHAR(64) NOT NULL COMMENT 'Firstleg费用来源完整快照SHA-256哈希',
   source_snapshot JSON NOT NULL COMMENT 'Firstleg费用来源完整不可变JSON快照',
   review_status VARCHAR(16) NOT NULL DEFAULT 'DRAFT' COMMENT 'Finance费用状态：DRAFT草稿、PENDING待审核、APPROVED已通过、REJECTED已驳回',
@@ -30,7 +35,16 @@ CREATE TABLE IF NOT EXISTS fin_fee_source (
   UNIQUE KEY uk_fin_fee_source (source_system, source_fee_id, source_fee_version),
   KEY idx_fin_fee_source_customer (customer_id, status),
   CONSTRAINT chk_fin_fee_source_currency CHECK (currency_code = 'CNY'),
-  CONSTRAINT chk_fin_fee_source_amount CHECK (amount >= 0)
+  CONSTRAINT chk_fin_fee_source_amount CHECK (amount >= 0),
+  CONSTRAINT chk_fin_fee_source_settlement CHECK (
+    (direction='RECEIVABLE' AND settlement_mode IS NULL AND paid_at IS NULL AND payment_method IS NULL
+      AND payment_reference_no IS NULL AND payment_voucher_file_ids IS NULL)
+    OR (direction='PAYABLE' AND settlement_mode='ON_ACCOUNT' AND paid_at IS NULL AND payment_method IS NULL
+      AND payment_reference_no IS NULL AND payment_voucher_file_ids IS NULL)
+    OR (direction='PAYABLE' AND settlement_mode='DIRECT_PAID' AND paid_at IS NOT NULL
+      AND payment_method IN ('ONLINE','BANK_TRANSFER','CASH','OTHER')
+      AND (payment_reference_no IS NOT NULL OR JSON_LENGTH(payment_voucher_file_ids)>0))
+  )
 ) ENGINE=InnoDB COMMENT='Firstleg费用来源快照池；账单人工选择并固化明细';
 
 CREATE TABLE IF NOT EXISTS fin_inbox_event (