فهرست منبع

Merge task/S-cfc-420: S-cfc-420 契约级RED单测 health.analysis.mediatorAudit 介导链路确定性因果审计(§三P1-2+§八8.2 输出正则审计;10失败/2通过)

Sisyphus 2 روز پیش
والد
کامیت
89466e40b4
1فایلهای تغییر یافته به همراه285 افزوده شده و 0 حذف شده
  1. 285 0
      cfc-backend/src/test/java/com/etotem/cfc/unit/HealthAnalysisMediatorAuditContractTest.java

+ 285 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/HealthAnalysisMediatorAuditContractTest.java

@@ -0,0 +1,285 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.constant.AttributionLowSideRules;
+import com.etotem.cfc.service.attribution.AttributionComplianceGate;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import java.lang.reflect.Field;
+import java.util.Arrays;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 契约级单测:介导链路确定性因果审计(能力键 {@code health.analysis.mediatorAudit})。
+ *
+ * <p><b>契约来源</b>(《谷禾新版解析与五维归因升级方案 v1.0》§三 P1-2 + §八 8.2,提交
+ * {@code ef8eb62be} 已合入 origin/cfclub;溯源 {@code SC-B-05 · 敏感问题拦截与隐私保护} /
+ * {@code SC-B-06 · LangGraph 不可用 Fallback},{@code tests/user-scenarios/应用场景总览.md}):
+ * <blockquote>
+ *   §三 P1-2 介导链路禁确定性因果:{@code analysis_graph} / {@code health_butler_graph} 的
+ *   解读文案里,凡是涉及<b>心 / 智维度</b>的菌群 → 递质 → 情绪/认知链路,只作<b>上游信号</b>,
+ *   不判能力。输出侧加正则审计:{@code 导致 / 治愈 / 改善 / 典型表现 / 正是.*的根} →
+ *   命中即<b>重写或标记人工复核</b>。
+ *   <br>§八 8.2:菌群 → 递质 → 情绪/认知 的 ⚠ 介导链路只作<b>上游信号</b>,不判能力;
+ *   行文一律「相关联 / 报告提示 / 可能与…有关」。
+ *   <br>红线:禁『这正是…典型表现』/『正是…的根』/『拖了…后腿』;必用『相关联 / 报告提示』。
+ *   <br>验收(§7.3):健康计划禁用词命中 <b>0</b>(P1-2 审计通过)。
+ * </blockquote></p>
+ *
+ * <p><b>契约语义</b>:本能力键是「合规门禁(横切)」的<b>介导链路确定性因果审计</b>——在
+ * L5 出文档前对解读/结论文本反向回扫 §5.8 介导链路禁用措辞(导致 / 治愈 / 改善 / 典型表现 /
+ * 正是…的根 / 拖了…后腿),命中即产出合规违规(violation),建议改写为措辞白名单表述
+ * (相关联 / 报告提示 / 可能与…有关 / 待进一步确认),供报告侧暴露审计结果;流程不阻断,
+ * 由 7.3「禁用词命中 0」验收兜底。介导链本身({@code FiveDimAttributionEngine.mediationChain}
+ * 的「报告提示:…间接关联(经肠脑轴介导),属关联非因果」阶梯表述)已按上游信号口径落地,
+ * 本审计补的是<b>输出侧确定性因果措辞</b>的拦截。</p>
+ *
+ * <p><b>实现现状(worktree src/main 探测,2026-11-16)</b>:G-1 低侧红线组已落地
+ * ({@code AttributionLowSideRules} / {@code AttributionComplianceGate},含 {@code association_only} /
+ * {@code no_causal_bridge} / {@code no_prescription} / {@code no_strain_recommendation} 规则码 +
+ * 措辞白名单 {@code WORDING_WHITELIST}),但<b>介导链路确定性因果审计未落地</b>:
+ * <ul>
+ *   <li>{@code AttributionLowSideRules} 无独立 {@code RULE_MEDIATOR_AUDIT} 规则码、无
+ *       {@code FORBIDDEN_MEDIATOR_WORDS} 禁用词表、无 {@code MEDIATOR_AUDIT_HINT} 改写建议;</li>
+ *   <li>{@code WORDING_WHITELIST} 缺「待进一步确认」(§5.8 必用措辞,仅相关联/报告提示/可能与…有关/可能与/有关);</li>
+ *   <li>{@code AttributionComplianceGate.scan()} 现有 {@code FORBIDDEN_CAUSAL_PATTERNS} 仅回扫
+ *       「缺 X → 致病/需补充」桥接(需 缺/偏低 引导 + 致病/功能下降 收尾),<b>不覆盖</b>
+ *       「递质偏低导致记忆力下降」「这正是…典型表现」「正是…的根」「拖了…后腿」「改善了…」等
+ *       §5.8 介导链路确定性因果措辞。</li>
+ * </ul>
+ * 故本测试以「反射结构 + 纯规则行为」双通道探测实现缺失:能编译、能运行、断言失败(红),
+ * 失败断言原文清晰可贴(纯 JUnit + 反射,无 Spring / 无 DB / 无外部服务)。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:实现者在 {@code AttributionLowSideRules} 增加
+ * {@code RULE_MEDIATOR_AUDIT="mediator_audit"} 与 {@code FORBIDDEN_MEDIATOR_WORDS}
+ * (覆盖 导致/治愈/改善/典型表现/正是/的根/拖了/后腿)与 {@code MEDIATOR_AUDIT_HINT}
+ * (含「关联非因果」改写建议),并把「待进一步确认」并入 {@code WORDING_WHITELIST};
+ * 在 {@code AttributionComplianceGate.scan()}(L5 出文档前输出审计)追加 §5.8 禁用词回扫后,
+ * 本测试自动转绿。</p>
+ *
+ * <p><b>权限流说明</b>:本能力为后端内部合规审计(L5 出文档前),无用户权限维度,
+ * 权限流不适用,以说明性用例标注。</p>
+ */
+class HealthAnalysisMediatorAuditContractTest {
+
+    /** §三 P1-2 期望的介导链审计规则码 */
+    private static final String RULE_MEDIATOR_AUDIT = "mediator_audit";
+
+    /** §5.8 禁用词表常量名(介导链路确定性因果措辞) */
+    private static final String FORBIDDEN_WORDS_FIELD = "FORBIDDEN_MEDIATOR_WORDS";
+
+    /** §5.8 必用措辞「待进一步确认」(现缺) */
+    private static final String WHITELIST_NEEDED_WORD = "待进一步确认";
+
+    /** §三 P1-2 期望的改写建议常量名 */
+    private static final String HINT_FIELD = "MEDIATOR_AUDIT_HINT";
+
+    /** §5.8 介导链路禁用措辞词元(覆盖「这正是…典型表现/正是…的根/拖了…后腿/导致/治愈/改善」) */
+    private static final List<String> FORBIDDEN_TOKENS = Arrays.asList(
+            "导致", "治愈", "改善", "典型表现", "正是", "的根", "拖了", "后腿");
+
+    private final AttributionComplianceGate gate = new AttributionComplianceGate();
+
+    // ------------------------------------------------------------------
+    // 正常流:规则层常量(§三 P1-2 介导链审计规则码 + 禁用词表 + 改写建议)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-1:AttributionLowSideRules 应暴露 RULE_MEDIATOR_AUDIT 规则码")
+    void lowSideRules_exposesMediatorAuditRuleCode() {
+        Field f = declaredField(AttributionLowSideRules.class, "RULE_MEDIATOR_AUDIT");
+        assertNotNull(f,
+                "[health.analysis.mediatorAudit] AttributionLowSideRules 缺少 RULE_MEDIATOR_AUDIT 规则码:"
+                        + "§三 P1-2 要求介导链路确定性因果审计(输出正则审计),当前仅落地 G-1 的"
+                        + " association_only/no_causal_bridge/no_prescription,未覆盖 §5.8 禁用措辞。");
+        try {
+            Object v = f.get(null);
+            assertNotNull(v, "[health.analysis.mediatorAudit] RULE_MEDIATOR_AUDIT 常量值不应为 null。");
+            assertTrue(RULE_MEDIATOR_AUDIT.equals(String.valueOf(v)),
+                    "[health.analysis.mediatorAudit] RULE_MEDIATOR_AUDIT 应取值为 \"" + RULE_MEDIATOR_AUDIT
+                            + "\",实际为 \"" + v + "\"。");
+        } catch (IllegalAccessException e) {
+            assertTrue(false, "[health.analysis.mediatorAudit] 读取 RULE_MEDIATOR_AUDIT 失败:" + e.getMessage());
+        }
+    }
+
+    @Test
+    @DisplayName("正常流-2:AttributionLowSideRules 应暴露 FORBIDDEN_MEDIATOR_WORDS 禁用词表(覆盖§5.8措辞)")
+    void lowSideRules_exposesForbiddenMediatorWords() {
+        Field f = declaredField(AttributionLowSideRules.class, FORBIDDEN_WORDS_FIELD);
+        assertNotNull(f,
+                "[health.analysis.mediatorAudit] AttributionLowSideRules 缺少 " + FORBIDDEN_WORDS_FIELD
+                        + ":§5.8 要求禁用 导致/治愈/改善/典型表现/正是…的根/拖了…后腿 等确定性因果措辞"
+                        + "(§三 P1-2 输出正则审计),当前仅 FORBIDDEN_CAUSAL_PATTERNS 回扫「缺X桥接」。");
+        try {
+            Object v = f.get(null);
+            assertNotNull(v, "[health.analysis.mediatorAudit] " + FORBIDDEN_WORDS_FIELD + " 常量值不应为 null。");
+            assertTrue(v instanceof List,
+                    "[health.analysis.mediatorAudit] " + FORBIDDEN_WORDS_FIELD + " 应为 List<String>,实际 "
+                            + v.getClass().getSimpleName());
+            @SuppressWarnings("unchecked")
+            List<String> words = (List<String>) v;
+            for (String token : FORBIDDEN_TOKENS) {
+                assertTrue(words.contains(token),
+                        "[health.analysis.mediatorAudit] " + FORBIDDEN_WORDS_FIELD + " 应含禁用词元「"
+                                + token + "」(§5.8 介导链路禁确定性因果),实际:" + words);
+            }
+        } catch (IllegalAccessException e) {
+            assertTrue(false, "[health.analysis.mediatorAudit] 读取 " + FORBIDDEN_WORDS_FIELD + " 失败:" + e.getMessage());
+        }
+    }
+
+    @Test
+    @DisplayName("正常流-3:措辞白名单应含「待进一步确认」(§5.8 必用措辞)")
+    void lowSideRules_whitelistCoversPendingConfirm() {
+        List<String> whitelist = AttributionLowSideRules.WORDING_WHITELIST;
+        assertNotNull(whitelist, "[health.analysis.mediatorAudit] WORDING_WHITELIST 不应为 null。");
+        assertTrue(whitelist.contains(WHITELIST_NEEDED_WORD),
+                "[health.analysis.mediatorAudit] 措辞白名单应含「" + WHITELIST_NEEDED_WORD
+                        + "」(§5.8 介导链路必用措辞:相关联 / 报告提示 / 可能与…有关 / 待进一步确认),"
+                        + "实际仅:" + whitelist + "。");
+    }
+
+    @Test
+    @DisplayName("正常流-4:AttributionLowSideRules 应暴露 MEDIATOR_AUDIT_HINT 改写建议(关联非因果口径)")
+    void lowSideRules_exposesMediatorAuditHint() {
+        Field f = declaredField(AttributionLowSideRules.class, HINT_FIELD);
+        assertNotNull(f,
+                "[health.analysis.mediatorAudit] AttributionLowSideRules 缺少 " + HINT_FIELD
+                        + ":§三 P1-2 要求命中即重写或标记人工复核,需给下游「关联非因果」改写建议"
+                        + "(相关联 / 报告提示 / 可能与…有关 / 待进一步确认)。");
+        try {
+            Object v = f.get(null);
+            assertNotNull(v, "[health.analysis.mediatorAudit] " + HINT_FIELD + " 常量值不应为 null。");
+            String text = String.valueOf(v);
+            assertTrue(text.contains("关联"),
+                    "[health.analysis.mediatorAudit] " + HINT_FIELD + " 应含「关联非因果」口径(介导链只作上游信号、不判能力),"
+                            + "实际为:「" + text + "」。");
+            assertTrue(text.contains("报告提示") || text.contains("相关联") || text.contains("待进一步确认"),
+                    "[health.analysis.mediatorAudit] " + HINT_FIELD + " 应引用措辞白名单(报告提示/相关联/待进一步确认),"
+                            + "实际为:「" + text + "」。");
+        } catch (IllegalAccessException e) {
+            assertTrue(false, "[health.analysis.mediatorAudit] 读取 " + HINT_FIELD + " 失败:" + e.getMessage());
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 边界流:输出正则审计(§三 P1-2)—— L5 出文档前 scan 应命中 §5.8 禁用措辞
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("边界流-1:scan 命中「递质偏低导致记忆力下降」(导致)→ 应产出违规")
+    void scan_deterministicCausal_导致_hitsMediatorAudit() {
+        List<AttributionComplianceGate.Violation> vs = gate.scan(
+                "菌群经肠脑轴使递质偏低,导致记忆力下降、注意力变差");
+        assertFalse(vs.isEmpty(),
+                "[health.analysis.mediatorAudit] 「导致」确定性因果措辞应被输出审计命中(§5.8 禁),"
+                        + "当前 scan 仅回扫缺X桥接/处方化/菌株号,未覆盖 §5.8 介导链禁用词。");
+    }
+
+    @Test
+    @DisplayName("边界流-2:scan 命中「这正是情绪问题的典型表现」(典型表现)→ 应产出违规")
+    void scan_deterministicCausal_典型表现_hitsMediatorAudit() {
+        List<AttributionComplianceGate.Violation> vs = gate.scan(
+                "菌群经肠脑轴递质偏低,这正是情绪问题的典型表现");
+        assertFalse(vs.isEmpty(),
+                "[health.analysis.mediatorAudit] 「这正是…典型表现」应被输出审计命中(§5.8 禁,红线),"
+                        + "当前 scan 未覆盖。");
+    }
+
+    @Test
+    @DisplayName("边界流-3:scan 命中「睡眠问题正是记忆力下降的根」(正是…的根)→ 应产出违规")
+    void scan_deterministicCausal_正是根_hitsMediatorAudit() {
+        List<AttributionComplianceGate.Violation> vs = gate.scan(
+                "肠道菌群失衡与睡眠问题相关,而睡眠问题正是记忆力下降的根");
+        assertFalse(vs.isEmpty(),
+                "[health.analysis.mediatorAudit] 「正是…的根」应被输出审计命中(§5.8 禁,红线),"
+                        + "当前 scan 未覆盖。");
+    }
+
+    @Test
+    @DisplayName("边界流-4:scan 命中「肠道菌群失衡拖了专注力的后腿」(拖了…后腿)→ 应产出违规")
+    void scan_deterministicCausal_拖后腿_hitsMediatorAudit() {
+        List<AttributionComplianceGate.Violation> vs = gate.scan(
+                "肠道菌群失衡拖了专注力的后腿");
+        assertFalse(vs.isEmpty(),
+                "[health.analysis.mediatorAudit] 「拖了…后腿」应被输出审计命中(§5.8 禁,红线),"
+                        + "当前 scan 未覆盖。");
+    }
+
+    @Test
+    @DisplayName("边界流-5:scan 命中「菌群干预改善了情绪表现」(改善)→ 应产出违规")
+    void scan_deterministicCausal_改善_hitsMediatorAudit() {
+        List<AttributionComplianceGate.Violation> vs = gate.scan(
+                "菌群干预改善了孩子的情绪表现与专注力");
+        assertFalse(vs.isEmpty(),
+                "[health.analysis.mediatorAudit] 「改善」确定性因果措辞应被输出审计命中(§5.8 禁),"
+                        + "当前 scan 未覆盖。");
+    }
+
+    @Test
+    @DisplayName("边界流-6:审计命中应携带规则码与改写建议(violation 结构)")
+    void scan_mediatorHit_violationCarriesRuleAndSuggestion() {
+        List<AttributionComplianceGate.Violation> vs = gate.scan(
+                "菌群经肠脑轴递质偏低,导致记忆力下降");
+        assertFalse(vs.isEmpty(),
+                "[health.analysis.mediatorAudit] §5.8 命中应产出违规(前置条件:审计已覆盖禁用词)。");
+        AttributionComplianceGate.Violation v = vs.get(0);
+        assertNotNull(v.getRule(),
+                "[health.analysis.mediatorAudit] 违规应带规则码(mediator_audit)。");
+        assertNotNull(v.getSnippet(),
+                "[health.analysis.mediatorAudit] 违规应带命中片段。");
+        assertNotNull(v.getSuggestion(),
+                "[health.analysis.mediatorAudit] 违规应带「关联非因果」改写建议(重写或标记人工复核)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 边界流:白名单措辞不误报(§5.8 上游信号口径 · 已有介导链阶梯表述)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("边界流-7:白名单介导链措辞不误报(scan 无违规)")
+    void scan_whitelistMediatorWording_noFalsePositive() {
+        for (String safe : Arrays.asList(
+                "报告提示:肠道菌群读数与情绪状态可能存在间接关联(经肠脑轴介导),属关联非因果",
+                "报告提示:肠道菌群读数与注意力、记忆表现可能存在间接关联(经肠脑轴介导),属关联非因果",
+                "菌群异常与近期情绪波动可能有关,关联强度需结合问诊验证",
+                "可能与压力负荷有关",
+                "睡眠表现待进一步确认",
+                "与肠道环境相关联"
+        )) {
+            List<AttributionComplianceGate.Violation> vs = gate.scan(safe);
+            assertTrue(vs.isEmpty(),
+                    "[health.analysis.mediatorAudit] 白名单介导链措辞不应误报:" + safe);
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 权限流(不适用):后端内部合规审计,无用户权限维度
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("权限流:本能力为后端内部合规审计,无用户权限维度,权限流不适用")
+    void permissionFlow_notApplicable() {
+        // 说明性用例:契约 AC 为「L5 出文档前 → 介导链确定性因果措辞回扫」内部规则,无权限校验维度。
+        assertTrue(true, "权限流不适用:health.analysis.mediatorAudit 为后端内部合规审计,无用户权限维度。");
+    }
+
+    // ------------------------------------------------------------------
+    // 反射辅助
+    // ------------------------------------------------------------------
+
+    private static Field declaredField(Class<?> clazz, String name) {
+        for (Field f : clazz.getDeclaredFields()) {
+            if (f.getName().equals(name)) {
+                f.setAccessible(true);
+                return f;
+            }
+        }
+        return null;
+    }
+}