Ver código fonte

test(S-cfc-419): health.plan.medicalRedline 医疗红线契约测试(TDD-RED,预期红 6/7)

E2E Test Bot 2 dias atrás
pai
commit
85e2b56d86

+ 281 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/HealthPlanMedicalRedlineContractTest.java

@@ -0,0 +1,281 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.entity.FiveDimensionSelfCheck;
+import com.etotem.cfc.entity.HealthPlan;
+import com.etotem.cfc.entity.User;
+import com.etotem.cfc.mapper.FiveDimensionSelfCheckMapper;
+import com.etotem.cfc.mapper.HealthPlanMapper;
+import com.etotem.cfc.mapper.UserMapper;
+import com.etotem.cfc.service.AiGateway;
+import com.etotem.cfc.service.impl.HealthPlanServiceImpl;
+import com.sun.net.httpserver.HttpServer;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.MockitoAnnotations;
+
+import java.io.ByteArrayOutputStream;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.net.InetSocketAddress;
+import java.nio.charset.StandardCharsets;
+import java.util.Map;
+import java.util.concurrent.atomic.AtomicReference;
+
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * 契约级单测:健康计划医疗红线(能力键 {@code health.plan.medicalRedline},§8.1 归因禁区)。
+ *
+ * <p><b>契约溯源</b></p>
+ * <ul>
+ *   <li>需求:{@code tests/user-scenarios/应用场景总览.md} <b>SC-B-05 敏感问题拦截与隐私保护</b>(命中→拒答+合规提示)
+ *       、{@code tests/user-scenarios/08-butler.md} B-05(敏感词拦截;越权拒)。</li>
+ *   <li>设计:{@code docs/浠艾福程序-谷禾新版解析与五维归因升级方案-v1.0.md} <b>§三 P1-1 健康计划生成红线</b>
+ *       + <b>§八 8.1 归因禁区</b>(ef8eb62be 已合入 origin/cfclub 设计契约 v1.0)。</li>
+ * </ul>
+ *
+ * <p><b>§8.1 归因禁区(破一条即失格)</b></p>
+ * <ul>
+ *   <li><b>R1</b> 器质性诊断只作<b>前提约束</b>,不作<b>改善目标</b>(例:不出现「心脏问题会随方案改善」);</li>
+ *   <li><b>R2</b> 处方药不得建议<b>增减或停用</b>;涉及用药只做「请与开方医生确认」(例:不出现「可以停用美托洛尔」);</li>
+ *   <li><b>R3</b> 12 周内<b>不设不可测目标</b>(骨密度、骨代谢标志物、器质性病变);</li>
+ *   <li><b>R4</b> 急症信号(晕厥/黑便/胸痛/静息心悸/进行性消瘦)只做<b>转介</b>,禁写「方案见效后不再发作」;</li>
+ *   <li><b>R5</b> 行为判读先排除医学约束(「她不能」≠「她不肯」)——属 Python prompt 约束侧,Java 输出审计不直接覆盖。</li>
+ * </ul>
+ *
+ * <p><b>§8.1 落地三件套(Java 侧契约锚点)</b></p>
+ * <ol>
+ *   <li>Java 输入字段 {@code medical_constraints}(用户已有诊断、在服药物)在调用侧注入
+ *       {@code health_plan_graph} 请求体(report→plan 主链 {@code callLangGraphPlanData}
+ *       与 AiGateway 自检→plan 路径均属 Java 调用侧);</li>
+ *   <li>输出正则审计:命中 §8.1 红线措辞 → 拦截/重写/标记人工复核,
+ *       Java 侧发布门禁 {@code HealthPlanServiceImpl.approveAndPublish}(现有 SC-T-28 复核挂钩点)须拒绝。</li>
+ * </ol>
+ *
+ * <p><b>RED 现状核实(本分支 src/main,24a02941b 基线)</b>:
+ * 输入侧 {@code callLangGraphPlanData}/{@code generateFromSelfCheck} 构造的请求体/inputs 均无
+ * {@code medical_constraints} 键;发布门禁 {@code approveAndPublish → detectUnsafePlanContent} 仅做
+ * SC-T-28 通用敏感词复核({@code PlanContentSafetyUtil.matchUnsafeTerm}),未含 §8.1 医疗红线审计。
+ * 因此本类用例当前应全部失败(红):断言请求契约缺失字段 / 红线文本未被拦截。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:实现者在 Java 调用侧注入 {@code medical_constraints}(用户诊断/在服药物),
+ * 并把 §8.1 四类红线正则审计接入方案内容复核(发布门禁)后,本类自动转绿;无需改动本类。</p>
+ *
+ * <p><b>测试风格</b>:纯 JUnit5 + Mockito/反射/回环 HTTP 夹具({@link HttpServer} 仅监听 127.0.0.1 随机端口,
+ * 用于捕获调用侧真实请求体,非外部服务),无 Spring 上下文、无 DB、无外网。</p>
+ */
+class HealthPlanMedicalRedlineContractTest {
+
+    /** §三 P1-1 / §八 8.1:Java 调用侧输入字段(用户已有诊断、在服药物) */
+    private static final String KEY_MEDICAL_CONSTRAINTS = "medical_constraints";
+
+    private static final Long FAMILY_ID = 100L;
+    private static final Long USER_ID = 200L;
+    private static final Long CHECK_ID = 9L;
+    private static final Long PLAN_ID = 1L;
+    private static final Long REVIEWER_ID = 300L;
+
+    @Mock
+    private FiveDimensionSelfCheckMapper selfCheckMapper;
+
+    @Mock
+    private UserMapper userMapper;
+
+    @Mock
+    private HealthPlanMapper healthPlanMapper;
+
+    @Mock
+    private AiGateway aiGateway;
+
+    @InjectMocks
+    private HealthPlanServiceImpl service;
+
+    @BeforeEach
+    void setUp() {
+        MockitoAnnotations.openMocks(this);
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流·输入侧:Java 输入字段 medical_constraints(§8.1 落地三件套之 2)
+    // ------------------------------------------------------------------
+
+    /**
+     * 报告→健康计划生成主链(health_plan_graph 调用方 {@code callLangGraphPlanData}):
+     * 请求体必须携带 {@code medical_constraints},供 Python 侧注入 prompt 约束(§三 P1-1)。
+     * 通过回环 HttpServer 捕获真实 POST 请求体断言(纯 JDK HttpServer,仅监听 127.0.0.1 随机端口)。
+     */
+    @Test
+    @DisplayName("正常流-1:报告→健康计划生成请求体应携带 medical_constraints 输入字段")
+    void inputContract_planGenerateRequestBody_carriesMedicalConstraints() throws Exception {
+        AtomicReference<String> captured = new AtomicReference<>();
+        HttpServer server = HttpServer.create(new InetSocketAddress("127.0.0.1", 0), 0);
+        server.createContext("/", exchange -> {
+            try {
+                captured.set(new String(readAll(exchange.getRequestBody()), StandardCharsets.UTF_8));
+                byte[] resp = "{\"success\":true,\"data\":{\"overview\":\"概述\",\"sections\":[]}}"
+                        .getBytes(StandardCharsets.UTF_8);
+                exchange.sendResponseHeaders(200, resp.length);
+                try (OutputStream os = exchange.getResponseBody()) {
+                    os.write(resp);
+                }
+            } finally {
+                exchange.close();
+            }
+        });
+        server.start();
+        try {
+            HealthPlanServiceImpl svc = new HealthPlanServiceImpl();
+            Field urlField = HealthPlanServiceImpl.class.getDeclaredField("langgraphBaseUrl");
+            urlField.setAccessible(true);
+            urlField.set(svc, "http://127.0.0.1:" + server.getAddress().getPort());
+
+            Method generate = HealthPlanServiceImpl.class.getDeclaredMethod(
+                    "callLangGraphPlanData", Long.class, String.class, String.class, String.class);
+            generate.setAccessible(true);
+            generate.invoke(svc, FAMILY_ID, "7", "body", "基于菌群检测报告的个性化健康管理方案");
+
+            String body = captured.get();
+            assertNotNull(body,
+                    "[health.plan.medicalRedline] 未捕获到调用侧生成健康计划的请求体"
+                            + "(health_plan_graph /api/v1/health/plan/generate)。");
+            @SuppressWarnings("unchecked")
+            Map<String, Object> payload = new com.fasterxml.jackson.databind.ObjectMapper()
+                    .readValue(body, Map.class);
+            assertTrue(payload.containsKey(KEY_MEDICAL_CONSTRAINTS),
+                    "[health.plan.medicalRedline] 报告→健康计划生成请求体(callLangGraphPlanData)缺少 medical_constraints"
+                            + " 输入字段:§三 P1-1 要求 Java 调用侧注入用户已有诊断、在服药物,供 health_plan_graph 作"
+                            + " prompt 约束(§8.1 落地三件套·Java 输入字段)。实现未落地。");
+        } finally {
+            server.stop(0);
+        }
+    }
+
+    /**
+     * 自检→健康计划生成路径({@code generateFromSelfCheck → AiGateway.generateHealthPlan}):
+     * inputs 同样属于 P1-1 所指「Java 调用侧」,须携带 {@code medical_constraints}。
+     */
+    @Test
+    @DisplayName("正常流-2:自检生成健康计划路径(AiGateway)应携带 medical_constraints")
+    void inputContract_selfCheckPlanPath_passesMedicalConstraintsToGateway() throws Exception {
+        FiveDimensionSelfCheck check = new FiveDimensionSelfCheck();
+        check.setId(CHECK_ID);
+        check.setScoresJson("{\"body\":4,\"mind\":7,\"wisdom\":8}");
+        when(selfCheckMapper.selectById(CHECK_ID)).thenReturn(check);
+
+        User user = new User();
+        user.setId(USER_ID);
+        user.setFamilyId(FAMILY_ID);
+        when(userMapper.selectById(USER_ID)).thenReturn(user);
+
+        when(aiGateway.generateHealthPlan(any())).thenReturn("计划内容");
+        when(healthPlanMapper.insert(any(HealthPlan.class))).thenReturn(1);
+
+        service.generateFromSelfCheck(USER_ID, CHECK_ID);
+
+        @SuppressWarnings("unchecked")
+        ArgumentCaptor<Map<String, Object>> captor = ArgumentCaptor.forClass(Map.class);
+        verify(aiGateway).generateHealthPlan(captor.capture());
+        Map<String, Object> inputs = captor.getValue();
+        assertNotNull(inputs,
+                "[health.plan.medicalRedline] 未捕获到自检路径调用 AiGateway.generateHealthPlan 的 inputs。");
+        assertTrue(inputs.containsKey(KEY_MEDICAL_CONSTRAINTS),
+                "[health.plan.medicalRedline] 自检→健康计划生成路径(generateFromSelfCheck → AiGateway.generateHealthPlan)"
+                        + "的 inputs 缺少 medical_constraints:§三 P1-1 要求 Java 调用侧注入用户已有诊断、在服药物。"
+                        + "实现未落地。");
+    }
+
+    // ------------------------------------------------------------------
+    // 边界流·输出侧:§8.1 四类红线输出正则审计(发布门禁须拦截)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("边界流-R1:器质诊断不得写成改善目标(§8.1)——命中须拦截发布")
+    void redlineR1_organicDiagnosisAsImprovementGoal_blocksPublish() {
+        assertPublishBlockedForPlanText(
+                "报告提示二尖瓣脱垂,坚持本方案后心脏问题会随方案改善。",
+                "器质性诊断(二尖瓣脱垂/心脏问题)被写成健康方案的改善目标(R1)");
+    }
+
+    @Test
+    @DisplayName("边界流-R2:不得建议增减或停用处方药(§8.1)——命中须拦截发布")
+    void redlineR2_rxIncreaseDecreaseOrStop_blocksPublish() {
+        assertPublishBlockedForPlanText(
+                "可以停用美托洛尔,改用本方案推荐的调理方式。",
+                "对在服处方药(美托洛尔)建议减停(R2)");
+    }
+
+    @Test
+    @DisplayName("边界流-R3:12 周内不设不可测目标(§8.1)——命中须拦截发布")
+    void redlineR3_unmeasurableGoalWithin12Weeks_blocksPublish() {
+        assertPublishBlockedForPlanText(
+                "目标:12 周内提升骨密度并复查骨代谢标志物。",
+                "12 周内设立不可测目标(骨密度/骨代谢标志物,R3)");
+    }
+
+    @Test
+    @DisplayName("边界流-R4:急症信号只做转介,禁写「方案见效后不再发作」(§8.1)——命中须拦截发布")
+    void redlineR4_acuteSignGuaranteeOfCessation_blocksPublish() {
+        assertPublishBlockedForPlanText(
+                "持续执行本方案,见效后胸痛不再发作。",
+                "急症信号(胸痛)写入「不再发作」的疗效承诺(R4)");
+    }
+
+    /**
+     * 输出审计契约(§8.1 落地三件套之 3):命中 §8.1 红线措辞的方案在发布门禁
+     * {@code HealthPlanServiceImpl.approveAndPublish} 必须被拒(fail-closed,与现有 SC-T-28
+     * 「方案内容未通过安全复核」链路同点位)。
+     * RED 现状:门禁仅做 SC-T-28 通用敏感词复核,不包含 §8.1 医疗红线 → 不抛异常 → 本断言失败(红)。
+     */
+    private void assertPublishBlockedForPlanText(String planContent, String redlineKind) {
+        HealthPlan plan = new HealthPlan();
+        plan.setId(PLAN_ID);
+        plan.setFamilyId(FAMILY_ID);
+        plan.setStatus("pending_review");
+        plan.setPlanContent(planContent);
+        when(healthPlanMapper.selectById(PLAN_ID)).thenReturn(plan);
+
+        assertThrows(RuntimeException.class,
+                () -> service.approveAndPublish(PLAN_ID, REVIEWER_ID, "通过"),
+                "[health.plan.medicalRedline] 命中医疗红线但方案仍被发布(" + redlineKind + "):"
+                        + "§三 P1-1 + §八 8.1 要求输出正则审计命中即拦截/重写/标记人工复核,发布门禁须拒绝。实现未落地。");
+    }
+
+    // ------------------------------------------------------------------
+    // R5 说明:行为判读先排除医学约束(prompt 约束侧,Java 输出审计不直接覆盖)
+    // ------------------------------------------------------------------
+
+    /**
+     * R5「行为判读先排除医学约束」(「她不能」≠「她不肯」)由 §三 P1-1 的 Python prompt 约束段承担,
+     * 不属于 Java 输出正则审计范畴,本类不产生失败断言;仅作覆盖标注。
+     */
+    @Test
+    @DisplayName("R5 说明:行为判读先排除医学约束属 prompt 约束侧,Java 输出审计不覆盖")
+    void redlineR5_behaviorJudgmentMedicalExclusion_promptSideOnly() {
+        assertTrue(true, "R5 为 Python prompt 约束侧(§三 P1-1 做法 1),Java 输出审计不直接覆盖,说明性标注。");
+    }
+
+    // ------------------------------------------------------------------
+    // 辅助
+    // ------------------------------------------------------------------
+
+    private byte[] readAll(InputStream is) throws java.io.IOException {
+        ByteArrayOutputStream bos = new ByteArrayOutputStream();
+        byte[] buf = new byte[4096];
+        int n;
+        while ((n = is.read(buf)) != -1) {
+            bos.write(buf, 0, n);
+        }
+        return bos.toByteArray();
+    }
+}