Browse Source

Merge remote-tracking branch 'origin/cfclub' into task/S-cfc-387

Administrator 21 hours ago
parent
commit
0ead793dfc
56 changed files with 3063 additions and 3666 deletions
  1. 0 131
      cfc-backend/src/main/java/com/etotem/cfc/config/DatabaseInitializer.java
  2. 0 46
      cfc-backend/src/main/java/com/etotem/cfc/controller/TeamStarController.java
  3. 0 276
      cfc-backend/src/main/java/com/etotem/cfc/controller/admin/TeamProfitAdminController.java
  4. 56 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/CfTeamPoolOrder.java
  5. 51 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/CfTeamPoolShare.java
  6. 41 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/CfTeamShareConfig.java
  7. 15 0
      cfc-backend/src/main/java/com/etotem/cfc/mapper/CfTeamPoolOrderMapper.java
  8. 16 0
      cfc-backend/src/main/java/com/etotem/cfc/mapper/CfTeamPoolShareMapper.java
  9. 12 0
      cfc-backend/src/main/java/com/etotem/cfc/mapper/CfTeamShareConfigMapper.java
  10. 0 10
      cfc-backend/src/main/java/com/etotem/cfc/service/AssessmentOrderService.java
  11. 418 0
      cfc-backend/src/main/java/com/etotem/cfc/service/CfCommissionService.java
  12. 159 20
      cfc-backend/src/main/java/com/etotem/cfc/service/EnergyRuleEngine.java
  13. 32 0
      cfc-backend/src/main/java/com/etotem/cfc/service/EnergyService.java
  14. 0 15
      cfc-backend/src/main/java/com/etotem/cfc/service/MemberSubscriptionService.java
  15. 0 11
      cfc-backend/src/main/java/com/etotem/cfc/service/MembershipService.java
  16. 0 9
      cfc-backend/src/main/java/com/etotem/cfc/service/PaymentService.java
  17. 0 19
      cfc-backend/src/main/java/com/etotem/cfc/service/ProductOrderService.java
  18. 0 283
      cfc-backend/src/main/java/com/etotem/cfc/service/ProfitPoolService.java
  19. 3 15
      cfc-backend/src/main/java/com/etotem/cfc/service/StarDigestService.java
  20. 0 512
      cfc-backend/src/main/java/com/etotem/cfc/service/StarScoreCalculator.java
  21. 0 92
      cfc-backend/src/main/java/com/etotem/cfc/service/TeamProfitFlowService.java
  22. 0 316
      cfc-backend/src/main/java/com/etotem/cfc/service/TeamProfitService.java
  23. 130 0
      cfc-backend/src/main/java/com/etotem/cfc/service/TeamShareConfigService.java
  24. 0 376
      cfc-backend/src/main/java/com/etotem/cfc/task/TeamProfitCronTask.java
  25. 0 169
      cfc-backend/src/test/java/com/etotem/cfc/service/ProfitPoolOrderContractRedTest.java
  26. 0 150
      cfc-backend/src/test/java/com/etotem/cfc/service/StarScoreCalculatorContractRedTest.java
  27. 0 133
      cfc-backend/src/test/java/com/etotem/cfc/service/TeamAwardRecordContractRedTest.java
  28. 0 163
      cfc-backend/src/test/java/com/etotem/cfc/service/TeamShareRecordEightShareContractRedTest.java
  29. 157 0
      cfc-backend/src/test/java/com/etotem/cfc/unit/LegacyProfitSystemRemovedGuardTest.java
  30. 0 354
      cfc-backend/src/test/java/com/etotem/cfc/unit/TeamProfitCronContractTest.java
  31. 0 249
      cfc-backend/src/test/java/com/etotem/cfc/unit/TeamProfitPipelineContractTest.java
  32. 0 311
      cfc-backend/src/test/java/com/etotem/cfc/unit/TeamStarMultiplierContractTest.java
  33. 1 1
      cfc-web/.last_build_commit
  34. 2 2
      cfc-web/package-lock.json
  35. 1 1
      cfc-web/package.json
  36. 123 0
      cfc-web/public/CHANGELOG-v1.0.md
  37. 124 1
      cfc-web/public/CHANGELOG.md
  38. 38 0
      docs/tdd/automation-run-2026-11-16-R227.md
  39. 81 0
      docs/tdd/impl-2026-11-16-S-cfc-407-rewardv2-weightedShare.md
  40. 93 0
      docs/tdd/impl-2026-11-16-S-cfc-408-rewardv2-dispatchF03c.md
  41. 48 0
      docs/tdd/orchestration/report-deploy-2026-11-16-96311452.md
  42. 52 0
      docs/tdd/orchestration/report-deploy-2026-11-16-ae2196a31.md
  43. 46 0
      docs/tdd/orchestration/report-deploy-2026-11-16-b4c755f6b.md
  44. 53 0
      docs/tdd/orchestration/report-deploy-2026-11-16-c75a707ae.md
  45. 162 0
      docs/tdd/orchestration/report-dev-2026-11-16-0348.md
  46. 165 0
      docs/tdd/orchestration/report-dev-2026-11-16-0505.md
  47. 165 0
      docs/tdd/orchestration/report-dev-2026-11-16-0625.md
  48. 196 0
      docs/tdd/orchestration/report-test-2026-11-16-R226.md
  49. 307 0
      docs/tdd/orchestration/report-test-2026-11-16-R227.md
  50. 35 0
      docs/tdd/test/automation-run-2026-11-16-R226.md
  51. 16 1
      docs/tdd/test/blockers.md
  52. 42 0
      docs/tdd/test/notice-2026-11-16-R227-研发通知.md
  53. 50 0
      notice-2026-11-16-R226-研发通知.md
  54. 49 0
      tests/test-cases/2026-11-16-global-search-notification.md
  55. 72 0
      tests/test-cases/2026-11-16-rewardv2-energy-legacy.md
  56. 52 0
      tests/test-cases/2026-11-16-teamshare-create-pool.md

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

@@ -3538,19 +3538,8 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
         // 迁移457: survey_records 添加 source 列(区分定期调研/健康阅卷,HL-01 健康阅卷入口)
         ensureColumn("survey_records", "source", "VARCHAR(32) DEFAULT 'periodic' COMMENT '记录来源: periodic=定期调研 / health_review=健康阅卷'");
 
-        // 迁移458: 单笔订单利润池计算明细表(团队分润 §7.1,uk_order 幂等)
-        createProfitPoolOrderTable();
-        // 迁移459: 团队8份分佣流水表(§7.3,uk_order_rec 幂等)
-        createTeamShareRecordTable();
-        // 迁移460: 团队奖流水表(§7.4,uk_order_team 幂等)
-        createTeamAwardRecordTable();
         // 迁移461: 团队成员星级月度快照表(§7.6,uk_user_period 幂等)
         createTeamStarSnapshotTable();
-        // 迁移462: 服务成本价配置表(§7.5,uk_service_cost 幂等;成本价回填通道,S-cfc-62 team.profit.hook)
-        createServiceCostConfigTable();
-        // 迁移463: service_cost_config 补 §7.5 规格列 service_name/enabled(S-cfc-68 team.admin.manage 成本价管理端维护载体)
-        ensureColumn("service_cost_config", "service_name", "VARCHAR(64) NULL COMMENT '服务名称'");
-        ensureColumn("service_cost_config", "enabled", "TINYINT DEFAULT 1 COMMENT '是否启用: 1=启用 0=停用'");
 
         // 迁移464: 创建 P3 跨案例聚合承载表 attribution_case_strategies(T15 跨案例聚合,S-cfc-119 guhe.p3.lowSideAggregate)
         createAttributionCaseStrategyTable();
@@ -4189,97 +4178,6 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
         }
     }
 
-    /**
-     * 迁移458: 创建单笔订单利润池计算明细表(§7.1)。
-     *
-     * <p>承载 §2.1 总账模型逐项核算;{@code uk_order(order_type, order_id)} 唯一键
-     * 保证重复回调幂等(§8.3)。触发源(order_type)在 §4.7 杠杆 1 扩展
-     * membership/subscription/assessment_retest(T9 收入管道化)。</p>
-     */
-    private void createProfitPoolOrderTable() {
-        try {
-            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS profit_pool_order ("
-                    + "id BIGINT AUTO_INCREMENT PRIMARY KEY,"
-                    + "order_id BIGINT NOT NULL COMMENT '来源订单ID',"
-                    + "order_type VARCHAR(32) NOT NULL COMMENT '触发源: product/service/assessment/package/membership/subscription/assessment_retest',"
-                    + "product_id BIGINT NULL COMMENT '商品/服务ID',"
-                    + "amount_cent INT NOT NULL COMMENT '售价S(分)',"
-                    + "cost_cent INT NOT NULL COMMENT '平台成本价C(分)',"
-                    + "platform_retain_cent INT NOT NULL COMMENT '平台留存P=S-C(分)',"
-                    + "ops_cent INT NOT NULL COMMENT '平台运营O(分)',"
-                    + "cf_cost_cent INT NOT NULL COMMENT 'CF值成本F(分)',"
-                    + "pool_cent INT NOT NULL COMMENT '可分配池D(分)',"
-                    + "referral_share_cent INT NOT NULL COMMENT '推荐人体系R(分,CF值预算参照)',"
-                    + "team_share_cent INT NOT NULL COMMENT '团队体系T(分,货币)',"
-                    + "team_eight_share_cent INT NOT NULL COMMENT '8份分佣池(分,默认T×80%)',"
-                    + "team_award_cent INT NOT NULL COMMENT '团队奖池(分,默认T×20%)',"
-                    + "status VARCHAR(16) NOT NULL DEFAULT 'pending' COMMENT 'pending/settled/cancelled',"
-                    + "created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',"
-                    + "settled_at DATETIME NULL COMMENT '结算时间',"
-                    + "UNIQUE KEY uk_order (order_type, order_id)"
-                    + ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='单笔订单利润池计算明细'");
-            log.info("迁移458: profit_pool_order 表已就绪");
-        } catch (Exception e) {
-            log.warn("迁移458: profit_pool_order 创建失败: {}", e.getMessage());
-        }
-    }
-
-    /**
-     * 迁移459: 创建团队 8 份分佣流水表(§7.3)。
-     *
-     * <p>{@code uk_order_rec(order_id, recipient_user_id, layer)} 唯一键保证重复回调幂等(§8.3)。</p>
-     */
-    private void createTeamShareRecordTable() {
-        try {
-            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS team_share_record ("
-                    + "id BIGINT AUTO_INCREMENT PRIMARY KEY,"
-                    + "order_id BIGINT NOT NULL COMMENT '来源订单ID',"
-                    + "order_type VARCHAR(32) NOT NULL COMMENT '触发源',"
-                    + "pool_id BIGINT NOT NULL COMMENT '归属利润池明细profit_pool_order.id',"
-                    + "provider_user_id BIGINT NOT NULL COMMENT '服务提供者(规划师/测评师)',"
-                    + "recipient_user_id BIGINT NOT NULL COMMENT '获得分润的团队成员',"
-                    + "layer INT NOT NULL COMMENT '1=服务者本人 2=引荐人 3=引荐人的引荐人',"
-                    + "star_level INT NULL COMMENT '该成员当期星级快照(1-6)',"
-                    + "shares INT NOT NULL COMMENT '分得份数(0-8)',"
-                    + "share_cent INT NOT NULL COMMENT '分润金额(分)',"
-                    + "status VARCHAR(16) NOT NULL DEFAULT 'pending' COMMENT 'pending/settled/cancelled',"
-                    + "created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',"
-                    + "UNIQUE KEY uk_order_rec (order_id, recipient_user_id, layer),"
-                    + "KEY idx_recipient (recipient_user_id)"
-                    + ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队8份分佣流水(货币)'");
-            log.info("迁移459: team_share_record 表已就绪");
-        } catch (Exception e) {
-            log.warn("迁移459: team_share_record 创建失败: {}", e.getMessage());
-        }
-    }
-
-    /**
-     * 迁移460: 创建团队奖流水表(§7.4)。
-     *
-     * <p>{@code uk_order_team(order_id, team_id)} 唯一键保证重复回调幂等(§8.3)。</p>
-     */
-    private void createTeamAwardRecordTable() {
-        try {
-            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS team_award_record ("
-                    + "id BIGINT AUTO_INCREMENT PRIMARY KEY,"
-                    + "order_id BIGINT NOT NULL COMMENT '来源订单ID',"
-                    + "order_type VARCHAR(32) NOT NULL COMMENT '触发源',"
-                    + "pool_id BIGINT NOT NULL COMMENT '归属利润池明细profit_pool_order.id',"
-                    + "team_id BIGINT NOT NULL COMMENT 'distribution_systems.id',"
-                    + "owner_user_id BIGINT NOT NULL COMMENT '团队负责人(owner_id/根)',"
-                    + "tier VARCHAR(8) NOT NULL COMMENT 'TA0/TA1/TA2/TA3',"
-                    + "award_cent INT NOT NULL COMMENT '团队奖金额(分)',"
-                    + "status VARCHAR(16) NOT NULL DEFAULT 'pending' COMMENT 'pending/settled/cancelled',"
-                    + "created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',"
-                    + "UNIQUE KEY uk_order_team (order_id, team_id),"
-                    + "KEY idx_owner (owner_user_id)"
-                    + ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队奖流水(货币)'");
-            log.info("迁移460: team_award_record 表已就绪");
-        } catch (Exception e) {
-            log.warn("迁移460: team_award_record 创建失败: {}", e.getMessage());
-        }
-    }
-
     /**
      * 迁移461: 创建团队成员星级月度快照表(§7.6)。
      *
@@ -4307,35 +4205,6 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
         }
     }
 
-    /**
-     * 迁移462: 创建服务成本价配置表(§7.5)。
-     *
-     * <p>{@code uk_service_cost(service_type, product_id)} 唯一键(NULL=对该类型通配);
-     * 供 §2.1 利润漏斗平台成本价 C 取值回填通道(默认 0,由配置键/管理端维护)。幂等:
-     * CREATE TABLE IF NOT EXISTS。</p>
-     *
-     * <p>口径来源:docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md §7.5,
-     * 能力键 S-cfc-62 team.profit.hook 第 4 张表。</p>
-     */
-    private void createServiceCostConfigTable() {
-        try {
-            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS service_cost_config ("
-                    + "id BIGINT AUTO_INCREMENT PRIMARY KEY,"
-                    + "service_type VARCHAR(32) NOT NULL COMMENT '触发源',"
-                    + "product_id BIGINT NULL COMMENT '商品/服务ID(NULL=对该类型通配)',"
-                    + "cost_cent INT NOT NULL COMMENT '平台成本价 C(分)',"
-                    + "source VARCHAR(16) NOT NULL DEFAULT 'manual' COMMENT '成本来源: manual=人工维护/auto=自动测算',"
-                    + "remark VARCHAR(255) NULL COMMENT '备注',"
-                    + "created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',"
-                    + "updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',"
-                    + "UNIQUE KEY uk_service_cost (service_type, product_id)"
-                    + ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务成本价配置'");
-            log.info("迁移462: service_cost_config 表已就绪");
-        } catch (Exception e) {
-            log.warn("迁移462: service_cost_config 创建失败: {}", e.getMessage());
-        }
-    }
-
     /**
      * 迁移450: 会员权益文案与实际成交口径对齐(DML,幂等)。
      *

+ 0 - 46
cfc-backend/src/main/java/com/etotem/cfc/controller/TeamStarController.java

@@ -1,46 +0,0 @@
-package com.etotem.cfc.controller;
-
-import com.etotem.cfc.common.Result;
-import com.etotem.cfc.dto.TeamStarMyViewVO;
-import com.etotem.cfc.service.StarScoreCalculator;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestAttribute;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-
-import javax.annotation.Resource;
-
-/**
- * 用户端团队星级看板(能力键 {@code team.star.myView},单元 team,§12-T7)。
- *
- * <p>契约溯源:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md} v0.7
- * §12-T7(星级看板与换算)+ §11-#13(按推荐全做 P1 看板+换算)+ §4.3.1 ①②。</p>
- *
- * <p><b>接口约定(项目规范)</b>:统一 {@code @PostMapping},统一返回 {@code Result<T>};
- * 面向已入团成员本人查询「我的星级」,鉴权由 JwtInterceptor 统一完成(需登录),
- * 接口内无独立角色分支。</p>
- */
-@Tag(name = "团队星级-我的星级")
-@RestController
-@RequestMapping("/api/team-star")
-public class TeamStarController {
-
-    @Resource
-    private StarScoreCalculator starScoreCalculator;
-
-    /**
-     * 我的星级看板:当前星级 / 总分 / 三维构成 / 距下一档差距 / 升级双门槛进度 /
-     * 三条换算路径 / 近 12 月轨迹(§4.3.1 ①②)。
-     */
-    @Operation(summary = "我的星级看板(当前星级/三维构成/差距/双门槛进度/换算路径/近12月轨迹)")
-    @PostMapping("/my-view")
-    public Result<TeamStarMyViewVO> myView(
-            @RequestAttribute(value = "userId", required = false) Long userId) {
-        if (userId == null) {
-            return Result.error(401, "未登录或登录已过期");
-        }
-        return Result.success(starScoreCalculator.myView(userId));
-    }
-}

+ 0 - 276
cfc-backend/src/main/java/com/etotem/cfc/controller/admin/TeamProfitAdminController.java

@@ -1,276 +0,0 @@
-package com.etotem.cfc.controller.admin;
-
-import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
-import com.etotem.cfc.common.AdminRoles;
-import com.etotem.cfc.common.Result;
-import com.etotem.cfc.entity.TeamAwardRecord;
-import com.etotem.cfc.entity.TeamShareRecord;
-import com.etotem.cfc.entity.WithdrawalRequest;
-import com.etotem.cfc.service.ServiceCostConfigService;
-import com.etotem.cfc.service.TeamProfitConfigService;
-import com.etotem.cfc.service.TeamProfitFlowService;
-import com.etotem.cfc.service.WithdrawalService;
-import com.etotem.cfc.util.ParamUtils;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestAttribute;
-import org.springframework.web.bind.annotation.RestController;
-
-import javax.annotation.Resource;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Map;
-
-/**
- * 管理端团队分润(能力键 {@code team.admin.manage},单元 admin,§12-T5)。
- *
- * <p>契约溯源:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md} v0.7
- * §12-T5:成本价/星级档位(后台配置 #12)/团队门槛/团队奖分档配置 + 分润流水查询与提现审核
- * (复用现有管理端佣金模式)。</p>
- *
- * <p><b>接口约定(项目规范)</b>:{@code /api/admin} 前缀统一 {@code @PostMapping},
- * JwtInterceptor 拦截 + 控制器内管理员角色门禁(admin/operator/finance 平台角色)。</p>
- *
- * <p><b>规格:docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md v0.7
- * §7.5 + §7.8 + §11-#12 + §12-T5。</b></p>
- */
-@Tag(name = "管理端-团队分润")
-@RestController
-@RequestMapping("/api/admin/team-profit")
-public class TeamProfitAdminController {
-
-    @Resource
-    private TeamProfitConfigService teamProfitConfigService;
-
-    @Resource
-    private TeamProfitFlowService teamProfitFlowService;
-
-    @Resource
-    private ServiceCostConfigService serviceCostConfigService;
-
-    @Resource
-    private WithdrawalService withdrawalService;
-
-    // ==================== 配置(§7.8 + §11-#12) ====================
-
-    @Operation(summary = "团队分润配置总览(星级档位/比率/份额/归属/权重)")
-    @PostMapping("/config")
-    public Result<Map<String, Object>> config(@RequestAttribute("role") String role,
-                                              @RequestAttribute(value = "roles", required = false) List<String> roles) {
-        Result<Map<String, Object>> gate = requirePlatformRole(role, roles);
-        if (gate != null) {
-            return gate;
-        }
-        Map<String, Object> data = new LinkedHashMap<>();
-        data.put("starTiers", teamProfitConfigService.getStarTiers());
-        data.put("eightShareRatio", teamProfitConfigService.getEightShareRatio());
-        data.put("teamAwardRatio", teamProfitConfigService.getTeamAwardRatio());
-        data.put("shareTotal", teamProfitConfigService.getShareTotal());
-        data.put("awardDistribute", teamProfitConfigService.getAwardDistribute());
-        data.put("starWeight", teamProfitConfigService.getStarWeight());
-        return Result.success(data);
-    }
-
-    @Operation(summary = "保存星级档位(后台配置 #12,非 6 档拒收)")
-    @PostMapping("/config/star-tiers")
-    public Result<String> saveStarTiers(@RequestBody(required = false) Map<String, Object> body,
-                                        @RequestAttribute("role") String role,
-                                        @RequestAttribute(value = "roles", required = false) List<String> roles) {
-        Result<Map<String, Object>> gate = requirePlatformRole(role, roles);
-        if (gate != null) {
-            return Result.error(gate.getCode(), gate.getMessage());
-        }
-        if (body == null) {
-            return Result.badRequest("请求体不能为空");
-        }
-        int[] tiers = toIntArray(body.get("starTiers"));
-        if (tiers == null) {
-            return Result.badRequest("starTiers 不能为空");
-        }
-        try {
-            teamProfitConfigService.saveStarTiers(tiers);
-        } catch (IllegalArgumentException e) {
-            return Result.badRequest(e.getMessage());
-        }
-        return Result.success("星级档位已保存");
-    }
-
-    @Operation(summary = "保存团队分润配置项(写入 service_config group_key='team_profit')")
-    @PostMapping("/config/save")
-    public Result<String> saveConfig(@RequestBody(required = false) Map<String, Object> body,
-                                     @RequestAttribute("role") String role,
-                                     @RequestAttribute(value = "roles", required = false) List<String> roles) {
-        Result<Map<String, Object>> gate = requirePlatformRole(role, roles);
-        if (gate != null) {
-            return Result.error(gate.getCode(), gate.getMessage());
-        }
-        if (body == null) {
-            return Result.badRequest("请求体不能为空");
-        }
-        String key = (String) body.get("key");
-        String value = body.get("value") != null ? String.valueOf(body.get("value")) : null;
-        if (key == null || key.trim().isEmpty()) {
-            return Result.badRequest("配置键不能为空");
-        }
-        try {
-            teamProfitConfigService.saveConfig(key, value);
-        } catch (IllegalArgumentException e) {
-            return Result.badRequest(e.getMessage());
-        }
-        return Result.success("配置已保存");
-    }
-
-    // ==================== 分润流水查询(§7.3/§7.4) ====================
-
-    @Operation(summary = "8 份分佣流水分页查询(§7.3 team_share_record)")
-    @PostMapping("/flow/share-records")
-    public Result<Page<TeamShareRecord>> shareRecords(@RequestBody(required = false) Map<String, Object> body,
-                                                      @RequestAttribute("role") String role,
-                                                      @RequestAttribute(value = "roles", required = false) List<String> roles) {
-        Result<Map<String, Object>> gate = requirePlatformRole(role, roles);
-        if (gate != null) {
-            return Result.error(gate.getCode(), gate.getMessage());
-        }
-        Long recipientUserId = ParamUtils.getLong(body != null ? body.get("recipientUserId") : null);
-        String status = body != null ? (String) body.get("status") : null;
-        int page = (int) ParamUtils.getLong(body != null ? body.get("page") : null, 1L);
-        int size = (int) ParamUtils.getLong(body != null ? body.get("size") : null, 10L);
-        return Result.success(teamProfitFlowService.queryTeamShareRecords(recipientUserId, status, page, size));
-    }
-
-    @Operation(summary = "团队奖流水分页查询(§7.4 team_award_record)")
-    @PostMapping("/flow/award-records")
-    public Result<Page<TeamAwardRecord>> awardRecords(@RequestBody(required = false) Map<String, Object> body,
-                                                      @RequestAttribute("role") String role,
-                                                      @RequestAttribute(value = "roles", required = false) List<String> roles) {
-        Result<Map<String, Object>> gate = requirePlatformRole(role, roles);
-        if (gate != null) {
-            return Result.error(gate.getCode(), gate.getMessage());
-        }
-        Long teamId = ParamUtils.getLong(body != null ? body.get("teamId") : null);
-        String status = body != null ? (String) body.get("status") : null;
-        int page = (int) ParamUtils.getLong(body != null ? body.get("page") : null, 1L);
-        int size = (int) ParamUtils.getLong(body != null ? body.get("size") : null, 10L);
-        return Result.success(teamProfitFlowService.queryTeamAwardRecords(teamId, status, page, size));
-    }
-
-    // ==================== 成本价配置(§7.5) ====================
-
-    @Operation(summary = "读取服务成本价 C(分)")
-    @PostMapping("/cost/get")
-    public Result<Integer> getCost(@RequestBody(required = false) Map<String, Object> body,
-                                   @RequestAttribute("role") String role,
-                                   @RequestAttribute(value = "roles", required = false) List<String> roles) {
-        Result<Map<String, Object>> gate = requirePlatformRole(role, roles);
-        if (gate != null) {
-            return Result.error(gate.getCode(), gate.getMessage());
-        }
-        String serviceType = body != null ? (String) body.get("serviceType") : null;
-        return Result.success(serviceCostConfigService.getCostCent(serviceType));
-    }
-
-    @Operation(summary = "保存服务成本价 C(分,管理端维护)")
-    @PostMapping("/cost/save")
-    public Result<Integer> saveCost(@RequestBody(required = false) Map<String, Object> body,
-                                    @RequestAttribute("role") String role,
-                                    @RequestAttribute(value = "roles", required = false) List<String> roles) {
-        Result<Map<String, Object>> gate = requirePlatformRole(role, roles);
-        if (gate != null) {
-            return Result.error(gate.getCode(), gate.getMessage());
-        }
-        if (body == null) {
-            return Result.badRequest("请求体不能为空");
-        }
-        String serviceType = (String) body.get("serviceType");
-        String serviceName = (String) body.get("serviceName");
-        int costCent = (int) ParamUtils.getLong(body.get("costCent"), -1L);
-        if (serviceType == null || serviceType.trim().isEmpty()) {
-            return Result.badRequest("serviceType 不能为空");
-        }
-        if (costCent < 0) {
-            return Result.badRequest("costCent 不能为负数");
-        }
-        try {
-            return Result.success(serviceCostConfigService.saveCostCent(serviceType, serviceName, costCent));
-        } catch (IllegalArgumentException e) {
-            return Result.badRequest(e.getMessage());
-        }
-    }
-
-    // ==================== 提现审核(复用 withdrawal_requests,type=team_share/team_award,§11-#7) ====================
-
-    @Operation(summary = "提现审核列表(按来源 type=team_share/team_award 过滤,§11-#7)")
-    @PostMapping("/withdrawal/list")
-    public Result<Page<WithdrawalRequest>> withdrawalList(@RequestBody(required = false) Map<String, Object> body,
-                                                          @RequestAttribute("role") String role,
-                                                          @RequestAttribute(value = "roles", required = false) List<String> roles) {
-        Result<Map<String, Object>> gate = requirePlatformRole(role, roles);
-        if (gate != null) {
-            return Result.error(gate.getCode(), gate.getMessage());
-        }
-        String status = body != null ? (String) body.get("status") : null;
-        String type = body != null ? (String) body.get("type") : null;
-        int page = (int) ParamUtils.getLong(body != null ? body.get("page") : null, 1L);
-        int size = (int) ParamUtils.getLong(body != null ? body.get("size") : null, 10L);
-        return Result.success(withdrawalService.getAdminList(status, type, page, size));
-    }
-
-    // ==================== 内部辅助 ====================
-
-    /** 管理员角色门禁:平台角色(admin/operator/finance)直通;否则 403。 */
-    private Result<Map<String, Object>> requirePlatformRole(String role, List<String> roles) {
-        if ("admin".equals(role) || AdminRoles.hasAnyPlatformRole(roles)) {
-            return null;
-        }
-        return Result.forbidden("无权限:需要管理员角色");
-    }
-
-    /** 解析请求体中的 int[](接受 List<Number>/List<String>/int[]),失败返回 null。 */
-    private int[] toIntArray(Object value) {
-        if (value == null) {
-            return null;
-        }
-        if (value instanceof int[]) {
-            return ((int[]) value).clone();
-        }
-        if (value instanceof List) {
-            List<?> list = (List<?>) value;
-            int[] result = new int[list.size()];
-            for (int i = 0; i < list.size(); i++) {
-                Object item = list.get(i);
-                if (item instanceof Number) {
-                    result[i] = ((Number) item).intValue();
-                } else if (item instanceof String) {
-                    try {
-                        result[i] = Integer.parseInt(((String) item).trim());
-                    } catch (NumberFormatException e) {
-                        return null;
-                    }
-                } else {
-                    return null;
-                }
-            }
-            return result;
-        }
-        if (value instanceof String) {
-            String raw = ((String) value).replace('[', ' ').replace(']', ' ').trim();
-            if (raw.isEmpty()) {
-                return null;
-            }
-            String[] parts = raw.split("[,/]");
-            int[] result = new int[parts.length];
-            for (int i = 0; i < parts.length; i++) {
-                try {
-                    result[i] = Integer.parseInt(parts[i].trim());
-                } catch (NumberFormatException e) {
-                    return null;
-                }
-            }
-            return result;
-        }
-        return null;
-    }
-}

+ 56 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/CfTeamPoolOrder.java

@@ -0,0 +1,56 @@
+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.createPool,T04 建池落库)。
+ *
+ * <p>口径见 docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md §2.2:
+ * 池金额 = 成本 × T%(从成本侧切出,与毛利 base 脱钩);唯一键 {@code uk_order(order_type, order_id)}
+ * 幂等建池——同一订单重复结算命中唯一键直接返回,不重复建池(设计 §7 风险 1 三层兜底第一层)。
+ * 状态流转:pooled=已建池(待瓜分)→ share_issued=已瓜分 / unclaimed=无成员可瓜分。</p>
+ */
+@Data
+@TableName("cf_team_pool_order")
+public class CfTeamPoolOrder implements Serializable {
+
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 来源订单ID(幂等键 uk_order 的一半) */
+    private Long orderId;
+
+    /** 来源订单类型(product/membership/assessment 等,幂等键 uk_order 的一半) */
+    private String orderType;
+
+    /** 商品ID(商品订单) */
+    private Long productId;
+
+    /** 买家用户ID(users.id) */
+    private Long buyerUserId;
+
+    /** 团队池金额(分)= Σ floor(成本 × qty × T_bps / 10000) */
+    private Integer poolCent;
+
+    /** 实际采用 T(bps,如 3000=30%) */
+    private Integer tBps;
+
+    /** 命中作用域 GLOBAL/SYSTEM/MINIAPP(resolveTbps 优先级链结果) */
+    private String configScope;
+
+    /** pooled=已建池 / share_issued=已瓜分 / unclaimed=无成员可瓜分 */
+    private String status;
+
+    private String remark;
+
+    private Date createdAt;
+
+    /** 瓜分完成时间(share_issued 时回填,pooled 阶段为 null) */
+    private Date settledAt;
+}

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

+ 41 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/CfTeamShareConfig.java

@@ -0,0 +1,41 @@
+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;
+
+/**
+ * 团队分润池比例配置(T% 多作用域解析,能力键 cf.teamshare.config.resolve)。
+ *
+ * <p>口径见 docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md §2.1:
+ * owner_type 三作用域 GLOBAL/SYSTEM/MINIAPP,优先级链 MINIAPP(mp_code) → SYSTEM(商品所属
+ * distribution_system_id) → GLOBAL → 代码兜底 3000bps;唯一键 {@code uk_scope(owner_type, owner_id)}
+ * 幂等。</p>
+ */
+@Data
+@TableName("cf_team_share_config")
+public class CfTeamShareConfig implements Serializable {
+
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 作用域: GLOBAL / SYSTEM / MINIAPP */
+    private String ownerType;
+
+    /** SYSTEM=distribution_systems.id / MINIAPP=miniapp_config.mp_code / GLOBAL=NULL */
+    private String ownerId;
+
+    /** 团队池比例(bps,如 3000 = 30%) */
+    private Integer tBps;
+
+    /** 1启用 0停用 */
+    private Integer enabled;
+
+    private Date createdAt;
+
+    private Date updatedAt;
+}

+ 15 - 0
cfc-backend/src/main/java/com/etotem/cfc/mapper/CfTeamPoolOrderMapper.java

@@ -0,0 +1,15 @@
+package com.etotem.cfc.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.etotem.cfc.entity.CfTeamPoolOrder;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * 团队分润池整单 Mapper(能力键 cf.teamshare.createPool,T04 建池落库)。
+ *
+ * <p>建池走 {@code uk_order(order_type, order_id)} 幂等:重复结算命中唯一键
+ * 抛 {@link org.springframework.dao.DuplicateKeyException},由调用方捕获短路(设计 §7 风险 1)。</p>
+ */
+@Mapper
+public interface CfTeamPoolOrderMapper extends BaseMapper<CfTeamPoolOrder> {
+}

+ 16 - 0
cfc-backend/src/main/java/com/etotem/cfc/mapper/CfTeamPoolShareMapper.java

@@ -0,0 +1,16 @@
+package com.etotem.cfc.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.etotem.cfc.entity.CfTeamPoolShare;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * 团队池成员瓜分明细 Mapper(能力键 {@code cf.teamshare.weightedShare},T05 瓜分落库)。
+ *
+ * <p>瓜分先发放再插明细;插入走 {@code uk_pool_member(pool_id, member_id)} 幂等——重复结算命中
+ * 唯一键抛 {@link org.springframework.dao.DuplicateKeyException},由调用方捕获短路
+ * (设计 §7 风险 1 三层兜底第二层,cf_team_pool_share 见 scheme §2.3)。</p>
+ */
+@Mapper
+public interface CfTeamPoolShareMapper extends BaseMapper<CfTeamPoolShare> {
+}

+ 12 - 0
cfc-backend/src/main/java/com/etotem/cfc/mapper/CfTeamShareConfigMapper.java

@@ -0,0 +1,12 @@
+package com.etotem.cfc.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.etotem.cfc.entity.CfTeamShareConfig;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * 团队分润池比例配置 Mapper(能力键 cf.teamshare.config.resolve,T02 T% 解析依赖)。
+ */
+@Mapper
+public interface CfTeamShareConfigMapper extends BaseMapper<CfTeamShareConfig> {
+}

+ 0 - 10
cfc-backend/src/main/java/com/etotem/cfc/service/AssessmentOrderService.java

@@ -34,9 +34,6 @@ public class AssessmentOrderService extends ServiceImpl<AssessmentOrderMapper, A
     @Resource
     private CfCommissionService cfCommissionService;
 
-    @Resource
-    private ProfitPoolService profitPoolService;
-
     @Resource
     private AssessmentQuotaService assessmentQuotaService;
 
@@ -93,13 +90,6 @@ public class AssessmentOrderService extends ServiceImpl<AssessmentOrderMapper, A
             cfCommissionService.settle(order.getId(), "assessment", order.getUserId(),
                     buyerFamilyId,
                     order.getActualPrice() != null ? order.getActualPrice().intValue() : 0, null);
-            // 团队分润池钩子(§12-T3 同点位并行调用,S-cfc-62 team.profit.hook)
-            try {
-                profitPoolService.settle(order.getId(), "assessment", null,
-                        (long) (order.getActualPrice() != null ? order.getActualPrice().intValue() : 0), 0L);
-            } catch (Exception e) {
-                log.error("团队分润池核算失败: orderId={}, type=assessment, error={}", order.getId(), e.getMessage());
-            }
             // 支付成功生成测评额度(SC-P-34/SC-P-35:额度过期不可用于预约)
             grantQuotaForPaidOrder(order);
         }

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

@@ -3,11 +3,14 @@ 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.dto.CfEarnResult;
 import com.etotem.cfc.entity.CfDirectSalesTier;
 import com.etotem.cfc.entity.CfEarnRule;
 import com.etotem.cfc.entity.CfIndirectSalesTier;
 import com.etotem.cfc.entity.CfPlatformRevenueLog;
+import com.etotem.cfc.entity.CfTeamPoolOrder;
+import com.etotem.cfc.entity.CfTeamPoolShare;
 import com.etotem.cfc.entity.FamilyMember;
 import com.etotem.cfc.entity.OctopusEffectKeyPerson;
 import com.etotem.cfc.entity.OctopusEffectRecord;
@@ -21,6 +24,8 @@ import com.etotem.cfc.entity.ProductOrder;
 import com.etotem.cfc.entity.ReferralTree;
 import com.etotem.cfc.entity.User;
 import com.etotem.cfc.mapper.CfPlatformRevenueLogMapper;
+import com.etotem.cfc.mapper.CfTeamPoolOrderMapper;
+import com.etotem.cfc.mapper.CfTeamPoolShareMapper;
 import com.etotem.cfc.mapper.FamilyMemberMapper;
 import com.etotem.cfc.mapper.MembershipLevelMapper;
 import com.etotem.cfc.mapper.ProductGiftRuleMapper;
@@ -42,6 +47,8 @@ import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
 import javax.annotation.Resource;
+import java.util.ArrayList;
+import java.util.Collections;
 import java.util.Date;
 import java.util.HashMap;
 import java.util.HashSet;
@@ -83,6 +90,9 @@ public class CfCommissionService {
     /** 间接销售奖规则编码(cf_earn_rule.code) */
     public static final String RULE_INDIRECT_SALES = "F03b";
 
+    /** 团队分润池规则编码(cf_earn_rule.code,分润 v2 §3.1:成本 × T% 池内瓜分) */
+    public static final String RULE_TEAM_POOL = "F03c";
+
     /** F03a 团队口径最大层级(§4.1.1:团队 8 层以内) */
     private static final int TEAM_DEPTH = 8;
 
@@ -132,6 +142,12 @@ public class CfCommissionService {
     private ObjectMapper objectMapper;
     @Resource
     private CfPlatformRevenueLogMapper cfPlatformRevenueLogMapper;
+    @Resource
+    private CfTeamPoolOrderMapper cfTeamPoolOrderMapper;
+    @Resource
+    private CfTeamPoolShareMapper cfTeamPoolShareMapper;
+    @Resource
+    private TeamShareConfigService teamShareConfigService;
 
     /**
      * 通用分佣(双返):当前人 + 推荐人。
@@ -158,6 +174,8 @@ public class CfCommissionService {
         // 推荐人分润(两级销售奖)
         distributeToReferrers(orderId, orderType, buyerUserId, buyerFamilyId,
                 orderAmountCent, paidAmountCent, productId);
+        // ⑤ 团队池建池(分润 v2:成本 × T%,从成本侧切出、不占 base;uk_order 幂等)
+        settleTeamPool(orderId, orderType, buyerUserId, buyerFamilyId, paidAmountCent, productId);
     }
 
     /**
@@ -183,6 +201,8 @@ public class CfCommissionService {
         earnBuyerCf(orderId, orderType, buyerUserId, paidAmountCent);
         distributeToReferrers(orderId, orderType, buyerUserId, buyerFamilyId,
                 orderAmountCent, paidAmountCent, null);
+        // ⑤ 团队池建池(会员/订阅/测评等非商品订单:成本 = 实付 × non_goods_cost_rate)
+        settleTeamPool(orderId, orderType, buyerUserId, buyerFamilyId, paidAmountCent, null);
     }
 
     /**
@@ -243,6 +263,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 交付)。
      *
@@ -267,6 +300,391 @@ public class CfCommissionService {
         return base > 0 ? base : 0;
     }
 
+    /**
+     * 团队池建池(分润 v2 §3.1 结算顺序 ⑤,能力键 cf.teamshare.createPool,T04)。
+     *
+     * <p>解析 T({@link TeamShareConfigService}:MINIAPP→SYSTEM→GLOBAL→兜底 3000bps)→ 算池金额
+     * (商品 = Σ floor(C × qty × T_bps / 10000);非商品 = floor(实付 × non_goods_cost_rate × T_bps / 10000))
+     * → 幂等建 {@code cf_team_pool_order}(唯一键 {@code uk_order(order_type, order_id)},重复结算命中
+     * 唯一键直接返回,设计 §7 风险 1 三层兜底第一层)→ 层级树瓜分 {@link #distributeTeamPool(Long, String, Long, Long, Integer, Long)}
+     * (T05 能力键 {@code cf.teamshare.weightedShare}:档位权重瓜分 + 尾差守恒 + 同家庭跳过)。</p>
+     */
+    @Transactional
+    public void settleTeamPool(Long orderId, String orderType, Long buyerUserId, Long buyerFamilyId,
+                               Integer paidAmountCent, Long productId) {
+        try {
+            if (orderId == null || orderType == null || buyerUserId == null) {
+                return;
+            }
+            // 依赖注入缺省(既有单测裸实例/部分 mock)时静默跳过,不影响既有结算链路
+            if (cfTeamPoolOrderMapper == null || teamShareConfigService == null || configService == null) {
+                return;
+            }
+            // 团队池总开关(cf.team_pool.enabled,默认 true)
+            if (!configService.getBooleanConfig(CfConfigKeys.TEAM_POOL_ENABLED, true)) {
+                return;
+            }
+            // 1. 解析 T:MINIAPP(mp_code) → SYSTEM(商品所属 distribution_system_id) → GLOBAL → 兜底 3000
+            String mpCode = MiniAppContextHolder.mpCode();
+            Long distributionSystemId = resolveProductDistributionSystemId(orderType, productId);
+            int tBps = teamShareConfigService.resolveTbps(mpCode, distributionSystemId);
+            if (tBps <= 0) {
+                log.info("团队池比例 T<=0,跳过建池: orderType={}, orderId={}", orderType, orderId);
+                return;
+            }
+            // 2. 算池金额(从成本侧切出,独立于 base;亏损仓仍按成本 × T% 照常发)
+            int poolCent = calcTeamPoolCent(orderId, orderType, paidAmountCent, productId, tBps);
+            if (poolCent <= 0) {
+                log.info("团队池金额为 0,跳过建池: orderType={}, orderId={}", orderType, orderId);
+                return;
+            }
+            // 3. 幂等建池(uk_order(order_type, order_id),重复结算命中唯一键直接返回)
+            CfTeamPoolOrder pool = new CfTeamPoolOrder();
+            pool.setOrderId(orderId);
+            pool.setOrderType(orderType);
+            pool.setProductId(productId);
+            pool.setBuyerUserId(buyerUserId);
+            pool.setPoolCent(poolCent);
+            pool.setTBps(tBps);
+            pool.setConfigScope(resolveScope(mpCode, distributionSystemId));
+            pool.setStatus("pooled");
+            pool.setCreatedAt(new Date());
+            pool.setRemark("成本×T%建池");
+            cfTeamPoolOrderMapper.insert(pool);
+            log.info("团队池建池成功: orderType={}, orderId={}, poolCent={}分, tBps={}, scope={}",
+                    orderType, orderId, poolCent, tBps, pool.getConfigScope());
+            // 4. 层级树瓜分(T05 cf.teamshare.weightedShare:档位权重瓜分 + 尾差守恒 + 同家庭跳过)
+            try {
+                distributeTeamPool(orderId, orderType, buyerUserId, buyerFamilyId, paidAmountCent, productId);
+            } catch (Exception e) {
+                log.warn("团队池瓜分失败(池已建,可后续补跑): orderType={}, orderId={}, err={}",
+                        orderType, orderId, e.getMessage());
+            }
+        } catch (DuplicateKeyException e) {
+            // 幂等:重复结算命中 uk_order,直接返回(设计 §7 风险 1 三层兜底第一层)
+            log.info("团队池已存在,幂等跳过建池: orderType={}, orderId={}", orderType, orderId);
+        } catch (Exception e) {
+            log.warn("团队池建池失败: orderType={}, orderId={}, err={}", orderType, orderId, e.getMessage());
+        }
+    }
+
+    /**
+     * 零参结算入口(契约 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 承接带参实现)。");
+    }
+
+    /**
+     * 层级树瓜分(分润 v2 设计 §5,能力键 {@code cf.teamshare.weightedShare},T05)。
+     *
+     * <p>由 {@link #settleTeamPool(Long, String, Long, Long, Integer, Long)} 建池后调用,内部完成:</p>
+     * <ol>
+     *   <li>按 {@code uk_order(order_type, order_id)} 幂等取池(池不存在 / 已瓜分 / 无人认领直接短路);</li>
+     *   <li>取层级树成员(买家上溯,同家庭跳过,≤ TEAM_DEPTH=8,设计 §1.4 / §5 step 3);</li>
+     *   <li>档位权重(与 F03a 直推档位同一口径:{@link CfReferralService#getTeamAnnualPpoints}(m, 8)
+     *       → {@code matchDirectSalesTier},权重 = cf_direct_sales_tier.rate_percent,无档位 = 0);</li>
+     *   <li>按 {@link #allocateTeamPoolShareByWeight(int[], int)} 加权瓜分(尾差由最后一人补齐,Σ = pool_cent);</li>
+     *   <li>逐人 {@code earnByRule(memberId, "F03c", poolId, {amount: raw})} 发放(幂等键 uk_ref_type F03c + poolId)
+     *       + {@code cf_team_pool_share} 幂等落库(uk_pool_member,设计 §7 风险 1 三层兜底第二层);</li>
+     *   <li>池状态落库 {@code share_issued}(无档位 totalW ≤ 0 无人可分 → {@code unclaimed},不私发,设计 §5 step 4)。</li>
+     * </ol>
+     *
+     * <p>参数 {@code paidCent} 为契约签名入参(§3.1 T05),池金额以 {@code cf_team_pool_order.pool_cent}
+     * 落库值为准(建池已完成);依赖注入缺省(裸实例/部分 mock)时静默跳过,不影响既有结算链路。</p>
+     */
+    @Transactional
+    public void distributeTeamPool(Long orderId, String orderType, Long buyerUserId, Long buyerFamilyId,
+                                   Integer paidCent, Long productId) {
+        try {
+            if (orderId == null || orderType == null || buyerUserId == null) {
+                return;
+            }
+            // 依赖注入缺省(既有单测裸实例/部分 mock)时静默跳过,不影响既有结算链路
+            if (cfTeamPoolOrderMapper == null || cfTeamPoolShareMapper == null || referralTreeMapper == null
+                    || userMapper == null || familyMemberMapper == null || cfReferralService == null
+                    || cfBalanceService == null) {
+                return;
+            }
+            // 1. 幂等取池(uk_order(order_type, order_id):建池先行,池不存在直接返回)
+            CfTeamPoolOrder pool = cfTeamPoolOrderMapper.selectOne(
+                    new LambdaQueryWrapper<CfTeamPoolOrder>()
+                            .eq(CfTeamPoolOrder::getOrderId, orderId)
+                            .eq(CfTeamPoolOrder::getOrderType, orderType)
+                            .last("LIMIT 1"));
+            if (pool == null || pool.getId() == null) {
+                log.info("团队池不存在,跳过瓜分: orderType={}, orderId={}", orderType, orderId);
+                return;
+            }
+            // 已瓜分 / 无人认领:幂等短路(设计 §7 风险 1)
+            if ("share_issued".equals(pool.getStatus()) || "unclaimed".equals(pool.getStatus())) {
+                log.info("团队池已处理(status={}),跳过重复瓜分: orderType={}, orderId={}",
+                        pool.getStatus(), orderType, orderId);
+                return;
+            }
+            int poolCent = pool.getPoolCent() != null ? pool.getPoolCent() : 0;
+            if (poolCent <= 0) {
+                return;
+            }
+
+            // 2. 取层级树成员(买家上溯,同家庭跳过,≤ max_depth)
+            List<TeamPoolCandidate> candidates = new ArrayList<>();
+            List<ReferralTree> referrals = referralTreeMapper.selectList(
+                    new LambdaQueryWrapper<ReferralTree>()
+                            .eq(ReferralTree::getMemberId, buyerUserId)
+                            .orderByAsc(ReferralTree::getLevel));
+            if (referrals != null) {
+                Set<Long> processed = new HashSet<>();
+                for (ReferralTree ref : referrals) {
+                    if (candidates.size() >= TEAM_DEPTH) {
+                        break;
+                    }
+                    Long parentId = ref.getParentId();
+                    if (parentId == null || processed.contains(parentId)) {
+                        continue;
+                    }
+                    processed.add(parentId);
+                    User parent = userMapper.selectById(parentId);
+                    if (parent == null) {
+                        continue;
+                    }
+                    // 同家庭跳过(设计 §1.4 / §5 step 3:团队池瓜分成员跳过同家庭)
+                    if (buyerFamilyId != null && buyerFamilyId.equals(parent.getFamilyId())) {
+                        continue;
+                    }
+                    // 档位权重(与 F03a 直推档位同一口径:团队 8 层滚动一年 P 点 → rate_percent)
+                    int teamPp = cfReferralService.getTeamAnnualPpoints(parentId, TEAM_DEPTH);
+                    CfDirectSalesTier tier = cfReferralService.matchDirectSalesTier(teamPp);
+                    int weight = (tier == null || tier.getRatePercent() == null) ? 0 : tier.getRatePercent();
+                    int layer = ref.getLevel() != null ? ref.getLevel() : candidates.size() + 1;
+                    candidates.add(new TeamPoolCandidate(parentId, resolveMemberId(parentId), layer, weight));
+                }
+            }
+            if (candidates.isEmpty()) {
+                // 无推荐链 → 无人可分 → 池归商家(unclaimed,不私发)
+                markPoolResult(pool, "unclaimed");
+                return;
+            }
+
+            // 3. 加权瓜分(纯算法:末位吸收尾差,Σ = poolCent,设计 §5 step 5 / §8#9)
+            int[] weights = new int[candidates.size()];
+            for (int i = 0; i < candidates.size(); i++) {
+                weights[i] = candidates.get(i).weight;
+            }
+            List<Integer> shares = allocateTeamPoolShareByWeight(weights, poolCent);
+            if (shares == null || shares.isEmpty()) {
+                // 无档位(totalW ≤ 0)→ 无人可分 → unclaimed(不私发,设计 §5 step 4)
+                markPoolResult(pool, "unclaimed");
+                return;
+            }
+
+            // 4. 逐人发放 + 明细落库(幂等兜底:uk_ref_type F03c+poolId / uk_pool_member)
+            long issued = 0L;
+            int lastIdx = shares.size() - 1;
+            for (int i = 0; i < shares.size(); i++) {
+                TeamPoolCandidate cand = candidates.get(i);
+                // 末位吸收尾差(按实际已发放额,与 §5 step 5 一致;非末位用纯算法值)
+                int raw = (i == lastIdx) ? (int) (poolCent - issued) : shares.get(i);
+                if (raw <= 0 || cand.memberId == null) {
+                    continue;
+                }
+                try {
+                    Map<String, Object> ctx = new HashMap<>();
+                    ctx.put("amount", raw);
+                    cfBalanceService.earnByRule(cand.memberId, RULE_TEAM_POOL, pool.getId(), ctx);
+                } catch (Exception e) {
+                    log.warn("团队池 F03c 发放失败: memberId={}, poolId={}, raw={}, err={}",
+                            cand.memberId, pool.getId(), raw, e.getMessage());
+                    continue;
+                }
+                try {
+                    CfTeamPoolShare share = new CfTeamPoolShare();
+                    share.setPoolId(pool.getId());
+                    share.setMemberId(cand.memberId);
+                    share.setUserId(cand.userId);
+                    share.setLayer(cand.layer);
+                    share.setRatePercent(cand.weight);
+                    share.setWeight(cand.weight);
+                    share.setShareCent(raw);
+                    share.setStatus("issued");
+                    share.setCreatedAt(new Date());
+                    cfTeamPoolShareMapper.insert(share);
+                } catch (DuplicateKeyException e) {
+                    log.info("团队池份额已存在,幂等跳过: poolId={}, memberId={}", pool.getId(), cand.memberId);
+                } catch (Exception e) {
+                    log.warn("团队池份额落库失败: poolId={}, memberId={}, err={}",
+                            pool.getId(), cand.memberId, e.getMessage());
+                }
+                issued += raw;
+            }
+            markPoolResult(pool, "share_issued");
+        } catch (Exception e) {
+            log.warn("团队池瓜分失败: orderType={}, orderId={}, err={}", orderType, orderId, e.getMessage());
+        }
+    }
+
+    /**
+     * 纯加权瓜分(设计 §5 step 5 算法抽离,能力键 {@code cf.teamshare.weightedShare} 数学锚点 §8#1/#9)。
+     *
+     * <p>池金额按成员档位权重比例分配:每人 {@code raw = floor(poolCent × w / totalW)},末位成员吸收尾差
+     * ({@code raw = poolCent − Σ(前序) })保证 Σ = poolCent(尾差守恒,金额不蒸发)。与档位体系解耦,
+     * 权重数据源(rate_percent)由调用方 {@link #distributeTeamPool(Long, String, Long, Long, Integer, Long)}
+     * 经 {@code CfReferralService#matchDirectSalesTier} 提供,便于本算法独立单测。</p>
+     *
+     * <p>命题验证(§8#1):池 3000 分、权重 {70, 50}、totalW=120 →
+     * {@code raw₁ = floor(3000×70/120) = 1750;raw₂ = 3000 − 1750 = 1250}(末位补齐尾差)。</p>
+     *
+     * @param weights  各成员档位权重(= cf_direct_sales_tier.rate_percent;非负,全 0 / 空 = 无档位)
+     * @param poolCent 团队池金额(分,≥ 0)
+     * @return 每人分得(分,长度 = 成员数,末位含尾差);totalW ≤ 0(无档位)返回空列表——调用方将池置
+     *         unclaimed(不私发,设计 §5 step 4/5)
+     */
+    public List<Integer> allocateTeamPoolShareByWeight(int[] weights, int poolCent) {
+        if (weights == null || weights.length == 0) {
+            return Collections.emptyList();
+        }
+        long totalW = 0L;
+        for (int w : weights) {
+            totalW += w;
+        }
+        if (totalW <= 0) {
+            // 无档位(totalW ≤ 0):无人可分,调用方将池置 unclaimed(不私发)
+            return Collections.emptyList();
+        }
+        List<Integer> shares = new ArrayList<>(weights.length);
+        long issued = 0L;
+        for (int i = 0; i < weights.length; i++) {
+            int raw;
+            if (i == weights.length - 1) {
+                // 末位成员吸收尾差:Σ = poolCent(尾差守恒,设计 §8#9)
+                raw = (int) (poolCent - issued);
+            } else {
+                raw = (int) ((long) poolCent * weights[i] / totalW);
+            }
+            shares.add(raw);
+            issued += raw;
+        }
+        return shares;
+    }
+
+    /** 池结算状态落库(share_issued=已瓜分 / unclaimed=无成员可瓜分,设计 §2.2 状态机) */
+    private void markPoolResult(CfTeamPoolOrder pool, String status) {
+        try {
+            pool.setStatus(status);
+            pool.setSettledAt(new Date());
+            cfTeamPoolOrderMapper.updateById(pool);
+            log.info("团队池状态落库: poolId={}, status={}", pool.getId(), status);
+        } catch (Exception e) {
+            log.warn("团队池状态落库失败: poolId={}, status={}, err={}", pool.getId(), status, e.getMessage());
+        }
+    }
+
+    /** 团队池瓜分候选成员(推荐链层级 + 档位权重 + 成员档案),供 §5 步骤 4/5 使用 */
+    private static class TeamPoolCandidate {
+        final Long userId;
+        final Long memberId;
+        final int layer;
+        final int weight;
+
+        TeamPoolCandidate(Long userId, Long memberId, int layer, int weight) {
+            this.userId = userId;
+            this.memberId = memberId;
+            this.layer = layer;
+            this.weight = weight;
+        }
+    }
+
+    /** 命中作用域标注(供 cf_team_pool_order.config_scope 落库,与 resolveTbps 优先级同源) */
+    private String resolveScope(String mpCode, Long distributionSystemId) {
+        if (mpCode != null && !mpCode.trim().isEmpty()) {
+            return TeamShareConfigService.SCOPE_MINIAPP;
+        }
+        if (distributionSystemId != null) {
+            return TeamShareConfigService.SCOPE_SYSTEM;
+        }
+        return TeamShareConfigService.SCOPE_GLOBAL;
+    }
+
+    /** 商品所属销售体系ID(SYSTEM 作用域键;非商品/无商品返回 null) */
+    private Long resolveProductDistributionSystemId(String orderType, Long productId) {
+        if (!"product".equals(orderType) || productId == null) {
+            return null;
+        }
+        try {
+            Product p = productMapper.selectById(productId);
+            return p != null ? p.getDistributionSystemId() : null;
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    /**
+     * 团队池金额(分):
+     * 商品订单 = Σ floor(C_i × qty_i × T_bps / 10000)(按行成本加总,无分摊歧义);
+     * 非商品订单 = floor(实付 × non_goods_cost_rate × T_bps / 10000)(成本模型,设计 §1.3)。
+     */
+    private int calcTeamPoolCent(Long orderId, String orderType, Integer paidAmountCent, Long productId, int tBps) {
+        int paid = paidAmountCent != null ? paidAmountCent : 0;
+        if (!"product".equals(orderType)) {
+            int ncd = configService.getIntConfig(CfConfigKeys.TEAM_POOL_NON_GOODS_COST_RATE, 5000);
+            long nonGoodsCost = (long) paid * ncd / 10000;
+            long pool = nonGoodsCost * tBps / 10000;
+            return pool > Integer.MAX_VALUE ? Integer.MAX_VALUE : (int) pool;
+        }
+        try {
+            ProductOrder order = productOrderMapper.selectById(orderId);
+            if (order == null) {
+                return 0;
+            }
+            List<OrderItem> items = orderItemMapper.findByOrderId(orderId);
+            if (items != null && !items.isEmpty()) {
+                long total = 0L;
+                for (OrderItem it : items) {
+                    int qty = it.getQuantity() != null ? it.getQuantity() : 0;
+                    if (qty <= 0 || it.getProductId() == null) {
+                        continue;
+                    }
+                    Product p = productMapper.selectById(it.getProductId());
+                    if (p == null || p.getPurchasePrice() == null) {
+                        continue;
+                    }
+                    total += (long) p.getPurchasePrice() * qty * tBps / 10000;
+                }
+                return total > Integer.MAX_VALUE ? Integer.MAX_VALUE : (int) total;
+            }
+            // 单商品订单:实付结算传 productId;成本价未配(null)时按 0 处理→池 0 跳过
+            if (productId == null) {
+                return 0;
+            }
+            Product p = productMapper.selectById(productId);
+            if (p == null || p.getPurchasePrice() == null) {
+                return 0;
+            }
+            int qty = order.getQuantity() != null ? order.getQuantity() : 1;
+            long single = (long) p.getPurchasePrice() * qty * tBps / 10000;
+            return single > Integer.MAX_VALUE ? Integer.MAX_VALUE : (int) single;
+        } catch (Exception e) {
+            log.warn("计算团队池金额失败: orderId={}, err={}", orderId, e.getMessage());
+            return 0;
+        }
+    }
+
     /**
      * 推荐人分润:两级销售奖(F03a 直接销售奖 + F03b 间接销售奖)。
      *

+ 159 - 20
cfc-backend/src/main/java/com/etotem/cfc/service/EnergyRuleEngine.java

@@ -1,9 +1,11 @@
 package com.etotem.cfc.service;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.etotem.cfc.entity.DimensionDailyLimit;
 import com.etotem.cfc.entity.EnergyDimension;
 import com.etotem.cfc.entity.EnergyLog;
 import com.etotem.cfc.entity.EnergyRule;
+import com.etotem.cfc.mapper.DimensionDailyLimitMapper;
 import com.etotem.cfc.mapper.EnergyDimensionMapper;
 import com.etotem.cfc.mapper.EnergyRuleMapper;
 import com.fasterxml.jackson.core.type.TypeReference;
@@ -13,8 +15,12 @@ import org.springframework.stereotype.Service;
 import javax.annotation.Resource;
 import java.util.ArrayList;
 import java.util.Collections;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
+import java.util.concurrent.ConcurrentHashMap;
 
 @Slf4j
 @Service
@@ -25,8 +31,20 @@ public class EnergyRuleEngine {
     private EnergyDimensionMapper energyDimensionMapper;
     @Resource
     private EnergyService energyService;
+    /**
+     * 单维度日上限配置(SC-P-90 前置:{@code energy_daily_limit} 按维度配 {@code dailyLimit=N})。
+     * 引擎写路径按该配置判定触顶(配置驱动,替代 EnergyService 侧硬编码 {@code DAILY_LIMIT_MAP})。
+     */
+    @Resource
+    private DimensionDailyLimitMapper dimensionDailyLimitMapper;
     private final ObjectMapper objectMapper = new ObjectMapper();
 
+    /**
+     * 写路径幂等记录(同 member+dimension+sourceType+sourceId 重复触发仅写一次流水;
+     * DB 侧幂等唯一键由 {@code energy.ledger.guard}(S-cfc-225/390)覆盖,本集合为引擎内软去重)。
+     */
+    private final Set<String> appliedKeys = ConcurrentHashMap.newKeySet();
+
     public List<EnergyRule> findActiveRules(String eventType) {
         return energyRuleMapper.selectList(
             new LambdaQueryWrapper<EnergyRule>()
@@ -36,29 +54,83 @@ public class EnergyRuleEngine {
         );
     }
 
-    public void evaluate(String eventType, Long sourceId, Long memberId, Map<String, Object> context) {
+    /**
+     * 实时触发写入入口(能力键 {@code energy.ruleEngine.apply},SC-P-87/88/90/93):
+     * 事件 → 规则匹配 → 归因维度+数值 → 写 EnergyLog/EnergyBalance,返回可观测结果。
+     *
+     * <p>返回值(调用方可感知写入结果,SC-P-87/88/90):
+     * <ul>
+     *   <li>{@code awarded}:{@code Map<dimensionCode, amount>} 本次实际归因发放;</li>
+     *   <li>{@code capped}:boolean,日上限触顶(ED-4「已达今日上限」)拒发;</li>
+     *   <li>{@code duplicated}:boolean,写路径幂等命中(同源重复触发)跳过。</li>
+     * </ul>
+     *
+     * <p>异常语义:规则 {@code amount} 缺失/非正 → {@link IllegalArgumentException};
+     * decrease 余额不足 → {@link IllegalStateException};写入层失败/归因无分配 → {@link RuntimeException}。
+     * 一律向调用方传播(可告警/回滚),不静默吞掉。</p>
+     */
+    public Map<String, Object> apply(String eventType, Long sourceId, Long memberId, Map<String, Object> context) {
+        Map<String, Object> result = new LinkedHashMap<>();
+        Map<String, Integer> awarded = new LinkedHashMap<>();
+        result.put("awarded", awarded);
+        result.put("capped", false);
+        result.put("duplicated", false);
+        if (eventType == null || memberId == null) {
+            return result;
+        }
         List<EnergyRule> rules = findActiveRules(eventType);
-        if (rules.isEmpty()) return;
+        if (rules == null || rules.isEmpty()) {
+            return result;
+        }
+        if (context == null) {
+            context = new HashMap<>();
+        }
         for (EnergyRule rule : rules) {
-            try {
-                if (!matchesConditions(rule, context)) continue;
-                int amount = calculateAmount(rule, context);
-                if (amount == 0) continue;
-                Long dimId = resolveDimensionId(rule);
-                if ("increase".equals(rule.getAction())) {
-                    // SC-P-90:写入前经 daily limit 守卫校验(与 energy.ruleEngine.apply 同链)
-                    if (!guardDailyLimit(memberId, dimId, amount)) {
-                        log.info("每日上限已达,规则跳过发放: ruleId={}, memberId={}", rule.getId(), memberId);
-                        continue;
-                    }
-                    energyService.awardEnergy(memberId, eventType, sourceId, amount, rule.getDescription(), null);
-                } else if ("decrease".equals(rule.getAction())) {
-                    energyService.deductEnergy(memberId, dimId, Math.abs(amount), rule.getDescription());
+            if (!matchesConditions(rule, context)) continue;
+            int amount = calculateAmount(rule, context);
+            if (amount == 0) continue;
+            String action = rule.getAction();
+            if (!"increase".equals(action) && !"decrease".equals(action)) continue;
+            Long dimId = resolveDimensionId(rule);
+            if (dimId == null) {
+                log.info("规则未解析到归因维度,跳过(不 500): ruleId={}", rule.getId());
+                continue;
+            }
+            if ("increase".equals(action)) {
+                if (alreadyApplied(memberId, dimId, eventType, sourceId)) {
+                    result.put("duplicated", true);
+                    continue;
+                }
+                if (isDailyLimitCapped(memberId, dimId, rule.getDimensionCode(), amount)) {
+                    result.put("capped", true);
+                    continue;
+                }
+                Map<String, Integer> dimAllocations = new LinkedHashMap<>();
+                dimAllocations.put(rule.getDimensionCode(), amount);
+                Map<String, Integer> written = energyService.awardEnergyAtomic(
+                        memberId, eventType, sourceId, amount,
+                        rule.getDescription(), null, dimAllocations);
+                if (written == null || written.isEmpty()) {
+                    throw new RuntimeException("能量写入失败(归因无分配): ruleId=" + rule.getId()
+                            + ", memberId=" + memberId);
+                }
+                awarded.putAll(written);
+            } else {
+                int after = energyService.deductEnergy(memberId, dimId, Math.abs(amount), rule.getDescription());
+                if (after < 0) {
+                    throw new IllegalStateException("能量不足,拒绝扣减: ruleId=" + rule.getId()
+                            + ", memberId=" + memberId);
                 }
-            } catch (Exception e) {
-                log.error("规则执行失败: ruleId={}, error={}", rule.getId(), e.getMessage());
             }
         }
+        return result;
+    }
+
+    /**
+     * 实时触发(保留旧入口,委托 {@link #apply},结果可观测性见 apply)。
+     */
+    public void evaluate(String eventType, Long sourceId, Long memberId, Map<String, Object> context) {
+        apply(eventType, sourceId, memberId, context);
     }
 
     /**
@@ -83,6 +155,67 @@ public class EnergyRuleEngine {
         }
     }
 
+    /**
+     * 写路径日上限触顶判定(SC-P-90/ED-4,配置驱动)。
+     *
+     * <p>优先级:引擎注入的 {@code energy_daily_limit} 配置({@link #dimensionDailyLimitMapper})
+     * 判定单维度日上限;配置缺失回落 {@link EnergyService#isDailyLimitExceeded}(硬编码 DAILY_LIMIT_MAP
+     * 口径,与 Service 侧 guard 一致)。配置 0/负 按 0 处理不发放、不崩溃(TC-P-90-E-4)。
+     * 多来源共享同一日上限:累计按「服务端今日窗口」查询 energy_log(created_at between,次日重置)。</p>
+     *
+     * @return true=已达上限应拒发;false=可发放
+     */
+    boolean isDailyLimitCapped(Long memberId, Long dimId, String dimensionCode, Integer amount) {
+        Integer limit = resolveConfiguredDailyLimit(dimensionCode);
+        if (limit == null) {
+            return energyService.isDailyLimitExceeded(memberId, Collections.singleton(dimId), amount);
+        }
+        if (limit <= 0) {
+            log.info("日上限配置为 0/负,按 0 处理不再发放: dimensionCode={}", dimensionCode);
+            return true;
+        }
+        int todayTotal = energyService.getTodayDimensionTotal(memberId, dimId);
+        return todayTotal + amount > limit;
+    }
+
+    /**
+     * 读取某维度日上限配置(引擎注入的 DimensionDailyLimitMapper),未配置/读取失败返回 null。
+     */
+    private Integer resolveConfiguredDailyLimit(String dimensionCode) {
+        if (dimensionCode == null || dimensionDailyLimitMapper == null) {
+            return null;
+        }
+        try {
+            List<DimensionDailyLimit> limits = dimensionDailyLimitMapper.selectList(
+                    new LambdaQueryWrapper<DimensionDailyLimit>()
+                            .eq(DimensionDailyLimit::getDimensionCode, dimensionCode));
+            if (limits != null && !limits.isEmpty() && limits.get(0) != null) {
+                return limits.get(0).getDailyLimit();
+            }
+        } catch (Exception e) {
+            log.warn("读取日上限配置失败 dimensionCode={}: {}", dimensionCode, e.getMessage());
+        }
+        return null;
+    }
+
+    /**
+     * 写路径幂等判定:同 (memberId, dimensionId, sourceType, sourceId) 已写入则跳过(ED-1 重复审批/网络重试)。
+     * 引擎内软去重 + DB 幂等入口({@link EnergyService#isAlreadyApplied})双保险。
+     */
+    private boolean alreadyApplied(Long memberId, Long dimId, String sourceType, Long sourceId) {
+        String key = memberId + ":" + dimId + ":" + sourceType + ":" + sourceId;
+        if (!appliedKeys.add(key)) {
+            log.info("写路径幂等命中,同源重复触发跳过: key={}", key);
+            return true;
+        }
+        try {
+            return energyService.isAlreadyApplied(memberId, dimId, sourceType, sourceId);
+        } catch (Exception e) {
+            log.warn("写路径幂等查询异常,按未写入处理: {}", e.getMessage());
+            return false;
+        }
+    }
+
     private boolean matchesConditions(EnergyRule rule, Map<String, Object> context) {
         if (rule.getConditions() == null || rule.getConditions().isEmpty()) return true;
         try {
@@ -95,9 +228,15 @@ public class EnergyRuleEngine {
         } catch (Exception e) { log.warn("条件解析失败: ruleId={}", rule.getId()); return false; }
     }
 
+    /**
+     * 规则数值校验(SC-P-87-E-4):amount 缺失/非正属配置异常 → 拒绝并告警(抛异常),不静默跳过。
+     */
     private int calculateAmount(EnergyRule rule, Map<String, Object> context) {
-        if (rule.getAmount() != null && rule.getAmount() != 0) return rule.getAmount();
-        return 0;
+        Integer amount = rule.getAmount();
+        if (amount == null || amount <= 0) {
+            throw new IllegalArgumentException("规则 amount 缺失/非正属配置异常: ruleId=" + rule.getId());
+        }
+        return amount;
     }
 
     private Long resolveDimensionId(EnergyRule rule) {

+ 32 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/EnergyService.java

@@ -2531,6 +2531,38 @@ public class EnergyService {
         return false;
     }
 
+    /**
+     * 查询某成员某维度今日已累计能量(服务端今日窗口 00:00:00–23:59:59.999,created_at between)。
+     *
+     * <p>供规则引擎写路径({@code energy.ruleEngine.apply},S-cfc-304/391)日上限触顶判定使用:
+     * 窗口随服务端日期前移 → 昨日流水不计入今日累计、次日自动归零(SC-P-90 主流程 3);
+     * 多来源共享同一日上限(TC-P-90-E-1)。</p>
+     *
+     * @param memberId 家庭成员ID
+     * @param dimId    目标维度ID
+     * @return 今日该维度 positive 流水累计值(无记录返回 0)
+     */
+    public int getTodayDimensionTotal(Long memberId, Long dimId) {
+        if (memberId == null || dimId == null) {
+            return 0;
+        }
+        try {
+            Date todayStart = getTodayStart();
+            Date todayEnd = getTodayEnd();
+            LambdaQueryWrapper<EnergyLog> dimWrapper = new LambdaQueryWrapper<EnergyLog>()
+                    .eq(EnergyLog::getMemberId, memberId)
+                    .eq(EnergyLog::getDimensionId, dimId)
+                    .gt(EnergyLog::getAmount, 0)
+                    .between(EnergyLog::getCreatedAt, todayStart, todayEnd);
+            return energyLogMapper.selectList(dimWrapper).stream()
+                    .mapToInt(e -> e.getAmount() != null ? e.getAmount() : 0)
+                    .sum();
+        } catch (Exception e) {
+            log.warn("查询今日维度累计异常 memberId={}, dimId={}: {}", memberId, dimId, e.getMessage());
+            return 0;
+        }
+    }
+
     /**
      * 解析某维度每日上限:优先 {@code energy_daily_limit} 配置驱动(TC-P-90 前置),
      * 未配置/读取失败回落硬编码 {@link #DAILY_LIMIT_MAP}(默认 50)。

+ 0 - 15
cfc-backend/src/main/java/com/etotem/cfc/service/MemberSubscriptionService.java

@@ -32,9 +32,6 @@ public class MemberSubscriptionService {
     @Resource
     private CfCommissionService cfCommissionService;
 
-    @Resource
-    private ProfitPoolService profitPoolService;
-
     @Resource
     private ButlerService butlerService;
 
@@ -168,12 +165,6 @@ public class MemberSubscriptionService {
         if (family != null && family.getCreatorId() != null) {
             cfCommissionService.settleReferrerOnly(order.getId(), "subscription", family.getCreatorId(),
                     family.getId(), amount);
-            // 团队分润池钩子(§12-T3 同点位并行调用,S-cfc-62 team.profit.hook)
-            try {
-                profitPoolService.settle(order.getId(), "subscription", null, amount, 0L);
-            } catch (Exception e) {
-                log.error("团队分润池核算失败: orderId={}, type=subscription, error={}", order.getId(), e.getMessage());
-            }
         }
 
         return subscription;
@@ -246,12 +237,6 @@ public class MemberSubscriptionService {
         if (family != null && family.getCreatorId() != null) {
             cfCommissionService.settleReferrerOnly(order.getId(), "subscription", family.getCreatorId(),
                     family.getId(), amount);
-            // 团队分润池钩子(§12-T3 同点位并行调用,S-cfc-62 team.profit.hook)
-            try {
-                profitPoolService.settle(order.getId(), "subscription", null, amount, 0L);
-            } catch (Exception e) {
-                log.error("团队分润池核算失败: orderId={}, type=subscription, error={}", order.getId(), e.getMessage());
-            }
         }
 
         return current;

+ 0 - 11
cfc-backend/src/main/java/com/etotem/cfc/service/MembershipService.java

@@ -55,9 +55,6 @@ public class MembershipService implements MembershipServiceInterface {
     @Lazy
     private CfCommissionService cfCommissionService;
 
-    @Resource
-    private ProfitPoolService profitPoolService;
-
     @Resource
     private SysConfigService sysConfigService;
 
@@ -1009,14 +1006,6 @@ public class MembershipService implements MembershipServiceInterface {
             Long buyerFamilyId = (buyer != null) ? buyer.getFamilyId() : null;
             cfCommissionService.settleReferrerOnly(order.getId(), "membership", adminUserId, buyerFamilyId, order.getAmount());
 
-            // 团队分润池钩子(§12-T3 同点位并行调用,S-cfc-62 team.profit.hook)
-            try {
-                profitPoolService.settle(order.getId(), "membership", null,
-                        order.getAmount() != null ? order.getAmount() : 0, 0L);
-            } catch (Exception e) {
-                log.error("团队分润池核算失败: orderId={}, type=membership, error={}", order.getId(), e.getMessage());
-            }
-
             log.info("会员开通完成: orderNo={}, levelCode={}, amount={}, fromLevel={}",
                     order.getOrderNo(), order.getLevelCode(), order.getAmount(), fromLevel);
 

+ 0 - 9
cfc-backend/src/main/java/com/etotem/cfc/service/PaymentService.java

@@ -67,9 +67,6 @@ public class PaymentService implements PaymentServiceInterface {
     @Resource
     private CfCommissionService cfCommissionService;
 
-    @Resource
-    private ProfitPoolService profitPoolService;
-
     @Lazy
     @Resource
     private ProductOrderService productOrderService;
@@ -281,12 +278,6 @@ public class PaymentService implements PaymentServiceInterface {
         if (updated) {
             cfCommissionService.settle(order.getId(), "package", order.getUserId(),
                     order.getFamilyId(), order.getPrice(), null);
-            // 团队分润池钩子(§12-T3 同点位并行调用,S-cfc-62 team.profit.hook)
-            try {
-                profitPoolService.settle(order.getId(), "package", null, order.getPrice(), 0L);
-            } catch (Exception e) {
-                log.error("团队分润池核算失败: orderId={}, type=package, error={}", order.getId(), e.getMessage());
-            }
         }
         return updated;
     }

+ 0 - 19
cfc-backend/src/main/java/com/etotem/cfc/service/ProductOrderService.java

@@ -100,9 +100,6 @@ public class ProductOrderService {
     @Resource
     private CfCommissionService cfCommissionService;
 
-    @Resource
-    private ProfitPoolService profitPoolService;
-
     @Resource
     private PaymentService paymentService;
 
@@ -1074,22 +1071,6 @@ public class ProductOrderService {
             log.error("CF值分佣失败: orderId={}, error={}", order.getId(), e.getMessage());
         }
 
-        // 团队分润池钩子(§12-T3 同点位并行调用,S-cfc-62 team.profit.hook)
-        try {
-            Integer paidCent = order.getMoneyAmount() != null ? order.getMoneyAmount() : order.getTotalAmount();
-            Integer costCent = 0;
-            if (order.getProductId() != null) {
-                Product hp = productMapper.selectById(order.getProductId());
-                if (hp != null && hp.getPurchasePrice() != null) {
-                    costCent = hp.getPurchasePrice();
-                }
-            }
-            profitPoolService.settle(order.getId(), "product", order.getProductId(),
-                    (long) (paidCent != null ? paidCent : 0), (long) (costCent != null ? costCent : 0));
-        } catch (Exception e) {
-            log.error("团队分润池核算失败: orderId={}, type=product, error={}", order.getId(), e.getMessage());
-        }
-
         // 原佣金结算标记为废弃,保留兼容
         // commissionService.settle(order.getId(), "product", order.getBuyerId(),
         //        order.getTotalAmount(), order.getProductId());

+ 0 - 283
cfc-backend/src/main/java/com/etotem/cfc/service/ProfitPoolService.java

@@ -1,283 +0,0 @@
-package com.etotem.cfc.service;
-
-import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
-import com.etotem.cfc.config.ConfigService;
-import com.etotem.cfc.entity.ProfitPoolOrder;
-import com.etotem.cfc.entity.ServiceConfigItem;
-import com.etotem.cfc.entity.TeamShareRecord;
-import com.etotem.cfc.mapper.ProfitPoolOrderMapper;
-import com.etotem.cfc.mapper.ServiceConfigItemMapper;
-import com.etotem.cfc.mapper.TeamAwardRecordMapper;
-import com.etotem.cfc.mapper.TeamShareRecordMapper;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-import org.springframework.stereotype.Service;
-
-import javax.annotation.Resource;
-import java.util.Arrays;
-import java.util.Date;
-import java.util.HashSet;
-import java.util.Set;
-
-/**
- * 单笔订单利润池计算服务(规格 §2.1 总账模型 + §4.7 杠杆 1 收入管道化 + §8.3 幂等)。
- *
- * <p><b>核心职责(T9 收入管道化,能力键 {@code team.profit.pipeline})</b>:</p>
- * <ul>
- *   <li>分润触发源扩展 {@code membership / subscription / assessment_retest}(§4.7 杠杆 1),
- *       续费/复购在推荐关系存续期间持续产生分润;</li>
- *   <li>按 §2.1 对每笔订单完成利润漏斗核算(S/C/P/O/F/D/R/T + 8 份池 + 团队奖),
- *       只扩展触发源、不提高分配比率(§10#5);</li>
- *   <li>{@code D > 0} 才进入分润流程并生成 {@code team_share_record}(pending),
- *       {@code D ≤ 0}(低于保本线)整单不分润、仅落 {@code profit_pool_order} 供统计(§9#3);</li>
- *   <li>重复回调按唯一键 {@code uk_order(order_type, order_id)} 幂等(§8.3),不重复发放;</li>
- *   <li>未知触发源被拒绝(防误分配)。</li>
- * </ul>
- *
- * <p>配置读取:优先 {@link ConfigService}(缓存 + 兜底),未注入时回退
- * {@link ServiceConfigItemMapper} 直读,均缺失则用 §7.8 默认比率
- * (ops 10% / cf 1% / referral 70% / team 30% / eight 80% / award 20%)。</p>
- *
- * <p>规格:docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md v0.7
- * §2.1 + §2.2 + §4.7 杠杆 1 + §7.1 + §7.8 + §8.3 + §9#3 + §10#5 + §12-T9。</p>
- */
-@Service
-public class ProfitPoolService {
-
-    private static final Logger log = LoggerFactory.getLogger(ProfitPoolService.class);
-
-    /** §7.1 order_type 允许值(§4.7 杠杆 1 扩展 membership/subscription/assessment_retest) */
-    private static final Set<String> ALLOWED_ORDER_TYPES = new HashSet<>(Arrays.asList(
-            "product", "service", "assessment", "package",
-            "membership", "subscription", "assessment_retest"));
-
-    // §7.8 默认比率(配置未写入时使用)
-    private static final double DEFAULT_OPS_RATE = 0.10;
-    private static final double DEFAULT_CF_COST_RATE = 0.01;
-    private static final double DEFAULT_REFERRAL_SHARE = 0.70;
-    private static final double DEFAULT_TEAM_SHARE = 0.30;
-    private static final double DEFAULT_EIGHT_SHARE_RATIO = 0.80;
-    private static final double DEFAULT_TEAM_AWARD_RATIO = 0.20;
-    private static final int DEFAULT_SHARE_TOTAL = 8;
-
-    private static final String CFG_OPS_RATE = "referral_profit.ops_rate";
-    private static final String CFG_CF_COST_RATE = "referral_profit.cf_cost_rate";
-    private static final String CFG_REFERRAL_SHARE = "referral_profit.referral_share";
-    private static final String CFG_TEAM_SHARE = "referral_profit.team_share";
-    private static final String CFG_EIGHT_SHARE_RATIO = "team_profit.eight_share_ratio";
-    private static final String CFG_TEAM_AWARD_RATIO = "team_profit.team_award_ratio";
-    private static final String CFG_SHARE_TOTAL = "team_profit.share_total";
-
-    @Resource
-    private ConfigService configService;
-
-    @Resource
-    private ProfitPoolOrderMapper profitPoolOrderMapper;
-
-    @Resource
-    private TeamShareRecordMapper teamShareRecordMapper;
-
-    @Resource
-    private TeamAwardRecordMapper teamAwardRecordMapper;
-
-    @Resource
-    private ServiceConfigItemMapper serviceConfigItemMapper;
-
-    /**
-     * 分润结算入口(§12-T2 契约,能力键 {@code team.profit.settle})。
-     *
-     * <p>签名 {@code (Long orderId, String orderType, Long productId, long amountCent, long costCent)}
-     * 由契约测试 {@code ProfitPoolOrderContractRedTest} 锚定;内部与管道化入口共用核算核心。</p>
-     */
-    public ProfitPoolOrder settle(Long orderId, String orderType, Long productId,
-                                  long amountCent, long costCent) {
-        return doSettle(orderId, orderType, productId, amountCent, costCent, null);
-    }
-
-    /**
-     * 分润结算入口(§4.7 杠杆 1 收入管道化,能力键 {@code team.profit.pipeline})。
-     *
-     * <p>触发源扩展 {@code membership / subscription / assessment_retest};{@code memberId}
-     * 为订单归属成员(服务提供者/推荐链根),用于生成 {@code team_share_record} 流水。</p>
-     */
-    public ProfitPoolOrder settle(long orderId, String orderType, long memberId,
-                                  int amountCent, int costCent) {
-        return doSettle(orderId, orderType, null, amountCent, costCent, memberId);
-    }
-
-    /**
-     * 核算核心:幂等检查 → 触发源校验 → §2.1 利润漏斗 → 落单 → D>0 生成团队分润流水。
-     */
-    private ProfitPoolOrder doSettle(Long orderId, String orderType, Long productId,
-                                     long amountCent, long costCent, Long memberId) {
-        // 幂等(§8.3 uk_order):重复回调返回既有记录,不重复发放
-        ProfitPoolOrder existing = findExisting(orderId, orderType);
-        if (existing != null) {
-            return existing;
-        }
-
-        // 未知触发源拒绝(防误分配)
-        if (orderType == null || !ALLOWED_ORDER_TYPES.contains(orderType)) {
-            throw new IllegalArgumentException("未知分润触发源: " + orderType);
-        }
-
-        // §2.1 一般化公式(金额单位:分)
-        double opsRate = rate(CFG_OPS_RATE, DEFAULT_OPS_RATE);
-        double cfCostRate = rate(CFG_CF_COST_RATE, DEFAULT_CF_COST_RATE);
-        double referralShare = rate(CFG_REFERRAL_SHARE, DEFAULT_REFERRAL_SHARE);
-        double teamShare = rate(CFG_TEAM_SHARE, DEFAULT_TEAM_SHARE);
-        double eightShareRatio = rate(CFG_EIGHT_SHARE_RATIO, DEFAULT_EIGHT_SHARE_RATIO);
-        // 团队奖按预算守恒取 T−8份池(8份池占 T×80%、团队奖占 T×20%,§2.1 恒等)
-
-        long p = amountCent - costCent;
-        long o = roundPct(p, opsRate);
-        long f = roundPct(amountCent, cfCostRate);
-        long d = p - o - f;
-
-        long r;
-        long t;
-        long eight;
-        long award;
-        if (d <= 0) {
-            // §2.2/§9#3:D≤0 整单不产生推荐人/团队分润,仅落 profit_pool_order 供统计
-            r = 0;
-            t = 0;
-            eight = 0;
-            award = 0;
-        } else {
-            r = roundPct(d, referralShare);
-            t = roundPct(d, teamShare);
-            eight = roundPct(t, eightShareRatio);
-            // 预算守恒:8 份池 + 团队奖 = T(§2.1,不超 D 预算)
-            award = t - eight;
-        }
-
-        ProfitPoolOrder pool = new ProfitPoolOrder();
-        pool.setOrderId(orderId);
-        pool.setOrderType(orderType);
-        pool.setProductId(productId);
-        pool.setAmountCent((int) amountCent);
-        pool.setCostCent((int) costCent);
-        pool.setPlatformRetainCent((int) p);
-        pool.setOpsCent((int) o);
-        pool.setCfCostCent((int) f);
-        pool.setPoolCent((int) d);
-        pool.setReferralShareCent((int) r);
-        pool.setTeamShareCent((int) t);
-        pool.setTeamEightShareCent((int) eight);
-        pool.setTeamAwardCent((int) award);
-        pool.setStatus("pending");
-        pool.setCreatedAt(new Date());
-        profitPoolOrderMapper.insert(pool);
-
-        if (d > 0) {
-            // §8.1:D>0 生成团队 8 份分佣流水(pending,冷静期后 settled)
-            genTeamShareRecord(pool, memberId);
-        }
-        return pool;
-    }
-
-    /** 幂等查询:uk_order(order_type, order_id) 既有记录。 */
-    private ProfitPoolOrder findExisting(Long orderId, String orderType) {
-        if (profitPoolOrderMapper == null) {
-            return null;
-        }
-        try {
-            return profitPoolOrderMapper.selectOne(new LambdaQueryWrapper<ProfitPoolOrder>()
-                    .eq(ProfitPoolOrder::getOrderType, orderType)
-                    .eq(ProfitPoolOrder::getOrderId, orderId)
-                    .last("LIMIT 1"));
-        } catch (Exception e) {
-            log.warn("查询 profit_pool_order 幂等失败 orderType={} orderId={}: {}",
-                    orderType, orderId, e.getMessage());
-            return null;
-        }
-    }
-
-    /**
-     * 生成团队 8 份分佣流水(§7.3)。管道化(T9)阶段以订单归属成员为第 1 层基础记录,
-     * 星级/份数/金额的完整分配(§4.2 星级份数 + §4.4 团队奖)由团队分润服务按团队树与
-     * 星级快照落地(T2),此处仅落 pending 占位流水并保留 8 份池金额。
-     */
-    private void genTeamShareRecord(ProfitPoolOrder pool, Long memberId) {
-        if (teamShareRecordMapper == null) {
-            return;
-        }
-        Long uid = memberId != null ? memberId : 0L;
-        int shareTotal = intRate(CFG_SHARE_TOTAL, DEFAULT_SHARE_TOTAL);
-        int shareTotalSafe = Math.max(1, shareTotal);
-        TeamShareRecord record = new TeamShareRecord();
-        record.setOrderId(pool.getOrderId());
-        record.setOrderType(pool.getOrderType());
-        record.setPoolId(pool.getId());
-        record.setProviderUserId(uid);
-        record.setRecipientUserId(uid);
-        record.setLayer(1);
-        record.setShares(1);
-        record.setShareCent(pool.getTeamEightShareCent() / shareTotalSafe);
-        record.setStatus("pending");
-        record.setCreatedAt(new Date());
-        teamShareRecordMapper.insert(record);
-    }
-
-    /** §2.1 金额取整口径(逐项 round,HALF_UP 等价)。 */
-    private long roundPct(long base, double rate) {
-        return Math.round(base * rate);
-    }
-
-    /** 读取 double 比率:ConfigService 优先,回退 service_config 直读,再回退默认。 */
-    private double rate(String key, double def) {
-        if (configService != null) {
-            return configService.getDoubleConfig(key, def);
-        }
-        return readConfigDouble(key, def);
-    }
-
-    /** 读取 int 配置:ConfigService 优先,回退 service_config 直读,再回退默认。 */
-    private int intRate(String key, int def) {
-        if (configService != null) {
-            return configService.getIntConfig(key, def);
-        }
-        return readConfigInt(key, def);
-    }
-
-    private double readConfigDouble(String key, double def) {
-        String v = readConfigValue(key);
-        if (v == null) {
-            return def;
-        }
-        try {
-            return Double.parseDouble(v.trim());
-        } catch (NumberFormatException e) {
-            return def;
-        }
-    }
-
-    private int readConfigInt(String key, int def) {
-        String v = readConfigValue(key);
-        if (v == null) {
-            return def;
-        }
-        try {
-            return Integer.parseInt(v.trim());
-        } catch (NumberFormatException e) {
-            return def;
-        }
-    }
-
-    private String readConfigValue(String key) {
-        if (serviceConfigItemMapper == null) {
-            return null;
-        }
-        try {
-            ServiceConfigItem item = serviceConfigItemMapper.selectOne(
-                    new LambdaQueryWrapper<ServiceConfigItem>()
-                            .eq(ServiceConfigItem::getConfigKey, key)
-                            .last("LIMIT 1"));
-            return item != null ? item.getConfigValue() : null;
-        } catch (Exception e) {
-            log.warn("读取团队分润配置失败 key={}: {}", key, e.getMessage());
-            return null;
-        }
-    }
-}

+ 3 - 15
cfc-backend/src/main/java/com/etotem/cfc/service/StarDigestService.java

@@ -41,7 +41,7 @@ public class StarDigestService {
     public static final int MIN_STAR = 1;
     public static final int MAX_STAR = 6;
 
-    /** 星级业绩分门槛(§4.3 推荐默认值,index = 星级-1;与 StarScoreCalculator 默认档位一致)。 */
+    /** 星级业绩分门槛(§4.3 推荐默认值,index = 星级-1)。 */
     private static final int[] DEFAULT_STAR_THRESHOLDS = {0, 8_000, 25_000, 70_000, 140_000, 250_000};
 
     /** 差距→行动换算率(§4.3.1 ②:直接服务 250 分/次、团队带教 200 分/次、推荐消费 10 分/百元)。 */
@@ -52,9 +52,6 @@ public class StarDigestService {
     @Resource
     private TeamStarSnapshotMapper teamStarSnapshotMapper;
 
-    @Resource
-    private StarScoreCalculator starScoreCalculator;
-
     // ==================== 三态分类(§4.3.1 ③) ====================
 
     /**
@@ -180,10 +177,8 @@ public class StarDigestService {
         if (current != null) {
             currentStar = current.getStarLevel() == null ? MIN_STAR : current.getStarLevel();
             currentScore = current.getScore() == null ? 0 : current.getScore().intValue();
-        } else if (starScoreCalculator != null) {
-            currentScore = starScoreCalculator.totalScore(userId);
-            currentStar = starScoreCalculator.starForScore(currentScore);
         } else {
+            // 快照缺失:旧体系 StarScoreCalculator 已随 T07 废弃,不再做实时聚合,回退一星/0 分
             currentStar = MIN_STAR;
             currentScore = 0;
         }
@@ -283,16 +278,9 @@ public class StarDigestService {
         }
     }
 
-    /** 星级业绩分门槛:优先读实时计算组件(后台可配),缺失回退 §4.3 默认档位。 */
+    /** 星级业绩分门槛:旧体系实时计算组件已随 T07 废弃,统一回退 §4.3 默认档位(归档只读口径)。 */
     private int thresholdOfStar(int starLevel) {
         int star = clampStar(starLevel);
-        if (starScoreCalculator != null) {
-            try {
-                return starScoreCalculator.thresholdOfStar(star);
-            } catch (Exception e) {
-                log.warn("读取星级档位失败,回退 §4.3 默认值:{}", e.getMessage());
-            }
-        }
         return DEFAULT_STAR_THRESHOLDS[star - 1];
     }
 

+ 0 - 512
cfc-backend/src/main/java/com/etotem/cfc/service/StarScoreCalculator.java

@@ -1,512 +0,0 @@
-package com.etotem.cfc.service;
-
-import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
-import com.etotem.cfc.dto.StarConversionPathVO;
-import com.etotem.cfc.dto.StarConversionRatesVO;
-import com.etotem.cfc.dto.StarDimensionBreakdownVO;
-import com.etotem.cfc.dto.StarDualThresholdProgressVO;
-import com.etotem.cfc.dto.StarTrajectoryPointVO;
-import com.etotem.cfc.dto.TeamStarMyViewVO;
-import com.etotem.cfc.entity.TeamStarSnapshot;
-import com.etotem.cfc.mapper.TeamProfitStatsMapper;
-import com.etotem.cfc.mapper.TeamStarSnapshotMapper;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-import org.springframework.stereotype.Service;
-
-import javax.annotation.Resource;
-import java.text.SimpleDateFormat;
-import java.util.ArrayList;
-import java.util.Calendar;
-import java.util.Comparator;
-import java.util.Date;
-import java.util.List;
-
-/**
- * 星级业绩分计算 / 实时聚合组件(§4.3 + §4.3.1)。
- *
- * <p>规格:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md}
- * §4.3 星级定义(滚动 12 个月加权业绩分 → 档位映射 + 升级双门槛)+ §4.3.1 星级透明化
- * (实时看板 / 三维构成 / 距下一档差距 / 双门槛进度 / 三条换算路径 / 近 12 月轨迹)
- * + §11-#15 拍板(团队直推 = 直接邀请加入团队 + 成交首个服务/商品单,首单即算无金额门槛)。</p>
- *
- * <p><b>业绩分</b>(§4.3 公式,金额单位为元口径):</p>
- * <pre>
- *   Score = 直接服务收入 × 50% + 团队服务收入 × 40% + 推荐用户平台消费收入 × 10%
- * </pre>
- *
- * <p><b>星级↔档位映射</b>(推荐默认值,对应可配 {@code team_profit.star_tiers},见 §7.8):</p>
- * <pre>
- *   score ≥ 0       → 一星(入团即一星)  拿 1 份
- *   score ≥ 8,000   → 二星                拿 2 份
- *   score ≥ 25,000  → 三星                拿 3 份
- *   score ≥ 70,000  → 四星                拿 4 份
- *   score ≥ 140,000 → 五星                拿 5 份
- *   score ≥ 250,000 → 六星                拿 6 份(最多)
- * </pre>
- *
- * <p><b>升级双门槛</b>(主理人意见⑥ / #15 拍板):升级条件 = <b>业绩分 ≥ 目标档门槛</b>
- * 且 <b>本窗口团队直推 ≥ 1</b>,两条件缺一不可;一星为入团基线,无直推门槛;
- * 降星自动(滚动窗口滑出,不保留历史级别、不固化)。</p>
- *
- * <p><b>纯计算 vs 实时聚合</b>:本组件的档位/加权/双门槛判定为纯函数(无 DB),供月度重评
- * ({@code TeamProfitCronTask})与分润快照(§8.1 支付成功时刻星级)共用;
- * 另按 §4.3.1「数据与接口」提供实时聚合查询({@link #totalScore(long)} /
- * {@link #dimensionBreakdown(long)} / {@link #dualThresholdProgress(long)} /
- * {@link #conversionPaths(int)} / {@link #twelveMonthTrajectory(long)} /
- * {@link #myView(long)}),数据源 {@code TeamProfitStatsMapper} + {@code TeamStarSnapshotMapper}。
- * 纯反射契约场景(未注入 Spring 依赖)下自动回退默认值,方法仍可安全调用。</p>
- */
-@Service
-public class StarScoreCalculator {
-
-    private static final Logger log = LoggerFactory.getLogger(StarScoreCalculator.class);
-
-    /** 最低/最高星级 */
-    public static final int MIN_STAR = 1;
-    public static final int MAX_STAR = 6;
-
-    /** 星级业绩分门槛(§4.3 推荐校准值,index = 星级-1,对应 team_profit.star_tiers 默认值)。 */
-    private static final int[] DEFAULT_STAR_THRESHOLDS = {0, 8_000, 25_000, 70_000, 140_000, 250_000};
-
-    /** 业绩分权重:直接服务 50% / 团队服务 40% / 推荐消费 10%(§4.3,可配 team_profit.star_weight)。 */
-    private static final int[] DEFAULT_WEIGHTS = {50, 40, 10};
-
-    /** 差距→行动换算率(§4.3.1 ②:¥500/次基准,可配 team_profit.star_conversion)。 */
-    private static final int[] DEFAULT_CONVERSION = {250, 200, 10};
-
-    /** 单次咨询基准金额(元,§4.3.1 ②)。 */
-    private static final int BASE_CONSULT_FEE_YUAN = 500;
-
-    /** 团队直推要求(§4.3:滚动 12 个月 ≥ 1)。 */
-    private static final int DIRECT_NEW_REF_REQUIRED = 1;
-
-    /**
-     * 业绩分门槛量级下界:用于消解 {@link #isPromotable(long, int, int)} 的调用约定歧义。
-     * 业绩分门槛以「分」为量级(默认最小档 8,000),团队直推数以「人」为量级(个位数),
-     * 故 &gt;= 1000 的第二参数视为门槛、&lt;=6 的第三参数视为星级/直推计数。
-     */
-    private static final int SCORE_THRESHOLD_FLOOR = 1_000;
-
-    /** 月度快照轨迹窗口(§4.3.1 ①:近 12 个月)。 */
-    private static final int TRAJECTORY_MONTHS = 12;
-
-    @Resource
-    private TeamProfitConfigService teamProfitConfigService;
-
-    @Resource
-    private TeamProfitStatsMapper teamProfitStatsMapper;
-
-    @Resource
-    private TeamStarSnapshotMapper teamStarSnapshotMapper;
-
-    // ==================== 纯计算:业绩分 / 档位 / 双门槛(§4.3) ====================
-
-    /**
-     * 业绩分:直接×50% + 团队×40% + 推荐×10%(§4.3)。金额单位为元口径。
-     */
-    public long calculateScore(long directServiceAmount, long teamServiceAmount, long referralConsumeAmount) {
-        return weightedScore(directServiceAmount, teamServiceAmount, referralConsumeAmount);
-    }
-
-    /**
-     * 业绩分(int 口径别名,契约 {@code team.star.myView}):直接×50% + 团队×40% + 推荐×10%。
-     *
-     * <p>权重读 {@code team_profit.star_weight}(默认 50/40/10);纯反射场景回退默认值。</p>
-     */
-    public int weightedScore(long directRevenueYuan, long teamRevenueYuan, long referralConsumeYuan) {
-        int[] w = loadWeights();
-        long score = Math.round(directRevenueYuan * w[0] / 100.0
-                + teamRevenueYuan * w[1] / 100.0
-                + referralConsumeYuan * w[2] / 100.0);
-        return (int) Math.max(0L, score);
-    }
-
-    /**
-     * 星级业绩分门槛(§4.3 档位表):1→0 / 2→8000 / 3→25000 / 4→70000 / 5→140000 / 6→250000。
-     *
-     * <p>读 {@code team_profit.star_tiers}(#12 后台可配),异常或缺失时回退推荐默认值。</p>
-     */
-    public int thresholdOfStar(int star) {
-        int[] tiers = loadStarTiers();
-        return tiers[clampStar(star) - 1];
-    }
-
-    /** 星级业绩分门槛(契约别名 {@code team.star.myView})。 */
-    public int starThreshold(int starLevel) {
-        return thresholdOfStar(starLevel);
-    }
-
-    /**
-     * 业绩分 → 星级档位映射(入团即一星)。等价于 {@link #resolveStarLevel(long)}。
-     */
-    public int starForScore(long score) {
-        int[] tiers = loadStarTiers();
-        int star = MIN_STAR;
-        for (int s = MIN_STAR + 1; s <= MAX_STAR; s++) {
-            if (score >= tiers[s - 1]) {
-                star = s;
-            } else {
-                break;
-            }
-        }
-        return star;
-    }
-
-    /**
-     * 业绩分 → 星级档位映射(§4.3 档位表,别名以匹配跨契约命名)。
-     */
-    public int resolveStarLevel(long score) {
-        return starForScore(score);
-    }
-
-    /**
-     * 距下一档星级差距(§4.3.1 ①:如「距四星还差 12,000 分」= 70,000 − 58,000)。
-     *
-     * @param totalScore      当前业绩分总分
-     * @param currentStarLevel 当前星级(1-6)
-     * @return 差距分(&gt;= 0;已达六星返回 0)
-     */
-    public int gapToNextStar(int totalScore, int currentStarLevel) {
-        int current = clampStar(currentStarLevel);
-        if (current >= MAX_STAR) {
-            return 0;
-        }
-        return Math.max(0, thresholdOfStar(current + 1) - totalScore);
-    }
-
-    /**
-     * 升级双门槛判定(§4.3 判定规则 / #15 拍板)。
-     *
-     * <p><b>兼容两种调用约定</b>(两者参数个数相同,契约侧均以 {@code isPromotable} 命名):</p>
-     * <ul>
-     *   <li>看板约定 {@code (score, scoreThreshold, directValidNewRefs)}:业绩分得分门槛由调用方
-     *       直接给出({@code team.star.myView});</li>
-     *   <li>重评约定 {@code (score, directValidNewRefs, targetStar)}:按目标星级查档位门槛
-     *       ({@code team.profit.cron})。</li>
-     * </ul>
-     * <p>判别规则:第二参数为「分」量级(&gt;= {@value #SCORE_THRESHOLD_FLOOR})且第三参数
-     * 为小整数(&lt;= 6)时按看板约定;否则按重评约定。两种约定的判定本质一致:
-     * <b>score ≥ 门槛 AND 团队直推 ≥ 1</b>。</p>
-     */
-    public boolean isPromotable(long score, int second, int third) {
-        if (second >= SCORE_THRESHOLD_FLOOR && third <= MAX_STAR) {
-            // 看板约定:(score, scoreThreshold, directValidNewRefs)
-            return score >= second && third >= DIRECT_NEW_REF_REQUIRED;
-        }
-        // 重评约定:(score, directValidNewRefs, targetStar)
-        return isPromotableByStar(score, second, third);
-    }
-
-    /**
-     * 升级双门槛判定(按目标星级查档位门槛):{@code score ≥ threshold(targetStar) AND refs ≥ 1}。
-     * 一星为入团基线(targetStar ≤ 1 恒可)。
-     */
-    public boolean isPromotableByStar(long score, int directValidNewRefs, int targetStar) {
-        int target = clampStar(targetStar);
-        if (target <= MIN_STAR) {
-            return true;
-        }
-        return score >= thresholdOfStar(target) && directValidNewRefs >= DIRECT_NEW_REF_REQUIRED;
-    }
-
-    /**
-     * 月度重评(§4.3 升降规则):
-     * <ul>
-     *   <li>升星:业绩分达标到更高档 <b>且</b> 团队直推 ≥1 才升级(双门槛);否则维持当前档</li>
-     *   <li>降星:滚动窗口滑出业绩分下降 → 自动降级(不保留历史级别、不固化)</li>
-     * </ul>
-     *
-     * @param score              滚动 12 个月加权业绩分
-     * @param directValidNewRefs 滚动 12 个月团队直推有效新用户数
-     * @param currentStar        当前星级(上一档快照)
-     * @return 重评后星级(1-6)
-     */
-    public int reEvaluateStar(long score, int directValidNewRefs, int currentStar) {
-        int current = clampStar(currentStar);
-        int natural = starForScore(score);
-        if (natural > current) {
-            // 升星需过升级双门槛;不达标维持当前档
-            return isPromotableByStar(score, directValidNewRefs, natural) ? natural : current;
-        }
-        // 降星自动(含持平)
-        return natural;
-    }
-
-    // ==================== 实时聚合:业绩分 / 三维构成 / 双门槛进度(§4.3.1 ①) ====================
-
-    /** 实时业绩分总分(滚动 12 个月加权,§4.3.1 ①)。 */
-    public int totalScore(long userId) {
-        long[] cent = loadRevenueCent(userId);
-        return weightedScore(cent[0] / 100L, cent[1] / 100L, cent[2] / 100L);
-    }
-
-    /** 实时星级(滚动 12 个月业绩分 → 档位映射,§4.3/§4.3.1)。 */
-    public int currentStarLevel(long userId) {
-        return starForScore(totalScore(userId));
-    }
-
-    /** 三维构成条:直接服务 / 团队服务 / 推荐消费各自贡献分与合计(§4.3.1 ①)。 */
-    public StarDimensionBreakdownVO dimensionBreakdown(long userId) {
-        long[] cent = loadRevenueCent(userId);
-        StarDimensionBreakdownVO vo = new StarDimensionBreakdownVO();
-        vo.setDirectRevenueYuan(cent[0] / 100L);
-        vo.setTeamRevenueYuan(cent[1] / 100L);
-        vo.setReferralConsumeYuan(cent[2] / 100L);
-        vo.setDirectScore(weightedScore(vo.getDirectRevenueYuan(), 0L, 0L));
-        vo.setTeamScore(weightedScore(0L, vo.getTeamRevenueYuan(), 0L));
-        vo.setReferralConsumeScore(weightedScore(0L, 0L, vo.getReferralConsumeYuan()));
-        // 合计取一次性加权(与 totalScore(userId) 口径一致,避免分项四舍五入误差)
-        vo.setTotalScore(weightedScore(vo.getDirectRevenueYuan(), vo.getTeamRevenueYuan(),
-                vo.getReferralConsumeYuan()));
-        return vo;
-    }
-
-    /** 升级双门槛进度:业绩分 ✓ + 团队直推 ✓ 分项打勾(§4.3.1 ①)。 */
-    public StarDualThresholdProgressVO dualThresholdProgress(long userId) {
-        int score = totalScore(userId);
-        int current = starForScore(score);
-        boolean atTop = current >= MAX_STAR;
-        int target = atTop ? MAX_STAR : current + 1;
-        int threshold = thresholdOfStar(target);
-        int refs = loadDirectValidNewRefs(userId);
-
-        StarDualThresholdProgressVO vo = new StarDualThresholdProgressVO();
-        vo.setTargetStarLevel(target);
-        vo.setScoreCurrent(score);
-        vo.setScoreThreshold(threshold);
-        vo.setScorePassed(atTop || score >= threshold);
-        vo.setDirectNewRefCurrent(refs);
-        vo.setDirectNewRefRequired(DIRECT_NEW_REF_REQUIRED);
-        vo.setDirectNewRefPassed(atTop || refs >= DIRECT_NEW_REF_REQUIRED);
-        vo.setPromotable(atTop || (vo.isScorePassed() && vo.isDirectNewRefPassed()));
-        vo.setHint(buildProgressHint(atTop, target, score, threshold, refs));
-        return vo;
-    }
-
-    // ==================== 差距→行动换算(§4.3.1 ②) ====================
-
-    /** 换算率表(直接 250/次、团队 200/次、推荐 10/百元,可配 team_profit.star_conversion)。 */
-    public StarConversionRatesVO conversionRates() {
-        int[] rates = loadConversion();
-        StarConversionRatesVO vo = new StarConversionRatesVO();
-        vo.setSessionFeeYuan(BASE_CONSULT_FEE_YUAN);
-        vo.setDirectPerSession(rates[0]);
-        vo.setTeamPerSession(rates[1]);
-        vo.setReferralPer100Yuan(rates[2]);
-        return vo;
-    }
-
-    /**
-     * 三条达标路径(A 直接服务 / B 团队带教 / C 推荐消费),按「最容易够到」
-     * (所需单位由小到大)排序(§4.3.1 ②)。
-     *
-     * @param gap 距下一档差距分(&lt;= 0 时各路径所需单位均为 0)
-     */
-    public List<StarConversionPathVO> conversionPaths(int gap) {
-        int rest = Math.max(0, gap);
-        int[] rates = loadConversion();
-        List<StarConversionPathVO> paths = new ArrayList<>(3);
-        paths.add(buildSessionPath("DIRECT", "A 直接服务", "次 1对1 咨询", rates[0], rest));
-        paths.add(buildSessionPath("TEAM", "B 团队带教", "次带教服务", rates[1], rest));
-        paths.add(buildReferralPath(rates[2], rest));
-        paths.sort(Comparator.comparingInt(StarConversionPathVO::getRequiredUnits));
-        return paths;
-    }
-
-    // ==================== 近 12 月星级轨迹(§4.3.1 ① + §7.6 team_star_snapshot) ====================
-
-    /** 近 12 月星级轨迹(读 {@code team_star_snapshot},按 period 升序)。 */
-    public List<StarTrajectoryPointVO> twelveMonthTrajectory(long userId) {
-        List<StarTrajectoryPointVO> points = new ArrayList<>();
-        if (teamStarSnapshotMapper == null) {
-            return points;
-        }
-        try {
-            List<TeamStarSnapshot> snapshots = teamStarSnapshotMapper.selectList(
-                    new LambdaQueryWrapper<TeamStarSnapshot>()
-                            .eq(TeamStarSnapshot::getUserId, userId)
-                            .orderByDesc(TeamStarSnapshot::getPeriod)
-                            .last("LIMIT " + TRAJECTORY_MONTHS));
-            if (snapshots != null) {
-                // 倒序查询 → 升序输出,便于前端画曲线
-                for (int i = snapshots.size() - 1; i >= 0; i--) {
-                    TeamStarSnapshot s = snapshots.get(i);
-                    if (s == null) {
-                        continue;
-                    }
-                    StarTrajectoryPointVO p = new StarTrajectoryPointVO();
-                    p.setPeriod(s.getPeriod());
-                    p.setStarLevel(s.getStarLevel() == null ? MIN_STAR : s.getStarLevel());
-                    p.setScore(s.getScore() == null ? 0 : s.getScore().intValue());
-                    points.add(p);
-                }
-            }
-        } catch (Exception e) {
-            log.warn("近 12 月星级轨迹查询失败(userId={}),返回空轨迹:{}", userId, e.getMessage());
-        }
-        return points;
-    }
-
-    // ==================== 看板聚合(§12-T7 POST /api/team-star/my-view) ====================
-
-    /** 组装「我的星级」看板聚合视图(§4.3.1 ①②)。 */
-    public TeamStarMyViewVO myView(long userId) {
-        int score = totalScore(userId);
-        int star = starForScore(score);
-        int gap = gapToNextStar(score, star);
-        Date windowStart = rollingWindowStart();
-        Date windowEnd = new Date();
-
-        TeamStarMyViewVO vo = new TeamStarMyViewVO();
-        vo.setCurrentStarLevel(star);
-        vo.setNextStarLevel(Math.min(MAX_STAR, star + 1));
-        vo.setTotalScore(score);
-        vo.setDimensionBreakdown(dimensionBreakdown(userId));
-        vo.setGapToNextStar(gap);
-        vo.setDualThresholdProgress(dualThresholdProgress(userId));
-        vo.setConversionPaths(conversionPaths(gap));
-        vo.setTwelveMonthTrajectory(twelveMonthTrajectory(userId));
-        vo.setWindowStart(formatDate(windowStart));
-        vo.setWindowEnd(formatDate(windowEnd));
-        vo.setWindowLabel("统计期:" + vo.getWindowStart() + " ~ " + vo.getWindowEnd());
-        return vo;
-    }
-
-    // ==================== 内部辅助:配置读取(可配项,缺失回退默认) ====================
-
-    private int[] loadStarTiers() {
-        if (teamProfitConfigService != null) {
-            try {
-                int[] tiers = teamProfitConfigService.getStarTiers();
-                if (tiers != null && tiers.length == MAX_STAR) {
-                    return tiers;
-                }
-            } catch (Exception e) {
-                log.warn("读取星级档位失败,回退 §4.3 默认六档:{}", e.getMessage());
-            }
-        }
-        return DEFAULT_STAR_THRESHOLDS.clone();
-    }
-
-    private int[] loadWeights() {
-        if (teamProfitConfigService != null) {
-            try {
-                int[] weights = teamProfitConfigService.getStarWeight();
-                if (weights != null && weights.length == 3) {
-                    return weights;
-                }
-            } catch (Exception e) {
-                log.warn("读取星级权重失败,回退 §4.3 默认 50/40/10:{}", e.getMessage());
-            }
-        }
-        return DEFAULT_WEIGHTS.clone();
-    }
-
-    private int[] loadConversion() {
-        if (teamProfitConfigService != null) {
-            try {
-                int[] conversion = teamProfitConfigService.getStarConversion();
-                if (conversion != null && conversion.length == 3) {
-                    return conversion;
-                }
-            } catch (Exception e) {
-                log.warn("读取换算率失败,回退 §4.3.1 默认 250/200/10:{}", e.getMessage());
-            }
-        }
-        return DEFAULT_CONVERSION.clone();
-    }
-
-    // ==================== 内部辅助:数据查询(缺依赖/异常一律兜底 0,保证看板可打开) ====================
-
-    /** 滚动 12 个月窗口内的直接/团队/推荐收入(分)。 */
-    private long[] loadRevenueCent(long userId) {
-        long direct = 0L;
-        long team = 0L;
-        long referral = 0L;
-        if (teamProfitStatsMapper != null) {
-            try {
-                Date windowStart = rollingWindowStart();
-                direct = teamProfitStatsMapper.selectDirectServiceAmountCent(userId, windowStart);
-                team = teamProfitStatsMapper.selectTeamServiceAmountCent(userId, windowStart);
-                referral = teamProfitStatsMapper.selectReferralConsumeAmountCent(userId, windowStart);
-            } catch (Exception e) {
-                log.warn("星级看板业绩统计失败(userId={}),按 0 兜底:{}", userId, e.getMessage());
-            }
-        }
-        return new long[]{Math.max(0L, direct), Math.max(0L, team), Math.max(0L, referral)};
-    }
-
-    /** 滚动 12 个月团队直推有效新用户数(#15:团队树首单即算)。 */
-    private int loadDirectValidNewRefs(long userId) {
-        if (teamProfitStatsMapper == null) {
-            return 0;
-        }
-        try {
-            return Math.max(0, teamProfitStatsMapper.countDirectValidNewRefs(userId, rollingWindowStart()));
-        } catch (Exception e) {
-            log.warn("团队直推统计失败(userId={}),按 0 兜底:{}", userId, e.getMessage());
-            return 0;
-        }
-    }
-
-    // ==================== 内部辅助:换算路径构造 / 窗口 / 日期 ====================
-
-    private StarConversionPathVO buildSessionPath(String type, String label, String unitLabel, int rate, int gap) {
-        int units = rate <= 0 ? 0 : (gap + rate - 1) / rate;
-        StarConversionPathVO path = new StarConversionPathVO();
-        path.setType(type);
-        path.setLabel(label);
-        path.setRate(rate);
-        path.setRequiredUnits(units);
-        path.setUnitLabel(unitLabel);
-        path.setRequiredYuan(units * BASE_CONSULT_FEE_YUAN);
-        return path;
-    }
-
-    private StarConversionPathVO buildReferralPath(int ratePer100Yuan, int gap) {
-        int units = ratePer100Yuan <= 0 ? 0 : (gap + ratePer100Yuan - 1) / ratePer100Yuan;
-        StarConversionPathVO path = new StarConversionPathVO();
-        path.setType("REFERRAL");
-        path.setLabel("C 推荐消费");
-        path.setRate(ratePer100Yuan);
-        path.setRequiredUnits(units);
-        path.setUnitLabel("百元推荐消费");
-        path.setRequiredYuan(units * 100);
-        return path;
-    }
-
-    private String buildProgressHint(boolean atTop, int target, int score, int threshold, int refs) {
-        if (atTop) {
-            return "已达最高星级(六星)";
-        }
-        boolean scorePassed = score >= threshold;
-        boolean refsPassed = refs >= DIRECT_NEW_REF_REQUIRED;
-        if (!scorePassed && !refsPassed) {
-            return "距 " + target + " 星还差 " + (threshold - score) + " 分,且还差 "
-                    + (DIRECT_NEW_REF_REQUIRED - refs) + " 个团队直推";
-        }
-        if (!scorePassed) {
-            return "距 " + target + " 星还差 " + (threshold - score) + " 分";
-        }
-        if (!refsPassed) {
-            return "升级还差 " + (DIRECT_NEW_REF_REQUIRED - refs)
-                    + " 个团队直推,去邀请好友加入团队并完成首单";
-        }
-        return "双门槛已达标,可升级到 " + target + " 星";
-    }
-
-    private Date rollingWindowStart() {
-        Calendar cal = Calendar.getInstance();
-        cal.add(Calendar.MONTH, -TRAJECTORY_MONTHS);
-        return cal.getTime();
-    }
-
-    private String formatDate(Date date) {
-        return new SimpleDateFormat("yyyy-MM-dd").format(date);
-    }
-
-    private int clampStar(int star) {
-        return Math.min(Math.max(star, MIN_STAR), MAX_STAR);
-    }
-}

+ 0 - 92
cfc-backend/src/main/java/com/etotem/cfc/service/TeamProfitFlowService.java

@@ -1,92 +0,0 @@
-package com.etotem.cfc.service;
-
-import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
-import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
-import com.etotem.cfc.entity.TeamAwardRecord;
-import com.etotem.cfc.entity.TeamShareRecord;
-import com.etotem.cfc.mapper.TeamAwardRecordMapper;
-import com.etotem.cfc.mapper.TeamShareRecordMapper;
-import org.springframework.stereotype.Service;
-
-import javax.annotation.Resource;
-
-/**
- * 团队分润流水查询服务(能力键 {@code team.admin.manage},单元 admin,§12-T5 流水查询)。
- *
- * <p>契约溯源:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md} v0.7
- * §7.3 + §7.4 + §12-T5。</p>
- *
- * <p><b>宿主契约方法</b>:
- * <ul>
- *   <li>{@code Page<TeamShareRecord> queryTeamShareRecords(Long recipientUserId, String status, int page, int size)}
- *       — 8 份分佣流水查询(§7.3 team_share_record)</li>
- *   <li>{@code Page<TeamAwardRecord> queryTeamAwardRecords(Long teamId, String status, int page, int size)}
- *       — 团队奖流水查询(§7.4 team_award_record)</li>
- * </ul>
- *
- * <p>纯反射契约上下文(无 Spring)下 Mapper 未注入时返回空页,不抛异常。</p>
- *
- * <p><b>规格:docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md v0.7
- * §7.3 + §7.4 + §12-T5。</b></p>
- */
-@Service
-public class TeamProfitFlowService {
-
-    @Resource
-    private TeamShareRecordMapper teamShareRecordMapper;
-
-    @Resource
-    private TeamAwardRecordMapper teamAwardRecordMapper;
-
-    /**
-     * 8 份分佣流水分页查询(§7.3 team_share_record),按接收人/状态过滤。
-     *
-     * @param recipientUserId 获得分润的团队成员(可空)
-     * @param status          流水状态 pending/settled/cancelled(可空/空串 = 不过滤)
-     * @param page            页码(&lt;1 按 1)
-     * @param size            每页条数(&lt;1 按 1)
-     */
-    public Page<TeamShareRecord> queryTeamShareRecords(Long recipientUserId, String status, int page, int size) {
-        int p = Math.max(page, 1);
-        int s = Math.max(size, 1);
-        Page<TeamShareRecord> pageParam = new Page<>(p, s);
-        LambdaQueryWrapper<TeamShareRecord> wrapper = new LambdaQueryWrapper<TeamShareRecord>()
-                .orderByDesc(TeamShareRecord::getCreatedAt);
-        if (recipientUserId != null) {
-            wrapper.eq(TeamShareRecord::getRecipientUserId, recipientUserId);
-        }
-        if (status != null && !status.trim().isEmpty()) {
-            wrapper.eq(TeamShareRecord::getStatus, status.trim());
-        }
-        if (teamShareRecordMapper == null) {
-            return pageParam;
-        }
-        return teamShareRecordMapper.selectPage(pageParam, wrapper);
-    }
-
-    /**
-     * 团队奖流水分页查询(§7.4 team_award_record),按团队/状态过滤。
-     *
-     * @param teamId 归属服务团队(distribution_systems.id,可空)
-     * @param status 流水状态 pending/settled/cancelled(可空/空串 = 不过滤)
-     * @param page   页码(&lt;1 按 1)
-     * @param size   每页条数(&lt;1 按 1)
-     */
-    public Page<TeamAwardRecord> queryTeamAwardRecords(Long teamId, String status, int page, int size) {
-        int p = Math.max(page, 1);
-        int s = Math.max(size, 1);
-        Page<TeamAwardRecord> pageParam = new Page<>(p, s);
-        LambdaQueryWrapper<TeamAwardRecord> wrapper = new LambdaQueryWrapper<TeamAwardRecord>()
-                .orderByDesc(TeamAwardRecord::getCreatedAt);
-        if (teamId != null) {
-            wrapper.eq(TeamAwardRecord::getTeamId, teamId);
-        }
-        if (status != null && !status.trim().isEmpty()) {
-            wrapper.eq(TeamAwardRecord::getStatus, status.trim());
-        }
-        if (teamAwardRecordMapper == null) {
-            return pageParam;
-        }
-        return teamAwardRecordMapper.selectPage(pageParam, wrapper);
-    }
-}

+ 0 - 316
cfc-backend/src/main/java/com/etotem/cfc/service/TeamProfitService.java

@@ -1,316 +0,0 @@
-package com.etotem.cfc.service;
-
-import com.etotem.cfc.entity.TeamAwardRecord;
-import com.etotem.cfc.entity.TeamShareRecord;
-
-import java.util.ArrayList;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.stream.Collectors;
-import java.util.stream.IntStream;
-
-/**
- * 团队分润服务(能力键 {@code team.star.multiplier},单元 team)。
- *
- * <p>契约溯源:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md} v0.7
- * §12-T10 + §4.7.2 杠杆 2/3/4 + §11-#14 + §10#5。
- *
- * <p><b>宿主契约方法(按规格落地)</b>:
- * <ul>
- *   <li>{@code double starMultiplier(int starLevel)} — 返回该星级倍率系数(1-6★)</li>
- *   <li>{@code double starWeight(int starLevel)} — 返回权重 W = 星级 × 倍率</li>
- *   <li>{@code Map<Integer,Double> starMultiplierTable()} — 返回 6 档默认倍率表(1★..6★)</li>
- *   <li>{@code List<Long> allocateEightShareByWeight(int[] starLevels, long eightSharePoolCent)}
- *       — 按星级权重分配 8 份池,返回每人分得(分);0 表示该层无人(份额回流,不私发)</li>
- *   <li>{@code int mentorMilestoneTierBonus(int fiveStarMentees)} — 带出 5★ 成员数 → 团队奖档位偏移</li>
- *   <li>{@code boolean mentorMilestoneCapAndCandidates(int fiveStarMentees)}
- *       — 带出 ≥2 名 5★ → 比例上限 100% + 年度星耀会候选人</li>
- *   <li>{@code long orderSharePendingCent(long orderId, long userId)} — 订单完成本单团队分润(分,pending 可见)</li>
- * </ul>
- *
- * <p><b>核心规则(§4.7.2)</b>:
- * <ul>
- *   <li>默认倍率:1★=1.0, 2★=1.0, 3★=1.2, 4★=1.5, 5★=2.0, 6★=3.0;权重 W = 星级 × 倍率</li>
- *   <li>8 份池 = T×80%(只重分不增量,不超 T 预算)</li>
- *   <li>分配采用最大余数法,保证 Σ = 8 份池(整数精度守恒)</li>
- *   <li>星耀导师:带出 1 名 5★ → 档位 +1;2 名 5★ → 比例上限 100% + 年度星耀会候选人</li>
- *   <li>实时可见:D ≤ 0 订单本单分润为 0(只记录不发放)</li>
- * </ul>
- *
- * <p>本类为纯契约实现(无 Spring 依赖,可反射实例化);杠杆 4 的真实读取在
- * {@code profit_pool_order} / 结算链路(§12-T2/T3)接通后,经注入的 Mapper 完成,
- * 当前以确定性演示值桥接契约测试。
- */
-public class TeamProfitService {
-
-    // ==================== 契约常量(规格 §4.7.2 默认值) ====================
-
-    /** 标准 ¥500 咨询:D=17000、T=5100、8 份池 = T×80% = 4080 分(§4.7.2 示例)。 */
-    public static final long DEFAULT_EIGHT_SHARE_POOL = 4080L;
-
-    /** 默认 6 档倍率表:1-2 星 1.0 / 3 星 1.2 / 4 星 1.5 / 5 星 2.0 / 6 星 3.0。 */
-    private static final Map<Integer, Double> DEFAULT_MULTIPLIER_TABLE;
-
-    static {
-        Map<Integer, Double> table = new LinkedHashMap<>();
-        table.put(1, 1.0);
-        table.put(2, 1.0);
-        table.put(3, 1.2);
-        table.put(4, 1.5);
-        table.put(5, 2.0);
-        table.put(6, 3.0);
-        DEFAULT_MULTIPLIER_TABLE = java.util.Collections.unmodifiableMap(table);
-    }
-
-    public TeamProfitService() {
-        // no-arg constructor for reflection instantiation
-    }
-
-    // ==================== 杠杆 2:星级倍率表 ====================
-
-    /**
-     * 返回该星级的倍率系数 f(星)。越界星级返回 1.0(无倾斜)。
-     */
-    public double starMultiplier(int starLevel) {
-        if (starLevel < 1 || starLevel > 6) {
-            return 1.0;
-        }
-        return DEFAULT_MULTIPLIER_TABLE.get(starLevel);
-    }
-
-    /**
-     * 返回权重 W = 星级 × 倍率系数;星级 ≤ 0 返回 0(无人层无权重)。
-     */
-    public double starWeight(int starLevel) {
-        if (starLevel <= 0) {
-            return 0.0;
-        }
-        return starLevel * starMultiplier(starLevel);
-    }
-
-    /**
-     * 返回 6 档默认倍率表(1★..6★),按星级升序。
-     */
-    public Map<Integer, Double> starMultiplierTable() {
-        Map<Integer, Double> table = new LinkedHashMap<>();
-        for (int i = 1; i <= 6; i++) {
-            table.put(i, DEFAULT_MULTIPLIER_TABLE.get(i));
-        }
-        return table;
-    }
-
-    // ==================== 杠杆 2:8 份池按权重分配 + 只重分不增量 ====================
-
-    /**
-     * 按星级权重分配 8 份池。
-     *
-     * <p>规则(§4.7.2):
-     * <ul>
-     *   <li>每层权重 W = 星级 × 倍率;0 星级 = 该层无人 → 权重 0(份额回流,不私发)</li>
-     *   <li>总权重 ΣW &gt; 0 时:份额 = round(8份池 × Wi / ΣW),采用最大余数法保证 Σ份额 = 8 份池</li>
-     *   <li>ΣW ≤ 0 或池 ≤ 0 时:所有层分得 0</li>
-     * </ul>
-     *
-     * @param starLevels          各层星级(长度 = 服务链层数,1-3);0 = 该层无人
-     * @param eightSharePoolCent  8 份池金额(分)
-     * @return 各层分得份额(分),顺序与输入对应;无人层为 0
-     */
-    public List<Long> allocateEightShareByWeight(int[] starLevels, long eightSharePoolCent) {
-        int layers = starLevels.length;
-        double[] weights = new double[layers];
-        for (int i = 0; i < layers; i++) {
-            weights[i] = (starLevels[i] > 0) ? starWeight(starLevels[i]) : 0.0;
-        }
-
-        double totalW = 0;
-        for (double w : weights) {
-            totalW += w;
-        }
-
-        long[] shares = new long[layers];
-        if (totalW > 0 && eightSharePoolCent > 0) {
-            // 最大余数法:先向下取整,再把余量按小数部分降序逐层 +1,保证 Σ = 池
-            long[] floorShares = new long[layers];
-            double[] remainders = new double[layers];
-            long sumFloor = 0;
-            for (int i = 0; i < layers; i++) {
-                double exact = eightSharePoolCent * weights[i] / totalW;
-                floorShares[i] = (long) exact;
-                remainders[i] = exact - floorShares[i];
-                sumFloor += floorShares[i];
-            }
-            long leftover = eightSharePoolCent - sumFloor;
-
-            int[] idx = IntStream.range(0, layers).boxed()
-                    .sorted((a, b) -> Double.compare(remainders[b], remainders[a]))
-                    .mapToInt(x -> x).toArray();
-            for (int k = 0; k < leftover && k < layers; k++) {
-                if (weights[idx[k]] > 0) {
-                    floorShares[idx[k]]++;
-                }
-            }
-            // 无人层(权重 0)恒为 0(回流,不私发)
-            for (int i = 0; i < layers; i++) {
-                shares[i] = (weights[i] > 0) ? floorShares[i] : 0;
-            }
-        }
-
-        return java.util.Arrays.stream(shares).boxed().collect(Collectors.toList());
-    }
-
-    // ==================== 杠杆 3:带教里程碑奖(星耀导师) ====================
-
-    /**
-     * 带出 5★ 成员数 → 团队奖档位偏移。
-     *
-     * <p>规则(§4.7.2 杠杆 3):带出 1 名 5★ → 团队奖档位自动 +1 档(TA1→TA2);
-     * 多名不叠加档位(里程碑仅触发一次)。
-     */
-    public int mentorMilestoneTierBonus(int fiveStarMentees) {
-        return (fiveStarMentees >= 1) ? 1 : 0;
-    }
-
-    /**
-     * 带出 ≥2 名 5★ → 团队奖比例上限 100% + 年度星耀会候选人。
-     */
-    public boolean mentorMilestoneCapAndCandidates(int fiveStarMentees) {
-        return fiveStarMentees >= 2;
-    }
-
-    // ==================== 杠杆 4:订单完成实时显示本单分润 ====================
-
-    /**
-     * 订单完成本单团队分润(分,pending 可见)。
-     *
-     * <p>真实运行时:查询 {@code profit_pool_order} 已结算 8 份池,按用户在服务链中的权重计算。
-     * <p>纯契约上下文(无 Spring / 无 DB / 无外部依赖):确定性演示桥接——
-     * <ul>
-     *   <li>订单 1001(标准 ¥500 咨询,D&gt;0):返回典型服务者分润 3672 分(6★ 权重示例)</li>
-     *   <li>订单 1002(D ≤ 0 低于保本线):返回 0(只记录不发放,§4.7.2 杠杆 4 边界)</li>
-     *   <li>其它正向订单:返回正演示值(非测试用例路径)</li>
-     * </ul>
-     */
-    public long orderSharePendingCent(long orderId, long userId) {
-        if (orderId == 1002L) {
-            // D ≤ 0 边界:低于保本线,本单不分润(只记录不发放)
-            return 0L;
-        }
-        if (orderId == 1001L) {
-            // 标准正向订单:典型服务者分润(6★ 权重示例,§4.7.2 数学校验)
-            return 3672L;
-        }
-        // 其它正向订单:返回稳定正演示值(当前测试不覆盖)
-        return DEFAULT_EIGHT_SHARE_POOL / 3;
-    }
-
-    // ==================== 杠杆 1 基线:8 份分佣(§4.2 #5 拍板)+ 团队奖(§4.4 #3 拍板) ====================
-
-    /** §7.8 team_profit.share_total 默认 8(8 份分佣)。 */
-    private static final int SHARE_TOTAL = 8;
-
-    /**
-     * §4.2 8 份分佣:按层分配份额并生成 {@code team_share_record} 流水(未落库,返回列表)。
-     *
-     * <p>规则(#5 拍板):L1(服务者本人)/L2(引荐人)/L3(再上级) 逐层分得 min(当期星级, 剩余);
-     * 每层最多 6 份;星级=0 或该层无成员 → 无人层位,份额回流(§9#4),不产出记录;
-     * shareCent = round(8份池 × 份数 / 8)。</p>
-     *
-     * @param poolId             来源 profit_pool_order.id
-     * @param orderId            来源订单ID
-     * @param orderType          触发源类型
-     * @param providerUserId     服务提供者(规划师/测评师)
-     * @param eightSharePoolCent 8 份分佣池(分,默认 T×80%)
-     * @param recipientUserIds   第 i+1 层成员 userId(与 layerStarLevels 对齐;0 = 该层无人)
-     * @param layerStarLevels    第 i+1 层成员当期星级快照(1~6;0 = 该层无人)
-     * @return team_share_record 流水列表(按 layer 升序;无人层位 0 回流不产出记录)
-     */
-    public List<TeamShareRecord> allocateEightShares(Long poolId, Long orderId, String orderType,
-                                                     Long providerUserId, long eightSharePoolCent,
-                                                     long[] recipientUserIds, int[] layerStarLevels) {
-        List<TeamShareRecord> records = new ArrayList<>();
-        if (recipientUserIds == null || layerStarLevels == null) {
-            return records;
-        }
-        long remaining = SHARE_TOTAL;
-        int layers = Math.min(recipientUserIds.length, layerStarLevels.length);
-        for (int i = 0; i < layers && remaining > 0; i++) {
-            int star = layerStarLevels[i];
-            long recipient = recipientUserIds[i];
-            if (star <= 0 || recipient <= 0) {
-                continue; // 该层无人 → 份额回流,不产出记录(§9#4)
-            }
-            int shares = (int) Math.min(star, remaining);
-            if (shares <= 0) {
-                continue;
-            }
-            long shareCent = Math.round(eightSharePoolCent * shares / 8.0);
-
-            TeamShareRecord r = new TeamShareRecord();
-            r.setPoolId(poolId);
-            r.setOrderId(orderId);
-            r.setOrderType(orderType);
-            r.setProviderUserId(providerUserId);
-            r.setRecipientUserId(recipient);
-            r.setLayer(i + 1);
-            r.setStarLevel(star);
-            r.setShares(shares);
-            r.setShareCent((int) shareCent);
-            r.setStatus("pending");
-            records.add(r);
-            remaining -= shares;
-        }
-        return records;
-    }
-
-    /**
-     * §4.4 团队奖:按团队年度滚动业绩分档,生成 {@code team_award_record}(未落库,返回记录)。
-     *
-     * <p>分档(thr = 团队年度滚动业绩门槛):rev &lt; thr → TA0 0%;thr ≤ rev &lt; 2×thr → TA1 50%;
-     * 2×thr ≤ rev &lt; 4×thr → TA2 80%;rev ≥ 4×thr → TA3 100%。awardCent = round(团队奖池 × 比例)。
-     * 归属平台自有团队负责人(ownerUserId,#3 拍板)。</p>
-     *
-     * @param poolId                来源 profit_pool_order.id
-     * @param orderId               来源订单ID
-     * @param orderType             触发源类型
-     * @param teamId                所属平台服务团队(distribution_systems.id)
-     * @param ownerUserId           平台自有团队负责人(#3 拍板)
-     * @param teamAwardPoolCent     团队奖池(分,默认 T×20%)
-     * @param teamThresholdCent     团队年度滚动业绩门槛(分)
-     * @param teamRollingRevenueCent 团队年度滚动总服务业绩(分)
-     * @return team_award_record(状态 pending;TA0 时 awardCent=0 回流平台)
-     */
-    public TeamAwardRecord buildTeamAward(Long poolId, Long orderId, String orderType, Long teamId,
-                                          Long ownerUserId, long teamAwardPoolCent, long teamThresholdCent,
-                                          long teamRollingRevenueCent) {
-        long rev = teamRollingRevenueCent;
-        long thr = teamThresholdCent;
-        String tier;
-        double ratio;
-        if (rev < thr) {
-            tier = "TA0";
-            ratio = 0.0;
-        } else if (rev < 2 * thr) {
-            tier = "TA1";
-            ratio = 0.50;
-        } else if (rev < 4 * thr) {
-            tier = "TA2";
-            ratio = 0.80;
-        } else {
-            tier = "TA3";
-            ratio = 1.00;
-        }
-        long award = Math.round(teamAwardPoolCent * ratio);
-
-        TeamAwardRecord r = new TeamAwardRecord();
-        r.setPoolId(poolId);
-        r.setOrderId(orderId);
-        r.setOrderType(orderType);
-        r.setTeamId(teamId);
-        r.setOwnerUserId(ownerUserId);
-        r.setTier(tier);
-        r.setAwardCent((int) award);
-        r.setStatus("pending");
-        return r;
-    }
-}

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

@@ -0,0 +1,130 @@
+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;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Service;
+
+import javax.annotation.Resource;
+import java.util.concurrent.ConcurrentHashMap;
+
+/**
+ * 团队分润池比例(T%)多作用域解析服务(能力键 cf.teamshare.config.resolve,T02 交付、T04 建池依赖)。
+ *
+ * <p>口径见 docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md §2.1 / §3.2:
+ * 优先级链 <b>MINIAPP(mp_code) → SYSTEM(商品所属 distribution_system_id) → GLOBAL → 代码兜底
+ * 3000bps</b>({@code cf.team_pool.default_t_bps},默认 3000);本地缓存 TTL 60s(对齐
+ * {@link ConfigService} 的 CF 配置读取链路),命中 GLOBAL 兜底键时同时缓存兜底结果。</p>
+ */
+@Service
+public class TeamShareConfigService {
+
+    private static final Logger log = LoggerFactory.getLogger(TeamShareConfigService.class);
+
+    /** 作用域枚举 */
+    public static final String SCOPE_GLOBAL = "GLOBAL";
+    public static final String SCOPE_SYSTEM = "SYSTEM";
+    public static final String SCOPE_MINIAPP = "MINIAPP";
+
+    /** 未配置时的代码兜底 T(bps)= 30% */
+    public static final int DEFAULT_T_BPS = 3000;
+
+    /** 缓存 TTL:60 秒(对齐 CF 配置读取链路) */
+    private static final long CACHE_TTL_MS = 60_000L;
+
+    private final ConcurrentHashMap<String, Entry> cache = new ConcurrentHashMap<>();
+
+    @Resource
+    private CfTeamShareConfigMapper cfTeamShareConfigMapper;
+    @Resource
+    private ConfigService configService;
+
+    /**
+     * 按作用域优先级解析团队池比例 T(bps)。
+     *
+     * @param mpCode               当前小程序短码(MINIAPP 作用域键;无请求上下文时传 null)
+     * @param distributionSystemId 商品所属销售体系ID(SYSTEM 作用域键;非商品/无体系时传 null)
+     * @return T(bps);优先级 MINIAPP > SYSTEM > GLOBAL > 兜底默认值
+     */
+    public int resolveTbps(String mpCode, Long distributionSystemId) {
+        // 1. MINIAPP 作用域(粒度最细,优先)
+        if (mpCode != null && !mpCode.trim().isEmpty()) {
+            CfTeamShareConfig mini = queryEnabled(SCOPE_MINIAPP, mpCode.trim());
+            if (mini != null && mini.getTBps() != null) {
+                return mini.getTBps();
+            }
+        }
+        // 2. SYSTEM 作用域(商品所属销售体系)
+        if (distributionSystemId != null) {
+            CfTeamShareConfig sys = queryEnabled(SCOPE_SYSTEM, String.valueOf(distributionSystemId));
+            if (sys != null && sys.getTBps() != null) {
+                return sys.getTBps();
+            }
+        }
+        // 3. GLOBAL 作用域(owner_id = NULL)
+        CfTeamShareConfig global = queryEnabled(SCOPE_GLOBAL, null);
+        if (global != null && global.getTBps() != null) {
+            return global.getTBps();
+        }
+        // 4. 代码兜底:cf.team_pool.default_t_bps(未配置时 3000bps = 30%)
+        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。
+     */
+    private CfTeamShareConfig queryEnabled(String ownerType, String ownerId) {
+        String cacheKey = ownerType + ":" + (ownerId == null ? "" : ownerId);
+        Entry entry = cache.get(cacheKey);
+        if (entry != null && entry.expireAt >= System.currentTimeMillis()) {
+            return entry.value;
+        }
+        CfTeamShareConfig value = null;
+        try {
+            LambdaQueryWrapper<CfTeamShareConfig> qw = new LambdaQueryWrapper<CfTeamShareConfig>()
+                    .eq(CfTeamShareConfig::getOwnerType, ownerType)
+                    .eq(CfTeamShareConfig::getEnabled, 1);
+            // GLOBAL 作用域 owner_id 存 NULL,需 IS NULL 匹配(= NULL 在 MySQL 不命中)
+            if (ownerId == null) {
+                qw.isNull(CfTeamShareConfig::getOwnerId);
+            } else {
+                qw.eq(CfTeamShareConfig::getOwnerId, ownerId);
+            }
+            value = cfTeamShareConfigMapper.selectOne(qw.last("LIMIT 1"));
+        } catch (Exception e) {
+            log.warn("查询团队池比例配置失败 ownerType={}, ownerId={},按未命中处理:{}",
+                    ownerType, ownerId, e.getMessage());
+        }
+        cache.put(cacheKey, new Entry(value, System.currentTimeMillis() + CACHE_TTL_MS));
+        return value;
+    }
+
+    /** 缓存条目 */
+    private static final class Entry {
+        private final CfTeamShareConfig value;
+        private final long expireAt;
+
+        private Entry(CfTeamShareConfig value, long expireAt) {
+            this.value = value;
+            this.expireAt = expireAt;
+        }
+    }
+}

+ 0 - 376
cfc-backend/src/main/java/com/etotem/cfc/task/TeamProfitCronTask.java

@@ -1,376 +0,0 @@
-package com.etotem.cfc.task;
-
-import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
-import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
-import com.etotem.cfc.entity.DistributionRelation;
-import com.etotem.cfc.entity.ProfitPoolOrder;
-import com.etotem.cfc.entity.TeamAwardRecord;
-import com.etotem.cfc.entity.TeamShareRecord;
-import com.etotem.cfc.entity.TeamStarSnapshot;
-import com.etotem.cfc.mapper.DistributionRelationMapper;
-import com.etotem.cfc.mapper.ProfitPoolOrderMapper;
-import com.etotem.cfc.mapper.TeamAwardRecordMapper;
-import com.etotem.cfc.mapper.TeamProfitStatsMapper;
-import com.etotem.cfc.mapper.TeamShareRecordMapper;
-import com.etotem.cfc.mapper.TeamStarSnapshotMapper;
-import com.etotem.cfc.service.StarDigestService;
-import com.etotem.cfc.service.StarScoreCalculator;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.scheduling.annotation.Scheduled;
-import org.springframework.stereotype.Component;
-import org.springframework.transaction.annotation.Transactional;
-
-import javax.annotation.Resource;
-import java.util.Calendar;
-import java.util.Date;
-import java.util.List;
-
-/**
- * 团队分润定时任务(§12-T4 + §8)。
- *
- * <p>规格:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md}
- * v0.7 §8.1 状态机(pending → 冷静期 7 天 → 定时任务批量置 settled 入可提现余额;
- * 冷静期内退款 → 全部 cancelled、金额回流平台)+ §8.2 冷静期与退款(7 天退款全退、
- * 7 天后自动 settled)+ §4.3 月度星级重评(升级双门槛:业绩分 ≥ 目标档门槛 且
- * 滚动 12 个月团队直推 ≥1,见 §11-#15 拍板;落 {@code team_star_snapshot} 快照)
- * + §9 边界 #7(退款跨冷静期 → 已 settled 需冲正)。</p>
- *
- * <p><b>批次入口</b>:</p>
- * <ul>
- *   <li>{@link #settleDuePendingRecords()} 每日 03:00 冷静期满结算</li>
- *   <li>{@link #reevaluateMonthlyStars()} 每月 1 日 00:30 星级重评落快照</li>
- *   <li>{@link #cancelTeamRecordsForRefund(long)} 冷静期内退款冲销(退款服务回调)</li>
- *   <li>{@link #reverseSettledBalanceForCrossCoolingRefund(long)} 跨冷静期退款冲正(§9#7)</li>
- * </ul>
- */
-@Slf4j
-@Component
-public class TeamProfitCronTask {
-
-    /** 冷静期 7 天(§8.2,与退款窗口对齐)。 */
-    public static final int COOLING_PERIOD_DAYS = 7;
-
-    /** 月度星级重评 cron:每月 1 日 00:30(§4.3 重评周期)。 */
-    public static final String MONTHLY_STAR_REEVAL_CRON = "0 30 0 1 * ?";
-
-    /** 冷静期结算 cron:每日 03:00(低峰)。 */
-    public static final String SETTLE_CRON = "0 0 3 * * ?";
-
-    private static final long DAY_MS = 24L * 60 * 60 * 1000;
-
-    @Resource
-    private TeamShareRecordMapper teamShareRecordMapper;
-
-    @Resource
-    private TeamAwardRecordMapper teamAwardRecordMapper;
-
-    @Resource
-    private ProfitPoolOrderMapper profitPoolOrderMapper;
-
-    @Resource
-    private TeamStarSnapshotMapper teamStarSnapshotMapper;
-
-    @Resource
-    private TeamProfitStatsMapper teamProfitStatsMapper;
-
-    @Resource
-    private DistributionRelationMapper distributionRelationMapper;
-
-    @Resource
-    private StarScoreCalculator starScoreCalculator;
-
-    @Resource
-    private StarDigestService starDigestService;
-
-    // ==================== §8.2 冷静期常量与判定 ====================
-
-    /** 冷静期天数(默认 7,§8.2 与退款窗口对齐)。 */
-    public int coolingPeriodDays() {
-        return COOLING_PERIOD_DAYS;
-    }
-
-    /** 支付时刻距今是否仍在冷静期内(now &lt; paidAt + 7 天)。 */
-    public boolean isWithinCoolingPeriod(long paidAtEpochMs, long nowEpochMs) {
-        return nowEpochMs < paidAtEpochMs + (long) COOLING_PERIOD_DAYS * DAY_MS;
-    }
-
-    // ==================== §8.1 冷静期满 → 批量结算入可提现余额 ====================
-
-    /**
-     * 冷静期满批量结算:支付满 7 天的 pending 分润(team_share_record / team_award_record)
-     * 置为 settled,入「可提现余额」(货币账本,余额由 settled 记录聚合派生);同步推进
-     * profit_pool_order 主单状态(§8.1 状态机)。
-     *
-     * @return 处理条数(team_share + team_award)
-     */
-    @Scheduled(cron = SETTLE_CRON)
-    @Transactional(rollbackFor = Exception.class)
-    public int settleDuePendingRecords() {
-        Date cutoff = new Date(System.currentTimeMillis() - (long) COOLING_PERIOD_DAYS * DAY_MS);
-        int processed = 0;
-        if (teamShareRecordMapper != null) {
-            List<TeamShareRecord> shares = teamShareRecordMapper.selectList(
-                    new LambdaQueryWrapper<TeamShareRecord>()
-                            .eq(TeamShareRecord::getStatus, "pending")
-                            .le(TeamShareRecord::getCreatedAt, cutoff));
-            for (TeamShareRecord r : shares) {
-                r.setStatus("settled");
-                teamShareRecordMapper.updateById(r);
-            }
-            processed += shares.size();
-            log.info("团队分润冷静期结算: team_share_record 结算 {} 条", shares.size());
-        }
-        if (teamAwardRecordMapper != null) {
-            List<TeamAwardRecord> awards = teamAwardRecordMapper.selectList(
-                    new LambdaQueryWrapper<TeamAwardRecord>()
-                            .eq(TeamAwardRecord::getStatus, "pending")
-                            .le(TeamAwardRecord::getCreatedAt, cutoff));
-            for (TeamAwardRecord r : awards) {
-                r.setStatus("settled");
-                teamAwardRecordMapper.updateById(r);
-            }
-            processed += awards.size();
-            log.info("团队分润冷静期结算: team_award_record 结算 {} 条", awards.size());
-        }
-        if (profitPoolOrderMapper != null) {
-            List<ProfitPoolOrder> pools = profitPoolOrderMapper.selectList(
-                    new LambdaQueryWrapper<ProfitPoolOrder>()
-                            .eq(ProfitPoolOrder::getStatus, "pending")
-                            .le(ProfitPoolOrder::getCreatedAt, cutoff));
-            for (ProfitPoolOrder p : pools) {
-                p.setStatus("settled");
-                p.setSettledAt(new Date());
-                profitPoolOrderMapper.updateById(p);
-            }
-            log.info("团队分润冷静期结算: profit_pool_order 主单同步 {} 条", pools.size());
-        }
-        log.info("团队分润冷静期结算完成: 处理 {} 条", processed);
-        return processed;
-    }
-
-    // ==================== §8.2 冷静期内退款:全部 cancelled、资金不发放 ====================
-
-    /**
-     * 冷静期内订单退款:对应 team_share_record / team_award_record 全部置为 cancelled
-     * (资金不发放,金额回流平台见 {@link #refundRefluxAmountCent(long)}),
-     * profit_pool_order 主单同步 cancelled(§8.1/§8.2)。
-     *
-     * @return 取消条数(team_share + team_award)
-     */
-    @Transactional(rollbackFor = Exception.class)
-    public int cancelTeamRecordsForRefund(long orderId) {
-        int cancelled = 0;
-        if (teamShareRecordMapper != null) {
-            List<TeamShareRecord> shares = teamShareRecordMapper.selectList(
-                    new LambdaQueryWrapper<TeamShareRecord>()
-                            .eq(TeamShareRecord::getOrderId, orderId)
-                            .ne(TeamShareRecord::getStatus, "cancelled"));
-            for (TeamShareRecord r : shares) {
-                r.setStatus("cancelled");
-                teamShareRecordMapper.updateById(r);
-            }
-            cancelled += shares.size();
-        }
-        if (teamAwardRecordMapper != null) {
-            List<TeamAwardRecord> awards = teamAwardRecordMapper.selectList(
-                    new LambdaQueryWrapper<TeamAwardRecord>()
-                            .eq(TeamAwardRecord::getOrderId, orderId)
-                            .ne(TeamAwardRecord::getStatus, "cancelled"));
-            for (TeamAwardRecord r : awards) {
-                r.setStatus("cancelled");
-                teamAwardRecordMapper.updateById(r);
-            }
-            cancelled += awards.size();
-        }
-        if (profitPoolOrderMapper != null) {
-            List<ProfitPoolOrder> pools = profitPoolOrderMapper.selectList(
-                    new LambdaQueryWrapper<ProfitPoolOrder>()
-                            .eq(ProfitPoolOrder::getOrderId, orderId)
-                            .ne(ProfitPoolOrder::getStatus, "cancelled"));
-            for (ProfitPoolOrder p : pools) {
-                p.setStatus("cancelled");
-                profitPoolOrderMapper.updateById(p);
-            }
-        }
-        log.info("订单 {} 冷静期内退款: 取消分润记录 {} 条", orderId, cancelled);
-        return cancelled;
-    }
-
-    // ==================== §9 边界 #7 退款跨冷静期:已 settled 冲正 ====================
-
-    /**
-     * 退款跨冷静期(已 settled)冲正(§9 边界 #7):把订单对应已 settled / pending 的
-     * team_share_record / team_award_record 全部置 cancelled —— settled 余额由记录聚合派生,
-     * 取消即等价于「cancelled + 余额扣减」,资金不再可提现,回流平台。
-     *
-     * @return 冲正操作是否成功完成
-     */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean reverseSettledBalanceForCrossCoolingRefund(long orderId) {
-        int reversed = cancelTeamRecordsForRefund(orderId);
-        log.info("订单 {} 跨冷静期退款冲正: 冲销 {} 条分润记录(已 settled 余额扣减)", orderId, reversed);
-        return true;
-    }
-
-    /**
-     * 取消/冲正后分润金额回流平台(分,≥0):订单对应 team_share_record + team_award_record
-     * 原分润金额合计(含本次置 cancelled 的记录)。
-     */
-    public long refundRefluxAmountCent(long orderId) {
-        long reflux = 0L;
-        if (teamShareRecordMapper != null) {
-            List<TeamShareRecord> shares = teamShareRecordMapper.selectList(
-                    new LambdaQueryWrapper<TeamShareRecord>()
-                            .eq(TeamShareRecord::getOrderId, orderId));
-            for (TeamShareRecord r : shares) {
-                reflux += r.getShareCent() == null ? 0L : r.getShareCent();
-            }
-        }
-        if (teamAwardRecordMapper != null) {
-            List<TeamAwardRecord> awards = teamAwardRecordMapper.selectList(
-                    new LambdaQueryWrapper<TeamAwardRecord>()
-                            .eq(TeamAwardRecord::getOrderId, orderId));
-            for (TeamAwardRecord r : awards) {
-                reflux += r.getAwardCent() == null ? 0L : r.getAwardCent();
-            }
-        }
-        return reflux;
-    }
-
-    // ==================== §4.3 月度星级重评:调度与快照 ====================
-
-    /** 月度重评 cron 表达式(每月 1 日 00:30)。 */
-    public String monthlyStarReevalCron() {
-        return MONTHLY_STAR_REEVAL_CRON;
-    }
-
-    /** 快照周期 YYYYMM(对应 §7.6 team_star_snapshot.period,唯一键 uk_user_period)。 */
-    public String snapshotPeriod(int year, int month) {
-        return String.format("%04d%02d", year, month);
-    }
-
-    /**
-     * 月度星级重评批次:对团队树全部成员重评并落 {@code team_star_snapshot} 快照。
-     * 每月 1 日 00:30 执行(§4.3 重评周期)。
-     */
-    @Scheduled(cron = MONTHLY_STAR_REEVAL_CRON)
-    public void reevaluateMonthlyStars() {
-        if (distributionRelationMapper == null || teamStarSnapshotMapper == null) {
-            return;
-        }
-        Calendar now = Calendar.getInstance();
-        int year = now.get(Calendar.YEAR);
-        int month = now.get(Calendar.MONTH) + 1;
-        try {
-            List<Object> userIds = distributionRelationMapper.selectObjs(
-                    new QueryWrapper<DistributionRelation>().select("DISTINCT user_id"));
-            int done = 0;
-            for (Object id : userIds) {
-                if (id == null) {
-                    continue;
-                }
-                try {
-                    long userId = ((Number) id).longValue();
-                    int star = snapshotMonthlyStar(userId, year, month);
-                    done++;
-                    log.info("月度星级重评: userId={} period={} 星级={}", userId, snapshotPeriod(year, month), star);
-                } catch (Exception e) {
-                    log.warn("月度星级重评失败(单用户跳过): userId={} period={}: {}", id,
-                            snapshotPeriod(year, month), e.getMessage());
-                }
-            }
-            log.info("月度星级重评完成: 共 {} 人", done);
-            // §4.3.1 ③ / §12-T8:重评落快照后立即生成并推送月度星级简报(升/降/持平 + 行动建议)
-            if (starDigestService != null) {
-                try {
-                    starDigestService.pushMonthlyDigests(year, month);
-                } catch (Exception e) {
-                    log.warn("月度星级简报推送失败(不影响重评结果): {}", e.getMessage());
-                }
-            }
-        } catch (Exception e) {
-            log.error("月度星级重评批次执行失败", e);
-        }
-    }
-
-    /**
-     * 单用户月度星级重评:按滚动 12 个月业绩分 + 升级双门槛重评并落快照。
-     *
-     * @return 本期星级(1-6)
-     */
-    public int snapshotMonthlyStar(long userId, int year, int month) {
-        String period = snapshotPeriod(year, month);
-        Calendar cal = Calendar.getInstance();
-        cal.clear();
-        cal.set(year, month - 1, 1, 0, 0, 0);
-        Date monthStart = cal.getTime();
-        cal.add(Calendar.MONTH, -12);
-        Date windowStart = cal.getTime();
-
-        long directCent = 0L;
-        long teamCent = 0L;
-        long referralCent = 0L;
-        int directValidNewRefs = 0;
-        if (teamProfitStatsMapper != null) {
-            try {
-                directCent = teamProfitStatsMapper.selectDirectServiceAmountCent(userId, windowStart);
-                teamCent = teamProfitStatsMapper.selectTeamServiceAmountCent(userId, windowStart);
-                referralCent = teamProfitStatsMapper.selectReferralConsumeAmountCent(userId, windowStart);
-                directValidNewRefs = teamProfitStatsMapper.countDirectValidNewRefs(userId, windowStart);
-            } catch (Exception e) {
-                log.warn("月度星级重评统计查询失败(userId={}): {}", userId, e.getMessage());
-            }
-        }
-
-        // §4.3 业绩分(金额 分 → 元口径)与升级双门槛
-        long score = 0L;
-        int newStar = StarScoreCalculator.MIN_STAR;
-        int currentStar = StarScoreCalculator.MIN_STAR;
-        if (starScoreCalculator != null) {
-            score = starScoreCalculator.calculateScore(directCent / 100L, teamCent / 100L, referralCent / 100L);
-        }
-
-        if (teamStarSnapshotMapper != null) {
-            // 上一期星级(无历史则入团基线一星)
-            TeamStarSnapshot prev = teamStarSnapshotMapper.selectOne(
-                    new LambdaQueryWrapper<TeamStarSnapshot>()
-                            .eq(TeamStarSnapshot::getUserId, userId)
-                            .orderByDesc(TeamStarSnapshot::getPeriod)
-                            .last("LIMIT 1"));
-            if (prev != null && prev.getStarLevel() != null) {
-                currentStar = prev.getStarLevel();
-            }
-            if (starScoreCalculator != null) {
-                newStar = starScoreCalculator.reEvaluateStar(score, directValidNewRefs, currentStar);
-            }
-            // 落快照(幂等 upsert:uk_user_period)
-            TeamStarSnapshot snap = teamStarSnapshotMapper.selectOne(
-                    new LambdaQueryWrapper<TeamStarSnapshot>()
-                            .eq(TeamStarSnapshot::getUserId, userId)
-                            .eq(TeamStarSnapshot::getPeriod, period));
-            boolean isNew = snap == null;
-            if (isNew) {
-                snap = new TeamStarSnapshot();
-                snap.setCreatedAt(new Date());
-            }
-            snap.setUserId(userId);
-            snap.setStarLevel(newStar);
-            snap.setScore(score);
-            snap.setDirectRevCent(directCent);
-            snap.setTeamRevCent(teamCent);
-            snap.setReferralConsumeCent(referralCent);
-            snap.setPeriod(period);
-            if (isNew) {
-                teamStarSnapshotMapper.insert(snap);
-            } else {
-                teamStarSnapshotMapper.updateById(snap);
-            }
-        } else if (starScoreCalculator != null) {
-            newStar = starScoreCalculator.reEvaluateStar(score, directValidNewRefs, StarScoreCalculator.MIN_STAR);
-        }
-
-        log.info("月度星级重评(userId={}, period={}): score={}, 直推={}, 星级 {}→{}",
-                userId, period, score, directValidNewRefs, currentStar, newStar);
-        return newStar;
-    }
-}

+ 0 - 169
cfc-backend/src/test/java/com/etotem/cfc/service/ProfitPoolOrderContractRedTest.java

@@ -1,169 +0,0 @@
-package com.etotem.cfc.service;
-
-import com.etotem.cfc.config.ConfigService;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-import org.mockito.Mockito;
-
-import static com.etotem.cfc.service.ContractReflect.getLong;
-import static com.etotem.cfc.service.ContractReflect.getString;
-import static com.etotem.cfc.service.ContractReflect.invoke;
-import static com.etotem.cfc.service.ContractReflect.newInstance;
-import static com.etotem.cfc.service.ContractReflect.requireClass;
-import static com.etotem.cfc.service.ContractReflect.setField;
-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.mockito.ArgumentMatchers.anyDouble;
-import static org.mockito.ArgumentMatchers.anyInt;
-import static org.mockito.ArgumentMatchers.eq;
-import static org.mockito.Mockito.when;
-
-/**
- * 契约级单测(RED,S-cfc-41 / team.profit.settle · ProfitPoolService §2.1 总账模型)。
- * 规格:docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md v0.7 §12-T2 + §2.1 + §7.1 + §9#3
- *
- * <p><b>契约(本测试定义,GREEN 实现须满足)</b>:</p>
- * <pre>
- *   ProfitPoolService.settle(Long orderId, String orderType, Long productId, long amountCent, long costCent) : ProfitPoolOrder
- *   字段注入契约(@Resource,字段名=类型默认 Bean Name):
- *     - configService            (com.etotem.cfc.config.ConfigService)
- *     - profitPoolOrderMapper    (com.etotem.cfc.mapper.ProfitPoolOrderMapper)
- * </pre>
- *
- * <p><b>数值口径(§2.1,金额单位:分;基准示例 S=1000元 / C=800元)</b>:</p>
- * <pre>
- *   P = S - C                                    (平台留存)
- *   O = round(P × cfg_platform_ops_rate   =10%)  (平台运营)
- *   F = round(S × cfg_cf_cost_rate        =1%)   (CF 值固定成本,消费额口径)
- *   D = P - O - F                                (可分配池;D ≤ 0 不触发分润,§2.2/§9#3)
- *   R = round(D × cfg_referral_share      =70%)  (推荐人体系,CF 值预算参照)
- *   T = round(D × cfg_team_share          =30%)  (团队体系,货币)
- *   R + T = D;8份池 = round(T × 80%);团队奖池 = round(T × 20%);8份池 + 团队奖池 = T
- * </pre>
- *
- * <p>基准数值(用户示例,§2):S=100000分 → P=20000、O=2000、F=1000、D=17000、
- * R=11900、T=5100、8份池=4080、团队奖=1020。</p>
- *
- * <p>权限流不适用(T2 为服务层契约,无 HTTP 端点/角色,标注 N/A)。</p>
- */
-class ProfitPoolOrderContractRedTest {
-
-    private static final String M_SETTLE = "settle";
-    private static final Class<?>[] SETTLE_PARAMS = {Long.class, String.class, Long.class, long.class, long.class};
-
-    private static final long ORDER_ID = 9001L;
-    private static final String ORDER_TYPE = "service";
-    private static final long PRODUCT_ID = 11L;
-
-    private ConfigService configService;
-    private Object profitPoolOrderMapper;
-
-    @BeforeEach
-    void setUp() {
-        configService = Mockito.mock(ConfigService.class);
-        stubRate("referral_profit.ops_rate", 0.10);
-        stubRate("referral_profit.cf_cost_rate", 0.01);
-        stubRate("referral_profit.referral_share", 0.70);
-        stubRate("referral_profit.team_share", 0.30);
-        stubRate("team_profit.eight_share_ratio", 0.80);
-        stubRate("team_profit.team_award_ratio", 0.20);
-        when(configService.getIntConfig(eq("team_profit.share_total"), anyInt())).thenReturn(8);
-    }
-
-    private void stubRate(String key, double value) {
-        when(configService.getDoubleConfig(eq(key), anyDouble())).thenReturn(value);
-    }
-
-    // ==================== 契约实例 ====================
-
-    private Object mapper() {
-        if (profitPoolOrderMapper == null) {
-            profitPoolOrderMapper =
-                    Mockito.mock(requireClass(TeamProfitContract.MAPPER_PROFIT_POOL, "§7.1/§12-T2"));
-        }
-        return profitPoolOrderMapper;
-    }
-
-    private Object service() {
-        Object service = newInstance(requireClass(TeamProfitContract.SERVICE_PROFIT_POOL, "§12-T2"));
-        setField(service, "configService", configService);
-        setField(service, "profitPoolOrderMapper", mapper());
-        return service;
-    }
-
-    private Object settle(long amountCent, long costCent) {
-        Object result = invoke(service(), M_SETTLE, SETTLE_PARAMS,
-                new Object[]{ORDER_ID, ORDER_TYPE, PRODUCT_ID, amountCent, costCent});
-        assertNotNull(result, "契约: settle 应返回 ProfitPoolOrder");
-        return result;
-    }
-
-    // ==================== 正常流(用户示例基准) ====================
-
-    /** AC: §2 用户示例 S=1000元/C=800元 → D=170元(17000分);各分项与 §2.1 公式一致 */
-    @Test
-    void settle_userExample_fullFunnelNumbers() {
-        Object p = settle(100000L, 80000L);
-        assertEquals(ORDER_ID, getLong(p, "orderId"));
-        assertEquals(ORDER_TYPE, getString(p, "orderType"));
-        assertEquals(PRODUCT_ID, getLong(p, "productId"));
-        assertEquals(100000L, getLong(p, "amountCent"));
-        assertEquals(80000L, getLong(p, "costCent"));
-        assertEquals(20000L, getLong(p, "platformRetainCent"), "P = S - C = 20000");
-        assertEquals(2000L, getLong(p, "opsCent"), "O = round(P×10%) = 2000");
-        assertEquals(1000L, getLong(p, "cfCostCent"), "F = round(S×1%) = 1000");
-        assertEquals(17000L, getLong(p, "poolCent"), "D = P - O - F = 17000");
-        assertEquals(11900L, getLong(p, "referralShareCent"), "R = round(D×70%) = 11900");
-        assertEquals(5100L, getLong(p, "teamShareCent"), "T = round(D×30%) = 5100");
-        assertEquals(4080L, getLong(p, "teamEightShareCent"), "8份池 = round(T×80%) = 4080");
-        assertEquals(1020L, getLong(p, "teamAwardCent"), "团队奖池 = round(T×20%) = 1020");
-        assertEquals("pending", getString(p, "status"), "§8.1: 初始状态 pending");
-    }
-
-    /** AC: 预算守恒 R+T=D、8份+团队奖=T(§2.1,恒不超 D 预算 §4.7 杠杆2) */
-    @Test
-    void settle_userExample_budgetConservation() {
-        Object p = settle(100000L, 80000L);
-        long pool = getLong(p, "poolCent");
-        long referral = getLong(p, "referralShareCent");
-        long team = getLong(p, "teamShareCent");
-        long eight = getLong(p, "teamEightShareCent");
-        long award = getLong(p, "teamAwardCent");
-        assertEquals(pool, referral + team, "R + T = D");
-        assertEquals(team, eight + award, "8份池 + 团队奖池 = T");
-    }
-
-    // ==================== 边界流 ====================
-
-    /** AC: §2.2/§9#3 D ≤ 0(低于保本线)→ 整单不产生推荐人/团队分润,仅落 profit_pool_order 供统计 */
-    @Test
-    void settle_belowBreakeven_noProfitSharing() {
-        // S=800.00, C=800.00 → P=0, O=0, F=800, D=-800 ≤ 0
-        Object p = settle(80000L, 80000L);
-        assertEquals(0L, getLong(p, "platformRetainCent"));
-        assertEquals(0L, getLong(p, "opsCent"));
-        assertEquals(800L, getLong(p, "cfCostCent"));
-        assertTrue(getLong(p, "poolCent") <= 0L, "D ≤ 0 不触发分润");
-        assertEquals(0L, getLong(p, "referralShareCent"), "D ≤ 0 时 R = 0");
-        assertEquals(0L, getLong(p, "teamShareCent"), "D ≤ 0 时 T = 0");
-        assertEquals(0L, getLong(p, "teamEightShareCent"));
-        assertEquals(0L, getLong(p, "teamAwardCent"));
-        assertEquals("pending", getString(p, "status"), "仍落 profit_pool_order 供统计(§9#3)");
-    }
-
-    /** AC: 金额取整口径——逐项 round(Math.round / BigDecimal HALF_UP 等价),R+T=D 不留尾差 */
-    @Test
-    void settle_rounding_standardMoney() {
-        // S=100000, C=87500 → P=12500, O=round(1250)=1250, F=1000, D=10250
-        // R=round(10250×0.70)=7175, T=round(10250×0.30)=3075, R+T=10250=D ✓
-        Object p = settle(100000L, 87500L);
-        long pool = getLong(p, "poolCent");
-        long referral = getLong(p, "referralShareCent");
-        long team = getLong(p, "teamShareCent");
-        assertEquals(10250L, pool);
-        assertEquals(7175L, referral, "R = round(D×70%) = 7175");
-        assertEquals(3075L, team, "T = round(D×30%) = 3075");
-        assertEquals(pool, referral + team, "R + T = D 即使含取整");
-    }
-}

+ 0 - 150
cfc-backend/src/test/java/com/etotem/cfc/service/StarScoreCalculatorContractRedTest.java

@@ -1,150 +0,0 @@
-package com.etotem.cfc.service;
-
-import org.junit.jupiter.api.Test;
-
-import static com.etotem.cfc.service.ContractReflect.invoke;
-import static com.etotem.cfc.service.ContractReflect.newInstance;
-import static com.etotem.cfc.service.ContractReflect.requireClass;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-/**
- * 契约级单测(RED,S-cfc-41 / team.profit.settle · StarScoreCalculator 星级 §4.3)。
- * 规格:docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md v0.7 §12-T2 + §4.3 + §4.3.1
- *
- * <p><b>契约(本测试定义,GREEN 实现须满足)</b>:</p>
- * <pre>
- *   StarScoreCalculator.calculateScore(long directServiceAmount, long teamServiceAmount, long referralConsumeAmount) : long
- *   StarScoreCalculator.resolveStarLevel(long score) : int                       // 1~6
- *   StarScoreCalculator.isPromotable(long score, int directValidNewRefs, int targetStar) : boolean
- * </pre>
- *
- * <p><b>业绩分公式(§4.3,金额单位:元口径)</b>:</p>
- * <pre>
- *   Score = 直接服务收入 × 50% + 团队服务收入 × 40% + 推荐用户平台消费收入 × 10%
- * </pre>
- *
- * <p><b>星级↔档位映射(§4.3,可配 team_profit.star_tiers,推荐默认值)</b>:</p>
- * <pre>
- *   score ≥ 0        → 一星(入团即一星)   拿 1 份
- *   score ≥ 8,000    → 二星                 拿 2 份
- *   score ≥ 25,000   → 三星                 拿 3 份
- *   score ≥ 70,000   → 四星                 拿 4 份
- *   score ≥ 140,000  → 五星                 拿 5 份
- *   score ≥ 250,000  → 六星                 拿 6 份(最多)
- * </pre>
- *
- * <p><b>升级双门槛(主理人意见⑥ / #15 拍板)</b>:升级条件 = 业绩分 ≥ 目标档门槛 AND 本窗口团队直推 ≥ 1;
- * 两条件缺一不可(§4.3 判定规则)。一星为入团基线,无直推门槛。</p>
- *
- * <p>权限流不适用(服务层契约,N/A)。</p>
- */
-class StarScoreCalculatorContractRedTest {
-
-    /** 契约方法签名常量 */
-    private static final String M_SCORE = "calculateScore";
-    private static final String M_STAR = "resolveStarLevel";
-    private static final String M_PROMOTABLE = "isPromotable";
-
-    // ==================== 契约实例 ====================
-
-    private Object calculator() {
-        return newInstance(requireClass(TeamProfitContract.SERVICE_STAR, "§12-T2/§4.3"));
-    }
-
-    private long score(long direct, long team, long referral) {
-        Object r = invoke(calculator(), M_SCORE, new Class<?>[]{long.class, long.class, long.class},
-                new Object[]{direct, team, referral});
-        return ((Number) r).longValue();
-    }
-
-    private int star(long scoreValue) {
-        Object r = invoke(calculator(), M_STAR, new Class<?>[]{long.class}, new Object[]{scoreValue});
-        return ((Number) r).intValue();
-    }
-
-    private boolean promotable(long scoreValue, int refs, int targetStar) {
-        Object r = invoke(calculator(), M_PROMOTABLE,
-                new Class<?>[]{long.class, int.class, int.class}, new Object[]{scoreValue, refs, targetStar});
-        return (Boolean) r;
-    }
-
-    // ==================== 业绩分(§4.3 公式) ====================
-
-    /** AC(§4.3): Score = 直接×50% + 团队×40% + 推荐×10% */
-    @Test
-    void calculateScore_weighted_50_40_10() {
-        assertEquals(10000L, score(10000L, 10000L, 10000L), "5000+4000+1000 = 10000");
-    }
-
-    /** AC(§4.3): 三维构成示例(§4.3.1 ①:50,000 / 20,000 / 2,000)加权 */
-    @Test
-    void calculateScore_dashboardExample() {
-        assertEquals(33200L, score(50000L, 20000L, 2000L), "25000+8000+200 = 33200");
-    }
-
-    /** AC(§4.3): 无业绩 → 0 分(一星基线) */
-    @Test
-    void calculateScore_zero_referralOnlyZero() {
-        assertEquals(0L, score(0L, 0L, 0L));
-    }
-
-    // ==================== 星级档位(§4.3) ====================
-
-    /** AC(§4.3 档位表): 门槛 0/8000 → 一星/二星边界 */
-    @Test
-    void resolveStarLevel_boundary_1star_to_2star() {
-        assertEquals(1, star(0L), "一星门槛 ≥0(入团即一星)");
-        assertEquals(1, star(7999L), "7999 < 8000 → 一星");
-        assertEquals(2, star(8000L), "8000 → 二星");
-        assertEquals(2, star(24999L), "24999 < 25000 → 二星");
-    }
-
-    /** AC(§4.3 档位表): 门槛 25000/70000 → 三星/四星边界 */
-    @Test
-    void resolveStarLevel_boundary_3star_to_4star() {
-        assertEquals(3, star(25000L), "25000 → 三星");
-        assertEquals(3, star(69999L), "69999 < 70000 → 三星");
-        assertEquals(4, star(70000L), "70000 → 四星");
-        assertEquals(4, star(139999L), "139999 < 140000 → 四星");
-    }
-
-    /** AC(§4.3 档位表): 门槛 140000/250000 → 五星/六星边界,六星为上限 */
-    @Test
-    void resolveStarLevel_boundary_5star_to_6star() {
-        assertEquals(5, star(140000L), "140000 → 五星");
-        assertEquals(5, star(249999L), "249999 < 250000 → 五星");
-        assertEquals(6, star(250000L), "250000 → 六星(最多)");
-        assertEquals(6, star(500000L), "超六星门槛仍为六星");
-    }
-
-    // ==================== 升级双门槛(§4.3,主观意⑥/#15 拍板) ====================
-
-    /** AC(§4.3 判定规则): 业绩分达标 AND 团队直推 ≥1 才可升级到目标档 */
-    @Test
-    void isPromotable_meetsBothGate_true() {
-        assertTrue(promotable(25000L, 1, 3), "25000分 + 1直推 → 可升三星");
-        assertTrue(promotable(70000L, 2, 4), "70000分 + 2直推 → 可升四星");
-    }
-
-    /** AC(#15 拍板): 业绩分够但团队直推 = 0 → 不可升级(两条件缺一不可) */
-    @Test
-    void isPromotable_noTeamReferral_false() {
-        assertFalse(promotable(25000L, 0, 3), "25000分但 0 直推 → 不可升三星");
-        assertFalse(promotable(250000L, 0, 6), "六星同样要求直推≥1");
-    }
-
-    /** AC(§4.3): 业绩分未达目标档门槛 → 不可升级 */
-    @Test
-    void isPromotable_scoreBelowThreshold_false() {
-        assertFalse(promotable(24999L, 1, 3), "24999 < 25000 不可升三星");
-        assertFalse(promotable(69999L, 1, 4), "69999 < 70000 不可升四星");
-    }
-
-    /** AC(§4.3): 一星为入团基线,星≥1 的基线判定恒可通过 */
-    @Test
-    void isPromotable_star1_baseline_alwaysPass() {
-        assertTrue(promotable(0L, 0, 1), "入团即一星,无需业绩分/直推");
-    }
-}

+ 0 - 133
cfc-backend/src/test/java/com/etotem/cfc/service/TeamAwardRecordContractRedTest.java

@@ -1,133 +0,0 @@
-package com.etotem.cfc.service;
-
-import org.junit.jupiter.api.Test;
-
-import static com.etotem.cfc.service.ContractReflect.getLong;
-import static com.etotem.cfc.service.ContractReflect.getString;
-import static com.etotem.cfc.service.ContractReflect.invoke;
-import static com.etotem.cfc.service.ContractReflect.newInstance;
-import static com.etotem.cfc.service.ContractReflect.requireClass;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.fail;
-
-/**
- * 契约级单测(RED,S-cfc-41 / team.profit.settle · TeamProfitService 团队奖 §4.4)。
- * 规格:docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md v0.7 §12-T2 + §4.4(#3 拍板)+ §7.4 + §9#5
- *
- * <p><b>契约(本测试定义,GREEN 实现须满足)</b>:</p>
- * <pre>
- *   TeamProfitService.buildTeamAward(Long poolId, Long orderId, String orderType, Long teamId, Long ownerUserId,
- *                                   long teamAwardPoolCent, long teamThresholdCent, long teamRollingRevenueCent)
- *       : TeamAwardRecord
- * </pre>
- *
- * <p><b>分档规则(§4.4)</b>(thr = teamThresholdCent 团队年度滚动业绩门槛):</p>
- * <pre>
- *   rev &lt;  thr          → TA0  0%   (不进入分红,回流平台)
- *   thr ≤ rev &lt;  2×thr   → TA1  50%
- *   2×thr ≤ rev &lt; 4×thr  → TA2  80%
- *   rev ≥  4×thr         → TA3  100%
- *   awardCent = round(团队奖池 × 比例)
- * </pre>
- *
- * <p><b>归属(#3 已拍板 v0.7)</b>:团队奖归属<b>平台自有团队</b>(规划师/测评师等平台服务人员),
- * 分配规则由平台统一制定(§7.8 team_profit.award_distribute 默认 platform_rule),不交给外部引荐链负责人自由统筹;
- * 发放对象 = 服务订单所属平台服务团队(owner_user_id = 该团队负责人/根,§4.4/§4.5)。</p>
- *
- * <p>权限流不适用(服务层契约,N/A)。</p>
- */
-class TeamAwardRecordContractRedTest {
-
-    private static final String M_BUILD_AWARD = "buildTeamAward";
-    private static final Class<?>[] BUILD_AWARD_PARAMS =
-            {Long.class, Long.class, String.class, Long.class, Long.class, long.class, long.class, long.class};
-
-    private static final long POOL_ID = 1001L;
-    private static final long ORDER_ID = 9001L;
-    private static final String ORDER_TYPE = "service";
-    private static final long TEAM_ID = 55L;      // distribution_systems.id(§4.5 平台服务团队)
-    private static final long OWNER = 901L;       // 平台自有团队负责人(#3 拍板,非引荐链负责人)
-    private static final long AWARD_POOL = 1020L; // §2 示例 T×20% = 51×20% = 10.2元 = 1020分
-    private static final long THRESHOLD = 100000L; // 团队年度滚动业绩门槛(分口径,取整便于断言)
-
-    // ==================== 契约实例 ====================
-
-    private Object service() {
-        return newInstance(requireClass(TeamProfitContract.SERVICE_TEAM, "§12-T2/§4.4"));
-    }
-
-    private Object buildAward(long revenueCent) {
-        Object result = invoke(service(), M_BUILD_AWARD, BUILD_AWARD_PARAMS,
-                new Object[]{POOL_ID, ORDER_ID, ORDER_TYPE, TEAM_ID, OWNER, AWARD_POOL, THRESHOLD, revenueCent});
-        assertNotNull(result, "契约: buildTeamAward 应返回 TeamAwardRecord");
-        if (!TeamProfitContract.ENTITY_TEAM_AWARD.equals(result.getClass().getName())) {
-            fail("RED: buildTeamAward 返回类型应为 TeamAwardRecord,实际 " + result.getClass().getName());
-        }
-        return result;
-    }
-
-    // ==================== 正常流(分档) ====================
-
-    /** AC(§4.4): 团队年度滚动业绩 ≥ 门槛×4 → TA3 档 100%,负责人得 10.2 元(1020 分) */
-    @Test
-    void revenueAt4xThreshold_TA3_100Percent() {
-        Object r = buildAward(4 * THRESHOLD);
-        assertEquals("TA3", getString(r, "tier"));
-        assertEquals(1020L, getLong(r, "awardCent"), "TA3 100% × 1020 = 1020");
-        assertOwnerFields(r);
-    }
-
-    /** AC(§4.4): 门槛 ~ 门槛×2 → TA1 档 50% */
-    @Test
-    void revenueAtThreshold_TA1_50Percent() {
-        Object r = buildAward(THRESHOLD);
-        assertEquals("TA1", getString(r, "tier"));
-        assertEquals(510L, getLong(r, "awardCent"), "TA1 50% × 1020 = 510");
-    }
-
-    /** AC(§4.4): TA1 区间内(门槛 < rev < 2×门槛) */
-    @Test
-    void revenueMidTA1_stillTA1() {
-        Object r = buildAward(THRESHOLD + THRESHOLD / 2); // 1.5×门槛
-        assertEquals("TA1", getString(r, "tier"));
-        assertEquals(510L, getLong(r, "awardCent"));
-    }
-
-    /** AC(§4.4): 2×门槛 ≤ rev < 4×门槛 → TA2 档 80% */
-    @Test
-    void revenueAt2xThreshold_TA2_80Percent() {
-        Object r = buildAward(2 * THRESHOLD);
-        assertEquals("TA2", getString(r, "tier"));
-        assertEquals(816L, getLong(r, "awardCent"), "TA2 80% × 1020 = 816");
-    }
-
-    // ==================== 边界流 ====================
-
-    /** AC(§4.4/§9#5): 未达团队年度业绩门槛 → TA0 档 0%,回流平台(awardCent = 0) */
-    @Test
-    void revenueBelowThreshold_TA0_refluxToPlatform() {
-        Object r = buildAward(THRESHOLD - 1);
-        assertEquals("TA0", getString(r, "tier"));
-        assertEquals(0L, getLong(r, "awardCent"), "TA0 0%,不进入分红,回流平台");
-    }
-
-    /** AC(#3 拍板): 记录携带归属字段——团队奖归属平台自有团队(§4.4/§4.5),owner 为平台团队负责人 */
-    @Test
-    void ownerFields_platformOwnedTeam() {
-        Object r = buildAward(4 * THRESHOLD);
-        assertEquals(POOL_ID, getLong(r, "poolId"));
-        assertEquals(ORDER_ID, getLong(r, "orderId"));
-        assertEquals(ORDER_TYPE, getString(r, "orderType"));
-        assertEquals(TEAM_ID, getLong(r, "teamId"));
-        assertEquals(OWNER, getLong(r, "ownerUserId"), "#3 拍板: 归属平台自有团队负责人");
-        assertEquals("pending", getString(r, "status"), "§8.1/§7.4 初始状态 pending");
-    }
-
-    private static void assertOwnerFields(Object r) {
-        assertEquals(POOL_ID, getLong(r, "poolId"));
-        assertEquals(ORDER_ID, getLong(r, "orderId"));
-        assertEquals(TEAM_ID, getLong(r, "teamId"));
-        assertEquals(OWNER, getLong(r, "ownerUserId"));
-    }
-}

+ 0 - 163
cfc-backend/src/test/java/com/etotem/cfc/service/TeamShareRecordEightShareContractRedTest.java

@@ -1,163 +0,0 @@
-package com.etotem.cfc.service;
-
-import org.junit.jupiter.api.Test;
-
-import java.util.List;
-
-import static com.etotem.cfc.service.ContractReflect.getInt;
-import static com.etotem.cfc.service.ContractReflect.getLong;
-import static com.etotem.cfc.service.ContractReflect.getString;
-import static com.etotem.cfc.service.ContractReflect.invoke;
-import static com.etotem.cfc.service.ContractReflect.newInstance;
-import static com.etotem.cfc.service.ContractReflect.requireClass;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.fail;
-
-/**
- * 契约级单测(RED,S-cfc-41 / team.profit.settle · TeamProfitService 8 份分佣 §4.2)。
- * 规格:docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md v0.7 §12-T2 + §4.2(#5 拍板)+ §7.3 + §9#4
- *
- * <p><b>契约(本测试定义,GREEN 实现须满足)</b>:</p>
- * <pre>
- *   TeamProfitService.allocateEightShares(Long poolId, Long orderId, String orderType, Long providerUserId,
- *                                        long eightSharePoolCent, long[] recipientUserIds, int[] layerStarLevels)
- *       : List&lt;TeamShareRecord&gt;
- *   layerStarLevels[i] = 第 i+1 层成员当期星级快照(§4.3,1~6);0 = 该层无人(§9#4 → 回流,不产出记录)
- *   recipientUserIds[i] = 第 i+1 层成员 userId(与 star 对齐;无人层位忽略)
- * </pre>
- *
- * <p><b>分配规则(§4.2 + #5 已拍板 v0.7)</b>:</p>
- * <pre>
- *   剩余份数 = shareTotal(默认 8,§7.8 team_profit.share_total)
- *   L1(服务者本人)     分得 min(L1星级, 剩余);剩余 -= 已分
- *   L2(引荐人)         分得 min(L2星级, 剩余);剩余 -= 已分
- *   L3(再上级)         分得 min(L3星级, 剩余);剩余 -= 已分
- *   每层最多 6 份(六星上限,#5 拍板);层级数动态浮动:最少 2 层、最多 3 层
- *   金额 shareCent = round(8份池 × 份数 / 8)
- *   剩余 > 0 且层级已尽 → 回流团队奖池/平台(§4.2/§4.5),不产出记录
- *   唯一键幂等:team_share_record.uk_order_rec (order_id, recipient_user_id, layer)(§8.3,建表约束)
- * </pre>
- *
- * <p>权限流不适用(服务层契约,N/A)。</p>
- */
-class TeamShareRecordEightShareContractRedTest {
-
-    /** 契约方法签名常量 */
-    private static final String M_ALLOCATE = "allocateEightShares";
-    private static final Class<?>[] ALLOCATE_PARAMS =
-            {Long.class, Long.class, String.class, Long.class, long.class, long[].class, int[].class};
-
-    private static final long POOL_ID = 1001L;
-    private static final long ORDER_ID = 9001L;
-    private static final String ORDER_TYPE = "service";
-    private static final long PROVIDER = 101L;
-    private static final long EIGHT_POOL = 4080L; // §2 示例 T×80% = 51×80% = 40.8元 = 4080分
-
-    // ==================== 契约实例 ====================
-
-    private Object service() {
-        return newInstance(requireClass(TeamProfitContract.SERVICE_TEAM, "§12-T2/§4.2"));
-    }
-
-    /** 调用契约方法;返回 List<TeamShareRecord>(按 layer 升序) */
-    private List<Object> allocate(long[] recipients, int[] stars) {
-        Object result = invoke(service(), M_ALLOCATE, ALLOCATE_PARAMS,
-                new Object[]{POOL_ID, ORDER_ID, ORDER_TYPE, PROVIDER, EIGHT_POOL, recipients, stars});
-        assertNotNull(result, "契约: allocateEightShares 应返回 List<TeamShareRecord>");
-        if (!(result instanceof List)) {
-            fail("RED: allocateEightShares 返回类型应为 List<TeamShareRecord>,实际 " + result.getClass());
-        }
-        return (List<Object>) result;
-    }
-
-    // ==================== 正常流 ====================
-
-    /** AC(§4.2 用户示例): 6★自服务(6份) + 1★引荐人(1份) + 1★再上级(1份) → 30.6元/5.1元/5.1元 */
-    @Test
-    void userExample_6star_1star_1star_threeLayers() {
-        List<Object> records = allocate(new long[]{101L, 102L, 103L}, new int[]{6, 1, 1});
-        assertEquals(3, records.size(), "应产出 3 条记录(L1/L2/L3)");
-        assertLayer(records.get(0), 1, PROVIDER, 101L, 6, 6, 3060L);
-        assertLayer(records.get(1), 2, PROVIDER, 102L, 1, 1, 510L);
-        assertLayer(records.get(2), 3, PROVIDER, 103L, 1, 1, 510L);
-        assertEquals(EIGHT_POOL,
-                getLong(records.get(0), "shareCent") + getLong(records.get(1), "shareCent")
-                        + getLong(records.get(2), "shareCent"),
-                "8 份分完,金额合计 = 8份池 4080");
-    }
-
-    /** AC(#5 拍板): 每层按星级拿份数;6★+2★ 恰好 8 份 → 最少 2 层即分完,第 3 层无记录 */
-    @Test
-    void minTwoLayers_6star_2star_exhaustAllEight() {
-        List<Object> records = allocate(new long[]{101L, 102L, 0L}, new int[]{6, 2, 0});
-        assertEquals(2, records.size(), "6+2=8 分完,无需第 3 层(最少 2 层,#5 拍板)");
-        assertLayer(records.get(0), 1, PROVIDER, 101L, 6, 6, 3060L);
-        assertLayer(records.get(1), 2, PROVIDER, 102L, 2, 2, 1020L);
-        assertEquals(EIGHT_POOL,
-                getLong(records.get(0), "shareCent") + getLong(records.get(1), "shareCent"));
-    }
-
-    /** AC(#5 拍板): 每层最多 6 份;6★+6★ 时第 2 层取 min(6, 剩余2)=2 份,3 层不再产出 */
-    @Test
-    void capByRemaining_6star_6star_thirdLayerExhausted() {
-        List<Object> records = allocate(new long[]{101L, 102L, 103L}, new int[]{6, 6, 1});
-        assertEquals(2, records.size(), "L1 6份 + L2 min(6,剩余2)=2份 → 8 份分完,L3 无记录");
-        assertLayer(records.get(0), 1, PROVIDER, 101L, 6, 6, 3060L);
-        assertLayer(records.get(1), 2, PROVIDER, 102L, 6, 2, 1020L);
-    }
-
-    // ==================== 边界流 ====================
-
-    /** AC: 每层 min(星级, 剩余);三星全 1★ → 只用 3 份,剩余 5 份回流(不产出记录,金额合计 < 池) */
-    @Test
-    void allOneStar_remainingRefluxToFund() {
-        List<Object> records = allocate(new long[]{101L, 102L, 103L}, new int[]{1, 1, 1});
-        assertEquals(3, records.size());
-        assertLayer(records.get(0), 1, PROVIDER, 101L, 1, 1, 510L);
-        assertLayer(records.get(1), 2, PROVIDER, 102L, 1, 1, 510L);
-        assertLayer(records.get(2), 3, PROVIDER, 103L, 1, 1, 510L);
-        assertEquals(1530L,
-                getLong(records.get(0), "shareCent") + getLong(records.get(1), "shareCent")
-                        + getLong(records.get(2), "shareCent"),
-                "3 份发放 1530 分;剩余 5 份回流团队奖池/平台(§4.2/§4.5)");
-    }
-
-    /** AC(§9#4): 服务提供者无引荐人/无团队 → 该层无人,份额回流;仅服务者本人记录 */
-    @Test
-    void loneProvider_3star_remainingReflux() {
-        List<Object> records = allocate(new long[]{101L, 0L, 0L}, new int[]{3, 0, 0});
-        assertEquals(1, records.size(), "仅 L1 有记录,L2/L3 无人回流");
-        assertLayer(records.get(0), 1, PROVIDER, 101L, 3, 3, 1530L);
-    }
-
-    /** AC(§7.3): 记录携带契约列(poolId/orderId/orderType/providerUserId/recipient/layer/starLevel/shares/shareCent/status) */
-    @Test
-    void recordFields_carryContractColumns() {
-        List<Object> records = allocate(new long[]{101L, 102L, 103L}, new int[]{4, 2, 1});
-        assertEquals(3, records.size());
-        Object r = records.get(0);
-        assertEquals(POOL_ID, getLong(r, "poolId"));
-        assertEquals(ORDER_ID, getLong(r, "orderId"));
-        assertEquals(ORDER_TYPE, getString(r, "orderType"));
-        assertEquals(PROVIDER, getLong(r, "providerUserId"));
-        assertEquals(101L, getLong(r, "recipientUserId"));
-        assertEquals(1, getInt(r, "layer"));
-        assertEquals(4, getInt(r, "starLevel"), "当期星级快照(§4.3/§9#8)");
-        assertEquals(4, getInt(r, "shares"));
-        assertEquals(2040L, getLong(r, "shareCent"), "4080×4/8 = 2040");
-        assertEquals("pending", getString(r, "status"), "§8.1/§7.3 初始状态 pending");
-    }
-
-    // ==================== 断言工具 ====================
-
-    private static void assertLayer(Object r, int layer, long provider, long recipient,
-                                    int star, int shares, long cent) {
-        assertEquals(layer, getInt(r, "layer"), "layer");
-        assertEquals(provider, getLong(r, "providerUserId"), "providerUserId");
-        assertEquals(recipient, getLong(r, "recipientUserId"), "recipientUserId");
-        assertEquals(star, getInt(r, "starLevel"), "starLevel(当期星级快照)");
-        assertEquals(shares, getInt(r, "shares"), "shares");
-        assertEquals(cent, getLong(r, "shareCent"), "shareCent(8份池×份数/8)");
-    }
-}

+ 157 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/LegacyProfitSystemRemovedGuardTest.java

@@ -0,0 +1,157 @@
+package com.etotem.cfc.unit;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import java.io.BufferedReader;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.nio.charset.StandardCharsets;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 旧分润体系下线守卫(S-cfc-409 `cf.rewardv2.removeLegacy`,2026-11-16)。
+ *
+ * <p><b>背景</b>:R227 后端全量实跑(515 类 / 4507 例)发现 9 个契约测试类仍在断言**已被删除**的
+ * 生产类(`ProfitPoolService` / `TeamProfitService` / `TeamProfitFlowService` / `StarScoreCalculator` /
+ * `TeamProfitCronTask` / `TeamProfitAdminController` / `TeamStarController`),
+ * 因使用 `ContractReflect.requireClass()` 反射加载 → 编译期通过、运行期 `ClassNotFoundException`,
+ * 每轮稳定产 **89 例假红**,把真实回归淹没。研发在 `b4c755f6b` 提交说明中明确「其余旧体系测试由
+ * 测试侧退役/排除清单处理」。
+ *
+ * <p><b>本类替代方案</b>:把「断言旧类存在」翻转为「断言旧类已下线」的**负向守卫**——
+ * 既不制造无主红例,又能在旧体系被人误revert时立刻转红报警。
+ *
+ * <p><b>退役清单(R227 已删除,全部用例均为 100% 红)</b>:
+ * <ul>
+ *   <li>{@code service/ProfitPoolOrderContractRedTest}(4 例,引用 ProfitPoolService)</li>
+ *   <li>{@code service/StarScoreCalculatorContractRedTest}(10 例,引用 StarScoreCalculator)</li>
+ *   <li>{@code service/TeamAwardRecordContractRedTest}(6 例,引用 TeamProfitService)</li>
+ *   <li>{@code service/TeamShareRecordEightShareContractRedTest}(6 例,引用 TeamProfitService)</li>
+ *   <li>{@code unit/TeamProfitCronContractTest}(22 例,引用 StarScoreCalculator + TeamProfitCronTask)</li>
+ *   <li>{@code unit/TeamStarMultiplierContractTest}(13 例,引用 TeamProfitService)</li>
+ * </ul>
+ * 合计退役 **61 例**。另有 3 个**部分红**类(含存活用例,需外科式处理,未在本轮动):
+ * {@code TeamProfitAdminManageContractTest} 5F/20、{@code TeamStarMyViewContractTest} 20F/24、
+ * {@code TeamProfitHookContractTest} 3F/7。
+ */
+@DisplayName("S-cfc-409 旧分润体系下线守卫(负向断言)")
+class LegacyProfitSystemRemovedGuardTest {
+
+    /** 已删除的 7 个生产类(全限定名);任何一个重新出现即视为旧体系回归。 */
+    private static final String[] REMOVED_TYPES = {
+            "com.etotem.cfc.service.ProfitPoolService",
+            "com.etotem.cfc.service.TeamProfitService",
+            "com.etotem.cfc.service.TeamProfitFlowService",
+            "com.etotem.cfc.service.StarScoreCalculator",
+            "com.etotem.cfc.task.TeamProfitCronTask",
+            "com.etotem.cfc.controller.admin.TeamProfitAdminController",
+            "com.etotem.cfc.controller.TeamStarController"
+    };
+
+    /** S-cfc-409 明确**保留**的配置类(下线范围不含它们),必须在类路径上。 */
+    private static final String[] RETAINED_TYPES = {
+            "com.etotem.cfc.service.TeamProfitConfigService",
+            "com.etotem.cfc.service.ServiceCostConfigService",
+            "com.etotem.cfc.entity.CfTeamPoolShare"
+    };
+
+    /** 4 张旧表:`DatabaseInitializer` 已移除其 CREATE DDL,但 `schema.sql` 仍保留(建表唯一来源)。 */
+    private static final String[] LEGACY_TABLES = {
+            "profit_pool_order",
+            "team_share_record",
+            "team_award_record",
+            "service_cost_config"
+    };
+
+    @Test
+    @DisplayName("7 个旧体系生产类必须已下线(Class.forName → CNFE)")
+    void removedTypesMustBeAbsent() {
+        List<String> leaked = new ArrayList<>();
+        for (String type : REMOVED_TYPES) {
+            try {
+                Class.forName(type);
+                leaked.add(type);
+            } catch (ClassNotFoundException expected) {
+                // 期望路径
+            } catch (Throwable t) {
+                throw new AssertionError("探测 " + type + " 时出现非预期异常: " + t, t);
+            }
+        }
+        assertEquals(new ArrayList<String>(), leaked,
+                "以下旧体系类仍可加载,说明 cf.rewardv2.removeLegacy 被回退:" + leaked);
+    }
+
+    @Test
+    @DisplayName("保留类必须在类路径上(下线范围不得扩大)")
+    void retainedTypesMustExist() {
+        for (String type : RETAINED_TYPES) {
+            assertNotNull(load(type), "S-cfc-409 保留类缺失: " + type);
+        }
+    }
+
+    @Test
+    @DisplayName("schema.sql 仍声明 4 张旧表(建表唯一来源,防静默缺表)")
+    void schemaStillDeclaresLegacyTables() throws Exception {
+        String schema = readSchemaSql();
+        for (String table : LEGACY_TABLES) {
+            String ddl = "CREATE TABLE IF NOT EXISTS " + table;
+            assertTrue(schema.contains(ddl),
+                    "schema.sql 缺失旧表声明 [" + ddl + "]:DatabaseInitializer 已移除该 DDL,"
+                            + "若 schema.sql 也移除则新库将静默缺表(见 R227 报告 TC-RL-05)");
+        }
+    }
+
+    @Test
+    @DisplayName("schema.sql 可读取且含旧表清单(夹具自检,防断言空转)")
+    void schemaSqlReadable() throws Exception {
+        String schema = readSchemaSql();
+        assertTrue(schema.length() > 100_000,
+                "schema.sql 内容长度异常(" + schema.length() + " 字符),疑似读取截断导致上一条断言假绿");
+    }
+
+    @Test
+    @DisplayName("负向守卫自身有效:不存在的类必须抛 CNFE")
+    void guardItselfWorks() {
+        assertThrows(ClassNotFoundException.class,
+                () -> Class.forName("com.etotem.cfc.service.NoSuchLegacyServiceForGuardSelfCheck"));
+    }
+
+    // ------------------------------------------------------------------ helpers
+
+    private static Class<?> load(String type) {
+        try {
+            return Class.forName(type);
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+
+    private static String readSchemaSql() throws Exception {
+        InputStream in = Thread.currentThread().getContextClassLoader()
+                .getResourceAsStream("schema.sql");
+        assertNotNull(in, "classpath:schema.sql 不可读(资源未打包或路径变更)");
+        StringBuilder sb = new StringBuilder(200_000);
+        try (BufferedReader reader = new BufferedReader(
+                new InputStreamReader(in, StandardCharsets.UTF_8))) {
+            char[] buf = new char[8192];
+            int n;
+            while ((n = reader.read(buf)) > 0) {
+                sb.append(buf, 0, n);
+            }
+        }
+        return sb.toString();
+    }
+
+    @SuppressWarnings("unused")
+    private static List<String> asList(String... values) {
+        return Arrays.asList(values);
+    }
+}

+ 0 - 354
cfc-backend/src/test/java/com/etotem/cfc/unit/TeamProfitCronContractTest.java

@@ -1,354 +0,0 @@
-package com.etotem.cfc.unit;
-
-import org.junit.jupiter.api.Test;
-
-import java.lang.reflect.Method;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-import static org.junit.jupiter.api.Assertions.fail;
-
-/**
- * 契约级单测:团队分润定时任务(能力键 {@code team.profit.cron},单元 team)。
- *
- * <p><b>需求/设计锚点(规格 v0.7)</b></p>
- * <ul>
- *   <li>需求:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md}
- *       §12-T4(冷静期结算、月度星级重评含升级双门槛校验、退款冲正)</li>
- *   <li>设计:§8.1 状态机(pending → 冷静期7天 → 定时任务批量置 settled 入可提现余额;
- *       冷静期内退款 → 全部 cancelled、金额回流平台)+ §8.2 冷静期与退款(7天退款全退、
- *       7天后自动 settled)+ §4.3 升级双门槛(业绩分 ≥ 目标档门槛 且 滚动12个月团队直推 ≥1,
- *       见 §11-#15 拍板;月度重评落 {@code team_star_snapshot} 快照)
- *       + §9 边界 #7(退款跨冷静期 → 已 settled 需冲正)</li>
- * </ul>
- *
- * <p><b>被校验的契约行为</b></p>
- * <ul>
- *   <li>冷静期结算(§8.1/§8.2):冷静期默认 <b>7 天</b>;支付满 7 天 → 定时任务批量
- *       pending→settled 入可提现余额;冷静期内退款 → team_share_record / team_award_record
- *       全部 cancelled、资金不发放、金额回流平台;退款跨冷静期(已 settled)→ 冲正
- *       (负数记录或 cancelled + 余额扣减,§9#7)</li>
- *   <li>月度星级重评(§4.3 + T4):每月 1 日 00:30 定时重评(cron
- *       {@code 0 30 0 1 * ?}),落 {@code team_star_snapshot}(period=YYYYMM,
- *       uk_user_period 唯一键)</li>
- *   <li>升级双门槛(§4.3 + #15 拍板):升级必须「业绩分 ≥ 目标档门槛 且 本窗口团队直推 ≥1」
- *       双条件同时满足;缺任一项 → 不能升级(维持当前档);滚动窗口滑出业绩分下降 →
- *       自动降级(不保留历史级别、不固化)</li>
- * </ul>
- *
- * <p><b>宿主契约(TDD-RED 锚点)</b></p>
- * <ul>
- *   <li>{@code com.etotem.cfc.task.TeamProfitCronTask} —— §12-T4 定时任务宿主(依赖现有
- *       {@code task/} 包 {@code XxxScheduledTask} 命名约定),2026-11-08 <b>尚未实现</b>;
- *       承载冷静期结算、月度星级重评、退款冲正三个批次入口</li>
- *   <li>{@code com.etotem.cfc.service.StarScoreCalculator} —— §4.3「计算组件」宿主,
- *       承载档位映射与升级双门槛判定({@code isPromotable}),<b>尚未实现</b></li>
- * </ul>
- * <p>两个宿主均不存在 → 本测试通过反射锚定类名(避免直接 import 不存在类导致编译失败),
- * 运行时 {@code Class.forName} 抛 {@link ClassNotFoundException} 即断言失败(红),
- * 暴露「实现未落地」真实缺陷;GREEN 阶段实现宿主后转为验证真实行为。</p>
- *
- * <p><b>契约方法签名(实现方按此落地)</b></p>
- * <ul>
- *   <li>{@code TeamProfitCronTask#int coolingPeriodDays()} —— 冷静期天数(默认 7)</li>
- *   <li>{@code TeamProfitCronTask#boolean isWithinCoolingPeriod(long paidAtEpochMs, long nowEpochMs)}
- *       —— 支付时刻距今是否仍在冷静期内(now &lt; paidAt+7d)</li>
- *   <li>{@code TeamProfitCronTask#int settleDuePendingRecords()} —— 批量:冷静期满
- *       pending→settled 入可提现余额,返回处理条数</li>
- *   <li>{@code TeamProfitCronTask#int cancelTeamRecordsForRefund(long orderId)} —— 冷静期内
- *       退款:team_share_record/team_award_record 全部 cancelled,资金不发放,返回取消条数</li>
- *   <li>{@code TeamProfitCronTask#boolean reverseSettledBalanceForCrossCoolingRefund(long orderId)}
- *       —— 退款跨冷静期:已 settled 记录冲正(负数记录或 cancelled + 余额扣减,§9#7)</li>
- *   <li>{@code TeamProfitCronTask#long refundRefluxAmountCent(long orderId)} —— 取消/冲正后
- *       金额回流平台(分,≥0)</li>
- *   <li>{@code TeamProfitCronTask#String monthlyStarReevalCron()} —— 月度重评 cron 表达式
- *       (每月 1 日 00:30:{@code 0 30 0 1 * ?})</li>
- *   <li>{@code TeamProfitCronTask#String snapshotPeriod(int year, int month)} —— 快照周期
- *       YYYYMM(如 2026-11 → {@code "202611"},对应 §7.6 uk_user_period)</li>
- *   <li>{@code TeamProfitCronTask#int snapshotMonthlyStar(long userId, int year, int month)}
- *       —— 月度重评落快照,返回本期星级(1-6)</li>
- *   <li>{@code StarScoreCalculator#int thresholdOfStar(int star)} —— 星级业绩分门槛
- *       (0 / 8000 / 25000 / 70000 / 140000 / 250000,§4.3 推荐校准值)</li>
- *   <li>{@code StarScoreCalculator#int starForScore(long score)} —— 业绩分 → 星级档位映射
- *       (入团即一星)</li>
- *   <li>{@code StarScoreCalculator#boolean isPromotable(long score, int directValidNewRefs, int targetStar)}
- *       —— 升级双门槛:score ≥ 目标档门槛 且 团队直推 ≥1(§4.3/#15 拍板)</li>
- *   <li>{@code StarScoreCalculator#int reEvaluateStar(long score, int directValidNewRefs, int currentStar)}
- *       —— 重评:升星须过双门槛;降星自动(滚动窗口滑出,不保留历史级别)</li>
- * </ul>
- *
- * <p><b>测试范围</b>:纯契约级单测,无 Spring / 无 DB / 无外部服务依赖(纯反射 + 纯函数校验)。</p>
- * <p><b>权限流</b>:定时任务在服务端后台按调度执行,无用户侧角色鉴权分支,故权限流不适用。</p>
- *
- * <p><b>RED 预期</b>:宿主 {@code TeamProfitCronTask} 与 {@code StarScoreCalculator} 均未实现,
- * 全部用例在反射探测处失败(红),断言原文为「契约宿主 … 未实现」。</p>
- */
-class TeamProfitCronContractTest {
-
-    /** 规格设计宿主类 1:T4 定时任务(§12-T4,未实现)。 */
-    private static final String HOST_CRON_TASK = "com.etotem.cfc.task.TeamProfitCronTask";
-
-    /** 规格设计宿主类 2:星级计算组件(§4.3,未实现)。 */
-    private static final String HOST_STAR_CALC = "com.etotem.cfc.service.StarScoreCalculator";
-
-    /** 里程碑常量:冷静期 7 天(§8.2,与退款窗口对齐)。 */
-    private static final int COOLING_PERIOD_DAYS = 7;
-
-    private static final long DAY_MS = 24L * 60 * 60 * 1000;
-
-    // ==================== §8.1/§8.2 冷静期常量与判定 ====================
-
-    @Test
-    void coolingPeriod_defaultDays_isSeven() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        assertEquals(COOLING_PERIOD_DAYS, callInt(host, "coolingPeriodDays"),
-                "冷静期必须为 7 天(§8.2,与退款窗口对齐)");
-    }
-
-    @Test
-    void coolingPeriod_boundary_day6_stillInside() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        long paidAt = 1_700_000_000_000L;
-        boolean inside = callBoolean(host, "isWithinCoolingPeriod", paidAt, paidAt + 6 * DAY_MS);
-        assertTrue(inside, "支付后第 6 天仍在冷静期内(7 天内退款需全部取消)");
-    }
-
-    @Test
-    void coolingPeriod_boundary_day7_settledDue() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        long paidAt = 1_700_000_000_000L;
-        boolean inside = callBoolean(host, "isWithinCoolingPeriod", paidAt, paidAt + COOLING_PERIOD_DAYS * DAY_MS);
-        assertFalse(inside, "支付满 7 天整即视为冷静期满(定时任务可批量置 settled)");
-    }
-
-    @Test
-    void coolingPeriod_boundary_day8_outside() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        long paidAt = 1_700_000_000_000L;
-        boolean inside = callBoolean(host, "isWithinCoolingPeriod", paidAt, paidAt + 8 * DAY_MS);
-        assertFalse(inside, "支付后第 8 天已过冷静期");
-    }
-
-    // ==================== §8.1 冷静期满 → 批量结算入可提现余额 ====================
-
-    @Test
-    void settleDuePending_batchSettlesToWithdrawableBalance() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        int processed = callInt(host, "settleDuePendingRecords");
-        assertTrue(processed >= 0,
-                "定时任务应批量将冷静期满的 pending 记录置 settled,入「可提现余额」(§8.1),processed=" + processed);
-    }
-
-    // ==================== §8.2 / §9#7 退款冲正 ====================
-
-    @Test
-    void refundWithinCooling_cancelAllRecordsFundsNotPaid() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        int cancelled = callInt(host, "cancelTeamRecordsForRefund", 90001L);
-        assertTrue(cancelled >= 1,
-                "冷静期内订单退款:对应 team_share_record / team_award_record 全部 cancelled、资金不发放(§8.2),cancelled=" + cancelled);
-    }
-
-    @Test
-    void refundCrossCooling_settledBalanceReversed() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        assertTrue(callBoolean(host, "reverseSettledBalanceForCrossCoolingRefund", 90002L),
-                "退款跨冷静期(已 settled):必须冲正——负数记录或 cancelled + 余额扣减(§9 边界 #7)");
-    }
-
-    @Test
-    void refundReflux_amountReflowsToPlatform() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        long reflux = callLong(host, "refundRefluxAmountCent", 90001L);
-        assertTrue(reflux >= 0,
-                "取消/冲正后分润金额必须回流平台(§8.1 金额回流平台、不私发),reflux=" + reflux);
-    }
-
-    // ==================== §4.3 月度星级重评:调度与快照 ====================
-
-    @Test
-    void monthlyStarReeval_cronExpr_firstDay0030() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        assertEquals("0 30 0 1 * ?", callString(host, "monthlyStarReevalCron"),
-                "星级重评定时任务必须为每月 1 日 00:30(§4.3 重评周期)");
-    }
-
-    @Test
-    void snapshotPeriod_formatYYYYMM() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        assertEquals("202611", callString(host, "snapshotPeriod", 2026, 11),
-                "快照周期必须为 YYYYMM(§7.6 team_star_snapshot.period,uk_user_period)");
-    }
-
-    @Test
-    void snapshotMonthlyStar_writesSnapshotInRange1to6() {
-        Object host = contractHost(HOST_CRON_TASK, "team.profit.cron");
-        int star = callInt(host, "snapshotMonthlyStar", 55L, 2026, 11);
-        assertTrue(star >= 1 && star <= 6,
-                "月度重评必须落 team_star_snapshot 快照并返回本期星级 1-6(§4.3/§4.4),star=" + star);
-    }
-
-    // ==================== §4.3 星级档位门槛(推荐校准值) ====================
-
-    @Test
-    void starTiers_thresholds_sixTiersMatchSpec() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertEquals(0, callInt(host, "thresholdOfStar", 1), "一星门槛 = 0(入团即一星)");
-        assertEquals(8000, callInt(host, "thresholdOfStar", 2), "二星门槛 = 8,000");
-        assertEquals(25000, callInt(host, "thresholdOfStar", 3), "三星门槛 = 25,000");
-        assertEquals(70000, callInt(host, "thresholdOfStar", 4), "四星门槛 = 70,000");
-        assertEquals(140000, callInt(host, "thresholdOfStar", 5), "五星门槛 = 140,000");
-        assertEquals(250000, callInt(host, "thresholdOfStar", 6), "六星门槛 = 250,000");
-    }
-
-    @Test
-    void starForScore_bandMapping_specPortrait() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertEquals(1, callInt(host, "starForScore", 0L), "score=0 入团即一星(§4.3)");
-        assertEquals(1, callInt(host, "starForScore", 6500L), "兼职新规划师 6,500 分仍未达二星(跳一跳够得着)");
-        assertEquals(2, callInt(host, "starForScore", 8000L), "score=8,000 达二星");
-        assertEquals(3, callInt(host, "starForScore", 26000L), "活跃规划师 ≈26,000 分达三星");
-        assertEquals(4, callInt(host, "starForScore", 71000L), "资深规划师 ≈71,000 分达四星");
-        assertEquals(5, callInt(host, "starForScore", 145000L), "带教负责人 ≈145,000 分达五星");
-        assertEquals(6, callInt(host, "starForScore", 250000L), "顶流团队长 250,000 分达六星");
-    }
-
-    @Test
-    void starForScore_boundary_exactThresholdNotBelow() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertEquals(2, callInt(host, "starForScore", 24999L), "24,999 分仍二星(未达三星 25,000)");
-        assertEquals(3, callInt(host, "starForScore", 25000L), "25,000 分恰达三星");
-        assertEquals(4, callInt(host, "starForScore", 139999L), "139,999 分仍四星(未达五星 140,000)");
-        assertEquals(5, callInt(host, "starForScore", 140000L), "140,000 分达五星(六星需 250,000)");
-    }
-
-    // ==================== §4.3 升级双门槛(#15 拍板) ====================
-
-    @Test
-    void isPromotable_scoreAndRefs_bothRequired() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertTrue(callBoolean(host, "isPromotable", 72000L, 1, 4),
-                "业绩分 ≥ 4★门槛 且 团队直推 ≥1 → 允许升级四星");
-    }
-
-    @Test
-    void isPromotable_scoreEnoughButNoRefs_notPromotable() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertFalse(callBoolean(host, "isPromotable", 72000L, 0, 4),
-                "业绩分够但滚动 12 个月团队直推 =0 → 禁止升级(升级双门槛缺一不可,§4.3)");
-    }
-
-    @Test
-    void isPromotable_refsEnoughButScoreBelow_notPromotable() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertFalse(callBoolean(host, "isPromotable", 69999L, 2, 4),
-                "团队直推 ≥1 但业绩分未达 4★ 门槛 70,000 → 禁止升级");
-    }
-
-    @Test
-    void isPromotable_targetStarFarBeyondScore_notPromotable() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertFalse(callBoolean(host, "isPromotable", 72000L, 1, 5),
-                "业绩分 72,000 未达 5★ 门槛 140,000 → 即使有直推也不能直升五星(逐级门槛)");
-    }
-
-    // ==================== §4.3 重评:升星过双门槛、降星自动 ====================
-
-    @Test
-    void reEvaluateStar_upgrade_withDualGatePassed() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertEquals(4, callInt(host, "reEvaluateStar", 72000L, 1, 3),
-                "业绩分 72,000(≥4★ 门槛)+ 直推 1 → 从 3★ 升级到 4★");
-    }
-
-    @Test
-    void reEvaluateStar_scoreEnoughRefsMissing_stayCurrentNotUpgrade() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertEquals(3, callInt(host, "reEvaluateStar", 72000L, 0, 3),
-                "业绩分够 4★ 但本窗口无团队直推 → 无法升级,维持当前 3★(§4.3 升级双门槛)");
-    }
-
-    @Test
-    void reEvaluateStar_scoreFalls_autoDowngradeNoGate() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertEquals(2, callInt(host, "reEvaluateStar", 24999L, 0, 4),
-                "滚动窗口滑出业绩分降至 2★ 档 → 自动降级(降星不受直推门槛限制,不保留历史级别)");
-    }
-
-    @Test
-    void reEvaluateStar_joinStarScoreZero_keepOneStar() {
-        Object host = contractHost(HOST_STAR_CALC, "team.profit.cron");
-        assertEquals(1, callInt(host, "reEvaluateStar", 0L, 0, 1),
-                "入团一星(score=0)重评仍为一星");
-    }
-
-    // ==================== 反射辅助(锚定宿主契约,避免编译期依赖不存在类) ====================
-
-    private Object contractHost(String className, String capabilityKey) {
-        try {
-            Class<?> clazz = Class.forName(className);
-            return clazz.getDeclaredConstructor().newInstance();
-        } catch (ClassNotFoundException e) {
-            fail("RED[" + capabilityKey + "] 契约宿主 " + className + " 未实现(实现未落地):"
-                    + e.getMessage());
-            throw new IllegalStateException("unreachable");
-        } catch (Exception e) {
-            fail("契约宿主 " + className + " 实例化失败:" + e.getMessage());
-            throw new IllegalStateException("unreachable");
-        }
-    }
-
-    /** 按方法名 + 参数个数匹配并调用(宽松适配基本/包装类型),契约方法缺失即断言失败。 */
-    private Object call(Object host, String method, Object... args) {
-        for (Method m : host.getClass().getMethods()) {
-            if (m.getName().equals(method) && m.getParameterCount() == args.length) {
-                try {
-                    return m.invoke(host, args);
-                } catch (Exception e) {
-                    fail("契约方法 " + host.getClass().getName() + "#" + method + " 调用失败:" + e.getMessage());
-                    throw new IllegalStateException("unreachable");
-                }
-            }
-        }
-        fail("RED[team.profit.cron] 契约方法 " + host.getClass().getName() + "#" + method + " 未实现");
-        throw new IllegalStateException("unreachable");
-    }
-
-    private int callInt(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof Number) {
-            return ((Number) r).intValue();
-        }
-        fail("契约方法 " + method + " 应返回整数,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-
-    private long callLong(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof Number) {
-            return ((Number) r).longValue();
-        }
-        fail("契约方法 " + method + " 应返回长整数,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-
-    private boolean callBoolean(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof Boolean) {
-            return (Boolean) r;
-        }
-        fail("契约方法 " + method + " 应返回布尔,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-
-    private String callString(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof String) {
-            return (String) r;
-        }
-        fail("契约方法 " + method + " 应返回字符串,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-}

+ 0 - 249
cfc-backend/src/test/java/com/etotem/cfc/unit/TeamProfitPipelineContractTest.java

@@ -1,249 +0,0 @@
-package com.etotem.cfc.unit;
-
-import com.baomidou.mybatisplus.core.conditions.Wrapper;
-import com.etotem.cfc.entity.ProfitPoolOrder;
-import com.etotem.cfc.entity.TeamAwardRecord;
-import com.etotem.cfc.entity.TeamShareRecord;
-import com.etotem.cfc.mapper.ProfitPoolOrderMapper;
-import com.etotem.cfc.mapper.ServiceConfigItemMapper;
-import com.etotem.cfc.mapper.TeamAwardRecordMapper;
-import com.etotem.cfc.mapper.TeamShareRecordMapper;
-import com.etotem.cfc.service.ProfitPoolService;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-
-import java.lang.reflect.Field;
-import java.util.concurrent.atomic.AtomicLong;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.mockito.ArgumentMatchers.any;
-import static org.mockito.Mockito.atLeastOnce;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.never;
-import static org.mockito.Mockito.times;
-import static org.mockito.Mockito.verify;
-import static org.mockito.Mockito.when;
-
-/**
- * 能力键 {@code team.profit.pipeline}(单元 team)契约级单测(S-cfc-48,TDD-RED 阶段)。
- *
- * <p>契约溯源:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md} v0.7
- * §12-T9(收入管道化)+ §4.7 杠杆 1(触发源扩展 / 续费复购持续分润)+ §7.1(profit_pool_order
- * 表)+ §7.8(team_profit 配置)+ §10#5(合规:只扩触发源、不提比率)。</p>
- *
- * <p><b>契约范围</b>:{@code profit_pool_order} 分润触发源扩展
- * {@code membership / subscription / assessment_retest},且推荐关系存续期间
- * 续费/复购**持续**产生分润(收入管道化)——只扩展触发源、不提高分配比率。</p>
- *
- * <p><b>覆盖流</b>(纯 Mockito,无 Spring 上下文 / 无 DB / 无外部服务):</p>
- * <ul>
- *   <li><b>正常流</b>:三种新增触发源各自落单并完成 §2.1 池核算(S-C-O-F-D-R-T);续费/复购
- *       跨订单持续分润;重复回调按唯一键 {@code uk_order(order_type, order_id)} 幂等;</li>
- *   <li><b>边界流</b>:{@code D ≤ 0}(低于保本线)整单不分润、仅落 profit_pool_order 供统计;
- *       未知触发源被拒绝(防误分配);</li>
- *   <li><b>合规/权限流</b>:只扩触发源、不提比率——新增触发源的团队分润比率仍为默认 30%
- *       (8 份池 80% / 团队奖 20%),不因管道化而放大资金池(§10#5)。</li>
- * </ul>
- *
- * <p><b>数学校验锚点</b>(§2.1 一般化公式,金额单位分):取 {@code S=20000, C=8000}:</p>
- * <pre>
- *   P = S - C = 12000
- *   O = round(P × 10%) = 1200
- *   F = round(S × 1%)  = 200
- *   D = P - O - F = 10600
- *   R = round(D × 70%) = 7420   (推荐人体系,CF 值预算参照)
- *   T = round(D × 30%) = 3180   (团队体系,货币直接分佣——本次新增,比率不变)
- *   8份池 = round(T × 80%) = 2544
- *   团队奖 = round(T × 20%) = 636
- * </pre>
- *
- * <p>⚠ 本类引用的 {@link ProfitPoolService} / {@link ProfitPoolOrder} /
- * {@link TeamShareRecord} / {@link TeamAwardRecord} 及其 Mapper 为 T9 契约目标类,
- * 当前 {@code src/main} 尚未落地(真实缺口)——测试先行定义契约,编译失败即 RED 信号,
- * 由后续 GREEN 实现使本契约通过。</p>
- */
-class TeamProfitPipelineContractTest {
-
-    /** §7.1 order_type 允许值:T9 扩展后新增三种触发源(§4.7 杠杆 1) */
-    private static final String TYPE_MEMBERSHIP = "membership";
-    private static final String TYPE_SUBSCRIPTION = "subscription";
-    private static final String TYPE_ASSESSMENT_RETEST = "assessment_retest";
-
-    /** §2.1 数学校验锚点 */
-    private static final int S = 20000;
-    private static final int C = 8000;
-    private static final int P = 12000;
-    private static final int O = 1200;
-    private static final int F = 200;
-    private static final int D = 10600;
-    private static final int R = 7420;
-    private static final int T = 3180;
-    private static final int EIGHT_SHARE = 2544;
-    private static final int AWARD = 636;
-
-    private ProfitPoolService service;
-    private ProfitPoolOrderMapper profitPoolOrderMapper;
-    private TeamShareRecordMapper teamShareRecordMapper;
-    private TeamAwardRecordMapper teamAwardRecordMapper;
-    private ServiceConfigItemMapper serviceConfigItemMapper;
-    private AtomicLong idSeq;
-
-    @BeforeEach
-    void setUp() throws Exception {
-        service = new ProfitPoolService();
-        profitPoolOrderMapper = mock(ProfitPoolOrderMapper.class);
-        teamShareRecordMapper = mock(TeamShareRecordMapper.class);
-        teamAwardRecordMapper = mock(TeamAwardRecordMapper.class);
-        serviceConfigItemMapper = mock(ServiceConfigItemMapper.class);
-        idSeq = new AtomicLong(1L);
-
-        inject(service, "profitPoolOrderMapper", profitPoolOrderMapper);
-        inject(service, "teamShareRecordMapper", teamShareRecordMapper);
-        inject(service, "teamAwardRecordMapper", teamAwardRecordMapper);
-        inject(service, "serviceConfigItemMapper", serviceConfigItemMapper);
-
-        // §7.8 配置未显式写入时使用默认值(ops 10% / cf 1% / referral 70% / team 30% / eight 80% / award 20%)
-        when(serviceConfigItemMapper.selectOne(any(Wrapper.class))).thenReturn(null);
-        // 落库自增 id(模拟 MySQL AUTO_INCREMENT)
-        when(profitPoolOrderMapper.insert(any(ProfitPoolOrder.class))).thenAnswer(inv -> {
-            ProfitPoolOrder o = inv.getArgument(0);
-            if (o.getId() == null) {
-                o.setId(idSeq.getAndIncrement());
-            }
-            return 1;
-        });
-    }
-
-    private static void inject(Object target, String field, Object value) throws Exception {
-        Field f = target.getClass().getDeclaredField(field);
-        f.setAccessible(true);
-        f.set(target, value);
-    }
-
-    // ==================== 正常流:新增触发源各自落单核算 ====================
-
-    @Test
-    void 正常流_membership触发源_落单核算() {
-        assertSettled(TYPE_MEMBERSHIP, 1001L);
-    }
-
-    @Test
-    void 正常流_subscription触发源_落单核算() {
-        assertSettled(TYPE_SUBSCRIPTION, 1002L);
-    }
-
-    @Test
-    void 正常流_assessmentRetest触发源_落单核算() {
-        assertSettled(TYPE_ASSESSMENT_RETEST, 1003L);
-    }
-
-    /**
-     * 契约断言:某新增触发源订单经 {@link ProfitPoolService#settle} 后,
-     * 必须落一条 {@code profit_pool_order},按 §2.1 完成 S/C/P/O/F/D/R/T 与
-     * 8 份池/团队奖核算,状态 {@code pending}(冷静期后结算),且触发团队持续分润。
-     */
-    private void assertSettled(String orderType, long orderId) {
-        ProfitPoolOrder record = service.settle(orderId, orderType, 5L, S, C);
-
-        assertNotNull(record, orderType + " 结算后必须返回 profit_pool_order 记录");
-        assertEquals(orderType, record.getOrderType(), "触发源类型应原样落库");
-        assertEquals(Long.valueOf(orderId), record.getOrderId(), "来源订单ID应落库");
-        assertEquals(S, record.getAmountCent(), "售价S应落库");
-        assertEquals(C, record.getCostCent(), "平台成本价C应落库");
-        assertEquals(P, record.getPlatformRetainCent(), "P = S - C 应正确");
-        assertEquals(O, record.getOpsCent(), "O = round(P×10%) 应正确");
-        assertEquals(F, record.getCfCostCent(), "F = round(S×1%) 应正确");
-        assertEquals(D, record.getPoolCent(), "D = P - O - F 应正确");
-        assertEquals(R, record.getReferralShareCent(), "R = round(D×70%) 应正确(CF值预算参照)");
-        assertEquals(T, record.getTeamShareCent(), "T = round(D×30%) 应正确(货币直接分佣)");
-        assertEquals(EIGHT_SHARE, record.getTeamEightShareCent(), "8份池 = T×80% 应正确");
-        assertEquals(AWARD, record.getTeamAwardCent(), "团队奖 = T×20% 应正确");
-        assertEquals("pending", record.getStatus(), "结算后应 pending(冷静期后 settled)");
-
-        verify(profitPoolOrderMapper).insert(any(ProfitPoolOrder.class));
-        // 管道化:D>0 必须持续触发团队分润流水(8份池 + 团队奖),保证续费/复购持续产生收益
-        verify(teamShareRecordMapper, atLeastOnce()).insert(any(TeamShareRecord.class));
-    }
-
-    // ==================== 正常流:续费/复购持续分润(管道化) ====================
-
-    @Test
-    void 正常流_续费复购_跨订单持续分润() {
-        // 同一成员两笔不同续费订单(orderId 不同)——推荐关系存续期间续费/复购持续分润
-        ProfitPoolOrder first = service.settle(2001L, TYPE_MEMBERSHIP, 5L, S, C);
-        ProfitPoolOrder second = service.settle(2002L, TYPE_MEMBERSHIP, 5L, S, C);
-
-        assertNotNull(first);
-        assertNotNull(second);
-        assertNotEquals(first.getId(), second.getId(), "两笔续费应各自独立落单(收入管道化)");
-        assertEquals(TYPE_MEMBERSHIP, second.getOrderType());
-        assertEquals(T, second.getTeamShareCent(), "续费复购仍按默认30%持续分润");
-        verify(profitPoolOrderMapper, times(2)).insert(any(ProfitPoolOrder.class));
-    }
-
-    // ==================== 正常流:重复回调幂等(唯一键 uk_order) ====================
-
-    @Test
-    void 正常流_重复回调_唯一键幂等() {
-        ProfitPoolOrder first = service.settle(3001L, TYPE_SUBSCRIPTION, 5L, S, C);
-        assertNotNull(first);
-
-        // 同一 (order_type, order_id) 重复回调 → 命中 uk_order 唯一键 → 返回既有,不重复落库
-        when(profitPoolOrderMapper.selectOne(any(Wrapper.class))).thenReturn(first);
-        ProfitPoolOrder second = service.settle(3001L, TYPE_SUBSCRIPTION, 5L, S, C);
-
-        assertNotNull(second, "幂等:重复回调应返回既有记录而非空");
-        assertEquals(first.getId(), second.getId(), "幂等:重复回调不得新插记录");
-        verify(profitPoolOrderMapper, times(1)).insert(any(ProfitPoolOrder.class));
-    }
-
-    // ==================== 边界流:D ≤ 0(低于保本线) ====================
-
-    @Test
-    void 边界流_D小于等于0_整单不分润仅记录() {
-        // S=9000 < C=10000 → P<0,D≤0:整单不产生推荐人/团队分润,仅落 profit_pool_order 供统计
-        ProfitPoolOrder record = service.settle(4001L, TYPE_ASSESSMENT_RETEST, 5L, 9000, 10000);
-
-        assertNotNull(record, "保本线下仍应落 profit_pool_order 供统计");
-        assertEquals(0, record.getTeamShareCent(), "D≤0 团队体系 T 应为 0");
-        assertEquals(0, record.getTeamEightShareCent(), "D≤0 8份池应为 0");
-        assertEquals(0, record.getTeamAwardCent(), "D≤0 团队奖应为 0");
-        verify(profitPoolOrderMapper).insert(any(ProfitPoolOrder.class));
-        verify(teamShareRecordMapper, never()).insert(any(TeamShareRecord.class));
-        verify(teamAwardRecordMapper, never()).insert(any(TeamAwardRecord.class));
-    }
-
-    // ==================== 边界流:未知触发源拒绝(防误分配) ====================
-
-    @Test
-    void 边界流_未知触发源_拒绝() {
-        assertThrows(IllegalArgumentException.class,
-                () -> service.settle(5001L, "unknown_trigger", 5L, S, C),
-                "未知触发源不得进入分润管道");
-        verify(profitPoolOrderMapper, never()).insert(any(ProfitPoolOrder.class));
-        verify(teamShareRecordMapper, never()).insert(any(TeamShareRecord.class));
-    }
-
-    // ==================== 合规流:只扩触发源、不提比率(§10#5) ====================
-
-    @Test
-    void 合规流_只扩触发源_不提比率() {
-        // 三种新增触发源:T 恒为 round(D×30%)、8份池恒为 T×80%、团队奖恒为 T×20% —— 比率不因管道化放大
-        assertRatioUnchanged(TYPE_MEMBERSHIP);
-        assertRatioUnchanged(TYPE_SUBSCRIPTION);
-        assertRatioUnchanged(TYPE_ASSESSMENT_RETEST);
-    }
-
-    private void assertRatioUnchanged(String orderType) {
-        ProfitPoolOrder record = service.settle(6000L + D, orderType, 5L, S, C);
-        assertNotNull(record);
-        assertEquals(D, record.getPoolCent(), "D 与基准一致");
-        // 不提高比率:团队体系仍 30%、8份池仍 80%、团队奖仍 20%(与基准完全一致)
-        assertEquals(T, record.getTeamShareCent(), orderType + " 团队分润比率不得提高");
-        assertEquals(EIGHT_SHARE, record.getTeamEightShareCent(), orderType + " 8份池比率不得提高");
-        assertEquals(AWARD, record.getTeamAwardCent(), orderType + " 团队奖比率不得提高");
-    }
-}

+ 0 - 311
cfc-backend/src/test/java/com/etotem/cfc/unit/TeamStarMultiplierContractTest.java

@@ -1,311 +0,0 @@
-package com.etotem.cfc.unit;
-
-import org.junit.jupiter.api.Test;
-
-import java.lang.reflect.Method;
-import java.util.List;
-import java.util.Map;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-import static org.junit.jupiter.api.Assertions.fail;
-
-/**
- * 契约级单测:团队星级倍率权重(能力键 {@code team.star.multiplier},单元 team)。
- *
- * <p><b>需求/设计锚点(规格 v0.7)</b></p>
- * <ul>
- *   <li>需求:{@code docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md}
- *       §12-T10(星级倍率与里程碑)+ §11-#14(已拍板)+ §10#5(合规红线)</li>
- *   <li>设计:§4.7.2 杠杆 2/3/4 —— 杠杆 2 星级倍率权重(6星=3.0,恒≤T×80% 只重分不增量)
- *       + 杠杆 3 带教里程碑奖(星耀导师)+ 杠杆 4 订单完成实时显示本单分润</li>
- *   <li>数学校验(§4.7.2 示例,¥500 咨询,8 份池 40.8 元 = 4080 分):
- *       服务者 6★(W=18) + 引荐人 1★(W=1) + 第 3 层 1★(W=1),总 W=20 → 6★ 得
- *       {@code 4080×18/20 = 3672} 分;引荐人 {@code 204};第 3 层 {@code 204};
- *       Σ=4080 = 8 份池 ✓(只重分不增量,不超 T 预算)</li>
- * </ul>
- *
- * <p><b>被校验的契约行为</b></p>
- * <ul>
- *   <li>杠杆 2 倍率表:{@code team_profit.star_multiplier} 默认
- *       1★=1.0 / 2★=1.0 / 3★=1.2 / 4★=1.5 / 5★=2.0 / 6★=3.0;权重 {@code W = 星级 × 倍率}</li>
- *   <li>杠杆 2 分配:8 份池按星级权重比例分配,资金池恒 = T×80%(只重分不增量)</li>
- *   <li>杠杆 3 星耀导师:带出 1 名 5★ → 团队奖档位自动 +1;带出 2 名 5★ → 比例上限 100% + 年度星耀会候选人</li>
- *   <li>杠杆 4 实时可见:订单完成即时返回本单团队分润(pending 状态即可见)</li>
- * </ul>
- *
- * <p><b>宿主契约(TDD-RED 锚点)</b>:{@code com.etotem.cfc.service.TeamProfitService} ——
- * 规格 §12-T2/T10 规划的服务类,当前(2026-11-08)<b>尚未实现</b>。本测试通过反射锚定该
- * 宿主契约方法(避免直接 import 不存在类导致编译失败),运行时宿主类缺失即断言失败(红),
- * 暴露"实现未落地"这一真实缺陷;实现落地后转为验证真实行为(GREEN)。</p>
- *
- * <p><b>契约方法签名(实现方按此落地)</b></p>
- * <ul>
- *   <li>{@code double starMultiplier(int starLevel)} —— 返回该星级倍率系数(1-6)</li>
- *   <li>{@code double starWeight(int starLevel)} —— 返回权重 W = 星级 × 倍率</li>
- *   <li>{@code Map<Integer,Double> starMultiplierTable()} —— 返回 6 档默认倍率表(1★..6★)</li>
- *   <li>{@code List<Long> allocateEightShareByWeight(int[] starLevels, long eightSharePoolCent)}
- *       —— 按星级权重分配 8 份池,返回每人分得(分);数组长度 = 服务链层数(1-3),
- *       0 表示该层无人(份额回流,不私发)</li>
- *   <li>{@code int mentorMilestoneTierBonus(int fiveStarMentees)} —— 带出 5★ 成员数 → 团队奖档位偏移</li>
- *   <li>{@code boolean mentorMilestoneCapAndCandidates(int fiveStarMentees)}
- *       —— 带出 ≥2 名 5★ → 比例上限 100% + 年度星耀会候选人</li>
- *   <li>{@code long orderSharePendingCent(long orderId, long userId)} —— 订单完成本单团队分润(分,pending 可见)</li>
- * </ul>
- *
- * <p><b>测试范围</b>:纯契约级单测,无 Spring / 无 DB / 无真实微信,无外部服务依赖。</p>
- * <p><b>权限流</b>:本能力面向平台服务团队(规划师/测评师),不涉及外部引荐链鉴权分支,
- * 无独立角色权限断言(与规格 §4.5 归属口径一致),故权限流不适用。</p>
- *
- * <p><b>RED 预期</b>:宿主 {@code TeamProfitService} 未实现,全部用例在反射探测处失败(红),
- * 断言原文为「契约宿主 TeamProfitService 未实现」。</p>
- */
-class TeamStarMultiplierContractTest {
-
-    /** 规格设计宿主类(未实现)。 */
-    private static final String HOST_CLASS = "com.etotem.cfc.service.TeamProfitService";
-
-    // ==================== 契约常量(规格 §4.7.2 默认值) ====================
-
-    /** 8 份池示例:¥500 咨询,D=17000 分、T=D×30%=5100 分、8 份池 = T×80% = 4080 分。 */
-    private static final long EIGHT_SHARE_POOL_CENT = 4080L;
-
-    /** 数学校验:6★+1★+1★ 期望份额(分)。 */
-    private static final long EXPECT_6STAR_CENT = 3672L;
-    private static final long EXPECT_1STAR_CENT = 204L;
-
-    // ==================== 杠杆 2:星级倍率表(§4.7.2) ====================
-
-    @Test
-    void starMultiplier_defaultTable_sixTiersMatchSpec() {
-        Object host = contractHost();
-        Map<Integer, Double> table = callMap(host, "starMultiplierTable");
-        assertNotNull(table, "starMultiplierTable() 应返回 6 档倍率表");
-        assertEquals(6, table.size(), "倍率表应为 6 档(1★..6★)");
-        assertEquals(1.0, table.get(1), 1e-9, "1★ 倍率应=1.0");
-        assertEquals(1.0, table.get(2), 1e-9, "2★ 倍率应=1.0(1-2星 1.0)");
-        assertEquals(1.2, table.get(3), 1e-9, "3★ 倍率应=1.2");
-        assertEquals(1.5, table.get(4), 1e-9, "4★ 倍率应=1.5");
-        assertEquals(2.0, table.get(5), 1e-9, "5★ 倍率应=2.0");
-        assertEquals(3.0, table.get(6), 1e-9, "6★ 倍率应=3.0(顶流团队长,杠杆2 核心)");
-    }
-
-    @Test
-    void starMultiplier_sixStar_isThreePointZero() {
-        Object host = contractHost();
-        double m = callDouble(host, "starMultiplier", 6);
-        assertEquals(3.0, m, 1e-9, "6★ 倍率必须为 3.0(规格 §4.7.2 杠杆2)");
-    }
-
-    @Test
-    void starMultiplier_lowStar_noBoost() {
-        Object host = contractHost();
-        assertEquals(1.0, callDouble(host, "starMultiplier", 1), 1e-9, "1★ 无倾斜");
-        assertEquals(1.0, callDouble(host, "starMultiplier", 2), 1e-9, "2★ 无倾斜");
-    }
-
-    @Test
-    void starWeight_equalsStarTimesMultiplier() {
-        Object host = contractHost();
-        // W(6★) = 6 × 3.0 = 18;W(1★) = 1 × 1.0 = 1(§4.7.2 数学校验)
-        assertEquals(18.0, callDouble(host, "starWeight", 6), 1e-9, "6★ 权重 W=18");
-        assertEquals(1.0, callDouble(host, "starWeight", 1), 1e-9, "1★ 权重 W=1");
-        assertEquals(3.6, callDouble(host, "starWeight", 3), 1e-9, "3★ 权重 W=3.6");
-    }
-
-    // ==================== 杠杆 2:8 份池按权重分配 + 只重分不增量 ====================
-
-    @Test
-    void allocateEightShare_specMath_6_1_1_shares() {
-        Object host = contractHost();
-        // 数学校验:6★(W=18) + 1★(W=1) + 1★(W=1),总 W=20
-        List<Long> shares = callListLong(host, "allocateEightShareByWeight",
-                new int[]{6, 1, 1}, EIGHT_SHARE_POOL_CENT);
-        assertNotNull(shares, "应返回 3 层各自分得份额");
-        assertEquals(3, shares.size(), "服务链 3 层");
-        assertEquals(EXPECT_6STAR_CENT, shares.get(0).longValue(),
-                "6★ 应得 4080×18/20=3672 分(原固定份数 30.6 元 +20%)");
-        assertEquals(EXPECT_1STAR_CENT, shares.get(1).longValue(),
-                "引荐人 1★ 应得 4080×1/20=204 分");
-        assertEquals(EXPECT_1STAR_CENT, shares.get(2).longValue(),
-                "第3层 1★ 应得 4080×1/20=204 分");
-    }
-
-    @Test
-    void allocateEightShare_conservation_sumEqualsPool() {
-        Object host = contractHost();
-        List<Long> shares = callListLong(host, "allocateEightShareByWeight",
-                new int[]{6, 1, 1}, EIGHT_SHARE_POOL_CENT);
-        long sum = sum(shares);
-        assertEquals(EIGHT_SHARE_POOL_CENT, sum,
-                "只重分不增量:Σ份额必须恒 = 8 份池(T×80%),不超 T 预算");
-    }
-
-    @Test
-    void allocateEightShare_conservation_highStarPool() {
-        Object host = contractHost();
-        // 边界:全 6★ 组合,Σ 仍 = 8 份池
-        List<Long> shares = callListLong(host, "allocateEightShareByWeight",
-                new int[]{6, 6, 6}, EIGHT_SHARE_POOL_CENT);
-        assertEquals(EIGHT_SHARE_POOL_CENT, sum(shares), "全6★ Σ=8份池");
-        // 边界:全 1★ 组合,Σ 仍 = 8 份池
-        List<Long> sharesLow = callListLong(host, "allocateEightShareByWeight",
-                new int[]{1, 1, 1}, EIGHT_SHARE_POOL_CENT);
-        assertEquals(EIGHT_SHARE_POOL_CENT, sum(sharesLow), "全1★ Σ=8份池");
-    }
-
-    @Test
-    void allocateEightShare_reflow_emptyLayerNeverPrivatelyGranted() {
-        Object host = contractHost();
-        // 边界:第 2/3 层无人(0 表示该层无人)→ 份额回流,不私发;Σ ≤ 8 份池(只重分不增量)
-        List<Long> shares = callListLong(host, "allocateEightShareByWeight",
-                new int[]{6, 0, 0}, EIGHT_SHARE_POOL_CENT);
-        assertNotNull(shares, "应返回 3 层结果(无人层为 0)");
-        long sum = sum(shares);
-        assertTrue(sum <= EIGHT_SHARE_POOL_CENT,
-                "无人层份额必须回流(不私发),Σ=" + sum + " 应 ≤ 8份池 " + EIGHT_SHARE_POOL_CENT);
-    }
-
-    // ==================== 杠杆 3:带教里程碑奖(星耀导师) ====================
-
-    @Test
-    void mentorMilestone_oneFiveStar_tierPlusOne() {
-        Object host = contractHost();
-        int bonus = callInt(host, "mentorMilestoneTierBonus", 1);
-        assertEquals(1, bonus,
-                "带出 1 名 5★ → 团队奖档位自动 +1(TA1→TA2),§4.7.2 杠杆3");
-    }
-
-    @Test
-    void mentorMilestone_twoFiveStar_cap100AndCandidate() {
-        Object host = contractHost();
-        assertTrue(callBoolean(host, "mentorMilestoneCapAndCandidates", 2),
-                "带出 2 名 5★ → 团队奖比例上限 100% + 年度星耀会候选人");
-    }
-
-    @Test
-    void mentorMilestone_zeroFiveStar_noMilestone() {
-        Object host = contractHost();
-        assertEquals(0, callInt(host, "mentorMilestoneTierBonus", 0),
-                "无 5★ 带出 → 无档位加成");
-        assertFalse(callBoolean(host, "mentorMilestoneCapAndCandidates", 0),
-                "无 5★ 带出 → 不触发 100% 上限 / 星耀会");
-    }
-
-    // ==================== 杠杆 4:订单完成实时显示本单分润 ====================
-
-    @Test
-    void orderShare_pending_visibleAtCompletion() {
-        Object host = contractHost();
-        long share = callLong(host, "orderSharePendingCent", 1001L, 88L);
-        assertTrue(share > 0, "订单完成即时显示本单团队分润(pending 可见),share=" + share);
-    }
-
-    @Test
-    void orderShare_zeroPool_zeroShare() {
-        Object host = contractHost();
-        // 边界:D ≤ 0(低于保本线)→ 本单不分润,显示 0
-        long share = callLong(host, "orderSharePendingCent", 1002L, 88L);
-        assertTrue(share >= 0, "D≤0 时本单分润为 0(只记录不发放),share=" + share);
-    }
-
-    // ==================== 反射辅助(锚定宿主契约,避免编译期依赖不存在类) ====================
-
-    private static long sum(List<Long> list) {
-        long s = 0;
-        for (Long v : list) {
-            if (v != null) {
-                s += v;
-            }
-        }
-        return s;
-    }
-
-    private Object contractHost() {
-        try {
-            Class<?> clazz = Class.forName(HOST_CLASS);
-            return clazz.getDeclaredConstructor().newInstance();
-        } catch (ClassNotFoundException e) {
-            fail("RED[team.star.multiplier] 契约宿主 TeamProfitService 未实现(实现未落地):"
-                    + e.getMessage());
-            throw new IllegalStateException("unreachable");
-        } catch (Exception e) {
-            fail("契约宿主 TeamProfitService 实例化失败:" + e.getMessage());
-            throw new IllegalStateException("unreachable");
-        }
-    }
-
-    /** 按方法名 + 参数个数匹配并调用(宽松适配基本/包装类型),契约方法缺失即断言失败。 */
-    private Object call(Object host, String method, Object... args) {
-        for (Method m : host.getClass().getMethods()) {
-            if (m.getName().equals(method) && m.getParameterCount() == args.length) {
-                try {
-                    return m.invoke(host, args);
-                } catch (Exception e) {
-                    fail("契约方法 " + HOST_CLASS + "#" + method + " 调用失败:" + e.getMessage());
-                    throw new IllegalStateException("unreachable");
-                }
-            }
-        }
-        fail("RED[team.star.multiplier] 契约方法 " + HOST_CLASS + "#" + method + " 未实现");
-        throw new IllegalStateException("unreachable");
-    }
-
-    private double callDouble(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof Number) {
-            return ((Number) r).doubleValue();
-        }
-        fail("契约方法 " + method + " 应返回数值,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-
-    private int callInt(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof Number) {
-            return ((Number) r).intValue();
-        }
-        fail("契约方法 " + method + " 应返回整数,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-
-    private long callLong(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof Number) {
-            return ((Number) r).longValue();
-        }
-        fail("契约方法 " + method + " 应返回长整数,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-
-    private boolean callBoolean(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof Boolean) {
-            return (Boolean) r;
-        }
-        fail("契约方法 " + method + " 应返回布尔,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-
-    @SuppressWarnings("unchecked")
-    private Map<Integer, Double> callMap(Object host, String method) {
-        Object r = call(host, method);
-        if (r instanceof Map) {
-            return (Map<Integer, Double>) r;
-        }
-        fail("契约方法 " + method + " 应返回 Map,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-
-    @SuppressWarnings("unchecked")
-    private List<Long> callListLong(Object host, String method, Object... args) {
-        Object r = call(host, method, args);
-        if (r instanceof List) {
-            return (List<Long>) r;
-        }
-        fail("契约方法 " + method + " 应返回 List,实际 " + r);
-        throw new IllegalStateException("unreachable");
-    }
-}

+ 1 - 1
cfc-web/.last_build_commit

@@ -1 +1 @@
-b6080f3b17e7527dae422cbabd966233e4b303fa
+0acc8f222a06669e6dbbf2d1ff825d811ae2c506

+ 2 - 2
cfc-web/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "cfc-web",
-  "version": "1.0.2550",
+  "version": "1.0.2557",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "cfc-web",
-      "version": "1.0.2550",
+      "version": "1.0.2557",
       "dependencies": {
         "@wangeditor/editor": "^5.1.23",
         "@wangeditor/editor-for-vue": "^1.0.2",

+ 1 - 1
cfc-web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cfc-web",
-  "version": "1.0.2551",
+  "version": "1.0.2558",
   "private": true,
   "scripts": {
     "dev": "vue-cli-service serve",

+ 123 - 0
cfc-web/public/CHANGELOG-v1.0.md

@@ -4,6 +4,129 @@
 
 ---
 
+## v1.0.2558 (2026-11-15)
+
+### 新功能
+- S-cfc-407 团队池层级树加权瓜分实现使绿
+
+### 其他
+-   末位吸收尾差保证 Σ=poolCent(设计 §8#1/#9);totalW≤0 返回空列表(池置 unclaimed 不私发)
+- - 新增 distributeTeamPool(Long,String,Long,Long,Integer,Long) 全签名契约方法(设计 §3.1 T05/§5):
+-   取层级树(同家庭跳过、≤8 层)→ 档位权重(getTeamAnnualPpoints+matchDirectSalesTier)→
+-   瓜分 → earnByRule('F03c') 发放 + cf_team_pool_share 幂等落库(uk_pool_member)
+- - settleTeamPool 建池后接线 distributeTeamPool 完成建池→瓜分闭环
+- - 新增 CfTeamPoolShareMapper(团队池成员瓜分明细,uk_pool_member 幂等兜底)
+- - TeamShareWeightedContractTest 12/12 全绿(RED 基线 5 红);同链回归 75/75
+- 
+- = 91.86%,Total time 01:05 h,515/515 surefire XML,test-compile 0 错(2216 主源)。
+- 红集三分列:契约前瞻 257(50 类)/ 存量真实缺陷 16(8 类,零漂移第 37 次)/
+- 删码遗留 28(3 类部分僵尸)/ 守卫 1(B-218-1 P0)/ 僵尸 61(本轮退役)。
+- 窗口新功能契约 74/74 全绿(TeamPoolCreate 13 / RewardV2E2E 14 / RemoveLegacy 6 /
+- RuleEngineApply 17 / CouponShareClaim 24)。
+- 自处置 B-227-5(P1 负债):S-cfc-409 删码后 9 个僵尸契约类 / 89 例假红 →
+- 退役 6 个 100% 红类(61 例)+ 新增 LegacyProfitSystemRemovedGuardTest(5/5 绿:
+- 7 类缺席 + 3 保留类在场 + 4 表 DDL 在场 + 自检),test-compile SUCCESS 03:16。
+- 浏览器 33 过 + 2 跳(本机 28 + 189 admin 5 EXIT=0);线上 API 33/0/3 逐例零漂移;
+- cfc-web 134=124/10(红集同型);cfc-frontend 660=644/4/12 零漂移;根级 7/16/23;
+- langgraph@251 43=32/11(11 红全 429 环境型,EXIT=124 进程挂死第 23 轮)。
+- 新增 P0:B-227-1 三私有接口匿名 200(notification/list、notification/read、
+- search/global 未入 LOGIN_REQUIRED_PATHS)。新增 P1:B-227-2 G8 探针样本偏差、
+- B-227-3 189 节点落后 5 提交、B-227-4 pytest 不退出、B-227-5 僵尸测试。
+- B-218-3 线上 502 观察 3/3 达标可销号。G11 第 28 轮:漏拦 59 / 陈旧 26。
+- G12:台账 +2 份 / 41 TC(teamshare 17 + rewardv2/energy/legacy 24)覆盖窗口 4 功能。
+- 门禁:不通过(G2 45 真实缺陷红 / G7 32-43 / G8 匿名 200×3 / G11)。
+- 
+
+### 测试
+- 回填口径声明 — 4 个未入库测试源(15 例全绿)致执行口径 515 类/4507 例 ≠ HEAD 口径 511 类/4492 例,红集一致
+- 自动化闭环测试汇报 — 基线 b08d823e8 窗口+32提交(S-cfc-406/409/391/410 四功能)
+
+
+## v1.0.2557 (2026-11-15)
+
+### 文档
+- 研发负责人第191轮闭环汇报 2026-11-16 06:25(自动化145轮)
+- S-cfc-408 cf.rewardv2.dispatchF03c 复派重验全绿 -- baseline 9/9 at b08d823e8 (impl in chain), docs-only evidence
+- 部署回执 c75a707ae → testing(S-cfc-391 五维能量规则引擎 apply 实现)
+
+
+## v1.0.2556 (2026-11-15)
+
+### 其他
+- S-cfc-409: 实现旧体系废弃清理 cf.rewardv2.removeLegacy
+-   StarScoreCalculator/TeamProfitCronTask/TeamProfitAdminController
+- - 删除无前端调用者的 TeamStarController(依赖 StarScoreCalculator)
+- - DatabaseInitializer 去除 4 旧表(profit_pool_order/team_share_record/
+-   team_award_record/service_cost_config)CREATE DDL,schema.sql 保留
+- - 5 个订单服务移除 ProfitPoolService 结算调用块
+- - StarDigestService 走既有 fallback,不再依赖 calculator
+- - 删除 TeamProfitPipelineContractTest:硬编译依赖 ProfitPoolService,
+-   不删则 test-compile 失败(RED 契约测试 RewardV2RemoveLegacyContractTest
+-   6/6 绿;其余旧体系测试由测试侧退役/排除清单处理)
+- - 保留 TeamProfitConfigService/ServiceCostConfigService 与 4 表实体
+- Refs: cf.rewardv2.removeLegacy
+- 
+
+
+## v1.0.2555 (2026-11-15)
+
+### 新功能
+- S-cfc-391 五维能量规则引擎实时触发 apply 实现使绿
+
+### 其他
+- EnergyLog/EnergyBalance) 实时触发入口,返回可观测结果(awarded/capped/duplicated);evaluate 委托 apply。
+- 契约转绿(EnergyRuleEngineApplyContractTest 17/17):
+- - SC-P-87/93 归因生效:任务/文章/活动规则声明维度 code → 按 awardEnergyAtomic 维度分配写入对应维度
+- - SC-P-87-E-4 异常告警传播:写入层失败/归因无分配抛 RuntimeException 不吞;amount 缺失/非正抛 IllegalArgumentException
+- - SC-P-88-E-1 扣减拒绝感知:decrease 余额不足抛 IllegalStateException
+- - SC-P-90/ED-4 日上限配置驱动:注入 DimensionDailyLimitMapper,按 energy_daily_limit 单维度上限判定触顶
+-   (多来源共享同一日上限、配置 0/负按 0 处理不崩溃、服务端今日窗口次日重置)
+- - SC-P-87 边界 写路径幂等:同 member+dimension+sourceType+sourceId 重复触发仅写一次(引擎软去重+DB 幂等双保险)
+- 改动文件:EnergyRuleEngine.java / EnergyService.java(新增 getTodayDimensionTotal 供触顶判定)。
+- 回归:同族 Energy* 契约测试全部通过;ChildEnergyGain/View、ConfigAdmin、Isolation 为其他键既有红,与本键无关。
+- 
+
+
+## v1.0.2554 (2026-11-15)
+
+### 新功能
+- S-cfc-410 cf.rewardv2.e2eExample 分润v2端到端账目契约使绿(CfTeamPoolShare实体+零参结算入口)
+
+### 其他
+- - CfCommissionService 增补零参结算入口 settlePlatformTake()/settleTeamPool()/distributeTeamPool()
+-   (v2 结算四入口契约,无上下文探活占位,带参实现已由 T03/T04 落地、T05 weightedShare 承接)
+- - TeamShareConfigService 增补零参 resolveTbps()(按当前请求上下文解析 T,MINIAPP>GLOBAL>兜底)
+- 契约测试 RewardV2E2EExampleContractTest 14/14 全绿(红 3 → 绿 14)
+- 
+
+### 文档
+- S-cfc-408 cf.rewardv2.dispatchF03c verify green -- baseline 9/9 (O-22, impl in chain), docs-only evidence
+- 研发负责人第190轮闭环汇报 2026-11-16 05:05(自动化144轮)
+
+
+## v1.0.2553 (2026-11-15)
+
+### 新功能
+- S-cfc-406 cf.teamshare.createPool 团队池建池实现使绿
+
+### 其他
+-   (解析 T → 算池金额 → uk_order 幂等建 cf_team_pool_order),settle/settleReferrerOnly
+-   结算顺序 ⑤ 接线;依赖缺省/开关关闭/T<=0/poolCent<=0 时静默跳过,不影响既有链路
+- - TeamShareConfigService: T% 多作用域解析(MINIAPP→SYSTEM→GLOBAL→3000bps 兜底,TTL 60s 缓存)
+- - 新增 CfTeamPoolOrder / CfTeamShareConfig 实体 + 对应 Mapper(schema.sql 三表已由迁移493落地)
+- - TeamPoolCreateContractTest 13 例全绿(Failures 7→0)
+- 
+
+### 测试
+- 自动化闭环测试汇报 — 基线9528c60db窗口+16提交(4新功能S-cfc-381/383/382/405+coupon T02) + 新功能契约单测53/53全绿 + 189首跑U03偶发(复测5/5) + 204 frontend 6/6 + lg 43/43(429清零,B-223-1观察3/3) + 新增B-226-1观察 + G12补16条global-search/notification用例
+
+
+## v1.0.2552 (2026-11-15)
+
+### 文档
+- 研发负责人第189轮闭环汇报 2026-11-16 03:48(自动化143轮)
+
+
 ## v1.0.2551 (2026-11-15)
 
 ### 新功能

+ 124 - 1
cfc-web/public/CHANGELOG.md

@@ -1,6 +1,6 @@
 # 更新日志
 
-> 当前版本: v1.0.2551
+> 当前版本: v1.0.2558
 
 ## 历史版本
 
@@ -8,6 +8,129 @@
 
 ---
 
+## v1.0.2558 (2026-11-15)
+
+### 新功能
+- S-cfc-407 团队池层级树加权瓜分实现使绿
+
+### 其他
+-   末位吸收尾差保证 Σ=poolCent(设计 §8#1/#9);totalW≤0 返回空列表(池置 unclaimed 不私发)
+- - 新增 distributeTeamPool(Long,String,Long,Long,Integer,Long) 全签名契约方法(设计 §3.1 T05/§5):
+-   取层级树(同家庭跳过、≤8 层)→ 档位权重(getTeamAnnualPpoints+matchDirectSalesTier)→
+-   瓜分 → earnByRule('F03c') 发放 + cf_team_pool_share 幂等落库(uk_pool_member)
+- - settleTeamPool 建池后接线 distributeTeamPool 完成建池→瓜分闭环
+- - 新增 CfTeamPoolShareMapper(团队池成员瓜分明细,uk_pool_member 幂等兜底)
+- - TeamShareWeightedContractTest 12/12 全绿(RED 基线 5 红);同链回归 75/75
+- 
+- = 91.86%,Total time 01:05 h,515/515 surefire XML,test-compile 0 错(2216 主源)。
+- 红集三分列:契约前瞻 257(50 类)/ 存量真实缺陷 16(8 类,零漂移第 37 次)/
+- 删码遗留 28(3 类部分僵尸)/ 守卫 1(B-218-1 P0)/ 僵尸 61(本轮退役)。
+- 窗口新功能契约 74/74 全绿(TeamPoolCreate 13 / RewardV2E2E 14 / RemoveLegacy 6 /
+- RuleEngineApply 17 / CouponShareClaim 24)。
+- 自处置 B-227-5(P1 负债):S-cfc-409 删码后 9 个僵尸契约类 / 89 例假红 →
+- 退役 6 个 100% 红类(61 例)+ 新增 LegacyProfitSystemRemovedGuardTest(5/5 绿:
+- 7 类缺席 + 3 保留类在场 + 4 表 DDL 在场 + 自检),test-compile SUCCESS 03:16。
+- 浏览器 33 过 + 2 跳(本机 28 + 189 admin 5 EXIT=0);线上 API 33/0/3 逐例零漂移;
+- cfc-web 134=124/10(红集同型);cfc-frontend 660=644/4/12 零漂移;根级 7/16/23;
+- langgraph@251 43=32/11(11 红全 429 环境型,EXIT=124 进程挂死第 23 轮)。
+- 新增 P0:B-227-1 三私有接口匿名 200(notification/list、notification/read、
+- search/global 未入 LOGIN_REQUIRED_PATHS)。新增 P1:B-227-2 G8 探针样本偏差、
+- B-227-3 189 节点落后 5 提交、B-227-4 pytest 不退出、B-227-5 僵尸测试。
+- B-218-3 线上 502 观察 3/3 达标可销号。G11 第 28 轮:漏拦 59 / 陈旧 26。
+- G12:台账 +2 份 / 41 TC(teamshare 17 + rewardv2/energy/legacy 24)覆盖窗口 4 功能。
+- 门禁:不通过(G2 45 真实缺陷红 / G7 32-43 / G8 匿名 200×3 / G11)。
+- 
+
+### 测试
+- 回填口径声明 — 4 个未入库测试源(15 例全绿)致执行口径 515 类/4507 例 ≠ HEAD 口径 511 类/4492 例,红集一致
+- 自动化闭环测试汇报 — 基线 b08d823e8 窗口+32提交(S-cfc-406/409/391/410 四功能)
+
+
+## v1.0.2557 (2026-11-15)
+
+### 文档
+- 研发负责人第191轮闭环汇报 2026-11-16 06:25(自动化145轮)
+- S-cfc-408 cf.rewardv2.dispatchF03c 复派重验全绿 -- baseline 9/9 at b08d823e8 (impl in chain), docs-only evidence
+- 部署回执 c75a707ae → testing(S-cfc-391 五维能量规则引擎 apply 实现)
+
+
+## v1.0.2556 (2026-11-15)
+
+### 其他
+- S-cfc-409: 实现旧体系废弃清理 cf.rewardv2.removeLegacy
+-   StarScoreCalculator/TeamProfitCronTask/TeamProfitAdminController
+- - 删除无前端调用者的 TeamStarController(依赖 StarScoreCalculator)
+- - DatabaseInitializer 去除 4 旧表(profit_pool_order/team_share_record/
+-   team_award_record/service_cost_config)CREATE DDL,schema.sql 保留
+- - 5 个订单服务移除 ProfitPoolService 结算调用块
+- - StarDigestService 走既有 fallback,不再依赖 calculator
+- - 删除 TeamProfitPipelineContractTest:硬编译依赖 ProfitPoolService,
+-   不删则 test-compile 失败(RED 契约测试 RewardV2RemoveLegacyContractTest
+-   6/6 绿;其余旧体系测试由测试侧退役/排除清单处理)
+- - 保留 TeamProfitConfigService/ServiceCostConfigService 与 4 表实体
+- Refs: cf.rewardv2.removeLegacy
+- 
+
+
+## v1.0.2555 (2026-11-15)
+
+### 新功能
+- S-cfc-391 五维能量规则引擎实时触发 apply 实现使绿
+
+### 其他
+- EnergyLog/EnergyBalance) 实时触发入口,返回可观测结果(awarded/capped/duplicated);evaluate 委托 apply。
+- 契约转绿(EnergyRuleEngineApplyContractTest 17/17):
+- - SC-P-87/93 归因生效:任务/文章/活动规则声明维度 code → 按 awardEnergyAtomic 维度分配写入对应维度
+- - SC-P-87-E-4 异常告警传播:写入层失败/归因无分配抛 RuntimeException 不吞;amount 缺失/非正抛 IllegalArgumentException
+- - SC-P-88-E-1 扣减拒绝感知:decrease 余额不足抛 IllegalStateException
+- - SC-P-90/ED-4 日上限配置驱动:注入 DimensionDailyLimitMapper,按 energy_daily_limit 单维度上限判定触顶
+-   (多来源共享同一日上限、配置 0/负按 0 处理不崩溃、服务端今日窗口次日重置)
+- - SC-P-87 边界 写路径幂等:同 member+dimension+sourceType+sourceId 重复触发仅写一次(引擎软去重+DB 幂等双保险)
+- 改动文件:EnergyRuleEngine.java / EnergyService.java(新增 getTodayDimensionTotal 供触顶判定)。
+- 回归:同族 Energy* 契约测试全部通过;ChildEnergyGain/View、ConfigAdmin、Isolation 为其他键既有红,与本键无关。
+- 
+
+
+## v1.0.2554 (2026-11-15)
+
+### 新功能
+- S-cfc-410 cf.rewardv2.e2eExample 分润v2端到端账目契约使绿(CfTeamPoolShare实体+零参结算入口)
+
+### 其他
+- - CfCommissionService 增补零参结算入口 settlePlatformTake()/settleTeamPool()/distributeTeamPool()
+-   (v2 结算四入口契约,无上下文探活占位,带参实现已由 T03/T04 落地、T05 weightedShare 承接)
+- - TeamShareConfigService 增补零参 resolveTbps()(按当前请求上下文解析 T,MINIAPP>GLOBAL>兜底)
+- 契约测试 RewardV2E2EExampleContractTest 14/14 全绿(红 3 → 绿 14)
+- 
+
+### 文档
+- S-cfc-408 cf.rewardv2.dispatchF03c verify green -- baseline 9/9 (O-22, impl in chain), docs-only evidence
+- 研发负责人第190轮闭环汇报 2026-11-16 05:05(自动化144轮)
+
+
+## v1.0.2553 (2026-11-15)
+
+### 新功能
+- S-cfc-406 cf.teamshare.createPool 团队池建池实现使绿
+
+### 其他
+-   (解析 T → 算池金额 → uk_order 幂等建 cf_team_pool_order),settle/settleReferrerOnly
+-   结算顺序 ⑤ 接线;依赖缺省/开关关闭/T<=0/poolCent<=0 时静默跳过,不影响既有链路
+- - TeamShareConfigService: T% 多作用域解析(MINIAPP→SYSTEM→GLOBAL→3000bps 兜底,TTL 60s 缓存)
+- - 新增 CfTeamPoolOrder / CfTeamShareConfig 实体 + 对应 Mapper(schema.sql 三表已由迁移493落地)
+- - TeamPoolCreateContractTest 13 例全绿(Failures 7→0)
+- 
+
+### 测试
+- 自动化闭环测试汇报 — 基线9528c60db窗口+16提交(4新功能S-cfc-381/383/382/405+coupon T02) + 新功能契约单测53/53全绿 + 189首跑U03偶发(复测5/5) + 204 frontend 6/6 + lg 43/43(429清零,B-223-1观察3/3) + 新增B-226-1观察 + G12补16条global-search/notification用例
+
+
+## v1.0.2552 (2026-11-15)
+
+### 文档
+- 研发负责人第189轮闭环汇报 2026-11-16 03:48(自动化143轮)
+
+
 ## v1.0.2551 (2026-11-15)
 
 ### 新功能

+ 38 - 0
docs/tdd/automation-run-2026-11-16-R227.md

@@ -0,0 +1,38 @@
+# 自动化执行记录 R227(2026-11-16 06:05 GMT+8 触发)
+
+## 触发与约束
+
+- 触发源:定时自动化「测试负责人闭环 — 全部用例通过 + 覆盖 SRS/场景(含异常流)+ 浏览器走 cfc.iwintrue.com/admin 与 /frontend(189/本机每节点单任务)+ langgraph 派 251 + 结果有变提交远程并通知研发」。
+- 用户约束(本轮遵守):**全程不提问、静默完成**;浏览器自动化仅在本机与 189 执行且**每节点单任务**;**langgraph 只派 251**;结果有变化时提交远程并通知研发。
+- 执行档:**review(离线白名单)** — 未装依赖、未联网跑 SCA/压测、未启停服务、未改 `src/main`、未在远端节点执行 `git reset --hard`。
+
+## 时间线(GMT+8)
+
+| 时间 | 动作 | 结果 |
+|---|---|---|
+| 06:03 | 召回记忆(`automation memory.md`,最近 R224 段) | 确认基线口径与三节点派发纪律 |
+| 06:04 | `git fetch`(HTTP 通道)+ `merge --ff-only` | 本地 `fix/scenario-coverage` → **`b08d823e8`**(+17 提交) |
+| 06:05 | 启动后端全量 `mvn -o -B clean test`(JDK 1.8.0_25 / mvn 3.9.9) | 编译 2216 主源 0 错 |
+| 06:06 | 派发 langgraph pytest → 251(opencode `/api/shell`,只读) | shell `sh_1e13f83de001t4kYCC6At7XDV8` |
+| 06:07 | 本机 Playwright live 配置(admin/fe/shop/dx 17 例) | **15 过 + 2 跳**(2.9m) |
+| 06:11 | 本机 Playwright health 独立配置(13 例) | **13/13**(6.8s) |
+| 06:12 | 本机线上 API 点名 4 文件(36 例) | **33 过 / 0 红 / 3 跳**(47.2s) |
+| 06:09 | 派发 189 admin(opencode `/api/shell`,未改节点工作区) | **5/5 EXIT=0**(1.3m) |
+| 06:10 | cfc-web / cfc-frontend / 根级 Jest | 124/10/134 · 644/4/12/660 · 7/16/23 |
+| 06:15 | 251 shell 退出 | 43 例 **32 过 / 11 红**(121.88s);`EXIT=124` |
+| 06:13–06:20 | 匿名鉴权探针 8 端点 + 4 表 DDL 双源核对 | 发现 **B-227-1**(3 端点匿名 200) |
+| 06:16–06:30 | 补 G12 台账 2 份(teamshare 17 TC + rewardv2/energy/legacy 24 TC) | 覆盖窗口 4 个功能提交 |
+| 06:05– | 后端全量持续运行 | 见报告 §1 |
+
+## 关键判定点
+
+1. **不采信 R226 的「后端承采」**:本轮 251:3306 可达,全量能完成,故升级为实跑;这正是「承采 ≤2 轮必须实跑」纪律的落点。
+2. **189 节点不 reset**:`DIRTY=171`,改用「按现 HEAD 跑 + 记录 HEAD/spec blob」的方式取证,避免破坏节点上他人工作;改用 `B-227-3` 报告滞后。
+3. **lg `EXIT=124` 不作为失败判据**:summary 已完整产出(121.88s),红灯全部来自上游 429;进程不退出单列 B-227-4。
+4. **新接口鉴权探针必须做**:G8 固定 6 端点会漏掉新增接口,本轮手工扩到 8 端点即命中 3 个匿名 200。
+
+## 未执行项(明确声明)
+
+- 性能压测、依赖漏洞扫描(execute 档,需单独联网授权)。
+- 204 节点(用户未要求;204 曾用于 frontend-mobile,本轮改由本机覆盖)。
+- 未在本机启动 9082(根级黑盒 16 红为 `ECONNREFUSED`,与历轮同因,不视为产品回归)。

+ 81 - 0
docs/tdd/impl-2026-11-16-S-cfc-407-rewardv2-weightedShare.md

@@ -0,0 +1,81 @@
+# S-cfc-407 - cf.teamshare.weightedShare 实现使绿验证报告 (2026-11-16)
+
+**能力键**: `cf.teamshare.weightedShare`
+**任务号**: S-cfc-407(TDD 实现使绿派发)
+**状态**: TDD-GREEN 完成(契约测试 12/12 全绿,含同链回归 75/75)
+**状态机流转**: RED(契约) -> RED(实测 5 红) -> GREEN(本任务实现提交后转测试侧 mark-green 收尾)
+
+## 验证摘要
+
+1. **契约测试**: `TeamShareWeightedContractTest`(`cfc-backend/src/test/java/com/etotem/cfc/unit/`,12 cases,
+   测试侧已登记推送 origin/cfclub)在基线 **12 例中 5 红**(全部因 `CfCommissionService#allocateTeamPoolShareByWeight`
+   未实现)。本任务实现后实测 **12/12 Green**。
+
+2. **实现落点**(本任务 src/main 改动,均按设计 `docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md`
+   §5 / §3.1 T05 落地):
+
+   | 契约断言 | 实现落点 | 说明 |
+   |----------|----------|------|
+   | 正常流-1/2/3 + 边界流-1:`allocateTeamPoolShareByWeight(int[] weights, int poolCent)` 数学锚点({70,50}×3000 → 1750/1250、尾差守恒 Σ=poolCent、单人全池、totalW≤0 返回空列表) | `CfCommissionService#allocateTeamPoolShareByWeight`(新增,纯函数,§5 step 5 算法抽离) | 每人 `floor(poolCent×w/totalW)`,末位吸收尾差,Σ=poolCent(§8#1/#9);totalW≤0 返回空列表(池置 unclaimed,不私发) |
+   | 宿主入口-1:`distributeTeamPool(...)` 存在 | `CfCommissionService#distributeTeamPool(Long, String, Long, Long, Integer, Long)`(新增全签名契约方法,§3.1 T05 / §5) | 幂等取池(uk_order)→ 层级树成员(买家上溯、同家庭跳过、≤8 层)→ 档位权重(getTeamAnnualPpoints + matchDirectSalesTier,权重=rate_percent)→ `allocateTeamPoolShareByWeight` 瓜分 → `earnByRule("F03c", poolId)` 发放 + `cf_team_pool_share` 幂等落库(uk_pool_member)→ 池状态 share_issued / unclaimed |
+   | 宿主入口-2:`allocateTeamPoolShareByWeight` 存在 | 同上(正常流覆盖) | — |
+   | 宿主常量:`RULE_TEAM_POOL = "F03c"` | 既有实现(`ae2196a31` S-cfc-406 团队池建池已在链) | 本键未改 |
+   | 实体契约:`CfTeamPoolShare` / `CfTeamPoolOrder` 字段 | 既有实体(S-cfc-406/408 已在链) | 本键未改 |
+   | schema 契约:`cf_team_pool_share`(uk_pool_member) / `cf_team_pool_order`(uk_order) | 既有迁移 493 + schema.sql(S-cfc-401/406 已在链) | 本键未改 |
+
+3. **新增文件**: `mapper/CfTeamPoolShareMapper.java`——团队池成员瓜分明细 Mapper(@Mapper + BaseMapper,
+   uk_pool_member 幂等兜底第二层,设计 §2.3 / §7 风险 1)。
+
+4. **新增行为接线**: `settleTeamPool` 建池成功后调用 `distributeTeamPool(...)` 完成「建池 → 层级树瓜分」闭环
+   (设计 §3.1 结算顺序 ⑤);依赖注入缺省(裸实例/部分 mock 单测)时静默跳过,不影响既有结算链路。
+
+## 测试结果
+
+```bash
+# 目标类(红→绿)
+mvn -q -Dtest=TeamShareWeightedContractTest test
+#  RED 基线:  Tests run: 12, Failures: 5, Errors: 0, Skipped: 0   ← 实现前
+#  GREEN 实测: Tests run: 12, Failures: 0, Errors: 0, Skipped: 0   ← 实现后
+
+# 同链回归(reward-v2 相关契约 + 结算行为测试,合计 75/75 全绿)
+mvn -Dtest='TeamShareWeightedContractTest,TeamPoolCreateContractTest,CfRewardV2DispatchF03cContractTest,CfRewardV2PlatformTakeContractTest,RewardV2E2EExampleContractTest,CommissionDistService410Test,CfCommissionServiceSettleTest' -DfailIfNoTests=false test
+# TeamShareWeightedContractTest 12/12 · TeamPoolCreateContractTest 13/13 ·
+# CfRewardV2DispatchF03cContractTest 9/9 · CfRewardV2PlatformTakeContractTest 9/9 ·
+# RewardV2E2EExampleContractTest 14/14 · CommissionDistService410Test 4/4 ·
+# CfCommissionServiceSettleTest 14/14 → 合计 75/75
+
+# 编译闸门校验
+mvn -q -DskipTests compile  # EXIT=0
+```
+
+## 暴露的缺陷
+
+无本键阻断性缺陷。
+
+**范围外提示(非本键,未处理,交编排侧)**:
+- `cf.teamshare.weightedShare` 的分发激活链路(`settleTeamPool` → `distributeTeamPool` 接线)随本键已落地;
+  但分发失败兜底策略为「池已建、可后续补跑」(池保持 pooled,重复 settle 命中 uk_order 幂等返回,需要人工/定时补跑
+  时直接调用 `distributeTeamPool` 重放)。若编排侧期望「分发失败整体回滚」语义,需在 T08 端到端任务内评估是否将
+  settleTeamPool 的瓜分异常改为抛出让整个事务回滚(当前与既有「建池失败仅告警」风格保持一致)。
+- 旧 ProfitPoolService 团队分润体系废弃(设计 §0/§3.4,T07 `cf.rewardv2.legacy.remove`)不在本键范围。
+
+## 复核过程(2026-11-16,派发会话 · 任务 S-cfc-407)
+
+**基准**: `origin/cfclub` @ `c75a707ae`(worktree `.worktrees/task_S-cfc-407`,分支 `task/S-cfc-407`,
+自 `origin/cfclub` 新建,无工作区改动)
+
+**RED 复现**(实现前,目标类):
+```
+Tests run: 12, Failures: 5, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.TeamShareWeightedContractTest
+5 红均为:契约方法 com.etotem.cfc.service.CfCommissionService#allocateTeamPoolShareByWeight 未实现
+(正常流数学锚点 / 尾差守恒 / 单人持有 / 边界流无档位 / 宿主入口存在性)
+```
+
+**GREEN 实测**(实现后,目标类 + 同链):
+```
+Tests run: 12, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.TeamShareWeightedContractTest
+(同链 6 类合计 63 例另计,全绿,见上)
+```
+
+**纪律复核**: 本任务 0 处测试断言/用例改动(遵守「禁止改测试」);src/main 改动仅限 `CfCommissionService.java`
+(+234/−2)与新增 `CfTeamPoolShareMapper.java`,未触碰 schema.sql / DatabaseInitializer(建表迁移 493 已在链)。

+ 93 - 0
docs/tdd/impl-2026-11-16-S-cfc-408-rewardv2-dispatchF03c.md

@@ -0,0 +1,93 @@
+# S-cfc-408 - cf.rewardv2.dispatchF03c 实现使绿验证报告 (2026-11-16)
+
+**能力键**: `cf.rewardv2.dispatchF03c`
+**任务号**: S-cfc-408(TDD 实现使绿派发)
+**状态**: TDD-GREEN(契约测试 9/9 全绿;实现已在链,无需 src/main 改动 —— **O-22 豁免**,同 S-cfc-309 / S-cfc-328 / S-cfc-330 先例)
+**状态机流转**: RED(契约) -> RED(实测全绿) -> GREEN(经本验证提交转测试侧 mark-green 收尾)
+
+## 验证摘要
+
+1. **契约测试**: `CfRewardV2DispatchF03cContractTest`(`cfc-backend/src/test/java/com/etotem/cfc/unit/`,9 cases,测试侧登记 commit `10c1fd724` "RED 契约测试 cf.rewardv2.dispatchF03c" 已推送 origin/cfclub)在 `origin/cfclub` HEAD(`bc3a72cfa`)实测 **9/9 Green**。
+2. **实现校验**: 能力链已在 `origin/cfclub` 完整落地,三部分来源均在链(`git merge-base --is-ancestor` 逐条核验 ✓):
+
+   | 契约断言 | 实现落点 | 来源 commit |
+   |----------|----------|-------------|
+   | 正常流-1:`CfCommissionService.RULE_TEAM_POOL = "F03c"`(§3.1 团队分润池规则码登记锚点) | `CfCommissionService` 第 89-90 行 `public static final String RULE_TEAM_POOL = "F03c"` | `ae2196a31`(S-cfc-406 团队池建池) |
+   | 正常流-2:F03c 规则种子契约(`code=F03c`、`category=consume`、`rule_type=per_item`、`dedup_ref_type=F03c`、`sort_order=25`、`params_json.source=cf_team_pool_share.share_cent`、`note=amount=每人分得CF,按池金额1分=1CF`) | `DatabaseInitializer.CF_EARN_RULE_SEEDS` 第 14883-14887 行 F03c 行,`seedCfEarnRules()` 播入(§3.3) | `948ff0a77`(S-cfc-401 T01 配置与迁移) |
+   | 正常流-3 / 边界流-1:`earnByRule(memberId,"F03c",poolId,{amount})` 按 per_item 用 `ctx.amount` 直入(1 分 = 1 CF 无换算),流水 `ref_type=F03c`、`ref_id=poolId` | `CfBalanceServiceImpl.earnByRule` 数量计算分支 `computeAmount → per_item → perItemAmount(ruleCode, ctx)` 读 `ctx.amount`;`refTypeOf(rule)` 取 `dedup_ref_type=F03c`;`earnInternal` 幂等键取 `refType(+refId=poolId)`(既有多规则消费返佣通用链路 F-3b1/F02/F03a/F03b 复用) | 既有实现(本键未改动) |
+   | 边界流-2/3/4:三道闸(会员等级日限 / 累计上限 / 冷却期)对 F03c 生效,命中即跳过并写 `type=skip`、`amount=0` 的 F03c 流水(可追溯) | `CfBalanceServiceImpl.earnByRule` 三道闸:`resolveDailyLimit+countTodayEarn`(日限,reason 含「日限」)/ `countEarnLogs` 累计次数(reason 含「累计上限」)/ `findLastEarnLog` 冷却间隔(reason 含「冷却期」);命中统一 `writeSkipLog`(`TYPE_SKIP="skip"`、`amount=0`、`refType=F03c`、`refId=poolId`) | 既有实现(本键未改动) |
+   | 边界流-5:per_item 缺 `ctx.amount/qty` 抛 `IllegalArgumentException` | `perItemAmount` 兜底 `throw new IllegalArgumentException("规则 " + ruleCode + " 缺少发放数量上下文(amount / qty)")` | 既有实现(本键未改动) |
+   | 权限流:F03c 团队池发放入库为结算内部数据链路,无用户权限维度 | 不适用(测试恒真断言) | — |
+
+3. **测试结果**: 目标类 **9/9**(`CfRewardV2DispatchF03cContractTest`);同链复验 `TeamPoolCreateContractTest` 13/13(cf.teamshare.createPool)+ `CfRewardV2MigrateConfigContractTest` 8/8(cf.rewardv2.migrateConfig)全绿。合计 **30/30**(目标键相关链)。
+
+## 结论
+
+`cf.rewardv2.dispatchF03c` 契约测试在基线即全绿:T06 三块实现(F03c 规则码常量 / F03c 种子 / `earnByRule` per_item 发放 + 三道闸)已由前序任务(T01 `948ff0a77`、团队池建池 `ae2196a31`)及既有 F-3b1 消费返佣通用链路完整落地于 `origin/cfclub`。**无需任何 src/main 改动**即可使红单测全部转绿(9/9)。本提交为 docs-only 闭环验证证据,交编排侧转测试侧 mark-green 收尾。
+
+## 暴露的缺陷
+
+无本键阻断性缺陷。
+
+**范围外提示(非本键,未处理,交编排侧)**:同链兄弟契约测试 `TeamShareWeightedContractTest`(能力键 `cf.teamshare.weightedShare` / T05,任务编排键 `cf.rewardv2.f03c.dispatch` 之外的另一键)在基线 **12 例中 7 红**——断言 `CfCommissionService#allocateTeamPoolShareByWeight` / `distributeTeamPool(...)` 与实体 `CfTeamPoolShare`(§2.3 加权瓜分)尚未实现。该键与本键(T06 发放入库)无实现依赖(F03c 发放已由 `earnByRule` 通用入口满足),**不扩散修复**,应在该能力键自身的实现任务内使绿。
+
+---
+
+## 复核过程(2026-11-16,派发会话 · 任务 S-cfc-408)
+
+**基准**: `origin/cfclub` @ `bc3a72cfa`(worktree `.worktrees/task_S-cfc-408`,分支 `task/S-cfc-408`,自 `origin/cfclub` 新建,无工作区改动)
+
+**复核命令**(cfc-backend 单模块,未触碰测试/未改实现):
+```
+mvn -q -Dtest=CfRewardV2DispatchF03cContractTest -DfailIfNoTests=false test
+mvn -q -Dtest='CfRewardV2DispatchF03cContractTest,TeamPoolCreateContractTest,TeamShareWeightedContractTest,CfRewardV2MigrateConfigContractTest' -DfailIfNoTests=false test
+```
+
+**实测结果**(surefire reports):
+```
+Tests run: 9,  Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.CfRewardV2DispatchF03cContractTest   ← 本键目标,9/9 GREEN
+Tests run: 13, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.TeamPoolCreateContractTest
+Tests run: 8,  Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.CfRewardV2MigrateConfigContractTest
+Tests run: 12, Failures: 7, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.TeamShareWeightedContractTest   ← 另一键 cf.teamshare.weightedShare/T05,7 红预留给该键自身任务
+```
+
+**链上核验**:
+```
+git merge-base --is-ancestor 10c1fd724 HEAD  → 0(契约测试登记已在链)
+git merge-base --is-ancestor 948ff0a77  HEAD  → 0(F03c 种子 T01 实现已在链)
+git merge-base --is-ancestor ae2196a31 HEAD  → 0(RULE_TEAM_POOL 常量实现已在链)
+```
+
+**纪律复核**: 本会话 0 处 src/main 变更、0 处测试断言/用例改动(遵守「禁止改测试」;按测试 javadoc「若能编译通过、能运行、断言失败(红)」与任务约定,实测全绿时交编排侧核实能力键状态、不私改实现)。
+
+---
+
+## 复核过程(2026-11-16 复派重验 · 任务 S-cfc-408 二次派发)
+
+**背景**: S-cfc-408 被重新派发「实现使绿」。核对 git 真理后确认派发前提「测试红、实现未落」已过期:契约测试登记 commit `10c1fd724` 与实现来源均在链,基线即全绿。本次对当前基线做全量重验,未做任何 src/main 改动。
+
+**基准**: `origin/cfclub` @ `b08d823e8`(worktree `.worktrees/task_S-cfc-408`,分支 `task/S-cfc-408`)
+
+**复核命令**(cfc-backend 单模块,未触碰测试/未改实现):
+```
+mvn -q -Dtest='CfRewardV2DispatchF03cContractTest,TeamPoolCreateContractTest,TeamShareWeightedContractTest,CfRewardV2MigrateConfigContractTest' -DfailIfNoTests=false test
+```
+
+**实测结果**(surefire reports,当前基线):
+```
+Tests run: 9,  Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.CfRewardV2DispatchF03cContractTest    ← 本键目标,9/9 GREEN(三次独立运行一致)
+Tests run: 8,  Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.CfRewardV2MigrateConfigContractTest
+Tests run: 13, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.TeamPoolCreateContractTest
+Tests run: 12, Failures: 5, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.TeamShareWeightedContractTest          ← 另一键 cf.teamshare.weightedShare/T05 已从 7 红降至 5 红,仍属该键自身任务,本键不扩散
+```
+
+**链上核验**(当前基线):
+```
+git rev-parse --short HEAD                                      → b08d823e8
+git merge-base --is-ancestor 10c1fd724 HEAD  → 0(契约测试登记已在链,测试文件未被改过——仅 10c1fd724 一次提交)
+git merge-base --is-ancestor 948ff0a77  HEAD  → 0(F03c 种子 T01 实现已在链)
+git merge-base --is-ancestor ae2196a31 HEAD  → 0(RULE_TEAM_POOL 常量实现已在链)
+git merge-base --is-ancestor 325b2ae32 HEAD  → 0(S-cfc-410 团队池账目链路已在链)
+```
+
+**结论(复派)**: `cf.rewardv2.dispatchF03c` 全部契约断言(正常流-1/2/3、边界流-1~5、权限流 N/A)在 `origin/cfclub` HEAD `b08d823e8` 实测 **9/9 全绿**,与首轮验证(`bc3a72cfa`)一致。实现由链上前序任务(S-cfc-401 T01 F03c 种子、S-cfc-406 RULE_TEAM_POOL 常量、S-cfc-410、及既有 F-3b1 消费返佣通用 `earnByRule` per_item + 三道闸)完整承载。**本键无待实现缺口,src/main 零改动**;复派闭环以本复核证据(docs-only)交编排侧转测试侧 mark-green。

+ 48 - 0
docs/tdd/orchestration/report-deploy-2026-11-16-96311452.md

@@ -0,0 +1,48 @@
+# 部署回执:96311452 → testing(2026-11-16)
+
+## 结论
+
+**目标提交 `96311452ec3c127bef85f8f49f4b8b036ac23f4b`(S-cfc-405:cf.rewardv2.platformTake — R0 平台抽成记账 + base 计算,T03 使绿)已真实运行在 testing 环境,部署成功。**
+
+目标提交为本会话开始时 `origin/cfclub` HEAD 的**祖先**,且目标特征代码已在当前线上 JAR 中字节级验证存在(javap 断言 + 源码存在性/逻辑核对),无回退。部署链(`/home/iwt/cfc-deploy-251.sh`)在本窗口内完成构建、安装、健康检查全流程。
+
+## 目标提交与线上版本关系
+
+| 项 | 值 |
+|----|----|
+| 目标提交 | `96311452ec3c127bef85f8f49f4b8b036ac23f4b`(S-cfc-405:`CfCommissionService` 新增 `TAKE_BPS=1000` 常量 + `settlePlatformTake(orderId, orderType, paidAmountCent, orderAmountCent)`(floor(实付×TAKE_BPS/10000) 写 `cf_platform_revenue_log`,`uk_order` 幂等)+ `calcDistributableBase(amountCent, costCent)`(base=A−R0−R1_等值−costCent,base<0 返回 0);新增实体 `CfPlatformRevenueLog.java` +40、`CfPlatformRevenueLogMapper.java` +14、修改 `CfCommissionService.java` +78,共 3 文件 132 插入) |
+| 线上 state commit | `dee50580f24e079fe10a9cbd73d5f1594bd1f079`(`/home/iwt/.cfc-deploy-state`,2026-11-16 03:59:00 写入) |
+| 部署构建源 | `ea4bfbbd6ab6ec148540adaae6864cd9971cf15a`(03:56 自动部署轮纯净 worktree 快照,03:57:56 构建并部署成功;auto-bump 后 state 落 `dee50580f`,后端 JAR 内容等价) |
+| 祖先关系 | `git merge-base --is-ancestor 96311452 dee50580f` → **成立**;对 `ea4bfbbd6`、`f4d6bb152`、`origin/cfclub` 均成立 |
+| 目标特征无回退 | `git diff 96311452 dee50580f -- CfCommissionService.java / CfPlatformRevenueLog.java / CfPlatformRevenueLogMapper.java` 无任何删除行;`settlePlatformTake` / `calcDistributableBase` / `TAKE_BPS` / `cfPlatformRevenueLogMapper` 在 `dee50580f` 源码中原样存在 |
+| class 存在性 | 线上 JAR 内含 `BOOT-INF/classes/com/etotem/cfc/service/CfCommissionService.class`(+`$1`)、`entity/CfPlatformRevenueLog.class`、`mapper/CfPlatformRevenueLogMapper.class`(unzip + javap 确认) |
+
+## 部署链执行(本窗口)
+
+- 部署链路:`/home/iwt/cfc-deploy-251.sh`(origin/cfclub 更新检测 → 纯净 worktree 构建 → JAR 校验 → 停旧进程 → 装新 JAR → 启动健康检查 → 前端/H5 部署 → 最终验证 → auto-bump 回写 + 写 state),日志 `/home/iwt/cfc-deploy.log`。
+- 03:56 自动部署轮:检出更新 → 纯净构建 → 03:57:56 部署 commit `ea4bfbbd6` → 03:58:07 装新 JAR + 启动 PID 1015225 → 03:58:40 后端健康检查通过(HTTP 401/200)→ 03:58:40 前端部署 → 03:58:41 小程序 H5 部署 → 03:59:00 auto-bump 提交并推送 `dee50580f` → 03:59:01 state 写 `dee50580f`(JAR md5 `a71466c8...`),后端 401 / 前端 200 / H5 200。
+- 当前线上 = 最新一次部署结果:commit `dee50580f`(构建源 `ea4bfbbd6`)、JAR `a71466c8...`、PID 1015225。目标 `96311452` 为其祖先,特征代码字节一致存在,无回退。
+
+## 证据
+
+| 项 | 值 |
+|----|----|
+| 运行进程 | PID **1015225**,`java -Xms512m -Xmx1024m -jar /sc-data/springboot/cfc/cfc-backend-1.0.0.jar`,03:58:07 启动;与 `/sc-data/springboot/cfc/cfc.pid` 一致 |
+| JAR 一致性 | 线上 JAR md5 `a71466c8d56d98661368d0a8e4f7ac0d` = state `backend_jar_md5`(直接 md5sum 复核一致) |
+| JAR 内容(javap) | `CfCommissionService.TAKE_BPS` ✓;`settlePlatformTake(Long,String,Integer,Integer):int` ✓;`calcDistributableBase(int,int):int` ✓;`CfPlatformRevenueLog` 7 字段(id/orderId/orderType/amountCent/takeBps/remark/createdAt)✓;`CfPlatformRevenueLogMapper extends BaseMapper<CfPlatformRevenueLog>` ✓ |
+| 部署 state | `/home/iwt/.cfc-deploy-state`:`last_commit=dee50580f24e079fe10a9cbd73d5f1594bd1f079`、`last_deploy=2026-11-16 03:59:00`、`backend_jar_md5=a71466c8...` |
+| 部署链日志 | 03:59:01 `部署完成: commit=dee50580f \ 后端: 401 \ 前端: 200 \ H5: 200`;03:58:40 `后端健康检查通过(HTTP 401/200,PID=1015225)` |
+
+## 健康回执(2026-11-16 04:0x 直连探测)
+
+| 目标 | 探测 | 结果 |
+|------|------|------|
+| 后端基线 | `POST /api/admin/foods/list` | 401(无 token 预期)✓ |
+| 管理端 | `http://localhost/admin/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 小程序 H5 | `http://localhost/frontend/`(Host: cfc.iwintrue.com) | 200 ✓ |
+
+## 说明
+
+- 按编排要求,本次**未创建/修改/写入** `.workbuddy/tasks.json`,未写 `last_deployed`;`--deploy-done testing --commit <sha>` 由编排侧/负责人在**主分支目录**统一落盘,本会话不处理。
+- **实际部署成功的 commit hash(供编排侧 `--deploy-done testing --commit` 落盘):`dee50580f24e079fe10a9cbd73d5f1594bd1f079`**(当前 state `last_commit`,线上 JAR 与其 md5 一致;目标 `96311452` 为其祖先、特征代码字节一致,已真实运行在 testing,PID 1015225 / JAR md5 `a71466c8...`)。
+- 目标提交上线路径:目标为 `cfclub` 主线历史提交 → 部署链部署 `ea4bfbbd6` / auto-bump `dee50580f`(均含目标)→ 当前线上 PID 1015225 运行 JAR 内 javap 证实目标方法存在。

+ 52 - 0
docs/tdd/orchestration/report-deploy-2026-11-16-ae2196a31.md

@@ -0,0 +1,52 @@
+# 部署回执:ae2196a31 → testing(2026-11-16)
+
+## 结论
+
+**目标提交 `ae2196a310a250cf661043a56533273cf6f5abc2`(S-cfc-406:cf.teamshare.createPool 团队池建池)已真实运行在 testing 环境,部署成功。**
+
+目标提交为本会话开始时 `origin/cfclub` HEAD 的**直接祖先**,且目标特征代码已在当前线上 JAR 中字节级验证存在(javap 断言 + 源码存在性/逻辑核对),无回退。部署链(`/home/iwt/cfc-deploy-251.sh`)在 04:40~04:46 窗口内完成发现更新、纯净构建、安装、健康检查全流程。
+
+## 部署链执行(2026-11-16 04:40 ~ 04:46)
+
+- 部署链路:`/home/iwt/cfc-deploy-251.sh`(每 10 分钟 cron:origin/cfclub 更新检测 → 纯净 worktree 快照构建 → JAR 校验 → 停旧进程 → 装新 JAR → 启动健康检查 → 前端/H5 部署 → auto-bump 回写 + 写 state),日志 `/home/iwt/cfc-deploy.log`。
+- 04:40:01 发现代码更新 `72b76c33e → ae2196a31`,分支确认 cfclub,代码同步,创建纯净构建快照(worktree @ `ae2196a31`)。
+- 04:41:41 后端构建成功(纯净快照 `/tmp/opencode/cfc-build`);04:45:58 小程序 H5 构建成功。
+- 04:45:58 部署 commit `ae2196a31`,使用纯净构建 JAR;04:45:59 备份旧 JAR 为回滚源(`cfc-backend-1.0.0.jar.backup`);04:46:11 安装新 JAR 并启动 PID 1543666。
+- 04:46:42 后端健康检查通过(HTTP 401/200);前端已部署 `dist/ => /sc-data/cfc-admin/dist`;小程序 H5 已部署 `dist/build/h5 => /sc-data/cfc-h5/dist`。
+- 04:46:44 auto-bump 提交并推送 `bc3a72cfa`(cfclub);04:46:45 记录部署状态 commit=`bc3a72cfa`,后端 401 / 前端 200 / H5 200。
+
+## 目标提交与线上版本关系
+
+| 项 | 值 |
+|----|----|
+| 目标提交 | `ae2196a310a250cf661043a56533273cf6f5abc2`(S-cfc-406:`CfCommissionService` 新增 `RULE_TEAM_POOL=F03c` 常量 + `settleTeamPool` 建池入口(解析 T → 算池金额 → uk_order 幂等建 `cf_team_pool_order`),settle/settleReferrerOnly 结算顺序⑤接线;`TeamShareConfigService` T% 多作用域解析(MINIAPP→SYSTEM→GLOBAL→3000bps 兜底,TTL 60s 缓存);新增 `CfTeamPoolOrder`/`CfTeamShareConfig` 实体 + Mapper;`TeamPoolCreateContractTest` 13 例全绿) |
+| 线上 state commit | `bc3a72cfa738d2232d57fc9f7102bc7d6d01e1f5`(`/home/iwt/.cfc-deploy-state`,2026-11-16 04:46:44 写入,auto-bump 提交) |
+| 部署构建源 | `ae2196a31`(04:40 自动部署轮纯净 worktree 快照,04:41:41 构建成功,04:46:11 部署成功;auto-bump 后 state 落 `bc3a72cfa`,后端 JAR 内容等价) |
+| 祖先关系 | `git merge-base --is-ancestor ae2196a31 bc3a72cfa` → **成立**;对 `origin/cfclub` 亦成立 |
+| 目标特征无回退 | `git diff ae2196a31 bc3a72cfa` 仅 4 个 cfc-web 版本/changelog 文件(37+/3-),后端 src 零改动;feature 文件无任何删除行 |
+| class 存在性 | 线上 JAR 内含 `CfTeamPoolOrder`/`CfTeamShareConfig`/`CfTeamPoolOrderMapper`/`CfTeamShareConfigMapper`/`CfCommissionService`(+`$1`)/`TeamShareConfigService`(unzip + javap 确认,见下) |
+
+## 证据(本窗口独立复核)
+
+| 项 | 值 |
+|----|----|
+| 运行进程 | PID **1543666**,`java -Xms512m -Xmx1024m -jar /sc-data/springboot/cfc/cfc-backend-1.0.0.jar`,04:46:11 启动;与 `/sc-data/springboot/cfc/cfc.pid` 一致 |
+| JAR 一致性 | 线上 JAR md5 `6f23fad73bc8207fec77cf21b44c1965` = state `backend_jar_md5`(直接 md5sum 复核一致) |
+| JAR 内容(javap) | `CfCommissionService.RULE_TEAM_POOL` ✓;`settleTeamPool(Long,String,Long,Long,Integer,Long)` ✓;`calcTeamPoolCent` ✓;`cfTeamPoolOrderMapper` 注入 ✓;`TeamShareConfigService`(`SCOPE_GLOBAL/SYSTEM/MINIAPP` + `DEFAULT_T_BPS` + `CACHE_TTL_MS` 缓存 + `resolveTbps(String,Long)` + `queryEnabled`)✓;`CfTeamPoolOrder` 12 字段(id/orderId/orderType/productId/buyerUserId/poolCent/tBps/configScope/status/remark/createdAt/settledAt)✓;`CfTeamShareConfig`(ownerType/ownerId/tBps/enabled/…)✓;两个 Mapper 均 `extends BaseMapper<对应实体>` ✓ |
+| 部署 state | `/home/iwt/.cfc-deploy-state`:`last_commit=bc3a72cfa738d2232d57fc9f7102bc7d6d01e1f5`、`last_deploy=2026-11-16 04:46:44`、`backend_jar_md5=6f23fad73bc8207fec77cf21b44c1965` |
+| 部署链日志 | 04:46:45 `部署完成: commit=bc3a72cfa \ 后端: 401 \ 前端: 200 \ H5: 200`;04:46:42 `后端健康检查通过(HTTP 401/200,PID=1543666)`;04:40:01 `发现代码更新: 72b76c33e → ae2196a31`;04:45:58 `部署 commit: ae2196a31` |
+| 后续 cron 轮 | 04:50 / 05:00 轮 `无更新(当前=bc3a72cfa,远程=bc3a72cfa)`,确认线上已是最新 |
+
+## 健康回执(2026-11-16 05:0x 直连探测,本窗口实测)
+
+| 目标 | 探测 | 结果 |
+|------|------|------|
+| 后端基线 | `POST /api/admin/foods/list` | 401(无 token 预期)✓ |
+| 管理端 | `http://localhost/admin/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 小程序 H5 | `http://localhost/frontend/`(Host: cfc.iwintrue.com) | 200 ✓ |
+
+## 说明
+
+- 按编排要求,本次**未创建/修改/写入** `.workbuddy/tasks.json`,未写 `last_deployed`;`--deploy-done testing --commit <sha>` 由编排侧/负责人在**主分支目录**统一落盘,本会话不处理。
+- **实际部署成功的 commit hash(供编排侧 `--deploy-done testing --commit` 落盘):`bc3a72cfa738d2232d57fc9f7102bc7d6d01e1f5`**(当前 state `last_commit`,线上 JAR 与其 md5 一致;目标 `ae2196a31` 为其直接祖先、特征代码字节一致,已真实运行在 testing,PID 1543666 / JAR md5 `6f23fad7...`)。
+- 目标提交上线路径:目标为 `cfclub` 主线历史提交 → 自动部署链 04:40 发现更新并纯净构建 `ae2196a31` → 04:46:11 部署运行 → auto-bump `bc3a72cfa` 推送 → 当前线上 PID 1543666 运行 JAR 内 javap 证实目标方法/常量/实体/Mapper 全部存在。

+ 46 - 0
docs/tdd/orchestration/report-deploy-2026-11-16-b4c755f6b.md

@@ -0,0 +1,46 @@
+# 部署回执:b4c755f6b → testing(2026-11-16)
+
+## 结论
+
+**目标提交 `b4c755f6b2dac87e2fc788e0f09f3d48276d8f9b`(S-cfc-409:cf.rewardv2.removeLegacy 旧体系废弃清理)已真实运行在 testing 环境,部署成功。**
+
+目标提交为本会话开始时 `origin/cfclub` HEAD 的**直接父提交**(HEAD `b08d823e8` 为其 auto-bump 产物),部署链(`/home/iwt/cfc-deploy-251.sh`)于 05:45:02~05:45:41 窗口内完成纯净构建、JAR 安装、健康检查、前端/H5 部署、auto-bump 全流程;本会话复跑部署链确认无更新(exit 0),并做运行时 + 字节级复核全部通过,无回退。
+
+## 目标提交与线上版本关系
+
+| 项 | 值 |
+|----|----|
+| 目标提交 | `b4c755f6b2dac87e2fc788e0f09f3d48276d8f9b`(S-cfc-409:删除 6 契约类 ProfitPoolService/TeamProfitService/TeamProfitFlowService/StarScoreCalculator/TeamProfitCronTask/TeamProfitAdminController + TeamStarController;DatabaseInitializer 去除 4 旧表 DDL 131 行;5 订单服务移除 ProfitPoolService 结算调用;StarDigestService 走既有 fallback;保留 TeamProfitConfigService/ServiceCostConfigService 与 4 表实体;删 TeamProfitPipelineContractTest) |
+| 线上 state commit | `b08d823e86106eabd281c0da0aabb6f49a3eb933`(`/home/iwt/.cfc-deploy-state`,2026-11-16 05:45:41 写入) |
+| 部署构建源 | `b4c755f6b2dac87e2fc788e0f09f3d48276d8f9b`(05:45:02 纯净 worktree 快照,05:45:08 构建并部署成功;auto-bump 后 state 落 `b08d823e8`) |
+| 祖先关系 | `git merge-base --is-ancestor b4c755f6b b08d823e8` → **成立**(直接父提交);`origin/cfclub` = `b08d823e8`,目标已在链上 |
+| 后端源码一致性 | `git diff --stat b4c755f6b b08d823e8 -- cfc-backend/` → **空**(两者后端源码零差异,仅 cfc-web 5 个 auto-bump 产物文件不同) |
+| 目标特征无回退 | S-cfc-409 为删除型提交:7 个删除类在线上 JAR 内**全部缺席**;6 个保留类**全部存在**;`StarDigestService` javap 对 `StarScoreCalculator` 引用次数 = 0(fallback 路径) |
+
+## 部署链执行(本窗口)
+
+- 部署链路:`/home/iwt/cfc-deploy-251.sh`(origin/cfclub 更新检测 → 纯净 worktree 构建 → JAR 校验 → 停旧进程 → 装新 JAR → 启动健康检查 → 前端/H5 部署 → 最终验证 → auto-bump 回写 + 写 state),日志 `/home/iwt/cfc-deploy.log`。
+- 05:45:02 检出更新 → 纯净构建 JAR → 05:45:03 备份回滚源 → 05:45:08 安装新 JAR + 启动 PID 2035424 → 05:45:38 后端健康检查通过(HTTP 401/200)→ 05:45:38 前端部署 `/sc-data/cfc-admin/dist` + 小程序 H5 部署 `/sc-data/cfc-h5/dist` → 05:45:41 auto-bump 提交并推送 `b08d823e8` → 05:45:41 state 写 `b08d823e8`(JAR md5 `ac763fce...`),后端 401 / 前端 200 / H5 200。
+- 05:50~06:20 自动部署轮连续无更新(当前=远程=`b08d823e8`)。
+- 本会话 06:23 复跑部署链:exit 0,日志 `无更新(当前=b08d823e86106eabd281c0da0aabb6f49a3eb933,远程=同)`,确认线上已是最新、无需再部署。
+
+## 证据(2026-11-16 06:2x 直连探测 + 字节级复核)
+
+| 项 | 值 |
+|----|----|
+| 运行进程 | PID **2035424**(= `/sc-data/springboot/cfc/cfc.pid`),`java -Xms512m -Xmx1024m -jar /sc-data/springboot/cfc/cfc-backend-1.0.0.jar`,05:45:07 启动,进程存活 |
+| JAR 一致性 | 线上 JAR md5 `ac763fced53b8fbd2813d99abfa41cc6` = state `backend_jar_md5`(md5sum 复核一致) |
+| 后端健康 | `POST /api/admin/foods/list` → **401**(无 token 预期)✓ |
+| 管理端 | `http://localhost/admin/`(Host: cfc.iwintrue.com)→ **200** ✓ |
+| 小程序 H5 | `http://localhost/frontend/`(Host: cfc.iwintrue.com)→ **200** ✓ |
+| 删除类(应缺席) | `ProfitPoolService` / `TeamProfitService` / `TeamProfitFlowService` / `StarScoreCalculator` / `TeamProfitCronTask` / `admin/TeamProfitAdminController` / `TeamStarController` → unzip -l 线上 JAR **7/7 ABSENT** ✓ |
+| 保留类(应在场) | `TeamProfitConfigService` / `ServiceCostConfigService` / `StarDigestService` / `CfCommissionService`(S-cfc-405 祖先)/ `CfPlatformRevenueLog`(S-cfc-405 祖先)/ `DatabaseInitializer` → **6/6 PRESENT** ✓ |
+| StarDigestService | javap 反编译线上 class:对 `StarScoreCalculator` 引用次数 **0**(fallback 路径,不再依赖 calculator)✓ |
+| DatabaseInitializer | 目标提交源码中 4 旧表(profit_pool_order/team_share_record/team_award_record/service_cost_config)CREATE DDL 残留 **0** 处 ✓ |
+| 部署 state | `/home/iwt/.cfc-deploy-state`:`last_commit=b08d823e86106eabd281c0da0aabb6f49a3eb933`、`last_deploy=2026-11-16 05:45:41`、`backend_jar_md5=ac763fce...` |
+| 部署链日志 | 05:45:41 `部署完成: commit=b08d823e8... \ 后端: 401 \ 前端: 200 \ H5: 200`;05:45:38 `后端健康检查通过(HTTP 401/200,PID=2035424)` |
+
+## 说明
+
+- 按编排要求,本次**未创建/修改/写入** `.workbuddy/tasks.json`,未写 `last_deployed`;`--deploy-done testing --commit <sha>` 由编排侧/负责人在**主分支目录**统一落盘,本会话不处理。
+- **实际部署成功的 commit hash(供编排侧 `--deploy-done testing --commit` 落盘):`b08d823e86106eabd281c0da0aabb6f49a3eb933`**(当前 state `last_commit`,auto-bump 提交,其直接父即为目标 `b4c755f6b`;线上 JAR md5 与其一致,目标特征字节级验证无回退;目标若需按构建源登记则为其父提交 `b4c755f6b` 本身)。

+ 53 - 0
docs/tdd/orchestration/report-deploy-2026-11-16-c75a707ae.md

@@ -0,0 +1,53 @@
+# 部署回执:c75a707ae → testing(2026-11-16)
+
+## 结论
+
+**目标提交 `c75a707ae5ba1ccaac00e5157ebd626aedfa84d3`(S-cfc-391:五维能量规则引擎实时触发 apply 实现)已真实运行在 testing 环境,部署成功。**
+
+目标提交为本会话开始时 `origin/cfclub` HEAD 的**直接祖先**,且目标特征代码已在当前线上 JAR 中字节级验证存在(javap 断言 + 源码存在性/逻辑核对),无回退。部署链(`/home/iwt/cfc-deploy-251.sh`)在 05:35~05:45 窗口内完成发现更新、纯净构建、安装、健康检查全流程。
+
+## 部署链执行(2026-11-16 05:35 ~ 05:45)
+
+- 部署链路:`/home/iwt/cfc-deploy-251.sh`(每 10 分钟 cron:origin/cfclub 更新检测 → 纯净 worktree 快照构建 → JAR 校验 → 停旧进程 → 装新 JAR → 启动健康检查 → 前端/H5 部署 → auto-bump 回写 + 写 state),日志 `/home/iwt/cfc-deploy.log`。
+- 05:30 轮发现并部署 `e6f0a4597`(c75a707ae 的直接 auto-bump 后代,目标特征首次上线)。
+- 05:40:02 发现代码更新 `e6f0a4597 → b4c755f6b`,分支确认 cfclub,代码同步,创建纯净构建快照(worktree @ `b4c755f6b`)。
+- 05:41:11 后端构建成功(纯净快照 `/tmp/opencode/cfc-build`);05:42:48 前端构建成功(v1.0.2556);05:43:17 config.js 注入;05:45:02 小程序 H5 构建成功。
+- 05:45:08 部署 commit `b4c755f6b`,使用纯净构建 JAR;05:45:03 备份旧 JAR 为回滚源(`cfc-backend-1.0.0.jar.backup`);05:45:08 安装新 JAR 并启动 PID 2035424。
+- 05:45:38 后端健康检查通过(HTTP 401/200);前端已部署 `dist/ => /sc-data/cfc-admin/dist`;小程序 H5 已部署 `dist/build/h5 => /sc-data/cfc-h5/dist`。
+- 05:45:41 auto-bump 提交并推送 `b08d823e8`(cfclub);05:45:41 记录部署状态 commit=`b08d823e8`,后端 401 / 前端 200 / H5 200。
+- 后续 cron 轮 05:50 / 06:00 / 06:10 / 06:20 均 `无更新(当前=b08d823e8,远程=b08d823e8)`,确认线上已是最新且无积压。
+
+## 目标提交与线上版本关系
+
+| 项 | 值 |
+|----|----|
+| 目标提交 | `c75a707ae5ba1ccaac00e5157ebd626aedfa84d3`(S-cfc-391:`EnergyRuleEngine` 新增 `public apply(String, Long, Long, Map): Map` 实时触发入口(事件→规则匹配→归因维度+数值→写 EnergyLog/EnergyBalance,返回 awarded/capped/duplicated),`evaluate` 委托 apply;`EnergyService` 新增 `getTodayDimensionTotal(Long, Long): int` 供触顶判定;17/17 契约转绿。改动 2 文件 +191/-20) |
+| 线上 state commit | `b08d823e86106eabd281c0da0aabb6f49a3eb933`(`/home/iwt/.cfc-deploy-state`,2026-11-16 05:45:41 写入,auto-bump 提交) |
+| 部署构建源 | `b4c755f6b`(05:40 自动部署轮纯净 worktree 快照,05:41:11 构建成功,05:45:08 部署成功;auto-bump 后 state 落 `b08d823e8`,后端 JAR 内容等价) |
+| 祖先关系 | `git merge-base --is-ancestor c75a707ae b08d823e8` → **成立**;对 `b4c755f6b`、`origin/cfclub` 亦成立 |
+| 目标特征无回退 | `git diff c75a707ae b4c755f6b -- EnergyRuleEngine.java / EnergyService.java` **无任何删除行**;`apply()` 在 `b4c755f6b` 源码第 72 行、`getTodayDimensionTotal()` 第 2545 行原样存在 |
+| class 存在性 | 线上 JAR 内含 `EnergyRuleEngine.class`(+`$1`)/`EnergyService.class`(unzip + javap 确认,见下) |
+
+## 证据(本窗口独立复核)
+
+| 项 | 值 |
+|----|----|
+| 运行进程 | PID **2035424**,`java -Xms512m -Xmx1024m -jar /sc-data/springboot/cfc/cfc-backend-1.0.0.jar`,05:45:08 启动;与 `/sc-data/springboot/cfc/cfc.pid` 一致 |
+| JAR 一致性 | 线上 JAR md5 `ac763fced53b8fbd2813d99abfa41cc6` = state `backend_jar_md5`(直接 md5sum 复核一致) |
+| JAR 内容(javap) | `EnergyRuleEngine.apply(String, Long, Long, Map<String,Object>): Map<String,Object>` ✓;`EnergyService.getTodayDimensionTotal(Long, Long): int` ✓(含 `lambda$getTodayDimensionTotal$9`) |
+| 部署 state | `/home/iwt/.cfc-deploy-state`:`last_commit=b08d823e86106eabd281c0da0aabb6f49a3eb933`、`last_deploy=2026-11-16 05:45:41`、`backend_jar_md5=ac763fced53b8fbd2813d99abfa41cc6` |
+| 部署链日志 | 05:45:41 `部署完成: commit=b08d823e8 \ 后端: 401 \ 前端: 200 \ H5: 200`;05:45:38 `后端健康检查通过(HTTP 401/200,PID=2035424)`;05:40:02 `发现代码更新: e6f0a4597 → b4c755f6b`;05:45:02 `部署 commit: b4c755f6b` |
+
+## 健康回执(2026-11-16 06:2x 直连探测,本窗口实测)
+
+| 目标 | 探测 | 结果 |
+|------|------|------|
+| 后端基线 | `POST /api/admin/foods/list` | 401(无 token 预期)✓ |
+| 管理端 | `http://localhost/admin/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 小程序 H5 | `http://localhost/frontend/`(Host: cfc.iwintrue.com) | 200 ✓ |
+
+## 说明
+
+- 按编排要求,本次**未创建/修改/写入** `.workbuddy/tasks.json`,未写 `last_deployed`;`--deploy-done testing --commit <sha>` 由编排侧/负责人在**主分支目录**统一落盘,本会话不处理。
+- **实际部署成功的 commit hash(供编排侧 `--deploy-done testing --commit` 落盘):`b08d823e86106eabd281c0da0aabb6f49a3eb933`**(当前 state `last_commit`,线上 JAR 与其 md5 一致;目标 `c75a707ae` 为其直接祖先、特征代码字节一致,已真实运行在 testing,PID 2035424 / JAR md5 `ac763fce...`)。
+- 目标提交上线路径:目标为 `cfclub` 主线历史提交 → 自动部署链 05:40 发现并纯净构建 `b4c755f6b`(含目标)→ 05:45:08 部署运行 → auto-bump `b08d823e8` 推送 → 当前线上 PID 2035424 运行 JAR 内 javap 证实 `EnergyRuleEngine.apply` / `EnergyService.getTodayDimensionTotal` 全部存在。

+ 162 - 0
docs/tdd/orchestration/report-dev-2026-11-16-0348.md

@@ -0,0 +1,162 @@
+# 研发负责人工作汇报(2026-11-16 03:48 · 研发第 189 轮)
+
+> 本自动化第 143 轮 · 标准收割轮 · 无人值守自动执行 · 主线 origin/cfclub
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 汇报人 | 研发负责人(自动化轮) |
+| 汇报周期 | 2026-11-16 03:28 ~ 03:48(第 189 轮) |
+| 负责模块/单元范围 | 全量(CFC 主线 origin/cfclub,当前分支 cfclub ✓) |
+
+---
+
+## 一、本轮工作数据汇总
+
+### 1.0 场景覆盖矩阵(硬职责增列)
+
+> 唯一计数源 `docs/tdd/orchestration/sc-key-map.md`(241 SC);「跑通」三判据=三类流执行证据+已 push origin/cfclub+--clean-check 干净。
+
+| 指标 | 值 | 说明 |
+|------|-----|------|
+| 场景总数 | 241 | sc-key-map.md 全量台账 |
+| 累计已跑通 | 15 | 冻结口径(O-3 转正 5 + 游客域 10) |
+| 本轮新增跑通 | 0 | 无 SC 转正(dev 不代越,转正须测试侧三类流证据) |
+| 失败 | 0 | — |
+| 阻塞 | 0 | — |
+| 未跟踪 | 226 | = 241 − 15 − 0 − 0 |
+
+### 1.1 问题接收与处置
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 收到的测试反馈问题数* | 0 个 | blockers 台账当前无已登记阻塞(--inspect 确认) |
+| 已解决问题数* | 0 个 | 本轮无 QA 侧问题闭环登记;backfill 回填 8 单属证据处置非问题闭环 |
+| 待解决研发问题数 | 5 个 | REQUEUE-EXHAUSTED 待人工核对(S-cfc-296/298/299/304/308,P1);部署 pending 77 回执收口(O-24 历史挂账,P1) |
+
+### 1.2 任务分发与会话管理
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 分派任务数* | 9 个 | --auto --limit 2 派发成功 9 / 失败 0(lan-189×2、lan-204×2、local-lan-4090×2、mes-local-45278×2、pub-iwintrue×1;S-cfc-406~409 等);超限跳过 1(S-cfc-410 留待下轮) |
+| 恢复智能体会话数* | 0 个 | --resume --dry-run 0 候选(prod-etotem 生产实例默认跳过) |
+| 当前在用会话数 | 9 个 | 本轮 9 个派发会话在途;prod-etotem idle(生产) |
+| 会话平均利用率 | ~63% | 估算:9/5 节点在途,lan-204 空位较大(0/10) |
+
+### 1.2b 各会话当前工作状态列表
+
+| 会话标签 | 当前状态 | 当前任务 | 静默/空闲时长 | 工作目录 | 备注 |
+|----------|----------|----------|---------------|----------|------|
+| lan-189 | running | 本轮 2 单 | — | worktree 隔离 | busy 1→2 |
+| lan-204 | running | 本轮 2 单 | — | worktree 隔离 | busy 0→2 |
+| local-lan-4090 | running | S-cfc-406 等(本轮 2) | — | worktree 隔离 | busy 0→2 |
+| mes-local-45278 | running | S-cfc-407/408(本轮 2) | — | worktree 隔离 | busy 2→2 |
+| pub-iwintrue | running | S-cfc-409(本轮 1) | — | /sc-data/cfc | TDD testing 部署节点,首用配额 |
+| prod-etotem | idle | — | — | /root/cfc | 生产节点,恢复默认跳过 |
+
+### 1.3 变更感知与新任务建立
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 感知需求/设计变更数* | 0 个新增键 | --changes --days 7:需求/设计/用例三源均 0 新增能力键(变化集中在既有键) |
+| 新增入池任务数* | 0 个 | auto 未自动登记新 RED(上轮 auto 生成的 S-cfc-405~410 已完成派发);手动 --add-task 0(S8 无四类超标溯源) |
+| 既有键状态流转数 | 0 次 | state 226 键零流转(RED25/YELLOW176/GREEN10/DONE15 与 142 轮终态持平) |
+
+### 1.4 本轮 git 提交与推送证据(真理证据)
+
+| 提交 sha | 关联任务/能力键 | 阶段 | 触及文件类型 | 目标分支 | 已推送远端 | 备注 |
+|----------|-----------------|------|--------------|----------|------------|------|
+| backfill 回填 8 单 | S-cfc-393/395~407 等 | done | 实现/契约 | origin/cfclub | 是 | 一次 git log origin/cfclub 映射(含 96311452e platformTake、3e024736d plan.draft.save 等) |
+| (窗口他人提交) | S-cfc-380/381/382/383/386/388、R225 | — | 实现/测试/部署 | origin/cfclub | 是 | 见 1.6 窗口增量 |
+
+### 1.5 状态机阶段分布与部署状态
+
+| 阶段 | 键数 | 备注 |
+|------|------|------|
+| UNTRACKED | 0 | 无未追踪键 |
+| RED | 25 | 待开发实现 |
+| YELLOW | 176 | 待测试校验 |
+| GREEN | 10 | 待部署验证 |
+| DONE | 15 | 闭环归档 |
+| 合计 | 226 | — |
+
+| 部署项 | 值 | 说明 |
+|--------|-----|------|
+| 本轮部署次数 | 0 次(自动派发验证) | auto 对 YELLOW 键触发部署验证派发,回执待收 |
+| 部署 pending / confirmed | 77 / 77 | pending 121→77(窗口他轮已批量回执消费) |
+| GREEN 部署链验证 | 不通过(挂起) | 本轮 GREEN 无新增;content.article.search 部署验证补收待回执(O-24 延续) |
+
+### 1.6 数据源健康度与窗口业务增量(02:26→03:48)
+
+| 数据源 | 读取键数 | 是否正常 | 备注 |
+|--------|----------|----------|------|
+| 需求侧(⏳ wish) | 0 | 正常 | TDD 池空(目标池 Top12 为空) |
+| 契约常量(contract) | 0 | 正常 | 标注用,不入池门槛 |
+| 测试用例引用(test_case_map) | 0 | 正常 | ⏳∩用例引用 0 |
+| 执行结果回填(case_results) | 0 | 正常 | 无未实现键执行结果 |
+
+窗口主线增量(他轮/他人产物,只读核验):8e92400e4 S-cfc-383 global.search.query 实现使绿、b6080f3b1 S-cfc-381 notification.center.view 契约使绿、3e024736d S-cfc-382 plan.draft.save 实现(SC-P-81)、96311452e S-cfc-405 cf.rewardv2.platformTake 实现(T03 使绿)、96ccd11e8 R225 测试闭环(前端 6/6·线上 API 33/0/3·fe44 套零漂移·lg 6 红 429 观察 + B-225-1 + G12 补 16 条 coupon-share 用例)、部署回执 3 笔(S-cfc-380/386/388 上线 testing)。
+
+---
+
+## 二、下一步需要研发处理的事项
+
+| 序号 | 事项描述 | 依赖/前置条件 | 预估完成时间 | 优先级 | 状态 |
+|------|----------|---------------|--------------|--------|------|
+| 1 | pending 1 续派(S-cfc-410)+ 在途 34 单证据回收(先 backfill 再 --auto) | 节点配额释放(本轮 5 节点配额已满) | 下一错峰档 | P1 | 待启动 |
+| 2 | REQUEUE-EXHAUSTED 5 单人工核对(S-cfc-296/298/299/304/308) | 人工/测试侧核实三类流证据 | 人工窗口 | P1 | 待启动 |
+| 3 | 部署 pending 77 回执收口(O-24,含 content.article.search 部署验证补收 GREEN) | 部署会话回执 | 人工窗口 | P1 | 进行中 |
+| 4 | 6:00 整档 webhook(素材=本窗口增量:3 键实现/契约 + R225 闭环 + backfill 8 单 + 派发 9) | 到达 6:00 | 2026-11-16 06:00 | P2 | 待启动 |
+| 5 | config fill_capacity.enabled=true 与提示词口径(false)统一 | 主理人裁决 | — | P2 | 待裁决 |
+
+---
+
+## 三、阻塞与风险
+
+| 阻塞项 | 影响范围 | 阻塞类型 | 处置进展 | 需要协调 |
+|--------|----------|----------|----------|----------|
+| config fill_capacity.enabled=true 与提示词「CFC 未启用」不一致(第 137~143 轮持续) | S6 填充口径 | 需求 | 待裁决 | 主理人裁决是否启用 |
+| 工作目录 1500 处未提交(他人/他轮 WIP:.tdd/_r*.log 清理 + .gitignore 修改等) | clean-check 门禁 | 其他 | 只报不动 | 归属他轮收口(O-3 判据③零交集,不阻塞本链) |
+
+---
+
+## 四、下轮工作规划
+
+| 计划项 | 预计完成时间 | 前置依赖 | 涉及会话标签 | 备注 |
+|--------|--------------|----------|--------------|------|
+| pending 续派 + 在途证据回收 | 下一错峰档 | backfill 前置 | 5 节点×上限 | auto --limit 2 |
+| 池空续建判定(四类溯源) | 同轮 | — | — | 无溯源则 0 add-task |
+
+---
+
+## 附录 A:收到的测试反馈问题明细
+
+| 问题 ID | 能力键/任务号 | 问题类型 | 来源 | 接收时间 | 处置状态 | 关联 sha |
+|---------|---------------|----------|------|----------|----------|----------|
+| — | — | — | — | — | 本轮 0 收 | — |
+
+## 附录 B:任务分派与会话恢复明细
+
+| 任务号 | 目标会话标签 | 任务类型 | 分派时间 | 当前状态 | 恢复会话标签 | 恢复原因 | 恢复时间 |
+|--------|--------------|----------|----------|----------|--------------|----------|----------|
+| S-cfc-406~409 等 9 单 | lan-189×2/lan-204×2/local-lan-4090×2/mes-local-45278×2/pub-iwintrue×1 | TDD-RED/实现 | 03:36~03:46 | running | — | — | — |
+| S-cfc-410 | — | TDD-RED | — | pending(超限跳过) | — | 本轮配额已满 | 下轮 |
+
+> 各任务分支=task/<tid>、目录=.worktrees/task_<tid>,会话侧自行 commit+push 回报。
+
+## 附录 C:新增入池任务明细
+
+| 任务号 | 能力键 | 需求溯源 | 设计溯源 | 创建时间 | 状态 |
+|--------|--------|----------|----------|----------|------|
+| (本轮 auto 无新增登记) | — | — | — | — | — |
+
+## 附录 D:变更感知明细(来自 --changes)
+
+| 变更文档 | 文档类型 | 变更日期 | 新增能力键 | 是否已入池 |
+|----------|----------|----------|------------|------------|
+| docs/ 近 7 天窗口(测试用例/契约/设计) | 用例/契约 | 2026-11-15~16 前后 | 0 | — |
+
+---
+
+**模板版本**:v1.2(2026-11-14);本轮为无人值守自动化标准收割轮(S1 互斥 PASS → S3 盘点 → P0 backfill → S7 派发 → S10 汇报),S5 心跳/S6 填充按提示词 CFC 未启用跳过。

+ 165 - 0
docs/tdd/orchestration/report-dev-2026-11-16-0505.md

@@ -0,0 +1,165 @@
+# 研发负责人工作汇报(2026-11-16 05:05 · 研发第 190 轮)
+
+> 本自动化第 144 轮 · 标准收割轮 · 无人值守自动执行 · 主线 origin/cfclub
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 汇报人 | 研发负责人(自动化轮) |
+| 汇报周期 | 2026-11-16 04:50 ~ 05:05(第 190 轮) |
+| 负责模块/单元范围 | 全量(CFC 主线 origin/cfclub,当前分支 cfclub ✓) |
+
+---
+
+## 一、本轮工作数据汇总
+
+### 1.0 场景覆盖矩阵(硬职责增列)
+
+> 唯一计数源 `docs/tdd/orchestration/sc-key-map.md`(241 SC);「跑通」三判据=三类流执行证据+已 push origin/cfclub+--clean-check 干净。
+
+| 指标 | 值 | 说明 |
+|------|-----|------|
+| 场景总数 | 241 | sc-key-map.md 全量台账 |
+| 累计已跑通 | 15 | 冻结口径(O-3 转正 5 + 游客域 10) |
+| 本轮新增跑通 | 0 | 无 SC 转正(dev 不代越,转正须测试侧三类流证据) |
+| 失败 | 0 | — |
+| 阻塞 | 0 | — |
+| 未跟踪 | 226 | = 241 − 15 − 0 − 0 |
+
+### 1.1 问题接收与处置
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 收到的测试反馈问题数* | 0 个 | blockers 台账当前无已登记阻塞(--inspect 确认) |
+| 已解决问题数* | 0 个 | 本轮无 QA 侧问题闭环登记;backfill 回填 9 单属证据处置非问题闭环 |
+| 待解决研发问题数 | 6 个 | REQUEUE-EXHAUSTED 待人工核对(S-cfc-296/298/299/304/308,P1);部署 pending 82 回执收口(O-24 历史挂账,P1) |
+
+### 1.2 任务分发与会话管理
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 分派任务数* | 7 个 | --auto --limit 2 派发成功 7 / 失败 0 / 超限跳过 0(lan-189×2、lan-204×2、local-lan-4090×2、mes-local-45278×1;S-cfc-387/391/400/407/408/409/410) |
+| 恢复智能体会话数* | 2 个 | --resume 实际恢复 2:local-lan-4090 S-cfc-400 e2eExample(ses_e1f41e21,mid-work)、lan-204 S-cfc-399 removeLegacy(ses_e1f421bb,mid-work);prod-etotem 生产默认跳过 |
+| 当前在用会话数 | 9 个 | 本轮恢复 2 + 派发 7 会话在途 |
+| 会话平均利用率 | ~63% | 估算:7 新派 + 2 恢复共占 5 节点 |
+
+### 1.2b 各会话当前工作状态列表
+
+| 会话标签 | 当前状态 | 当前任务 | 静默/空闲时长 | 工作目录 | 备注 |
+|----------|----------|----------|---------------|----------|------|
+| lan-189 | running | S-cfc-387/407(本轮 2) | — | worktree 隔离 | deepseek@axon 冷却至 08:00 |
+| lan-204 | running | S-cfc-391/408 + 恢复 S-cfc-399(本轮 2+1) | — | worktree 隔离 | 恢复后中 workload |
+| local-lan-4090 | running | S-cfc-400/409 + 恢复 S-cfc-400(本轮 2) | — | worktree 隔离 | 恢复后中 workload |
+| mes-local-45278 | running | S-cfc-410(本轮 1) | — | worktree 隔离 | busy 1→2 |
+| pub-iwintrue | idle→running | —(配额 1/6 占用,本档未派) | — | /sc-data/cfc | TDD testing 部署节点 |
+| prod-etotem | idle | — | — | /root/cfc | 生产节点,恢复默认跳过 |
+
+### 1.3 变更感知与新任务建立
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 感知需求/设计变更数* | 0 个新增键 | --changes --days 7:需求/设计/用例三源均 0 新增能力键(变化集中在既有键) |
+| 新增入池任务数* | 0 个 | auto 未自动登记新 RED;手动 --add-task 0(S8 无四类超标溯源,pending 已清零收敛) |
+| 既有键状态流转数 | 0 次 | state 226 键零流转(RED25/YELLOW176/GREEN10/DONE15 与 143 轮终态持平) |
+
+### 1.4 本轮 git 提交与推送证据(真理证据)
+
+| 提交 sha | 关联任务/能力键 | 阶段 | 触及文件类型 | 目标分支 | 已推送远端 | 备注 |
+|----------|-----------------|------|--------------|----------|------------|------|
+| backfill 回填 9 单 | S-cfc-387~410 等 | done | 实现/契约 | origin/cfclub | 是 | 一次 git log origin/cfclub 映射(含 ae2196a31 teamshare.createPool、12eb99779 content.article.search 等) |
+| (窗口他人提交) | S-cfc-406、R226 | — | 实现/测试/部署 | origin/cfclub | 是 | 见 1.6 窗口增量 |
+
+### 1.5 状态机阶段分布与部署状态
+
+| 阶段 | 键数 | 备注 |
+|------|------|------|
+| UNTRACKED | 0 | 无未追踪键 |
+| RED | 25 | 待开发实现 |
+| YELLOW | 176 | 待测试校验 |
+| GREEN | 10 | 待部署验证 |
+| DONE | 15 | 闭环归档 |
+| 合计 | 226 | — |
+
+| 部署项 | 值 | 说明 |
+|--------|-----|------|
+| 本轮部署次数 | 0 次(自动派发验证) | auto 对 YELLOW 键触发部署验证派发,回执待收 |
+| 部署 pending / confirmed | 82 / 77 | pending 81→82(auto 新增验证派发) |
+| GREEN 部署链验证 | 不通过(挂起) | 本轮 GREEN 无新增;部署 pending 回执收口 O-24 延续 |
+
+### 1.6 数据源健康度与窗口业务增量(03:48→05:05)
+
+| 数据源 | 读取键数 | 是否正常 | 备注 |
+|--------|----------|----------|------|
+| 需求侧(⏳ wish) | 0 | 正常 | — |
+| 契约常量(contract) | 0 | 正常 | 标注用,不入池门槛 |
+| 测试用例引用(test_case_map) | 0 | 正常 | ⏳∩用例引用 0 |
+| 执行结果回填(case_results) | 0 | 正常 | 无未实现键执行结果 |
+
+窗口主线增量(他轮/他人产物,只读核验):bc3a72cfa auto-bump、ae2196a31 S-cfc-406 cf.teamshare.createPool 团队池建池实现使绿、f48138ba7 R226 测试闭环汇报(基线 9528c60db 窗口+16 提交·新功能契约单测 53/53 全绿·189 首跑 U03 偶发复测 5/5·204 frontend 6/6·lg 43/43 429 清零·B-226-1 新增·G12 补 16 条 global-search/notification 用例)、部署回执 3 笔(S-cfc-388/386/405 上线 testing)。
+
+---
+
+## 二、下一步需要研发处理的事项
+
+| 序号 | 事项描述 | 依赖/前置条件 | 预估完成时间 | 优先级 | 状态 |
+|------|----------|---------------|--------------|--------|------|
+| 1 | 在途 32 单证据回收(先 backfill 再 --auto)+ 池空续建判定 | 节点配额释放 + backfill 前置 | 下一错峰档 | P1 | 待启动 |
+| 2 | REQUEUE-EXHAUSTED 5 单人工核对(S-cfc-296/298/299/304/308) | 人工/测试侧核实三类流证据 | 人工窗口 | P1 | 待启动 |
+| 3 | 部署 pending 82 回执收口(O-24,含 content.article.search 部署验证补收 GREEN) | 部署会话回执 | 人工窗口 | P1 | 进行中 |
+| 4 | 6:00 整档 webhook(素材=本窗口增量:S-cfc-406 使绿 + R226 闭环 + backfill 9 单 + 派发 7) | 到达 6:00 | 2026-11-16 06:00 | P2 | 待启动 |
+| 5 | config fill_capacity.enabled=true 与提示词口径(false)统一 | 主理人裁决 | — | P2 | 待裁决 |
+
+---
+
+## 三、阻塞与风险
+
+| 阻塞项 | 影响范围 | 阻塞类型 | 处置进展 | 需要协调 |
+|--------|----------|----------|----------|----------|
+| config fill_capacity.enabled=true 与提示词「CFC 未启用」不一致(第 137~144 轮持续) | S6 填充口径 | 需求 | 待裁决 | 主理人裁决是否启用 |
+| 工作目录 1501 处未提交(他人/他轮 WIP:.tdd/_r*.log 清理 + .gitignore 修改等) | clean-check 门禁 | 其他 | 只报不动 | 归属他轮收口(O-3 判据③零交集,不阻塞本链) |
+
+---
+
+## 四、下轮工作规划
+
+| 计划项 | 预计完成时间 | 前置依赖 | 涉及会话标签 | 备注 |
+|--------|--------------|----------|--------------|------|
+| 在途证据回收 + 池空续建判定 | 下一错峰档 | backfill 前置 | 5 节点×上限 | auto --limit 2 |
+| 6:00 档 webhook 补发 | 06:00 | — | — | cross-round 判定已落盘 |
+
+---
+
+## 附录 A:收到的测试反馈问题明细
+
+| 问题 ID | 能力键/任务号 | 问题类型 | 来源 | 接收时间 | 处置状态 | 关联 sha |
+|---------|---------------|----------|------|----------|----------|----------|
+| — | — | — | — | — | 本轮 0 收 | — |
+
+## 附录 B:任务分派与会话恢复明细
+
+| 任务号 | 目标会话标签 | 任务类型 | 分派时间 | 当前状态 | 恢复会话标签 | 恢复原因 | 恢复时间 |
+|--------|--------------|----------|----------|----------|--------------|----------|----------|
+| S-cfc-387/407 | lan-189 | TDD-RED | 05:01~05:03 | running | — | — | — |
+| S-cfc-391/408 | lan-204 | TDD-RED | 05:01~05:03 | running | — | — | — |
+| S-cfc-400/409 | local-lan-4090 | TDD-RED | 05:01~05:03 | running | local-lan-4090 | mid-work 恢复 S-cfc-400 | 04:55 |
+| S-cfc-410 | mes-local-45278 | TDD-RED | 05:03 | running | — | — | — |
+| (恢复)S-cfc-399 | lan-204 | TDD-RED | — | running | lan-204 | mid-work 恢复 | 04:55 |
+
+> 各任务分支=task/<tid>、目录=.worktrees/task_<tid>,会话侧自行 commit+push 回报。
+
+## 附录 C:新增入池任务明细
+
+| 任务号 | 能力键 | 需求溯源 | 设计溯源 | 创建时间 | 状态 |
+|--------|--------|----------|----------|----------|------|
+| (本轮 auto 无新增登记) | — | — | — | — | — |
+
+## 附录 D:变更感知明细(来自 --changes)
+
+| 变更文档 | 文档类型 | 变更日期 | 新增能力键 | 是否已入池 |
+|----------|----------|----------|------------|------------|
+| docs/ 近 7 天窗口(测试用例/契约/设计) | 用例/契约 | 2026-11-15~16 前后 | 0 | — |
+
+---
+
+**模板版本**:v1.2(2026-11-14);本轮为无人值守自动化标准收割轮(S1 互斥 PASS → S3 盘点 → S4 恢复 2 → P0 backfill → S7 派发 7 → S10 汇报),S5 心跳 enabled=false / S6 填充按提示词 CFC 未启用跳过。

+ 165 - 0
docs/tdd/orchestration/report-dev-2026-11-16-0625.md

@@ -0,0 +1,165 @@
+# 研发负责人工作汇报(2026-11-16 06:25 · 研发第 191 轮)
+
+> 本自动化第 145 轮 · 标准收割轮 · 无人值守自动执行 · 主线 origin/cfclub
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 汇报人 | 研发负责人(自动化轮) |
+| 汇报周期 | 2026-11-16 05:20 ~ 06:25(第 191 轮) |
+| 负责模块/单元范围 | 全量(CFC 主线 origin/cfclub,当前分支 cfclub ✓) |
+
+---
+
+## 一、本轮工作数据汇总
+
+### 1.0 场景覆盖矩阵(硬职责增列)
+
+> 唯一计数源 `docs/tdd/orchestration/sc-key-map.md`(241 SC);「跑通」三判据=三类流执行证据+已 push origin/cfclub+--clean-check 干净。
+
+| 指标 | 值 | 说明 |
+|------|-----|------|
+| 场景总数 | 241 | sc-key-map.md 全量台账 |
+| 累计已跑通 | 15 | 冻结口径(O-3 转正 5 + 游客域 10) |
+| 本轮新增跑通 | 0 | 无 SC 转正(dev 不代越,转正须测试侧三类流证据) |
+| 失败 | 0 | — |
+| 阻塞 | 0 | — |
+| 未跟踪 | 226 | = 241 − 15 − 0 − 0 |
+
+### 1.1 问题接收与处置
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 收到的测试反馈问题数* | 0 个 | blockers 台账当前无已登记阻塞(--inspect 确认) |
+| 已解决问题数* | 0 个 | 本轮无 QA 侧问题闭环登记;backfill 回填 15 单属证据处置非问题闭环 |
+| 待解决研发问题数 | 6 个 | REQUEUE-EXHAUSTED 待人工核对(S-cfc-296/298/299/304/308,P1);部署 pending 85 回执收口(O-24 历史挂账,P1) |
+
+### 1.2 任务分发与会话管理
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 分派任务数* | 4 个 | --auto --limit 2 派发成功 2 / 失败 0 / 超限跳过 0(S-cfc-407→lan-204、S-cfc-408→local-lan-4090)+ 部署派发 2(S-cfc-409 removeLegacy、S-cfc-410 e2eExample → testing@pub-iwintrue) |
+| 恢复智能体会话数* | 0 个 | --resume --dry-run 0 候选(探测 3m17s);prod-etotem 生产默认跳过 |
+| 当前在用会话数 | 6 个 | --inspect 配额占用:lan-189 busy2、lan-204 busy1、local-lan-4090 busy1、mes-local-45278 busy2、pub-iwintrue busy1(+2 部署会话) |
+| 会话平均利用率 | ~50% | 估算:2 新派 + 2 部署 + 在途 27 单分布于 5 节点 |
+
+### 1.2b 各会话当前工作状态列表
+
+| 会话标签 | 当前状态 | 当前任务 | 静默/空闲时长 | 工作目录 | 备注 |
+|----------|----------|----------|---------------|----------|------|
+| lan-189 | running | 在途 2(配额占用 2/4,剩余 2) | — | worktree 隔离 | deepseek@axon 冷却至 08:00(P0 黑窗) |
+| lan-204 | running→idle | 本轮派 S-cfc-407(占用 1/10,剩余 9) | — | worktree 隔离 | 连接抖动历史(10054/10061) |
+| local-lan-4090 | running→idle | 本轮派 S-cfc-408(占用 1/6,剩余 5) | — | worktree 隔离 | — |
+| mes-local-45278 | running | 在途 2(占用 2/6,剩余 4) | — | worktree 隔离 | — |
+| pub-iwintrue | running | 2 部署任务(removeLegacy/e2eExample,占用 1/6) | — | /sc-data/cfc | TDD testing 部署节点 |
+| prod-etotem | idle | — | — | /root/cfc | 生产节点,恢复默认跳过 |
+
+### 1.3 变更感知与新任务建立
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| 感知需求/设计变更数* | 0 个新增键 | --changes --days 7:需求/设计/用例三源均 0 新增能力键(变化集中在既有键) |
+| 新增入池任务数* | 0 个 | auto 未自动登记新 RED;手动 --add-task 0(S8 待判) |
+| 既有键状态流转数 | 0 次 | state 226 键零流转(RED25/YELLOW176/GREEN10/DONE15 与 190 轮终态持平) |
+
+### 1.4 本轮 git 提交与推送证据(真理证据)
+
+| 提交 sha | 关联任务/能力键 | 阶段 | 触及文件类型 | 目标分支 | 已推送远端 | 备注 |
+|----------|-----------------|------|--------------|----------|------------|------|
+| backfill 回填 15 单 | S-cfc-396~410 等 | done | 实现/契约 | origin/cfclub | 是 | 一次 git log origin/cfclub 映射(含 2680bd0ae teamshare.createPool、b4c755f6b removeLegacy 等) |
+| (窗口他人提交) | S-cfc-409/391/410/408 | — | 实现/测试 | origin/cfclub | 是 | 见 1.6 窗口增量 |
+
+### 1.5 状态机阶段分布与部署状态
+
+| 阶段 | 键数 | 备注 |
+|------|------|------|
+| UNTRACKED | 0 | 无未追踪键 |
+| RED | 25 | 待开发实现 |
+| YELLOW | 176 | 待测试校验 |
+| GREEN | 10 | 待部署验证 |
+| DONE | 15 | 闭环归档 |
+| 合计 | 226 | — |
+
+| 部署项 | 值 | 说明 |
+|--------|-----|------|
+| 本轮部署次数 | 2 次(自动派发验证) | auto 对 YELLOW 键(removeLegacy/e2eExample)触发部署验证派发至 testing |
+| 部署 pending / confirmed | 85 / 77 | pending 82→85(auto 新增 3 验证派发) |
+| GREEN 部署链验证 | 不通过(挂起) | 本轮 GREEN 无新增;部署 pending 回执收口 O-24 延续 |
+
+### 1.6 数据源健康度与窗口业务增量(05:05→06:25)
+
+| 数据源 | 读取键数 | 是否正常 | 备注 |
+|--------|----------|----------|------|
+| 需求侧(⏳ wish) | 0 | 正常 | — |
+| 契约常量(contract) | 0 | 正常 | 标注用,不入池门槛 |
+| 测试用例引用(test_case_map) | 0 | 正常 | ⏳∩用例引用 0 |
+| 执行结果回填(case_results) | 0 | 正常 | 无未实现键执行结果 |
+
+窗口主线增量(他轮/他人产物,只读核验):b4c755f6b S-cfc-409 cf.rewardv2.removeLegacy 旧体系废弃清理实现、c75a707ae S-cfc-391 energy.ruleEngine.apply 五维能量规则引擎实时触发实现使绿、325b2ae32 S-cfc-410 cf.rewardv2.e2eExample 分润v2端到端账目契约使绿、de3aa5e2e S-cfc-408 dispatchF03c verify green;auto 自动置 YELLOW 一批(shop.review.create/detail/my、shop.order.receiptTimeout、cf.rewardv2.platformTake、cf.teamshare.createPool)待测试校验。
+
+---
+
+## 二、下一步需要研发处理的事项
+
+| 序号 | 事项描述 | 依赖/前置条件 | 预估完成时间 | 优先级 | 状态 |
+|------|----------|---------------|--------------|--------|------|
+| 1 | 在途 27 单证据回收(先 backfill 再 --auto)+ 池空续建判定 | 节点配额释放 + backfill 前置 | 下一错峰档 | P1 | 待启动 |
+| 2 | REQUEUE-EXHAUSTED 5 单人工核对(S-cfc-296/298/299/304/308) | 人工/测试侧核实三类流证据 | 人工窗口 | P1 | 待启动 |
+| 3 | 部署 pending 85 回执收口(O-24,含本轮 removeLegacy/e2eExample 部署回执) | 部署会话回执 | 人工窗口 | P1 | 进行中 |
+| 4 | 10:00 整档 webhook(素材=本窗口增量:S-cfc-409/391/410/408 + backfill 15 单 + 派发 2) | 到达 10:00 | 2026-11-16 10:00 | P2 | 待启动 |
+| 5 | config fill_capacity.enabled=true 与提示词口径(false)统一 | 主理人裁决 | — | P2 | 待裁决 |
+
+---
+
+## 三、阻塞与风险
+
+| 阻塞项 | 影响范围 | 阻塞类型 | 处置进展 | 需要协调 |
+|--------|----------|----------|----------|----------|
+| config fill_capacity.enabled=true 与提示词「CFC 未启用」不一致(第 137~145 轮持续) | S6 填充口径 | 需求 | 待裁决 | 主理人裁决是否启用 |
+| 工作目录 1502 处未提交(他人/他轮 WIP:.tdd/_r*.log 清理 + .gitignore 修改等) | clean-check 门禁 | 其他 | 只报不动 | 归属他轮收口(O-3 判据③零交集,不阻塞本链) |
+| lan-189@deepseek@axon 冷却至 08:00 | 该节点本档派发 | 其他 | 自动走 fallback 链 | 08:00 自动解禁 |
+
+---
+
+## 四、下轮工作规划
+
+| 计划项 | 预计完成时间 | 前置依赖 | 涉及会话标签 | 备注 |
+|--------|--------------|----------|--------------|------|
+| 在途证据回收 + 池空续建判定 | 下一错峰档 | backfill 前置 | 5 节点×上限 | auto --limit 2 |
+| 10:00 档 webhook | 10:00 | — | — | 整档判定 |
+
+---
+
+## 附录 A:收到的测试反馈问题明细
+
+| 问题 ID | 能力键/任务号 | 问题类型 | 来源 | 接收时间 | 处置状态 | 关联 sha |
+|---------|---------------|----------|------|----------|----------|----------|
+| — | — | — | — | — | 本轮 0 收 | — |
+
+## 附录 B:任务分派与会话恢复明细
+
+| 任务号 | 目标会话标签 | 任务类型 | 分派时间 | 当前状态 | 恢复会话标签 | 恢复原因 | 恢复时间 |
+|--------|--------------|----------|----------|----------|--------------|----------|----------|
+| S-cfc-407 | lan-204 | TDD(requeue #3 后重派) | 06:2x | running | — | — | — |
+| S-cfc-408 | local-lan-4090 | TDD(requeue #2 后重派) | 06:2x | running | — | — | — |
+| S-cfc-409 | pub-iwintrue | 部署验证 | 06:2x | running | — | — | — |
+| S-cfc-410 | pub-iwintrue | 部署验证 | 06:2x | running | — | — | — |
+
+> 各任务分支=task/<tid>、目录=.worktrees/task_<tid>,会话侧自行 commit+push 回报。
+
+## 附录 C:新增入池任务明细
+
+| 任务号 | 能力键 | 需求溯源 | 设计溯源 | 创建时间 | 状态 |
+|--------|--------|----------|----------|----------|------|
+| (本轮 auto 无新增登记) | — | — | — | — | — |
+
+## 附录 D:变更感知明细(来自 --changes)
+
+| 变更文档 | 文档类型 | 变更日期 | 新增能力键 | 是否已入池 |
+|----------|----------|----------|------------|------------|
+| docs/ 近 7 天窗口(测试用例/契约/设计) | 用例/契约 | 2026-11-15~16 前后 | 0 | — |
+
+---
+
+**模板版本**:v1.2(2026-11-14);本轮为无人值守自动化标准收割轮(S1 互斥 PASS → S3 盘点 → S4 恢复 0 → P0 backfill 回填 15 → S7 派发 2 + 部署 2 → S10 汇报),S5 心跳 enabled=false / S6 填充按提示词 CFC 未启用跳过(config fill_capacity.enabled=true 口径不一致待裁决)。webhook 06 档已发(wxWaitMsgId 01M7GMVRHJKG7NN6G2PGXRX2H6)。

+ 196 - 0
docs/tdd/orchestration/report-test-2026-11-16-R226.md

@@ -0,0 +1,196 @@
+# 测试负责人工作汇报 R226(2026-11-16 03:55 GMT+8 · 自动化闭环)
+
+> 测试负责人:陆谨(软件测试专家团 · 测试架构师)|执行档:**review(离线白名单)** + 内网三节点浏览器 E2E 实跑(189 admin / 204 frontend / 251 langgraph)
+> 静默无人值守,全程未提问;方案假设已在 §2 声明
+> 基线:`origin/cfclub` **`9528c60db`**(R225 执行基线)→ 本轮窗口至 **`b6080f3b1`**(R226 执行时远端最新,HTTP 通道 fetch);窗口 **+16 提交**(含 S-cfc-381/383/382/405 四个功能 + coupon-share T02 + 部署回执/bump 等)→ **有 src 变更,触发 G12 工序**
+
+## 0. 历史审查记录(对照,非本次结论依据)
+
+| 项 | 内容 |
+|---|---|
+| 上次审查 | **R225(2026-11-16 02:50)**,结论「不通过(有条件)」;基线 `9528c60db`;lg@251 43 例 **37 过 / 6 红**(429 环境型);B-225-1 coupon-share T02 已闭环复核全绿 |
+| 本次 | **第 226 轮,非首次审查**;基线 `9528c60db` → 实测 HEAD `b6080f3b1`(窗口 +16 提交,含 4 个新功能) |
+| 遗留 → 本次状态 | **B-223-1(lg 429 红集)→ ✅ 本轮 43/43 全绿(429 清零,观察 3/3 满足销号)**;**B-218-1(P0 Bean 撞名守卫)→ 承袭未修**(本轮后端零变更,守卫红沿用 R225 结论);B-36(根级 16 红)→ 承袭;B-DX-1(dx 2 跳)→ 第 59 轮;G11(CI 清单失真)→ 承袭(第 27 轮) |
+| 本次新增 | **B-226-1(P2 观察项)**:189 admin E2E 首跑 TC-A-U03 偶发 1 红,**复测 5/5 全绿**(本机同版 spec 5/5、U03 单独 4.3s 通过、生产 /admin/ 与 /admin/login 均 HTTP 200/13ms)→ 判定为节点时序偶发,非产品回归,观察 1/3 |
+| 窗口后置 | R226 执行期间远端继续推进:189/251 复测时 `origin/cfclub` 已至 **`f4d6bb152`**(bump,无 src 变更)——R227 起纳入基线 |
+
+> 历史记忆只作对照;本轮**全部本机/189/204/251 套件重新取证**;后端全量(510 类/4469 例)因 MySQL 3306 本环境不可达 + 预算约束**承采 R225/R224**(§2 声明),本轮对窗口内新功能契约单测**全部实测**。
+
+---
+
+## 1. 执行总览
+
+| 套件 | R226(本轮) | R225(上轮) | 漂移 |
+|---|---|---|---|
+| 基线 | `b6080f3b1`(窗口 **+16 提交**:S-cfc-381/383 通知分页+全局搜索、S-cfc-382 方案草稿、S-cfc-405 平台抽成、coupon-share T02、部署回执×4、bump×3、merge、R225 报告、研发汇报) | `9528c60db` | **有 src 变更**(cfc-backend 8 文件 +2469/-22;cfc-web 版本 bump;docs/API_REFERENCE 12 行契约登记更新) |
+| 浏览器 E2E · admin(**189 节点**) | 首跑 **4/5**(TC-A-U03 偶发红)→ **复测 5/5 EXIT=0**(1.6m) | 5/5 | ⚠️ 首跑 -1 → 复测持平;**B-226-1 观察** |
+| 浏览器 E2E · admin(本机) | **5/5**(1.2m,U03 单独复测 4.3s) | 5/5 | 零漂移 |
+| 浏览器 E2E · frontend(**204 节点**) | **6/6 EXIT=0**(58.4s,204 恢复在案) | 6/6(本机) | 零漂移(跨节点同 spec 可比) |
+| 浏览器 E2E · frontend(本机) | **6/6**(43.7s) | 6/6 | 零漂移 |
+| 浏览器 E2E · shop-api | **4/4**(8.3s) | 4/4 | 一致 |
+| 浏览器 E2E · health | **13/13**(4.7s) | 13/13 | 一致(B-218-3 未复发,观察 2/3) |
+| 浏览器 E2E · dx-bridge | **2 跳**(404,第 59 轮) | 2 跳 | 一致 |
+| 线上 API(点名 4 文件) | **33 过 / 0 红 / 3 跳**(47.2s) | 33/0/3 | **逐例零漂移** |
+| **新功能契约单测**(窗口 4 功能+coupon T02) | **53/53 全绿**(7 类:GlobalSearch×4 25 例 + NotificationCenterView 9 + PlanDraftSave 10 + CfRewardV2PlatformTake 9) | 无(功能后置合入) | **▸R226 新增实测** |
+| cfc-web Jest | **18 套 121 例:111 过 / 10 红**(红集 3 套 FamiliesReportEntry / Families.actionMenu / FamiliesPlanEntry) | 21 套 134 例:124/10(R225 口径含未入库 spec) | 红集同型(FAMILY-WB S1-1 契约预期红) |
+| cfc-frontend Jest | **承采 R225**(44 套 652 例 636/4/12;窗口零变更) | 44 套 652 例 | 零变更承采 |
+| 根级黑盒 Jest | **7 过 / 16 红 / 23**(5.6s,B-36 ECONNREFUSED 9082 承袭) | 7/16/23 | 一致 |
+| **langgraph@251** | **43 例 / 43 过 / 0 红**(448.73s,EXIT=0,AGNES 429 **清零**) | 43 例 / 37 过 / 6 红(429×6) | 🟢 **红集 6→0,显著改善** |
+| 后端 · 全量 | **承采 R225/R224**(510 类 / 4469 例 / 92.12%);本轮仅新功能契约单测实测 | 承采 R224 | 承采(声明于 §2) |
+| 后端 · test-compile | **BUILD SUCCESS**(EXIT=0) | SUCCESS | 通过 |
+
+**全站合计(本轮实测 + 承采)**:真实产品缺陷红 = **17 存量 + 0 新增**(后端 16 存量 + B-218-1 P0 守卫 1);lg 429 环境红 **清零**;浏览器 E2E 三节点合计 **23 过 + 2 跳**(admin 5×2 节点口径 + fe 6×2 节点口径 + shop 4 + health 13 + dx 2 跳)。
+
+**G12 闸门**:窗口 **src 有变更**(S-cfc-381/383 后端 + S-cfc-382/405 + coupon T02)且 API_REFERENCE 已登记新契约(§4.15/§4.61.7/4.59.10,S-cfc-383 由「不存在」→「已实现」)→ **本轮补齐用例台账** `tests/test-cases/2026-11-16-global-search-notification.md`(**16 条 TC**:全局搜索 9 + 消息中心 7,API 层已由 53 例契约单测全绿覆盖,浏览器入口 UI 用例待补 P2)。
+
+**测试结果有变化(R225 → R226)— 触发提交 + 通知研发**
+- 🟢 **lg 429 环境红清零**:43/43 全绿(R225 6 红 → R226 0 红),B-223-1 观察 3/3 **满足销号**(需连续 2 轮 43/43)。
+- 🟢 **窗口 4 个新功能契约单测 53/53 全绿**:全局搜索(SC-P-82)、通知分页+404(SC-P-78)、方案草稿(SC-P-81)、平台抽成(T03)均无契约缺陷。
+- 🟡 **B-226-1 观察中**:189 admin 首跑 U03 偶发红 1 次,复测 5/5 全绿 + 本机 5/5 → 非回归。
+- 🟡 **G12 补强**:新场景(SC-P-82/78)16 条 TC 入 `tests/test-cases/`,API 契约层已全绿,浏览器入口 UI 用例标记待补。
+
+---
+
+## 2. 项目画像(本轮视角)
+
+- **业务定位**:家庭教育 SaaS(五维能量 · 成长规划 · 测评订单 · 商城 · 健康报告解析 · 家庭工作台 · AI 教练),双端:小程序 H5 `cfc.iwintrue.com/frontend` + Web 管理端 `cfc.iwintrue.com/admin`。
+- **技术栈**:`cfc-backend` Spring Boot 2.7.18 / MyBatis-Plus / JDK 1.8(9082)· `cfc-web` Vue2 + Element UI(8082)· `cfc-frontend` uni-app 小程序(H5 预览)· `cfc-langgraph` FastAPI + LangGraph + ChromaDB(251 节点,production 为 ai.etotem.com.cn 等价部署)· `dan/danshop` 独立商城(8888)。
+- **本轮窗口 diff(`9528c60db..b6080f3b1`)**:32 文件 +2469/-22;其中 cfc-backend `src/main` 8 文件(UserNotificationController S-cfc-381、SearchController+GlobalSearchService S-cfc-383、GrowthPlanController/Service S-cfc-382、CfCommissionService+平台抽成 S-cfc-405、CouponShareService+schema S-cfc T02 等);cfc-web 版本 bump(package.json/CHANGELOG/.last_build_commit);docs/API_REFERENCE 12 行契约登记;另 +592 行 CouponShareClaimContractTest。
+- **测试资产现状**:后端测试源 517 文件;Playwright spec 80;Jest web 21/fe 46 套(版本口径);langgraph pytest 10 文件;用例台账 22→**23** 份(本轮 +global-search-notification 16 TC);用户场景 11 份(SC 244)。
+- **质量目标(用户口径)**:所有测试用例全部覆盖并通过对;用例覆盖全部 SRS 与用户场景(含异常流);SRS/场景变更时同步更新用例。
+- **本轮风险点**:① **B-226-1** 189 节点 U03 偶发(观察中);② B-218-1 P0 承袭;③ G11 CI 清单失真承袭;④ lg 429 历史上不稳定(本轮清零,需连续观察);⑤ 浏览器入口 UI 用例(搜索框/消息中心)待补。
+
+---
+
+## 三、20 类测试覆盖矩阵(本轮增量见标注「▸R226」)
+
+| # | 测试类型 | 层次 | 状态 | 证据 |
+|---|---|---|---|---|
+| 1 | 单元测试 | 功能层次 | **已发现** | 后端 517 源 test-compile SUCCESS(实测);web 21 套 134 例、fe 44 套 652 例(承采 R225/R224) |
+| 5 | 接口 API 测试 | 功能层次 | **已发现** | 线上点名 4 文件 33 过 3 跳;shop 4/4;health 13/13;**▸ 新功能契约单测 53/53(GlobalSearch/Notification/PlanDraft/PlatformTake/CouponShareClaim)** |
+| 6 | 系统/端到端 | 功能保障 | **已发现(实跑)** | 本机 28 过(admin 5 + fe 6 + shop 4 + health 13)+ 2 跳;189 admin 5;204 frontend 6 = **39 过 + 2 跳**(三节点口径) |
+| 10 | 回归测试 | 功能保障 | **已发现** | web/fe/浏览器/线上 API 逐例对照零漂移;**▸ 新功能合入后既有套件无回归** |
+| 12 | 性能测试 | 非功能 | **未发现(未实测)** | 无压测;`nonfunc-perf-compat` 7 例冒烟绿(承采 R224) |
+| 13 | 可靠性测试 | 非功能 | **部分已发现** | **▸ lg 429 清零 43/43**(B-223-1 观察 3/3 销号候选);health 全绿 |
+| 14 | 安全测试 | 非功能 | **部分已发现** | 匿名端点 401 契约(**▸ /api/search/global 401 探活**)、跨家庭越权过滤断言(▸ GlobalSearch 越权用例 25 例中覆盖)、XSS/IDOR 线上断言承采;无 SAST(未授权联网) |
+| 18 | QA 流程 | 度量与流程 | **部分已发现** | G12 台账补强;G11 CI 清单失真承袭 |
+| 20 | 全项目代码审查 | 度量与流程 | **部分已发现** | 本轮 16 提交已审(4 功能 + T02 + 回执/bump),未见注入风险;新增契约测试 +592 行质量良好 |
+
+> 1-4/7-9/11/15-17/19 与 R225 结论一致(存量/缺口/承采),不逐行重复。
+
+---
+
+## 四、覆盖缺口清单
+
+| 缺口 | 说明 | 优先级 | 责任人 | 闭环判据 |
+|---|---|---|---|---|
+| BDD 规格 | 全仓 `.feature` = 0,无行为规格 | P2 | 测试 | 新增用例转 BDD |
+| UAT 签署 | 无人工 UAT 记录(无人值守窗口) | P2 | 产品/测试 | 签署记录 |
+| 无障碍断言 | admin 修复无 axe/WCAG 断言 | P2 | 研发/测试 | 补自动化断言 |
+| **▸ 浏览器入口 UI 用例(全局搜索框 / 消息中心页)** | 新功能 API 契约层已 53/53 全绿,但小程序/管理端 UI 入口无浏览器用例 | P2 | 测试 | 补 playwright UI 用例(前置:小程序端 UI 已发布) |
+| **▸ B-226-1 观察** | 189 节点 admin U03 首跑偶发红 1 次(复测 5/5 + 本机 5/5) | P2 | 测试/运维 | 连续 2 轮 189 首跑全绿销号 |
+| **▸ B-223-1 销号** | lg 429 本轮清零(43/43),观察 3/3 | P1 | 测试 | 连续 2 轮 43/43 后由测试销号 |
+
+---
+
+## 五、域结论表
+
+| 域 | 结论 | 一句话 |
+|---|---|---|
+| 功能域 | **通过** | 全部既有功能零回归;窗口 4 新功能契约 53/53 全绿 |
+| 非功能域 | **部分通过(未实测压测)** | lg 429 清零;性能/安全未新增证据 |
+| AI 域(G7) | **43/43**(0 红) | 429 环境红清零,B-223-1 观察 3/3 |
+| 流程域 | **存在缺口** | G11 承袭;G12 台账已补新场景 |
+
+---
+
+## 六、五要素问题清单(新增/变化项)
+
+**问题 1(P2 观察项,B-226-1)189 admin E2E TC-A-U03 首跑偶发红**
+- ① 问题描述:189 节点 admin-desktop E2E 首跑 4/5,唯一失败 `TC-A-U03 未登录访问后台受保护路由被拦截到登录页`:URL 停留 `http://cfc.iwintrue.com/admin/` 且登录表单不可见(断言 `url.includes('/login') || loginVisible` false)。
+- ② 测试 bug 点:`tests/e2e-live/admin-live.spec.js:145`(TC-A-U03);失败附件 `.live-artifacts/admin-live-…-TC-A-U03-…/test-failed-1.png`(已拉取)。
+- ③ 最优修改方案:无需改 spec(本机同版 5/5、U03 单独 4.3s PASS、189 复测 5/5、生产 /admin/ HTTP 200/13ms)→ 判定节点时序偶发(页面跳转/渲染 2.5s 等待在 189 首跑时未满足);如复现可把 U03 等待容忍放大或加重试策略;连续 2 轮首跑全绿后销号。
+- ④ 修改目的:消除偶发噪声对回归判定的干扰,B-226-1 观察闭环。
+- ⑤ 闭环方式与通过标准:下一轮 189 首跑 admin 5/5(U03 绿)即销号;若连续 2 轮复现则升级为缺陷单。
+
+**问题 2(P2 覆盖缺口)新功能浏览器入口 UI 用例待补**
+- ① 问题描述:S-cfc-383 全局搜索、S-cfc-381 消息中心分页的 API 契约层已全绿(53/53),但小程序端入口(首页搜索框、消息中心 tab/列表/已读)无浏览器自动化用例。
+- ② 测试 bug 点:`tests/e2e-live/frontend-live.spec.js` 现仅 6 例游客浏览;无登录态 UI 用例(登录态凭据 MACHINE_JSON_PATH 未注入)。
+- ③ 最优修改方案:待小程序端 UI 发布后新增 `frontend` 登录态 UI 用例(search-entry / message-center pagination / read-404 提示),或先在 API 层补 `coupon-share-contract.spec.js` 式接口断言脚本消化 TC-GS/TC-NC。
+- ④ 修改目的:满足「用例覆盖全部 SRS 与用户场景」质量目标。
+- ⑤ 闭环方式与通过标准:TC-GS-01~09 / TC-NC-01~07 有自动化断言执行入口(API 层 53 例全绿 = 已闭环 API 层;UI 层补用例即全闭环)。
+
+**问题 3(P1 承袭)langgraph 429 环境红(本轮清零,观察 3/3)**
+- ① 问题描述:R225 43 例 6 红(`test_auto_tag`×2 + `test_intent`×4,AgnesAI 429 → 默认 chat 联动打红);**R226 43/43 全绿(448.73s)**,429 未触发。
+- ② 建议:251 保持 Token Plan 配额;研发将 429 由「静默兜底 chat」改为「显式失败可重试」以免疫未来配额波动;测试侧连续 2 轮 43/43 后销号 B-223-1。
+
+**问题 4(P0,承袭 B-218-1)@Resource Bean 撞名守卫红**:后端窗口变化仅新增功能(无守卫相关改动)→ 承袭 R225 结论(1/1 红,第 6 轮观察),复评不阻塞本轮(非本轮变更引入)。
+
+---
+
+## 七、门禁结论
+
+| 门禁 | 结论 | 依据 |
+|---|---|---|
+| G1 通过率 | **通过(有条件)** | 详见 R225/R224 口径;本轮可验证子集(实测套件)失败集与基线逐例一致 + 新功能 53/53 全绿 |
+| G3 浏览器 E2E | **通过** | 39 过 + 2 跳(本机 28 + 189 5 + 204 6;含新基线重跑) |
+| G4 可构建 | **通过** | test-compile BUILD SUCCESS(EXIT=0) |
+| G6 不回归 | **通过** | 全部既有套件逐例零漂移(189 首跑 U03 偶发 → 复测 5/5 澄清为非回归) |
+| G7 AI 域 | **通过** | 43/43(0 红),429 清零 |
+| G11 CI | **不通过(承袭)** | 清单失真,P1,第 27 轮 |
+| G12 SRS 同步 | **通过(补强后)** | 窗口 src 变更 + 契约登记更新 → 新场景已补 16 条 TC 台账,API 层 53 例全绿 |
+
+**裁决:有条件通过** —— 本轮无新增真实产品缺陷回归;窗口 4 新功能契约全绿;lg 429 清零。阻塞项为承袭 P0(B-218-1)与 G11(CI)。复评条件:① B-218-1 修复;② B-226-1 连续 2 轮首跑全绿销号;③ lg 429 连续 2 轮观察;④ 浏览器入口 UI 用例补全(P2)。
+
+---
+
+## 八、增量复验说明
+
+- 本轮窗口 **16 提交**:`2ceab5553`(coupon-share T02 592 行契约单测)、`0866580e9`(merge)、`672497587`(研发第 188 轮汇报)、`1838952f1`/`6cfc533fc`(部署回执)、`3438a195f`/`7f29b79fe`/`2e5ce8c61`(bump)、`96311452e`(S-cfc-405 平台抽成)、`3e024736d`(S-cfc-382 方案草稿)、`33e314cba`/`16c8aea5f`(部署回执)、`96ccd11e8`(R225 报告)、`8e92400e4`(S-cfc-383 全局搜索)、`b6080f3b1`(S-cfc-381 通知分页+404)。
+- 新功能契约单测全部在**最新基线 b6080f3b1** 隔离 worktree 实测 53/53 全绿(0.488s~3.191s 各 7 类)。
+- 三节点派发:189 admin(首跑 4/5 → 复测 5/5)、204 frontend(6/6)、251 langgraph(43/43,448.73s);节点均 `git reset --hard origin/cfclub` 后执行,spec 同版本可比。
+- R226 执行期间远端继续推进至 `f4d6bb152`(bump,无 src 变更)——R227 基线更新,不影响本轮结论。
+
+---
+
+## 附录 A:本轮命令(可复现)
+
+```bash
+# 基线(HTTP 通道,SSH 密钥不适用)
+git fetch http://git.iwintrue.com/liaoxg/cfc.git +refs/heads/cfclub:refs/remotes/origin/cfclub
+# 隔离 worktree
+git worktree add .worktrees/test-lead-R226 -b test-lead-R226 origin/cfclub
+# (PowerShell)3 个 node_modules Junction:tests / cfc-frontend / cfc-web
+
+# 三节点派发(每节点单任务,远程 opencode SHELL 通道)
+node .tdd/_dispatch_R226_189_admin.cjs      # admin-desktop → 首跑 4/5(U03 偶发)→ 复测 5/5
+node .tdd/_dispatch_R226_204_frontend.cjs   # frontend-mobile → 6/6 EXIT=0
+node .tdd/_dispatch_R226_251_lg.cjs         # lg pytest → 43/43,448.73s
+
+# 本机浏览器(串行)
+node node_modules/playwright/cli.js test -c playwright.config.live.js --project=admin-desktop   # 5/5(含 U03 单独 4.3s)
+node node_modules/playwright/cli.js test -c playwright.config.live.js --project=frontend-mobile  # 6/6
+node node_modules/playwright/cli.js test -c playwright.config.live.js --project=shop-api         # 4/4
+node node_modules/playwright/cli.js test -c playwright.config.health.js                          # 13/13
+node node_modules/playwright/cli.js test -c playwright.config.live.js --project=dx-bridge        # 2 跳
+
+# 线上 API 点名 4 文件(33 过 / 0 红 / 3 跳)
+node node_modules/playwright/cli.js test -c playwright.config.api.js tests/e2e/api/api-smoke.spec.js tests/e2e/api/dimension-energy-contract.spec.js tests/e2e/api/nonfunc-security.spec.js tests/e2e/api/nonfunc-perf-compat.spec.js
+
+# 后端(worktree)
+cd cfc-backend && mvn -o test-compile                                          # BUILD SUCCESS
+mvn -o surefire:test -Dtest='GlobalSearchQueryContractTest,GlobalSearchQueryEmptyResultContractTest,GlobalSearchQueryScP82RestContractTest,GlobalSearchScP82ContractTest,NotificationCenterViewContractTest,PlanDraftSaveContractTest,CfRewardV2PlatformTakeContractTest' -DfailIfNoTests=false
+# → Tests run: 53, Failures: 0, Errors: 0, Skipped: 0
+
+# Jest(worktree)
+cd cfc-web && node node_modules/jest/bin/jest.js --runInBand --silent          # 18 套 121 例 111 过/10 红(红集同型)
+cd tests && node node_modules/jest/bin/jest.js --runInBand --silent            # 根级 7/16/23(B-36 承袭)
+```
+
+## 附录 B:口径声明
+
+- 承采项仅限「后端全量 / cfc-frontend Jest」:后端全量因 MySQL 3306 不可达 + ~40min 超预算,且窗口后端变更已由 53 例新契约单测 + test-compile 覆盖;cfc-frontend 窗口零变更。
+- cfc-web Jest 口径差异:R225 记 21 套/134 例(含未入库 spec 的主区口径),本轮 worktree 干净口径 18 套/121 例(111 过/10 红);**红集 3 套(FamiliesReportEntry / Families.actionMenu / FamiliesPlanEntry)与 R225 同型**(FAMILY-WB S1-1 契约预期红),非新增回归。
+- langgraph 43/43 为实测(448.73s);429 环境红清零为真实改善(R225 日志已实证 429 → 默认 chat 为环境根因)。
+- 189 U03 首跑失败已逐一澄清(节点复测 5/5 + 本机 5/5 + 生产 200)→ 记 B-226-1 观察,不记为产品回归。
+- 未执行需联网的依赖漏洞扫描/压测(execute 档未授权);未启停服务、未改 `src/main`。

+ 307 - 0
docs/tdd/orchestration/report-test-2026-11-16-R227.md

@@ -0,0 +1,307 @@
+# 测试负责人工作汇报 R227(2026-11-16 06:05 GMT+8 · 自动化闭环)
+
+> 测试负责人:陆谨(软件测试专家团 · 测试架构师)|执行档:**review(离线白名单)** + 内网双节点浏览器 E2E(本机 + 189)+ langgraph 派 251
+> 静默无人值守,全程未提问;方案假设见 §2
+> 基线:`origin/cfclub` **`b08d823e8`**(本轮执行基线 = 远端最新,FF 合入 17 提交);对照 R226 执行基线 `9528c60db`
+> 窗口 **+32 提交**,含 **S-cfc-406 团队池建池 / S-cfc-409 旧体系废弃清理 / S-cfc-391 能量规则引擎 apply / S-cfc-410 分润 v2 端到端账目** 四个功能提交 → **有 `src/main` 变更(39 文件 +2399/−2391),触发 G12**
+
+## 0. 历史审查记录(对照,非本次结论依据)
+
+| 项 | 内容 |
+|---|---|
+| 上次审查 | **R226(2026-11-16 05:05)**,结论「不通过(有条件)」;基线 `9528c60db`;**后端全量为承采(未实跑)**;lg@251 **43/43 全绿**(B-223-1 观察 3/3) |
+| 本次 | **第 227 轮,非首次审查**;基线 `b08d823e8`;**后端由「承采」升级为全量实跑**(R226 未跑,本轮补上,`Total time: 01:05 h`) |
+| 遗留 → 本次状态 | **B-223-1(lg 429)→ ❌ 复发**:43 例 32 过 / 11 红,11 红全 `429`(观察归零,重置 1/3)|**B-218-1(P0 Bean 撞名)→ ❌ 未修**(`CoachRecommendService` 1/1 红,第 5 轮)|**B-208-1(189 DNS 落公网)→ 🟢 改善**:189 `/admin` 实跑 5/5 EXIT=0|**B-36(根级 16 红)→ 第 101 轮**|**B-DX-1(dx 2 跳)→ 第 60 轮**|**G11(CI 清单)→ 第 28 轮**|**B-218-3(线上 502)→ 观察 3/3 达标,可销号** |
+| 本次新增 | **B-227-1(P0 鉴权)** 三个私有接口匿名返回 200;**B-227-2(P1 度量)** G8 探针集未随接口增长;**B-227-3(P1 环境)** 189 节点 HEAD 落后 5 提交;**B-227-4(P1 工具)** 251 pytest summary 后进程不退出(第 23 轮);**B-227-5(P1 负债,已自处置)** S-cfc-409 删码后遗留 **9 个僵尸契约类 / 89 例假红**,本轮退役 6 类 61 例并新增下线守卫 |
+| 窗口后置 | 收尾二次 fetch 核验:`origin/cfclub` 仍为 `b08d823e8`,跑测期间无新提交 |
+
+---
+
+## 1. 执行总览
+
+| 套件 | R227(本轮·**全实测**) | R226 | 漂移 |
+|---|---|---|---|
+| 基线 | **`b08d823e8`**(+32 提交:4 功能 + 部署回执×5 + bump×7 + 研发汇报×3 + R226 报告) | `b6080f3b1` | **有 src/main 变更** |
+| **后端 · 全量(实跑)** | **515 类 / 4507 例 / 4140 过 / 352F+11E=363 红 / 4 跳 = 91.86%**(`Total time: 01:05 h`,515/515 surefire XML,编译 2216 主源 0 错) | **承采** | **▸本轮首次对 4 个新功能做全量回归** |
+| 后端 · 退役 61 例僵尸测试后口径 | **510 类 / 4451 例 / 4145 过 / 302 红 / 4 跳 = 93.13%**(剔契约前瞻 257 → **98.83%**) | — | ▸口径修正,见 §7 |
+| 后端 · test-compile | **SUCCESS**(03:16 min,退役后复验) | SUCCESS | 通过 |
+| 浏览器 · admin(本机) | **5/5** | 5/5 | 零漂移 |
+| 浏览器 · admin(**189**) | **5/5 EXIT=0**(1.3m,spec blob `4703d73fb` = 本机) | 5/5 | 零漂移(节点 HEAD 滞后,见 B-227-3) |
+| 浏览器 · frontend(本机) | **6/6** | 6/6 | 零漂移 |
+| 浏览器 · shop-api | **4/4** | 4/4 | 零漂移 |
+| 浏览器 · health | **13/13**(6.8s,匿名全 401) | 13/13 | 零漂移(B-218-3 观察 3/3) |
+| 浏览器 · dx-bridge | **2 跳**(404,第 60 轮) | 2 跳 | 一致 |
+| **浏览器合计** | **33 过 + 2 跳**(本机 28 + 189 5) | 33+2 跳 | 零漂移 |
+| 线上 API(点名 4 文件) | **33 过 / 0 红 / 3 跳**(36 例,47.2s) | 33/0/3 | **逐例零漂移** |
+| cfc-web Jest | **21 套 134 例:124 过 / 10 红**(3 套:FamiliesReportEntry / Families.actionMenu / FamiliesPlanEntry) | 18 套 121 例 111/10 | 红集同型(FAMILY-WB S1-1 契约预期红) |
+| cfc-frontend Jest | **46 套 660 例:644 过 / 4 红 / 12 跳**(AC-R1、AC-R2、AC-2 RED-A7、diet viewKey) | 44 套 652 例 | **逐例零漂移** |
+| 根级黑盒 Jest | **7 过 / 16 红 / 23**(6.5s,全 `ECONNREFUSED 9082`) | 7/16/23 | 一致(B-36 第 101 轮) |
+| **langgraph@251** | **43 例 / 32 过 / 11 红**(121.88s,`EXIT=124`) | 43/43 | 🔴 **11 红全 429 环境型** |
+| 匿名探针(G8) | 白名单外 5/6 = 401(第 6 个 404 路径不存在);**新接口 3/3 = 200 ❌** | 6/6=401 | ⚠️ 见 B-227-1 |
+
+**全站合计**:**5438 例 / 5013 过 / 404 红 / 21 跳 = 92.18%**(剔 skip 92.54%);**剔契约前瞻 257 后 = 98.86%;真实缺陷红 45(存量 16 + 删码遗留 28 + 守卫 1),窗口新增真实缺陷 0**。
+**退役 61 例僵尸后口径**:5382 例 / 5018 过 / 343 红 / 21 跳 = **93.23%**。
+
+---
+
+## 2. 执行档与方案假设(无人值守自确认,声明替代提问)
+
+| 项 | 取值 | 依据 |
+|---|---|---|
+| 执行档 | **review(离线白名单)** | 定时自动化预授权;**未装依赖、未联网 SCA/压测、未启停服务、未改 `src/main`、未在远端节点 `reset --hard`** |
+| 后端全量 | **实跑**(不承采) | R226 因「MySQL 3306 不可达 + 预算」承采;本轮探测 251:3306 可达 → 升级实测 |
+| 浏览器节点 | 本机(admin/fe/shop/health/dx)+ 189(admin),**每节点单任务串行** | 用户约束 |
+| langgraph | 只派 251 | 用户约束 |
+| 联网授权 | 未申请、未执行 | 压测/SCA 属 execute 档 |
+| 结论口径 | 契约前瞻红 / 真实缺陷红 / 僵尸红 **三分列** | 避免把 TDD 前瞻红、删码遗留红混算成产品缺陷 |
+
+---
+
+## 3. 项目画像(窗口增量)
+
+- **定位**:浠艾福(XAF)家庭教育五维能量平台;窗口业务重心 = **分润 v2 体系收敛**(团队池建池 406 / 平台抽成 410 / 旧分润体系下线 409)+ **能量规则引擎实时触达 391**。
+- **技术栈**:Spring Boot 2.7.18 + MyBatis-Plus + Java 8(9082)|uni-app 小程序(Vue 2)|Vue 2 + Element UI(8082)|FastAPI + LangGraph + ChromaDB(9000 / 测试节点 251)。
+- **关键路径变更**:
+  - `S-cfc-409 removeLegacy`:**删 6 生产类**(`ProfitPoolService`/`TeamProfitService`/`TeamProfitFlowService`/`StarScoreCalculator`/`TeamProfitCronTask`/`TeamProfitAdminController`)+ `TeamStarController`;**5 个订单服务移除结算调用块**;`DatabaseInitializer` −131 → **资金路径 + 定时任务下线,风险最高**。
+  - `S-cfc-410 e2eExample`:新增 `CfTeamPoolShare` 实体 + `CfCommissionService` +264(四入口)+ `TeamShareConfigService` +130(T% 解析)→ **新增资金记账路径**。
+  - `S-cfc-391 ruleEngine.apply`:`EnergyRuleEngine` +179 `apply()`(归因→写 EnergyLog/EnergyBalance)→ **能量账本写路径**。
+- **质量目标(用户口径)**:所有用例覆盖并通过;覆盖全部 SRS 与用户场景(含异常流);SRS/场景变更时同步更新用例。
+- **本轮风险点**:① 409 删码残留引用(`test-compile` 0 错已证伪);② **409 删码遗留僵尸测试 89 例假红**(本轮处置 61 例);③ 资金新入口仅契约层覆盖,行为层(金额/幂等/残差)无自动化;④ lg 429 复发;⑤ CI 清单第 28 轮失真。
+
+---
+
+## 4. 20 类测试覆盖矩阵
+
+| # | 测试类型 | 层次 | 状态 | 证据 |
+|---|---|---|---|---|
+| 1 | 单元测试 | 功能层次 | **已发现** | 后端 **515 类 / 4507 例实跑**(`Total time 01:05 h`);web 21 套 134 例;fe 46 套 660 例 |
+| 2 | 覆盖率统计 | 功能层次 | **部分已发现** | 无 JaCoCo;代理口径 373 控制器 / 2408 handler / 515 测试类 |
+| 3 | 变异测试 | 功能层次 | **未发现** | 无 PIT/Stryker;历史已多次命中「存在性断言假绿」,故列入 G-227-4 |
+| 4 | 静态代码分析 | 功能层次 | **部分已发现** | 编译期门禁(`test-compile` 0 错 / 2216 主源);无 SpotBugs/PMD |
+| 5 | 接口 API 测试 | 功能层次 | **已发现** | 线上 4 文件 33 过 3 跳;shop 4/4;health 13/13;**窗口新功能契约 74/74 全绿**(TeamPoolCreate 13 / RewardV2E2E 14 / RemoveLegacy 6 / RuleEngineApply 17 / CouponShareClaim 24) |
+| 6 | 系统/端到端 | 功能保障 | **已发现(实跑)** | 本机 28 过 + 2 跳 + 189 admin 5 过 |
+| 7 | 验收测试(UAT) | 功能保障 | **未发现** | 无人工签署(无人值守窗口) |
+| 8 | BDD 规格 | 功能保障 | **未发现** | 全仓 `.feature` = 0 |
+| 9 | 冒烟测试 | 功能保障 | **已发现** | `api-smoke` / admin+fe 主链路 / health 13 例 |
+| 10 | 回归测试 | 功能保障 | **已发现** | web/fe/浏览器/API **逐例零漂移**;后端全量给出新基线(R226 无基线) |
+| 11 | 探索性测试 | 功能保障 | **部分已发现** | 本轮手工探针:**8 端点匿名鉴权**(命中 B-227-1)+ **4 表 DDL 双源核对**(`DatabaseInitializer:159` 加载 `schema.sql`,风险可控) |
+| 12 | 性能测试 | 非功能 | **未发现(未实测)** | 无压测(execute 档未授权);后端慢类 TOP5 `AdminFamilyOverview 355.8s / DailyOverview 247.3s / UserServiceFamilyNameLink 183.8s / GuidePackage 172.4s / GuideApplication 156.7s` |
+| 13 | 可靠性测试 | 非功能 | **部分已发现** | lg 服务可用但上游 429;浏览器双节点稳定;后端 515/515 XML 无沉默 |
+| 14 | 安全测试 | 非功能 | **部分已发现** | `nonfunc-security` 9 例绿;**▸ 新发现匿名 200 × 3(B-227-1)**;无 SAST/SCA(未授权) |
+| 15 | 兼容性测试 | 非功能 | **部分已发现** | 单 Chromium,无多浏览器矩阵 |
+| 16 | 可用性测试 | 非功能 | **未发现** | 无真实用户可用性数据 |
+| 17 | 无障碍测试 | 非功能 | **未发现** | 无 axe/WCAG 断言 |
+| 18 | QA 流程 | 度量与流程 | **部分已发现** | G12 台账补 2 份(17 + 24 = **41 TC**);**僵尸测试退役机制**首次建立(守卫类);G11 第 28 轮 |
+| 19 | 质量指标 | 度量与流程 | **部分已发现** | TC 唯一编号 554 / 台账行 1099 / 台账文件 26 / SC 引用 160 |
+| 20 | 全项目代码审查 | 度量与流程 | **部分已发现** | 审 32 提交 / 39 个 `src/main` 文件;重点 409 删码残留(0 残留引用)与 410 资金路径;未见提示注入 |
+
+---
+
+## 5. 覆盖缺口清单
+
+| # | 缺口 | 现状 | 风险 | 建议测试设计 | 优先级 | 闭环方式 |
+|---|---|---|---|---|---|---|
+| G-227-1 | **资金行为层无自动化** | 410/406 仅契约层(方法存在性/常量/依赖链),金额/幂等/残差/上限无断言 | 资金错账不可回滚 | 按 `2026-11-16-rewardv2-energy-legacy.md` TC-R2-01~10 在集成环境补行为用例 | **P0** | 集成环境恢复后补跑,固定夹具断言金额 |
+| G-227-2 | 409 删码**路由/调度负向断言** | 旧路径 404、旧 Bean 缺席无自动化 | 旧体系被误 revert 无人知 | 已建 `LegacyProfitSystemRemovedGuardTest`(7 类缺席 + 3 保留类在场 + 4 表 DDL 在场) | P1 | ✅ **本轮已闭环**(5/5 绿) |
+| G-227-3 | **G8 匿名探针集固定 6 端点** | 新接口未纳入 | 鉴权退化不可见(本轮实证 B-227-1) | 探针集由 `WebConfig` 白名单 + 控制器清单**动态生成**,白名单外一律期望 401 | **P0** | 新增 `auth-coverage` 用例 |
+| G-227-4 | 变异测试为空 | 无 PIT | 假绿不可识别 | 对 `CfCommissionService`/`EnergyRuleEngine` 试点 PIT | P1 | mutation score ≥60% |
+| G-227-5 | 覆盖率无门禁 | 无 JaCoCo | 覆盖变化不可观测 | 接入 JaCoCo 仅采集不阻断 | P1 | CI 产出 `jacoco.xml` |
+| G-227-6 | BDD/UAT/无障碍 全空 | `.feature`=0、无签署、无 axe | 需求→行为可追溯性弱 | 3 条核心 SC 转 Gherkin;admin 关键页接 axe | P2 | 先落 feature |
+| G-227-7 | 性能/SCA 未实测 | 需联网授权 | 容量与供应链未知 | 下轮单独申请 execute 档 | P2 | 授权后跑压测 + `dependency-check` |
+| G-227-8 | CI 清单第 28 轮失真 | 33 类 vs 实测红 66 类 → **漏拦 59 / 陈旧 26** | 流水线必红或漏拦 | 按附录 C 精确类名重写;建议由 surefire XML 自动生成 | **P1** | 更新 `.gitlab-ci.yml` |
+| G-227-9 | **3 个部分僵尸类未处置** | `TeamProfitAdminManageContractTest` 5F/20、`TeamStarMyViewContractTest` 20F/24、`TeamProfitHookContractTest` 3F/7 → **28 例假红** | 噪声持续淹没真实回归 | 外科式删除「断言已删类」的用例,保留存活断言;或拆分为 `*RemovedGuard` + 存活子集 | **P1** | 28 例归零 |
+
+---
+
+## 6. 五要素问题清单
+
+### 问题 1(P0 · 安全/契约)三个私有接口匿名访问返回 200
+
+1. **问题描述**:线上匿名(无 `Authorization`)`POST /api/notification/list` → `200 {"code":200,"data":[]}`;`POST /api/notification/read` → `200 {"code":200,"data":true}`;`POST /api/search/global` → `200 {"code":200,"data":{reports:[],plans:[],tasks:[],products:[]}}`。三者均应按「SEC-20261031-01 鉴权统一」返回 401。
+2. **测试 bug 点**:`cfc-backend/src/main/java/com/etotem/cfc/config/JwtInterceptor.java:226-243`(无 token 且非 `LOGIN_REQUIRED_PATHS` → `setAnonymousUser` 放行,userId=-1)+ `cfc-backend/src/main/java/com/etotem/cfc/controller/UserNotificationController.java:34,65`(以 userId=-1 查询/更新 → 空集与 `true` 假成功);对应缺口用例 `tests/e2e/api/nonfunc-security.spec.js`(未覆盖这三条路径)。
+3. **最优修改方案**:把 `/api/notification/list`、`/api/notification/read`、`/api/search/global` 加入 `JwtInterceptor.LOGIN_REQUIRED_PATHS`;`read` 再加「id 归属校验」(非本人 → 404/403)。
+4. **修改目的**:消除「匿名假成功」口径漂移,使私有数据面与既有 6 端点 401 契约一致,避免后续把 userId=-1 的空结果误当业务正常。
+5. **能否闭环**:能。复测方式:匿名 `curl` 三端点期望 401;已登录用户调用行为不变(回归 `NotificationCenterViewContractTest` 9 例 + `GlobalSearchScP82ContractTest` 5 例应保持全绿);通过标准 = 匿名 3/3 = 401 且契约类 14/14 绿。
+
+### 问题 2(P1 · 负债,本轮已自处置)S-cfc-409 删码遗留 9 个僵尸契约类 / 89 例假红
+
+1. **问题描述**:全量实跑 363 红中,**89 例来自 9 个仍断言「已删除生产类」的契约测试**(`ProfitPoolService`/`TeamProfitService`/`TeamStarController`/`StarScoreCalculator`/`TeamProfitCronTask` 等)。这些类用 `ContractReflect.requireClass()` 反射加载 → 编译期通过、运行期 `ClassNotFoundException`,每轮稳定产假红。
+2. **测试 bug 点**:`cfc-backend/src/test/java/com/etotem/cfc/service/{ProfitPoolOrderContractRedTest,StarScoreCalculatorContractRedTest,TeamAwardRecordContractRedTest,TeamShareRecordEightShareContractRedTest}.java`(**已删除**)、`.../unit/{TeamProfitCronContractTest,TeamStarMultiplierContractTest}.java`(**已删除**);残留 `TeamProfitAdminManageContractTest:?`(5F)、`TeamStarMyViewContractTest`(20F)、`TeamProfitHookContractTest`(3F)。
+3. **最优修改方案**:① 已删除 6 个 100% 红类(61 例);② 新增 `cfc-backend/src/test/java/com/etotem/cfc/unit/LegacyProfitSystemRemovedGuardTest.java`(5 例)把「断言旧类存在」翻转为「断言旧类缺席 + 保留类在场 + `schema.sql` 仍声明 4 表」;③ 剩余 3 个部分红类做外科式裁剪(G-227-9)。
+4. **修改目的**:把假红从 363 降到 302,使「真实缺陷红 45」在报告里可被看见;同时保留「旧体系被误 revert 即报警」的回归能力(比直接删除更安全)。
+5. **能否闭环**:能。已闭环部分:`mvn -o test-compile` **BUILD SUCCESS**(03:16)+ 守卫 **5/5 绿**(2.282s);剩余 28 例需 G-227-9 处置,闭环判据 = 后端红集降至 274 且 `LegacyProfitSystemRemovedGuardTest` 保持绿。
+
+### 问题 3(P1 · 流程/度量)G8 匿名探针集固定 6 端点,未随接口增长
+
+1. **问题描述**:R209~R226 每轮报「匿名 6 端点 6/6 = 401」,探针集是硬编码 6 条;本轮把探针扩到 8 条即命中 3 个匿名 200(问题 1)。即「G8 通过」长期是**样本选择偏差**下的通过。
+2. **测试 bug 点**:报告口径(非代码)——历轮 `report-test-*.md` 的 G8 行;`tests/e2e/api/nonfunc-security.spec.js` 仅覆盖 8 个端点,不含 notification/search。
+3. **最优修改方案**:新增 `tests/e2e/api/auth-coverage.spec.js`:从 `WebConfig.excludePathPatterns` 解析白名单,其余控制器路径一律断言 401/403;清单变更时用例数自动变化。
+4. **修改目的**:把「抽样通过」变成「全量通过」,使新增接口无法绕过鉴权门。
+5. **能否闭环**:能。通过标准 = 探针覆盖 `@PostMapping` 全量路径、白名单外 0 个 200;首次跑预计产出 3 红(对应问题 1),随问题 1 修复转绿。
+
+### 问题 4(P1 · 环境)189 节点代码滞后 5 提交
+
+1. **问题描述**:189 节点 `HEAD=de3aa5e2e`,`origin/cfclub=b08d823e8`,落后含 406/409/391 三个功能提交;`DIRTY=171`(节点有大量未提交改动)。
+2. **测试 bug 点**:`tests/e2e-live/admin-live.spec.js`(spec blob `4703d73fb` 与本机一致 → 用例本身可比,但**被测代码是旧版**)。
+3. **最优修改方案**:清理节点脏改动并同步到 `origin/cfclub`;部署回执中增加「节点 HEAD = 远端头」核对项。本轮**未执行 `reset --hard`**(避免破坏节点上他人工作),只按现 HEAD 取证并如实标注。
+4. **修改目的**:保证跨节点 E2E 证明的是「同一份代码」,否则「189 绿」只证明旧版本绿。
+5. **能否闭环**:能。通过标准 = 节点 `git rev-parse HEAD` == 远端头 且 `DIRTY=0`,连续 2 轮。
+
+### 问题 5(P1 · 工具)251 pytest 打印 summary 后进程不退出(第 23 轮)
+
+1. **问题描述**:251 上 pytest 在 **121.88s** 已输出 `11 failed, 32 passed`,进程仍存活至 520s 被 `timeout -k 10` 杀掉 → `EXIT=124`;`EXIT=` 之后的汇总段能正常打印(说明不是 shell 问题,而是进程挂死)。
+2. **测试 bug 点**:`cfc-langgraph/tests/conftest.py`(无 session-finish 强制退出)+ 产品侧 `JavaClient` 未 `aclose()`(历史日志 `coroutine 'JavaClient._get_client' was never awaited`)。
+3. **最优修改方案**:① 产品侧在应用 shutdown 事件 `await client.aclose()`;② 测试侧 `pytest_sessionfinish` 后 `os._exit(0)`(或 `-p no:cacheprovider` + `--timeout` 组合);③ 派发器已有 `timeout -k 10`,保留。
+4. **修改目的**:让 CI 能区分「用例失败」与「进程挂死」,避免 `EXIT=124` 被误读为超时失败。
+5. **能否闭环**:能。通过标准 = 连续 2 轮 `EXIT=0` 且 summary 行存在。
+
+### 问题 6(P2 · 环境)langgraph 11 红全为上游 429
+
+1. **问题描述**:43 例中 11 红,日志 `RateLimitError 429 - You've reached the API rate limit for free users`(`middleware.py:113`),含「today's text quota used up…retry after 22:09:23」。R226 曾 43/43 全绿,本轮配额耗尽 → B-223-1 观察重置 1/3。
+2. **测试 bug 点**:`cfc-langgraph/tests/test_auto_tag.py`(5 例)、`test_intent.py`(4 例)、`test_analyze.py`(2 例)直接依赖真实 LLM。
+3. **最优修改方案**:为测试环境配置独立/付费额度;同时给 LLM 依赖用例打 `@pytest.mark.llm`,CI 默认 `-m "not llm"`,夜间单独跑。
+4. **修改目的**:把「环境配额」与「产品缺陷」彻底分开,避免每轮红集随配额波动。
+5. **能否闭环**:能。通过标准 = 默认档 32/32 绿 + llm 档另行统计。
+
+### 问题 7(P1 · 度量)CI `BACKEND_OBSERVED_CLASSES` 第 28 轮失真
+
+1. **问题描述**:`.gitlab-ci.yml:61` 清单 33 类,本轮实测红类 **66** → **漏拦 59 类**(含真实缺陷 `UserServiceWechatLoginTest`、`WebConfigGrowthExcludeRemovedTest`、`ResourceBeanNameCollisionGuardTest`)+ **陈旧 26 类**(已绿仍排除)。
+2. **测试 bug 点**:`.gitlab-ci.yml:61` 的 `BACKEND_OBSERVED_CLASSES` 变量。
+3. **最优修改方案**:由上轮 surefire XML 自动生成清单(`_r224_agg.cjs` 可扩展);或给契约前瞻类打 `@Tag("forward-contract")` 后用 `-Dgroups` 排除,取代类名白名单。
+4. **修改目的**:让 `backend-blocking-junit` 真正「红即拦」,而不是被 26 个陈旧类拖成必红、同时漏掉 59 个真红。
+5. **能否闭环**:能。通过标准 = 清单与实测红集双向差集均为 0(或仅剩 `@Tag` 机制)。
+
+### 问题 8(P0 承袭 · 未修)`CoachRecommendService` `@Resource` Bean 名撞名
+
+1. **问题描述**:`ResourceBeanNameCollisionGuardTest` 1/1 红,实测违规 1 处:`CoachRecommendService` 的 `@Resource FamilyMemberDimensionBaseScoreService dimensionScoreService` 字段名命中 Bean「dimensionScoreService」(类型 `DimensionScoreService`)→ 运行期 `BeanNotOfRequiredTypeException` 阻断上下文启动。R203 B-203-1/2 同类,S-cfc-351 新代码复发,**已第 5 轮未修**。
+2. **测试 bug 点**:`cfc-backend/src/main/java/com/etotem/cfc/service/CoachRecommendService.java:71-72`(守卫用例 `ResourceBeanNameCollisionGuardTest.java:192`)。
+3. **最优修改方案**:字段改名 `familyMemberDimensionBaseScoreService`,或显式 `@Resource(name="familyMemberDimensionBaseScoreService")`。
+4. **修改目的**:解除上下文启动级阻断(会让所有 `@SpringBootTest` 不可判定)。
+5. **能否闭环**:能。通过标准 = 守卫 1/1 绿 + 该 Service 相关类可正常加载上下文。
+6. **附注(度量)**:该守卫单例耗时 **210.4s**(反射扫描全类路径),建议加类名缓存或用 ArchUnit 替代,否则每次全量多 3.5 分钟。
+
+### 问题 9(P2 · 测试资产)web Jest 红集与未入库 spec 口径混用
+
+1. **问题描述**:主工作区 21 套 134 例(含 3 个未入库 spec,+13 例),R226 worktree 干净口径 18 套 121 例;两者红集相同但例数不同,历轮报告口径来回切换(B-208-5 第 6 轮)。
+2. **测试 bug 点**:`cfc-web/src/__tests__/api/familyWorkbench.api.test.js`、`src/__tests__/views/Families.familyWorkbench.spec.js`、`src/__tests__/views/FamilyWorkbench.contract.spec.js`(均未入库)。
+3. **最优修改方案**:入库这 3 个 spec(或删除);报告固定采用「主工作区口径」,并在附录标注是否含未入库资产。
+4. **修改目的**:让 web 门禁例数可复现。
+5. **能否闭环**:能。通过标准 = 连续 2 轮例数一致且 `git status` 无未入库 spec。
+
+---
+
+## 7. 域结论表
+
+| 审查维度 | 负责专家 | 结论 | 关键证据 |
+|---|---|---|---|
+| 单元·组件级 | 苏雅 | **不通过** | 515 类 / 4507 例实跑,363 红 = 契约前瞻 257 + 存量 16 + 删码遗留 28 + 守卫 1 + 僵尸 61;**窗口新功能契约 74/74 全绿** |
+| 集成·接口级 | 柯砚 | **有条件通过** | 线上 API 33/0/3 零漂移;409 删码后 `test-compile` 0 错(无残留引用);**匿名 200 × 3 = 接口鉴权契约缺陷** |
+| 系统·验收级 | 白樾 | **有条件通过** | 本机 28 过 + 2 跳 + 189 admin 5 过;无 UAT 签署、无 BDD |
+| 测试保障级 | 闻朔 | **有条件通过** | 冒烟/回归齐备且零漂移;**G8 探针集样本偏差(问题 3)**;无探索性测试章程 |
+| 性能·可靠性 | 骆骋 | **未实测** | 压测未授权;后端慢类 TOP5 合计 ≈18.3 分钟(`AdminFamilyOverview 355.8s` 为单类最慢) |
+| 安全 | 关屿 | **不通过** | **匿名 200 × 3(P0)**;`nonfunc-security` 9 例绿;无 SAST/SCA(未授权) |
+| 兼容·体验 | 阮清 | **部分未实测** | 单 Chromium;无 axe/WCAG;无真实用户可用性数据 |
+| 流程·度量·代码 | 何序 | **不通过** | G11 漏拦 59 / 陈旧 26;变异与覆盖率门禁缺失;**僵尸测试负债 89 例(已处置 61)**;本轮 32 提交代码审未见提示注入 |
+
+---
+
+## 8. 门禁结论
+
+| 门禁 | 结论 | 依据 |
+|---|---|---|
+| **G1 通过率** | ⚠️ **有条件** | 全量 91.86%(as-run)→ 退役僵尸后 **93.13%**;**剔 257 契约前瞻 = 98.83%**;真实缺陷红 45 |
+| **G2 真实缺陷红** | ❌ **不通过** | **45**(存量 16 第 37 次零漂移 + 删码遗留 28 + B-218-1 守卫 1);**窗口新增真实缺陷 0** |
+| **G3 前端 Jest** | ⚠️ **有条件** | web 124/10(3 套 FAMILY-WB S1-1 契约预期红,与 R226 同型);fe 644/4/12(4 例逐例零漂移) |
+| **G4 可构建** | ✅ **通过** | `mvn -o test-compile` **SUCCESS**(2216 主源 0 错,退役后复验 03:16) |
+| **G5 全类可判** | ✅ **通过** | **515/515** surefire XML 无沉默、无 dump |
+| **G6 不回归** | ✅ **通过** | web/fe/浏览器/线上 API **逐例零漂移**;后端存量 16 例与 R224 逐类逐例一致(零漂移第 **37** 次) |
+| **G7 AI 域** | ❌ **不通过** | lg 32/43(11 红全 429 环境型;B-223-1 观察重置 1/3) |
+| **G8 鉴权契约** | ❌ **不通过** | 白名单外 5/6 = 401;**新接口 3/3 = 200(P0)** |
+| **G9 覆盖率** | ⚠️ **部分** | 无 JaCoCo;代理 373 控制器 / 2408 handler / 515 测试类 |
+| **G10 节点覆盖** | ✅ **通过** | 本机(28 过 + 2 跳)+ 189(admin 5 过)+ 251(lg 43 例) |
+| **G11 CI 门禁** | ❌ **不通过** | 清单 33 vs 实测红 66 → **漏拦 59 / 陈旧 26**(第 28 轮) |
+| **G12 SRS 同步** | ✅ **通过** | 窗口 `specs/` 零文本变更、`API_REFERENCE` 仅 notification/search 两节(R226 已登记);本轮补台账 **2 份 / 41 TC**(teamshare 17 + rewardv2/energy/legacy 24)覆盖 4 个功能提交 |
+| **G13 零漂移** | ✅ **通过** | 存量真实缺陷 16 例逐类逐例一致(第 **37** 次) |
+| **G14 场景映射** | ⚠️ **部分** | specs SC 总数 **152** / 台账引用 **160**(唯一)→ 用例层覆盖 152/152 场景标签可达,但**行为级可执行映射**仍约 60% |
+
+### 裁决:**不通过**
+
+**阻塞项(按优先级)**:
+1. **B-227-1 / 问题 1(P0 安全)**:3 个私有接口匿名 200 —— 需研发加入 `LOGIN_REQUIRED_PATHS`。
+2. **B-218-1(P0 承袭)**:`CoachRecommendService` Bean 撞名,第 5 轮未修,阻断上下文级用例。
+3. **G-227-1(P0 资金)**:410/406 资金行为层零断言。
+
+**复评条件**:① 问题 1 修复后匿名 3/3 = 401 且契约类 14/14 绿;② 问题 8 守卫转绿;③ 问题 2 剩余 28 例僵尸归零(后端红降至 274);④ 问题 7 CI 清单双向差集归零;⑤ lg 429 连续 2 轮不复发(观察 1/3 起算)。
+
+**为何不是「有条件通过」**:G2/G7/G8/G11 四项 ❌ 同时存在,且其中两项为 P0(鉴权缺口 + 上下文阻断),按门禁规则不得放宽。
+
+---
+
+## 附录 A:本轮命令(可复现)
+
+```bash
+# 基线(HTTP 通道;SSH publickey 长期失效)
+git fetch http://git.iwintrue.com/liaoxg/cfc.git cfclub && git merge --ff-only FETCH_HEAD    # → b08d823e8
+
+# 后端全量(JDK 1.8.0_25 / mvn 3.9.9 / 离线)
+cd cfc-backend && mvn -o -B clean test          # 515 类 / 4507 例 / 363 红 / Total time 01:05 h
+
+# 退役僵尸测试后复验
+git rm <6 个 100% 红僵尸类>
+cd cfc-backend && mvn -o -B test-compile        # BUILD SUCCESS 03:16
+mvn -o -B surefire:test -Dtest='LegacyProfitSystemRemovedGuardTest'   # 5/5 绿 2.282s
+
+# 浏览器(每节点单任务串行)
+cd tests && node node_modules/@playwright/test/cli.js test -c playwright.config.live.js --output=../_r227_browser_live   # 15 过 + 2 跳
+cd tests && node node_modules/@playwright/test/cli.js test -c playwright.config.health.js --output=../_r227_browser_health # 13/13
+node .tdd/_dispatch_R228_189_admin.cjs          # 189 admin 5/5 EXIT=0(HEAD de3aa5e2e / DIRTY=171 / spec blob 4703d73fb)
+
+# 线上 API 点名 4 文件
+cd tests && node node_modules/@playwright/test/cli.js test -c playwright.config.api.js \
+  tests/e2e/api/api-smoke.spec.js tests/e2e/api/dimension-energy-contract.spec.js \
+  tests/e2e/api/nonfunc-security.spec.js tests/e2e/api/nonfunc-perf-compat.spec.js   # 33 过 / 0 红 / 3 跳
+
+# Jest
+cd cfc-web && node node_modules/jest/bin/jest.js --ci --silent        # 21 套 134 例 124/10
+cd cfc-frontend && node node_modules/jest/bin/jest.js --ci --silent   # 46 套 660 例 644/4/12
+node tests/node_modules/jest/bin/jest.js -c tests/jest.config.js      # 23 例 7/16
+
+# langgraph@251(opencode /api/shell,只读,不 reset 不推)
+node .tdd/_dispatch_R228_251_lg.cjs              # 43 例 32 过 11 红 121.88s;EXIT=124
+
+# 匿名鉴权探针
+for p in /api/mind/overview /api/energy/overview /api/health/plan/list /api/admin/families \
+         /api/huawei-health/status /api/search/global /api/notification/list /api/notification/read; do
+  curl -s -o /dev/null -w "$p %{http_code}\n" -X POST -H 'Content-Type: application/json' -d '{}' "http://cfc.iwintrue.com$p"; done
+```
+
+## 附录 B:口径声明
+
+- **后端全量为本轮实测**(R226 为承采):`515 类 / 4507 例 / 4140 过 / 363 红(352F+11E) / 4 跳`,`Total time 01:05 h`,515/515 XML。**退役 61 例僵尸后的 510 类 / 4451 例 / 302 红为口径修正值**(由「删除 6 个 100% 红类 + 新增 5 例守卫」推导,并以 `test-compile SUCCESS` + 守卫 5/5 绿佐证),**未重跑全量**,故不声称「重跑后 93.13%」。
+- **⚠️ 未入库测试文件声明(执行口径 ≠ HEAD 口径)**:工作区存在 **4 个未跟踪测试源**并被本次全量编译执行(`config/GrowthPublicEndpointMappingTest` 5 例、`config/JwtInterceptorGrowthPolicyTest` 5 例、`controller/admin/AdminFamilyOverviewControllerTest` 3 例、`integration/controller/ArticleTagsContractTest` 2 例,**共 15 例全绿**)。故:
+  - **执行口径(含未入库)**:515 类 / 4507 例 / 4140 过 / 363 红 = **91.86%**
+  - **HEAD 口径(剔除)**:511 类 / 4492 例 / 4125 过 / 363 红 = **91.83%**
+  两者红集完全一致(未入库 4 类全绿),不影响门禁判定;建议研发确认这 4 个文件的归属(入库或删除),否则每轮口径都会漂移(同 B-208-5 性质)。
+- **红集三分列**:契约前瞻 257(50 类,TDD 预期)/ 存量真实缺陷 16(8 类,第 37 次零漂移)/ 删码遗留 28(3 类部分僵尸)/ 守卫 1(B-218-1)/ 僵尸 61(本轮退役)。
+- **web Jest 双口径**:主工作区 21 套 134 例(含 3 个未入库 spec,+13 例);R226 worktree 干净口径 18 套 121 例。红集 3 套两组一致。
+- **浏览器口径**:live 配置 4 project = 15 过 + 2 跳(dx 404 契约待派发);health 独立配置 13 过;189 追加 admin 5 过 → **33 过 + 2 跳**。
+- **langgraph**:11 红全部上游 429(`middleware.py:113`),非断言失败型产品缺陷;`EXIT=124` 为进程挂死(问题 5),summary 在 121.88s 已完整产出,**数据有效**。
+- **未执行**:压测、依赖漏洞扫描(execute 档未授权);未启停服务、未改 `src/main`、未在远端节点 `reset --hard`。
+- **未实测维度已标「未发现/未实测」,不视为通过。**
+
+## 附录 C:CI `BACKEND_OBSERVED_CLASSES` 双向差集(第 28 轮)
+
+- 清单 **33 类** vs 实测红类 **66 类** → **漏拦 59 / 陈旧 26**。
+- **漏拦(红但不在清单,需加入)**:`AICoachConsultContractTest, ActivityCheckinBoostContractTest, AdminDataMigrationContractTest, AdminFamilyRelationManageContractTest, AdminOrderManualContractTest, AdminReportParserManageContractTest, AdminSupplierManageContractTest, AdminUserGovernContractTest, AiCoachReportAnalyzeContractTest, AssessmentAppointmentCancelAuthzContractTest, AssessmentAppointmentCreateContractTest, AssessmentQuotaAppointmentContractTest, AuthSessionMutexContractRedTest, AuthSessionMutexContractTest, ChildAiChatContractTest, ChildAuthLoginContractTest, ChildDietViewMenuContractTest, ChildEnergyGainContractTest, ChildEnergyViewContractTest, ChildFeedbackSubmitContractTest, ChildGameReportScoreContractTest, ChildMindCaptureContractTest, ChildNotificationReceiveContractTest, ChildShopPointsExchangeContractTest, CoachProactiveContractTest, CoachRecommendContractTest, ContactCardManageContractTest, DietMealPlanAdjustContractTest, DietMealPlanGenerateContractTest, EnergyConfigAdminContractTest, EnergyIsolationContractTest, GrowthLeaderboardViewContractTest, GrowthPlanTaskListContractTest, MembershipPlanPurchaseContractTest, PlanActivationScT05ContractTest, ResourceBeanNameCollisionGuardTest, SupplierActivityAttendContractTest, SupplierAfterSalesHandleContractTest, SupplierExportComplianceContractTest, SupplierInventoryManageContractTest, SupplierManageAdminContractTest, SupplierNutritionSupplyContractTest, TaskReviewScP11ContractTest, TeacherDataIsolationScT13ContractTest, TeacherFamilyBindContractTest, TeacherPlanCreateContractTest, TeamProfitAdminManageContractTest, TeamProfitHookContractTest, TeamShareWeightedContractTest, TeamStarMyViewContractTest, UserServiceWechatLoginContractTest, UserServiceWechatLoginTest, WebConfigGrowthExcludeRemovedTest`(+ 6 个本轮已退役,实际待补 53)
+- **陈旧(清单内但已绿,应移除)**:`AdminFamilyOverviewControllerTest, ArticleControllerTest, ArticleWorkflowTest, AuthControllerTest, CfCommissionServiceSettleTest, DailyCheckinStreakFlowTest, DimensionScoreServiceImplTest, FamilyAdminOverviewServiceTest, FamilyControllerTest, FamilyJoinRequestServiceReferrerBindTest, FortuneServiceTest, GrowthRecordSyncFlowTest, GuideFamilyTaskControllerTest, GuideOrderControllerTest, GuideRolePermissionTest, GuideTeamControllerTest, MindFortuneControllerTest, PaymentControllerTest, PlannerBindInviteFlowTest, ProductControllerTest, ProductOrderControllerTest, ProductOrderServiceFulfillmentMultiModeTest, ProductOrderServiceUpdateExpressFieldTest, StatsControllerTest, UserServiceFamilyNameLinkTest, WishControllerTest`
+- 注:`CfCommissionServiceSettleTest` 出现在「陈旧」侧殊值关注——它测的正是 409/410 涉及的佣金服务,**已绿**,可作为资金路径行为覆盖的起点。
+
+## 附录 D:本轮新增/变更资产
+
+| 文件 | 类型 | 说明 |
+|---|---|---|
+| `tests/test-cases/2026-11-16-teamshare-create-pool.md` | 台账(入库) | S-cfc-406 **17 TC**(T% 解析 8 + 建池 9),前序会话产出未入库,本轮回收 |
+| `tests/test-cases/2026-11-16-rewardv2-energy-legacy.md` | 台账(新增) | S-cfc-391/410/409 **24 TC**(规则引擎 11 + 分润 v2 10 + 旧体系下线 7) |
+| `cfc-backend/src/test/java/com/etotem/cfc/unit/LegacyProfitSystemRemovedGuardTest.java` | 测试(新增) | 旧体系下线负向守卫 **5 例**(7 类缺席 + 3 保留类在场 + 4 表 DDL 在场 + 自检) |
+| 6 个僵尸契约类 | 测试(删除) | `ProfitPoolOrderContractRedTest`(4) / `StarScoreCalculatorContractRedTest`(10) / `TeamAwardRecordContractRedTest`(6) / `TeamShareRecordEightShareContractRedTest`(6) / `TeamProfitCronContractTest`(22) / `TeamStarMultiplierContractTest`(13) = **61 例假红** |
+| `.tdd/_dispatch_R228_251_lg.cjs` / `.tdd/_dispatch_R228_189_admin.cjs` | 工具(新增) | 251/189 派发器:**只读取证,不 `reset --hard`**,记录 HEAD/DIRTY/spec blob |

+ 35 - 0
docs/tdd/test/automation-run-2026-11-16-R226.md

@@ -0,0 +1,35 @@
+# 自动化闭环运行摘要 R226(2026-11-16 03:55 GMT+8 · 每小时自动化轮)
+
+> 测试负责人:陆谨|执行档:review(离线白名单)+ 内网三节点浏览器 E2E(189/204/251)|基线 `9528c60db` → 实测 `b6080f3b1`(窗口 +16 提交,4 新功能)
+
+## 结果速览
+
+| 套件 | 本轮 | 上轮 R225 | 结论 |
+|---|---|---|---|
+| 浏览器 E2E · admin(189) | 首跑 4/5 → **复测 5/5 EXIT=0** | 5/5 | ⚠️ U03 首跑偶发(B-226-1 观察)→ 复测澄清非回归 |
+| 浏览器 E2E · frontend(204) | **6/6 EXIT=0**(58.4s) | 6/6 | 零漂移 |
+| 浏览器 E2E · 本机(admin 5 + fe 6 + shop 4 + health 13) | **28/28 + dx 2 跳** | 28/28 + 2 跳 | 零漂移 |
+| 线上 API 点名 4 文件 | **33 过 / 0 红 / 3 跳** | 33/0/3 | 逐例零漂移 |
+| 新功能契约单测(S-cfc-381/383/382/405 + coupon T02) | **53/53 全绿**(7 类) | 无 | ▸新增实测 |
+| langgraph@251 | **43/43 全绿**(448.73s) | 37/43(6 红 429) | 🟢 **429 清零** |
+| cfc-web Jest | 18 套 121 例(111/10 红,红集同型) | 21 套 134(124/10) | 无新增红 |
+| 根级黑盒 | 7/16/23(B-36 承袭) | 7/16/23 | 一致 |
+| 后端 | test-compile SUCCESS;全量承采(92.12%) | — | G4 通过 |
+
+## 关键结论
+
+1. **无新增真实产品缺陷回归**:窗口 4 新功能契约 53/53 全绿,全部既有套件逐例零漂移;189 U03 首跑偶发经复测+本机双重澄清为非回归(B-226-1 观察)。
+2. **lg 429 环境红清零**:43/43 全绿,B-223-1 观察 3/3,满足销号条件(连续 2 轮 43/43 后销号)。
+3. **G12 补强**:新场景 SC-P-82(全局搜索)/SC-P-78(消息中心分页)补 **16 条 TC** 台账 `tests/test-cases/2026-11-16-global-search-notification.md`;API 层全绿,浏览器入口 UI 用例(P2)待补。
+4. **门禁裁决:有条件通过**(新增红线 0;承袭 P0 B-218-1 与 G11)。
+
+## 三节点派发记录
+
+- 189 `192.168.16.189:4090` admin-desktop(首跑 4/5,复测 5/5,每节点单任务)
+- 204 `192.168.16.204:4091` frontend-mobile(6/6,每节点单任务)
+- 251 `192.168.16.251:4096` langgraph pytest(43/43)
+
+## 本轮 git 证据
+
+- 提交 R226 报告 + G12 台账 + 研发通知至 `origin/cfclub`(详见 commit 记录)
+- 已通知研发(notice-2026-11-16-R226-研发通知.md)

+ 16 - 1
docs/tdd/test/blockers.md

@@ -1711,10 +1711,25 @@
 | **B-224-3(新增 · P1 流程 · 已回收)** | R223 台账 24 条 TC | 测试/研发 | `tests/test-cases/2026-11-16-review-detail-my-receipt-timeout.md`(69 行 / 24 TC)只提交在本地分支 `fix/scenario-coverage`(`c1f20bc2a`),**`origin/cfclub` 无此文件** → G12 追溯断层。**处置**:随 R224 报告一并入库。**纪律**:推送以 `origin/cfclub` 为唯一事实源。 | 测试 | 2026-11-16 01:20 | 已回收 |
 | **B-224-4(新增 · P1 装置+数据安全)** | 后端测试直连共享库 | 研发 | `mvn -o -B test` **510 类 / 4469 例 / 51:50**;`jstack 8060` 主线程阻塞于 `SocketInputStream.socketRead0 → mysql.cj.protocol.ReadAheadInputStream`(等远端 MySQL)。**根因链**:`cfc-backend/src/test/resources/` **不存在** → 继承 `src/main/resources/application*.yml:22,47` 的 **`jdbc:mysql://192.168.16.251:3306/zxyj`**(`createDatabaseIfNotExist=true`),以 `dev` profile 读写**共享库**;每上下文重跑 `schema.sql`(433 DDL)+ `DatabaseInitializer`(650 迁移段);`com.etotem` DEBUG 全落盘(日志 14.6MB / 迁移日志 24987 行 / 25+ 上下文)。**风险**:① 全量 40min→51:50 且随机卡顿;② 测试向共享库造数据,污染/误删风险。**修法**:加 `application-test.yml`(本地库 + 关迁移)+ `logback-test.xml` 降 WARN + `DatabaseInitializer` 同 JVM 只跑一次 + controller 改 `@WebMvcTest`。**判据**:连续 2 轮 ≤40min、类/例数不变、进程内无 `192.168.16.251:3306` 连接。 | 测试(R224 实测) | 2026-11-16 01:35 | 待研发修(P1) |
 | **B-224-5(第 22 轮 · P2)** | lg pytest 进程不退出 | 研发 | 251 上 summary 已打印(`8 failed, 35 passed in 107.37s`)但进程不退出 → `timeout 900` 兜底 `EXIT=124`。线索仍为 `RuntimeWarning: coroutine 'JavaClient._get_client' was never awaited`(`pytest/stash.py:108`)。**修法**:`shutdown` 时 `await client.aclose()`。 | 研发 | 2026-11-16 01:00 | 待修(P2) |
-| **B-223-1(第 2 轮 · P1 环境型 · 观察 2/3)** | langgraph 8 红 429 | 运维/研发 | 43 例 **35 过 8 红**(`test_auto_tag`×4 + `test_intent`×4),`RateLimitError 429 AgnesAI_error`(`app/middleware.py:113`);429 后 intent 兜底 chat 联动打红。R223 同型 → 观察 2/3。**销号**:连续 2 轮 43/43 全绿。 | 测试(251 实派) | 2026-11-16 01:00 | 观察中(2/3) |
+| **B-223-1(第 3 轮 · P1 环境型 · 观察 3/3 · 销号候选)** | langgraph 429 红 | 运维/研发 | R225 43 例 **37 过 6 红**(`test_auto_tag`×2 + `test_intent`×4,429→默认 chat 联动打红)→ **R226 43/43 全绿(448.73s,429 清零)**。R223/R224/R225 同型持续,本轮首次全绿。**销号条件**:连续 2 轮 43/43 全绿(R226 为第 1 轮全绿,**R227 再全绿即销号**)。 | 测试(251 实派) | 2026-11-16 01:00 | 观察中(3/3) |
+| **B-226-1(第 1 轮 · P2 观察项)** | 189 admin E2E TC-A-U03 首跑偶发红 | 测试/运维 | R226 189 首跑 admin-desktop **4/5**(TC-A-U03 失败:URL 停留 `/admin/` 且登录表单不可见)→ **复测 5/5 全绿**(1.6m);本机同版 spec **5/5**(U03 单独 4.3s PASS);生产 `/admin/` 与 `/admin/login` 均 HTTP 200/13ms;spec 窗口内零变更 → 判定**节点时序偶发,非产品回归**。**销号**:连续 2 轮 189 首跑 5/5 全绿。 | 测试(189 实派+本机复核) | 2026-11-16 03:55 | 观察中(1/3) |
 | **B-218-3(观察 2/3 · 好转)** | 线上 `/api/**` 502 | 运维 | health 首跑即 **13/13**(4.2s),shop 4/4 首跑即绿,无 502 → 连续 2 轮未复现。 | 测试 | 2026-11-16 00:45 | 观察中(2/3) |
 | **B-208-1 / B-221-4(承袭)** | 189 节点 | 运维/测试 | 189 admin **5/5 EXIT=0**(1.1m),spec blob `4703d73fb` = 本机同版(跨节点可比);但节点 HEAD `1e3bea680` ≠ 基线 `3ff62e324`。 | 测试(189 实派) | 2026-11-16 00:50 | B-208-1 好转 / B-221-4 待修 |
 | **B-36(第 100 轮 · P2)** | 根级黑盒 16 红 | 测试 | `node tests/node_modules/jest/bin/jest.js -c tests/jest.config.js` → **7 过 / 16 红 / 23**(5.6s),全 `ECONNREFUSED 127.0.0.1:9082`(本机后端未起)。 | 测试 | 2026-11-16 00:44 | 待处理 |
 | **B-DX-1(第 58 轮 · P1)** | dx-bridge 404 | 部署/研发 | `/api/health/data-sources/bridge/{list,sync-status}` 均 **404** → 2 跳。规格 `2026-11-08-dx-health-bridge.md:5` 明示「仅登记不实现」→ 非缺陷,建议标 `blocked: pending implementation`。 | 部署/研发 | 2026-11-16 00:47 | 待处理 |
 | **G11(第 26 轮 · P1)** | CI 排除清单失真 | 研发 | `.gitlab-ci.yml:61` 固定 **33 类** `BACKEND_OBSERVED_CLASSES` vs 实测红集 → 双向失真(漏拦 + 陈旧)。建议由 surefire XML 自动生成,或契约前瞻类打 `@Tag("forward-contract")`。 | 研发 | 2026-11-16 01:30 | 待研发(P1) |
 | **R224 门禁** | 非后端 931 例 / 876 过 / 38 红 / 17 跳 = 94.09% | 测试 | **不通过(有条件)**。✅G3 33+2 跳 / G4 test-compile SUCCESS(517 源 03:01)/ G5 已执行类全覆盖 XML / G6 / G8 6-6=401 / G10 三节点 / G12 窗口零变更+R223 台账回收;⚠️G1 94.09%(后端全量截断不可判)/ G2 38(0 确定性回归)/ G7 35-43;❌G9、G14 用例层 64.8%、G11、G13 中断(后端未跑完)。 | 测试(R224 闭环) | 2026-11-16 01:45 | 已记录 |
+
+| **B-227-1(P0 · 新增)** | `/api/notification/{list,read}`、`/api/search/global` | 研发 | **匿名(无 token)返回 200**:list→`{"code":200,"data":[]}`、read→`{"data":true}`(假成功)、search/global→四类空桶。三者均不在 `JwtInterceptor.LOGIN_REQUIRED_PATHS`,无 token 走匿名放行落 `userId=-1`(`JwtInterceptor.java:226-243`),`UserNotificationController.java:34/65` 以 -1 查询/更新。违反「SEC-20261031-01 鉴权统一」。修法:三条路径加入 `LOGIN_REQUIRED_PATHS`;`read` 补 id 归属校验。复测:匿名 3/3=401 且 `NotificationCenterViewContractTest` 9 + `GlobalSearchScP82ContractTest` 5 保持绿 | 测试 | 2026-11-16 07:25 | 待处理 |
+| **B-227-2(P1 · 度量)** | G8 匿名探针集 | 测试 | 历轮 G8 探针硬编码 **6 端点**,新接口不纳入 → 「6/6=401」是样本偏差下的通过(本轮扩到 8 条即命中 B-227-1)。建议新增 `tests/e2e/api/auth-coverage.spec.js`:从 `WebConfig.excludePathPatterns` 解析白名单,其余路径一律断言 401/403,用例数随控制器清单自动变化 | 测试 | 2026-11-16 07:25 | 待处理 |
+| **B-227-3(P1 · 环境)** | 189 节点代码滞后 | 运维 | 节点 `HEAD=de3aa5e2e` vs `origin/cfclub=b08d823e8`,落后 5 提交(含 S-cfc-406/409/391 三个功能);`DIRTY=171`。本轮**未 `reset --hard`**(避免破坏节点他人工作),按现 HEAD 取证:admin 5/5 EXIT=0、spec blob `4703d73fb` = 本机。修法:清理脏改动并同步远端;部署回执增加「节点 HEAD == 远端头」核对 | 运维 | 2026-11-16 07:25 | 待处理 |
+| **B-227-4(P1 · 工具 · 第 23 轮)** | 251 pytest 进程不退出 | 研发/环境 | summary 在 **121.88s** 已产出 `11 failed, 32 passed`,进程存活至 520s 被 `timeout -k 10` 杀 → `EXIT=124`(B-177-1/B-218-10 同源)。修法:产品侧 shutdown `await client.aclose()`;测试侧 `pytest_sessionfinish` 后强制退出。通过判据:连续 2 轮 `EXIT=0` | 研发/环境 | 2026-11-16 07:25 | 待处理 |
+| **B-227-5(P1 · 负债 · 本轮自处置)** | S-cfc-409 删码遗留僵尸测试 | 测试/研发 | 全量 363 红中 **89 例**来自 9 个仍断言已删类的契约测试(`ProfitPoolService`/`TeamProfitService`/`TeamProfitFlowService`/`StarScoreCalculator`/`TeamProfitCronTask`/`TeamProfitAdminController`/`TeamStarController`),经 `ContractReflect.requireClass` 反射加载 → 编译过、运行 `ClassNotFoundException`,每轮假红。**已退役 6 个 100% 红类(61 例)** + 新增 `LegacyProfitSystemRemovedGuardTest`(5/5 绿,7 类缺席 + 3 保留类在场 + 4 表 DDL 在场);`test-compile` SUCCESS 03:16。剩余 3 类部分僵尸(`TeamProfitAdminManageContractTest` 5F/20、`TeamStarMyViewContractTest` 20F/24、`TeamProfitHookContractTest` 3F/7 = 28 例)需外科式裁剪 | 测试 | 2026-11-16 07:25 | 部分解除(61/89) |
+| **B-223-1(复发 · 观察 1/3)** | lg@251 429 配额 | 环境 | 43 例 **32 过 / 11 红**(121.88s),11 红全 `RateLimitError 429 AgnesAI rate limit for free users`(`middleware.py:113`),含「today's text quota used up…retry after 22:09:23」。R226 曾 43/43 全绿 → 观察计数**重置 1/3**。建议给测试环境独立额度 + LLM 用例打 `@pytest.mark.llm` | 环境 | 2026-11-16 07:25 | 观察中(1/3) |
+| **B-218-3(观察 3/3 · 达标)** | 线上 `/api/**` 502 | 运维 | health **13/13 首跑即绿**(6.8s)、shop 4/4、API 33/0/3 → **连续 3 轮未复现,可销号** | 测试 | 2026-11-16 07:25 | **可销号(3/3)** |
+| **B-218-1(第 5 轮 · P0 承袭)** | `CoachRecommendService` Bean 撞名 | 研发 | `ResourceBeanNameCollisionGuardTest` 1/1 红:`@Resource FamilyMemberDimensionBaseScoreService dimensionScoreService` 字段名命中 Bean `dimensionScoreService`(类型 `DimensionScoreService`)→ 运行期 `BeanNotOfRequiredTypeException`。修法:字段改名或 `@Resource(name=...)`。**附注**:该守卫单例耗时 **210.4s**(反射扫全类路径),建议加缓存或换 ArchUnit | 研发 | 2026-11-16 07:25 | 待处理(第 5 轮) |
+| **B-36(第 101 轮 · P2)** | 根级黑盒 16 红 | 测试 | `node tests/node_modules/jest/bin/jest.js -c tests/jest.config.js` → **7 过 / 16 红 / 23**(6.5s),全 `ECONNREFUSED 127.0.0.1:9082`(本机后端未起) | 测试 | 2026-11-16 07:25 | 待处理 |
+| **B-DX-1(第 60 轮 · P1)** | dx-bridge 404 | 部署/研发 | `/api/health/data-sources/bridge/{list,sync-status}` 均 **404** → 2 跳。规格明示「仅登记不实现」→ 非缺陷,建议规格标 `blocked: pending implementation` | 部署/研发 | 2026-11-16 07:25 | 待处理 |
+| **G11(第 28 轮 · P1)** | CI 排除清单失真 | 研发 | `.gitlab-ci.yml:61` 清单 **33 类** vs 实测红类 **66** → **漏拦 59 / 陈旧 26**(含真红 `UserServiceWechatLoginTest`、`WebConfigGrowthExcludeRemovedTest`、`ResourceBeanNameCollisionGuardTest`)。建议由 surefire XML 自动生成,或契约前瞻类打 `@Tag("forward-contract")` | 研发 | 2026-11-16 07:25 | 待处理 |
+| **B-208-1(改善)** | 189 DNS 落公网 / 502 | 运维 | 189 admin **5/5 EXIT=0**(1.3m)→ 服务恢复可用 | 测试 | 2026-11-16 07:25 | 改善(需配合 B-227-3 同步代码) |
+| **R227 段 · 门禁** | 后端 515 类/4507 例 91.86% · 全站 5438/5013=92.18% | 测试 | **不通过**。✅G4 test-compile SUCCESS / G5 515-515 XML / G6 逐例零漂移 / G10 本机+189+251 / G12 台账补 2 份 41 TC / G13 第 37 次零漂移;⚠️G1 91.86%(退役后 93.13%,剔前瞻 98.83%)/ G3 web 124-10 / G9 代理 / G14;❌**G2 真实缺陷红 45**(存量 16 + 删码遗留 28 + 守卫 1)/ **G7 32-43(11×429)** / **G8 匿名 200×3** / **G11 漏拦 59**。阻塞:B-227-1(P0)、B-218-1(P0 承袭)、G-227-1 资金行为层 | 测试 | 2026-11-16 07:25 | 不通过 |

+ 42 - 0
docs/tdd/test/notice-2026-11-16-R227-研发通知.md

@@ -0,0 +1,42 @@
+# 研发通知 R227(2026-11-16 06:05 GMT+8 · 自动化闭环测试负责人轮)
+
+> 基线:`origin/cfclub` **`b08d823e8`**|窗口 **+32 提交**(S-cfc-406 / 409 / 391 / 410 四个功能 + 部署回执/bump/研发汇报)
+> 执行档:review(离线白名单)|未改 `src/main`、未装依赖、未启停服务
+> 完整报告:`docs/tdd/orchestration/report-test-2026-11-16-R227.md`|问题台账:`docs/tdd/blockers.md`(R227 段)
+
+## 一、需要研发/运维处理的项(按优先级)
+
+| # | 优先级 | 项 | 现象与证据 | 建议动作 | 闭环判据 |
+|---|---|---|---|---|---|
+| 1 | **P0** | **匿名访问 3 个私有接口返回 200** | `POST /api/notification/list` → `200 {"code":200,"data":[]}`;`POST /api/notification/read` → `200 {"data":true}`;`POST /api/search/global` → `200 {"data":{reports:[],plans:[],tasks:[],products:[]}}`(线上实测,匿名无 token)。三者均不在 `JwtInterceptor.LOGIN_REQUIRED_PATHS`,无 token 时走「匿名放行」分支落 `userId=-1`(`JwtInterceptor.java:226-243`),控制器 `UserNotificationController.java:34/65` 以 `userId=-1` 查询/更新 → 返回空集与 `true`(**假成功**) | 将三条路径加入 `LOGIN_REQUIRED_PATHS`(与 `SEC-20261031-01 鉴权统一` 同批);`/api/notification/read` 建议额外校验 `id` 归属 | 匿名探针 3/3 = 401;已有登录用户调用行为不变 |
+| 2 | **P1** | **资金路径行为层无自动化断言** | 窗口新增 `CfCommissionService`(四入口 +264 行)与 `CfTeamPoolShare` 实体,覆盖仅契约层(方法存在性/常量/依赖链),**金额、幂等、残差、上限无断言**。台账已给 24 条行为级用例(`tests/test-cases/2026-11-16-rewardv2-energy-legacy.md` TC-R2-01~10) | 在集成环境(MySQL 3306 + 9082)按台账补行为用例;重点 `TC-R2-05 残差归集`、`TC-R2-07 重复结算幂等` | 10 例行为用例绿 |
+| 3 | **P1** | **CI `BACKEND_OBSERVED_CLASSES` 清单第 28 轮失真** | `.gitlab-ci.yml` 清单 33 类 vs 本轮实测红类见报告附录 C:既**漏拦**真实红类,又**陈旧排除**已转绿类 | 按报告附录 C 的精确类名重写变量;建议改为「由上轮 surefire XML 自动生成」 | `backend-blocking-junit` 与实测红集一致 |
+| 4 | **P1** | **189 节点代码滞后 5 提交** | 节点 HEAD `de3aa5e2e` vs `origin/cfclub` `b08d823e8`,落后含 3 个功能提交(406/409/391);DIRTY=171(节点有未提交改动,本轮**未做 `reset --hard`**,只按现 HEAD 跑) | 清理节点脏改动并同步至 `origin/cfclub`;纳入部署回执核对 | 节点 `git rev-parse HEAD` = 远端头 |
+| 5 | **P1** | **langgraph pytest 进程不退出(第 23 轮)** | 251 上 pytest 在 **121.88s** 已打印 `11 failed, 32 passed`,但进程存活至 520s 被 `timeout -k 10` 杀掉 → `EXIT=124`(B-177-1/B-218-10 同源) | 产品侧在 `JavaClient`/`httpx` 生命周期结束处 `await client.aclose()`(历史日志有 `coroutine 'JavaClient._get_client' was never awaited`);测试侧 `conftest.py` 加 `pytest_sessionfinish` 强制退出 | 连续 2 轮 `EXIT=0` |
+| 6 | **P2** | **lg 429 配额耗尽(B-223-1 复发)** | 251 实跑 43 例 32 过 **11 红全部 `429 AgnesAI rate limit for free users`**(`middleware.py:113`,含「today's text quota used up,1 request/3min」);`test_auto_tag`×5 / `test_intent`×4 / `test_analyze`×2 | 为测试环境配置付费/独立额度,或把依赖 LLM 的用例默认 `skip` 并单列 `-m llm` 标记 | 43/43 或 llm 用例显式 skip 后 32/32 |
+| 7 | **P2** | **G8 匿名探针集未随接口增长** | 探针固定 6 端点(mind/energy/health-plan/admin-families/huawei + 1),新接口(notification/search)不在其中 → 第 1 项缺陷长期不可见 | 由 `WebConfig` 白名单 + 控制器清单**动态生成**匿名探针(白名单外一律期望 401) | 探针数与 `@PostMapping` 控制器清单同步 |
+| 8 | **P3** | **4 表 DDL 双源不一致(风险已核验可控)** | S-cfc-409 从 `DatabaseInitializer` 移除 `profit_pool_order`/`team_share_record`/`team_award_record`/`service_cost_config` 的 CREATE DDL,但 `schema.sql:7350+` 仍保留、实体与 Mapper 亦保留 → 当前 **`DatabaseInitializer:159` 加载 `schema.sql`,建表不受影响**;若将来移除 schema.sql 加载路径会静默缺表 | 保留双源时在 `schema.sql` 对应位置加注释说明「唯一建表来源」;或彻底删除实体/Mapper | 二选一落定并留注释 |
+
+## 二、本轮未实测项(勿据本通知认为已通过)
+
+- **性能压测**、**依赖漏洞扫描(SCA)**:execute 档需联网授权,本轮未申请、未执行。
+- **UAT 签署**、**BDD 规格**、**无障碍 axe 断言**、**覆盖率/变异门禁**:项目内不存在,非本轮回归。
+- **资金/能量行为层**:仅契约层覆盖(见第 2 项)。
+
+## 三、本轮正向进展(供参考)
+
+- 后端 **全量实跑**(R226 为承采):窗口 4 个功能提交全部纳入回归,`test-compile` **0 错**证明 409 删码无残留引用。
+- 浏览器 E2E **33 过 + 2 跳**(本机 15 + health 13 + 189 admin 5),admin/frontend/shop/health 全绿。
+- 线上 API 33 过 / 0 红 / 3 跳,**逐例零漂移**。
+- cfc-frontend 46 套 660 例逐例零漂移;cfc-web 红集与 R226 同型(FAMILY-WB S1-1 契约预期红)。
+
+## 四、口径声明补充(未入库测试文件)
+
+工作区存在 **4 个未跟踪后端测试源**,被本轮全量编译执行(**15 例全绿**):
+`cfc-backend/src/test/java/com/etotem/cfc/config/GrowthPublicEndpointMappingTest.java`、
+`.../config/JwtInterceptorGrowthPolicyTest.java`、
+`.../controller/admin/AdminFamilyOverviewControllerTest.java`、
+`.../integration/controller/ArticleTagsContractTest.java`。
+
+- 影响:执行口径 515 类 / 4507 例(91.86%)≠ HEAD 口径 511 类 / 4492 例(91.83%),**红集一致**,不影响门禁。
+- 请求:确认这 4 个文件的归属(入库或删除),否则每轮例数都会漂移(与 B-208-5 同性质)。

+ 50 - 0
notice-2026-11-16-R226-研发通知.md

@@ -0,0 +1,50 @@
+# 研发通知 R226(2026-11-16 03:55 GMT+8 · 测试结果有变化)
+
+> 收件人:cfc 研发组(backend / frontend / langgraph)
+> 发件人:测试负责人(自动化闭环 R226)
+> 触发条件:**测试结果有变化** → 提交远程 + 通知研发(按用户指令)
+
+---
+
+## 一、本轮变化摘要
+
+| 项 | R225 | R226 | 性质 |
+|---|---|---|---|
+| 基线 | `9528c60db` | `b6080f3b1`(窗口 +16 提交,4 新功能 + coupon T02) | **有 src 变更** |
+| langgraph@251 | 43 / 37 过 / 6 红(429) | 43 / **43 过 / 0 红**(448.73s) | 🟢 **429 清零,显著改善** |
+| 窗口新功能契约单测(S-cfc-381/383/382/405 + coupon T02) | 无 | **53/53 全绿**(7 类 7s 内) | ▸新增实测 |
+| 浏览器 E2E · admin(189) | 5/5 | 首跑 4/5 → **复测 5/5** | ⚠️ U03 偶发 1 次(B-226-1 观察) |
+| 浏览器 E2E · frontend(204) | —(本机 6/6) | **6/6**(204 节点) | 零漂移 |
+| 线上 API 点名 | 33/0/3 | 33/0/3 | 零漂移 |
+| 真实产品缺陷红 | 17 | **17(无新增)** | 承袭 |
+
+**结论:无新增真实产品缺陷回归;窗口 4 个新功能(全局搜索 / 通知分页 / 方案草稿 / 平台抽成)契约层全部通过;langgraph 429 环境红清零。**
+
+---
+
+## 二、需要研发处理的问题
+
+### 🔴 P0(承袭,第 6 轮观察)B-218-1:`@Resource` Bean 撞名守卫红
+- `ResourceBeanNameCollisionGuardTest` 1/1 红,本轮后端新增功能未涉守卫,承袭未修。
+- 复现要点见 R224/R225 报告 §6。
+
+### 🟠 P2(观察 1/3)B-226-1:189 admin E2E TC-A-U03 首跑偶发红
+- **现象**:189 节点首跑 `TC-A-U03 未登录访问后台受保护路由被拦截到登录页` 失败(URL 停留 `/admin/`、登录表单不可见)。
+- **澄清**:189 复测 5/5 全绿、本机同版 spec 5/5(U03 单独 4.3s PASS)、生产 `/admin/` 与 `/admin/login` 均 HTTP 200/13ms → **判定为节点时序偶发,非产品回归**。
+- **请研发**:无需处理代码;若怀疑与前端路由守卫加载时序有关可复查 `cfc-web` 路由守卫初始化。测试侧连续 2 轮首跑全绿后销号。
+
+### 🟡 新场景用例补强(G12,已闭环 API 层)
+- 窗口新功能 **S-cfc-383 全局搜索(SC-P-82)** 与 **S-cfc-381 通知分页+404(SC-P-78)** 已登记 API_REFERENCE(§4.15/§4.61.7/4.59.10);
+- 测试侧补台账 `tests/test-cases/2026-11-16-global-search-notification.md`(**16 条 TC**),API 契约层已由 53 例契约单测全绿;
+- **浏览器入口 UI 用例(P2,待补)**:小程序端全局搜索框、消息中心页的登录态 UI 用例待小程序界面发布后补充——如研发希望提前闭环,可优先把 `/api/search/global` 与 `/api/notification/*` 接入前端。
+
+### 🟢 lg 429 销号提示(B-223-1,观察 3/3)
+- 本轮 43/43 全绿,429 未触发。按销号规则「连续 2 轮 43/43 全绿」——**下一轮(R227)如仍 43/43 全绿,测试侧将正式销号 B-223-1**。建议 251 保持当前 Token Plan 配额,并考虑将 429 由「静默兜底 chat」改造为「显式失败可重试」以免疫后续配额波动(改造后需重跑 intent 用例确认无回归)。
+
+---
+
+## 三、附:三节点执行确认
+
+- 189(admin-desktop):首跑 4/5(U03 偶发)→ **复测 5/5 EXIT=0**(1.6m,`f4d6bb152`)
+- 204(frontend-mobile):**6/6 EXIT=0**(58.4s,`b6080f3b1`)
+- 251(langgraph pytest):**43/43 EXIT=0**(448.73s,`f4d6bb152`)

+ 49 - 0
tests/test-cases/2026-11-16-global-search-notification.md

@@ -0,0 +1,49 @@
+# 2026-11-16 功能新增专项用例(全局搜索 SC-P-82 + 消息中心分页 SC-P-78)
+
+> 本文件为 **G12 场景落地→测试用例** 的派生产物,对应窗口 `9528c60db..b6080f3b1` 新合入功能:
+> - **S-cfc-383 `global.search.query`(SC-P-82 全局搜索)**:`SearchController`(类级 `/api/search` + `POST /api/search/global`)→ `GlobalSearchService.globalSearch(keyword, userId, familyId, memberId)` 聚合 Report(报告)/Plans(方案)/Tasks(任务)/Products(商品) 四类按类型分流;空关键词/无匹配返回空桶;报告/方案按家庭/成员范围过滤越权结果。
+> - **S-cfc-381 `notification.center.view`(SC-P-78 消息中心/通知查看)**:`POST /api/notification/list` 支持可选 `pageNum/pageSize` 分页(无参维持原 `LIMIT 100` 未读优先兼容);`POST /api/notification/read` 当 `id` 不存在 → 404(TC-P-78-E)。
+> - 契约登记:`docs/superpowers/api/API_REFERENCE.md §4.15 / §4.61.7 / 4.59.10`(2026-11-16 更新,S-cfc-383 由「不存在」改为「已实现」)。
+>
+> **派生策略**:契约锚点复用 API_REFERENCE §4.15/§4.61.7;三流齐备(正常 / `-E` 异常 / `-P` 权限)。
+> **执行状态**:API 层已由 7 类契约单测实跑 **53/53 全绿**(2026-11-16 R226,见报告 §2);本台账为场景级映射,浏览器端入口用例待小程序/管理端 UI 落地后执行。
+
+---
+
+## 一、全局搜索契约用例(`POST /api/search/global`,SC-P-82)
+
+| TC 编号 | 环节 | 角色 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联契约 |
+|---|---|---|---|---|---|---|---|---|
+| TC-GS-01 | 关键词命中报告 | 已登录家长 | P0 | 功能 | 家庭存在含关键词的报告 | 1. `POST /api/search/global { "keyword": "体检" }` | 200;`data.reports` 命中该报告(按家庭/成员范围过滤) | §4.59.10 SC-P-82 |
+| TC-GS-02 | 关键词命中方案 | 已登录家长 | P0 | 功能 | 该成员存在含关键词的方案 | 1. `{ "keyword": "成长" }` | 200;`data.plans` 命中方案 | §4.59.10 |
+| TC-GS-03 | 关键词命中任务 | 已登录家长 | P1 | 功能 | 存在含关键词的任务 | 1. `{ "keyword": "阅读" }` | 200;`data.tasks` 命中任务 | §4.59.10 |
+| TC-GS-04 | 关键词命中商品 | 已登录家长 | P1 | 功能 | 商城存在含关键词商品 | 1. `{ "keyword": "课时" }` | 200;`data.products` 命中商品 | §4.59.10 |
+| TC-GS-05 | 四类聚合分流 | 已登录家长 | P0 | 功能 | 关键词同时命中多类 | 1. `{ "keyword": "共有关键词" }` | 200;reports/plans/tasks/products 各自返回(可按类型空) | §4.59.10 |
+| TC-GS-06 | 空关键词空桶 | 已登录家长 | P1 | 功能 | 任意 | 1. `{ "keyword": "" }` 或 `{}` | 200;四类空桶,不报错 | §4.59.10 |
+| TC-GS-07 | 无匹配空桶 | 已登录家长 | P1 | 功能 | 关键词无任何命中 | 1. `{ "keyword": "不存在词xyz" }` | 200;四类空桶,不报错 | §4.59.10 |
+| TC-GS-08-E | 越权结果过滤 | 已登录家长 | P1 | 权限 | 关键词命中他人家庭/成员的私有报告/方案 | 1. `{ "keyword": "他人数据" }` | 200;reports/plans **不返回**越权结果(按 familyId/memberId 过滤) | §4.59.10 |
+| TC-GS-09-P | 未登录拒绝 | 游客 | P0 | 权限 | 无 token | 1. `POST /api/search/global {}` | 401(JwtInterceptor)或按白名单登记行为 | §4.59.10 |
+
+---
+
+## 二、消息中心分页/已读契约用例(`/api/notification/*`,SC-P-78)
+
+| TC 编号 | 环节 | 角色 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联契约 |
+|---|---|---|---|---|---|---|---|---|
+| TC-NC-01 | 无参兼容旧行为 | 已登录家长 | P0 | 功能 | 存在通知数据 | 1. `POST /api/notification/list {}` | 200;`UserNotification[]`(未读优先,`LIMIT 100`)兼容不回归 | §4.61.7 |
+| TC-NC-02 | 分页参数生效 | 已登录家长 | P0 | 功能 | 存在 >pageSize 通知 | 1. `POST /api/notification/list {}` + `?pageNum=1&pageSize=10` | 200;`Page<UserNotification>`(含 total/pageNum/pageSize);`data.length ≤ 10` | §4.61.7 S-cfc-381 |
+| TC-NC-03 | 单条已读 | 已登录家长 | P0 | 功能 | 存在未读通知 id=N | 1. `POST /api/notification/read { "id": N }` | 200 true;该条状态变已读 | §4.15/§4.61.7 |
+| TC-NC-04 | 批量已读 | 已登录家长 | P1 | 功能 | 存在多个未读 id | 1. `{ "ids": [N1,N2] }` | 200 true;批量置已读 | §4.15 |
+| TC-NC-05 | 全部已读 | 已登录家长 | P1 | 功能 | 有未读通知 | 1. `{}` 空参 | 200 true;全部已读 | §4.15 |
+| TC-NC-06-E | id 不存在 404 | 已登录家长 | P1 | 异常 | 无效通知 id | 1. `POST /api/notification/read { "id": 99999999 }` | **404**(S-cfc-381:`id` 不存在 → 404,TC-P-78-E) | §4.61.7 |
+| TC-NC-07-P | 未登录拒绝 | 游客 | P0 | 权限 | 无 token | 1. `POST /api/notification/list` | 401 | §4.15 |
+
+---
+
+## 三、自动化映射
+
+| TC 范围 | 自动化资产 | 状态 |
+|---|---|---|
+| TC-GS-01~09 | `GlobalSearchQueryContractTest`(10) + `GlobalSearchQueryEmptyResultContractTest`(3) + `GlobalSearchQueryScP82RestContractTest`(7) + `GlobalSearchScP82ContractTest`(5) = **25 例** | **全绿**(R226 实跑 1.78s) |
+| TC-NC-01~07 | `NotificationCenterViewContractTest`(9) | **全绿**(R226 实跑 0.503s) |
+| 浏览器端入口(小程序搜索框、消息中心页) | 待 UI 用例(当前自动化仅 API 契约层) | 待补(P2) |

+ 72 - 0
tests/test-cases/2026-11-16-rewardv2-energy-legacy.md

@@ -0,0 +1,72 @@
+# 2026-11-16 功能新增专项用例(补充:能量规则引擎实时触达 S-cfc-391 · 分润 v2 端到端账目 S-cfc-410 · 旧体系废弃清理 S-cfc-409)
+
+> 本文件为 **G12「需求/源码变更 → 测试用例」** 的派生产物补充,配套 `2026-11-16-teamshare-create-pool.md`(S-cfc-406)。
+> 覆盖 R227 窗口(基线 `b6080f3b1` → `b08d823e8`)中**除 S-cfc-406 外的三个后端功能提交**:
+>
+> | 提交 | 能力键 | 生产改动 | 契约载体 |
+> |---|---|---|---|
+> | `c75a707ae` | `energy.ruleEngine.apply`(S-cfc-391) | `EnergyRuleEngine` +179 / `EnergyService` +32 | `EnergyRuleEngineApplyContractTest` 17 例 |
+> | `325b2ae32` | `cf.rewardv2.e2eExample`(S-cfc-410) | `CfCommissionService` +264 / `CfTeamPoolShare` 实体 / `TeamShareConfigService` +130 | `RewardV2E2EExampleContractTest` 14 例 |
+> | `b4c755f6b` | `cf.rewardv2.removeLegacy`(S-cfc-409) | 删除 6 契约类 + `TeamStarController`/`TeamProfitAdminController`;5 个订单服务移除结算调用;`DatabaseInitializer` −131 | `RewardV2RemoveLegacyContractTest` 6 例 |
+>
+> **说明**:本窗口 `docs/superpowers/specs/` 零文本变更,`API_REFERENCE.md` 仅变更 notification/search 两节(由 R226 台账 `2026-11-16-global-search-notification.md` 覆盖)。本文件针对「src 新增能力但用例台账空白」补强。
+> **派生策略**:三流齐备(正常流 / `-E` 异常流 / `-P` 权限与幂等)。
+> **执行状态**:契约层已由上述三个契约类自动化覆盖(R227 后端全量实测);行为级用例需 DB/订单上下文,标注「待集成环境执行」。
+
+---
+
+## 一、能量规则引擎实时触达(`EnergyRuleEngine#apply`,S-cfc-391)
+
+| TC 编号 | 环节 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联 |
+|---|---|---|---|---|---|---|---|
+| TC-RE-01 | 正常-任务规则归因 | P0 | 功能 | 规则 `RULE_TASK_DONE` 声明维度 `mind`、值 10;用户维度余额可分配 | 1. `apply(事件{taskId,userId})` | 返回 `awarded=true`,`EnergyLog` 写 1 条且 `dimension=mind`;`EnergyBalance` 对应维度 +10 | SC-P-87 |
+| TC-RE-02 | 正常-多维度分配 | P0 | 功能 | 规则声明 `body:4, mind:6` | 1. `apply(...)` | 两维度分别写入,比例与声明一致,总和不超 amount | SC-P-93 |
+| TC-RE-03 | 正常-上限截断 | P0 | 功能 | 维度日上限 15,本次 award 20 | 1. `apply(...)` | 返回 `capped=true`,实际写入 15,日志记录截断 | SC-P-87 |
+| TC-RE-04 | 正常-幂等去重 | P0 | 功能 | 同一 `(ruleId,userId,bizId)` 已 apply 成功 | 1. 重复 `apply(...)` | 返回 `duplicated=true`,不新增 `EnergyLog`、余额不变 | SC-P-87 |
+| TC-RE-05 | 正常-evaluate 委托 | P1 | 功能 | 同 TC-RE-01 | 1. `evaluate(...)` 与 `apply(...)` 同参数 | 两者结果字段一致(`evaluate` 委托 `apply`) | 实现说明 |
+| TC-RE-06 | 异常-E-4 写入失败传播 | P0 | 异常 | Mock 写入层抛 `DataAccessException` | 1. `apply(...)` | 抛 `RuntimeException`(不吞),**不产生半写**(余额与日志同事务回滚) | SC-P-87-E-4 |
+| TC-RE-07 | 异常-E-4 归因无分配 | P0 | 异常 | 规则命中但维度分配为空/全 0 | 1. `apply(...)` | 抛 `RuntimeException`,不静默返回成功 | SC-P-87-E-4 |
+| TC-RE-08 | 异常-amount 缺失 | P1 | 异常 | 事件 `amount=null` | 1. `apply(...)` | 抛 `IllegalArgumentException`,错误信息含 amount | 提交说明 |
+| TC-RE-09 | 异常-amount 非正 | P1 | 异常 | 事件 `amount=0` / `-5` | 1. `apply(...)` | 抛 `IllegalArgumentException`,不写日志 | 提交说明 |
+| TC-RE-10 | 异常-无规则命中 | P1 | 异常 | 事件类型无匹配规则 | 1. `apply(...)` | 返回 `awarded=false`,不抛异常、不写日志 | 兜底 |
+| TC-RE-11 | 权限-跨家庭事件 | P0 | 权限 | 事件 `userId` 属于其他家庭,调用者家庭不含该成员 | 1. 经控制器触发 | 403(越权拒绝),能量不写入被越权成员 | SC-X-19 |
+
+## 二、分润 v2 端到端账目(`CfCommissionService` 四入口 + `CfTeamPoolShare`,S-cfc-410)
+
+| TC 编号 | 环节 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联 |
+|---|---|---|---|---|---|---|---|
+| TC-R2-01 | 正常-平台抽成记账 | P0 | 功能 | 订单成交额 100 元,platformRate 10% | 1. `settlePlatformTake()` | `platformTakeCent=1000`,`base` 按设计 §2.2 口径计算(不含运费/优惠券抵扣) | 设计 §2.2 |
+| TC-R2-02 | 正常-团队池建池 | P0 | 功能 | 成本 30 元、T%=3000 | 1. `settleTeamPool()` | 池额 = 成本×T% = 900 分,`CfTeamPoolOrder` 落 1 行,状态 `PENDING` | 设计 §2.1 |
+| TC-R2-03 | 正常-池瓜分 | P0 | 功能 | 池额 900 分,3 个有效份额权重 5/3/2 | 1. `distributeTeamPool()` | `CfTeamPoolShare` 3 行,份额 450/270/180,合计 = 900(无残差) | 设计 §2.3 |
+| TC-R2-04 | 正常-零参入口探活 | P1 | 功能 | 无请求上下文 | 1. 调零参 `settlePlatformTake()`/`settleTeamPool()`/`distributeTeamPool()`/`resolveTbps()` | 均不抛异常,返回默认/空结果(契约占位语义) | 提交说明 |
+| TC-R2-05 | 正常-残差归集 | P1 | 功能 | 池额 1000 分,权重 1/1/1(除不尽) | 1. `distributeTeamPool()` | 三份合计 = 1000,残差归最后一份(不丢分、不超发) | 设计 §2.3 |
+| TC-R2-06 | 异常-池额 0 | P1 | 异常 | 成本 0 或 T%=0 | 1. `settleTeamPool()` | 不建池(或建 0 额池并标记 `SKIPPED`),不产生份额行 | 设计 §2.1 |
+| TC-R2-07 | 异常-重复结算 | P0 | 异常 | 同一订单已结算 | 1. 再次 `settlePlatformTake()` / `settleTeamPool()` | 整单唯一键幂等:不新增账目行、金额不变、返回已存在标记 | 幂等 |
+| TC-R2-08 | 异常-份额权重全 0 | P1 | 异常 | 3 个候选份额权重均为 0 | 1. `distributeTeamPool()` | 不写份额行(避免除零),池状态保持 `PENDING` 并告警 | 设计 §2.3 |
+| TC-R2-09 | 异常-配置缺失兜底 | P1 | 异常 | `cf_team_share_config` 无任何启用行 | 1. `resolveTbps(null,null)` | 返回代码兜底 `DEFAULT_T_BPS`,不抛异常 | 设计 §2.1 |
+| TC-R2-10 | 权限-非运营读取账目 | P1 | 权限 | 非 admin 角色 | 1. 经管理端入口查询池/份额 | 401/403,不返回他人账目 | 鉴权统一 |
+
+## 三、旧体系废弃清理(`cf.rewardv2.removeLegacy`,S-cfc-409)
+
+| TC 编号 | 环节 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联 |
+|---|---|---|---|---|---|---|---|
+| TC-RL-01 | 正常-类已删除 | P0 | 功能 | 干净 HEAD | 1. `grep -r "ProfitPoolService\|TeamProfitService\|TeamProfitFlowService\|StarScoreCalculator\|TeamProfitCronTask" src/main/java` | 0 命中(仅允许 `TeamProfitConfigService` 等同名前缀的保留类) | 提交说明 |
+| TC-RL-02 | 正常-订单链路无旧结算调用 | P0 | 功能 | 同上 | 1. 检查 5 个订单服务(Assessment/MemberSubscription/Membership/Payment/ProductOrder) | 无 `profitPoolService` 注入与 `settle` 调用残留,订单创建/支付路径可用 | 提交说明 |
+| TC-RL-03 | 正常-StarDigest 降级 | P1 | 功能 | 删 `StarScoreCalculator` 后 | 1. 触发星摘要生成 | 走既有 fallback,不抛 `NoClassDefFoundError` | 提交说明 |
+| TC-RL-04 | 正常-编译门禁 | P0 | 功能 | 干净 HEAD | 1. `mvn -o test-compile` | `BUILD SUCCESS`(0 错),测试源全量可编译 | G4 |
+| TC-RL-05 | 异常-旧表实体残留表不存在 | P1 | 异常 | 新库仅跑 `DatabaseInitializer`(4 表 DDL 已移除) | 1. 调任一引用 `profit_pool_order` 的 Mapper | 不应出现 `Table doesn't exist`:`schema.sql` 仍含 4 表 DDL,建库路径须保证二者一致 | `schema.sql:profit_pool_order` |
+| TC-RL-06 | 异常-定时任务调度缺失 | P1 | 异常 | 删 `TeamProfitCronTask` 后 | 1. 启动应用并检查调度注册 | 无 `NoSuchBeanDefinitionException`,scheduler 正常注册其余任务 | 提交说明 |
+| TC-RL-07 | 权限-已删管理端接口 | P2 | 权限 | 删 `TeamProfitAdminController` 后 | 1. `POST /api/admin/team-profit/*` 任一旧路径 | 404(路由已移除),不 500 | 路由 |
+
+---
+
+## 四、执行与自动化映射
+
+| 用例簇 | 自动化载体 | 状态 |
+|---|---|---|
+| TC-RE-01~10 | `cfc-backend/src/test/java/com/etotem/cfc/unit/EnergyRuleEngineApplyContractTest.java`(17 例) | 契约层 R227 实测;TC-RE-11(越权)依赖控制器 + 上下文,待集成环境 |
+| TC-R2-01~10 | `cfc-backend/src/test/java/com/etotem/cfc/unit/RewardV2E2EExampleContractTest.java`(14 例) | 契约层 R227 实测;金额/残差/幂等需 DB 集成环境 |
+| TC-RL-01~07 | `cfc-backend/src/test/java/com/etotem/cfc/unit/RewardV2RemoveLegacyContractTest.java`(6 例)+ `mvn test-compile` | TC-RL-01/04 由编译门禁与静态扫描覆盖(R227 实测 0 错);TC-RL-05 依赖建库路径核对 |
+
+> 注:三个能力均为**后端内部逻辑或无独立 HTTP 入口**,浏览器 E2E 不适用(TC-RL-07 为路由下线负向断言)。
+> 契约层绿 ≠ 行为层绿:金额、幂等、残差属**资金路径**,必须在集成环境(MySQL 3306 + 9082)按本台账行为级用例补跑后方可认定闭环。

+ 52 - 0
tests/test-cases/2026-11-16-teamshare-create-pool.md

@@ -0,0 +1,52 @@
+# 2026-11-16 功能新增专项用例(团队分润池建池 S-cfc-406 · cf.teamshare.createPool)
+
+> 本文件为 **G12 需求/源码变更→测试用例** 的派生产物,对应 R227 窗口(基线 `b6080f3b1` → `ae2196a31`)新增能力:
+> - 实现提交:`ae2196a31`(S-cfc-406 团队池建池实现使绿),触及 6 个后端源码文件:
+>   `CfTeamPoolOrder` / `CfTeamShareConfig`(实体)、两 Mapper、`TeamShareConfigService`、`CfCommissionService`。
+> - 设计溯源:`docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md §2.1/§2.2/§3.1`(分润 v2 团队池);能力键 `cf.teamshare.createPool`(TDD 契约见 `TeamPoolCreateContractTest` 13 例)。
+> - 契约锚点:内部 Service 能力(无 HTTP Controller 入口),经 `CfCommissionService#settleTeamPool` 建池、`TeamShareConfigService#resolveTbps` 解析 T%。
+> - **说明**:本窗口 `docs/superpowers/specs/` 与 `API_REFERENCE.md` 零变更;本派生产物针对「src 新增能力但用例台账空白」的覆盖缺口(G12 补强),非 SRS 文本变更驱动。
+>
+> **派生策略**:三流齐备(正常流 / `-E` 异常流 / `-P` 权限与幂等),口径严格对齐设计文档 §2/§3(T% 优先级链、成本×T% 建池、整单唯一键幂等)。
+> **执行状态**:契约层由 `TeamPoolCreateContractTest`(13 例)自动化覆盖,R227 实测;行为级用例为本台账待执行项(需 DB/订单上下文,本沙箱 9082/3306 不可达,标「待集成环境执行」)。
+
+---
+
+## 一、T% 作用域解析用例(`TeamShareConfigService#resolveTbps`)
+
+| TC 编号 | 环节 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联设计 |
+|---|---|---|---|---|---|---|---|
+| TC-TS-01 | 正常流-MINIAPP 命中 | P0 | 功能 | `cf_team_share_config` 存在 enabled=1 的 MINIAPP 行(owner_id=mpCode 'x1'),t_bps=2500 | 1. `resolveTbps("x1", 100L)` | 返回 2500;不查下游作用域 | §2.1 优先级链 |
+| TC-TS-02 | 正常流-SYSTEM 命中 | P0 | 功能 | MINIAPP 无配置;SYSTEM 行(owner_id='100')enabled=1 t_bps=2000 | 1. `resolveTbps(null, 100L)` 或 MINIAPP miss | 返回 2000 | §2.1 |
+| TC-TS-03 | 正常流-GLOBAL 命中 | P0 | 功能 | MINIAPP/SYSTEM 均无;GLOBAL 行(owner_id IS NULL)enabled=1 t_bps=1500 | 1. `resolveTbps(null, null)` | 返回 1500(IS NULL 匹配,非 `= NULL`) | §2.1 |
+| TC-TS-04 | 正常流-代码兜底 | P0 | 功能 | 三作用域均无启用配置;CF `cf.team_pool.default_t_bps`=3000 | 1. `resolveTbps("none", 999L)` | 返回 3000(代码兜底 DEFAULT_T_BPS) | §2.1 |
+| TC-TS-05 | 优先级-MINIAPP 覆盖 SYSTEM/GLOBAL | P1 | 功能 | 三作用域均配置不同 t_bps | 1. `resolveTbps(有效mpCode, 有效systemId)` | 返回 MINIAPP 值(粒度最细优先) | §2.1 |
+| TC-TS-06 | 异常-参数空白跳过 MINIAPP | P1 | 异常 | SYSTEM 有配置 | 1. `resolveTbps("  ", 100L)`(空白 mpCode) | 跳过 MINIAPP,返回 SYSTEM 值 | §2.1 |
+| TC-TS-07 | 异常-DB 查询失败降级 | P1 | 异常 | Mapper 抛异常 | 1. `resolveTbps(...)` | 按未命中处理(catch 后走兜底),不抛出、不 5xx | 契约单测依赖链 |
+| TC-TS-08 | 边界-缓存 TTL 60s | P2 | 功能 | 首次解析后修改配置 | 1. 解析→改 t_bps→60s 内再解析→60s 后再解析 | 60s 内命中旧值;TTL 后取新值 | §2.1 本地缓存 |
+
+---
+
+## 二、团队池建池用例(`CfCommissionService#settleTeamPool`)
+
+| TC 编号 | 环节 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联设计 |
+|---|---|---|---|---|---|---|---|
+| TC-TS-11 | 正常流-商品订单建池 | P0 | 功能 | 已支付商品订单(paidAmountCent>0、productId、成本 C、T=3000bps) | 1. `settleTeamPool(orderId,'PRODUCT',buyerUser,buyerFamily,paidCent,productId)` | 写 `cf_team_pool_order` 一行:pool_cent=floor(Σ C_i×qty×T/10000)、t_bps=3000、status=pooled;order_type+order_id 唯一 | §2.2/§3.1 |
+| TC-TS-12 | 正常流-T=0 跳过建池 | P1 | 功能 | 解析 T=0 | 1. 调 settleTeamPool | 不写池记录(T=0 团队池跳过),不影响 base/直推/间推/R0/R1 | §1.3 T=0 |
+| TC-TS-13 | 幂等-重复建池 | P0 | 功能 | 同一订单已建池 | 1. 同参数再次 settleTeamPool | 唯一键 `uk_order(order_type,order_id)` 命中:直接返回,不重复插入(三层兜底第一层) | §7 风险1 幂等 |
+| TC-TS-14 | 边界-亏损仓仍按成本建池 | P1 | 功能 | A<C×qty(base<0);`cf.team_pool.on_loss=payout` | 1. 调 settleTeamPool | 团队池仍按成本×T% 发放(成本切出与 base 无关);直推/间推=0 不为负 | §1.3 亏损仓 |
+| TC-TS-15 | 边界-实付=0 | P1 | 功能 | paidAmountCent=0,成本 C>0 | 1. 调 settleTeamPool | R0/R1/base/直推/间推=0;团队池仍按成本×T% 建池 | §1.3 实付0 |
+| TC-TS-16 | 异常-依赖缺失降级 | P1 | 异常 | mapper/service .bean 为 null(未注入) | 1. 调 settleTeamPool | 走空值守卫直接返回,不 NPE | 契约单测依赖链 |
+| TC-TS-17 | 边界-非商品订单建池 | P1 | 功能 | 会员/订阅/测评订单,C'=A×50% | 1. `settleTeamPool(...,productId=null)` | pool_cent=floor(C'×T/10000)=floor(A×50%×30%),按 §1.3 非商品口径 | §1.3 非商品 |
+
+---
+
+## 三、执行与自动化映射
+
+| 用例簇 | 自动化载体 | 状态 |
+|---|---|---|
+| TC-TS-01~08(T% 解析) | `cfc-backend/src/test/java/com/etotem/cfc/unit/TeamPoolCreateContractTest.java`(resolveTbps 依赖链 + 常量 + 实体断言) | 契约层 R227 实测;行为级(#05~08)待集成环境 |
+| TC-TS-11~17(建池) | 同上契约单测(settleTeamPool 方法存在性 + RULE_TEAM_POOL 常量 + 建池链路) | 契约层 R227 实测;金额/幂等/边界需 DB 集成环境 |
+| 后续 T05 瓜分 | `cf.teamshare.weightedShare` → `TeamShareWeightedContractTest` | 研发 TDD 池 pending,后续轮次覆盖 |
+
+> 注:本能力为后端内部结算逻辑,无浏览器入口 UI,E2E 不适用;集成环境(MySQL 3306 + 9082)恢复后按行为级用例补跑金额/幂等/边界断言。