# 知识域表：knowledge_domain

**状态**：孤儿表（2026-09-29 RAG 抽离后无写入方）  
**来源**：`V009__add_knowledge_domain.sql`、`KnowledgeDomain`

> **2026-09-29 变更**：本表的写入方 `KnowledgeDomainService` 已随 RAG 模块抽离删除
> （L0 domain 分析下沉 py-rag）。表结构由 Flyway 保留（`ddl-auto: validate`），当前无读写方，
> 待后续迁移清理。历史数据仅供追溯。

## 定位

`knowledge_domain` 保存知识库领域级元数据，为 RAG backend 的 domain hint、检索选择和可观测性提供基础信息；它不是 Agent-facing Tool contract。

## 字段

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `id` | BIGINT | 是 | 自增主键 |
| `domain_id` | VARCHAR(64) | 是 | 领域 ID，通常对应文档 category，例如 `payment`、`infrastructure` |
| `description` | VARCHAR(256) | 否 | 领域描述 |
| `when_to_retrieve` | TEXT | 否 | 何时检索该领域的提示说明 |
| `document_count` | INT | 是 | 当前领域文档数量 |
| `created_at` | DATETIME | 是 | 创建时间 |
| `updated_at` | DATETIME | 是 | 更新时间 |

## 索引

| 索引 | 字段 | 用途 |
|---|---|---|
| unique | `domain_id` | 保证领域 ID 唯一 |

## 关系

- `knowledge_domain.domain_id` 与 `api_document.metadata` 或向量库 chunk metadata 中的 `category` 逻辑关联。
- 当前没有数据库外键，领域文档数量由服务逻辑维护。

## 注意点

- `when_to_retrieve` 是检索策略提示，不是事实证据。
- Diagnosis Agent 与 SemanticGuard 不能把领域描述当作诊断结论依据；事实仍应来自当前 Run 经 EvidenceGuard 验真的 Tool evidence。