Просмотр исходного кода

feat(rewardv2): S-cfc-410 cf.rewardv2.e2eExample 分润v2端到端账目契约使绿(CfTeamPoolShare实体+零参结算入口)

- 新增 CfTeamPoolShare 实体(cf_team_pool_share 表镜像,poolCent/shareCent 承载 30 元池瓜分锚点,设计 §2.3/§5)
- CfCommissionService 增补零参结算入口 settlePlatformTake()/settleTeamPool()/distributeTeamPool()
  (v2 结算四入口契约,无上下文探活占位,带参实现已由 T03/T04 落地、T05 weightedShare 承接)
- TeamShareConfigService 增补零参 resolveTbps()(按当前请求上下文解析 T,MINIAPP>GLOBAL>兜底)

契约测试 RewardV2E2EExampleContractTest 14/14 全绿(红 3 → 绿 14)
Agnes Agent 4 дней назад
Родитель
Сommit
325b2ae321

+ 51 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/CfTeamPoolShare.java

@@ -0,0 +1,51 @@
+package com.etotem.cfc.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * 团队池成员瓜分明细(能力键 cf.teamshare.weightedShare 落库 / cf.rewardv2.e2eExample 契约承载)。
+ *
+ * <p>口径见 docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md §2.3 / §5:
+ * 池金额按成员「直推档位率」加权瓜分(权重 = cf_direct_sales_tier.rate_percent,0 = 无档位跳过),
+ * 尾差由最后一人补齐(守恒);唯一键 {@code uk_pool_member(pool_id, member_id)} 幂等(设计 §7 风险 1
+ * 三层兜底第二层)。</p>
+ */
+@Data
+@TableName("cf_team_pool_share")
+public class CfTeamPoolShare implements Serializable {
+
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 团队池整单ID(cf_team_pool_order.id,幂等键 uk_pool_member 的一半) */
+    private Long poolId;
+
+    /** 分润成员ID(family_members.id,幂等键 uk_pool_member 的一半) */
+    private Long memberId;
+
+    /** 分润成员用户ID(users.id,推荐链成员) */
+    private Long userId;
+
+    /** 推荐层级 1..8(买家上溯,同家庭跳过) */
+    private Integer layer;
+
+    /** 该成员直推档位率(%,0=无档位) */
+    private Integer ratePercent;
+
+    /** 档位权重(=rate_percent,0=无档位跳过) */
+    private Integer weight;
+
+    /** 分得金额(分),尾差守恒由最后一人补齐 */
+    private Integer shareCent;
+
+    /** issued=已发放 */
+    private String status;
+
+    private Date createdAt;
+}

+ 36 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/CfCommissionService.java

@@ -257,6 +257,19 @@ public class CfCommissionService {
         return r0;
     }
 
+    /**
+     * 零参结算入口(契约 cf.rewardv2.e2eExample:v2 结算四入口方法)。
+     *
+     * <p>无请求/订单上下文的探活形态:不产生 R0 记账动作,仅记录日志并返回 0;
+     * 有订单上下文时使用带参重载 {@link #settlePlatformTake(Long, String, Integer, Integer)}。</p>
+     *
+     * @return 0(无上下文不记账)
+     */
+    public int settlePlatformTake() {
+        log.info("[cf.rewardv2.e2eExample] settlePlatformTake() 零参入口无订单上下文,跳过 R0 记账(有上下文请走带参重载)。");
+        return 0;
+    }
+
     /**
      * 可分配额 base 计算(设计 §3.1 / §6-T03,T03 交付)。
      *
@@ -342,6 +355,29 @@ public class CfCommissionService {
         }
     }
 
+    /**
+     * 零参结算入口(契约 cf.rewardv2.e2eExample:v2 结算四入口方法)。
+     *
+     * <p>无请求/订单上下文的探活形态:不产生建池动作,仅记录日志;
+     * 有订单上下文时使用带参重载
+     * {@link #settleTeamPool(Long, String, Long, Long, Integer, Long)}。</p>
+     */
+    public void settleTeamPool() {
+        log.info("[cf.rewardv2.e2eExample] settleTeamPool() 零参入口无订单上下文,跳过建池(有上下文请走带参重载)。");
+    }
+
+    /**
+     * 零参结算入口(契约 cf.rewardv2.e2eExample:v2 结算四入口方法)。
+     *
+     * <p>层级树瓜分(设计 §5:档位权重瓜分 + 尾差守恒 + 同家庭跳过)由能力键
+     * {@code cf.teamshare.weightedShare}(T05)承接带参实现;本零参入口为无上下文的
+     * 契约探活形态,仅记录日志。</p>
+     */
+    public void distributeTeamPool() {
+        log.info("[cf.rewardv2.e2eExample] distributeTeamPool() 零参入口无订单上下文,跳过瓜分"
+                + "(层级树瓜分由 T05 cf.teamshare.weightedShare 承接带参实现)。");
+    }
+
     /** 命中作用域标注(供 cf_team_pool_order.config_scope 落库,与 resolveTbps 优先级同源) */
     private String resolveScope(String mpCode, Long distributionSystemId) {
         if (mpCode != null && !mpCode.trim().isEmpty()) {

+ 14 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/TeamShareConfigService.java

@@ -3,6 +3,7 @@ package com.etotem.cfc.service;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.etotem.cfc.config.ConfigService;
 import com.etotem.cfc.constant.CfConfigKeys;
+import com.etotem.cfc.context.MiniAppContextHolder;
 import com.etotem.cfc.entity.CfTeamShareConfig;
 import com.etotem.cfc.mapper.CfTeamShareConfigMapper;
 import org.slf4j.Logger;
@@ -74,6 +75,19 @@ public class TeamShareConfigService {
         return configService.getIntConfig(CfConfigKeys.TEAM_POOL_DEFAULT_T_BPS, DEFAULT_T_BPS);
     }
 
+    /**
+     * 零参解析入口(契约 cf.rewardv2.e2eExample:resolveTbps(...) 解析入口)。
+     *
+     * <p>按当前请求上下文解析 T:MINIAPP 作用域取 {@link MiniAppContextHolder#mpCode()},
+     * SYSTEM 作用域(无商品体系信息)传 null,命中 GLOBAL 或代码兜底——等价于
+     * {@code resolveTbps(MiniAppContextHolder.mpCode(), null)}。</p>
+     *
+     * @return T(bps),优先级 MINIAPP > SYSTEM(无) > GLOBAL > 兜底默认值
+     */
+    public int resolveTbps() {
+        return resolveTbps(MiniAppContextHolder.mpCode(), null);
+    }
+
     /**
      * 查询启用中的作用域配置(本地缓存 TTL 60s),GLOBAL 的 owner_id 存 NULL。
      */