Pārlūkot izejas kodu

feat(cf.rewardv2.migrateConfig): T01 批次2 建4表+播种6键+F03c种子+迁移492 S-cfc-401

Agnes Agent 1 dienu atpakaļ
vecāks
revīzija
05215afa73

+ 122 - 0
cfc-backend/src/main/java/com/etotem/cfc/config/DatabaseInitializer.java

@@ -3631,6 +3631,109 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
 
         // 迁移484: users / product_orders / package_orders 加 appid 列 + users 唯一索引(OID 防串号)
         migrateMultiAppDataDimensions();
+
+        // 迁移492: CFC 分润 v2 团队池四表(cf.rewardv2.migrateConfig · S-cfc-401 T01 批次2)
+        migrateCfRewardV2TeamPool();
+    }
+
+
+    /**
+     * 迁移492: 团队池分润 v2 四表(S-cfc-401 T01 批次2,cf.rewardv2.migrateConfig)
+     *
+     * <p>CFC 分润 v2 团队池承载表:
+     * <ul>
+     *   <li>cf_team_share_config —— 团队池配置作用域表(GLOBAL/SYSTEM/MINIAPP,uk_scope);</li>
+     *   <li>cf_team_pool_order —— 团队池订单表(成本 × T% 整数单,uk_order);</li>
+     *   <li>cf_team_pool_share —— 团队池份额分配表(按 referral tree 分配,uk_pool_member);</li>
+     *   <li>cf_platform_revenue_log —— 平台抽成 R0 流水日志表。</li>
+     * </ul>
+     * 幂等:{@code CREATE TABLE IF NOT EXISTS},可重复执行。
+     */
+    private void migrateCfRewardV2TeamPool() {
+        // 迁移492: cf_team_share_config(团队池配置作用域:GLOBAL/SYSTEM/MINIAPP)
+        try {
+            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS cf_team_share_config ("
+                    + "id BIGINT AUTO_INCREMENT PRIMARY KEY, "
+                    + "scope_type VARCHAR(32) NOT NULL COMMENT '作用域类型: GLOBAL(全局)/SYSTEM(平台系统)/MINIAPP(小程序)', "
+                    + "scope_code VARCHAR(64) DEFAULT NULL COMMENT '作用域编码: SYSTEM=平台系统, MINIAPP=小程序编码, GLOBAL 为空', "
+                    + "take_rate_bps INT NOT NULL DEFAULT 1000 COMMENT '平台抽成费率(bps, 1bps=0.01%; 1000=10%)', "
+                    + "team_pool_enabled TINYINT(1) NOT NULL DEFAULT 1 COMMENT '团队池开关: 1启用 0停用', "
+                    + "default_t_bps INT NOT NULL DEFAULT 3000 COMMENT '团队池默认T比例(bps, 成本×T% 整数单; 3000=30%)', "
+                    + "on_loss VARCHAR(32) NOT NULL DEFAULT 'payout' COMMENT '亏损处理策略: payout(照常发放)/reduce(摊薄削减)/freeze(冻结)', "
+                    + "max_depth INT NOT NULL DEFAULT 8 COMMENT '团队池分配最大层级(referral tree 深度)', "
+                    + "non_goods_cost_rate INT NOT NULL DEFAULT 5000 COMMENT '非商品类流水成本率(bps: 服务/测评等 5000=50%)', "
+                    + "created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, "
+                    + "updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, "
+                    + "UNIQUE KEY uk_scope (scope_type, scope_code) "
+                    + ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队池配置作用域(迁移492)'");
+            log.info("迁移492: cf_team_share_config 表已就绪");
+        } catch (Exception e) {
+            log.warn("迁移492: cf_team_share_config 表创建失败(可能已存在): {}", e.getMessage());
+        }
+
+        // 迁移492: cf_team_pool_order(团队池订单:成本 × T% 整数单)
+        try {
+            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS cf_team_pool_order ("
+                    + "id BIGINT AUTO_INCREMENT PRIMARY KEY, "
+                    + "order_type VARCHAR(32) NOT NULL COMMENT '订单类型: product/package/member/assessment/service/subscription', "
+                    + "order_id BIGINT NOT NULL COMMENT '业务订单ID', "
+                    + "family_id BIGINT DEFAULT NULL COMMENT '家庭ID', "
+                    + "payer_member_id BIGINT DEFAULT NULL COMMENT '付款成员ID(family_members.id)', "
+                    + "gross_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '流水总额(R0)', "
+                    + "cost_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '成本金额', "
+                    + "t_bps INT NOT NULL DEFAULT 3000 COMMENT '本次实际T比例(bps)', "
+                    + "pool_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '团队池金额=成本×T%', "
+                    + "status VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT '分配状态: pending/allocated/settled', "
+                    + "created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, "
+                    + "updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, "
+                    + "UNIQUE KEY uk_order (order_type, order_id), "
+                    + "KEY idx_family (family_id) "
+                    + ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队池订单(迁移492)'");
+            log.info("迁移492: cf_team_pool_order 表已就绪");
+        } catch (Exception e) {
+            log.warn("迁移492: cf_team_pool_order 表创建失败(可能已存在): {}", e.getMessage());
+        }
+
+        // 迁移492: cf_team_pool_share(团队池份额分配:按 referral tree)
+        try {
+            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS cf_team_pool_share ("
+                    + "id BIGINT AUTO_INCREMENT PRIMARY KEY, "
+                    + "pool_order_id BIGINT NOT NULL COMMENT '关联 cf_team_pool_order.id', "
+                    + "member_id BIGINT NOT NULL COMMENT '获得份额的成员ID(family_members.id)', "
+                    + "ancestor_member_id BIGINT DEFAULT NULL COMMENT '上游推荐人(分配路径节点)', "
+                    + "depth INT NOT NULL DEFAULT 0 COMMENT 'referral tree 层级(0=直接)', "
+                    + "share_bps INT NOT NULL DEFAULT 0 COMMENT '份额比例(bps)', "
+                    + "share_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '分配金额', "
+                    + "status VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT '份额状态: pending/credited/reversed', "
+                    + "created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, "
+                    + "updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, "
+                    + "UNIQUE KEY uk_pool_member (pool_order_id, member_id, ancestor_member_id), "
+                    + "KEY idx_member (member_id) "
+                    + ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队池份额分配(迁移492)'");
+            log.info("迁移492: cf_team_pool_share 表已就绪");
+        } catch (Exception e) {
+            log.warn("迁移492: cf_team_pool_share 表创建失败(可能已存在): {}", e.getMessage());
+        }
+
+        // 迁移492: cf_platform_revenue_log(平台抽成 R0 流水日志)
+        try {
+            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS cf_platform_revenue_log ("
+                    + "id BIGINT AUTO_INCREMENT PRIMARY KEY, "
+                    + "order_type VARCHAR(32) NOT NULL COMMENT '订单类型: product/package/member/assessment/service/subscription', "
+                    + "order_id BIGINT NOT NULL COMMENT '业务订单ID', "
+                    + "family_id BIGINT DEFAULT NULL COMMENT '家庭ID', "
+                    + "gross_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '流水总额(R0)', "
+                    + "take_rate_bps INT NOT NULL DEFAULT 1000 COMMENT '本次抽成费率(bps)', "
+                    + "take_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '平台抽成金额', "
+                    + "member_id BIGINT DEFAULT NULL COMMENT '入账成员ID(直接成交人)', "
+                    + "created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, "
+                    + "UNIQUE KEY uk_revenue (order_type, order_id), "
+                    + "KEY idx_family (family_id) "
+                    + ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='平台抽成流水日志(R0, 迁移492)'");
+            log.info("迁移492: cf_platform_revenue_log 表已就绪");
+        } catch (Exception e) {
+            log.warn("迁移492: cf_platform_revenue_log 表创建失败(可能已存在): {}", e.getMessage());
+        }
     }
 
 
@@ -14723,6 +14826,11 @@ log.info("迁移298: 已为无 openid 的 child 账号补齐 family_members 记
                     "{\"base\":\"self_annual_ppoints\",\"tier_table\":\"cf_indirect_sales_tier\",\"window\":\"1y_rolling\",\"max_rate_percent\":20,\"downgrade\":true}",
                     "", "", "", "F03b", "30",
                     "基数=间接推荐人消费P点;档位按自身年度累计消费P点(cf_indirect_sales_tier);幂等ref_type与规则编码一致(F-4)"},
+            {"F03c", "团队池分润", "consume", "formula", "",
+                    "floor(pool_amount * share_bps / 10000)",
+                    "{\"base\":\"cf_team_pool_order.pool_amount\",\"t_bps\":\"cf.team_pool.default_t_bps\",\"on_loss\":\"cf.team_pool.on_loss\",\"max_depth\":\"cf.team_pool.max_depth\",\"take_rate_bps\":\"cf.platform.take_rate_bps\"}",
+                    "", "", "", "F03c", "35",
+                    "团队池分润(迁移492, S-cfc-401):平台抽成R0流水(cf_platform_revenue_log),成本×T%入池(cf_team_pool_order),按referral tree分配(cf_team_pool_share);幂等ref_type=F03c"},
             {"F04", "商品赠品CF", "consume", "per_item", "",
                     "",
                     "{\"source\":\"product_order_gift.cf_value\"}",
@@ -15023,6 +15131,20 @@ log.info("迁移298: 已为无 openid 的 child 账号补齐 family_members 记
                 "产品平台积分分成比例(bps);原散落 sys_config.product_platform_points_share", 1);
         ensureServiceConfig("cf.version", "1", "int",
                 "CF 配置版本号(单调递增,前端据此局部刷新提示)", 0);
+
+        // 迁移492: 团队池分润 v2 运营参数(cf.rewardv2.migrateConfig · S-cfc-401 T01 批次2)
+        ensureServiceConfig("cf.platform.take_rate_bps", "1000", "int",
+                "平台抽成费率(bps, 1bps=0.01%; 1000=10%);R0 流水平台抽成口径", 1);
+        ensureServiceConfig("cf.team_pool.enabled", "true", "bool",
+                "团队池分润开关(true=启用,按 referral tree 分配份额)", 1);
+        ensureServiceConfig("cf.team_pool.default_t_bps", "3000", "int",
+                "团队池默认T比例(bps, 成本×T% 整数单; 3000=30%)", 1);
+        ensureServiceConfig("cf.team_pool.on_loss", "payout", "string",
+                "团队池亏损处理策略(payout=照常发放/reduce=摊薄削减/freeze=冻结)", 1);
+        ensureServiceConfig("cf.team_pool.max_depth", "8", "int",
+                "团队池分配最大层级(referral tree 深度)", 1);
+        ensureServiceConfig("cf.team_pool.non_goods_cost_rate", "5000", "int",
+                "非商品类流水成本率(bps: 服务/测评等 5000=50%)", 1);
     }
 
     /**

+ 69 - 0
cfc-backend/src/main/resources/schema.sql

@@ -7490,3 +7490,72 @@ CREATE TABLE IF NOT EXISTS coach_recommend_log (
     KEY idx_member (member_id),
     KEY idx_target (target_type, target_id)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='AI教练推荐采纳留痕(一键采纳幂等,SC-B-07)';
+
+-- ============================================================
+-- CFC 分润 v2 团队池四表(迁移492,cf.rewardv2.migrateConfig · S-cfc-401 T01 批次2)
+-- ============================================================
+
+-- 团队池配置作用域表(GLOBAL/SYSTEM/MINIAPP,uk_scope)
+CREATE TABLE IF NOT EXISTS cf_team_share_config (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    scope_type VARCHAR(32) NOT NULL COMMENT '作用域类型: GLOBAL(全局)/SYSTEM(平台系统)/MINIAPP(小程序)',
+    scope_code VARCHAR(64) DEFAULT NULL COMMENT '作用域编码: SYSTEM=平台系统, MINIAPP=小程序编码, GLOBAL 为空',
+    take_rate_bps INT NOT NULL DEFAULT 1000 COMMENT '平台抽成费率(bps, 1bps=0.01%; 1000=10%)',
+    team_pool_enabled TINYINT(1) NOT NULL DEFAULT 1 COMMENT '团队池开关: 1启用 0停用',
+    default_t_bps INT NOT NULL DEFAULT 3000 COMMENT '团队池默认T比例(bps, 成本×T% 整数单; 3000=30%)',
+    on_loss VARCHAR(32) NOT NULL DEFAULT 'payout' COMMENT '亏损处理策略: payout(照常发放)/reduce(摊薄削减)/freeze(冻结)',
+    max_depth INT NOT NULL DEFAULT 8 COMMENT '团队池分配最大层级(referral tree 深度)',
+    non_goods_cost_rate INT NOT NULL DEFAULT 5000 COMMENT '非商品类流水成本率(bps: 服务/测评等 5000=50%)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_scope (scope_type, scope_code)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队池配置作用域(迁移492)';
+
+-- 团队池订单表(成本 × T% 整数单,uk_order)
+CREATE TABLE IF NOT EXISTS cf_team_pool_order (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    order_type VARCHAR(32) NOT NULL COMMENT '订单类型: product/package/member/assessment/service/subscription',
+    order_id BIGINT NOT NULL COMMENT '业务订单ID',
+    family_id BIGINT DEFAULT NULL COMMENT '家庭ID',
+    payer_member_id BIGINT DEFAULT NULL COMMENT '付款成员ID(family_members.id)',
+    gross_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '流水总额(R0)',
+    cost_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '成本金额',
+    t_bps INT NOT NULL DEFAULT 3000 COMMENT '本次实际T比例(bps)',
+    pool_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '团队池金额=成本×T%',
+    status VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT '分配状态: pending/allocated/settled',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_order (order_type, order_id),
+    KEY idx_family (family_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队池订单(迁移492)';
+
+-- 团队池份额分配表(按 referral tree 分配,uk_pool_member)
+CREATE TABLE IF NOT EXISTS cf_team_pool_share (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    pool_order_id BIGINT NOT NULL COMMENT '关联 cf_team_pool_order.id',
+    member_id BIGINT NOT NULL COMMENT '获得份额的成员ID(family_members.id)',
+    ancestor_member_id BIGINT DEFAULT NULL COMMENT '上游推荐人(分配路径节点)',
+    depth INT NOT NULL DEFAULT 0 COMMENT 'referral tree 层级(0=直接)',
+    share_bps INT NOT NULL DEFAULT 0 COMMENT '份额比例(bps)',
+    share_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '分配金额',
+    status VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT '份额状态: pending/credited/reversed',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_pool_member (pool_order_id, member_id, ancestor_member_id),
+    KEY idx_member (member_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队池份额分配(迁移492)';
+
+-- 平台抽成流水日志表(R0)
+CREATE TABLE IF NOT EXISTS cf_platform_revenue_log (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    order_type VARCHAR(32) NOT NULL COMMENT '订单类型: product/package/member/assessment/service/subscription',
+    order_id BIGINT NOT NULL COMMENT '业务订单ID',
+    family_id BIGINT DEFAULT NULL COMMENT '家庭ID',
+    gross_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '流水总额(R0)',
+    take_rate_bps INT NOT NULL DEFAULT 1000 COMMENT '本次抽成费率(bps)',
+    take_amount DECIMAL(14,2) NOT NULL DEFAULT 0 COMMENT '平台抽成金额',
+    member_id BIGINT DEFAULT NULL COMMENT '入账成员ID(直接成交人)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_revenue (order_type, order_id),
+    KEY idx_family (family_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='平台抽成流水日志(R0, 迁移492)';