|
|
@@ -0,0 +1,55 @@
|
|
|
+# 研发报告:谷禾低侧 C 档 4 项平台现状探测 + G-3 证据码隔离实现(T11/P1)
|
|
|
+
|
|
|
+- **日期**:2026-11-09
|
|
|
+- **规格文档**:`docs/superpowers/plans/2026-11-08-浠艾福平台程序修改计划.md`(v1.0,commit `b07bc4d0a` 入池溯源锚点)
|
|
|
+- **能力键**:guhe.gate.evidenceIsolate(S-cfc-91,RED 契约测试 `68a890d59`)
|
|
|
+- **任务**:T11 证据码隔离(G-3)——低侧机制证据标 PUB/KB;COM 只作存在性记录;未核实编号标「未核实」。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 一、C 档 4 项平台现状探测(实现前自主探测,判断不阻塞派发)
|
|
|
+
|
|
|
+对应计划文档 §四「待确认项(C 档 · 平台侧确认后转 A 档)」。探测对象 = 本仓库主干
|
|
|
+(origin/cfclub)上的平台现状(cfc-backend Java 服务 + cfc-langgraph Python AI 服务)。
|
|
|
+
|
|
|
+| # | 待确认项 | 平台现状(探测结论) | 对 G-3 的影响判断 |
|
|
|
+|---|---|---|---|
|
|
|
+| 1 | **Adapter 实现形态**:平台是否已封装统一 Adapter 接口 | **无统一 Java Adapter 接口**。报告采集/解析为:Python 指纹引擎(`docs/scripts/fingerprint_engine.py` 及 `parsers/` 副本,aidefansi→beijing→standard 判定)+ Java `PdfParseService` / `ReportParserController` 上传统链;guhe_v2 路由(L1-1)属 Python 指纹层新增分支,非 Java 路由重写 | **不阻塞**。G-3 在合规门禁横切层(Java),与 Adapter 形态解耦 |
|
|
|
+| 2 | **KB 服务加载方式**:`统一知识库.json` 文件直读 or 服务层 | **DB 为查询源 + classpath 种子兜底**:`knowledge_base_section` 表(schema.sql L3606 起,12 个顶层模块),`HealthKnowledgeBaseController` 服务层暴露(模块概览/原始内容/菌属查询/指标调整建议等) | **不阻塞**。G-3 证据码为规则层常量(PUB/KB/COM/未核实),不依赖 KB 加载方式 |
|
|
|
+| 3 | **L4 引擎存在性**:专家 prompt 驱动 or 已有规则引擎 | **已有 Java 规则引擎**:`FiveDimAttributionEngine` / `IndicatorInterpretEngine` / `NormCompareEngine` / `MainCauseChainEngine` / `FalsificationEngine`(`service/attribution/`),入口 `AttributionAnalysisServiceImpl.analyze()`(L4);socratic-coach 专家 prompt(cfc-langgraph)为对话侧补充 | **不阻塞**。G-3 为「补规则」(挂门禁方法),非「新建规则表」 |
|
|
|
+| 4 | **合规门禁挂载点**:平台是否已有门禁框架 | **已有门禁框架(G-1 已合入主链)**:`AttributionComplianceGate`(@Component,`a13bb8192`),挂载点 = `AttributionAnalysisServiceImpl.analyze()` L147 `enforceLowSide`(L4 出结论前)+ L152–154 `scan`/`merge`(L5 出文档前);报告侧 `redlineHits`/`sections.complianceGate` 暴露 | **不阻塞**。G-3 复用同门禁框架同挂载点,新增证据码隔离方法即可,无需新建门禁框架 |
|
|
|
+
|
|
|
+**结论**:C 档 4 项均探测确认,G-3 证据码隔离为纯规则/门禁层改造,不依赖 Adapter、KB
|
|
|
+加载方式、L4 引擎形态,不阻塞派发与实现。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 二、实现摘要(G-3 证据码隔离)
|
|
|
+
|
|
|
+1. `cfc-backend/.../constant/AttributionLowSideRules.java`:
|
|
|
+ - 新增规则码 `RULE_EVIDENCE_ISOLATE = "evidence_isolate"`;
|
|
|
+ - 新增证据码常量:`EVIDENCE_PUB = "PUB"`、`EVIDENCE_KB = "KB"`(可进推荐依据)、
|
|
|
+ `EVIDENCE_COM = "COM"`(仅存在性记录)、`EVIDENCE_UNVERIFIED = "未核实"`;
|
|
|
+ - 新增 G-3 分组码 `GROUP_CODE_G3` / `GROUP_TITLE_G3`(与 G-1 并列)。
|
|
|
+2. `cfc-backend/.../service/attribution/AttributionComplianceGate.java`(新增 4 个确定性方法,纯规则无依赖):
|
|
|
+ - `tagEvidence(String)`:PUB/KB/COM 原样保留;空/null/未知编号(如 `COM-870`)→「未核实」;
|
|
|
+ - `canEnterRecommendationBasis(String)`:仅 PUB/KB true;COM/「未核实」/空/null false;
|
|
|
+ - `isExistenceRecordOnly(String)`:仅 COM true;
|
|
|
+ - `isolateForRecommendation(List<String>)`:保序过滤仅保留 PUB/KB,剔除 COM 与「未核实」。
|
|
|
+
|
|
|
+**挂载**:与 G-1 同处横切合规门禁,推荐依据组装前调用(L4 出结论前 / L5 出文档前)。
|
|
|
+
|
|
|
+## 三、测试与构建
|
|
|
+
|
|
|
+| 项 | 结果 |
|
|
|
+|---|---|
|
|
|
+| `GuheEvidenceIsolateContractTest`(RED 契约,12 例) | ✅ 12/12 绿(实现前按契约语义逐条对齐) |
|
|
|
+| G-1 回归 `AttributionComplianceGateTest` / `AttributionRedlinesTest` / `GuheGateLowSideRedlineContractTest` | ✅ 无回归 |
|
|
|
+| `GuheGateStrainBlockContractTest`(G-2/T6,S-cfc-81 独立任务) | 5 例仍红(该任务本身 RED by design,非本次改动引入) |
|
|
|
+| 后端编译 `mvn -DskipTests compile` | ✅ BUILD SUCCESS |
|
|
|
+| cfc-web 构建 `vue-cli-service build` | ✅ Build complete(无 eslint 插件,lint N/A;纯后端改动,前端零触及) |
|
|
|
+| DB 迁移 | ⚠ 无新增(本任务纯规则层,无 DDL) |
|
|
|
+
|
|
|
+**附带修复**:RED 契约测试辅助 `call()` 的变长参数 null 陷阱(`call(gate, … , null)` 会把
|
|
|
+`null` 解析为整个 `Object[]` → `args.length` NPE),已做语义不变的最小归一化(`args==null`
|
|
|
+→ 单 null 实参),断言原文未改。
|