|
|
@@ -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;
|
|
|
+ }
|
|
|
+}
|