|
|
@@ -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 "";
|
|
|
+ }
|
|
|
+ }
|
|
|
+}
|