docs(architecture): align evidence pipeline design

mvp/architecture/data-model.md

@@ -1,6 +1,6 @@
 # 数据模型总览
 
-**更新日期**：2026-07-05  
+**更新日期**：2026-07-08
 **状态**：当前可运行架构
 
 ## 1. 定位
@@ -130,10 +130,35 @@ erDiagram
 用途：
 
 - 给 Trace API 展示证据。
-- 给 Verifier 构造 `tool_trace_summary`。
+- 给 Gatekeeper 提供 `retrieval_details.evidence_refs` 引用验真源。
+- 给 Verifier 构造 `tool_trace_summary` 审计导航。
 - 给 `EvaluationService` 计算 evidence score。
 - 给 RAG eval 和人工排查提供检索细节。
 
+`retrieval_details.evidence_refs` 是当前 Chat 证据链路的关键字段：
+
+```json
+{
+  "evidence_status": "supported",
+  "evidence_refs": [
+    {
+      "raw_path": "$.logs[0]",
+      "text": "2026-07-08 23:05:28 ERROR order-service HikariPool-1 - Connection is not available..."
+    }
+  ]
+}
+```
+
+字段边界：
+
+| 字段 | 说明 |
+|---|---|
+| `evidence_status` | 工具证据状态，例如 `supported`、`no_evidence`、`deduped`、`failed` |
+| `evidence_refs[].raw_path` | Executor 可引用的稳定路径，例如 `$.logs[0]`、`$.alerts[0]`、`$.evidence_blocks[0]`、`$.no_evidence` |
+| `evidence_refs[].text` | 系统抽取的最小证据文本，Gatekeeper 用它核对 `evidence_excerpt` |
+
+`$.no_evidence` 只表示“本次工具查询未检索到匹配证据”，不能被解释为“问题不存在”或“根因已排除”。
+
 ## 4. 知识库模型
 
 ### api_document
@@ -213,9 +238,39 @@ category
 边界：
 
 - `rule_evaluation` 评估证据收集充分度。
-- `verifier_evaluation` 评估 Chat 答案关键事实是否有证据支撑。
+- `verifier_evaluation` 评估 Chat 结构化 claims 是否能由已验真证据推出，并保存 Gatekeeper、Verifier、Composer 的审计数据。
 - `aiops_rule_evaluation` 评估 AIOps 报告是否聚焦告警并使用证据。
 
+当前 `verifier_evaluation` 关键结构：
+
+```json
+{
+  "verdict": "PASS",
+  "groundedness_score": 1.0,
+  "critical_fact_count": 1,
+  "claim_checks": [],
+  "facts_checked": [],
+  "rationale": "...",
+  "round": 1,
+  "traceability_version": "v1",
+  "executor_output_parse_status": {},
+  "executor_structured_output": {},
+  "gatekeeper_result": {},
+  "composer_output": {},
+  "tool_trace_summary": []
+}
+```
+
+必要审计字段：
+
+| 字段 | 说明 |
+|---|---|
+| `executor_output_parse_status` | Executor 输出是否能解析为 `executor_evidence_v2` |
+| `executor_structured_output` | Executor 结构化 claims、hypotheses、recommended_actions、missing_info |
+| `gatekeeper_result` | 引用真实性校验结果，包括 checked bindings、failed rules、warnings、errors |
+| `composer_output` | Composer 最终表达及解析状态 |
+| `tool_trace_summary` | Verifier 调用时使用的工具调用导航索引，不是唯一证据源 |
+
 ## 7. 数据写入时序
 
 ```mermaid
@@ -253,6 +308,5 @@ sequenceDiagram
 
 1. 增加 run id，支持同 session 多次独立诊断。
 2. 强化 `tool_invocation.step_id` 关联。
-3. 将 evidence block 结构化保存。
+3. 将 Gatekeeper 规则配置化时的规则元数据保存为可审计版本。
 4. 将 `case_library` 的 rootCause/solution 从完整 answer 中结构化抽取。
-