Przeglądaj źródła

test(R227): 自动化闭环测试汇报 — 基线 b08d823e8 窗口+32提交(S-cfc-406/409/391/410 四功能)

后端首次全量实跑(R226 为承采):515 类 / 4507 例 / 4140 过 / 352F+11E=363 红 / 4 跳
= 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)。
test-lead-bot 5 dni temu
rodzic
commit
ee81af1f0b

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

+ 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`,与历轮同因,不视为产品回归)。

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

@@ -0,0 +1,303 @@
+# 测试负责人工作汇报 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%」。
+- **红集三分列**:契约前瞻 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 |

+ 14 - 0
docs/tdd/test/blockers.md

@@ -1719,3 +1719,17 @@
 | **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 | 不通过 |

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

@@ -0,0 +1,31 @@
+# 研发通知 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 契约预期红)。

+ 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)恢复后按行为级用例补跑金额/幂等/边界断言。