优化

finance/src/test/java/com/baiyue/finance/CustomerAccountSummaryBehaviorTest.java

@@ -23,6 +23,7 @@ import static org.mockito.ArgumentMatchers.anyString;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
+import org.springframework.jdbc.BadSqlGrammarException;
 
 class CustomerAccountSummaryBehaviorTest {
 
@@ -51,8 +52,9 @@ class CustomerAccountSummaryBehaviorTest {
             .contains("FROM fin_settlement s WHERE s.tenant_id=?")
             .contains("s.direction='RECEIVABLE' AND s.status<>'VOIDED'")
             .contains("s.direction='PAYABLE' AND s.status<>'VOIDED'")
-            .contains("f.customer_id=?", "f.status='AVAILABLE'", "'$.reviewStatus'", "'$.settlementIncluded'")
+            .contains("f.customer_id=?", "f.status='AVAILABLE'", "f.review_status='APPROVED'", "f.settlement_included=1")
             .contains("b.status<>'VOIDED'")
+            .doesNotContain("JSON_EXTRACT")
             .doesNotContain("SUM(received_amount)", "FROM fin_receipt r");
     }
 
@@ -72,6 +74,24 @@ class CustomerAccountSummaryBehaviorTest {
         assertThat(result.outstandingPayable()).isZero();
     }
 
+    @Test
+    void missingSettlementProjectionReturnsZeroCnyBaseline() {
+        JdbcTemplate jdbc = mock(JdbcTemplate.class);
+        when(jdbc.queryForObject(anyString(), any(RowMapper.class), any(), any(), any()))
+            .thenThrow(new BadSqlGrammarException("customer summary", "SELECT ...", null));
+
+        CustomerAccountSummary result = new FinanceQueryService(jdbc, new ObjectMapper()).customerAccountSummary(88L);
+
+        assertThat(result.customerId()).isEqualTo(88L);
+        assertThat(result.currency()).isEqualTo("CNY");
+        assertThat(result.totalReceivable()).isZero();
+        assertThat(result.receivedAmount()).isZero();
+        assertThat(result.outstandingReceivable()).isZero();
+        assertThat(result.pendingBilling()).isZero();
+        assertThat(result.outstandingPayable()).isZero();
+        assertThat(result.lastChangedAt()).isNull();
+    }
+
     @Test
     void controllerUsesListPermissionAndDelegatesSummary() throws Exception {
         FinanceQueryService query = mock(FinanceQueryService.class);

finance/src/test/java/com/baiyue/finance/FinanceSettlementSchemaContractTest.java

@@ -0,0 +1,37 @@
+package com.baiyue.finance;
+
+import org.junit.jupiter.api.Test;
+
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class FinanceSettlementSchemaContractTest {
+
+    @Test
+    void moduleSchemaCreatesFormalSettlementTablesAndSummaryIndex() throws Exception {
+        String sql = Files.readString(Path.of("src/main/resources/db/finance.sql"), StandardCharsets.UTF_8);
+        String unified = Files.readString(resolveUnifiedSql(), StandardCharsets.UTF_8);
+
+        assertThat(sql)
+            .contains("CREATE TABLE IF NOT EXISTS fin_settlement (")
+            .contains("CREATE TABLE IF NOT EXISTS fin_settlement_line (")
+            .contains("CREATE TABLE IF NOT EXISTS fin_settlement_payment (")
+            .contains("idx_fin_settlement_customer_direction_status (tenant_id, direction, status)")
+            .contains("total_amount DECIMAL(20,6)", "paid_amount DECIMAL(20,6)", "outstanding_amount DECIMAL(20,6)")
+            .contains("updated_at DATETIME(3)");
+        assertThat(unified)
+            .contains("CREATE TABLE IF NOT EXISTS fin_settlement (")
+            .contains("CREATE TABLE IF NOT EXISTS fin_settlement_line (")
+            .contains("CREATE TABLE IF NOT EXISTS fin_settlement_payment (")
+            .contains("idx_fin_settlement_customer_direction_status (tenant_id, direction, status)")
+            .contains("'fin_settlement', 'fin_settlement_line', 'fin_settlement_payment')) <> 16");
+    }
+
+    private static Path resolveUnifiedSql() {
+        Path direct = Path.of("deploy", "sql", "头程数据库统一增量-MySQL8.sql");
+        return Files.exists(direct) ? direct : Path.of("..", "deploy", "sql", "头程数据库统一增量-MySQL8.sql");
+    }
+}

finance/src/test/java/com/baiyue/finance/FinanceSqlCommentContractTest.java

@@ -43,8 +43,8 @@ class FinanceSqlCommentContractTest {
                 missing.add(currentTable + "." + column.group(1));
             }
         }
-        assertThat(tableCount).isEqualTo(13);
-        assertThat(columnCount).isEqualTo(190);
+        assertThat(tableCount).isEqualTo(16);
+        assertThat(columnCount).isEqualTo(233);
         assertThat(missing).as("缺少中文业务注释的Finance字段").isEmpty();
     }