Переглянути джерело

test(cfc-backend): RED 契约测试 cf.rewardv2.migrateConfig(S-cfc-393,T01 配置与迁移)

为「CF 分润模型 v2 T01 配置与迁移」新增契约级单测(TDD-RED 阶段,预期红):
- DatabaseInitializer 应提供 migrateCfRewardV2TeamPool() 迁移入口(§2.5)
- schema.sql 应含 4 张新表(cf_team_share_config/cf_team_pool_order/
  cf_team_pool_share/cf_platform_revenue_log,§2.1-2.4)+ 幂等唯一键 uk_scope/
  uk_order/uk_pool_member(§1.5)
- CfConfigKeys 应声明 6 个 v2 配置键并返回 §4 兜底默认值
- CF_EARN_RULE_SEEDS 应含 F03c 团队分润池规则(§3.3)
纯 JUnit5 + 反射 + schema.sql 资源读取,无 Spring/DB/外部服务。

溯源:docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md §6-T01
实测 RED:Tests run 8, Failures 7(实现未落地),权限流说明用例通过。
Sisyphus 3 днів тому
батько
коміт
1fa9a35b83

+ 297 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/CfRewardV2MigrateConfigContractTest.java

@@ -0,0 +1,297 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.constant.CfConfigKeys;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import java.io.InputStream;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.lang.reflect.Modifier;
+import java.nio.charset.StandardCharsets;
+import java.util.Scanner;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
+
+/**
+ * 契约级单测:CF 分润模型 v2 配置与迁移(能力键 {@code cf.rewardv2.migrateConfig},TDD-RED 阶段)。
+ *
+ * <p><b>契约溯源(T01 配置与迁移,表+键+种子)</b>:</p>
+ * <ul>
+ *   <li>需求:{@code docs/superpowers/plans/2026-11-14-cf-reward-model-v2.md} §4.2/§5 待实现清单 1/4
+ *       (数据库迁移:团队池比例配置 + 配置表/字段 + 流水表)</li>
+ *   <li>设计:{@code docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md}
+ *       §6-T01(新建 4 表 + F03c 种子 + 6 键播种)、§2.1-2.5(表结构 + 迁移方式)、
+ *       §3.3(F03c 种子)、§4(配置键)</li>
+ *   <li>任务编排键:T01 对应 {@code cf.rewardv2.config.migrate} / {@code cf.rewardv2.config.seed};
+ *       本测试以任务键 {@code cf.rewardv2.migrateConfig} 覆盖两者。</li>
+ * </ul>
+ *
+ * <p><b>被校验的契约行为(T01 范围)</b>:</p>
+ * <ul>
+ *   <li><b>迁移入口</b>:{@code DatabaseInitializer.migrateCfRewardV2TeamPool()}(§2.5)——
+ *       幂等 {@code CREATE TABLE IF NOT EXISTS} 建 4 张新表 + {@code ensureServiceConfig} 播种 6 个配置键。</li>
+ *   <li><b>4 张新表</b>(§2.1-2.4,迁移建议 462-465,实际续编以合入后为准):</li>
+ *   <li>{@code cf_team_share_config}(T% 配置,作用域 GLOBAL/SYSTEM/MINIAPP,唯一键 {@code uk_scope})</li>
+ *   <li>{@code cf_team_pool_order}(团队池整单,唯一键 {@code uk_order(order_type, order_id)} 幂等)</li>
+ *   <li>{@code cf_team_pool_share}(成员瓜分明细,唯一键 {@code uk_pool_member(pool_id, member_id)} 幂等)</li>
+ *   <li>{@code cf_platform_revenue_log}(平台抽成 R0 流水,唯一键 {@code uk_order} 幂等)</li>
+ *   <li><b>6 个配置键</b>(§4,进 {@code CfConfigKeys} + {@code seedCfServiceConfig}):</li>
+ *   <li>{@code cf.platform.take_rate_bps=1000}、{@code cf.team_pool.enabled=true}、
+ *       {@code cf.team_pool.default_t_bps=3000}、{@code cf.team_pool.on_loss=payout}、
+ *       {@code cf.team_pool.max_depth=8}、{@code cf.team_pool.non_goods_cost_rate=5000}</li>
+ *   <li><b>F03c 种子</b>(§3.3,{@code DatabaseInitializer.seedCfEarnRules} 追加):
+ *       团队分润池规则,幂等 {@code ref_type=F03c}、{@code ref_id=pool_id}。</li>
+ * </ul>
+ *
+ * <p><b>实现现状</b>:本分支 src/main 中 {@code cf_team_share_config} / {@code cf_team_pool_order} /
+ * {@code cf_team_pool_share} / {@code cf_platform_revenue_log} 四表未落地(schema.sql 无建表),
+ * {@code CfConfigKeys} 无 {@code cf.platform.take_rate_bps} / {@code cf.team_pool.*} 六个键,
+ * {@code DatabaseInitializer} 无 {@code migrateCfRewardV2TeamPool()} 方法、{@code CF_EARN_RULE_SEEDS}
+ * 无 F03c。因此本测试以「反射结构契约 + schema.sql 资源读取 + 配置兜底断言」探测实现缺失:
+ * 能编译通过、能运行、断言失败(红),且失败断言原文清晰可贴。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:实现者落地 T01 后(建 4 表并同步 schema.sql、CfConfigKeys 加 6 键并同步
+ * FALLBACKS、DatabaseInitializer 加 {@code migrateCfRewardV2TeamPool()} 并在 {@code runMigrations()}
+ * 接线、{@code seedCfEarnRules} 追加 F03c 种子),本测试自动转绿。</p>
+ *
+ * <p><b>测试范围</b>:纯契约级单测,无 Spring / 无 DB / 无外部服务。权限流不适用(迁移/配置为后端
+ * 内部数据链路,无用户权限维度)。</p>
+ */
+class CfRewardV2MigrateConfigContractTest {
+
+    /** 契约宿主:迁移入口所在类(设计 §2.5)。 */
+    private static final String DATABASE_INITIALIZER = "com.etotem.cfc.config.DatabaseInitializer";
+
+    /** 契约要求新增的迁移方法名(§2.5)。 */
+    private static final String MIGRATE_METHOD = "migrateCfRewardV2TeamPool";
+
+    /** §2.1-2.4 四张新表。 */
+    private static final String[] NEW_TABLES = {
+            "cf_team_share_config", "cf_team_pool_order", "cf_team_pool_share", "cf_platform_revenue_log"
+    };
+
+    /** §2.1-2.4 + §1.5 幂等唯一键。 */
+    private static final String[] UNIQUE_KEYS = {
+            "uk_scope", "uk_order", "uk_pool_member"
+    };
+
+    /** §4 六个配置键(键名 → 兜底默认值)。 */
+    private static final String[][] CONFIG_KEYS = {
+            {"cf.platform.take_rate_bps", "1000"},
+            {"cf.team_pool.enabled", "true"},
+            {"cf.team_pool.default_t_bps", "3000"},
+            {"cf.team_pool.on_loss", "payout"},
+            {"cf.team_pool.max_depth", "8"},
+            {"cf.team_pool.non_goods_cost_rate", "5000"}
+    };
+
+    // ------------------------------------------------------------------
+    // 正常流-1:迁移入口 migrateCfRewardV2TeamPool 应存在(§2.5)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-1:DatabaseInitializer 应提供 migrateCfRewardV2TeamPool() 迁移入口")
+    void databaseInitializer_hasMigrateCfRewardV2TeamPoolMethod() {
+        Class<?> clazz = loadClass(DATABASE_INITIALIZER);
+        if (clazz == null) {
+            fail("[cf.rewardv2.migrateConfig] DatabaseInitializer 类不存在(§2.5 迁移入口宿主)。");
+        }
+        Method method = null;
+        for (Method m : clazz.getDeclaredMethods()) {
+            if (m.getName().equals(MIGRATE_METHOD)) {
+                method = m;
+                break;
+            }
+        }
+        assertNotNull(method,
+                "[cf.rewardv2.migrateConfig] DatabaseInitializer 应提供 " + MIGRATE_METHOD + "() "
+                        + "私有方法:幂等 CREATE TABLE IF NOT EXISTS 建 4 张新表 + ensureServiceConfig "
+                        + "播种 6 个配置键(设计 §2.5 / §6-T01)。实现未落地。");
+        assertTrue(Modifier.isPrivate(method.getModifiers()),
+                "[cf.rewardv2.migrateConfig] " + MIGRATE_METHOD + "() 应为私有方法(runMigrations 内部调用)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-2:schema.sql 应含 4 张新表(§2.1-2.4,项目铁律同步)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-2:schema.sql 应含 4 张新表(cf_team_share_config/cf_team_pool_order/cf_team_pool_share/cf_platform_revenue_log)")
+    void schemaSql_containsFourNewTables() {
+        String schema = readSchemaSql();
+        for (String table : NEW_TABLES) {
+            assertTrue(schema.contains(table),
+                    "[cf.rewardv2.migrateConfig] schema.sql 缺少 " + table
+                            + " 建表(设计 §2.1-2.4 / §6-T01:新建 4 表)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-3:幂等唯一键应落地(§1.5 / §2.1-2.4)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-3:schema.sql 应含幂等唯一键 uk_scope/uk_order/uk_pool_member")
+    void schemaSql_containsIdempotentUniqueKeys() {
+        String schema = readSchemaSql();
+        for (String key : UNIQUE_KEYS) {
+            assertTrue(schema.contains(key),
+                    "[cf.rewardv2.migrateConfig] schema.sql 缺少唯一键 " + key
+                            + "(设计 §1.5 幂等:uk_scope 作用域唯一 / uk_order 整单幂等 / "
+                            + "uk_pool_member 成员幂等)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-4:CfConfigKeys 应声明 6 个配置键(§4)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-4:CfConfigKeys 应声明 6 个 v2 配置键常量")
+    void cfConfigKeys_declaresSixRewardV2Keys() {
+        for (String[] kv : CONFIG_KEYS) {
+            String key = kv[0];
+            boolean declared = false;
+            for (Field f : CfConfigKeys.class.getDeclaredFields()) {
+                if (Modifier.isStatic(f.getModifiers())
+                        && f.getType() == String.class
+                        && key.equals(staticString(f))) {
+                    declared = true;
+                    break;
+                }
+            }
+            assertTrue(declared,
+                    "[cf.rewardv2.migrateConfig] CfConfigKeys 缺少配置键常量 " + key
+                            + "(设计 §4 / §6-T01:6 键进 CfConfigKeys + seedCfServiceConfig)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-5:6 个键的引导期兜底默认值应符合 §4
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-5:CfConfigKeys.fallbackOf 应返回 6 键的 §4 默认值")
+    void cfConfigKeys_fallbackDefaultsMatchSpec() {
+        for (String[] kv : CONFIG_KEYS) {
+            String key = kv[0];
+            String expected = kv[1];
+            assertEquals(expected, CfConfigKeys.fallbackOf(key),
+                    "[cf.rewardv2.migrateConfig] 配置键 " + key + " 的兜底默认值应为 "
+                            + expected + "(设计 §4)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-6:cf_earn_rule 种子应含 F03c 团队分润池(§3.3)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-6:DatabaseInitializer.CF_EARN_RULE_SEEDS 应含 F03c 团队分润池规则")
+    void cfEarnRuleSeeds_containsTeamPoolF03c() {
+        String[][] seeds = earnRuleSeeds();
+        if (seeds == null) {
+            fail("[cf.rewardv2.migrateConfig] DatabaseInitializer.CF_EARN_RULE_SEEDS 字段不存在或不可读。");
+        }
+        boolean found = false;
+        for (String[] row : seeds) {
+            if (row != null && row.length > 0 && "F03c".equals(row[0])) {
+                found = true;
+                break;
+            }
+        }
+        assertTrue(found,
+                "[cf.rewardv2.migrateConfig] cf_earn_rule 种子应含 F03c「团队分润池」规则"
+                        + "(设计 §3.3 / §6-T01:seedCfEarnRules 追加,幂等 ref_type=F03c、ref_id=pool_id)。实现未落地。");
+    }
+
+    // ------------------------------------------------------------------
+    // 边界流:4 张新表 + 6 键 + F03c 种子 —— 幂等可重复执行(迁移铁律)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("边界流-1:迁移须幂等 —— 建表用 CREATE TABLE IF NOT EXISTS(schema.sql 体现)")
+    void schemaSql_newTablesUseIfNotExists() {
+        String schema = readSchemaSql();
+        for (String table : NEW_TABLES) {
+            int idx = schema.indexOf("CREATE TABLE IF NOT EXISTS " + table);
+            assertTrue(idx >= 0,
+                    "[cf.rewardv2.migrateConfig] " + table + " 建表应为 CREATE TABLE IF NOT EXISTS"
+                            + "(迁移铁律:幂等可重复执行,设计 §2.5)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 权限流(不适用):迁移/配置为后端内部数据链路,无用户权限维度
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("权限流:本能力为后端内部迁移/配置链路,无用户权限维度,权限流不适用")
+    void permissionFlow_notApplicable() {
+        // 说明性用例:契约 AC 为「数据库迁移 + 配置播种」内部数据链路,无权限校验维度。
+        // 不产生断言失败;仅为三流覆盖标注「不适用」。
+        assertTrue(true, "权限流不适用:cf.rewardv2.migrateConfig 为后端内部迁移/配置链路,无用户权限维度。");
+    }
+
+    // ------------------------------------------------------------------
+    // 反射辅助
+    // ------------------------------------------------------------------
+
+    private Class<?> loadClass(String name) {
+        try {
+            return Class.forName(name, false, Thread.currentThread().getContextClassLoader());
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+
+    private String staticString(Field f) {
+        try {
+            f.setAccessible(true);
+            Object v = f.get(null);
+            return v instanceof String ? (String) v : null;
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    /** 反射读取 DatabaseInitializer.CF_EARN_RULE_SEEDS(String[][])。 */
+    private String[][] earnRuleSeeds() {
+        Class<?> clazz = loadClass(DATABASE_INITIALIZER);
+        if (clazz == null) {
+            return null;
+        }
+        for (Field f : clazz.getDeclaredFields()) {
+            if ("CF_EARN_RULE_SEEDS".equals(f.getName())) {
+                try {
+                    f.setAccessible(true);
+                    Object v = f.get(null);
+                    if (v instanceof String[][]) {
+                        return (String[][]) v;
+                    }
+                } catch (Exception e) {
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+
+    private String readSchemaSql() {
+        try (InputStream is = getClass().getClassLoader().getResourceAsStream("schema.sql")) {
+            if (is == null) {
+                return "";
+            }
+            try (Scanner scanner = new Scanner(is, StandardCharsets.UTF_8.name())) {
+                scanner.useDelimiter("\\A");
+                return scanner.hasNext() ? scanner.next() : "";
+            }
+        } catch (Exception e) {
+            return "";
+        }
+    }
+}