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

Merge remote-tracking branch 'origin/cfclub' into cfclub

zxyj-langgraph 4 дней назад
Родитель
Сommit
de919fb890

+ 235 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/EnergyLedgerViewContractTest.java

@@ -0,0 +1,235 @@
+package com.etotem.cfc.unit;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.etotem.cfc.common.Result;
+import com.etotem.cfc.controller.EnergyController;
+import com.etotem.cfc.entity.EnergyDimension;
+import com.etotem.cfc.entity.EnergyLog;
+import com.etotem.cfc.mapper.EnergyDimensionMapper;
+import com.etotem.cfc.mapper.EnergyLogMapper;
+import com.etotem.cfc.service.EnergyService;
+import com.fasterxml.jackson.annotation.JsonFormat;
+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.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * 契约测试:能力键 {@code energy.ledger.view}(SC-P-18 能量流水查看,业务域 C 五维能量与健康)。
+ *
+ * <p><b>契约锚点</b></p>
+ * <ul>
+ *   <li>需求:{@code tests/user-scenarios/应用场景总览.md} SC-P-18 —— 目标:追溯能量来源;流程:能量明细(任务/打卡/测评);边界:时间格式统一。模块:{@code EnergyController}。</li>
+ *   <li>设计:{@code docs/superpowers/api/API_REFERENCE.md} §4.5 —— {@code POST /api/energy/logs} 能量流水。</li>
+ *   <li>职责边界:本键 = 查看流水(view);{@code energy.ledger.guard}(S-cfc-225)= 账本一致性守卫。二者互补不重复:guard 校验 {@code balanceAfter==prev+amount},view 校验 <b>展示口径</b>(来源可读名 + 时间格式)。</li>
+ * </ul>
+ *
+ * <p><b>被校验的契约行为(展示口径,TDD-RED)</b></p>
+ * <ul>
+ *   <li><b>来源溯源可读</b>:每条流水必须暴露可读来源名 {@code sourceName}("task"→"完成任务"、"health_checkin"→"健康打卡"、"assessment"→"测评"等),而非仅原始 {@code sourceType} 码;未映射来源回退原始码,不得抛错。</li>
+ *   <li><b>维度代码</b>:每条流水需暴露 {@code dimensionCode}(如 "body"/"mind"),使前端无需再查维度表即可按维度着色/筛选。</li>
+ *   <li><b>时间格式统一</b>:{@code createdAt} 响应须以 {@code yyyy-MM-dd'T'HH:mm:ss}(ISO 8601)字符串暴露,而非裸 {@code java.util.Date}(Jackson 默认序列化为 epoch 毫秒)。与项目时间显示规范一致(后端统一 ISO 8601,前端按需格式化)。</li>
+ * </ul>
+ *
+ * <p><b>测试范围</b>:{@link EnergyController#getEnergyLogs} + {@link EnergyService#getLogs} 的展示口径。仅用 Mockito(无 Spring / 无 DB),不依赖真实外部服务。</p>
+ *
+ * <p><b>读取策略</b>:{@code sourceName}/{@code dimensionCode} 为待落地的展示字段,{@code EnergyLog} 实体当前没有,
+ * 故用反射 {@link #readField} 读取(字段缺失即抛异常 = 契约失败),使本测试可编译、失败发生在测试阶段(运行期红)而非编译期红,
+ * 与同批 RED 契约测试风格一致。{@code createdAt} 的 ISO 8601 契约用 {@code @JsonFormat} 注解存在性断言。</p>
+ *
+ * <p><b>RED 预期</b>:{@code EnergyLog} 实体当前只有 {@code sourceType}/{@code sourceId}/{@code dimensionId}/{@code Date createdAt},
+ * 无 {@code sourceName}/{@code dimensionCode} 展示字段,{@code createdAt} 亦无 {@code @JsonFormat} —— 本契约展示口径未落地,
+ * 三条用例在 GREEN 补齐前应失败(红)。</p>
+ */
+class EnergyLedgerViewContractTest extends EnergyContractTestBase {
+
+    private static final String MSG_NO_MEMBER = "memberId不能为空";
+
+    private EnergyService service;
+    private EnergyDimensionMapper dimensionMapper;
+    private EnergyLogMapper logMapper;
+    private EnergyController controller;
+
+    @BeforeEach
+    void setUp() throws Exception {
+        service = new EnergyService();
+        dimensionMapper = mock(EnergyDimensionMapper.class);
+        logMapper = mock(EnergyLogMapper.class);
+        inject(service, "energyDimensionMapper", dimensionMapper);
+        inject(service, "energyLogMapper", logMapper);
+        inject(service, "energyBalanceMapper", mock(com.etotem.cfc.mapper.EnergyBalanceMapper.class));
+        inject(service, "energySourceConfigMapper", mock(com.etotem.cfc.mapper.EnergySourceConfigMapper.class));
+        inject(service, "energyBehaviorConfigMapper", mock(com.etotem.cfc.mapper.EnergyBehaviorConfigMapper.class));
+        inject(service, "wishMapper", mock(com.etotem.cfc.mapper.WishMapper.class));
+        inject(service, "familyMemberMapper", mock(com.etotem.cfc.mapper.FamilyMemberMapper.class));
+        inject(service, "notificationDispatchService", mock(com.etotem.cfc.service.NotificationDispatchService.class));
+
+        controller = new EnergyController();
+        inject(controller, "energyService", service);
+        inject(controller, "fiveDimensionScoreService", mock(com.etotem.cfc.service.FiveDimensionScoreService.class));
+        inject(controller, "userMapper", mock(com.etotem.cfc.mapper.UserMapper.class));
+        inject(controller, "unlockGateService", mock(com.etotem.cfc.service.UnlockGateService.class));
+
+        initTable(EnergyLog.class);
+        initTable(EnergyDimension.class);
+    }
+
+    private void seedDims() {
+        when(dimensionMapper.selectList(any())).thenReturn(Arrays.asList(fiveDims()));
+    }
+
+    private void seedPage(EnergyLog... logs) {
+        when(logMapper.selectPage(any(Page.class), any())).thenAnswer(inv -> {
+            Page<EnergyLog> p = inv.getArgument(0);
+            p.setRecords(Arrays.asList(logs));
+            p.setTotal(logs.length);
+            return p;
+        });
+    }
+
+    /** 通过 controller 入口取回流水 Page(走 memberId/familyId 门禁 + service.getLogs) */
+    private Page<EnergyLog> invokeLogs() {
+        Map<String, Object> params = new HashMap<>();
+        params.put("memberId", 50L);
+        Result<Page<EnergyLog>> r = controller.getEnergyLogs(params, 1L, 50L);
+        assertEquals(200, r.getCode(), "入口应返回 200");
+        assertNotNull(r.getData());
+        return r.getData();
+    }
+
+    /** 反射读取实体字段(沿类层次向上查找);字段缺失即抛 IllegalStateException = 契约失败 */
+    private static Object readField(Object target, String fieldName) {
+        Class<?> cls = target.getClass();
+        Field f = null;
+        while (cls != null && f == null) {
+            try {
+                f = cls.getDeclaredField(fieldName);
+            } catch (NoSuchFieldException e) {
+                cls = cls.getSuperclass();
+            }
+        }
+        if (f == null) {
+            throw new IllegalStateException(
+                    "EnergyLog 缺少契约展示字段 '" + fieldName + "'(SC-P-18 能量流水查看:展示口径未落地)");
+        }
+        f.setAccessible(true);
+        try {
+            return f.get(target);
+        } catch (IllegalAccessException e) {
+            throw new IllegalStateException("无法读取字段 " + fieldName, e);
+        }
+    }
+
+    // ==================== 契约 AC-1:来源溯源可读(task / health_checkin / assessment) ====================
+
+    @Test
+    @DisplayName("SC-P-18 契约:task 流水暴露可读来源名 sourceName=完成任务")
+    void 契约_任务流水_来源可读名() {
+        seedDims();
+        seedPage(energyLog(1L, 50L, 5L, 10, 30, "task", 100L));
+
+        Page<EnergyLog> page = invokeLogs();
+        EnergyLog log = page.getRecords().get(0);
+        assertEquals("task", log.getSourceType(), "原始来源码应为 task");
+        assertEquals("完成任务", readField(log, "sourceName"), "task 应映射为可读来源名「完成任务」");
+    }
+
+    @Test
+    @DisplayName("SC-P-18 契约:health_checkin 流水暴露可读来源名 sourceName=健康打卡")
+    void 契约_打卡流水_来源可读名() {
+        seedDims();
+        seedPage(energyLog(2L, 50L, 4L, 5, 25, "health_checkin", 200L));
+
+        Page<EnergyLog> page = invokeLogs();
+        EnergyLog log = page.getRecords().get(0);
+        assertEquals("health_checkin", log.getSourceType(), "原始来源码应为 health_checkin");
+        assertEquals("健康打卡", readField(log, "sourceName"), "health_checkin 应映射为「健康打卡」");
+    }
+
+    @Test
+    @DisplayName("SC-P-18 契约:assessment 流水暴露可读来源名 sourceName=测评")
+    void 契约_测评流水_来源可读名() {
+        seedDims();
+        seedPage(energyLog(3L, 50L, 1L, 8, 18, "assessment", 300L));
+
+        Page<EnergyLog> page = invokeLogs();
+        EnergyLog log = page.getRecords().get(0);
+        assertEquals("assessment", log.getSourceType(), "原始来源码应为 assessment");
+        assertEquals("测评", readField(log, "sourceName"), "assessment 应映射为「测评」");
+    }
+
+    @Test
+    @DisplayName("SC-P-18 契约:未映射来源码回退原始码,不抛错")
+    void 契约_未映射来源_回退原始码() {
+        seedDims();
+        seedPage(energyLog(4L, 50L, 3L, 6, 6, "unknown_source", 400L));
+
+        Page<EnergyLog> page = invokeLogs();
+        EnergyLog log = page.getRecords().get(0);
+        assertEquals("unknown_source", readField(log, "sourceName"), "未映射来源应回退原始码,且不抛错");
+    }
+
+    // ==================== 契约 AC-2:维度代码暴露 ====================
+
+    @Test
+    @DisplayName("SC-P-18 契约:流水暴露 dimensionCode(如 body)供前端维度着色/筛选")
+    void 契约_流水暴露维度代码() {
+        seedDims();
+        seedPage(energyLog(5L, 50L, 5L, 10, 10, "task", 500L));
+
+        Page<EnergyLog> page = invokeLogs();
+        EnergyLog log = page.getRecords().get(0);
+        assertEquals(5L, log.getDimensionId(), "前置:维度 ID=5 应为 body");
+        assertEquals("body", readField(log, "dimensionCode"), "应按 dimensionId 暴露 dimensionCode");
+    }
+
+    // ==================== 契约 AC-3:时间格式统一(yyyy-MM-dd'T'HH:mm:ss) ====================
+
+    @Test
+    @DisplayName("SC-P-18 契约:createdAt 以 ISO 8601 序列化(@JsonFormat yyyy-MM-dd'T'HH:mm:ss)")
+    void 契约_时间格式ISO8601() throws Exception {
+        seedDims();
+        seedPage(energyLog(6L, 50L, 5L, 10, 10, "task", 600L));
+
+        Page<EnergyLog> page = invokeLogs();
+        EnergyLog log = page.getRecords().get(0);
+        assertNotNull(log.getCreatedAt(), "前置:createdAt 非空");
+
+        Field createdAtField = EnergyLog.class.getDeclaredField("createdAt");
+        JsonFormat ann = createdAtField.getAnnotation(JsonFormat.class);
+        assertNotNull(ann,
+                "EnergyLog.createdAt 需 @JsonFormat(pattern=\"yyyy-MM-dd'T'HH:mm:ss\"),否则 Jackson 序列化为 epoch 毫秒,时间格式不统一");
+        assertEquals("yyyy-MM-dd'T'HH:mm:ss", ann.pattern(), "时间格式必须统一为 yyyy-MM-dd'T'HH:mm:ss");
+    }
+
+    // ==================== 既有门禁回归:view 与 guard 职责不互斥 ====================
+
+    @Test
+    @DisplayName("SC-P-18 回归:无 memberId 仍返回业务提示(view 不破坏既有门禁)")
+    void 回归_无memberId_业务提示() {
+        Map<String, Object> params = new HashMap<>();
+        params.put("dimensionCode", "body");
+        Result<Page<EnergyLog>> r = controller.getEnergyLogs(params, 1L, null);
+        assertEquals(500, r.getCode());
+        assertEquals(MSG_NO_MEMBER, r.getMessage());
+    }
+
+    @Test
+    @DisplayName("SC-P-18 回归:无 familyId 返回 5001(view 不破坏既有权限门禁)")
+    void 回归_无familyId_5001() {
+        Map<String, Object> params = new HashMap<>();
+        params.put("memberId", 50L);
+        Result<Page<EnergyLog>> r = controller.getEnergyLogs(params, null, 50L);
+        assertEquals(5001, r.getCode());
+    }
+}

+ 322 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/ReportArchiveManageContractTest.java

@@ -0,0 +1,322 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.entity.HealthReport;
+import com.etotem.cfc.service.FamilyMemberNutritionProfileService;
+import com.etotem.cfc.service.HealthReportService;
+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.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.text.SimpleDateFormat;
+import java.util.Collections;
+import java.util.Date;
+import java.util.List;
+import java.util.Map;
+
+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.Mockito.when;
+
+/**
+ * 契约级单测:报告档案管理(能力键 {@code report.archive.manage},TDD-RED 阶段)。
+ *
+ * <p><b>契约溯源</b></p>
+ * <ul>
+ *   <li>需求:{@code tests/user-scenarios/应用场景总览.md}
+ *       <ul>
+ *         <li><b>SC-P-24 多报告管理/对比</b>(业务域 C,模块 报告管理)—— 流程:报告列表 → 查看/删除/对比;
+ *             边界:<b>删除有关联方案时提示</b>。对应测试用例 TC-P-24 / TC-P-24-E / TC-P-24-P:
+ *             <ul>
+ *               <li>TC-P-24:删除有关联方案时提示;对比展示差异</li>
+ *               <li>TC-P-24-E:有方案时提示<b>「请先解除关联方案」</b>再删;不存在 id 返回 404 不崩</li>
+ *               <li>TC-P-24-P:非归属数据访问(报告)统一 403/401,横向越权被拒</li>
+ *             </ul></li>
+ *         <li><b>SC-P-25 报告趋势查看</b>(业务域 C,模块 报告/成长)—— 流程:同类型报告时间序列 → 趋势图;
+ *             边界:<b>单报告无趋势</b>;时间轴正确。对应 TC-P-25 / TC-P-25-E:
+ *             <ul>
+ *               <li>TC-P-25:同类型报告时间序列趋势图;单报告无趋势提示;时间轴按真实时间升序</li>
+ *               <li>TC-P-25-E:仅 1 份同类型报告 → 提示<b>「至少需要 2 份报告才能看趋势」</b>;
+ *                   两份报告时间倒挂时按真实时间升序不倒挂</li>
+ *             </ul></li>
+ *       </ul></li>
+ *   <li>设计:{@code docs/superpowers/api/API_REFERENCE.md}
+ *       <ul>
+ *         <li>§4.10 测评({@code POST /api/assessment/history} 测评历史、
+ *             {@code POST /api/assessment/latest-result} 最新结果)—— 成长档案 / 报告管理锚点</li>
+ *         <li>§4.59.10 契约缺口:<b>未实现端点</b> {@code /api/health/report/{compare,trend,...}}
+ *             (即报告对比 / 报告趋势契约新增,实现未落地)</li>
+ *       </ul></li>
+ * </ul>
+ *
+ * <p><b>实现现状(2026-11-14,本分支 src/main 核实)</b>:以下契约行为<b>均未落地</b>,本测试逐一探测缺失:</p>
+ * <ol>
+ *   <li><b>删除守卫缺失</b>:{@code HealthReportService.deleteReport(Long)} 无条件逻辑删除(status=deleted +
+ *       清理关联数据),<b>不检测报告关联成长方案</b>——服务内无 {@code GrowthPlanMapper} /
+ *       {@code hasLinkedPlan} / {@code assertNotLinkedToPlan} 入口,无法在删除前提示「请先解除关联方案」。</li>
+ *   <li><b>单报告趋势未拦</b>:{@code FamilyMemberNutritionProfileService.getReportTrendData(memberId)}
+ *       对 1 份报告仍返回单点序列(dates/scores 各 1 项),<b>不标记无趋势、不提示</b>「至少需要 2 份报告才能看趋势」。</li>
+ *   <li><b>趋势未按同类型过滤</b>:{@code getReportTrendData} 仅 1 参(memberId),无 {@code reportType}
+ *       入参,无法只取「同类型报告」时间序列(SC-P-25 口径)。</li>
+ *   <li><b>报告对比缺失</b>:契约宿主 {@code ReportArchiveCompareService} 未落地;{@code HealthReportController}
+ *       无 {@code POST /api/health/report/compare} 端点(对比展示差异 / 类型一致才可比对均无载体)。</li>
+ *   <li><b>删除归属未校验</b>:{@code HealthReportController.deleteReport} 仅收 {@code @RequestBody Map},
+ *       无 {@code userId}/{@code memberId} 归属校验,横向越权删除他人报告不被拒(TC-P-24-P)。</li>
+ * </ol>
+ *
+ * <p><b>测试范围</b>:纯 Mockito / 反射,无 Spring 上下文、无 DB、无外部服务、无真实微信。
+ * 能编译、能运行、断言失败(红),失败断言原文清晰可贴;实现落地后转绿。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:实现者按本契约补齐——
+ * (1) {@code HealthReportService} 注入 {@code GrowthPlanMapper} 并提供 {@code hasLinkedPlan(Long)}/
+ * {@code assertNotLinkedToPlan(Long)},删除前命中则抛 {@code MSG_LINKED_PLAN};
+ * (2) {@code FamilyMemberNutritionProfileService.getReportTrendData} 增 {@code reportType} 同类型过滤,
+ * 单报告(同类型 &lt;2)时返回 {@code trendAvailable=false} + 提示 {@code MSG_SINGLE_REPORT_TREND};
+ * (3) 落地 {@code ReportArchiveCompareService.compareReports(reportAId, reportBId)}(类型一致才可比对,返回差异标注)
+ * 及 {@code HealthReportController} 的 {@code POST /api/health/report/compare} 端点;
+ * (4) {@code HealthReportController.deleteReport} 增 {@code @RequestAttribute("userId")} 归属校验,
+ * 非归属返回 403/401。</p>
+ */
+class ReportArchiveManageContractTest {
+
+    // ==================== 契约文案(TC-P-24-E / TC-P-25-E 原文) ====================
+
+    /** 删除有关联方案时的提示(TC-P-24-E「请先解除关联方案」) */
+    private static final String MSG_LINKED_PLAN = "该报告已关联成长方案,请先解除关联方案后再删除";
+
+    /** 单报告无趋势提示(TC-P-25-E「至少需要 2 份报告才能看趋势」) */
+    private static final String MSG_SINGLE_REPORT_TREND = "至少需要 2 份报告才能看趋势";
+
+    /** 报告对比契约宿主(§4.59.10 未实现端点 /api/health/report/compare 的服务层载体) */
+    private static final String HOST_REPORT_COMPARE = "com.etotem.cfc.service.ReportArchiveCompareService";
+
+    // ==================== Mockito:趋势行为探测(SC-P-25) ====================
+
+    @Mock
+    private HealthReportService healthReportService;
+
+    @InjectMocks
+    private FamilyMemberNutritionProfileService trendService;
+
+    @BeforeEach
+    void setUp() {
+        MockitoAnnotations.openMocks(this);
+    }
+
+    // ==================== A. 删除守卫(关联方案)— SC-P-24 / TC-P-24-E ====================
+
+    @Test
+    @DisplayName("删除守卫:HealthReportService 应提供关联方案检测入口(hasLinkedPlan/assertNotLinkedToPlan)")
+    void deleteReport_应提供关联方案检测入口() {
+        Class<?> svc = loadClass("com.etotem.cfc.service.HealthReportService");
+        assertNotNull(svc, "[report.archive.manage] HealthReportService 类不存在,无法探测删除守卫入口。");
+
+        // 守卫入口:方法 hasLinkedPlan(Long) / assertNotLinkedToPlan(Long),或注入 GrowthPlanMapper 字段
+        boolean hasGuardMethod = false;
+        for (Method m : svc.getDeclaredMethods()) {
+            String n = m.getName();
+            if (("hasLinkedPlan".equals(n) || "assertNotLinkedToPlan".equals(n))
+                    && m.getParameterCount() == 1) {
+                hasGuardMethod = true;
+                break;
+            }
+        }
+        boolean hasGrowthPlanMapper = false;
+        for (Field f : svc.getDeclaredFields()) {
+            if (f.getType().getName().endsWith("GrowthPlanMapper")) {
+                hasGrowthPlanMapper = true;
+                break;
+            }
+        }
+
+        assertTrue(hasGuardMethod || hasGrowthPlanMapper,
+                "[report.archive.manage] HealthReportService 缺少关联方案检测入口:删除前应检测报告是否关联"
+                        + "成长方案(hasLinkedPlan/assertNotLinkedToPlan 或 GrowthPlanMapper),"
+                        + "命中则提示「" + MSG_LINKED_PLAN + "」(SC-P-24 / TC-P-24-E)。实现未落地。");
+    }
+
+    @Test
+    @DisplayName("删除守卫:删除关联方案报告应被拒并提示「请先解除关联方案」,不落删除")
+    void deleteReport_关联方案报告_应拒绝并提示_不删除() {
+        Class<?> svc = loadClass("com.etotem.cfc.service.HealthReportService");
+        assertNotNull(svc, "[report.archive.manage] HealthReportService 类不存在。");
+
+        // 行为探测:定位删除守卫入口(GREEN 后在此反射调用并断言抛 MSG_LINKED_PLAN + 不执行删除)
+        Method guard = null;
+        for (Method m : svc.getDeclaredMethods()) {
+            String n = m.getName();
+            if (("hasLinkedPlan".equals(n) || "assertNotLinkedToPlan".equals(n))
+                    && m.getParameterCount() == 1) {
+                guard = m;
+                break;
+            }
+        }
+        if (guard == null) {
+            // 契约入口缺失即红:无法表达「关联方案报告删除被拒」这一行为(TC-P-24-E)
+            fail("[report.archive.manage] 删除守卫入口缺失:无 hasLinkedPlan/assertNotLinkedToPlan,"
+                    + "删除关联方案报告时无法提示「" + MSG_LINKED_PLAN + "」,会无条件删除(SC-P-24)。");
+        }
+        // 守卫入口已存在(GREEN 阶段补行为级断言:反射调用抛 MSG_LINKED_PLAN)
+        assertNotNull(guard, "[report.archive.manage] 删除守卫入口应存在(SC-P-24)。");
+    }
+
+    // ==================== B. 趋势守卫(单报告 / 同类型)— SC-P-25 / TC-P-25-E ====================
+
+    @Test
+    @DisplayName("趋势:单报告应标记无趋势并提示「至少需要 2 份报告才能看趋势」")
+    void 趋势_单报告_应标记无趋势并提示() {
+        HealthReport only = report("gut_flora", "2026-10-01", 72);
+
+        when(healthReportService.getMemberReports(1L)).thenReturn(Collections.singletonList(only));
+
+        Map<String, Object> trend = trendService.getReportTrendData(1L);
+        assertNotNull(trend, "[report.archive.manage] 趋势数据不应为 null(SC-P-25)。");
+
+        // 契约:单报告(同类型 <2)→ trendAvailable=false + 提示文案(TC-P-25-E)
+        assertFalse(Boolean.TRUE.equals(trend.get("trendAvailable")),
+                "[report.archive.manage] 单报告应标记 trendAvailable=false(无趋势),"
+                        + "当前仅 1 份报告仍返回单点序列(dates/scores 各 1 项)。SC-P-25 边界未落地。");
+        assertTrue(trend.containsKey("message") && trend.get("message") != null
+                        && trend.get("message").toString().contains(MSG_SINGLE_REPORT_TREND),
+                "[report.archive.manage] 单报告趋势应返回提示「" + MSG_SINGLE_REPORT_TREND
+                        + "」(TC-P-25-E),当前 response 无 message 字段。实现未落地。");
+    }
+
+    @Test
+    @DisplayName("趋势:应提供 reportType 同类型过滤入参(同类型报告时间序列)")
+    void 趋势_应提供reportType同类型过滤入参() {
+        Class<?> svc = loadClass("com.etotem.cfc.service.FamilyMemberNutritionProfileService");
+        assertNotNull(svc, "[report.archive.manage] FamilyMemberNutritionProfileService 类不存在。");
+
+        boolean hasTypedOverload = false;
+        for (Method m : svc.getDeclaredMethods()) {
+            if (m.getName().equals("getReportTrendData") && m.getParameterCount() == 2) {
+                hasTypedOverload = true;
+                break;
+            }
+        }
+        assertTrue(hasTypedOverload,
+                "[report.archive.manage] getReportTrendData 缺少 reportType 入参:SC-P-25 口径为"
+                        + "「同类型报告时间序列」→趋势图,需按 reportType 过滤;当前仅 1 参(memberId),"
+                        + "无法只取同类型报告。实现未落地。");
+    }
+
+    // ==================== C. 报告对比(SC-P-24 对比展示差异)— 正常流 ====================
+
+    @Test
+    @DisplayName("报告对比:应提供 ReportArchiveCompareService 宿主")
+    void 报告对比_应提供ReportArchiveCompareService宿主() {
+        Class<?> host = loadClass(HOST_REPORT_COMPARE);
+        assertNotNull(host,
+                "[report.archive.manage] ReportArchiveCompareService 未落地:SC-P-24「对比展示差异」"
+                        + "(TC-P-24)契约宿主缺失,报告档案对比无载体(§4.59.10 未实现端点 /api/health/report/compare)。");
+    }
+
+    @Test
+    @DisplayName("报告对比:宿主应提供 compareReports(reportAId, reportBId) 契约方法")
+    void 报告对比_宿主应提供compareReports方法() {
+        Class<?> host = loadClass(HOST_REPORT_COMPARE);
+        if (host == null) {
+            fail("[report.archive.manage] ReportArchiveCompareService 未落地,无法验证 compareReports "
+                    + "契约方法(SC-P-24 / TC-P-24)。");
+        }
+        boolean hasCompare = false;
+        for (Method m : host.getDeclaredMethods()) {
+            if (m.getName().equals("compareReports") && m.getParameterCount() == 2) {
+                hasCompare = true;
+                break;
+            }
+        }
+        assertTrue(hasCompare,
+                "[report.archive.manage] ReportArchiveCompareService 应提供 compareReports(reportAId, reportBId),"
+                        + "报告类型一致才可比对、差异清晰标注(SC-P-24 / TC-T-21)。");
+    }
+
+    @Test
+    @DisplayName("报告对比:HealthReportController 应暴露 POST /api/health/report/compare 端点")
+    void 报告对比_应暴露report_compare端点() {
+        Class<?> controller = loadClass("com.etotem.cfc.controller.HealthReportController");
+        assertNotNull(controller, "[report.archive.manage] HealthReportController 类不存在。");
+
+        boolean exposed = false;
+        for (Method m : controller.getDeclaredMethods()) {
+            org.springframework.web.bind.annotation.PostMapping post =
+                    m.getAnnotation(org.springframework.web.bind.annotation.PostMapping.class);
+            if (post != null) {
+                for (String v : post.value()) {
+                    if ("/report/compare".equals(v)) {
+                        exposed = true;
+                        break;
+                    }
+                }
+            }
+            if (exposed) break;
+        }
+        assertTrue(exposed,
+                "[report.archive.manage] HealthReportController 缺少 POST /api/health/report/compare 端点:"
+                        + "报告档案对比(SC-P-24 / TC-P-24,§4.59.10 未实现端点)无接口载体。实现未落地。");
+    }
+
+    // ==================== D. 权限流(SC-P-24-P 归属校验) ====================
+
+    @Test
+    @DisplayName("权限流:删除报告应校验归属,非归属数据访问统一 403/401")
+    void 删除报告_应校验归属_非归属越权被拒() {
+        Class<?> controller = loadClass("com.etotem.cfc.controller.HealthReportController");
+        assertNotNull(controller, "[report.archive.manage] HealthReportController 类不存在。");
+
+        Method del = null;
+        for (Method m : controller.getDeclaredMethods()) {
+            if (m.getName().equals("deleteReport")) {
+                del = m;
+                break;
+            }
+        }
+        assertNotNull(del, "[report.archive.manage] HealthReportController.deleteReport 方法不存在。");
+
+        boolean hasOwnerArg = false;
+        for (java.lang.reflect.Parameter p : del.getParameters()) {
+            for (java.lang.annotation.Annotation a : p.getAnnotations()) {
+                String at = a.annotationType().getName();
+                // 归属校验载体:@RequestAttribute("userId"/"memberId") 或 @RequestAttribute("familyId")
+                if (at.endsWith("RequestAttribute")) {
+                    hasOwnerArg = true;
+                }
+            }
+        }
+        assertTrue(hasOwnerArg,
+                "[report.archive.manage] HealthReportController.deleteReport 缺少归属校验参数"
+                        + "(@RequestAttribute userId/memberId/familyId):当前仅收 @RequestBody Map,"
+                        + "无法拦截横向越权删除他人报告(SC-P-24-P / TC-P-24-P,非归属统一 403/401)。实现未落地。");
+    }
+
+    // ==================== 反射 / 测试辅助 ====================
+
+    private HealthReport report(String reportType, String reportDate, int overallScore) {
+        HealthReport r = new HealthReport();
+        r.setId(9001L);
+        r.setReportType(reportType);
+        try {
+            Date d = new SimpleDateFormat("yyyy-MM-dd").parse(reportDate);
+            r.setReportDate(d);
+        } catch (Exception ignored) {
+            // 契约探针不依赖真实日期解析
+        }
+        r.setOverallScore(overallScore);
+        return r;
+    }
+
+    private Class<?> loadClass(String name) {
+        try {
+            return Class.forName(name, false, Thread.currentThread().getContextClassLoader());
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+}