Parcourir la source

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

Sisyphus il y a 4 jours
Parent
commit
62ab5e45e1

+ 276 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/ActivityCheckinBoostContractTest.java

@@ -0,0 +1,276 @@
+package com.etotem.cfc.unit;
+
+import org.junit.jupiter.api.DisplayName;
+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.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
+
+/**
+ * 契约级单测:活动打卡/助力(营销)进度累计与反刷量(能力键 {@code activity.checkin.boost},单元 activity)。
+ *
+ * <p><b>需求/设计锚点</b></p>
+ * <ul>
+ *   <li>需求:{@code tests/user-scenarios/应用场景总览.md} SC-P-77(活动打卡/助力·营销)——
+ *       主流程「打卡 → 进度累计 → 助力」;异常/边界「重复打卡幂等;刷量/机器行为拦截」;
+ *       CF 值预估「打卡/助力为平台 CF 值产出点,操作入口须按 SC-X-22 展示『本操作预计 +N CF』」</li>
+ *   <li>设计:{@code docs/superpowers/api/API_REFERENCE.md} §4.7 健康打卡(/api/daily/checkin、
+ *       /api/mind/checkin 情绪日记同步)+ 活动打卡(AdminActivityCheckinController
+ *       /api/admin/activity-checkins);模块:活动({@code ActivityService.checkin} 现状为
+ *       一次性签到任务,无进度累计/助力/反刷量/CF 预估)</li>
+ * </ul>
+ *
+ * <p><b>被校验的契约行为</b></p>
+ * <ul>
+ *   <li>打卡 → 进度累计:同一活动下某成员打卡一次,进度 +1;连续打卡逐次累计</li>
+ *   <li>助力 → 进度累计:他人为目标成员助力一次,目标进度 +1;打卡后再助力继续累计</li>
+ *   <li>重复打卡幂等:同一 (activityId, memberId) 重复打卡,进度不重复累计,返回既有进度</li>
+ *   <li>刷量/机器行为拦截:窗口内高频打卡判为刷量应拒绝;同一设备短时关联多账号判为机器行为应拒绝</li>
+ *   <li>CF 值预估(SC-X-22):打卡/助力入口应返回「本操作预计 +N CF」的预估(非负,规则未配置可降级为 0)</li>
+ * </ul>
+ *
+ * <p><b>宿主契约(TDD-RED 锚点)</b>:{@code com.etotem.cfc.service.ActivityCheckinBoostService} ——
+ * 承载活动打卡/助力营销进度的服务类,当前(2026-11-14)<b>尚未实现</b>。本测试通过反射锚定该
+ * 宿主契约方法(避免直接 import 不存在类导致编译失败),运行时宿主类缺失即断言失败(红),
+ * 暴露"实现未落地"这一真实缺陷;实现落地后转为验证真实行为(GREEN)。</p>
+ *
+ * <p><b>契约方法签名(实现方按此落地)</b></p>
+ * <ul>
+ *   <li>{@code int checkin(long activityId, long userId, long memberId, String deviceId)}
+ *       —— 打卡一次,进度 +1,返回该成员本次活动累计进度</li>
+ *   <li>{@code int boost(long activityId, long targetUserId, long helperUserId, String deviceId)}
+ *       —— 助力目标成员,目标进度 +1,返回目标成员累计进度</li>
+ *   <li>{@code int checkinProgress(long activityId, long memberId)}
+ *       —— 查询该成员本次活动累计进度</li>
+ *   <li>{@code int expectedCf(long activityId, String actionType)}
+ *       —— SC-X-22 CF 值预估:actionType ∈ {@code checkin}/{@code boost},返回本操作预计获得 CF
+ *       (规则未配置可降级为 0,不得为负)</li>
+ *   <li>{@code boolean shouldRejectCheckin(int checkinsInWindow, int windowSeconds)}
+ *       —— 刷量拦截判定(纯函数):窗口内打卡次数超过阈值(如 60s 内 ≥ 5 次)应返回 true</li>
+ *   <li>{@code boolean shouldRejectMachineAbuse(int accountsOnDeviceInWindow, int windowHours)}
+ *       —— 机器行为拦截判定(纯函数):同一设备窗口内关联账号数超过阈值(如 1h 内 ≥ 3 账号)应返回 true</li>
+ * </ul>
+ *
+ * <p><b>测试范围</b>:纯契约级单测,无 Spring / 无 DB / 无外部服务依赖(纯 Mockito/反射风格,
+ * 与同批已合入主链的 {@code TeamStarMultiplierContractTest} / {@code TeamProfitHookContractTest} 一致)。</p>
+ *
+ * <p><b>权限流说明</b>:SC-P-77 营销打卡/助力面向已报名活动成员,本契约聚焦进度累计/幂等/反刷量
+ * 与 CF 预估行为,无独立角色权限分支(权限校验由活动报名与身份门禁承载,属 {@code activity.enroll.join}
+ * 范围),故权限流以说明性用例标注不适用。</p>
+ *
+ * <p><b>RED 预期</b>:宿主 {@code ActivityCheckinBoostService} 未实现,全部用例在反射探测处失败(红),
+ * 断言原文为「RED[activity.checkin.boost] 契约宿主 ActivityCheckinBoostService 未实现(实现未落地)」。</p>
+ */
+class ActivityCheckinBoostContractTest {
+
+    /** 规格设计宿主类(未实现)。 */
+    private static final String HOST_CLASS = "com.etotem.cfc.service.ActivityCheckinBoostService";
+
+    // ==================== 契约常量(SC-P-77 边界) ====================
+
+    /** 示例活动 ID(营销活动)。 */
+    private static final long ACTIVITY_ID = 9001L;
+    /** 打卡成员(memberId)。 */
+    private static final long MEMBER_ID = 70001L;
+    /** 打卡操作账号(userId)。 */
+    private static final long USER_ID = 60001L;
+    /** 助力人账号(helperUserId)。 */
+    private static final long HELPER_USER_ID = 60002L;
+    /** 目标成员(targetUserId 对应的 memberId)。 */
+    private static final long TARGET_MEMBER_ID = 70002L;
+    /** 设备指纹(刷量/机器行为拦截维度)。 */
+    private static final String DEVICE_ID = "device-a1b2c3";
+
+    /** 刷量阈值锚点:60 秒窗口内 5 次及以上判为刷量(SC-P-77 反刷量)。 */
+    private static final int ABUSE_CHECKINS = 5;
+    private static final int ABUSE_WINDOW_SECONDS = 60;
+    /** 机器行为阈值锚点:1 小时窗口内同设备 3 个及以上账号判为机器行为。 */
+    private static final int MACHINE_ACCOUNTS = 3;
+    private static final int MACHINE_WINDOW_HOURS = 1;
+
+    // ==================== 正常流:打卡 → 进度累计 ====================
+
+    @Test
+    @DisplayName("正常流-1:首次打卡进度累计为 1")
+    void checkin_firstTime_progressIsOne() {
+        Object host = contractHost();
+        int progress = callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        assertEquals(1, progress, "首次打卡后累计进度应为 1");
+    }
+
+    @Test
+    @DisplayName("正常流-2:连续打卡进度逐次累计")
+    void checkin_consecutive_progressAccumulates() {
+        Object host = contractHost();
+        callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        int progress = callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        assertEquals(3, progress, "连续打卡三次后累计进度应为 3");
+    }
+
+    @Test
+    @DisplayName("正常流-3:checkinProgress 查询返回累计值")
+    void checkinProgress_reflectsAccumulatedValue() {
+        Object host = contractHost();
+        callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        int progress = callInt(host, "checkinProgress", ACTIVITY_ID, MEMBER_ID);
+        assertEquals(2, progress, "查询进度应与两次打卡累计一致(2)");
+    }
+
+    // ==================== 正常流:助力 → 目标进度累计 ====================
+
+    @Test
+    @DisplayName("正常流-4:助力使目标成员进度 +1")
+    void boost_addsOneToTargetProgress() {
+        Object host = contractHost();
+        callInt(host, "checkin", ACTIVITY_ID, USER_ID, TARGET_MEMBER_ID, DEVICE_ID);
+        int progress = callInt(host, "boost", ACTIVITY_ID, USER_ID, HELPER_USER_ID, DEVICE_ID);
+        assertEquals(2, progress, "目标打卡 1 次后再被助力 1 次,目标进度应为 2");
+    }
+
+    @Test
+    @DisplayName("正常流-5:打卡后再助力进度继续累计")
+    void checkinThenBoost_continuesAccumulation() {
+        Object host = contractHost();
+        callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        int progress = callInt(host, "boost", ACTIVITY_ID, USER_ID, HELPER_USER_ID, DEVICE_ID);
+        assertEquals(3, progress, "打卡两次后再助力一次,累计进度应为 3");
+    }
+
+    // ==================== 边界流:重复打卡幂等 ====================
+
+    @Test
+    @DisplayName("边界流-1:重复打卡幂等,进度不重复累计")
+    void duplicateCheckin_idempotent_progressNotDoubleCounted() {
+        Object host = contractHost();
+        callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        int second = callInt(host, "checkin", ACTIVITY_ID, USER_ID, MEMBER_ID, DEVICE_ID);
+        assertEquals(1, second, "同一 (activityId, memberId) 重复打卡不得重复累计进度(幂等)");
+    }
+
+    // ==================== 边界流:刷量 / 机器行为拦截 ====================
+
+    @Test
+    @DisplayName("边界流-2:窗口内高频打卡判为刷量,应拒绝")
+    void highFrequencyCheckin_shouldReject() {
+        Object host = contractHost();
+        boolean reject = callBoolean(host, "shouldRejectCheckin", ABUSE_CHECKINS, ABUSE_WINDOW_SECONDS);
+        assertTrue(reject, "60 秒窗口内 5 次打卡应判为刷量并拒绝(SC-P-77 反刷量)");
+    }
+
+    @Test
+    @DisplayName("边界流-3:正常低频打卡不判刷量")
+    void normalFrequencyCheckin_notRejected() {
+        Object host = contractHost();
+        boolean reject = callBoolean(host, "shouldRejectCheckin", 1, ABUSE_WINDOW_SECONDS);
+        assertFalse(reject, "60 秒窗口内 1 次打卡属正常行为,不应拒绝");
+    }
+
+    @Test
+    @DisplayName("边界流-4:同设备短时多账号判为机器行为,应拒绝")
+    void sameDeviceMultiAccount_shouldReject() {
+        Object host = contractHost();
+        boolean reject = callBoolean(host, "shouldRejectMachineAbuse", MACHINE_ACCOUNTS, MACHINE_WINDOW_HOURS);
+        assertTrue(reject, "1 小时窗口内同设备 3 个账号应判为机器行为并拒绝");
+    }
+
+    @Test
+    @DisplayName("边界流-5:同设备单账号不判机器行为")
+    void sameDeviceSingleAccount_notRejected() {
+        Object host = contractHost();
+        boolean reject = callBoolean(host, "shouldRejectMachineAbuse", 1, MACHINE_WINDOW_HOURS);
+        assertFalse(reject, "1 小时窗口内同设备 1 个账号属正常,不应判机器行为");
+    }
+
+    // ==================== CF 值预估流(SC-X-22) ====================
+
+    @Test
+    @DisplayName("CF预估-1:打卡入口应返回预计获得 CF(非负)")
+    void expectedCf_checkin_nonNegative() {
+        Object host = contractHost();
+        int cf = callInt(host, "expectedCf", ACTIVITY_ID, "checkin");
+        assertTrue(cf >= 0, "打卡入口应返回『本操作预计 +N CF』预估(SC-X-22),cf=" + cf);
+    }
+
+    @Test
+    @DisplayName("CF预估-2:助力入口应返回预计获得 CF(非负)")
+    void expectedCf_boost_nonNegative() {
+        Object host = contractHost();
+        int cf = callInt(host, "expectedCf", ACTIVITY_ID, "boost");
+        assertTrue(cf >= 0, "助力入口应返回『本操作预计 +N CF』预估(SC-X-22),cf=" + cf);
+    }
+
+    @Test
+    @DisplayName("CF预估-3:未知动作类型不得为负(降级为 0)")
+    void expectedCf_unknownAction_notNegative() {
+        Object host = contractHost();
+        int cf = callInt(host, "expectedCf", ACTIVITY_ID, "unknown");
+        assertTrue(cf >= 0, "未知动作类型 CF 预估不得为负(SC-X-22 降级口径),cf=" + cf);
+    }
+
+    // ==================== 权限流(不适用) ====================
+
+    @Test
+    @DisplayName("权限流:营销打卡/助力无独立角色权限分支,权限流不适用")
+    void permissionFlow_notApplicable() {
+        // 说明性用例:SC-P-77 权限校验由活动报名与身份门禁承载(activity.enroll.join),
+        // 本能力聚焦进度累计/幂等/反刷量/CF 预估,无独立权限分支。不产生断言失败。
+        assertTrue(true, "权限流不适用:activity.checkin.boost 无独立角色权限分支。");
+    }
+
+    // ==================== 反射辅助(锚定宿主契约,避免编译期依赖不存在类) ====================
+
+    private Object contractHost() {
+        try {
+            Class<?> clazz = Class.forName(HOST_CLASS);
+            return clazz.getDeclaredConstructor().newInstance();
+        } catch (ClassNotFoundException e) {
+            fail("RED[activity.checkin.boost] 契约宿主 ActivityCheckinBoostService 未实现(实现未落地):"
+                    + e.getMessage());
+            throw new IllegalStateException("unreachable");
+        } catch (Exception e) {
+            fail("契约宿主 ActivityCheckinBoostService 实例化失败:" + 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[activity.checkin.boost] 契约方法 " + HOST_CLASS + "#" + 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 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");
+    }
+}

+ 237 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/AssessmentResultViewContractTest.java

@@ -0,0 +1,237 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.common.Result;
+import com.etotem.cfc.controller.assessment.AssessmentResultController;
+import com.etotem.cfc.dto.AssessmentResultDTO;
+import com.etotem.cfc.entity.DanAssessmentResult;
+import com.etotem.cfc.mapper.DanAssessmentResultMapper;
+import com.etotem.cfc.service.CognitiveService;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import java.lang.reflect.Field;
+import java.lang.reflect.Modifier;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+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 assessment.result.view}(业务域 D,SC-P-39 家长查看测评结果)。
+ *
+ * <p><b>溯源</b>
+ * <ul>
+ *   <li>需求:{@code tests/user-scenarios/应用场景总览.md} SC-P-39「查看测评结果(DAN 报告)」——
+ *       流程:结果页 → 八类报告展示;边界:<b>结果未录入不展示;量纲标注</b>;模块 {@code DanAssessmentResultDTO}。</li>
+ *   <li>设计:{@code docs/superpowers/api/API_REFERENCE.md} §4.10 测评
+ *       {@code POST /api/assessment/latest-result}(最新测评结果)、{@code /api/assessment/history}(测评历史);
+ *       与 {@code teacher.assessment.record}(S-cfc-184)区分:<b>家长看结果 vs 规划师记录测评</b>。</li>
+ *   <li>量纲口径:{@code docs/superpowers/specs/2026-11-05-dimension-scoring-convention.md} §1——
+ *       所有维度得分统一落在 <b>0–100</b> 闭区间(0=最弱,100=最强)。</li>
+ * </ul>
+ *
+ * <p><b>被校验的契约边界</b>
+ * <ul>
+ *   <li><b>边界一(已落地,作对照)</b>:结果未录入(getChildLatestResult 返回 null)→ 接口返回
+ *       {@code Result.success(null)}(data 为 null,不展示),而非错误或空对象。</li>
+ *   <li><b>边界二(缺失,预期红)</b>:八类报告的每类维度须携带 <b>量纲标注</b>(0–100 闭区间 + 中文标签),
+ *       供结果页直接渲染,而非前端散落硬编码。当前 {@link AssessmentResultDTO} 仅暴露裸 Integer 分数,
+ *       无 dimensionLabel / dimensionUnit / scaleMin / scaleMax 等量纲元信息。</li>
+ *   <li><b>边界三(缺失,预期红)</b>:超出 0–100 量纲的分数在查看时须被<b>拒显</b>(拦截返回错误),
+ *       当前 {@code getLatestResult} 直接透传,无范围校验。</li>
+ * </ul>
+ *
+ * <p><b>测试范围</b>:纯 Mockito + 反射注入,无 Spring 上下文 / 无 DB / 无外部服务依赖,沿用已合入主链
+ * 同批 RED 契约测试风格(TeamProfitHookContractTest / TeamStarMultiplierContractTest /
+ * FamilyJoinValidationRulesContractTest)。
+ *
+ * <p><b>RED 预期</b>:边界二 / 边界三相关断言在实现补齐前均应失败(红);GREEN 阶段由实现方在
+ * {@code AssessmentResultDTO} 增加「量纲标注(标签 + 0–100 范围)」字段、在 {@code getLatestResult}
+ * 增加「0–100 范围拒显」校验后自动转绿。边界一(未录入不展示)当前已落地,作对照用例。
+ */
+class AssessmentResultViewContractTest {
+
+    /** SC-P-39 八类报告的英文维度字段名(camelCase) */
+    private static final String[] EIGHT_DIMENSION_FIELDS = {
+            "overallScore", "attentionScore", "focusScore", "memoryScore",
+            "logicScore", "perceptionScore", "spatialScore", "processingSpeedScore"
+    };
+
+    private AssessmentResultController controller;
+    private CognitiveService cognitiveService;
+    private DanAssessmentResultMapper danAssessmentResultMapper;
+
+    @BeforeEach
+    void setUp() throws Exception {
+        controller = new AssessmentResultController();
+        // 反射注入全部非 static / 非 final 字段为 mock,隔离 DB / 外部服务
+        injectAll(controller);
+        cognitiveService = (CognitiveService) readField(controller, "cognitiveService");
+        danAssessmentResultMapper = (DanAssessmentResultMapper) readField(controller, "danAssessmentResultMapper");
+    }
+
+    // ==================== 边界一(对照):结果未录入不展示 ====================
+
+    @Test
+    @DisplayName("SC-P-39 边界(对照,当前已落地):结果未录入时应返回 success(null) 而非错误/空对象")
+    void view_noResultRecorded_shouldReturnSuccessWithNullData() {
+        // member 存在(memberId 非空),但尚未录入测评结果
+        when(cognitiveService.getChildLatestResult(any(Long.class))).thenReturn(null);
+
+        Map<String, Object> body = new HashMap<>();
+        body.put("memberId", 55L);
+
+        Result<AssessmentResultDTO> resp = controller.getLatestResult(body, null);
+
+        assertNotNull(resp, "Result 包装不应为 null");
+        assertEquals(200, resp.getCode(), "未录入不展示 → 应为成功码 200(而非错误码)");
+        assertNull(resp.getData(), "未录入不展示 → data 应为 null(前端据 null 渲染空态)");
+    }
+
+    // ==================== 边界二(缺失,预期红):八类报告须携带 0–100 量纲标注 ====================
+
+    @Test
+    @DisplayName("SC-P-39 边界:AssessmentResultDTO 应暴露量纲标注(0–100 范围)供结果页直接渲染")
+    void dto_shouldExposeDimensionScaleAnnotation() {
+        List<String> fieldNames = dtoFieldNames();
+
+        // 量纲标注字段:0–100 闭区间的最小/最大值,用于结果页绘制刻度/雷达图半径
+        boolean hasScaleMin = fieldNames.contains("scaleMin");
+        boolean hasScaleMax = fieldNames.contains("scaleMax");
+        boolean hasScale = fieldNames.contains("scale");
+
+        assertTrue(hasScaleMin && hasScaleMax || hasScale,
+                "[assessment.result.view] AssessmentResultDTO 缺少量纲标注(0–100 范围)字段:"
+                        + "期望 scaleMin+scaleMax 或 scale,用于结果页八类报告量纲刻度渲染。"
+                        + "SC-P-39 边界「量纲标注」未落地。");
+    }
+
+    @Test
+    @DisplayName("SC-P-39 边界:八类报告每类维度应暴露中文标签,供结果页直接展示")
+    void dto_shouldExposeDimensionChineseLabel() {
+        List<String> fieldNames = dtoFieldNames();
+
+        // 每类维度的中文标签标注:整体/注意力/专注力/记忆力/逻辑/感知/空间/加工速度
+        String[] expectedLabelFields = {
+                "overallLabel", "attentionLabel", "focusLabel", "memoryLabel",
+                "logicLabel", "perceptionLabel", "spatialLabel", "processingSpeedLabel"
+        };
+
+        List<String> missingLabels = Arrays.stream(expectedLabelFields)
+                .filter(name -> !fieldNames.contains(name))
+                .collect(Collectors.toList());
+
+        assertTrue(missingLabels.isEmpty(),
+                "[assessment.result.view] AssessmentResultDTO 缺少八类报告维度中文标签字段:" + missingLabels
+                        + "。SC-P-39「八类报告展示」要求每类维度携带中文标签供结果页直接渲染,"
+                        + "当前标签散落前端硬编码,未纳入契约 DTO。");
+    }
+
+    // ==================== 边界三(缺失,预期红):超量纲分数应拒显 ====================
+
+    @Test
+    @DisplayName("SC-P-39 边界:分数超出 0–100 量纲时应拒显(返回错误而非透传脏数据)")
+    void view_outOfRangeScore_shouldRejectDisplay() {
+        // 构造一条分数越界(150 > 100)的结果 → 查看契约要求拒显,不透传脏数据
+        DanAssessmentResult result = new DanAssessmentResult();
+        result.setMemberId(55L);
+        result.setChildName("小李");
+        result.setOverallScore(150);   // 超出 0–100 量纲
+        result.setAttentionScore(80);
+        result.setFocusScore(75);
+        result.setMemoryScore(85);
+        result.setLogicScore(90);
+        result.setPerceptionScore(70);
+        result.setSpatialScore(88);
+        result.setProcessingSpeedScore(78);
+        when(cognitiveService.getChildLatestResult(any(Long.class))).thenReturn(result);
+
+        Map<String, Object> body = new HashMap<>();
+        body.put("memberId", 55L);
+
+        Result<AssessmentResultDTO> resp = controller.getLatestResult(body, null);
+
+        // 契约:越界分数应被拦截(非 200),而非 success + 脏数据透传
+        boolean rejected = resp.getCode() != 200;
+        assertTrue(rejected,
+                "[assessment.result.view] 分数超出 0–100 量纲时应拒显(返回非 200 错误码),"
+                        + "当前实现直接透传脏数据(code=" + resp.getCode() + ")。"
+                        + "SC-P-39 量纲口径(0–100 闭区间)的查看侧拦截未落地。");
+        // 越界时不应当返回成功数据
+        if (rejected) {
+            assertNull(resp.getData(), "拒显时 data 不应携带脏数据");
+        }
+    }
+
+    @Test
+    @DisplayName("SC-P-39 边界:负分数(< 0)同样应拒显")
+    void view_negativeScore_shouldRejectDisplay() {
+        DanAssessmentResult result = new DanAssessmentResult();
+        result.setMemberId(55L);
+        result.setChildName("小李");
+        result.setOverallScore(80);
+        result.setAttentionScore(-5);  // 负数越界
+        result.setFocusScore(75);
+        result.setMemoryScore(85);
+        result.setLogicScore(90);
+        result.setPerceptionScore(70);
+        result.setSpatialScore(88);
+        result.setProcessingSpeedScore(78);
+        when(cognitiveService.getChildLatestResult(any(Long.class))).thenReturn(result);
+
+        Map<String, Object> body = new HashMap<>();
+        body.put("memberId", 55L);
+
+        Result<AssessmentResultDTO> resp = controller.getLatestResult(body, null);
+
+        assertTrue(resp.getCode() != 200,
+                "[assessment.result.view] 负分数(<0)超出 0–100 量纲应拒显,"
+                        + "当前实现直接透传(code=" + resp.getCode() + ")。");
+    }
+
+    // ==================== 结构锚点:契约载体存在(防假 RED 对照) ====================
+
+    @Test
+    @DisplayName("结构锚点:AssessmentResultController + /latest-result 契约载体应存在")
+    void contractCarrier_shouldExist() throws Exception {
+        assertNotNull(controller, "[assessment.result.view] AssessmentResultController 实例应可创建");
+        java.lang.reflect.Method m = AssessmentResultController.class.getMethod(
+                "getLatestResult", Map.class, Long.class);
+        assertNotNull(m, "[assessment.result.view] getLatestResult(Map, Long) 方法应存在(端点 /latest-result 宿主)");
+    }
+
+    // ==================== 辅助构造 / 反射 ====================
+
+    private List<String> dtoFieldNames() {
+        return Arrays.stream(AssessmentResultDTO.class.getDeclaredFields())
+                .map(Field::getName)
+                .collect(Collectors.toList());
+    }
+
+    /** 反射注入全部非 static / 非 final 字段为对应类型 mock */
+    private static void injectAll(Object target) throws Exception {
+        for (Field f : target.getClass().getDeclaredFields()) {
+            if (Modifier.isStatic(f.getModifiers()) || Modifier.isFinal(f.getModifiers())) {
+                continue;
+            }
+            f.setAccessible(true);
+            f.set(target, mock(f.getType()));
+        }
+    }
+
+    private static Object readField(Object target, String name) throws Exception {
+        Field f = target.getClass().getDeclaredField(name);
+        f.setAccessible(true);
+        return f.get(target);
+    }
+}

+ 400 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/DataExportGdprContractTest.java

@@ -0,0 +1,400 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.entity.FamilyMember;
+import com.etotem.cfc.entity.User;
+import com.etotem.cfc.mapper.DanAssessmentResultMapper;
+import com.etotem.cfc.mapper.FamilyMemberMapper;
+import com.etotem.cfc.mapper.HealthReportMapper;
+import com.etotem.cfc.mapper.TaskMapper;
+import com.etotem.cfc.mapper.UserMapper;
+import com.etotem.cfc.service.AccountCleanupService;
+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 java.io.InputStream;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.nio.charset.StandardCharsets;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Scanner;
+
+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;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+
+/**
+ * 契约级单测:个人/家庭数据导出(GDPR)(能力键 {@code data.export.gdpr},SC-P-72,TDD-RED 阶段)。
+ *
+ * <p><b>契约溯源</b></p>
+ * <ul>
+ *   <li>需求:{@code tests/user-scenarios/应用场景总览.md} SC-P-72「个人/家庭数据导出(GDPR)」(业务域 J:账号与数据主权)——
+ *       <b>流程:申请导出 → 生成加密包 → 下载</b>;<b>边界:敏感字段脱敏;频次限制;越权导出被拒</b>;
+ *       模块:数据导出(GDPR)。用例台账 GAP-028(TC-P-72 正常流 / TC-P-72-E 异常流 / TC-P-72-P 权限流,
+ *       见 {@code docs/tdd/test/scenario-gap-backlog.csv});sc-key-map 台账登记 SC-P-72 → {@code data.export.gdpr}(RED/未跑通)。</li>
+ *   <li>设计:{@code docs/superpowers/api/API_REFERENCE.md} §4.61.5——数据主权(GDPR)能力<b>无独立端点</b>,
+ *       需复用 {@code /api/user}、{@code /api/family/member/list} 汇集导出;
+ *       「仅导出登录用户本人;无 memberId 入参 → 无『家长代导出孩子』(G-05)」;
+ *       {@code docs/superpowers/specs/2026-11-07-child-zone-contract.md} §5 G-05:
+ *       {@code exportUserData(userId)} 不接受 memberId,无家长代导出指定成员。</li>
+ * </ul>
+ *
+ * <p><b>宿主契约(本 RED 测试定稿,GREEN 实现方按此落地)</b>:{@code com.etotem.cfc.service.DataExportService}
+ * ——「数据导出(GDPR)」模块服务(申请→加密包→下载 流程宿主)。origin/cfclub @ d6dac931a 实测 <b>不存在</b>
+ * (实现未落地),测试以反射结构契约探测缺失,失败断言原文红色清晰可贴。</p>
+ *
+ * <p><b>建议契约方法签名(实现方可按仓库惯例微调命名)</b></p>
+ * <ul>
+ *   <li>{@code applyExport(Long userId, Long scopeMemberId)}——申请导出入口:频次窗口校验(如 24h)+ 归属校验
+ *       (越权拒)后创建导出工单(pending);</li>
+ *   <li>{@code buildExportPackage(...)}(或 generatePackage)——汇集数据(复用 user / family-member 数据)+
+ *       敏感字段脱敏(复用 {@code DataMaskUtil})+ 加密 → 生成加密包;</li>
+ *   <li>{@code downloadPackage(...)}——下载入口:本人/家庭归属校验 → 返回加密包(含密钥交接);</li>
+ *   <li>配套实体/表:{@code DataExportTask}({@code data_export_task})承载 status / packagePath / packageKey /
+ *       expiresAt 等工单状态字段。</li>
+ * </ul>
+ *
+ * <p><b>测试范围</b>:纯 JUnit + Mockito + 反射(无 Spring / 无 DB / 无外部服务,同批
+ * {@code TeamProfitHookContractTest} / {@code TeacherExportContractTest} 风格);
+ * 行为断言锚定现有数据导出载体 {@code AccountCleanupService.exportUserData}(设计指定复用的 /api/user 载体)。</p>
+ *
+ * <p><b>RED 预期</b>:宿主 {@code DataExportService} 未实现(反射结构用例全红);且现有载体
+ * {@code AccountCleanupService.exportUserData} 明文导出家庭成员 phone、无 memberId 范围入参(行为/签名用例红),
+ * GREEN 阶段按上述契约落地后转绿。</p>
+ */
+class DataExportGdprContractTest {
+
+    /** 宿主服务类(SC-P-72 数据导出(GDPR) 模块,设计锚点;当前实现未落地)。 */
+    private static final String HOST_CLASS = "com.etotem.cfc.service.DataExportService";
+
+    /** 配套导出工单实体(申请→加密包→下载 状态载体)。 */
+    private static final String TASK_ENTITY = "com.etotem.cfc.entity.DataExportTask";
+
+    /** 配套导出工单表(schema.sql 建表快照)。 */
+    private static final String TASK_TABLE = "data_export_task";
+
+    /** 现有数据导出载体(设计指定复用 /api/user,UserController POST /api/user/data-export → exportUserData)。 */
+    private static final String EXPORT_CARRIER = "com.etotem.cfc.service.AccountCleanupService";
+
+    private static final Long PARENT_USER_ID = 1001L;
+    private static final Long FAMILY_ID = 5001L;
+    private static final Long CHILD_MEMBER_ID = 2001L;
+    private static final String RAW_PHONE = "13800138000";
+
+    @Mock
+    private UserMapper userMapper;
+
+    @Mock
+    private FamilyMemberMapper familyMemberMapper;
+
+    @Mock
+    private DanAssessmentResultMapper danAssessmentResultMapper;
+
+    @Mock
+    private HealthReportMapper healthReportMapper;
+
+    @Mock
+    private TaskMapper taskMapper;
+
+    @InjectMocks
+    private AccountCleanupService service;
+
+    @BeforeEach
+    void setUp() {
+        MockitoAnnotations.openMocks(this);
+    }
+
+    // ==================== 正常流(TC-P-72):申请导出 → 加密包 → 下载 ====================
+
+    @Test
+    @DisplayName("正常流-1:DataExportService 数据导出(GDPR) 服务类应存在(宿主锚点)")
+    void dataExportService_classExists() {
+        assertNotNull(loadClass(HOST_CLASS),
+                "[data.export.gdpr] DataExportService 类不存在:SC-P-72 个人/家庭数据导出(GDPR)"
+                        + "要求「申请导出 → 生成加密包 → 下载」流程宿主(模块:数据导出(GDPR),复用 /api/user、"
+                        + "/api/family/member/list 汇集导出)。实现未落地。");
+    }
+
+    @Test
+    @DisplayName("正常流-2:DataExportService 应提供 applyExport 申请导出入口")
+    void dataExportService_hasApplyExportEntry() {
+        Method apply = findMethodContains(hostClass(), "apply");
+        assertNotNull(apply,
+                "[data.export.gdpr] DataExportService 应提供 applyExport(...) 申请导出入口"
+                        + "(申请 → 生成加密包 → 下载 三阶段之首,SC-P-72 正常流)。实现未落地:宿主类不存在。");
+    }
+
+    @Test
+    @DisplayName("正常流-3:DataExportService 应提供加密包生成入口(package/generate/encrypt)")
+    void dataExportService_hasPackageGenerateEntry() {
+        Class<?> clazz = hostClass();
+        boolean hasPackageBuilder = methodNameContains(clazz, "package") && (
+                methodNameContains(clazz, "generate")
+                        || methodNameContains(clazz, "build")
+                        || methodNameContains(clazz, "create")
+                        || methodNameContains(clazz, "encrypt"));
+        assertTrue(hasPackageBuilder,
+                "[data.export.gdpr] DataExportService 应提供加密包生成入口(方法名含 package 且 "
+                        + "generate/build/create/encrypt,如 buildExportPackage):契约要求「生成加密包」"
+                        + "而非同步裸返回明文 Map(SC-P-72 正常流)。实现未落地:宿主类不存在。");
+    }
+
+    @Test
+    @DisplayName("正常流-4:DataExportService 应提供 downloadPackage 下载入口")
+    void dataExportService_hasDownloadEntry() {
+        Method download = findMethodContains(hostClass(), "download");
+        assertNotNull(download,
+                "[data.export.gdpr] DataExportService 应提供 downloadPackage(...) 下载入口"
+                        + "(申请导出 → 生成加密包 → 下载 三阶段之末,SC-P-72 正常流)。实现未落地:宿主类不存在。");
+    }
+
+    // ==================== 边界/异常流(TC-P-72-E):频次限制 + 脱敏 + 加密包字段 ====================
+
+    @Test
+    @DisplayName("边界流-1:DataExportService 应有频次限制守卫(RATE_LIMIT 常量或 rateLimit/checkFrequency 方法)")
+    void applyExport_hasRateLimitGuard() {
+        Class<?> clazz = hostClass();
+        boolean hasRateLimit = fieldNameContains(clazz, "rate_limit")
+                || fieldNameContains(clazz, "frequency")
+                || methodNameContains(clazz, "ratelimit")
+                || methodNameContains(clazz, "checkfrequency")
+                || methodNameContains(clazz, "assertfrequency");
+        assertTrue(hasRateLimit,
+                "[data.export.gdpr] applyExport 应含频次限制守卫:SC-P-72 边界「频次限制」"
+                        + "(建议 24h 窗口,RATE_LIMIT_WINDOW_HOURS 常量或 checkRateLimit 方法),"
+                        + "超限申请应被拒。实现未落地:宿主类不存在。");
+    }
+
+    @Test
+    @DisplayName("边界流-2:DataExportTask 实体与 data_export_task 表应存在(申请→加密包→下载 工单载体)")
+    void dataExportTask_entityAndTableExist() {
+        String schema = readSchemaSql();
+        assertNotNull(loadClass(TASK_ENTITY),
+                "[data.export.gdpr] DataExportTask 实体不存在:SC-P-72 要求导出为「申请 → 生成加密包 → 下载」"
+                        + "有状态流程,需 data_export_task 工单承载。实现未落地。");
+        assertTrue(schema.contains(TASK_TABLE),
+                "[data.export.gdpr] schema.sql 缺少 " + TASK_TABLE + " 建表(导出工单,SC-P-72 流程载体)。");
+    }
+
+    @Test
+    @DisplayName("边界流-3:DataExportTask 应含工单状态与加密包字段(status/packagePath/packageKey/expiresAt)")
+    void dataExportTask_hasPackageStateFields() {
+        Class<?> entity = loadClass(TASK_ENTITY);
+        if (entity == null) {
+            fail("[data.export.gdpr] DataExportTask 实体不存在,无法校验工单状态字段(SC-P-72 加密包流程)。");
+        }
+        for (String required : new String[]{"status", "packagePath", "packageKey", "expiresAt"}) {
+            boolean has = fieldNameEquals(entity, required);
+            assertTrue(has,
+                    "[data.export.gdpr] DataExportTask 应含 " + required + " 字段:加密包流程工单"
+                            + "(status=导出状态、packagePath=加密包路径、packageKey=加密密钥、expiresAt=有效/频次窗口)。"
+                            + "当前实体缺失。");
+        }
+    }
+
+    @Test
+    @DisplayName("边界流-4:DataExportService 应暴露敏感字段脱敏方法(mask/desensitize,复用 DataMaskUtil)")
+    void dataExportService_masksSensitiveFields() {
+        Method mask = findMethodContains(hostClass(), "mask");
+        assertNotNull(mask,
+                "[data.export.gdpr] DataExportService 应提供敏感字段脱敏方法(如 maskSensitiveFields,"
+                        + "复用 DataMaskUtil.maskPhone/maskName):SC-P-72 边界「敏感字段脱敏」(对齐 SC-T-29/"
+                        + "SC-S-11 合规口径,phone/realName/idCard 强制脱敏)。实现未落地:宿主类不存在。");
+    }
+
+    @Test
+    @DisplayName("边界流-5:现有导出载体 exportUserData 的家庭成员块 phone 应脱敏(当前明文,红)")
+    void exportUserData_familyMemberPhone_shouldBeMasked() {
+        // Given:家庭内有一名成员(phone 明文),其余导出区块无数据
+        User parent = new User();
+        parent.setId(PARENT_USER_ID);
+        parent.setFamilyId(FAMILY_ID);
+        when(userMapper.selectById(PARENT_USER_ID)).thenReturn(parent);
+
+        FamilyMember member = new FamilyMember();
+        member.setId(CHILD_MEMBER_ID);
+        member.setFamilyId(FAMILY_ID);
+        member.setPhone(RAW_PHONE);
+        when(familyMemberMapper.selectList(any())).thenReturn(Collections.singletonList(member));
+        when(danAssessmentResultMapper.selectList(any())).thenReturn(Collections.emptyList());
+        when(healthReportMapper.selectList(any())).thenReturn(Collections.emptyList());
+        when(taskMapper.selectList(any())).thenReturn(Collections.emptyList());
+
+        // When:导出个人数据包(复用 /api/user 载体,设计指定汇集导出)
+        Map<String, Object> data = service.exportUserData(PARENT_USER_ID);
+
+        // Then:家庭成员(他人数据)的敏感字段 phone 必须脱敏,不得明文
+        Object children = data.get("children");
+        assertNotNull(children,
+                "[data.export.gdpr] 导出包应包含家庭成员 children 区块(SC-P-72 个人/家庭数据导出)。");
+        @SuppressWarnings("unchecked")
+        List<FamilyMember> members = (List<FamilyMember>) children;
+        assertFalse(members.isEmpty(),
+                "[data.export.gdpr] 家庭成员区块不应为空(SC-P-72 家庭数据导出汇集 /api/family/member/list)。");
+        for (FamilyMember fm : members) {
+            String phone = fm.getPhone();
+            assertFalse(phone != null && phone.contains(RAW_PHONE),
+                    "[data.export.gdpr] 导出包家庭成员 phone 应脱敏(如 138****8000,复用 DataMaskUtil):"
+                            + "SC-P-72 边界「敏感字段脱敏」。当前实现将 family_members 全量实体裸导出"
+                            + "(含 phone 明文),脱敏契约未落地。");
+        }
+    }
+
+    // ==================== 权限流(TC-P-72-P):越权导出被拒 ====================
+
+    @Test
+    @DisplayName("权限流-1:applyExport/downloadPackage 应携带显式 memberId 范围入参(G-05 家长代导出指定成员)")
+    void applyExport_carriesScopeMemberId() {
+        Class<?> clazz = hostClass();
+        Method apply = findMethodContains(clazz, "apply");
+        assertNotNull(apply,
+                "[data.export.gdpr] 申请导出入口缺失(宿主未实现),无法校验范围入参契约。");
+        boolean scopeAware = hasNumberOrMapParam(apply);
+        assertTrue(scopeAware,
+                "[data.export.gdpr] applyExport 应携带显式导出范围(scopeMemberId/memberId 数值入参或 Map 载体),"
+                        + "支撑「家长代导出指定成员」(G-05,API_REFERENCE §4.61.5:无 memberId 入参 → 无代导出)"
+                        + "与「越权导出被拒」(TC-P-72-P 权限流)。");
+    }
+
+    @Test
+    @DisplayName("权限流-2:DataExportService 应有归属校验守卫(assertCanExport/checkExportPermission,越权拒)")
+    void dataExportService_hasOwnershipGuard() {
+        Class<?> clazz = hostClass();
+        boolean guarded = methodNameContains(clazz, "assert")        // assertCanExport
+                || methodNameContains(clazz, "check")               // checkExportPermission
+                || methodNameContains(clazz, "permission")
+                || methodNameContains(clazz, "ownership")
+                || methodNameContains(clazz, "authorize");
+        assertTrue(guarded,
+                "[data.export.gdpr] applyExport/downloadPackage 须有归属校验守卫(如 assertCanExport/"
+                        + "checkExportPermission):非本家庭成员/非绑定家庭不得导出他人数据(SC-P-72 边界"
+                        + "「越权导出被拒」,TC-P-72-P 权限流)。实现未落地:宿主类不存在。");
+    }
+
+    @Test
+    @DisplayName("权限流-3:现有导出载体 exportUserData 应支持 memberId 范围入参(G-05;当前仅 1 参,红)")
+    void exportUserData_shouldCarryScopeMemberId() {
+        Class<?> carrier = loadClass(EXPORT_CARRIER);
+        if (carrier == null) {
+            fail("[data.export.gdpr] AccountCleanupService 载体类不存在(异常状态)。");
+        }
+        boolean hasScopeParam = false;
+        for (Method m : carrier.getDeclaredMethods()) {
+            if (m.getName().equals("exportUserData") && m.getParameterCount() >= 2) {
+                hasScopeParam = true;
+                break;
+            }
+        }
+        assertTrue(hasScopeParam,
+                "[data.export.gdpr] " + EXPORT_CARRIER + ".exportUserData 应支持 memberId 范围入参"
+                        + "(如 exportUserData(Long userId, Long scopeMemberId)):G-05 缺口——无 memberId 入参则"
+                        + "无「家长代导出指定成员」、也无越权归属校验载体(TC-P-72-P 权限流)。"
+                        + "当前仅 exportUserData(Long) 1 参,实现未落地。");
+    }
+
+    // ==================== 反射辅助(锚定宿主契约,避免编译期依赖不存在类) ====================
+
+    /** 解析宿主类;不存在即断言失败(RED 信号:实现未落地),并清晰贴出缺口。 */
+    private Class<?> hostClass() {
+        try {
+            return Class.forName(HOST_CLASS);
+        } catch (ClassNotFoundException e) {
+            fail("RED[data.export.gdpr] 契约宿主 " + HOST_CLASS + " 未实现(实现未落地):"
+                    + "SC-P-72 个人/家庭数据导出(GDPR)「申请导出 → 生成加密包 → 下载」流程宿主缺失"
+                    + "(模块:数据导出(GDPR);复用 /api/user、/api/family/member/list 汇集导出;"
+                    + "现有 UserController /api/user/data-export 仅同步返回明文 Map,无加密包/频次/越权校验)。"
+                    + "缺失详情:" + e.getMessage());
+            throw new IllegalStateException("unreachable");
+        }
+    }
+
+    private Class<?> loadClass(String name) {
+        try {
+            return Class.forName(name, false, Thread.currentThread().getContextClassLoader());
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+
+    /** 方法名包含关键字的首个匹配;无则 null。 */
+    private Method findMethodContains(Class<?> clazz, String keywordLower) {
+        if (clazz == null) {
+            return null;
+        }
+        for (Method m : clazz.getDeclaredMethods()) {
+            if (m.getName().toLowerCase().contains(keywordLower)) {
+                return m;
+            }
+        }
+        return null;
+    }
+
+    private boolean methodNameContains(Class<?> clazz, String keywordLower) {
+        if (clazz == null) {
+            return false;
+        }
+        for (Method m : clazz.getDeclaredMethods()) {
+            if (m.getName().toLowerCase().contains(keywordLower)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private boolean fieldNameContains(Class<?> clazz, String keywordLower) {
+        if (clazz == null) {
+            return false;
+        }
+        for (Field f : clazz.getDeclaredFields()) {
+            if (f.getName().toLowerCase().contains(keywordLower)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private boolean fieldNameEquals(Class<?> clazz, String name) {
+        if (clazz == null) {
+            return false;
+        }
+        for (Field f : clazz.getDeclaredFields()) {
+            if (f.getName().equals(name)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /** 方法参数含数值 ID(Long/memberId 载体)或 Map(scopeMemberId 键)→ 支持显式导出范围。 */
+    private boolean hasNumberOrMapParam(Method m) {
+        for (Class<?> p : m.getParameterTypes()) {
+            if (Number.class.isAssignableFrom(p) || p.isPrimitive()
+                    || Map.class.isAssignableFrom(p)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private String readSchemaSql() {
+        try (InputStream is = getClass().getClassLoader().getResourceAsStream("schema.sql")) {
+            if (is == null) {
+                return "";
+            }
+            try (Scanner scanner = new Scanner(is, StandardCharsets.UTF_8.name())) {
+                scanner.useDelimiter("\\A");
+                return scanner.hasNext() ? scanner.next() : "";
+            }
+        } catch (Exception e) {
+            return "";
+        }
+    }
+}

+ 1 - 1
cfc-web/.last_build_commit

@@ -1 +1 @@
-9cf9bfa4907ad4a55423c1b97696d61168c461bb
+febd928904d90b16c7661385c83bc3709ae1d36d

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

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

+ 1 - 1
cfc-web/package.json

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

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

@@ -4,6 +4,137 @@
 
 ---
 
+## v1.0.2467 (2026-11-13)
+
+### 测试
+- RED 契约测试 assessment.result.view (S-cfc-278)
+
+### 其他
+- (查看测评结果:八类报告展示、结果未录入不展示、量纲标注)与
+- API_REFERENCE.md §4.10(POST /api/assessment/latest-result、/history)。
+- 纯 Mockito + 反射,无 Spring/DB/外部服务,沿用同批 RED 测试风格
+- (TeamProfitHookContractTest / FamilyJoinValidationRulesContractTest)。
+- - 边界一(对照,已落地):结果未录入返回 success(null) 不展示
+- - 边界二(红):AssessmentResultDTO 缺量纲标注(0-100 范围)字段
+- - 边界二(红):八类报告维度缺中文标签字段
+- - 边界三(红):分数超出 0-100 量纲未拒显(直接透传 code=200)
+- - 结构锚点:AssessmentResultController.getLatestResult 存在
+- 红测结果:Tests run 6, Failures 4, Errors 0(4 项契约缺口断言按预期失败)
+- 
+
+
+## v1.0.2466 (2026-11-13)
+
+### 文档
+- 研发负责人 第166轮汇报(派发2 RED契约 S-cfc-291/292,lan-189)
+- /tdd/orchestration/sc-key-map.md SC-P-04→family.familyMembers.list→S-cfc-258;
+
+### 测试
+- S-cfc-258 family.familyMembers.list 契约级单测(TDD-RED)
+- RED 契约测试 report.upload.parse 上传解析确认链路(并发幂等/未知聚类/异常值拦截)
+
+### 其他
+- 边界仅本家庭成员可见 + 分页/搜索。
+- 新增 FamilyMembersListScP04ContractTest(8 例,预期红 5 绿 3,纯 Mockito/反射,无 Spring/DB/外部服务):
+- RED 契约缺口(断言实现未落地):
+- - 正常流-1:带 page/pageSize 应返回分页结构(total+list),当前忽略并返回全量裸 List
+- - 正常流-2:带 keyword 应按昵称过滤,当前忽略仍返回全量未过滤
+- - 正常流-3(结构):FamilyMemberService 应提供 keyword/String 参数或 search 命名的列表方法,当前仅 listMembers(Long)/listMembersOfFamily/listMembersWithFamily
+- - 正常流-4(结构):FamilyMemberVO 应含在线状态字段 online/onlineStatus/lastActiveAt,当前全部缺失
+- - 异常流-1:非法分页参数(page=0/pageSize=-1)应 400 校验拦截,当前静默忽略返回 200
+- GREEN 基线锚点(锁定既有实现不被 GREEN 误伤):
+- - 基线-1:匿名 userId<=0 → 401
+- - 基线-2:指定非本家庭 familyId → 403(canAccessFamily 已具备)
+- - 基线-3:无分页/搜索参数时返回全量成员列表(兼容现状语义)
+- 实测 mvn -Dtest=FamilyMembersListScP04ContractTest test:Tests run 8, Failures 5, Errors 0(红=RED 完成)。
+- 溯源:tests/user-scenarios/应用场景总览.md SC-P-04;
+- API_REFERENCE §4.2;FamilyMembersController.listMembers + 分页/搜索。
+- 仅新增 src/test 测试文件,未改 src/main。GREEN 实现指引自类注释。
+- 
+
+### Bug 修复
+- admin.reportParser.manage saveType 显式置空 linkedProductId 改用字符串版 UpdateWrapper(消除 lambda cache 依赖,RED 3例转绿)
+
+
+## v1.0.2465 (2026-11-13)
+
+### 测试
+- RED 契约测试 report.upload.parse 上传解析确认链路(并发幂等/未知聚类/异常值拦截)
+- RED 契约单测 S-cfc-281(SC-P-44 确认方案/SC-P-45 方案直接发布,7 例全红)
+- assessment.appointment.create 预约时间冲突校验 RED 契约测试(SC-P-36 边界,预期红)
+- S-cfc-264 add RED contract test for energy.fiveDim.view (五维分配总和=100%/配置报警/空态不500)
+- 定时自动化闭环报告 - 后端全量3745例92.84% + 浏览器28过2跳 + API全量990例首次完跑(23红) + langgraph 41/51(配额红)
+- RED contract test for growth.milestone.mark 成长里程碑标记
+- RED 契约单测 butler.resource.match(SC-H-05 线下资源与活动对接)9/11 红
+- 合入 RED 契约单测 auth.account.deactivate(SC-P-71 账号注销)
+- assessment.order.pay 契约级 RED 单测(S-cfc-276)
+- add RED contract test for SC-P-47 plan task list view (S-cfc-282)
+- S-cfc-262 task.frequency.config 任务频率/周期配置 契约级单测 11例全红
+- RED 契约级单测 contact.group.import(SC-P-62 联系人分组/导入)
+- S-cfc-271 契约新增能力 RED 单测(收藏/调替换食材/营养对齐,宿主 MealPlanService 未实现预期红)
+- RED 契约单测 ai.coach.handoffPlanner(SC-B-09 教练转接成长规划师)
+- 契约级 RED 单测 assessment.type.browse(SC-P-31 测评类型浏览)
+- RED 契约单测 assessment.planner.select(SC-P-32 测评选规划师→绑定 T 列表,未绑定提示先绑定)
+- RED 契约测试 diet.mealPlan.generate 一日三餐生成/忌口排除
+- RED 契约单测 energy.ledger.view(SC-P-18 能量流水查看展示口径)
+- RED 契约单测 report.archive.manage(SC-P-24/25 报告管理·删除守卫/趋势/对比/归属)
+- 契约测试 family.family.createWithInvite RED
+- RED contract test for butler.escalation.handle (S-cfc-251)
+
+### 文档
+- 研发负责人 第157轮汇报(恢复1 + 派发2 GREEN 实现)
+
+### 其他
+- - 契约宿主 GrowthMilestoneService(markMilestone/isMarked + 重复标幂等)未落地
+- - GrowthController /api/growth 无 milestone 端点(缺口 G-2)
+- 实测 8 用例 7 失败(宿主缺失 + 端点缺失),权限流不适用用例通过。
+- 溯源:SC-P-51 成长里程碑(系统/手动标里程碑→时间线高亮,重复标幂等);
+- 设计:API_REFERENCE §4.6 /api/growth/*;缺口 G-2(2026-11-07-parent-rest-contract)
+- 
+- 契约溯源:
+- - 需求 SC-P-47(查看方案下任务列表:方案关联任务列表(状态/进度),任务增删与方案同步)
+- - 设计 API_REFERENCE.md 4.3 任务视图;模块 GrowthPlanController + TaskController
+- 新增 GrowthPlanTaskListContractTest(反射结构契约,纯 Mockito/无 Spring/DB/外部服务):
+- - 正常流-1: GrowthPlanController 应暴露 POST /api/growth/plan/task/list
+- - 正常流-2: 任务 Item 应含 status/progress 字段(已存在,绿)
+- - 正常流-3: 任务应含 growthPlanId/planId 方案关联(任务增删与方案同步)
+- - 正常流-4: GrowthPlanService 应提供方案任务清单方法
+- - 异常流-1: 缺 planId/memberId 参数守卫
+- - 权限流-1: 家庭归属校验(IDOR 防护)
+- RED 结果: 6 tests, 5 failures(契约缺失点), 1 pass(既有字段)
+- 
+- 
+- - 契约:测评页列 DAN 8 类(mind/wisdom/cognition/learning/behavior/career/campus/adolescent)
+- - 断言缺失:AssessmentService 类型浏览入口、AssessmentMaterial 类型码字段、
+-   assessment_materials 表类型码列、DanAssessmentController 类型浏览 POST 端点
+- - 验证:Tests run: 7, Failures: 5, Errors: 0(RED 符合预期)
+- 
+- - 纯 JUnit5 + Mockito + 反射结构探测,无 Spring/DB/外部服务(同批 RED 契约测试风格)
+- - 契约锚点 DietRecommendationService:generateDailyMealPlan(Long,Map) /
+-   resolveParticipantExclusions(List) / excludeRestrictedFromMenu(Object,List) 均未实现
+- - 覆盖:早/午/晚三餐返回形态(meals/degraded/excludedItems)、无报告降级通用食谱、
+-   忌口/过敏自动排除并集、按忌口重算排除项 + 冲突提示(conflictPrompt)
+- - 预期红:13 用例 13 失败,GREEN 阶段按契约签名落地即转绿
+- 
+- RED 断言展示口径未落地:
+- - sourceName 可读来源名(task→完成任务 / health_checkin→健康打卡 / assessment→测评 / 未映射回退原始码)
+- - dimensionCode 维度代码暴露(按 dimensionId)
+- - createdAt @JsonFormat(yyyy-MM-dd'T'HH:mm:ss) 时间格式统一
+- 纯 Mockito/反射,无 Spring/DB;8 测试 = 6 红(契约缺口)+ 2 绿(既有 memberId/familyId 门禁回归)。仅新增测试文件,未改 src/main。
+- 
+- - 服务层 6:正常/管理员回写/空名/超长30/注入/边界
+- - 控制层 4:空名400/超长400/正常/注入
+- - 权限 1:create-family 匿名需 401(未在 LOGIN_REQUIRED_PATHS)
+- - 锚点契约:POST /api/family/user/create-family(SC-P-01, TC-P-01)
+- - 未改 src/main;GREEN 阶段在既有入口补齐契约行为
+- 
+- 本测试预期失败(红):断言 ButlerEscalationService 宿主 / ButlerEscalationOrder 实体 /
+- butler_escalation_orders 建表 / ButlerController+AdminButlerController escalation 端点均缺失,
+- 覆盖正常/异常/权限三流,GREEN 阶段实现后自动转绿。
+- 纯反射 + Mockito 契约级单测,无 Spring/DB/外部服务,风格对齐同批已合入 RED 契约测试。
+- 
+
+
 ## v1.0.2464 (2026-11-13)
 
 ### 测试

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

@@ -1,6 +1,6 @@
 # 更新日志
 
-> 当前版本: v1.0.2464
+> 当前版本: v1.0.2467
 
 ## 历史版本
 
@@ -8,6 +8,137 @@
 
 ---
 
+## v1.0.2467 (2026-11-13)
+
+### 测试
+- RED 契约测试 assessment.result.view (S-cfc-278)
+
+### 其他
+- (查看测评结果:八类报告展示、结果未录入不展示、量纲标注)与
+- API_REFERENCE.md §4.10(POST /api/assessment/latest-result、/history)。
+- 纯 Mockito + 反射,无 Spring/DB/外部服务,沿用同批 RED 测试风格
+- (TeamProfitHookContractTest / FamilyJoinValidationRulesContractTest)。
+- - 边界一(对照,已落地):结果未录入返回 success(null) 不展示
+- - 边界二(红):AssessmentResultDTO 缺量纲标注(0-100 范围)字段
+- - 边界二(红):八类报告维度缺中文标签字段
+- - 边界三(红):分数超出 0-100 量纲未拒显(直接透传 code=200)
+- - 结构锚点:AssessmentResultController.getLatestResult 存在
+- 红测结果:Tests run 6, Failures 4, Errors 0(4 项契约缺口断言按预期失败)
+- 
+
+
+## v1.0.2466 (2026-11-13)
+
+### 文档
+- 研发负责人 第166轮汇报(派发2 RED契约 S-cfc-291/292,lan-189)
+- /tdd/orchestration/sc-key-map.md SC-P-04→family.familyMembers.list→S-cfc-258;
+
+### 测试
+- S-cfc-258 family.familyMembers.list 契约级单测(TDD-RED)
+- RED 契约测试 report.upload.parse 上传解析确认链路(并发幂等/未知聚类/异常值拦截)
+
+### 其他
+- 边界仅本家庭成员可见 + 分页/搜索。
+- 新增 FamilyMembersListScP04ContractTest(8 例,预期红 5 绿 3,纯 Mockito/反射,无 Spring/DB/外部服务):
+- RED 契约缺口(断言实现未落地):
+- - 正常流-1:带 page/pageSize 应返回分页结构(total+list),当前忽略并返回全量裸 List
+- - 正常流-2:带 keyword 应按昵称过滤,当前忽略仍返回全量未过滤
+- - 正常流-3(结构):FamilyMemberService 应提供 keyword/String 参数或 search 命名的列表方法,当前仅 listMembers(Long)/listMembersOfFamily/listMembersWithFamily
+- - 正常流-4(结构):FamilyMemberVO 应含在线状态字段 online/onlineStatus/lastActiveAt,当前全部缺失
+- - 异常流-1:非法分页参数(page=0/pageSize=-1)应 400 校验拦截,当前静默忽略返回 200
+- GREEN 基线锚点(锁定既有实现不被 GREEN 误伤):
+- - 基线-1:匿名 userId<=0 → 401
+- - 基线-2:指定非本家庭 familyId → 403(canAccessFamily 已具备)
+- - 基线-3:无分页/搜索参数时返回全量成员列表(兼容现状语义)
+- 实测 mvn -Dtest=FamilyMembersListScP04ContractTest test:Tests run 8, Failures 5, Errors 0(红=RED 完成)。
+- 溯源:tests/user-scenarios/应用场景总览.md SC-P-04;
+- API_REFERENCE §4.2;FamilyMembersController.listMembers + 分页/搜索。
+- 仅新增 src/test 测试文件,未改 src/main。GREEN 实现指引自类注释。
+- 
+
+### Bug 修复
+- admin.reportParser.manage saveType 显式置空 linkedProductId 改用字符串版 UpdateWrapper(消除 lambda cache 依赖,RED 3例转绿)
+
+
+## v1.0.2465 (2026-11-13)
+
+### 测试
+- RED 契约测试 report.upload.parse 上传解析确认链路(并发幂等/未知聚类/异常值拦截)
+- RED 契约单测 S-cfc-281(SC-P-44 确认方案/SC-P-45 方案直接发布,7 例全红)
+- assessment.appointment.create 预约时间冲突校验 RED 契约测试(SC-P-36 边界,预期红)
+- S-cfc-264 add RED contract test for energy.fiveDim.view (五维分配总和=100%/配置报警/空态不500)
+- 定时自动化闭环报告 - 后端全量3745例92.84% + 浏览器28过2跳 + API全量990例首次完跑(23红) + langgraph 41/51(配额红)
+- RED contract test for growth.milestone.mark 成长里程碑标记
+- RED 契约单测 butler.resource.match(SC-H-05 线下资源与活动对接)9/11 红
+- 合入 RED 契约单测 auth.account.deactivate(SC-P-71 账号注销)
+- assessment.order.pay 契约级 RED 单测(S-cfc-276)
+- add RED contract test for SC-P-47 plan task list view (S-cfc-282)
+- S-cfc-262 task.frequency.config 任务频率/周期配置 契约级单测 11例全红
+- RED 契约级单测 contact.group.import(SC-P-62 联系人分组/导入)
+- S-cfc-271 契约新增能力 RED 单测(收藏/调替换食材/营养对齐,宿主 MealPlanService 未实现预期红)
+- RED 契约单测 ai.coach.handoffPlanner(SC-B-09 教练转接成长规划师)
+- 契约级 RED 单测 assessment.type.browse(SC-P-31 测评类型浏览)
+- RED 契约单测 assessment.planner.select(SC-P-32 测评选规划师→绑定 T 列表,未绑定提示先绑定)
+- RED 契约测试 diet.mealPlan.generate 一日三餐生成/忌口排除
+- RED 契约单测 energy.ledger.view(SC-P-18 能量流水查看展示口径)
+- RED 契约单测 report.archive.manage(SC-P-24/25 报告管理·删除守卫/趋势/对比/归属)
+- 契约测试 family.family.createWithInvite RED
+- RED contract test for butler.escalation.handle (S-cfc-251)
+
+### 文档
+- 研发负责人 第157轮汇报(恢复1 + 派发2 GREEN 实现)
+
+### 其他
+- - 契约宿主 GrowthMilestoneService(markMilestone/isMarked + 重复标幂等)未落地
+- - GrowthController /api/growth 无 milestone 端点(缺口 G-2)
+- 实测 8 用例 7 失败(宿主缺失 + 端点缺失),权限流不适用用例通过。
+- 溯源:SC-P-51 成长里程碑(系统/手动标里程碑→时间线高亮,重复标幂等);
+- 设计:API_REFERENCE §4.6 /api/growth/*;缺口 G-2(2026-11-07-parent-rest-contract)
+- 
+- 契约溯源:
+- - 需求 SC-P-47(查看方案下任务列表:方案关联任务列表(状态/进度),任务增删与方案同步)
+- - 设计 API_REFERENCE.md 4.3 任务视图;模块 GrowthPlanController + TaskController
+- 新增 GrowthPlanTaskListContractTest(反射结构契约,纯 Mockito/无 Spring/DB/外部服务):
+- - 正常流-1: GrowthPlanController 应暴露 POST /api/growth/plan/task/list
+- - 正常流-2: 任务 Item 应含 status/progress 字段(已存在,绿)
+- - 正常流-3: 任务应含 growthPlanId/planId 方案关联(任务增删与方案同步)
+- - 正常流-4: GrowthPlanService 应提供方案任务清单方法
+- - 异常流-1: 缺 planId/memberId 参数守卫
+- - 权限流-1: 家庭归属校验(IDOR 防护)
+- RED 结果: 6 tests, 5 failures(契约缺失点), 1 pass(既有字段)
+- 
+- 
+- - 契约:测评页列 DAN 8 类(mind/wisdom/cognition/learning/behavior/career/campus/adolescent)
+- - 断言缺失:AssessmentService 类型浏览入口、AssessmentMaterial 类型码字段、
+-   assessment_materials 表类型码列、DanAssessmentController 类型浏览 POST 端点
+- - 验证:Tests run: 7, Failures: 5, Errors: 0(RED 符合预期)
+- 
+- - 纯 JUnit5 + Mockito + 反射结构探测,无 Spring/DB/外部服务(同批 RED 契约测试风格)
+- - 契约锚点 DietRecommendationService:generateDailyMealPlan(Long,Map) /
+-   resolveParticipantExclusions(List) / excludeRestrictedFromMenu(Object,List) 均未实现
+- - 覆盖:早/午/晚三餐返回形态(meals/degraded/excludedItems)、无报告降级通用食谱、
+-   忌口/过敏自动排除并集、按忌口重算排除项 + 冲突提示(conflictPrompt)
+- - 预期红:13 用例 13 失败,GREEN 阶段按契约签名落地即转绿
+- 
+- RED 断言展示口径未落地:
+- - sourceName 可读来源名(task→完成任务 / health_checkin→健康打卡 / assessment→测评 / 未映射回退原始码)
+- - dimensionCode 维度代码暴露(按 dimensionId)
+- - createdAt @JsonFormat(yyyy-MM-dd'T'HH:mm:ss) 时间格式统一
+- 纯 Mockito/反射,无 Spring/DB;8 测试 = 6 红(契约缺口)+ 2 绿(既有 memberId/familyId 门禁回归)。仅新增测试文件,未改 src/main。
+- 
+- - 服务层 6:正常/管理员回写/空名/超长30/注入/边界
+- - 控制层 4:空名400/超长400/正常/注入
+- - 权限 1:create-family 匿名需 401(未在 LOGIN_REQUIRED_PATHS)
+- - 锚点契约:POST /api/family/user/create-family(SC-P-01, TC-P-01)
+- - 未改 src/main;GREEN 阶段在既有入口补齐契约行为
+- 
+- 本测试预期失败(红):断言 ButlerEscalationService 宿主 / ButlerEscalationOrder 实体 /
+- butler_escalation_orders 建表 / ButlerController+AdminButlerController escalation 端点均缺失,
+- 覆盖正常/异常/权限三流,GREEN 阶段实现后自动转绿。
+- 纯反射 + Mockito 契约级单测,无 Spring/DB/外部服务,风格对齐同批已合入 RED 契约测试。
+- 
+
+
 ## v1.0.2464 (2026-11-13)
 
 ### 测试

+ 149 - 0
docs/tdd/orchestration/report-dev-2026-11-14-0342.md

@@ -0,0 +1,149 @@
+# 研发负责人工作汇报
+
+> 本模板用于研发负责人按轮次/按日汇总研发工作。数据来源:`--status / --inspect / --clean-check / --changes / --auto` 实跑输出(2026-11-14 03:42 巡检轮 · 第 166 轮)。带 `*` 字段已如实填写,不留空占位。
+
+---
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 汇报人 | 研发负责人(错峰自动化轮 856ff81f · 第166轮) |
+| 汇报周期 | 2026年11月14日 03:42 ~ 2026年11月14日 03:53(单轮巡检+派发) |
+| 负责模块/单元范围 | 全量(无 scope 限定,仓库 E:/cfc,主分支 origin/cfclub) |
+
+---
+
+## 一、本轮工作数据汇总
+
+### 1.1 问题接收与处置
+
+| 指标 | 数量 | 说明 |
+|------|------|----------|
+| **收到的测试反馈问题数*** | 0 个 | `--inspect` 显示「当前无已登记阻塞」,`blockers.md` 无新增 B-* 待处理项 |
+| **已解决问题数*** | 0 个 | 本轮无 `--mark-*` 登记;`--auto` 仅做 git 证据自动核验与派发,不越权 mark |
+| **待解决研发问题数** | 0 个 | 无新阻塞;既有 O-24(部署超时无回执)归测试/部署侧,O-19(RED 孤儿收敛)已裁决不阻塞,均非研发侧未决 |
+
+### 1.2 任务分发与会话管理
+
+| 指标 | 数量 | 说明 |
+|------|------|----------|
+| **分派任务数*** | 2 个 | S-cfc-291 / S-cfc-292(均 TDD-RED 契约,label=cfc,实例 lan-189,详见附录 B) |
+| **恢复智能体会话数*** | 0 个 | `--inspect` 5 节点 interrupted=0;`--resume --dry-run` 探测节点 7 分钟无输出被停止,按 inspect「0 中断」判定无可恢复 |
+| **当前在用会话数** | 12 个 | 5 节点 busy 合计 12(lan-189=2 / lan-204=5 / local-lan-4090=2 / mes-local-45278=1 / pub-iwintrue=2),上限 10/节点,剩余配额 5~9 |
+| **会话平均利用率** | ~24% | = 12 busy / 50 节点会话总量(粗估);配额未满,留有余量供错峰轮次续派 |
+
+### 1.2b 各会话当前工作状态列表
+
+| 节点 | 当前状态 | busy/interrupted | 当前任务 | 工作目录 | 备注 |
+|----------|----------|----------|----------|------|------|
+| lan-189 | running | busy=2 / interrupted=0 | S-cfc-291、S-cfc-292(本轮新派) | clean-check 主树 924 处他人 WIP 零接触 | 本轮派发目标节点 |
+| lan-204 | running | busy=5 / interrupted=0 | 既有在途任务 | 同上 | 负载偏高 5/10 |
+| local-lan-4090 | running | busy=2 / interrupted=0 | 既有在途任务 | 同上 | — |
+| mes-local-45278 | running | busy=1 / interrupted=0 | 既有在途任务 | 同上 | — |
+| pub-iwintrue | running | busy=2 / interrupted=0 | 既有在途任务 | 同上 | — |
+| (空闲说明) | idle | 各节点 idle 45~49 | — | — | 配额余量充足,未达 agent_session_limit |
+
+> 状态判定:5 节点均无 interrupted/wedged/thrash/swallowed;任务账本 dispatched=51 + 本轮 2 = 53 在途。`--clean-check`:主工作树 924 处未提交(.tdd 日志/.gitignore 等他人 WIP),**零接触不代收**,按原地观察处理。
+
+### 1.3 变更感知与新任务建立
+
+| 指标 | 数量 | 说明 |
+|------|------|----------|
+| **感知需求/设计变更数*** | 68 个设计文档 + 14 个测试用例文档 | `--changes --days 7`:检出 200 提交(2026-11-12 ~ 11-13),涉及 161 文件;另有 79 个其他文件(多为 .tdd 日志) |
+| **新增入池任务数*** | 0 个 | 变更后能力键对比:测试用例/契约设计均「无新增能力键(0 → 0)」,无需要的 `--add-task` |
+| **既有键状态流转数** | 0 次登记 | 本轮无 `--mark-*` 登记;`--auto` 对大量既有 YELLOW 键做 git 证据自动确认(YELLOW✓ + 自动待部署验证)与 REQUEUE-SKIP-O22 保持 done 不重派 |
+
+### 1.4 本轮 git 提交与推送证据(真理证据)
+
+| 提交 sha | 关联任务/能力键 | 阶段 | 触及文件类型 | 目标分支 | 已推送远端 | 备注 |
+|----------|-----------------|------|--------------|----------|------------|------|
+| (本轮无 mark-* 登记) | — | — | — | — | — | `--auto` 自动核验既有提交证据,本轮未产生需登记的阶段 commit |
+| (汇报文档提交) | 第166轮汇报 | — | docs | cfclub | 推送后核验 | 本文件 report-dev-2026-11-14-0342.md |
+
+### 1.5 状态机阶段分布与部署状态
+
+| 阶段 | 键数 | 备注 |
+|------|------|------|
+| UNTRACKED | 0 | 无新增(数据源 0 键,见 1.6) |
+| RED | 64 | 待开发实现(较上轮 94 减 30,RED 契约批次由其他错峰轮实现推进) |
+| YELLOW | 123 | 待测试校验(较上轮 93 增 30,与 RED 减少对应) |
+| GREEN | 8 | 待部署验证 |
+| DONE | 15 | 闭环归档 |
+
+| 部署项 | 值 | 说明 |
+|--------|-----|------|
+| 本轮部署次数 | 0 次 | 本轮未执行 `--deploy`/`--deploy-done`;部署在途 pending 30 / confirmed 77(全 testing),O-24 归测试/部署侧,研发不越权 |
+| 部署在途样例 | testing@0a01a0e8, testing@f6590c89 … | `--status` 显示「自动待部署验证」键群,待编排侧 `--deploy-done <env> --commit <sha>` 收口 |
+| GREEN 部署链验证 | 未推进 | 本轮无新 GREEN 产生;既有 GREEN 8 键依赖部署链收口(双账本 tasks.json/deploy_state.json 差异延续) |
+
+### 1.6 数据源健康度
+
+| 数据源 | 读取键数 | 是否正常 | 备注 |
+|--------|----------|----------|------|
+| 需求侧(⏳ wish) | 0 | 正常(模式特征) | CFC「发现/跟踪」模式,TDD 池由 tasks.json 任务账本驱动,状态机数据源 0 键为历轮常态 |
+| 契约常量(contract) | 0 | 正常(模式特征) | 0 键同上,契约常量仅作标注用,不入池门槛 |
+| 测试用例引用(test_case_map) | 0 | 正常(模式特征) | 同上 |
+| 执行结果回填(case_results) | 0 | 正常(模式特征) | 已部署键回验由测试/部署侧执行 |
+
+---
+
+## 二、下一步需要研发处理的事项
+
+| 序号 | 事项描述 | 依赖/前置条件 | 预估完成时间 | 优先级 | 状态 |
+|------|----------|---------------|--------------|--------|------|
+| 1 | 续派 pending 任务池(当前 pending 52→50,dispatched 53 在途) | 会话空闲配额(当前充足,5 节点 busy 12/50) | 下轮巡检 | P1 | 进行中 |
+| 2 | YELLOW 123 键待测试 GREEN + 部署收口 | 测试侧 `--mark-green` + 编排侧 `--deploy-done`(O-24 职责归测试/部署侧) | 持续 | P1 | 待启动 |
+| 3 | S-cfc-291/292 契约批次实现闭环核验 | 会话产出已推 origin/cfclub | 下轮巡检 | P2 | 待启动 |
+
+## 三、阻塞与风险
+
+| 阻塞项 | 影响范围 | 阻塞类型 | 处置进展 | 需要协调 |
+|--------|----------|----------|----------|----------|
+| 部署在途 pending 30 无回执(O-24) | YELLOW→GREEN 收口效率 | 测试/部署 | 处理中(既有 O-24 裁决归测试/部署侧,研发不越权代署) | 测试/部署侧巡检确认 |
+| 主工作树 924 处他人 WIP 未提交 | `--clean-check` 恒不干净 | 流程 | 待观察(含 .tdd 日志被追踪、.gitignore 变更;非本角色职责,零接触) | 对应产出会话/测试负责人收口 |
+| REQUEUE-SKIP-O22 键(done 无 git 证据) | 状态机账本与 git 证据对齐 | 流程 | 已收敛处理(键级已实现定论,保持 done 不重派),继续观察 | 无 |
+
+## 四、下轮工作规划
+
+| 计划项 | 预计完成时间 | 前置依赖 | 涉及会话标签 | 备注 |
+|--------|--------------|----------|--------------|------|
+| 续派 pending 任务(--auto --limit 2) | 下轮巡检 | 会话配额 | lan-189 等 5 节点 | 池空研判后按 `--add-task` 建新任务 |
+| 核验 S-cfc-291/292 产出 | 下轮巡检 | 远端提交 | lan-189 | 已推 origin/cfclub 且触及 src/test |
+
+---
+
+## 附录
+
+### 附录 A:收到的测试反馈问题明细
+
+| 问题 ID | 能力键/任务号 | 问题类型 | 来源 | 接收时间 | 处置状态 | 关联 sha |
+|---------|---------------|----------|------|----------|----------|----------|
+| (无新增) | — | — | `--inspect` 无已登记阻塞 | 2026-11-14 03:46 | — | — |
+
+### 附录 B:任务分派与会话恢复明细
+
+| 任务号 | 目标实例 | 任务类型 | 分派时间 | 会话 ID | 当前状态 | 恢复会话 | 恢复原因 | 恢复时间 |
+|--------|------|----------|----------|---------|----------|----------|----------|----------|
+| S-cfc-291 | lan-189 | TDD-RED 契约 | 2026-11-14 03:53 | ses_e29868051ffeDq6vKZ0JQbGpR1 | running | — | — | — |
+| S-cfc-292 | lan-189 | TDD-RED 契约 | 2026-11-14 03:53 | ses_e2985dc76ffeSnrY8zL2Ezu0ma | running | — | — | — |
+
+> 派发通道:tdd_orchestrate.py `--auto --role 开发 --limit 2`(T5 直连 skill,未调用 hub 任何脚本)。选路:lan-189(负载 0/10 会话)。自动派发合计:成功 2 / 失败 0 / 跳过(超限)0。
+
+### 附录 C:新增入池任务明细
+
+| 任务号 | 能力键 | 需求溯源 | 设计溯源 | 创建时间 | 状态 |
+|--------|--------|----------|----------|----------|------|
+| (本轮无新增) | — | 变更感知 0 新增键 | — | — | — |
+
+### 附录 D:变更感知明细(来自 `--changes --days 7`)
+
+| 变更文档 | 文档类型 | 变更日期 | 新增能力键 | 是否已入池 |
+|----------|----------|----------|------------|------------|
+| docs/superpowers/PROJECT-OVERVIEW.md 等 68 个 | 设计 | 2026-11-12 ~ 11-13 | 0 | — |
+| docs/tdd/test/* 等 14 个(automation-status/inventory/discovery/blockers…) | 用例 | 2026-11-12 ~ 11-13 | 0 | — |
+| .tdd/_r189~_r192 日志等 79 个 | 其他 | 2026-11-13 | — | — |
+
+---
+
+**模板版本**:v1.1(2026-11-03)· 第 166 轮研发负责人汇报 · 2026-11-14 03:42