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

docs(tdd): S-cfc-270 diet.mealPlan.generate 重派发复核——契约测试已合入 origin/cfclub(0f99c53cc),实测13/13红、实现未落地,GREEN阶段开放;环境绕行JDK21记录

Sisyphus 2 дней назад
Родитель
Сommit
bd4d0fdbab
1 измененных файлов с 64 добавлено и 0 удалено
  1. 64 0
      docs/tdd/orchestration/S-cfc-270-recheck-report.md

+ 64 - 0
docs/tdd/orchestration/S-cfc-270-recheck-report.md

@@ -0,0 +1,64 @@
+# S-cfc-270 diet.mealPlan.generate 重派发复核报告
+
+> 复核时间:2026-11-15
+> 结论:**本任务交付物已存在于 origin/cfclub,RED 契约测试实测为红(13 例 13 失败,预期红),实现未落地,GREEN 阶段开放。**
+> 本次重派发为编排侧 `.tdd/state.json` 未登记导致(`RED-pending-dispatch-2026-11-14.md` 仍列为待派发)。
+
+## 一、能力键与溯源
+
+- 能力键:`diet.mealPlan.generate`(业务域 C,饮食推荐系统 / 家庭食谱)
+- 需求:`tests/user-scenarios/应用场景总览.md`
+  - SC-P-27 家庭食谱生成(一日三餐):基于菌群报告+营养目标 → 生成早/午/晚食谱;边界:**无报告降级通用食谱**;**忌口/过敏自动排除**
+  - SC-P-28 食谱按食材筛选/忌口:设忌口/过敏 → **食谱重算排除项**;边界:**忌口冲突时提示**
+- 设计:`docs/superpowers/api/API_REFERENCE.md` §4.11 饮食推荐
+  - `POST /api/diet/meals/config`(餐食配置 `participantMemberIds` 共餐人)
+  - `POST /api/diet/meals/config/save`(批量格式 `configs:{breakfast,lunch,dinner}`)
+  - `POST /api/diet/recommendation/generate`(单餐次生成)
+
+## 二、交付物现状(核心结论)
+
+| 项 | 状态 |
+|---|---|
+| RED 契约测试文件 | ✅ **已存在于 origin/cfclub**:`cfc-backend/src/test/java/com/etotem/cfc/unit/DietMealPlanGenerateContractTest.java`(commit `0f99c53cc`,2026-11-14 03:17 合入,307 commits 前为祖先) |
+| 测试实测结果 | ✅ **RED 预期红**:`Tests run: 13, Failures: 13, Errors: 0, Skipped: 0`(见下方验证) |
+| src/main 实现 | ⏳ **未落地**:`DietRecommendationService` 仅 `generateRecommendation`(单餐次)/`getTodayRecommendation`;无 `generateDailyMealPlan` / `resolveParticipantExclusions` / `excludeRestrictedFromMenu`;源码无 `degraded` / `excludedItems` / `conflictPrompt` 契约标记 |
+| GREEN 阶段 | 开放:实现方按测试类 javadoc 三契约签名落地即转绿 |
+
+## 三、RED 验证
+
+- 分支:`task/S-cfc-270`(基于 `origin/cfclub` HEAD `cbfeb6031`,工作区干净,未改 src/main)
+- 命令(见「五、环境说明」,本机默认 Maven JVM 为 Java 8 需绕行):
+  ```
+  MAVEN_SKIP_RC=1 JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 \
+    /usr/share/maven/bin/mvn clean test -Dtest=DietMealPlanGenerateContractTest
+  ```
+- 结果:
+  ```
+  Tests run: 13, Failures: 13, Errors: 0, Skipped: 0
+  ```
+- 失败原因复核(符合预期):A/B/C 结构用例在反射探测 `getDeclaredMethod` 处断言失败(方法缺失);D 源码锚点断言失败(无契约标记);E/F/G 行为用例在 `invokeContract` 方法解析处 `fail("RED[...] 契约方法未实现")`。全部为「实现未落地」型红,无实现已存在误绿问题。
+
+## 四、契约方法签名(GREEN 落地指引)
+
+见测试类 javadoc,摘要如下:
+
+1. `Map<String,Object> generateDailyMealPlan(Long familyId, Map<String,Object> request)` — 一日三餐聚合生成(SC-P-27)
+   - request:`date / participant_member_ids / nutrition_goals / view_key`
+   - 返回含:`meals`(键 `breakfast/lunch/dinner`)、`nutritionSummary`、`degraded`(Boolean,无报告降级通用食谱标志)、`excludedItems`(List&lt;String&gt; 忌口/过敏自动排除清单)
+2. `List<String> resolveParticipantExclusions(List<Long> participantMemberIds)` — 参与者忌口/过敏关键词并集(SC-P-27/28),来源 `diet_preferences.allergies / absoluteAvoid`
+3. `Map<String,Object> excludeRestrictedFromMenu(Object menuJson, List<String> exclusions)` — 按忌口重算排除项(SC-P-28),返回 `menu`(过滤后)/ `excludedItems`(剔除清单)/ `conflictPrompt`(忌口冲突提示,全部命中时非空)
+
+## 五、环境说明(后续同批任务可复用)
+
+- 仓库测试编译需要 JDK ≥ 9(多个已合入测试用 `List.of()`,如 `ProductRecommendationFilterTest` 等商品可见性链路测试),但本机默认 Maven 被钉在 Java 8:
+  - `/usr/bin/mvn` 为 Ubuntu wrapper,**硬编码** `export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64`
+  - `~/.mavenrc` 内容为 `export JAVA_HOME=`(会把命令行设置的 JAVA_HOME 置空)
+- 绕行方式(已验证):
+  ```
+  MAVEN_SKIP_RC=1 JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 /usr/share/maven/bin/mvn ...
+  ```
+
+## 六、交编排侧
+
+- 请更新 `.tdd/state.json` 将 S-cfc-270 登记为「RED 契约测试已合入主链(0f99c53cc),实测 13/13 红」;能力键在 `docs/tdd/orchestration/sc-key-map.md` 中 SC-P-27/SC-P-28 状态保持 RED/未跑通(实现未落地)。
+- 无需重复派发本任务。