# 案例库表：case_library

**状态**：当前表  
**来源**：`V002__create_case_library.sql`、`CaseLibrary`

## 定位

`case_library` 保存高质量诊断案例，用于后续相似案例推荐和知识沉淀。当前自动沉淀路径来自 `useful` 用户反馈：系统把 `diagnosis_session` 中的 query 和 answer 映射为案例内容。

## 字段

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `id` | BIGINT | 是 | 自增主键 |
| `case_id` | VARCHAR(64) | 是 | 案例唯一 ID |
| `diagnosis_id` | VARCHAR(64) | 否 | 关联诊断会话；当前自动生成时存 `diagnosis_session.session_id` |
| `source_type` | VARCHAR(16) | 否 | 来源类型：`AUTO` 或 `MANUAL` |
| `fault_category` | VARCHAR(32) | 否 | 故障类别，实体侧使用 `FaultCategory` |
| `fault_source` | VARCHAR(128) | 否 | 故障源，例如服务、系统或省份 |
| `fault_target` | VARCHAR(256) | 否 | 故障目标，例如接口、方法、SQL 或组件 |
| `error_code` | VARCHAR(64) | 否 | 错误码或异常类型 |
| `title` | VARCHAR(256) | 是 | 案例标题 |
| `root_cause` | TEXT | 是 | 根因分析 |
| `solution` | TEXT | 是 | 解决方案 |
| `reference_count` | INT | 否 | 被推荐次数 |
| `created_by` | VARCHAR(64) | 否 | 创建人 |
| `created_at` | DATETIME | 是 | 创建时间 |
| `updated_at` | DATETIME | 是 | 更新时间 |

## 索引

| 索引 | 字段 | 用途 |
|---|---|---|
| `idx_fault_category` | `fault_category` | 按故障类别筛选 |
| `idx_error_code` | `error_code` | 按错误码精确匹配 |
| `idx_fault_source` | `fault_source` | 按故障源筛选 |
| `idx_fault_target` | `fault_target(100)` | 按故障目标筛选 |
| `idx_diagnosis_id` | `diagnosis_id` | 追溯来源会话 |
| `idx_reference_count` | `reference_count` | 推荐排序 |
| `idx_created_at` | `created_at` | 时间排序 |

## 关系

- `case_library.diagnosis_id` 当前逻辑关联 `diagnosis_session.session_id`，不是旧的 `diagnosis_record`。
- 人工录入案例可以不填写 `diagnosis_id`。

## 注意点

- 旧文档里提到的 `diagnosis_record` 已被 `V007` 删除，不再是当前主模型。
- 当前自动沉淀仍比较粗：`root_cause` 和 `solution` 都可能来自完整 answer。后续可从结构化结论中拆分根因、证据和修复建议。