Explorar el Código

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

Sisyphus hace 4 días
padre
commit
5becd6c84d

+ 242 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/AuthAccountDeactivateContractTest.java

@@ -0,0 +1,242 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.config.JwtConfig;
+import com.etotem.cfc.config.JwtInterceptor;
+import com.etotem.cfc.entity.User;
+import com.etotem.cfc.mapper.AssessmentOrderMapper;
+import com.etotem.cfc.mapper.FamilyMemberMapper;
+import com.etotem.cfc.mapper.PaymentOrderMapper;
+import com.etotem.cfc.mapper.UserMapper;
+import com.etotem.cfc.service.AccountCleanupService;
+import io.jsonwebtoken.Claims;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.MockitoAnnotations;
+
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.util.Collections;
+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.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * 契约级单测:账号注销(能力键 {@code auth.account.deactivate})。
+ *
+ * <p><b>契约来源</b></p>
+ * <ul>
+ *   <li>需求:tests/user-scenarios/应用场景总览.md SC-P-71(账号注销:申请 → 身份验证 → 冷静期 → 数据归档/删除;
+ *       边界:有进行中订单/未结清拦截;注销后不可登录);TC-P-71 / TC-P-71-E / TC-P-71-P;业务域 J 账号与数据主权。</li>
+ *   <li>设计:docs/superpowers/api/API_REFERENCE.md §4.1 认证与用户(/api/auth、/api/user)、§4.65.5;
+ *       现有 {@code POST /api/user/deactivate} → {@link AccountCleanupService#deactivateAccount(Long)}
+ *       (立即匿名化 + 未完成订单/测评拦截)。</li>
+ * </ul>
+ *
+ * <p><b>契约缺口(RED 预期)</b>:SC-P-71 要求「申请 → 身份验证 → 冷静期 → 数据归档/删除」四段闭环,
+ * 而 src/main 现状为<b>单段立即匿名化</b>:缺少<b>身份验证前置</b>、缺少<b>冷静期</b>(申请后即 deleted=1,
+ * 无等待/撤回窗口)、注销后不可登录仅靠「清空 phone + 哈希 openid」incidental 达成,
+ * {@code JwtInterceptor} 无 {@code deleted=1} 拦截(TC-P-71-E 要求注销后原 token 失效 401)。
+ * 本测试以「反射结构探测 + 真实行为验证」混合表达该缺口:能编译、能运行、相关断言失败(红),
+ * 失败断言原文可贴;GREEN 阶段补齐两阶段注销与 deleted 拦截后转绿。</p>
+ *
+ * <p><b>已落地部分(GREEN 基线)</b>:进行中订单/未结清测评拦截为契约边界之一,src/main 已实现,
+ * 本测试同时固化其行为(防回归)。参考风格:FamilyJoinValidationRulesContractTest(红门禁 + 绿正常流混合)。</p>
+ *
+ * <p>纯 Mockito/反射,无 Spring 容器 / 无 DB / 无外部服务。</p>
+ */
+class AuthAccountDeactivateContractTest {
+
+    private static final Long USER_ID = 200L;
+    private static final Long FAMILY_ID = 100L;
+
+    // ---------------- 被测:账号清理服务(真实实现 + mock mappers) ----------------
+    @Mock
+    private UserMapper userMapper;
+
+    @Mock
+    private PaymentOrderMapper paymentOrderMapper;
+
+    @Mock
+    private AssessmentOrderMapper assessmentOrderMapper;
+
+    @Mock
+    private FamilyMemberMapper familyMemberMapper;
+
+    @InjectMocks
+    private AccountCleanupService accountCleanupService;
+
+    // ---------------- 被测:登录门禁(真实实现 + mock 依赖) ----------------
+    @Mock
+    private JwtConfig jwtConfig;
+
+    @InjectMocks
+    private JwtInterceptor jwtInterceptor;
+
+    @BeforeEach
+    void setUp() {
+        MockitoAnnotations.openMocks(this);
+    }
+
+    // ==================================================================
+    // GREEN 基线:进行中订单 / 未结清测评 拦截(契约边界,已落地)
+    // ==================================================================
+
+    @Test
+    @DisplayName("GREEN基线-1:有未完成支付订单 → 拦截注销,不匿名化")
+    void 有未完成支付订单_拦截注销_不匿名化() {
+        User user = new User();
+        user.setId(USER_ID);
+        user.setFamilyId(FAMILY_ID);
+        when(userMapper.selectById(USER_ID)).thenReturn(user);
+        when(paymentOrderMapper.selectCount(any())).thenReturn(1L); // 有 pending 支付订单
+        when(assessmentOrderMapper.selectCount(any())).thenReturn(0L);
+
+        Map<String, Object> result = accountCleanupService.deactivateAccount(USER_ID);
+
+        assertEquals(Boolean.FALSE, result.get("canDeactivate"),
+                "有进行中订单必须拦截注销(SC-P-71 边界)");
+        assertEquals("您有未完成的订单,请先处理后再注销账号", result.get("message"));
+        // 未通过门禁不得匿名化/软删
+        verify(userMapper, never()).updateById(any(User.class));
+    }
+
+    @Test
+    @DisplayName("GREEN基线-2:有未结清测评订单 → 拦截注销,不匿名化")
+    void 有未结清测评订单_拦截注销_不匿名化() {
+        User user = new User();
+        user.setId(USER_ID);
+        user.setFamilyId(null); // 无家庭支付订单,走测评检查
+        when(userMapper.selectById(USER_ID)).thenReturn(user);
+        when(assessmentOrderMapper.selectCount(any())).thenReturn(1L); // 有 pending 测评订单
+
+        Map<String, Object> result = accountCleanupService.deactivateAccount(USER_ID);
+
+        assertEquals(Boolean.FALSE, result.get("canDeactivate"),
+                "有未结清测评必须拦截注销(SC-P-71 边界)");
+        assertEquals("您有未完成的测评,请先处理后再注销账号", result.get("message"));
+        verify(userMapper, never()).updateById(any(User.class));
+    }
+
+    // ==================================================================
+    // RED:身份验证 + 冷静期 —— 两阶段注销入口应存在(申请 / 确认)
+    // ==================================================================
+
+    @Test
+    @DisplayName("RED-1:应提供「申请注销+身份验证」入口 applyDeactivate(身份验证前置)")
+    void 应提供申请注销入口_含身份验证() {
+        Class<?> svc = loadClass("com.etotem.cfc.service.AccountCleanupService");
+        assertNotNull(svc, "AccountCleanupService 应存在");
+        assertTrue(hasMethod(svc, "applyDeactivate"),
+                "[auth.account.deactivate] AccountCleanupService 应提供 applyDeactivate(...) 入口承载"
+                        + "「申请 + 身份验证」阶段:SC-P-71 要求 申请 → 身份验证 → 冷静期 → 数据归档/删除 两阶段闭环,"
+                        + "当前仅有立即匿名化的 deactivateAccount(userId),缺少身份验证前置与申请阶段。");
+    }
+
+    @Test
+    @DisplayName("RED-2:应提供「冷静期满确认注销」入口 confirmDeactivate(数据归档/删除)")
+    void 应提供确认注销入口_冷静期满后归档删除() {
+        Class<?> svc = loadClass("com.etotem.cfc.service.AccountCleanupService");
+        assertNotNull(svc, "AccountCleanupService 应存在");
+        assertTrue(hasMethod(svc, "confirmDeactivate"),
+                "[auth.account.deactivate] AccountCleanupService 应提供 confirmDeactivate(...) 入口承载"
+                        + "「冷静期满 → 数据归档/删除」阶段:申请进入冷静期后,须在冷静期结束才执行最终删除,"
+                        + "当前缺失确认阶段。");
+    }
+
+    @Test
+    @DisplayName("RED-3:User 实体应承载注销冷静期状态与申请时间")
+    void 用户实体应承载冷静期状态与申请时间() {
+        Class<?> user = loadClass("com.etotem.cfc.entity.User");
+        assertNotNull(user, "User 实体应存在");
+        boolean hasStatus = hasField(user, "deactivateStatus");
+        boolean hasApplyAt = hasField(user, "deactivateApplyAt");
+        assertTrue(hasStatus && hasApplyAt,
+                "[auth.account.deactivate] User 实体应承载注销冷静期状态(deactivateStatus)与申请时间(deactivateApplyAt),"
+                        + "以支撑「申请 → 冷静期 → 确认」两阶段注销;当前实体无任何冷静期字段,"
+                        + "无法在申请后保留可撤回的等待窗口。");
+    }
+
+    // ==================================================================
+    // RED:注销后不可登录 —— 已注销(deleted=1)账号持有效 token 应被 401 拒绝
+    // ==================================================================
+
+    @Test
+    @DisplayName("RED-4:已注销账号携有效 token 访问受保护路径 → 401 拒绝(注销后不可登录)")
+    void 已注销账号携有效token_访问受保护路径应401拒绝() throws Exception {
+        HttpServletRequest request = mock(HttpServletRequest.class);
+        HttpServletResponse response = mock(HttpServletResponse.class);
+        StringWriter sw = new StringWriter();
+        when(response.getWriter()).thenReturn(new PrintWriter(sw));
+
+        when(request.getMethod()).thenReturn("POST");
+        when(request.getRequestURI()).thenReturn("/api/family/member/list");
+        when(request.getHeader("Authorization")).thenReturn("Bearer valid-token");
+
+        Claims claims = mock(Claims.class);
+        when(claims.getSubject()).thenReturn(String.valueOf(USER_ID));
+        when(claims.get("role")).thenReturn("parent");
+        when(claims.get("roles")).thenReturn(Collections.singletonList("parent"));
+        when(jwtConfig.parseToken("valid-token")).thenReturn(claims);
+
+        User deletedUser = new User();
+        deletedUser.setId(USER_ID);
+        deletedUser.setDeleted(1); // 已注销
+        when(userMapper.selectById(USER_ID)).thenReturn(deletedUser);
+        when(familyMemberMapper.selectOne(any())).thenReturn(null);
+
+        boolean result = jwtInterceptor.preHandle(request, response, null);
+
+        assertFalse(result,
+                "[auth.account.deactivate] 已注销(deleted=1)账号即使持有效 token 也应被拒绝"
+                        + "(SC-P-71 / TC-P-71-E:注销后不可登录、原 token 失效 401);"
+                        + "当前 JwtInterceptor 未校验 deleted 标记,已注销用户仍可访问受保护路径。");
+        verify(response).setStatus(HttpServletResponse.SC_UNAUTHORIZED);
+    }
+
+    // ==================================================================
+    // 反射辅助(与 TeamProfitHookContractTest 同风格)
+    // ==================================================================
+
+    private Class<?> loadClass(String name) {
+        try {
+            return Class.forName(name, false, Thread.currentThread().getContextClassLoader());
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+
+    private boolean hasMethod(Class<?> clazz, String name) {
+        for (Method m : clazz.getDeclaredMethods()) {
+            if (m.getName().equals(name)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private boolean hasField(Class<?> clazz, String name) {
+        for (Class<?> c = clazz; c != null; c = c.getSuperclass()) {
+            for (Field f : c.getDeclaredFields()) {
+                if (f.getName().equals(name)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}

+ 212 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/PlanConfirmSubmitContractTest.java

@@ -0,0 +1,212 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.controller.growth.GrowthPlanController;
+import com.etotem.cfc.entity.GrowthPlan;
+import com.etotem.cfc.mapper.FamilyMemberMapper;
+import com.etotem.cfc.mapper.GrowthPlanMapper;
+import com.etotem.cfc.mapper.UserMapper;
+import com.etotem.cfc.service.GrowthPlanService;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestAttribute;
+
+import java.lang.annotation.Annotation;
+import java.lang.reflect.Method;
+import java.lang.reflect.Parameter;
+import java.util.Arrays;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * 契约级单测:能力键 {@code plan.confirm.submit}(SC-P-44 确认方案 · SC-P-45 方案直接发布)。
+ *
+ * <p><b>契约锚点</b></p>
+ * <ul>
+ *   <li>需求:{@code docs/tdd/orchestration/sc-key-map.md} SC-P-44 / SC-P-45(家长端方案生命周期),
+ *       两行能力键均为 {@code plan.confirm.submit},状态 RED / 未通过,任务 S-cfc-281:
+ *       SC-P-44 = 家长确认/送审,generated→reviewed 确认态流转;SC-P-45 = 方案直接发布(应直接 active)。</li>
+ *   <li>设计:{@code docs/superpowers/api/API_REFERENCE.md} §4.6 ——
+ *       {@code GrowthPlanController /api/growth/plan/*}(create 创建 / {@code /{id}/review} 复盘)。
+ *       状态机参照 {@code PlanReviewController}(TaskPlanInstance:generated→reviewed→active,
+ *       「方案状态异常」守卫)。</li>
+ * </ul>
+ *
+ * <p><b>实现现状(2026-11-14 实测 origin/cfclub @64ac74d1f)</b>:
+ * {@code GrowthPlanController} 无 confirm / submit / 发布端点;{@code /{id}/review} 无 role/roles
+ * 请求属性(与同域 {@code listPlans} 的 RolesUtil.hasTeacherRole 门禁不同构);
+ * {@code GrowthPlanService} 无 {@code confirmPlan} 方法,{@code createPlan} 默认 {@code status="active"}
+ * (违背「未确认不可激活」),{@code reviewPlan} 仅 reviewCount+1、无 generated→reviewed 状态流转、
+ * 无越状态守卫;{@code GrowthPlan.status} 注释仅 draft/active/completed/expired(无 generated/reviewed 态)。
+ * 本测试以这些缺口为 RED 锚点:断言在 GREEN 阶段补齐前失败(红)。</p>
+ *
+ * <p><b>测试范围</b>:纯 Mockito / 反射 / 无 Spring / 无 DB / 无外部服务;断言不依赖真实外部服务。
+ * 六例 RED:正常流(confirm / submit 端点载体探针、confirmPlan 方法载体探针)、行为(未确认不可激活、
+ * reviewPlan 状态流转 reviewed、越状态守卫抛异常)、权限流(reviewPlan 角色门禁探针)。</p>
+ *
+ * <p><b>RED 预期</b>:6/6 失败——端点/方法缺失经反射探针(assertNotNull 失败);行为断言
+ * (status==active、review 后未流转、未抛异常)与当前实现不符而失败;权限门禁缺失经 assertRoleGate 失败。
+ * 断言原文均含能力键前缀 {@code [plan.confirm.submit]} 供 GREEN 阶段实现者贴原文。</p>
+ */
+class PlanConfirmSubmitContractTest extends AssessmentPlanContractTestBase {
+
+    // ==================== 正常流-1:确认 / 发布端点载体(RED:当前无 confirm/submit 端点) ====================
+
+    @Test
+    @DisplayName("SC-P-44 正常:GrowthPlanController 应暴露确认方案端点(confirmPlan/confirm,POST)——当前未落地")
+    void controller_confirm_endpointCarrier() {
+        Method m = findMethodByNames(GrowthPlanController.class, "confirmPlan", "confirm");
+        assertNotNull(m,
+                "[plan.confirm.submit] GrowthPlanController(/api/growth/plan/*)未暴露确认方案端点"
+                        + "(confirmPlan/confirm,POST,SC-P-44 家长确认方案):"
+                        + "SC-P-44/45 未落地 → 当前实现缺确认端点。");
+        assertTrue(m.isAnnotationPresent(PostMapping.class),
+                "[plan.confirm.submit] confirmPlan 应为 POST 映射(框架统一 POST 约定,禁止 Get/Put/Delete)。");
+    }
+
+    @Test
+    @DisplayName("SC-P-45 正常:GrowthPlanController 应暴露方案发布端点(submitPlan/publishPlan,POST)——当前未落地")
+    void controller_submit_endpointCarrier() {
+        Method m = findMethodByNames(GrowthPlanController.class, "submitPlan", "publishPlan", "submit");
+        assertNotNull(m,
+                "[plan.confirm.submit] GrowthPlanController(/api/growth/plan/*)未暴露方案发布端点"
+                        + "(submitPlan/publishPlan,POST,SC-P-45 方案直接发布):"
+                        + "SC-P-45 未落地 → 当前实现缺发布端点。");
+        assertTrue(m.isAnnotationPresent(PostMapping.class),
+                "[plan.confirm.submit] 发布端点应为 POST 映射(框架统一 POST 约定,禁止 Get/Put/Delete)。");
+    }
+
+    // ==================== 正常流-2:confirmPlan 方法载体(RED:当前无) ====================
+
+    @Test
+    @DisplayName("SC-P-44/45 正常:GrowthPlanService 应含 confirmPlan 方法(确认幂等)——当前未落地")
+    void service_confirmPlan_methodCarrier() {
+        Method m = findMethod(GrowthPlanService.class, "confirmPlan");
+        assertNotNull(m,
+                "[plan.confirm.submit] GrowthPlanService 未含 confirmPlan 方法"
+                        + "(SC-P-44/45 确认/发布方案,确认幂等):SC-P-44/45 未落地 → 当前缺该方法。");
+    }
+
+    // ==================== 行为:未确认不可激活(RED:createPlan 默认 active) ====================
+
+    @Test
+    @DisplayName("SC-P-44 行为:新建方案(未确认)不应直接激活为 active——当前默认 active")
+    void behavior_create_unconfirmed_notActive() throws Exception {
+        GrowthPlanService svc = new GrowthPlanService();
+        inject(svc, "growthPlanMapper", mock(GrowthPlanMapper.class));
+        inject(svc, "familyMemberMapper", mock(FamilyMemberMapper.class));
+        inject(svc, "userMapper", mock(UserMapper.class));
+
+        GrowthPlan plan = new GrowthPlan();
+        plan.setMemberId(10L);
+        plan.setPlanTitle("SC-P-44 确认方案契约");
+        svc.createPlan(plan);
+
+        assertNotEquals("active", plan.getStatus(),
+                "[plan.confirm.submit] 新建方案(未确认)不应直接激活为 active:"
+                        + "按 SC-P-44/45 状态机应先处于待确认态(generated),家长确认/审核通过后才流转为 active。"
+                        + "当前 createPlan 默认 status=active → 违背「未确认不可激活」。");
+    }
+
+    // ==================== 行为:reviewPlan 状态流转(RED:仅 reviewCount+1,无流转) ====================
+
+    @Test
+    @DisplayName("SC-P-44 行为:reviewPlan 审核通过后状态应流转为 reviewed(generated→reviewed→active)——当前未流转")
+    void behavior_review_transitionsToReviewed() throws Exception {
+        GrowthPlanService svc = new GrowthPlanService();
+        GrowthPlanMapper mapper = mock(GrowthPlanMapper.class);
+        inject(svc, "growthPlanMapper", mapper);
+        inject(svc, "familyMemberMapper", mock(FamilyMemberMapper.class));
+        inject(svc, "userMapper", mock(UserMapper.class));
+
+        GrowthPlan plan = new GrowthPlan();
+        plan.setId(501L);
+        plan.setStatus("generated");
+        when(mapper.selectById(501L)).thenReturn(plan);
+        when(mapper.updateById(any(GrowthPlan.class))).thenReturn(1);
+
+        svc.reviewPlan(501L);
+
+        assertEquals("reviewed", plan.getStatus(),
+                "[plan.confirm.submit] reviewPlan 审核通过后方案状态应流转为 reviewed"
+                        + "(generated→reviewed→active,参照 PlanReviewController 状态机):"
+                        + "当前实现未流转,仅 reviewCount+1。");
+    }
+
+    // ==================== 行为:越状态守卫(RED:任意状态均可 review 通过) ====================
+
+    @Test
+    @DisplayName("SC-P-44 异常:非 generated 状态调 reviewPlan 应抛 IllegalStateException(状态守卫)——当前无守卫")
+    void behavior_review_wrongState_throws() throws Exception {
+        GrowthPlanService svc = new GrowthPlanService();
+        GrowthPlanMapper mapper = mock(GrowthPlanMapper.class);
+        inject(svc, "growthPlanMapper", mapper);
+        inject(svc, "familyMemberMapper", mock(FamilyMemberMapper.class));
+        inject(svc, "userMapper", mock(UserMapper.class));
+
+        GrowthPlan plan = new GrowthPlan();
+        plan.setId(502L);
+        plan.setStatus("active");
+        when(mapper.selectById(502L)).thenReturn(plan);
+
+        assertThrows(IllegalStateException.class, () -> svc.reviewPlan(502L),
+                "[plan.confirm.submit] 非待审核状态(如 active)调 reviewPlan 应拒绝:"
+                        + "按 SC-P-44 状态机仅 generated 可审核,越状态应抛异常"
+                        + "(参照 PlanReviewController「方案状态异常」守卫):"
+                        + "当前无状态守卫,任意状态均 reviewCount+1 通过。");
+    }
+
+    // ==================== 权限流:reviewPlan 角色门禁(RED:无 role/roles 输入) ====================
+
+    @Test
+    @DisplayName("权限流:GrowthPlanController.reviewPlan 应暴露 role/roles 输入(teacher/admin 门禁)——当前未落地")
+    void permission_reviewPlan_roleGate() {
+        assertRoleGate(GrowthPlanController.class, "reviewPlan",
+                "[plan.confirm.submit] GrowthPlanController.reviewPlan(POST /api/growth/plan/{id}/review)"
+                        + "未暴露 role/roles 请求属性:规划师/家长确认审核方案应校验 teacher/admin 角色"
+                        + "(参照同域 listPlans 的 RolesUtil.hasTeacherRole 门禁)。角色门禁未落地。");
+    }
+
+    // ==================== 反射/断言辅助 ====================
+
+    /** 按多个候选名查找方法(按序匹配第一个存在者),用于端点载体探针。 */
+    private Method findMethodByNames(Class<?> clazz, String... names) {
+        for (Method m : clazz.getDeclaredMethods()) {
+            for (String n : names) {
+                if (m.getName().equals(n)) return m;
+            }
+        }
+        return null;
+    }
+
+    private Method findMethod(Class<?> clazz, String name) {
+        return findMethodByNames(clazz, name);
+    }
+
+    /** 权限流探针:断言处理方法至少暴露一个 @RequestAttribute("role"|"roles") 输入。 */
+    private void assertRoleGate(Class<?> clazz, String method, String failMsg) {
+        Method m = findMethod(clazz, method);
+        assertNotNull(m, failMsg + " 方法 " + method + " 不存在。");
+        boolean hasRoleInput = false;
+        for (Parameter p : m.getParameters()) {
+            for (Annotation a : p.getAnnotations()) {
+                if (a instanceof RequestAttribute) {
+                    String attr = ((RequestAttribute) a).value();
+                    if ("role".equals(attr) || "roles".equals(attr)) {
+                        hasRoleInput = true;
+                        break;
+                    }
+                }
+            }
+            if (hasRoleInput) break;
+        }
+        assertTrue(hasRoleInput, failMsg);
+    }
+}

+ 131 - 0
docs/tdd/orchestration/report-dev-2026-11-14-0355.md

@@ -0,0 +1,131 @@
+# 研发负责人工作汇报(错峰 第157轮 · 自动化无人值守)
+
+> 本轮为「研发负责人」定时自动化错峰轮(无人值守),基于 tdd-orchestrator skill 全自动闭环,只认已推送远端 git 真理证据。填报时间 2026-11-14 03:20 ~ 03:55。
+
+---
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 汇报人 | 研发负责人(AI 自动化错峰轮) |
+| 汇报周期 | 2026-11-14 03:20 ~ 03:55(错峰 第157轮,本自动化) |
+| 负责模块/单元范围 | 全量(CFC 用户场景端到端跑通闭环:开发侧实现使绿 + 派发 + 部署收口 + 场景台账) |
+
+---
+
+## 一、本轮工作数据汇总
+
+### 1.1 问题接收与处置
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **收到的测试反馈问题数*** | 0 个 | 本轮无新增 `--mark-blocked` 登记;阻塞查询受角色门禁(研发角色只读不可查,沿用上轮口径 0 阻塞) |
+| **已解决问题数*** | 1 个 | `--resume` 恢复 1 个 outcome=interrupted 中断会话(local-lan-4090 DeadPool分流 248,见 1.2b) |
+| **待解决研发问题数** | 0 个新增 | 沿用历史遗留:RED 64 键全缺 red_sha(测试侧契约证据未落地,转测试侧补证);YELLOW 123 键待测试 mark-green(闭环最大卡点);部署 pending 30 在途归测试/部署侧(O-24) |
+
+### 1.2 任务分发与会话管理
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **分派任务数*** | 2 个 | **精确派发 2 条 pending GREEN 实现任务**(不用 `--auto`,避免误派前 18 条 RED 契约测试任务):S-cfc-309 teacher.report.proxy(→mes-local-45278,ses_e29966c8…)、S-cfc-311 admin.reportParser.manage(→local-lan-4090,ses_e2995c0b…) |
+| **恢复智能体会话数*** | 1 个 | `--resume` 实际恢复 1 个:local-lan-4090「DeadPool分流 248 (4 tasks)」(ses_e398e645dffeOESshSjKyT3U0b),原因 outcome=interrupted;prod-etotem 生产实例默认跳过;并发未满放行 |
+| **当前在用会话数** | 中负载 | 5 节点在途派发合计 51 条(lan-189 10 / mes-local-45278 17 / lan-204 8 / local-lan-4090 9 / pub-iwintrue 7),全部有任务在途,无空闲会话 |
+| **会话平均利用率** | 满载运转 | 49 dispatched → 51 dispatched + 1 恢复续跑,所有会话均已分派任务(满足「不留空闲」纪律) |
+
+### 1.2b 各会话当前工作状态列表
+
+| 会话标签 | 会话 ID | 当前状态 | 当前任务 | 备注 |
+|----------|---------|----------|----------|------|
+| local-lan-4090 | ses_e398e645dffeOESshSjKyT3U0b | running(恢复) | DeadPool分流 248(4 tasks) | 本轮 interrupted 恢复 |
+| local-lan-4090 | ses_e2995c0bdffe0hOqVNdsMtD7wh | running(新派) | S-cfc-311 admin.reportParser.manage GREEN | 本轮新派 |
+| mes-local-45278 | ses_e29966c8effeT3n2cFIpNuRytU | running(新派) | S-cfc-309 teacher.report.proxy GREEN | 本轮新派 |
+| lan-189 | — | running(在途既有) | 既有在途 10 条 | 黑窗=False |
+| lan-204 | — | running(在途既有) | 既有在途 8 条 | 黑窗=False |
+| pub-iwintrue | — | running(在途既有) | 既有在途 7 条 | 黑窗=False |
+| cfc-test(部署) | — | running | 部署在途 pending 30 / confirmed 77(O-24 归测试/部署侧) | 待 --deploy-done 收口 |
+| cfc-prod(部署) | — | idle | 无生产部署(confirm 门) | 默认跳过 |
+
+### 1.3 变更感知与新任务建立
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **感知需求/设计变更数*** | 0 次 | 无新增能力键;主线新合入均为测试侧 RED 契约(S-cfc-262 task.frequency.config 11例 / S-cfc-253 butler.resource.match 9例 / S-cfc-272 growth.milestone.mark / S-cfc-250 merge) |
+| **新增入池任务数*** | 0 个 | peer GREEN 实现池仍有 34 条待派(S-cfc-313 起),无 --add-task 需求 |
+| **既有键状态流转数** | 0 次显式 mark-* | 状态机 210 键零漂移(RED 64 / YELLOW 123 / GREEN 8 / DONE 15) |
+
+### 1.4 本轮 git 提交与推送证据(真理证据)
+
+| 提交 sha | 关联任务/能力键 | 阶段 | 触及文件类型 | 目标分支 | 已推送远端 | 备注 |
+|----------|-----------------|------|--------------|----------|------------|------|
+| 本轮汇报 commit(见附录 D) | 错峰 第157轮汇报 | other/docs | docs/tdd/orchestration | cfclub | 是 | 单文件 hash-object + 临时索引,push 后核验 |
+
+> 本轮无阶段 mark-* 登记动作(实现任务在途未回执,待下轮收 GREEN 证据后回填 yellow_sha)。
+
+---
+
+## 二、执行明细
+
+### 2.1 并发互斥前置判定
+- `state.json` / `tasks.json` 最后写盘 **02:50:45**(他轮),本轮启动 **03:20**(距 29.5min > 5min 窗口,且复查 >5.5min 无持续写入)→ 互斥放行,正常执行全链只读 + 恢复 + 派发。
+
+### 2.2 恢复动作(--resume)
+- `--resume --dry-run --resume-explain` 识别 1 候选:local-lan-4090「DeadPool分流 248 (4 tasks)」(outcome=interrupted,A 类直接恢复)→ 实际恢复 1 个 ✓(EXIT=0,`[ok] 已恢复`)。
+- 意义:DeadPool 分流 248 批次含 4 个子任务,中断后若不恢复将静默丢失;恢复后续跑。
+- prod-etotem 生产实例默认跳过(--allow-prod 未启用)。
+
+### 2.3 派发动作(精确 --task,非 --auto)
+- **为什么不用 `--auto --limit N`**:`auto_dispatch` 按 pending 数组顺序取前 N **不按 stage 过滤**,当前 pending 前 18 条全部是 RED 契约任务(测试侧职责)→ 研发侧派发必须 `dispatch.py --task <id>` 精确指定 GREEN 实现任务。
+- 派发前 `dispatch.py --task S-cfc-309 --json --dry-run` 演练核验指令内容(「实现使绿」语义正确)→ 真实派发:
+  - S-cfc-309 teacher.report.proxy → mes-local-45278 ✓(verified=true,会话 ses_e29966c8effeT3n2cFIpNuRytU)
+  - S-cfc-311 admin.reportParser.manage → local-lan-4090 ✓(verified=true,会话 ses_e2995c0bdffe0hOqVNdsMtD7wh)
+- 两任务账本核验:status=dispatched、tdd_stage=GREEN、dispatch_instance 正确、session 已登记 ✓。
+- 自动派发合计:**成功 2 / 失败 0 / 跳过 0**;黑窗=False(-→-,各节点无 opencode 429 黑窗)。
+
+### 2.4 在途任务核验(git 真理证据)
+| 任务 | 核验结果 |
+|------|----------|
+| S-cfc-248 ai.coach.recommend(RED 契约) | `9add35ddc` Merge branch 'task/S-cfc-248' IN CHAIN ✓(已由他轮 02:34 合主线,账本仍 dispatched = 登记滞后,归测试侧回执) |
+| S-cfc-228 teacher.plan.review | 分支独立提交 `da981a2d8 feat(teacher.plan.review): SC-T-28 AI方案内容安全复核闭环` ✓(在途推进) |
+| S-cfc-238 teacher.plan.create | 分支提交 `a4a9b7ac0 feat(backend): 角色门禁落地(TrainingPlan/GrowthPlan create/update 增加 teacher/admin 校验)` ✓(在途推进) |
+| 主线 tip | `a80750b84`(origin/cfclub),新合入 S-cfc-262/253/272/250 测试契约 ✓ |
+
+### 2.5 工作目录门禁(--clean-check)
+- 主工作树 **922 处未提交改动**(他轮/他会话 WIP:.gitignore、.tdd/*.log 删除态、tests、cfc-backend 等)——按纪律④**只读零触碰**,不 git add -A、不 stash、不 reset。本轮无业务代码变更,无需 commit+push(汇报文档单文件精确入库,见附录 D)。
+
+### 2.6 部署状态(O-24 归测试/部署侧)
+- 部署在途 pending 30 / confirmed 77;本轮未新增部署派发,未收口条目(testing@0a01a0e8、testing@f6590c89 等多笔)仍归测试/部署侧闭环,研发侧无动作可施加。
+
+---
+
+## 三、本轮结论与下一步
+
+### 3.1 结论
+- **本轮为错峰 GREEN 实现续派轮**:核心产出 = 恢复 1 个 interrupted 会话(DeadPool 248)+ 精确派发 2 条 GREEN 实现任务(S-cfc-309/311,避开 RED 契约池),dispatch 在途 49→51,pending 54→52(GREEN 36→34、RED 18 持平),全节点无空闲会话。
+- 状态机总量:RED 64 / YELLOW 123 / GREEN 8 / DONE 15(合计 210 键),与上轮持平(本轮无 mark-* 流转)。
+- 场景台账:**15/241 已跑通**(O-3 收口 5 + 游客域补证 10),226 未跑通(包含 RED 契约 18 条在途测试任务)。
+- 主线持续推进:a80750b84(新合测试契约 S-cfc-262/253/272/250),S-cfc-248 合链确认 ✓。
+
+### 3.2 下一步事项(事项→依赖→预估完成时间)
+
+| # | 事项 | 依赖 | 预估 |
+|---|------|------|------|
+| 1 | 收 S-cfc-309/311 GREEN 实现产出回执(实现使绿 + push 远端) | 实现会话执行 | 下轮复核 |
+| 2 | 收死池 248 恢复批次产出回执(4 子任务续跑) | local-lan-4090 恢复会话 | 下轮复核 |
+| 3 | 续派 GREEN 实现 pending 池(34 条,2/轮错峰推进,S-cfc-313 起含 admin.dimension.config 等) | 后续错峰轮次 | 持续 |
+| 4 | RED 18 条契约测试任务在途(测试侧续派,S-cfc-197/200/201/198/199/205/203/206/308 等) | 测试侧会话 | 持续 |
+| 5 | YELLOW 123 键待测试 mark-green 校验确认(**闭环最大卡点**) | 测试侧校验,研发无动作 | 持续 |
+| 6 | 部署在途 pending 30 收口(O-24 归测试/部署侧) | 测试/部署侧 | 持续 |
+| 7 | RED 64 键补 red_sha 契约证据(测试侧承接,O-19 终裁) | 测试侧契约批次 | 分批 |
+| 8 | 241 SC 场景证据补建(226 待补,O-25) | 测试侧分批承接 | 持续 |
+
+---
+
+## 附录 D:本轮汇报入库推送(精确单文件)
+
+- 流程:`git hash-object -w <report>` → 临时索引 `git read-tree origin/cfclub^{tree}`(基线=当轮最新 tip a80750b84,避免旧轮 CI bump 回退)→ `update-index --add --cacheinfo` → `write-tree` → `diff-tree` 校验**精确 1 行 A** → `commit-tree` → `push origin <commit>:cfclub` → `git merge-base --is-ancestor` 核验 IN CHAIN ✓ → 临时索引清理。
+- 全程不触碰主工作树 index(922 处他人 WIP 零污染),无 `git add -A` / `git stash` / `reset`。
+
+---
+
+*本汇报由研发负责人自动化错峰轮生成,全部数据来自 `--status`/`--inspect`/`--changes`/`--resume`/`--resume-explain`/`dispatch.py --task --dry-run` 实跑输出与 git 真理证据(`git merge-base --is-ancestor` 核验)。*