Prechádzať zdrojové kódy

test(S-cfc-270): RED 契约测试 diet.mealPlan.generate 一日三餐生成/忌口排除

- 能力键 diet.mealPlan.generate(SC-P-27/SC-P-28,业务域 C,饮食推荐系统/家庭食谱)
- 纯 JUnit5 + Mockito + 反射结构探测,无 Spring/DB/外部服务(同批 RED 契约测试风格)
- 契约锚点 DietRecommendationService:generateDailyMealPlan(Long,Map) /
  resolveParticipantExclusions(List) / excludeRestrictedFromMenu(Object,List) 均未实现
- 覆盖:早/午/晚三餐返回形态(meals/degraded/excludedItems)、无报告降级通用食谱、
  忌口/过敏自动排除并集、按忌口重算排除项 + 冲突提示(conflictPrompt)
- 预期红:13 用例 13 失败,GREEN 阶段按契约签名落地即转绿
zxyj-langgraph 2 dní pred
rodič
commit
0f99c53cc

+ 374 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/DietMealPlanGenerateContractTest.java

@@ -0,0 +1,374 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.entity.DietPreferences;
+import com.etotem.cfc.mapper.DietPreferencesMapper;
+import com.etotem.cfc.mapper.DietRecommendationMapper;
+import com.etotem.cfc.mapper.FamilyMemberMapper;
+import com.etotem.cfc.mapper.MealConfigMapper;
+import com.etotem.cfc.service.AiGateway;
+import com.etotem.cfc.service.BeijingNutritionService;
+import com.etotem.cfc.service.DietRecommendationService;
+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.File;
+import java.io.IOException;
+import java.lang.reflect.Method;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.util.HashMap;
+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.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+
+/**
+ * 契约级单测:能力键 {@code diet.mealPlan.generate}(家庭食谱·一日三餐生成),R 系列场景 + 需求 SC-P-27 / SC-P-28。
+ *
+ * <p><b>需求 / 设计溯源</b></p>
+ * <ul>
+ *   <li>需求:{@code tests/user-scenarios/应用场景总览.md} SC-P-27(家庭食谱生成:基于菌群报告 + 营养目标 →
+ *       生成早/午/晚食谱(食材/用量/禁忌标注);边界:<b>无报告降级通用食谱</b>;<b>忌口/过敏自动排除</b>)
+ *       与 SC-P-28(食谱按食材筛选/忌口:设忌口过敏 → <b>食谱重算排除项</b>;边界:<b>忌口冲突时提示</b>);业务域 C;模块:饮食推荐系统 / 家庭食谱</li>
+ *   <li>设计:{@code docs/superpowers/api/API_REFERENCE.md} §4.11 饮食推荐 ——
+ *       {@code /api/diet/meals/config}(餐食配置 {@code participantMemberIds} 共餐人)、
+ *       {@code /api/diet/meals/config/save}(批量格式 {@code configs:{breakfast,lunch,dinner}})、
+ *       {@code /api/diet/recommendation/generate}(单餐次生成 {@code date / meal_type / participant_member_ids})</li>
+ * </ul>
+ *
+ * <p><b>实现现状(src/main 核实)</b>:本分支 src/main 中 {@link DietRecommendationService} 仅提供
+ * {@code generateRecommendation}(单餐次生成)与 {@code getTodayRecommendation};<b>「一日三餐 MealPlan
+ * 聚合生成」能力未落地</b>:无 {@code generateDailyMealPlan}、无参与者忌口/过敏并集解析、
+ * 无「按忌口重算排除项 + 冲突提示」方法,返回层也无 {@code degraded / excludedItems} 契约字段。</p>
+ *
+ * <p><b>契约方法签名(实现方按此落地)</b></p>
+ * <ul>
+ *   <li>{@code Map<String,Object> generateDailyMealPlan(Long familyId, Map<String,Object> request)}
+ *       —— 一日三餐聚合生成(SC-P-27)。request 同 §4.11 {@code /generate} 载荷:{@code date / participant_member_ids /
+ *       nutrition_goals / view_key}。返回 Map 必须含:{@code meals}(键 {@code breakfast/lunch/dinner} 三顿)、
+ *       {@code nutritionSummary}、{@code degraded}(Boolean:无报告降级通用食谱的标志)、{@code excludedItems}
+ *       (List&lt;String&gt;:忌口/过敏自动排除项清单)。</li>
+ *   <li>{@code List<String> resolveParticipantExclusions(List<Long> participantMemberIds)}
+ *       —— 参与者忌口/过敏关键词并集(SC-P-27「忌口/过敏自动排除」+ SC-P-28),来源
+ *       {@code diet_preferences.allergies / absoluteAvoid}(实体 {@link DietPreferences})。</li>
+ *   <li>{@code Map<String,Object> excludeRestrictedFromMenu(Object menuJson, List<String> exclusions)}
+ *       —— 按忌口重算排除项(SC-P-28 主流程)。返回 Map 必须含:{@code menu}(过滤后菜单)、
+ *       {@code excludedItems}(剔除清单)、{@code conflictPrompt}(忌口冲突时提示,无冲突可为空串/**null**)。</li>
+ * </ul>
+ *
+ * <p><b>测试范围</b>:纯契约级单测 —— JUnit5 + Mockito + 反射结构探测,无 Spring / 无 DB / 无真实外部服务
+ * (与同批 RED 契约测试 TeamProfitHookContractTest / TeamStarMultiplierContractTest 同风格)。</p>
+ *
+ * <p><b>RED 预期</b>:三个契约方法在 {@link DietRecommendationService} 中均缺失(实现未落地),
+ * 结构用例在反射探测处断言失败(红);行为用例在方法解析处断言失败(红)。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:实现者按上述签名落地后本测试自动转绿:结构用例直接通过;
+ * 行为用例在方法存在后转为校验真实返回形态(meals 三键 / degraded / excludedItems / conflictPrompt)。</p>
+ */
+class DietMealPlanGenerateContractTest {
+
+    private static final Long FAMILY_ID = 100L;
+    private static final Long MEMBER_A = 11L; // 有忌口/过敏
+    private static final Long MEMBER_B = 12L; // 无忌口/过敏
+
+    @Mock
+    private DietRecommendationMapper dietRecommendationMapper;
+
+    @Mock
+    private BeijingNutritionService beijingNutritionService;
+
+    @Mock
+    private AiGateway aiGateway;
+
+    @Mock
+    private MealConfigMapper mealConfigMapper;
+
+    @Mock
+    private FamilyMemberMapper familyMemberMapper;
+
+    @Mock
+    private DietPreferencesMapper dietPreferencesMapper;
+
+    @InjectMocks
+    private DietRecommendationService service;
+
+    @BeforeEach
+    void setUp() {
+        MockitoAnnotations.openMocks(this);
+    }
+
+    // ==================================================================
+    // 结构契约 A:一日三餐聚合生成 generateDailyMealPlan(SC-P-27)
+    // ==================================================================
+
+    @Test
+    @DisplayName("A1:generateDailyMealPlan(Long, Map) 方法应存在(SC-P-27 一日三餐聚合生成)")
+    void generateDailyMealPlan_methodExists() {
+        Method m = findMethod("generateDailyMealPlan", Long.class, Map.class);
+        assertNotNull(m,
+                "[diet.mealPlan.generate] DietRecommendationService 缺少 generateDailyMealPlan(Long, Map)(SC-P-27):"
+                        + "契约要求基于 participant_member_ids 共餐人 + nutrition_goals 一次生成早/午/晚三餐,"
+                        + "返回 meals(breakfast/lunch/dinner) + degraded + excludedItems。现状仅单餐次 generateRecommendation。");
+    }
+
+    @Test
+    @DisplayName("A2:generateDailyMealPlan 返回类型应为 Map(契约返回形态容器)")
+    void generateDailyMealPlan_returnTypeIsMap() {
+        Method m = findMethod("generateDailyMealPlan", Long.class, Map.class);
+        if (m == null) {
+            fail("[diet.mealPlan.generate] generateDailyMealPlan 未实现,无法校验返回类型(SC-P-27)。");
+        }
+        assertTrue(Map.class.isAssignableFrom(m.getReturnType()),
+                "[diet.mealPlan.generate] generateDailyMealPlan 应返回 Map<String,Object>(含 meals/degraded/excludedItems)。");
+    }
+
+    // ==================================================================
+    // 结构契约 B:忌口/过敏并集解析 resolveParticipantExclusions(SC-P-28)
+    // ==================================================================
+
+    @Test
+    @DisplayName("B1:resolveParticipantExclusions(List) 方法应存在(参与者忌口/过敏并集)")
+    void resolveParticipantExclusions_methodExists() {
+        Method m = findMethod("resolveParticipantExclusions", List.class);
+        assertNotNull(m,
+                "[diet.mealPlan.generate] DietRecommendationService 缺少 resolveParticipantExclusions(List)(SC-P-28):"
+                        + "契约要求聚合各参与者 diet_preferences.allergies/absoluteAvoid 关键词并集,"
+                        + "供生成与重算时自动排除。");
+    }
+
+    @Test
+    @DisplayName("B2:resolveParticipantExclusions 返回类型应为 List(关键词并集)")
+    void resolveParticipantExclusions_returnTypeIsList() {
+        Method m = findMethod("resolveParticipantExclusions", List.class);
+        if (m == null) {
+            fail("[diet.mealPlan.generate] resolveParticipantExclusions 未实现,无法校验返回类型(SC-P-28)。");
+        }
+        assertTrue(List.class.isAssignableFrom(m.getReturnType()),
+                "[diet.mealPlan.generate] resolveParticipantExclusions 应返回 List<String> 关键词并集。");
+    }
+
+    // ==================================================================
+    // 结构契约 C:按忌口重算排除项 excludeRestrictedFromMenu(SC-P-28)
+    // ==================================================================
+
+    @Test
+    @DisplayName("C1:excludeRestrictedFromMenu(Object, List) 方法应存在(按忌口重算排除项)")
+    void excludeRestrictedFromMenu_methodExists() {
+        Method m = findMethod("excludeRestrictedFromMenu", Object.class, List.class);
+        assertNotNull(m,
+                "[diet.mealPlan.generate] DietRecommendationService 缺少 excludeRestrictedFromMenu(Object, List)(SC-P-28):"
+                        + "契约要求设忌口/过敏后对现有菜单重算排除项,返回 menu + excludedItems + conflictPrompt。");
+    }
+
+    @Test
+    @DisplayName("C2:excludeRestrictedFromMenu 返回类型应为 Map(menu/excludedItems/conflictPrompt)")
+    void excludeRestrictedFromMenu_returnTypeIsMap() {
+        Method m = findMethod("excludeRestrictedFromMenu", Object.class, List.class);
+        if (m == null) {
+            fail("[diet.mealPlan.generate] excludeRestrictedFromMenu 未实现,无法校验返回类型(SC-P-28)。");
+        }
+        assertTrue(Map.class.isAssignableFrom(m.getReturnType()),
+                "[diet.mealPlan.generate] excludeRestrictedFromMenu 应返回 Map(menu/excludedItems/conflictPrompt)。");
+    }
+
+    // ==================================================================
+    // 源码锚点:缺失契约字段标记(辅助定位实现未落地)
+    // ==================================================================
+
+    @Test
+    @DisplayName("D1:DietRecommendationService 源码应含 MealPlan 契约标记(degraded/excludedItems)")
+    void source_containsMealPlanContractMarkers() {
+        String src = readMainSource("service/DietRecommendationService.java");
+        assertTrue(src.contains("excludedItems") && src.contains("degraded"),
+                "[diet.mealPlan.generate] DietRecommendationService 源码缺少契约标记 excludedItems / degraded(SC-P-27):"
+                        + "无报告降级通用食谱须以 degraded 标志透出、忌口/过敏自动排除须以 excludedItems 清单透出,"
+                        + "现状源码均未出现。");
+    }
+
+    // ==================================================================
+    // 行为契约 E:一日三餐聚合生成的返回形态(SC-P-27,RED 在方法解析处失败)
+    // ==================================================================
+
+    @Test
+    @DisplayName("E1:generateDailyMealPlan 应返回 meals 三键(breakfast/lunch/dinner)")
+    void generateDailyMealPlan_returnsThreeMeals() {
+        Map<String, Object> request = new HashMap<>();
+        request.put("date", "2026-11-14");
+        request.put("participant_member_ids", "[11,12]");
+
+        Object result = invokeContract("generateDailyMealPlan", FAMILY_ID, request);
+
+        assertNotNull(result, "[diet.mealPlan.generate] generateDailyMealPlan 不应返回 null(SC-P-27)。");
+        Map<?, ?> resultMap = (Map<?, ?>) result;
+        Object meals = resultMap.get("meals");
+        assertNotNull(meals,
+                "[diet.mealPlan.generate] 返回 Map 应含 meals 键(SC-P-27 早/午/晚三餐容器)。");
+        Map<?, ?> mealsMap = (Map<?, ?>) meals;
+        assertTrue(mealsMap.containsKey("breakfast") && mealsMap.containsKey("lunch") && mealsMap.containsKey("dinner"),
+                "[diet.mealPlan.generate] meals 应含 breakfast/lunch/dinner 三键(早/午/晚三餐,SC-P-27)。");
+    }
+
+    @Test
+    @DisplayName("E2:generateDailyMealPlan 应返回 degraded 布尔键(无报告降级通用食谱标志)")
+    void generateDailyMealPlan_returnsDegradedFlag() {
+        Map<String, Object> request = new HashMap<>();
+        request.put("date", "2026-11-14");
+        request.put("participant_member_ids", "[11,12]");
+
+        Object result = invokeContract("generateDailyMealPlan", FAMILY_ID, request);
+
+        Map<?, ?> resultMap = (Map<?, ?>) result;
+        assertTrue(resultMap.containsKey("degraded"),
+                "[diet.mealPlan.generate] 返回 Map 应含 degraded 键(Boolean):无菌群报告时降级通用食谱须置 true(SC-P-27 边界)。");
+    }
+
+    @Test
+    @DisplayName("E3:generateDailyMealPlan 应返回 excludedItems 键(忌口/过敏自动排除清单)")
+    void generateDailyMealPlan_returnsExcludedItems() {
+        Map<String, Object> request = new HashMap<>();
+        request.put("date", "2026-11-14");
+        request.put("participant_member_ids", "[11,12]");
+
+        Object result = invokeContract("generateDailyMealPlan", FAMILY_ID, request);
+
+        Map<?, ?> resultMap = (Map<?, ?>) result;
+        assertTrue(resultMap.containsKey("excludedItems"),
+                "[diet.mealPlan.generate] 返回 Map 应含 excludedItems 键(List<String>):"
+                        + "参与者忌口/过敏须自动排除并透出清单(SC-P-27「忌口/过敏自动排除」)。");
+    }
+
+    // ==================================================================
+    // 行为契约 F:忌口/过敏并集解析(SC-P-28)
+    // ==================================================================
+
+    @Test
+    @DisplayName("F1:resolveParticipantExclusions 应返回非空并集(成员有忌口时)")
+    void resolveParticipantExclusions_unionNonEmpty() {
+        DietPreferences pA = preferences(MEMBER_A, "花生,海鲜", "辣");
+        DietPreferences pB = preferences(MEMBER_B, null, null);
+        when(dietPreferencesMapper.selectList(any())).thenReturn(java.util.Arrays.asList(pA, pB));
+
+        Object result = invokeContract("resolveParticipantExclusions",
+                java.util.Arrays.asList(MEMBER_A, MEMBER_B));
+
+        assertNotNull(result, "[diet.mealPlan.generate] resolveParticipantExclusions 不应返回 null(SC-P-28)。");
+        List<?> exclusions = (List<?>) result;
+        assertTrue(exclusions.contains("花生") && exclusions.contains("海鲜"),
+                "[diet.mealPlan.generate] 成员过敏关键词应并入结果集(allergies:花生、海鲜),实际=" + exclusions);
+    }
+
+    // ==================================================================
+    // 行为契约 G:按忌口重算排除项 + 冲突提示(SC-P-28)
+    // ==================================================================
+
+    @Test
+    @DisplayName("G1:excludeRestrictedFromMenu 应剔除命中忌口的菜品并透出排除清单")
+    void excludeRestrictedFromMenu_filtersHitDishes() {
+        // 菜单含「清蒸鲈鱼」与「葱爆羊肉」,忌口「羊肉」→ 应剔除羊肉菜、保留鲈鱼
+        String menuJson = "{\"meals\":["
+                + "{\"name\":\"清蒸鲈鱼\",\"ingredients\":[\"鲈鱼\",\"姜\"]},"
+                + "{\"name\":\"葱爆羊肉\",\"ingredients\":[\"羊肉\",\"大葱\"]}]}";
+
+        Object result = invokeContract("excludeRestrictedFromMenu", menuJson,
+                java.util.Collections.singletonList("羊肉"));
+
+        assertNotNull(result, "[diet.mealPlan.generate] excludeRestrictedFromMenu 不应返回 null(SC-P-28)。");
+        Map<?, ?> resultMap = (Map<?, ?>) result;
+        assertTrue(resultMap.containsKey("excludedItems"),
+                "[diet.mealPlan.generate] 返回 Map 应含 excludedItems(剔除清单,SC-P-28)。");
+        List<?> excluded = (List<?>) resultMap.get("excludedItems");
+        assertTrue(excluded != null && excluded.contains("羊肉"),
+                "[diet.mealPlan.generate] excludedItems 应含命中忌口「羊肉」,实际=" + excluded);
+        String filtered = String.valueOf(resultMap.get("menu"));
+        assertFalse(filtered.contains("羊肉"),
+                "[diet.mealPlan.generate] 过滤后菜单不应再含「羊肉」菜(设忌口→食谱重算排除项,SC-P-28)。");
+        assertTrue(filtered.contains("鲈鱼"),
+                "[diet.mealPlan.generate] 过滤后菜单应保留未命中忌口的菜(清蒸鲈鱼)。");
+    }
+
+    @Test
+    @DisplayName("G2:excludeRestrictedFromMenu 忌口冲突时应透出 conflictPrompt 提示")
+    void excludeRestrictedFromMenu_conflictPrompts() {
+        // 边界 SC-P-28:全部菜品均命中忌口(全被剔除)→ 忌口冲突提示
+        String menuJson = "{\"meals\":["
+                + "{\"name\":\"羊肉串\",\"ingredients\":[\"羊肉\"]},"
+                + "{\"name\":\"羊排\",\"ingredients\":[\"羊排\"]}]}";
+
+        Object result = invokeContract("excludeRestrictedFromMenu", menuJson,
+                java.util.Collections.singletonList("羊肉"));
+
+        assertNotNull(result, "[diet.mealPlan.generate] excludeRestrictedFromMenu 不应返回 null(SC-P-28 边界)。");
+        Map<?, ?> resultMap = (Map<?, ?>) result;
+        assertTrue(resultMap.containsKey("conflictPrompt"),
+                "[diet.mealPlan.generate] 返回 Map 应含 conflictPrompt 键(忌口冲突时提示,SC-P-28 边界)。");
+        String prompt = resultMap.get("conflictPrompt") == null ? "" : String.valueOf(resultMap.get("conflictPrompt"));
+        assertFalse(prompt.trim().isEmpty(),
+                "[diet.mealPlan.generate] 全部菜品命中忌口时应返回非空 conflictPrompt(忌口冲突提示),实际为空。");
+    }
+
+    // ==================================================================
+    // 反射辅助(锚定宿主契约,避免编译期依赖不存在方法)
+    // ==================================================================
+
+    private Method findMethod(String name, Class<?>... paramTypes) {
+        try {
+            return DietRecommendationService.class.getDeclaredMethod(name, paramTypes);
+        } catch (NoSuchMethodException e) {
+            return null;
+        }
+    }
+
+    /** 按方法名 + 参数个数匹配并调用(宽松适配基本/包装类型),契约方法缺失即断言失败(红)。 */
+    private Object invokeContract(String method, Object... args) {
+        for (Method m : DietRecommendationService.class.getDeclaredMethods()) {
+            if (m.getName().equals(method) && m.getParameterCount() == args.length) {
+                try {
+                    m.setAccessible(true);
+                    return m.invoke(service, args);
+                } catch (Exception e) {
+                    fail("[diet.mealPlan.generate] 契约方法 " + method + " 调用失败:" + e.getMessage());
+                    throw new IllegalStateException("unreachable");
+                }
+            }
+        }
+        fail("RED[diet.mealPlan.generate] 契约方法 DietRecommendationService#" + method + " 未实现(实现未落地)");
+        throw new IllegalStateException("unreachable");
+    }
+
+    private DietPreferences preferences(Long memberId, String allergies, String absoluteAvoid) {
+        DietPreferences p = new DietPreferences();
+        p.setFamilyMemberId(memberId);
+        p.setAllergies(allergies);
+        p.setAbsoluteAvoid(absoluteAvoid);
+        return p;
+    }
+
+    /** 读取 src/main 源码文件(surefire 工作目录 = cfc-backend 模块目录),找不到返回空串 */
+    private String readMainSource(String relative) {
+        String[] candidates = {
+                "src/main/java/com/etotem/cfc/" + relative,
+                "cfc-backend/src/main/java/com/etotem/cfc/" + relative,
+                "../cfc-backend/src/main/java/com/etotem/cfc/" + relative
+        };
+        for (String candidate : candidates) {
+            File file = new File(candidate);
+            if (file.isFile()) {
+                try {
+                    return new String(Files.readAllBytes(file.toPath()), StandardCharsets.UTF_8);
+                } catch (IOException e) {
+                    return "";
+                }
+            }
+        }
+        return "";
+    }
+}